Utilisation de l'API Envato avec WordPress

Aujourd'hui, nous allons discuter de la manière d'utiliser l'API Envato dans WordPress et de créer un shortcode WordPress faisant la promotion de nos éléments de marché Envato dans notre site WordPress. Nous allons combiner la puissante API Envato, la flexibilité de WordPress et un peu de créativité pour créer un plugin incroyable pour notre site..

Fixons notre objectif

Dans ce tutoriel, nous allons nous concentrer sur:

• Quelques connaissances de base sur l'API Envato
• Comment utiliser les données de résultat de l'API dans WordPress
• Construire un Shortcode WordPress faisant la promotion des articles Envato Marketplace dans notre site WordPress.

Alors entrons dans le premier!

Étape 1: Comprendre l'API Envato

Envato fournit une API qui permet aux développeurs d'obtenir des informations sur les éléments d'Envato Marketplace, les informations des utilisateurs, les projets les plus populaires, etc. Toutes les requêtes possibles sont répertoriées dans la documentation officielle. Dans cet article, nous ne parlons que de l'API publique.

L'API publique Envato a la structure suivante.

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

Le mot ensemble doit être remplacé par une option répertoriée dans la colonne ensemble de la documentation de l'API. Donc, si nous voulons toutes les informations sur un article du marché, nous devons remplacer ensemble avec élément: the_item_id. L'URL de la demande finale sera:

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

Vous pouvez essayer d'insérer l'URL ci-dessus dans votre navigateur Web et voir les données retournées.

Nous pouvons également concaténer plus d’un définir l'option en une seule demande pour obtenir plus de données. Par exemple, nous voulons les données d'élément et leurs informations d'auteur. Donc l'URL précédente deviendra:

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

L'API Envato renvoie le code JSON. Dans le paragraphe suivant, nous allons montrer comment le gérer dans WordPress..

Étape 2: Comment utiliser les résultats de l'API dans WordPress

Dans ce tutoriel, nous n'allons pas discuter de la création d'un plugin WordPress, mais nous allons nous concentrer sur certaines techniques d'utilisation de l'API dans WordPress:

• Envoyer la demande d'API
• Gérer les données de résultat (la chaîne JSON)

La fonction ci-dessous récupère les données du serveur Envato et renvoie un tableau PHP contenant toutes les informations souhaitées..

 / ** * @param String $ item_id - ID d'un élément du marché Envato * * @returns Array - Informations sur l'élément * / function WPTP_get_item_info ($ item_id) / * Définir l'URL de l'API,% s sera remplacé par l'ID de l'élément * / $ api_url = "http://marketplace.envato.com/api/edge/item:%s.json"; / * Récupération de données à l'aide de la fonction WordPress wp_remote_get () * / $ response = wp_remote_get (sprintf ($ api_url, $ item_id)); / * Vérifie les erreurs, s'il y en a, retourne false * / if (is_wp_error ($ response) ou (wp_remote_retrieve_response_code ($ response)! = =)) Return false;  / * Transforme la chaîne JSON en un tableau PHP * / $ item_data = json_decode (wp_remote_retrieve_body ($ réponse), true); / * Vérifie les données incorrectes * / if (! Is_array ($ item_data)) return false;  / * Retourne un tableau d'informations sur les objets * / return $ item_data; 

