Rivoluziona il tuo sito con le WP REST API - Andrea Cardinali

RIVOLUZIONA IL
TUO SITO CON LE
WP REST API
Andrea Cardinali
T.C. Informatica

CHI SONO
• DEVELOPER & SEO @ T.C. INFORMATICA
• LAVORO CON WP DAL 2009
• CO-ORGANIZZATORE DEL WP ROMAGNA MEETUP
• I <3 TALK ABOUT WORDPRESS
• https://wordpress.tv/?s=andrea+cardinali
@andreacardinali - #WCRM - WordCamp Roma 15/16 Dicembre 2017

I <3 TALK ABOUT WORDPRESS
• INDICIZZAZIONE & CRAWL BUDGET OPTIMIZATION
(seoCMS ‘16)
• VAGRANT E SVILUPPO (WCMIL ‘16)
• WP-CLI (WCTRN ‘17)
• SEO, HTTPS e HTTP/2 (seoCMS 17)
• WEB PERFOMANCE E HTTP/2 (WMF ‘17)
• REALIZZARE SITI CHE CARICANO IN 1s (WCMIL ‘17)

DI COSA PARLERÒ
• COSA SONO LE REST API
• VANTAGGI
• COME FUNZIONANO
• PLUGINS
• DOMANDE

#WCRM
@andreacardinali

SONDAGGIO

CHI UTILIZZA WP 4.7
O SUPERIORE?

PLUGIN CHE UTILIZZANO LE
REST API
• https://wordpress.org/plugins/wp-front-end-editor/
• https://it.wordpress.org/plugins/woocommerce/
• https://it.wordpress.org/plugins/contact-form-7/

LA STORIA IN BREVE
• NASCONO NEL 2012 da
RACHEL BAKER & RYAN MC CUE
• INCLUSE NEL CORE DALLA v.4.4
(8 Dicembre 2015)
• ATTIVE DI DEFAULT DALLA v.4.7
(6 Dicembre 2016)

V2
VERSIONE ATTUALE
https://developer.wordpress.org/rest-api/

LE REST API SONO
UN’INTERFACCIA DI
PROGRAMMAZIONE
APPLICATIVA RESTFUL HTTP
JSON […] EVOLUZIONE
DELLA PRECEDENTE API
BASATA SU PROTOCOLLO
XML-RPC

…COME SE
FOSSE ANTANI

«Non hai veramente
capito qualcosa fino a
quando non sei in
grado di spiegarlo a tua
nonna»
Albert Einstein

JSON REST API

JAVA
SCRIPT
OBJECT
NOTATION

JSON È UN FORMATO
DI
RAPPRESENTAZIONE
TESTUALE DEI DATI

Application
Programming
Interface

UN API È UN INSIEME
DI CONVENZIONI
CHE PERMETTE LA
COMUNICAZIONE TRA
SOFTWARE

UN API
«NASCONDE» LA
COMPLESSITÁ DEL
SOFTWARE

REpresentational
State
Transfer

REST È UN TIPO DI
ARCHITETTURA
SOFTWARE

REST DEFINISCE UN
INSIEME DI REGOLE
(PRINCIPI ARCHITETTURALI)
PER LA
PROGETTAZIONE DI
UN SISTEMA
https://it.wikipedia.org/wiki/Representational_State_Transfer

REST UTILIZZA IL
PROTOCOLLO
HTTP(/S)

CARATTERISTICHE REST
• Identificazione delle risorse
• Utilizzo esplicito dei metodi HTTP
• Comunicazione senza stato
• Risorse autodescrittive
• Collegamenti tra risorse

UNA RISORSA È UN
QUALSIASI ELEMENTO
OGGETTO DI
ELABORAZIONE

UNA RISORSA È
IDENTIFICATA
UNIVOCAMENTE DA
UN URI

UNIFORM
RESOURCE
IDENTIFIER

Uniform RESOURCE
IDENTIFIER
/wp-json/wp/v2/posts/123

CARATTERISTICHE REST
• Identificazione delle risorse
• Utilizzo esplicito dei metodi HTTP
• Risorse autodescrittive
• Collegamenti tra risorse
• Comunicazione senza stato

METODI HTTP
(HTTP VERBS)

UN METODO HTTP
È UN COMANDO
CHE IL CLIENT INVIA
AL SERVER

METODO HTTP
GET /contatti/
POST/wp-admin/admin-ajax.php

I METODI HTTP
PERMETTONO LA
MANIPOLAZIONE DI
UNA RISORSA

