WordPress è il tuo sito, non la rete di qualcun altro, quindi il collegamento funziona in modo diverso da ogni altro canale: non c’è nessuna app Ocoya da approvare su un servizio centrale. Ti colleghi con una application password, che WordPress emette proprio per questo e che puoi revocare in qualsiasi momento senza cambiare la tua password.
Prima di iniziare
Il sito deve soddisfare tre condizioni:
- È raggiungibile tramite https. Una application password non può essere inviata in sicurezza tramite http, quindi Ocoya rifiuta i siti http.
- La sua REST API è raggiungibile. Alcuni plugin di sicurezza la disattivano o la bloccano.
- L’utente che colleghi ha il ruolo Author, Editor o Administrator. I ruoli inferiori non possono pubblicare.
Collegare WordPress
Ci sono due strade. Entrambe portano alla stessa connessione.
Apri Channels e scegli WordPress
Seleziona Channels, poi Connect channel, e scegli WordPress: è elencato sotto Blogging.
Inserisci l'indirizzo del tuo sito
Digita l’indirizzo del sito, per esempio https://example.com. Ocoya lo usa per trovare la REST API del sito.
Approva sul tuo sito oppure incolla una password
Ocoya può mandarti alla schermata Authorize application del tuo sito, dove WordPress crea la password e la restituisce. Se preferisci non essere reindirizzato, generane una tu sotto Users → Profile → Application Passwords e incollala insieme al tuo nome utente.
La revoca si fa sul tuo sito: elimina la application password sotto Users → Profile e Ocoya non potrà più raggiungerlo. In quella schermata la connessione si chiama Ocoya, quindi è chiaro quale rimuovere.
Cosa puoi pubblicare
| Tipo di post | Supportato |
|---|---|
| Testo | Sì, obbligatorio |
| Titolo | Facoltativo |
| Immagini | Sì, fino a 10 |
| GIF | Sì |
| Video | No |
I post vengono pubblicati online, non come bozze sul sito.
Niente video. Un sito WordPress può ospitarne, ma con dimensioni e codifiche che dipendono dal limite di caricamento del tuo sito e non da un post programmato: per questo Ocoya lo rifiuta invece di fallire a metà di un caricamento.
Il titolo
Ogni post di WordPress ha un titolo, ma non sei obbligato a scriverlo. Lascia il campo vuoto e Ocoya prende la prima riga della tua didascalia al momento della pubblicazione.
È la differenza rispetto a DEV.to, dove il campo è obbligatorio nel composer: qui nulla viene mai rifiutato per mancanza di un titolo.
Le immagini vanno nella tua libreria multimediale
Le immagini vengono caricate nella libreria multimediale del sito invece di essere collegate da Ocoya. Due conseguenze da sapere:
- Il post mantiene le sue immagini anche dopo che sostituisci o elimini il creativo in Ocoya.
- Compaiono nella tua libreria, dove te le aspetteresti.
Le immagini stanno alla fine del corpo, non nello slot dell’immagine in evidenza. Quello slot contiene una sola copertina che il tuo tema ritaglia a modo suo: sopravvivrebbe una sola immagine, in un punto che non hai scelto. Nel corpo, ogni immagine sopravvive con le proprie proporzioni.
I limiti di WordPress
| Titolo | 200 caratteri, facoltativo |
| Corpo | 100.000 caratteri |
| Immagini | 10 |
| Video | Non supportato |
WordPress salva il corpo in una colonna di testo e non impone una lunghezza propria, quindi il limite del corpo è un guardrail di Ocoya. Anche il numero di immagini è nostro: il limite reale del tuo sito è la dimensione di caricamento, che solo lui conosce.
Problemi comuni
“WordPress sites must be connected over https.” L’indirizzo del sito è http. Una application password non può essere inviata in sicurezza tramite http.
“Your WordPress site did not return a REST API response. The REST API may be disabled or blocked by a security plugin.” Qualcosa sul sito sta bloccando /wp-json. Di solito la causa sono i plugin di sicurezza e firewall.
“This WordPress user is not allowed to publish posts. Connect a user with the Author, Editor or Administrator role.” Il ruolo dell’utente collegato è troppo basso.
“WordPress posts require text.” Il post ha immagini ma nessun corpo.
“WordPress did not store the uploaded image.” Il caricamento del file è stato rifiutato: di solito per il limite di dimensione di caricamento del sito, o per un tipo di file che non accetta.
“Connection to your profile has expired. Please reconnect.” La application password è stata revocata o cambiata. Generane una nuova e ricollega. Vedi Ricollega un canale.