Comment utiliser WordPress comme back-end : ressources pour démarrer avec l'API REST

Publié: 2019-06-23

L'API WordPress REST existe depuis un certain temps maintenant, mais comprendre ce que c'est et pourquoi c'est important peut ne pas être immédiatement clair pour les nouveaux arrivants et les non-développeurs. Même ainsi, cet outil est pratique à connaître pour les utilisateurs de tous bords, car il vous permet d'utiliser l'interface WordPress familière uniquement comme back-end et de développer le front-end à l'aide d'autres outils et langages.

Cet article fournira une introduction à ce qu'est l'API WordPress REST et de quoi elle est capable. Nous partagerons également quelques étapes pour vous aider à commencer à utiliser WordPress comme back-end pour une application ou un site Web.

Allons-y !

Une introduction à l'API REST WordPress

Il existe de nombreux articles qui expliquent ce qu'est l'API WordPress REST – nous l'avons même déjà couvert – nous allons donc rester bref pour éviter de nous répéter. En termes simples, une interface de programmation d'applications (API) est ce qui permet les connexions entre divers appareils, applications et données.

Une analogie utile consiste à considérer une API comme un serveur livrant des demandes et des réponses entre les convives et la cuisine. Dans cet exemple, vous êtes le restaurant, l'application ou la base de données avec laquelle vous essayez de communiquer est la cuisine et votre « repas » correspond aux données que vous demandez.

Le transfert d'état représentatif (REST) ​​est un « style architectural » ou un type d'API. Il est conçu pour être léger et nécessite une bande passante minimale lorsqu'il est utilisé. À l'aide d'une API REST, vous pouvez effectuer quatre types de requêtes de base :

  • GET : Récupère les données de l'appareil, de l'application ou de la base de données avec laquelle vous communiquez.
  • POST : ajoute des données à l'appareil, à l'application ou à la base de données avec laquelle vous communiquez.
  • PUT : met à jour les données déjà existantes sur l'appareil, l'application ou la base de données avec laquelle vous communiquez.
  • SUPPRIMER : supprime les données de l'appareil, de l'application ou de la base de données avec laquelle vous communiquez.

L'API WordPress REST utilise JavaScript Object Notation (JSON) pour renvoyer des données. Ainsi, lorsque vous mettez tout cela ensemble, vous obtenez une méthode légère de communication des requêtes GET , POST , PUT et DELETE entre les sites Web WordPress et d'autres plates-formes via l'utilisation de JSON.

Comprendre ce que l'API REST WordPress peut faire

Il peut sembler que l'API REST WordPress ne vous soit pas très utile, surtout si vous n'êtes pas un développeur. Cependant, il y a beaucoup de choses que l'API peut faire que même les utilisateurs intermédiaires de WordPress pourraient vouloir essayer, comme :

  • Synchronisation du contenu. Vous pouvez utiliser l'API REST pour permettre à différents sites WordPress de communiquer entre eux. Par exemple, vous pouvez tester une refonte de site Web en synchronisant le contenu entre votre site actuel et la version remaniée.
  • Contenu de syndication. Dans le même ordre d'idées, vous pouvez également combiner le contenu de plusieurs sites Web différents. Prenez une entreprise avec plusieurs emplacements, chacun avec son propre site - vous pouvez syndiquer le contenu des trois sur un autre site complet.
  • Mise en place d'une feuille Google de données WordPress. En utilisant l'API REST, vous pouvez connecter votre site WordPress et Google Sheets. Cela pourrait vous aider à organiser vos publications dans une feuille de calcul pour rester au courant des mises à jour de contenu.
  • Création d'applications mobiles. En connectant votre site WordPress à une application frontale personnalisée, vous pouvez créer une application mobile pour compléter votre site de bureau. C'est pratique pour des situations telles que la création d'une version d'application d'un magasin WooCommerce.
  • Utilisation de WordPress « sans tête ». Si les options d'affichage frontal pour WordPress ne le font pas pour vous, l'API REST vous permet d'utiliser WordPress pour toute votre création et gestion de contenu tout en servant le contenu aux utilisateurs sur un site Web personnalisé ou une application Web frontale. Ceci est connu sous le nom de WordPress « sans tête ».

Une recherche rapide sur Google révélera de nombreuses autres façons d'utiliser l'API REST de WordPress. Cependant, pour le reste de cet article, nous nous concentrerons sur l'utilisation de WordPress comme back-end pour une application ou un site Web.

Comment utiliser WordPress comme back-end (en 3 étapes)

Il existe de nombreuses façons d’utiliser WordPress comme back-end. En tant que tel, cet article est plus une introduction générale à l'utilisation de l'API WordPress REST, plutôt qu'un guide complet pour créer une application ou un site Web découplé.

Bien que les étapes ci-dessous soient simplifiées pour vous aider à démarrer, cela signifie que vous devrez probablement rechercher des conseils supplémentaires spécifiques à votre projet. Cependant, connaître ces bases facilitera le processus.

Étape 1 : Chargez le contenu dans WordPress et testez l'API REST

La première étape pour utiliser WordPress comme back-end est remarquablement similaire au démarrage d'un site Web WordPress. Vous aurez besoin d'une installation WordPress chargée de tout le contenu que vous souhaitez sur votre site Web ou votre application. Il peut s'agir d'une installation active ou d'une nouvelle que vous avez configurée pour votre projet.

