Verwenden der Envato-API mit WordPress

Heute werden wir über die Verwendung der Envato-API in WordPress diskutieren und einen WordPress-Shortcode erstellen, der unsere Envato Marketplace-Artikel in unserer WordPress-Site bewirbt. Wir werden die leistungsstarke Envato-API, die Flexibilität von WordPress und ein wenig Kreativität kombinieren, um ein erstaunliches Plugin für unsere Website zu erstellen.

Lassen Sie uns unser Ziel festlegen

In diesem Tutorial konzentrieren wir uns auf:

• Grundkenntnisse über die Envato-API
• Verwendung von API-Ergebnisdaten in WordPress
• Erstellen Sie einen WordPress-Shortcode, mit dem Sie auf unserer Website für Envato Marketplace-Artikel werben können.

Kommen wir zum ersten!

Schritt 1: Informationen zur Envato-API

Envato bietet eine API, mit der Entwickler Informationen zu Envato Marketplace-Elementen, Benutzerinformationen, beliebte Projekte usw. abrufen können. Alle möglichen Fragen sind in der offiziellen Dokumentation aufgeführt. In diesem Artikel behandeln wir nur die öffentliche API.

Die Envato Public API hat die folgende Struktur.

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

Das Wort einstellen muss durch eine Option ersetzt werden, die in der Spalte set der API-Dokumentation aufgeführt ist. Wenn wir also alle Informationen über einen Marktplatzartikel erhalten möchten, müssen wir diese ersetzen einstellen mit item: the_item_id. Die endgültige Anforderungs-URL lautet:

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

Sie können versuchen, die oben angegebene URL in Ihren Webbrowser einzufügen und die zurückgegebenen Daten anzuzeigen.

Wir können auch mehrere verketten Option setzen in einer einzigen Anfrage, um mehr Daten zu erhalten. Zum Beispiel möchten wir die Artikeldaten und ihre Autorinformationen. Die vorherige URL wird also zu:

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

Die Envato-API gibt JSON zurück. Im nächsten Abschnitt wird gezeigt, wie sie in WordPress verwaltet wird.

Schritt 2: Verwendung von API-Ergebnissen in WordPress

In diesem Tutorial werden wir nicht besprechen, wie man ein WordPress-Plugin erstellt, aber wir werden uns auf einige Techniken konzentrieren, um die API in WordPress zu verwenden:

• Senden Sie die API-Anfrage
• Verwalten Sie die Ergebnisdaten (die JSON-Zeichenfolge)

Die folgende Funktion ruft die Daten vom Envato-Server ab und gibt ein PHP-Array zurück, das alle gewünschten Informationen enthält.

 / ** * @param String $ item_id - Die ID eines Envato Marketplace-Elements * @returns Array - Die Elementinformationen * / Funktion WPTP_get_item_info ($ item_id) / * Setzen Sie die API-URL.% s wird durch die Element-ID ersetzt * / $ api_url = "http://marketplace.envato.com/api/edge/item:%s.json"; / * Abrufen von Daten mithilfe der WordPress-Funktion wp_remote_get () * / $ response = wp_remote_get (sprintf ($ api_url, $ item_id)); / * Auf Fehler prüfen, wenn Fehler aufgetreten sind, zurück false * / if (is_wp_error ($ response) oder (wp_remote_retrieve_response_code ($ response)! = 200)) return false;  / * Wandle den JSON-String in ein PHP-Array um * / $ item_data = json_decode (wp_remote_retrieve_body ($ response), true); / * Auf falsche Daten überprüfen * / if (! Is_array ($ item_data)) return false;  / * Element-Info-Array zurückgeben * / return $ item_data; 