I METODI HTTP
CORRISPONDONO
ALLE AZIONI CRUD

CRUD = AZIONI
FONDAMENTALI CHE
POSSONO ESSERE
ESEGUITE SU UNA
RISORSA

CREATE
READ
UPDATE
DELETE

AZIONI CRUD E METODI HTTP
AZIONE METODO HTTP RISORSA
CREATE POST /posts/
READ GET /posts/123
UPDATE PUT /posts/123
DELETE DELETE /posts/123

COMUNICAZIONE
SENZA STATO
(STATELESS)

IL SERVER NON
CONSERVA LO
«STATO»

OGNI RICHIESTA DEL
CLIENT DEVE
CONTENERE TUTTE LE
INFO NECESSARIE AL
SERVER A
COMPRENDERLA […]
https://stackoverflow.com/a/34131829

CON LE REST API
WP PARLA UN
LINGUAGGIO
UNIVERSALE

WORDPRESS AS
BACKEND

FRAMEWORK JS

SINGLE PAGE APP

MOBILE APP

SCALABILITÁ

AGGREGARE
CONTENUTI

IoT

L’UNICO LIMITE È LA
TUA
IMMAGINAZIONE

AUTENTICAZIONE

LE REST API
FUNZIONANO
SOLO CON I COOKIES
DI AUTENTICAZIONE
https://developer.wordpress.org/rest-api/using-the-rest-api/authentication/

NO COOKIES NO
PARTY?

HTTP authentication is
presumed to be stateless:
all of the information
necessary to authenticate a
request MUST be provided
in the request, rather than
be dependent on the server
remembering prior requests.
https://tools.ietf.org/html/rfc7235

PER SFRUTTARE LE
API IN SCRITTURA
(CRUD) È NECESSARIO
IMPLEMENTARE UN
MECCANISMO DI AUTH

ROUTES

UNA ROUTE È UNA
PARTE DI URI

ROUTE
/wp-json/wp/v2/posts/123
BASE PATH
ROUTE
URI

1 RISORSA = 1 ROUTE *

ENDPOINT

ENDPOINT =
ROUTE + METODO HTTP
https://developer.wordpress.org/rest-api/extending-the-rest-api/routes-and-endpoints/

1 ROUTE 3 ENDPOINT
GET /wp-
json/wp/v2/posts/123
PUT/wp-
DELETE /wp-

AD OGNI ENDPOINT
È ASSOCIATA UNA
FUNZIONE DI
CALLBACK
https://developer.wordpress.org/rest-api/extending-the-rest-api/routes-and-endpoints/

ROTTE PREDEFINITE
Resource Base Route
Posts /wp/v2/posts
Post Revisions /wp/v2/revisions
Categories /wp/v2/categories
Tags /wp/v2/tags
Pages /wp/v2/pages
Comments /wp/v2/comments
Taxonomies /wp/v2/taxonomies
Media /wp/v2/media
Users /wp/v2/users
Post Types /wp/v2/types
Post Statuses /wp/v2/statuses
Settings /wp/v2/settings
https://developer.wordpress.org/rest-api/reference/

REST API &
TIPI DI POST
PERSONALIZZATI

DISATTIVATE DI
DEFAULT PER I
CUSTOM POST TYPE

ATTIVARE LE REST API PER I
CPT
$args = array(
'public' => true,
'show_in_rest' => true,
'label' => 'Books'
);
register_post_type( 'book',
$args );

I CAMPI
PERSONALIZZATI
NON SONO VISIBILI
DI DEFAULT

È POSSIBILE
MOSTRARE I CAMPI
PERSONALIZZATI
NELLA RISPOSTA
UTILIZZANDO
register_meta()
https://developer.wordpress.org/reference/functions/register_meta/

È POSSIBILE
AGGIUNGERE
REST FIELDS
PERSONALIZZATI CON
register_rest_field()
https://developer.wordpress.org/reference/functions/register_rest_field/

CMB2 SUPPORTA LE
REST API

CMB2 SUPPORTA LE REST API
function yourprefix_register_demo_metabox() {
$cmb = new_cmb2_box( array(
'id' =>
'cmb2_info_metabox',
'title' => 'Information',
'object_types' => array( 'post' ),
'show_in_rest' =>
WP_REST_Server::READABLE
) );
}
add_action( 'cmb2_init',
'yourprefix_register_demo_metabox' );
https://github.com/CMB2/CMB2/wiki/REST-API

