Utilizarea API-ului Envato cu WordPress

Astăzi vom discuta cum să folosim API-ul Envato în WordPress și să creăm un cod scurt WordPress care să promoveze produsele Envato Marketplace din interiorul site-ului nostru WordPress. Vom combina puternicul Envato API, flexibilitatea WordPress și un pic de creativitate, pentru a construi un plugin uimitor pentru site-ul nostru.

Să ne stabilim scopul

În acest tutorial ne vom concentra pe:

• Câteva cunoștințe de bază despre API-ul Envato
• Cum se utilizează datele rezultatelor API în WordPress
• Creați un Shortcode WordPress care promovează articolele Envato Marketplace pe site-ul nostru WordPress.

Să intrăm în primul!

Pasul 1: Înțelegerea API-ului Envato

Envato oferă un API care permite dezvoltatorilor să obțină unele informații despre articolele Envato Marketplace, informații despre utilizatori, proiecte populare și așa mai departe. Toate întrebările posibile sunt enumerate în documentația oficială. În acest articol discutăm numai API public.

API-ul public Envato are următoarea structură.

 http://marketplace.envato.com/api/edge/set.json

Cuvantul a stabilit trebuie să fie înlocuită cu o opțiune afișată în coloana setată a documentației API. Deci, dacă vrem toate informațiile despre un articol de pe piață, trebuie să îl înlocuim a stabilit cu articol: the_item_id. Adresa URL a solicitării finale va fi:

 http://marketplace.envato.com/api/edge/item:1263846.json

Puteți încerca să inserați adresa URL de mai sus în browserul dvs. Web și să vedeți datele returnate.

Putem, de asemenea, să concatenăm mai multe setare într-o singură cerere pentru a obține mai multe date. De exemplu, dorim datele despre elemente și informațiile despre autor. Astfel, adresa URL anterioară va deveni:

 http://marketplace.envato.com/api/edge/item:1263846+user:evoG.json

API-ul Envato returnează JSON, așa că în paragraful următor vom arăta cum să o gestionăm în WordPress.

Pasul 2: Cum se utilizează rezultatele API în WordPress

În acest tutorial nu vom discuta despre cum să creați un plugin WordPress, dar ne vom concentra pe câteva tehnici de utilizare a API-ului în WordPress:

• Trimiteți cererea API
• Gestionați datele despre rezultate (șirul JSON)

Funcția de mai jos aduce datele de pe serverul Envato și returnează o matrice PHP care conține toate informațiile pe care le dorim.

 / ** * @param String $ item_id - ID-ul unui element Envato Marketplace * @returns Array - informatia elementului * / function WPTP_get_item_info ($ item_id) / * Setarea URL-ului API,% s va fi inlocuit cu ID- * / $ api_url = "http://marketplace.envato.com/api/edge/item:%..json"; / * Returnați datele utilizând funcția WordPress wp_remote_get () * / $ response = wp_remote_get (sprintf ($ api_url, $ item_id)); / * Verificați erorile, dacă există erori return false * / if (is_wp_error ($ response) sau (wp_remote_retrieve_response_code ($ response)! = 200)) return false;  / * Transformarea șirului JSON într-o array PHP * / $ item_data = json_decode (wp_remote_retrieve_body ($ response), true); / * Verificați datele incorecte * / if (! Is_array ($ item_data)) return false;  / * Returnați elementul de informație al elementului * / return $ item_data; 

