1. Persönliches Figma-Zugriffstoken erzeugen

Um deine Figma-Datei mit dem Commentful-Plugin zu verbinden, musst du in deinem Figma-Konto ein persönliches Zugriffstoken erzeugen:

1. Öffne den Bereich Settings (im Dropdown-Menü unter dem Symbol deines Figma-Kontos).
2. Scroll im Einstellungs-Popup im Tab Account nach unten zum Abschnitt Personal access tokens.
3. Klick auf Generate new token.
4. Gib einen Token name ein (zum Beispiel Commentful Figma Plugin).
5. Stell im Dropdown Expiration die Option 90 Days ein.
6. Achte darauf, dass im Dropdown File content die Option Read-only eingestellt ist.
7. Achte darauf, dass im Dropdown Comments die Option Write eingestellt ist.
8. Alle anderen Dropdowns kannst du auf No access lassen.
9. Klick auf Generate token.
10. Klick auf Copy this token (das ist deine einzige Gelegenheit dazu).

Figma hat die Option No expiration aus dem Dropdown Expiration entfernt. Du musst dein persönliches Figma-Zugriffstoken daher alle 90 Tage erneuern. Wenn dein Token abläuft, gehen keine Daten, Kommentare oder Review-Daten verloren. Das Token dient nur dazu, das Commentful-Plugin zu authentifizieren, damit es die Kommentare in deiner Figma-Datei sehen kann.

API-Limits von Figma (gültig ab 17. November 2024) Figma begrenzt API-Anfragen für Figma-Nutzer im Starter-Tarif (kostenlos) auf 5 pro Minute. Commentful mildert dieses Limit automatisch durch Caching und eine Begrenzung der Anfragen ab. Für eine intensivere Nutzung (zum Beispiel, wenn du über das Commentful-Plugin viele Kommentare pro Minute postest) solltest du ein Upgrade auf einen Full-Seat in Figma in Betracht ziehen.

2. Token und URL der Figma-Datei in Commentful einfügen

Nachdem du dein persönliches Figma-Zugriffstoken erzeugt und in die Zwischenablage kopiert hast, führ das Commentful-Plugin aus und geh so vor:

1. Klick im Commentful-Plugin auf Connect This Figma File.
2. Füge dein persönliches Zugriffstoken in das Plugin ein und klick auf Save Token.
3. Klick oben rechts in deiner Figma-Datei auf Share, um das Popup zum Teilen zu öffnen.
4. Stell die Berechtigung der Figma-Datei für Anyone with the link auf can view.
5. Klick auf Copy link, um die URL der aktuellen Figma-Datei in die Zwischenablage zu kopieren.
6. Füge die URL deiner Figma-Datei in das Plugin ein und klick auf Save URL.

Wenn du eine Figma-Datei aus einer anderen Datei dupliziert hast, die bereits mit Commentful verknüpft war, musst du das Plugin neu verknüpfen: Klick im Bereich Settings von Commentful auf Re-link your Figma File und gib die neue URL der duplizierten Figma-Datei ein.