Wir können die Funktion oben verbessern. Um den Envato API-Server nicht zu belasten, können wir Artikeldaten zwischenspeichern und die Informationen nach einem Timeout erneut anfordern. WordPress bietet einige Funktionen zur Implementierung dieser Funktion. Lass es uns hinzufügen.

 / ** * @param String $ item_id - Die ID eines Envato Marketplace-Elements * @returns Array - Die Elementinformationen * / function WPTP_get_item_info ($ item_id) / * Zeitüberschreitung des Daten-Cache in Sekunden - Stattdessen wird jede Stunde eine neue Anforderung gesendet von jeder Seitenaktualisierung * / $ CACHE_EXPIRATION = 3600; / * Legt die Transient-ID für das Caching fest * / $ transient_id = 'WPTP_envato_item_data'; / * Hole die zwischengespeicherten Daten * / $ cached_item = get_transient ($ transient_id); / * Prüfen Sie, ob die Funktion eine neue API-Anforderung senden muss. * / If (! $ Cached_item || ($ cached_item-> item_id! = $ Item_id)) / * Setzen Sie die API-URL.% S wird durch das Element ersetzt ID * / $ api_url = "http://marketplace.envato.com/api/edge/item:%s.json"; / * Abrufen von Daten mithilfe der WordPress-Funktion wp_remote_get () * / $ response = wp_remote_get (sprintf ($ api_url, $ item_id)); / * Auf Fehler prüfen, wenn Fehler aufgetreten sind, zurück false * / if (is_wp_error ($ response) oder (wp_remote_retrieve_response_code ($ response)! = 200)) return false;  / * Wandle den JSON-String in ein PHP-Array um * / $ item_data = json_decode (wp_remote_retrieve_body ($ response), true); / * Auf falsche Daten überprüfen * / if (! Is_array ($ item_data)) return false;  / * Vorbereiten der Daten für das Caching * / $ data_to_cache = new stdClass (); $ data_to_cache-> item_id = $ item_id; $ data_to_cache-> item_info = $ item_data; / * Setze die Transient-Cache-Elementdaten * / set_transient ($ transient_id, $ data_to_cache, $ CACHE_EXPIRATION); / * Element-Info-Array zurückgeben * / return $ item_data;  / * Wenn das Element bereits zwischengespeichert ist, geben Sie die zwischengespeicherten Informationen zurück. * / Return $ cached_item-> item_info; 

Nun ist die Kernfunktion unseres WordPress-Plugins fertig. Wir haben einige WordPress-Funktionen verwendet, die uns helfen, Zeit zu sparen. Alle Informationen dazu werden im offiziellen WordPress-Codex erläutert.

• wp_remote_get () - Ruft eine URL mit der HTTP-Methode GET ab
• wp_remote_retrieve_response_code () - Überprüft, dass in der Rohantwort keine Fehler enthalten sind
• wp_remote_retrieve_body () - Ruft den Hauptteil einer bereits abgerufenen HTTP-Anforderung ab.
• set_transient () - Zwischenspeicherung von Daten
• get_transient () - Ruft zwischengespeicherte Daten ab

Schritt 3: Erstellen Sie WordPress Shortcode

In den nächsten Schritten werden wir ein nützliches WordPress-Plugin codieren, mit dem wir einige Informationen zu einem Envato Marketplace-Artikel anzeigen können. Der gesamte Code ist gut kommentiert, sodass Sie jede Zeile leicht verstehen können. Weitere Informationen zum Schreiben eines WordPress-Plugins und zur WordPress Shortcode-API finden Sie in der Online-Dokumentation des WordPress-Codex.

Lasst uns beginnen

Schreiben wir die Header-Informationen für unser Plugin

  
Fügen Sie den WordPress-Kurzcode hinzu
 
Jetzt schreiben wir den Code, um den Shortcode und seine Funktionen hinzuzufügen.
 
 "), $ atts); extrahieren ($ atts); / * Validation * / if (empty ($ item_id)) return"
Bitte geben Sie eine Envato Marketplace-Artikel-ID ein.
"; / * Daten von der API abrufen * / $ item = WPTP_get_item_info ($ item_id); / * Überprüfung - Prüfen, ob etwas schiefgelaufen ist * / if ($ item === false) return"
Ups! Irgendwas lief schief. Bitte überprüfen Sie die Artikel-ID und versuchen Sie es erneut.
"; / * Formatieren des $ item-Arrays * / $ item = $ item ['item']; extract ($ item); / * Vorbereiten des Plugins HTML * / $ html ="; $ html. = ' 
 
'. $ item.'
 
 
 
 bewertung'. WPTP_get_stars ($ rating). '
  
  
 
  
 '. $ Umsatz.' Der Umsatz 
  
  
  
  
  
 $'.round ($ cost).' nur 
  
  
  
  
  
  
 '; return $ html; 
 
Sternbewertungen funktionieren
 
Das WPTP_add_shortcode () Funktion oben hat die WPTP_get_stars () Prozedur, die die Bewertungszahl in HTML-Sterne umwandelt. Lass es uns implementieren.
 
 Noch nicht bewertet