ACF SUPPORTA LE
REST API
(TRAMITE PLUGIN)
https://it.wordpress.org/plugins/acf-to-rest-api/

COME VERIFICARE
SE LE REST API
SONO ATTIVE?

VERSIONE WP > 4.7

example.com/wp-json/

È INDIFFERENTE
UTILIZZARE LE REST
API O admin-ajax?

LE REST API NON
SCATENANO
admin_init A
DIFFERENZA DI
admin-ajax.php

LE REST API SONO
PIÙ PERFORMANTI
(BENCHMARK)

CODICE SCRITTO
MEGLIO

POSSO
DISATTIVARE LE WP
REST API?

PUOI PROTEGGERE LE
ROUTES ATTRAVERSO
UN MECCANISMO DI
AUTENTICAZIONE

WP NON PREVEDE
UNA ROUTE CHE FA
XYZ

LE REST API SONO
PERSONALIZZABILI
ED ESTENDIBILI

SE NON ESISTE
L’ENDPOINT PUOI
SEMPRE CREARLO

AGGIUNGERE UN ENDPOINT
add_action( 'rest_api_init',
function ()
{
register_rest_route(
'myplugin/v1',
'/author/(?P<id>d+)', array(
'methods' => 'GET',
'callback' => 'my_awesome_func',
) );
} );
https://developer.wordpress.org/rest-api/extending-the-rest-api/adding-custom-endpoints/

POSSO UTILIZZARE
LE API
INTERNAMENTE?

RICHIAMARE INTERNAMENTE
$request = new WP_REST_Request( 'GET',
'/wp/v2/posts' );
// Set one or more request query
parameters
$request->set_param( 'per_page', 20 );
$response = rest_do_request( $request );

RICAPITOLANDO
• Le REST API permettono a un qualsiasi client
che «parla» http e json di interagire con
WordPress
• Le REST API richiedono un meccanismo di
autenticazione
• È possibile estendere la risposta delle api
• È possibile creare nuovi endpoint
• Ogni volta che provi disattivare le REST API
muoiono delle fatine

DEV TOOLS
CLIENT HTTP PER TESTARE LE API
https://www.getpostman.com/
BASIC AUTH (SOLO PER I TEST)
https://github.com/WP-API/Basic-Auth
Network inspector (Chrome e Firefox)
LOGGER PER API
https://it.wordpress.org/plugins/wp-rest-api-
log/

PLUGIN UTILI
DISABILITARE LE API PER GLI UTENTI NON
LOGGATI
https://it.wordpress.org/plugins/disable-json-api/
ACF TO REST API
https://it.wordpress.org/plugins/acf-to-rest-api/
REST MANAGER - DISABILITARE PLUGIN PER
ROUTE
https://it.wordpress.org/plugins/rest-manager/
WP-CLI RESTFUL
https://github.com/wp-cli/restful

PLUGIN PER AUTENTICAZIONE
COOKIELESS
OAUTH 1
https://wordpress.org/plugins/rest-api-
oauth1/
JWT AUTH (JSON WEB TOKEN AUTH)
https://wordpress.org/plugins/jwt-
authentication-for-wp-rest-api/
BASIC AUTH (SOLO PER I TEST)
https://github.com/WP-API/Basic-Auth

APPROFONDIMENTI
• https://developer.wordpress.org/rest-api/
• https://skillsandmore.org/rest-e-restful-api-
introduzione/
• https://skillsandmore.org/rest-api-
wordpress-poteri/

WORDPRESS MEETUP ROMAGNA
QUANDO:
ogni 1°Martedì del mese (9 Gennaio 2018)
DOVE:
Dinamo Coworking Space Cesena
PERCHÉ:
Per parlare di WordPress, conoscere bella
gente e condividere le proprie esperienze
wpromagna.com
@romagnawp

GRAZIE!
• Twitter:@andreacardinali
• Slideshare:
http://www.slideshare.net/andreacardinali
• Wordcamp TV:
https://wordpress.tv/?s=andrea+cardinali
• Website: https://www.andreacardinali.it/
• Website: https://www.tcinformatica.net/

Rivoluziona il tuo sito con le WP REST API - Andrea Cardinali

Recommended

Recommended

More Related Content

Similar to Rivoluziona il tuo sito con le WP REST API - Andrea Cardinali

Similar to Rivoluziona il tuo sito con le WP REST API - Andrea Cardinali (20)

More from Andrea Cardinali

More from Andrea Cardinali (11)

Rivoluziona il tuo sito con le WP REST API - Andrea Cardinali