Nous pouvons améliorer la fonction ci-dessus. Pour éviter le stress sur le serveur API Envato, nous pouvons mettre en cache les données d'élément et demander à nouveau les informations après un délai d'attente. WordPress nous offre quelques fonctions pour implémenter cette fonctionnalité. Ajoutons-le.

 / ** * @param String $ item_id - ID d'un élément du marché Envato * @returns Array - Informations sur l'élément * / function WPTP_get_item_info ($ item_id) / * Délai d'expiration du cache de données en secondes - Il envoie une nouvelle demande chaque heure à la place. de chaque rafraîchissement de page * / $ CACHE_EXPIRATION = 3600; / * Définir l'ID transitoire pour la mise en cache * / $ transient_id = 'WPTP_envato_item_data'; / * Récupère les données en cache * / $ cached_item = get_transient ($ transient_id); / * Vérifie si la fonction doit envoyer une nouvelle demande d'API * / if (! $ Cached_item || ($ cached_item-> item_id! = $ Item_id)) / * Définit l'URL de l'API,% s sera remplacé par l'élément ID * / $ api_url = "http://marketplace.envato.com/api/edge/item:%s.json"; / * Récupération de données à l'aide de la fonction WordPress wp_remote_get () * / $ response = wp_remote_get (sprintf ($ api_url, $ item_id)); / * Vérifie les erreurs, s'il y en a, retourne false * / if (is_wp_error ($ response) ou (wp_remote_retrieve_response_code ($ response)! = =)) Return false;  / * Transforme la chaîne JSON en un tableau PHP * / $ item_data = json_decode (wp_remote_retrieve_body ($ réponse), true); / * Vérifie les données incorrectes * / if (! Is_array ($ item_data)) return false;  / * Préparer les données pour la mise en cache * / $ data_to_cache = new stdClass (); $ data_to_cache-> item_id = $ item_id; $ data_to_cache-> item_info = $ item_data; / * Définit les données d'élément de cache transitoires * / set_transient ($ transient_id, $ data_to_cache, $ CACHE_EXPIRATION); / * Retourne un tableau d'informations sur les objets * / return $ item_data;  / * Si l'élément est déjà mis en cache, retournez les informations mises en cache * / return $ cached_item-> item_info; 

La fonction principale de notre plugin WordPress est maintenant prête. Nous avons utilisé certaines fonctions WordPress qui nous aident à gagner du temps. Toutes les informations à leur sujet sont expliquées dans le WordPress Codex officiel.

• wp_remote_get () - Récupère une URL en utilisant la méthode HTTP GET
• wp_remote_retrieve_response_code () - Vérifie qu'il n'y a pas d'erreur dans la réponse brute
• wp_remote_retrieve_body () - Récupère le corps d'une requête HTTP déjà récupérée.
• set_transient () - Données de caches
• get_transient () - Obtient les données en cache

Étape 3: Construire WordPress Shortcode

Dans les étapes suivantes, nous allons coder un plugin WordPress utile qui nous permet d’afficher des informations sur un élément du marché Envato. Tout le code ci-dessous est bien commenté afin que vous puissiez facilement comprendre chaque ligne. Pour plus de détails sur l'écriture d'un plugin WordPress et l'API WordPress Shortcode, consultez la documentation en ligne dans le codex WordPress..

Commençons

Ecrivons les informations d'en-tête de notre plugin

  
Ajouter le shortcode WordPress
 
Maintenant nous écrivons le code pour ajouter le shortcode et ses fonctionnalités.
 
 "), $ atts); extract ($ atts); / * Validation * / if (vide ($ item_id)) return"
Veuillez insérer un numéro d'article du marché Envato.
"; / * Obtenir des données de l'API * / $ item = WPTP_get_item_info ($ item_id); / * Validation - Vérifie si une erreur s'est produite * / if ($ item === false) return"
Oups… Quelque chose s'est mal passé. Veuillez vérifier l'ID d'article et réessayer..
"; / * Formatez le tableau $ item * / $ item = $ item ['item']; extract ($ item); / * Préparez le plugin HTML * / $ html ="; $ html. = ' 
 
'. $ item.'
 
 
 
 évaluation'. WPTP_get_stars ($ rating). '
  
  
 
  
 ". $ ventes." Ventes 
  
  
  
  
  
 $'.round ($ cost).' seulement 
  
  
  
  
  
  
 '; return $ html; 
 
Fonction de classement par étoiles
 
le WPTP_add_shortcode () fonction ci-dessus a la WPTP_get_stars () procédure qui couvre le numéro d’évaluation en étoiles HTML. Mettons en œuvre.
 
 Pas encore d'évaluation