Putem îmbunătăți funcția de mai sus. Pentru a preveni stresul pe serverul API Envato, putem cache datele de date și să solicităm din nou informațiile după un timp de expirare. WordPress ne oferă câteva funcții pentru implementarea acestei funcții. Să o adăugăm.

 / ** * @param String $ item_id - ID-ul unui element Envato Marketplace * @returns Array - Informatia elementului * / function WPTP_get_item_info ($ item_id) / * Timeout cache de date in cateva secunde - din fiecare pagină refresh * / $ CACHE_EXPIRATION = 3600; / * Setați ID-ul tranzitoriu pentru cache * / $ transient_id = 'WPTP_envato_item_data'; / * Obțineți datele stocate în cache * / $ cached_item = get_transient ($ transit_id); / * Verificați dacă funcția trebuie să trimită o nouă solicitare API * / if (! $ Cached_item || ($ cached_item-> item_id! = $ Item_id)) / * Setați adresa URL API,% s va fi înlocuită cu elementul ID * / $ api_url = "http://marketplace.envato.com/api/edge/item:%..json"; / * Returnați datele utilizând funcția WordPress wp_remote_get () * / $ response = wp_remote_get (sprintf ($ api_url, $ item_id)); / * Verificați erorile, dacă există erori return false * / if (is_wp_error ($ response) sau (wp_remote_retrieve_response_code ($ response)! = 200)) return false;  / * Transformarea șirului JSON într-o array PHP * / $ item_data = json_decode (wp_remote_retrieve_body ($ response), true); / * Verificați datele incorecte * / if (! Is_array ($ item_data)) return false;  / * Pregătirea datelor pentru cache * / $ data_to_cache = new stdClass (); $ data_to_cache-> item_id = $ item_id; $ data_to_cache-> item_info = $ item_data; / * Setați datele elementului tranzitoriu - cache * / set_transient ($ transient_id, $ data_to_cache, $ CACHE_EXPIRATION); / * Returnați elementul informativ al elementului * / return $ item_data;  / * Dacă elementul este deja stocat în memoria cache, returnați informațiile cached * / return $ cached_item-> item_info; 

Acum funcția de bază a pluginului nostru WordPress este gata. Am folosit câteva funcții WordPress care ne ajută să economisim timp. Toate informațiile despre ele sunt explicate în Codul oficial WordPress.

• wp_remote_get () - Obține o adresă URL utilizând metoda HTTP GET
• wp_remote_retrieve_response_code () - Verifică că nu există erori în răspunsul brut
• wp_remote_retrieve_body () - Preia corpul unei cereri HTTP deja preluate.
• set_transient () - Datele cache-urilor
• get_transient () - Obține date cache

Pasul 3: Construiți Shortcode WordPress

În următorii pași vom codifica un plugin util WordPress care ne permite să afișăm câteva informații despre un element Envato Marketplace. Codul de mai jos este bine comentat, astfel încât să puteți înțelege cu ușurință fiecare linie. Pentru mai multe detalii despre scrierea unui Plugin WordPress și API-ul WordPress Shortcode API consultați documentația online din Codul WordPress.

Să începem

Să scriem informațiile antetului pluginului nostru

  
Adăugați codul scurt WordPress
 
Acum scriem codul pentru a adăuga codul scurt și funcționalitățile acestuia.
 
 ($ atts); / * Validare * / dacă (gol ($ item_id)) return "
Introduceți un ID de element Envato Marketplace.
"* / * Obțineți date din API * / $ item = WPTP_get_item_info ($ item_id); / * Validare - Verificați dacă ceva a mers prost * / if ($ item === false)
Ups! Ceva a mers prost. Verificați ID-ul elementului și încercați din nou.
"/ * Pregătiți pluginul HTML * / $ html ="; "* / * Formatarea elementului $ $ array * / $ item = $ item ['item']; $ html. = ' 
 
'$ Element.'
 
 
 
 evaluare“. WPTP_get_stars (valoare $). '
  
  
 
  
 '$ De vânzări.' vânzări 
  
  
  
  
  
 $'(Cost $) .round.' numai 
  
  
  
  
  
  
 „; returnați $ html; 
 
Funcția de evaluare stea
 
 WPTP_add_shortcode () funcția de mai sus are WPTP_get_stars () procedură care acoperă numărul de rating pentru stelele HTML. Să o implementăm.
 
 Nu rata încă