Cómo construir un complemento de WordPress: aplicación de ejemplo y demostración en vivo

En este tutorial, crearemos el complemento de WordPress desde cero. Al final del artículo, tendremos que trabajar con el complemento de WordPress con soporte de API REST y demostración en vivo.

No voy a aburrirlos ni a perder su tiempo diciéndoles lo importante que es WordPress y para qué sirven los plugins. Estoy seguro de que sabes todo eso y probablemente estés buscando una guía real y práctica. No jodas, solo código.

Vamos a empezar. Necesita saber y tener algunas cosas con usted para continuar.

Requisitos previos para crear el complemento de WordPress

Necesita lo siguiente:

  • WordPress alojado en vivo o en el servidor.
  • Conocimientos básicos de PHP
  • Editor de código

Y eso es todo. Veamos qué vamos a construir.

Que vamos a construir

No voy a decepcionarlo desarrollando un complemento de WordPress que dice “¡Hola mundo!”.

¿Por qué? Bueno, hay toneladas de tutoriales que hacen eso.

Entonces, lo que vamos a construir es un complemento en vivo que usaremos en nuestro próximo producto.

Este complemento lo llamamos socialbot que hace lo siguiente:

  • Exponer el punto final de la API REST.
  • Descubra publicaciones aleatorias.
  • Devuelve la respuesta JSON.

La razón por la que hemos desarrollado este complemento específico se debe a nuestro caso de uso, que les diré tan pronto como nuestro producto esté listo.

El resultado final se parece a esto.

Así que vamos a sumergirnos.

Demostración en vivo y código fuente

DEMO EN VIVO DESCARGAR

Estructura del complemento de WordPress

Cada complemento de WordPress debe tener los siguientes archivos:

  • readme.txt
  • appname.php

Por supuesto, también puede tener archivos adicionales. Puede separar su base de código en módulos y colocar imágenes en otras carpetas. Esos son nuevamente específicos del complemento, pero debe tener al menos dos de estos archivos.

Aquí está nuestra estructura de aplicación.

| =========================

|
– readme.txt


|
– social-bot-hook.php


| _________________________

simple y dulce.

Vamos a sumergirnos en el código.

Complemento de codificación de WordPress

Entonces sabemos lo que tenemos que hacer. En primer lugar, permítanme abordar el desafío. Uno de los desafíos clave fue exponer la API REST. Es posible que esté pensando en utilizar algún servidor web basado en PHP para exponer la API REST. Bueno, yo pensaba lo mismo.

Luego investigué un poco y me enteré de que WordPress (versión 4.4 y superior) es compatible con JSON API. Era exactamente lo que necesitaba, todo lo que necesito hacer es exponer un punto final y la tarea está lista.

Así que aquí está nuestro código PHP para exponer el punto final JSON.

social-bot-hook.php

/ *

Nombre del complemento: gancho de bot social.


Descripción: este complemento actúa como un gancho para el servicio SaaS de bot social.


Autor: Shahid Shaikh


Autor URI: https://codeforgeek.com/about


Versión: 1.0.1


* /


add_action
( ‘rest_api_init’ , function ( ) {

        register_rest_route
( ‘socialbot / v1’ , ‘/ posts /’ , array (
                ‘ métodos ‘ => ‘ OBTENER ‘ ,
                ‘ devolución de llamada ‘ => ‘ sbh_retrieve_random_post ‘ ,
        ) ) ;
} ) ;
?>

Primero estamos registrando nuestro gancho en un evento llamado ‘rest_api_init’ que, según la documentación, se activa cuando se prepara para servir la API REST.

Dentro del gancho, estamos usando otra función de WordPress llamada ‘register_rest_routes’ que, según la documentación, registra una ruta REST.

Estamos registrando una ruta en el método GET HTTP y llamando a una función cuando se golpea esa ruta.

La función hace el trabajo de recuperar la publicación de WordPress en orden aleatorio y prepara el documento JSON. Aquí está el código para lo mismo.