Vous devrez également travailler sur la création de publications et de pages, l'ajout de fichiers multimédias et tout ce dont votre projet a besoin en termes de contenu. Fondamentalement, vous devez obtenir tout ce que vous voulez avoir sur votre site ou votre application dans WordPress, car c'est là que vous gérerez le contenu.

Une fois que vous avez tout configuré, vous souhaiterez probablement effectuer un test pour voir comment fonctionne l'API REST de WordPress. Heureusement, vous pouvez le faire directement dans votre navigateur. Tapez simplement votre domaine suivi de wp-json/wp/v2/posts :

Le JSON est revenu après avoir demandé toutes les publications via l'API WordPress REST.

Vous devriez voir quelque chose comme l'image ci-dessus, bien que la quantité de JSON affichée diffère selon la densité du site. Vous avez maintenant utilisé avec succès l'API REST WordPress pour renvoyer les données de tous vos articles. Le manuel de l'API REST contient des informations sur la façon de procéder pour d'autres informations également.

Pour récapituler cette étape :

  1. Tout d'abord, nous avons configuré une installation WordPress pour servir de back-end à notre application/site Web.
  2. Nous avons créé le contenu que nous souhaitons afficher sur le frontend de notre projet dans WordPress sous forme de publications, de pages, etc.
  3. Pour voir l'API REST en action, nous avons renvoyé le JSON pour tous nos messages dans le navigateur.

Une fois que vous sentez que vous maîtrisez la manière dont toutes ces pièces fonctionnent ensemble, vous pouvez passer du back-end de votre site pour commencer à travailler sur le front-end.

Étape 2 : Configurez le front-end de votre application ou de votre site Web à l'aide de React

Maintenant que vous avez compris les aspects « en coulisses », vous devrez travailler sur la partie de votre application ou de votre site Web que les utilisateurs pourront réellement voir. Un itinéraire populaire pour y parvenir pour les utilisateurs de WordPress est via React :

La page d'accueil de React.

Pour les non-initiés, React est (comme le dit le slogan de l'image ci-dessus) une bibliothèque JavaScript pour créer des interfaces utilisateur. Il vous permet de créer des éléments appelés « composants », qui deviennent les éléments qui composent le front-end de votre application ou de votre site Web. Cela peut inclure des publications, des boutons, des images ou tout autre nombre d'autres caractéristiques et fonctions.

Il existe également de nombreuses autres plates-formes que vous pourriez envisager pour construire votre projet, alors faites le tour avant de vous engager. Les tenants et aboutissants complets de l'utilisation de React (ou similaire) dépassent le cadre de cet article. Cependant, une fois que vous avez choisi une méthode pour créer votre frontal, prenez soin de toute configuration afin d'être prêt à commencer à créer des composants.

Étape 3 : connectez votre back-end WordPress à votre front-end

À présent, vous devriez avoir votre back-end WordPress et votre front-end React (ou autre). Maintenant, il vous suffit de les faire se parler pour que les données de WordPress s'affichent dans votre application ou votre site Web. C'est là qu'intervient l'API REST de WordPress.

Puisque vous avez déjà testé l'API et constaté qu'elle peut renvoyer des données pour vos publications et autres contenus, vous savez qu'elle fonctionne et qu'elle est prête à l'emploi. Ensuite, vous devrez créer des composants qui utilisent l'API REST pour récupérer les publications de WordPress et les afficher sur votre front-end.

Si vous avez une expérience de codage minimale, c'est là que les choses vont devenir assez délicates. Si vous espérez lancer votre application ou votre site Web rapidement, vous feriez probablement mieux d'embaucher un développeur pour le configurer pour vous. Cependant, si vous êtes prêt à y consacrer du temps, vous pouvez commencer à travailler lentement sur les composants et à apprendre au fur et à mesure.

Nous avons écrit sur la façon de créer un composant React pour récupérer tous vos articles WordPress et les afficher dans une application dans le passé. Vous pouvez utiliser cet article comme exercice pour commencer ou consulter certains cours de formation en ligne.

Une fois que vous avez utilisé l'API WordPress REST pour obtenir tout votre contenu sur votre front-end, vous pouvez commencer à créer des composants plus (et de plus en plus complexes), puis travailler sur la personnalisation du front-end de votre site - tout en utilisant WordPress pour continuer à créer et à gérer du contenu.

Conclusion

Il y a certainement une courbe d'apprentissage en ce qui concerne l'API REST WordPress, surtout si vous avez des connaissances minimales en codage. Cependant, une fois que vous avez compris, cette fonctionnalité peut vous aider à développer vos bases de base pour utiliser WordPress comme back-end pour votre propre application ou site Web personnalisé.

Cet article a fourni quelques étapes de base simplifiées pour utiliser WordPress en tant que back-end. Récapitulons-les rapidement :

  1. Chargez du contenu dans WordPress et testez l'API REST.
  2. Configurez le front-end de votre application ou de votre site Web à l'aide de React.
  3. Connectez votre back-end WordPress à votre front-end React.

Avez-vous des questions sur l'API REST ou sur l'utilisation de WordPress comme back-end ? Demandez-leur dans la section commentaires ci-dessous!

Image miniature de l'article Jesus Sanz / shutterstock.com