1. Wygeneruj osobisty token dostępu Figmy

Aby połączyć plik Figmy z wtyczką Commentful, musisz wygenerować osobisty token dostępu na swoim koncie Figmy:

1. Przejdź do panelu Settings (w menu rozwijanym pod ikoną konta Figmy).
2. Na karcie Account w okienku ustawień przewiń w dół do sekcji Personal access tokens.
3. Kliknij Generate new token.
4. Ustaw Token name (na przykład Commentful Figma Plugin).
5. W menu rozwijanym Expiration wybierz opcję 90 Days.
6. Upewnij się, że w menu rozwijanym File content ustawiona jest opcja Read-only.
7. Upewnij się, że w menu rozwijanym Comments ustawiona jest opcja Write.
8. Wszystkie pozostałe menu rozwijane możesz zostawić na No access.
9. Kliknij przycisk Generate token.
10. Kliknij Copy this token (to jedyna okazja, aby go skopiować).

Figma usunęła opcję No expiration z menu rozwijanego Expiration, więc osobisty token dostępu Figmy trzeba odświeżać co 90 dni. Gdy token wygaśnie, nie stracisz żadnych danych, komentarzy ani danych przeglądów. Token służy jedynie do uwierzytelnienia wtyczki Commentful, aby mogła odczytywać komentarze w Twoim pliku Figmy.

Limity API Figmy (od 17 listopada 2024 r.) Figma ogranicza zapytania do API do 5 na minutę dla użytkowników bezpłatnego planu Starter. Commentful automatycznie łagodzi ten limit dzięki pamięci podręcznej i ograniczaniu liczby zapytań. Przy intensywniejszym użyciu (na przykład gdy publikujesz przez wtyczkę Commentful wiele komentarzy na minutę) rozważ przejście na stanowisko Full w Figmie.

2. Wklej token i adres URL pliku Figmy do Commentful

Gdy wygenerujesz osobisty token dostępu Figmy i skopiujesz go do schowka, uruchom wtyczkę Commentful i wykonaj poniższe kroki:

1. Kliknij przycisk Connect This Figma File we wtyczce Commentful.
2. Wklej osobisty token dostępu do wtyczki i kliknij przycisk Save Token.
3. Kliknij przycisk Share w prawym górnym rogu pliku Figmy, aby otworzyć okienko udostępniania.
4. Ustaw uprawnienia pliku Figmy dla Anyone with the link na can view.
5. Kliknij Copy link, aby skopiować adres URL bieżącego pliku Figmy do schowka.
6. Wklej adres URL pliku Figmy do wtyczki i kliknij przycisk Save URL.

Jeśli zduplikowano plik Figmy z innego pliku, który był już połączony z Commentful, musisz ponownie połączyć wtyczkę z nowym adresem URL zduplikowanego pliku Figmy. Kliknij w tym celu przycisk Re-link your Figma File w panelu Settings w Commentful.