function sbh_retrieve_random_post ( ) {
  $ sbhArguement = array ( ‘posts_per_page’ => 1 , ‘orderby’ => ‘rand’ ) ;
  $ sbhRandomPost = get_posts ( $ sbhArguement ) ;
  if ( vacío ( $ sbhRandomPost ) ) {
        devolver nulo ;
  }
  $ sbhPost = $ sbhRandomPost [ 0 ] ;
  $ sbhPost -> enlace permanente =get_permalink ( $ sbhPost -> ID ) ;
  $ sbhPost -> hash_tags = wp_get_post_tags ( $ sbhPost -> ID , matriz ( ‘campos’ => ‘nombres’ ) ) ;
  return $ sbhPost ;
}

En el código que se muestra arriba, estamos preparando los argumentos para llamar a otra función de WordPress para recuperar nuestras publicaciones.

Si no hay ninguna publicación, obtenemos una matriz vacía, por lo que devolvemos nulo.

Si obtenemos algo, volvemos a llamar a la función get_permalink para recuperar la URL completa de la publicación. En el resultado de la función get_posts , obtenemos solo una URL corta.

Luego, llamamos a otra función que, a su vez, descubre las etiquetas de publicación de WordPress en función de la ID.

Al final, devolvemos el resultado a la función de llamada.

Así es como se ve el código completo del complemento.

social-bot-hook.php

/ *

Nombre del complemento: gancho de bot social.


Descripción: este complemento actúa como un gancho para el servicio SaaS de bot social.


Autor: Shahid Shaikh


Autor URI: https://codeforgeek.com/about


Versión: 1.0.1


* /

function sbh_retrieve_random_post ( ) {
  $ sbhArguement = array ( ‘posts_per_page’ => 1 , ‘orderby’ => ‘rand’ ) ;
  $ sbhRandomPost = get_posts ( $ sbhArguement ) ;
  si ( vacío ( $ sbhRandomPost ) ) {
        retorno nulo ;
  }
  $ sbhPost = $ sbhRandomPost [ 0 ] ;
  $ sbhPost -> enlace permanente = get_permalink ( $ sbhPost -> ID ) ;
  $ sbhPost -> hash_tags = wp_get_post_tags ( $ sbhPost -> ID , matriz ( ‘campos’ => ‘nombres’ ) ) ;
  return $ sbhPost ;
}

add_action
( ‘rest_api_init’ , function ( ) {

        register_rest_route
( ‘socialbot / v1’ , ‘/ posts /’ , array (
                ‘métodos’ => ‘GET’ ,
                ‘callback’ => ‘sbh_retrieve_random_post’ ,
        ) ) ;
} ) ;
?>

Los comentarios de este archivo se consideran metainformación de su complemento. Esto será más claro cuando ejecutemos el complemento.

Al llegar al archivo Léame, este archivo es importante para alojar su complemento en el registro de WordPress. Así que asegúrese de tener uno compatible con readme.txt del complemento de WordPress .

Ahora ejecutemos nuestro complemento.

Ejecutando nuestro complemento de WordPress

Puede pegar su carpeta que contiene el código que se muestra arriba o su propio código en la carpeta / wp-content / plugins / O comprimirlo y cargarlo desde la sección Complementos.

Probemos el zip.

Abra su página de administración de WordPress y vaya a Complementos -> Agregar nuevo . Aquí elija su archivo zip y haga clic en Instalar ahora .

Una vez que se haya cargado, haga clic en el botón Activar complemento y su complemento debería estar activado y ejecutándose.

Puede comprobarlo en la lista de complementos instalados .

Démosle un cheque. Si está desarrollando esto en un sistema local, visite {wordpress-site} / wp-json / socialbot / v1 / posts desde el navegador.

Terminarlo

El resultado del complemento es lo que necesitaba, aunque puede continuar y expandirlo más. Puede agregar menús de administración, opciones de personalización y mucho más.

Conclusión

Es muy fácil y simple crear un complemento de WordPress. Solo necesita enumerar correctamente lo que necesita y buscar la función existente de WordPress que puede hacer lo que necesita. Si no existe tal función, cree una y hágala funcionar.

Publicada en PHP

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *