WordPress est votre propre site plutôt que le réseau de quelqu’un d’autre : le connecter fonctionne donc différemment de tous les autres canaux, car il n’y a pas d’application Ocoya à approuver sur un service central. Vous vous connectez avec un mot de passe d’application, que WordPress délivre précisément pour cela et que vous pouvez révoquer à tout moment sans changer votre propre mot de passe.
Avant de commencer
Trois conditions doivent être remplies par le site :
- Il est accessible en https. Un mot de passe d’application ne peut pas être envoyé en toute sécurité en http : Ocoya refuse donc les sites en http.
- Son API REST est accessible. Certains plugins de sécurité la désactivent ou la bloquent.
- L’utilisateur que vous connectez a le rôle Author, Editor ou Administrator. Les rôles inférieurs ne peuvent pas publier.
Connecter WordPress
Il y a deux façons de procéder. Toutes deux aboutissent à la même connexion.
Ouvrir Channels et choisir WordPress
Sélectionnez Channels, puis Connect channel, et choisissez WordPress — il figure sous Blogging.
Saisir l'adresse de votre site
Saisissez l’adresse du site, par exemple https://example.com. Ocoya s’en sert pour trouver l’API REST du site.
Approuver sur votre propre site, ou coller un mot de passe
Ocoya peut vous envoyer vers l’écran Authorize application de votre site, où WordPress crée le mot de passe et le lui transmet. Si vous préférez ne pas être redirigé, générez-en un vous-même sous Users → Profile → Application Passwords et collez-le avec votre nom d’utilisateur.
La révocation se fait sur votre site : supprimez le mot de passe d’application sous Users → Profile et Ocoya ne peut plus y accéder. La connexion s’appelle Ocoya sur cet écran, il est donc clair laquelle supprimer.
Ce que vous pouvez publier
| Type de publication | Pris en charge |
|---|---|
| Texte | Oui — obligatoire |
| Titre | Facultatif |
| Images | Oui — jusqu’à 10 |
| GIF | Oui |
| Vidéo | Non |
Les publications sont publiées en direct, et non en brouillons sur le site.
Pas de vidéo. Un site WordPress peut en héberger, mais avec des tailles et des encodages qui dépendent de la limite d’envoi propre à votre site plutôt que d’une publication programmée — Ocoya la refuse donc plutôt que d’échouer en plein envoi.
Le titre
Chaque publication WordPress porte un titre, mais vous n’avez pas à en saisir un. Laissez le champ vide et Ocoya prend la première ligne de votre légende au moment de la publication.
C’est la différence avec DEV.to, où le champ est obligatoire dans le composer : ici, rien n’est jamais rejeté faute de titre.
Les images vont dans votre médiathèque
Les images sont importées dans la médiathèque du site plutôt que liées depuis Ocoya. Deux conséquences à connaître :
- La publication conserve ses images même après que vous avez remplacé ou supprimé le visuel dans Ocoya.
- Elles apparaissent dans votre médiathèque, là où vous vous attendez à les trouver.
Les images se placent à la fin du corps, et non dans l’emplacement de l’image mise en avant. Cet emplacement ne contient qu’une seule couverture que votre thème recadre à sa façon — une seule image y survivrait, placée à un endroit que vous n’avez pas choisi. Dans le corps, chaque image survit avec ses propres proportions.
Les limites de WordPress
| Titre | 200 caractères, facultatif |
| Corps | 100 000 caractères |
| Images | 10 |
| Vidéo | Non prise en charge |
WordPress stocke le corps dans une colonne de texte et n’impose aucune longueur propre : la limite du corps est donc un garde-fou d’Ocoya. Le nombre d’images aussi — la vraie limite de votre site est la taille d’envoi, que lui seul connaît.
Problèmes fréquents
“WordPress sites must be connected over https.” L’adresse du site est en http. Un mot de passe d’application ne peut pas être envoyé en toute sécurité par ce biais.
“Your WordPress site did not return a REST API response. The REST API may be disabled or blocked by a security plugin.” Quelque chose sur le site bloque /wp-json. Les plugins de sécurité et de pare-feu en sont la cause habituelle.
“This WordPress user is not allowed to publish posts. Connect a user with the Author, Editor or Administrator role.” Le rôle de l’utilisateur connecté est trop bas.
“WordPress posts require text.” La publication a des images mais pas de corps.
“WordPress did not store the uploaded image.” L’envoi du média a été refusé — généralement à cause de la limite de taille d’envoi du site, ou d’un type de fichier qu’il n’accepte pas.
“Connection to your profile has expired. Please reconnect.” Le mot de passe d’application a été révoqué ou modifié. Générez-en un nouveau et reconnectez. Voir Reconnecter un canal.