Documentație

Configurare

Ghid de Configurare

Pasul 1: Creează un Token de Acces Mastodon

  1. Înregistrează-te pe https://social.5th.ro
  2. Mergi la Preferințe → Dezvoltare
  3. Click pe Aplicație Nouă
  4. Completează detaliile aplicației:
    • Nume aplicație: 5th Social Bot
    • Website: URL-ul site-ului tău WordPress
    • Redirect URI: Lasă gol
    • Scopes: Bifează write:statuses și read:accounts
  5. Click pe Trimite
  6. Copiază valoarea Token-ul tău de acces

Pasul 2: Configurează Plugin-ul

  1. Mergi la Setări → 5th Social Bot în panoul WordPress
  2. Lipește token-ul de acces în câmpul Mastodon Access Token (câmpul este blurat pentru securitate, cu opțiune show/hide)
  3. Numele de utilizator va fi preluat automat din token
  4. Configurează celelalte setări după cum este necesar:
    • Activează postarea automată pentru articole și/sau pagini
    • Setează template-ul postării (implicit: {text}\n{tags}\n{url})
    • Folosește selectorul de emoji-uri (peste 2000 emoji-uri Unicode disponibile)
    • Alege vizibilitatea statusului (public, unlisted, private, direct)
    • Setează limba postării (implicit: Română, ISO 639-1/639-2)
    • Activează Debug Mode pentru logging detaliat (opțional)
  5. Click pe Salvează Setările
  6. Folosește butonul Send test post to Mastodon pentru a verifica configurația

Template Placeholders

Template-ul postării suportă următoarele placeholder-e:

  • {text} - excerpt/preview al conținutului (se trunchează automat la 500 caractere)
  • {tags} - hashtag-uri generate din tag-urile WordPress (spații și caractere speciale eliminate, prefix # adăugat)
  • {readmore_text} - text call-to-action scurt (poți adăuga multiple variante, câte una pe linie, se alege aleatoriu)
  • {url} - permalink către articol sau pagină

Suport newlines: Poți scrie template-ul pe multiple linii în textarea, sau folosește \n în template (se convertește la newlines reale).

Trunchiere automată: Dacă postarea depășește 500 de caractere (limita Mastodon), plugin-ul încearcă să scurtăm doar partea {text} mai întâi, apoi folosește o variantă minimală …. {readmore_text} {url} dacă este necesar.

Pasul 3: Verificare Profil (Opțional)

  1. Activează Verificare Profil în setări
  2. Mergi la contul tău Mastodon Preferințe → Profil public → Verificare
  3. Adaugă domeniul site-ului WordPress în whitelist
  4. Plugin-ul va adăuga automat codul de verificare în header-ul site-ului