La WP REST API est là ! Mais quelles sont les implications techniques ? Nous allons faire le tour de la partie technique qui se cache derrière /wp-json/ mais aussi les possibilités en Javascript pour rendre son site plus dynamique et rapide ! Découvrons ensemble les mutiples facettes et possibilités de la WP API qui attend le/la dev en embuscade.

1. WP API : LA REVIEW TECHNIQUE
WORDCAMP PARIS 2016

2. QUI SUIS-JE ?
Développeur PHP et JavaScript
Développeur avec WordPress depuis 6 ans
Directeur technique à @be_api

3. REST
Un ensemble de bonne pratiques pour la construction d'une
API
Chaque contenu est défini comme une ressource
Utilisation des verbes HTTP
Des "routes" claires et formatées

4. RÉCUPÉRER LES DERNIERS
ARTICLES
GET monsite.fr/wp­json/wp/v2/posts

6. RÉCUPÉRER LE CONTENU D'UN
ARTICLE
GET monsite.fr/wp­json/wp/v2/posts/15/

8. METTRE À JOUR UN CONTENU
POST|PUT|PATCH monsite.fr/wp­json/wp/v2/posts/15/

9. 4.4 -> 4.5
LA WP API
Le projet
ou pas...

10. 3 CLASSES 4.4
WP_REST_Server
WP_REST_Request
WP_REST_Response

11. WP_REST_REQUEST
Requête du client
Contient toutes les constantes magiques
Sanitize les données
Valide les paramètres

12. WP_REST_SERVER
Contient les verbes autorisés
Récupère une WP_REST_Request
dispatch sur les controllers
Attend une WP_REST_Response
Sert la WP_REST_Response

13. WP_REST_RESPONSE
Etend WP_HTTP_Response
Contient les données retournées par les controllers
Ajoute les "links" d'une ressource
collection
description du type de contenu
taxonomies
meta
...

14. source : https://hmn.md/uploads/2016/01/Talking-to-25-of-the-Web.pdf

15. CLASSES 4.5
Base : WP_REST_Controller
12 Classes pour les controlleurs des contenus

16. WP_REST_CONTROLLER
Classe abstraite
1 méthode à redéfinir : register_routes
12 méthodes implémentables
get_items
get_item
create_item
update_item
delete_item
....

17. RÉCUPÉRER UN CONTENU :
GET_ITEM

18. MAIS D'ABORD :
GET_ITEM_PERMISSIONS_CHECK

19. MAIS D'ABORD :
CHECK_READ_PERMISSIONS

21. MÊME PRINCIPE POUR
create
update
delete

22. QUELQUES MÉTHODES
IMPORTANTES
get_item_schema
prepare_item_for_response
prepare_links

23. GET_ITEM_SCHEMA
Basé sur http://json-schema.org/
Décrit l'objet retourné
Propriétés et fonctions
Filtre les valeurs au moment du retour

26. PREPARE_ITEM_FOR_RESPONSE
Récupère les données avant retour
Filtre en fonction du contexte (view, edit) et du schema
Ajoute les champs additionnels
Ajoute les 'links'
Retourne une WP_REST_Response

29. PREPARE_LINKS
Hypermedia (HAL)
Liaison forte entre les contenus
API auto découvrable
author, collection, enclosure, related, replies, up

32. ?_embed

34. WP_REST_POSTS_CONTROLLER

36. ETENDABLE ET COMPATIBLE TOUT
TYPE DE CONTENU ET TAXONOMIE

37. TYPE DE CONTENU
show_in_rest : bool
rest_base : string
rest_controller_class : WP_REST_Posts_Controller

38. TAXONOMIE
show_in_rest : bool
rest_base : string
rest_controller_class : WP_REST_Terms_Controller

39. INITIALISATION DES ROUTES
create_initial_rest_routes
Types de contenus
Taxonomies
Champs personnalisés
Révisions
Collection des type de contenus
Collection des taxonomies
Collection des status
Utilisateurs
Commentaires
...

41. EXEMPLE PHP

42. ADAPTATION : BEA POST VIEW
COUNTER
Compteur de vues par jour, mois, semaine, année
admin-ajax.php vs Rest API

43. ROUTES
Namespace et version
POST monsite.fr/wp­json/bea­post­view­counter/1.0/{post_id}
GET monsite.fr/wp­json/bea­post­view­counter/1.0/{post_id}

44. BEA_PVC_COUNTER_REST_CONTRO
LLER
register_routes
get_item
create_item
create_item_permissions_check
prepare_item_for_database

46. monsite.fr/wp­json/

48. INTÉGRER DANS MA RÉPONSE POST

49. FIELD

50. monsite.fr/wp­json/wp/v2/posts/{post_id}/

51. EMBED

53. monsite.fr/wp­json/wp/v2/posts/{post_id}/?_embed
monsite.fr/wp­json/bea­post­view­counter/1.0/{post_id}/

54. EXEMPLE JAVASCRIPT

55. CRÉATION : EDITEUR FRONT OFFICE
Modifier le titre et l'image depuis le front office

56. PHP
56 lignes, 1 classe

58. JAVASCRIPT
111 lignes bien indentées
wp-api.js + jQuery + Backbone + Underscore

59. RÉCUPÉRER LES DONNÉES
monsite.fr/wp­json/wp/v2/posts/{post_id}/

61. CLICK

62. FOCUSOUT

63. CONCLUSION
Etendable
Authentifications
WP CLI
Possibilités infinies
E-Commerce
Multilingue
Posts to posts
Advanced custom fields
Objet connecté
Dashboard dynamique

64. DES QUESTIONS ?