Jhon Jairo Rincón Cardona - El gran libro de desarrollo de plugins WordPress

El gran libro de desarrollo de plugins WordPress

Primera edición: 2022

©2022 Jhon Jairo Rincón

© 2022 MARCOMBO, S. L.

www.marcombo.com

Diseño de la cubierta: ENEDENÚ DISEÑO GRÁFICO

Correctora: Beatriz García Alonso

Revisor técnico: Pablo Martínez Izurzu

Directora de producción: M.a Rosa Castillo Hidalgo

«Cualquier forma de reproducción, distribución, comunicación pública o transformación de esta obra solo puede ser realizada con la autorización de sus titulares, salvo excepción prevista por la ley. Diríjase a CEDRO (Centro Español de Derechos Reprográficos, www.cedro.org) si necesita fotocopiar o escanear algún fragmento de esta obra».

ISBN: 978-84-267-3470-9

D.L.: B 7089-2022

Producción del ePub: booqlab

PARTE I: FUNCIONES Y MÉTODOS

Introducción Introducción Lo que aprenderá en este libro Este libro está enfocado a todos aquellos que tengan algún conocimiento básico de los lenguajes de la web, como PHP, JavaScript, HTML, CSS, MySQL, y para los que hayan interactuado un poco con WordPress, por ejemplo, al realizar creación de blogs, sitios web, etc. Si es de los que siempre han querido ir un poco más allá, intentando crear una funcionalidad en WordPress para que le realice algo en específico, pero se le hace difícil, porque no encuentra casi material que le pueda guiar, entonces este libro es para usted. He desarrollado un itinerario que va desde lo más básico hasta lo más avanzado, para que pueda comprender cómo funciona en realidad WordPress y logre convertir sus ideas en poderosos plugins. Una vez termine, habrá aprendido a: • Manipular la base de datos de WordPress. • Crear una estructura de archivos para sus plugins. • Realizar consultas sql a la base de datos de WordPress. • Utilizar múltiples funciones de WordPress para sus plugins. • Manipular datos y roles de usuarios en WordPress. • Crear sus propios ganchos de acción personalizados. • Crear sus propios widgets, etc.

Lo que aprenderá en este libro

Instalando el servidor local wampserver Instalando el servidor local wampserver Ahora empezaremos preparando la base de nuestro WordPress, que no consiste más que en montar nuestro servidor local, el cual nos permitirá arrancar nuestro WordPress. Para ello, vamos a visualizar un vídeo que he preparado en YouTube, así que vamos a copiar en nuestro navegador el enlace que les dejo debajo de la imagen. https://vimeo.com/574360614

Instalando la plantilla para nuestro WordPress Instalando la plantilla para nuestro WordPress Para desarrollar cada uno de los ejercicios propuestos en este libro, he creado una plantilla “Restaurante” y he preparado un vídeo en el que explico cómo descargarla e instalarla. Dejaré el enlace debajo de la imagen. https://vimeo.com/574360453 Recuerda: accede a www.marcombo.info para obtener gratis las credenciales.

Funciones y condicionales básicos de un plugin Funciones y condicionales básicos de un plugin ¿Qué es un plugin? Los plugins o complementos son paquetes de código que amplían la funcionalidad principal de WordPress. Los plugins de WordPress están formados por código PHP y otros activos como imágenes, CSS y JavaScript. Al crear su propio complemento, está ampliando WordPress, es decir, creando funcionalidades adicionales además de lo que WordPress ya ofrece. Por ejemplo, podría escribir un complemento que muestre enlaces a las diez publicaciones más recientes en su sitio. O, utilizando los tipos de publicaciones personalizadas de WordPress, puede escribir un complemento que cree un sistema de tiques de soporte con todas las funciones con notificaciones por correo electrónico, estados de tiques personalizados y un portal orientado al cliente. ¡Las posibilidades son infinitas! La mayoría de los plugins o complementos de WordPress están compuestos por muchos archivos, pero un plugin realmente solo necesita un archivo principal con un DocBlock formateado específicamente en el encabezado. Un DocBlock es un fragmento de código PHP comentado dentro de nuestro archivo php.

¿Qué es un plugin?

Requisitos de cabecera, título y descripción del plugin Requisitos de cabecera, título y descripción del plugin El archivo PHP principal del plugin debe incluir un comentario de encabezado que le dice a WordPress que un archivo es un complemento, y proporciona información sobre este. Como mínimo, un comentario de encabezado debe contener el nombre del complemento:

Ganchos de activación y desactivación Ganchos de activación y desactivación Creamos nuestro plugin de prueba, al que llamaremos pruebas. Vamos a nuestra carpeta wp-content -> plugins -> y aquí dentro de plugins crearemos una carpeta o directorio res_pruebas . Le pondremos un prefijo (res_), de restaurante. Podemos ver resaltado res_pruebas , dentro crearemos un archivo PHP y lo nombraremos res-pruebas.php . Vamos a nuestro editor Visual Studio Code y escribimos la cabecera. Ahora escribiremos las funciones: Es muy común que en el desactivador se utilice una función para limpiar enlaces permanentes, la función es:

Métodos de desinstalación Métodos de desinstalación Los métodos de desinstalación de plugins en WordPress se ejecutan cuando hacemos clic en la opción de borrar un plugin en WordPress. El primer método requiere que en nuestro archivo principal del plugin escribamos una función. Con esta función podemos borrar tablas, configuraciones y otras opciones. El segundo método requiere crear un archivo en la raíz de nuestro plugin, este archivo debe llamarse uninstall.php . Creamos el archivo y escribimos el siguiente código: Este primer código es de seguridad y dice que, si no está definida esa constante, no siga ejecutando el código que vamos a escribir más abajo. Ahora vamos a crear una consulta sql para eliminar la tabla que hemos creado anteriormente. Después de escribir este código, guardamos los cambios. Ahora vamos a comprobar que esto funciona y, para ello, vamos primero a crear una copia de nuestro plugin res_pruebas comprimiéndolo en un archivo .zip con winrar. Después de crear el archivo res_pruebas.zip, volvemos a nuestro panel de administración, recargamos la página y desinstalamos el plugin res_pruebas . Ahora hacemos clic en Borrar. Veremos que nos saldrá una ventana de confirmación y hacemos clic en Aceptar. Ahora, al volver a nuestra base de datos y recargar, podemos ver que la tabla atr_mitabla ha desaparecido.

Mejores prácticas para definir nuestras funciones o variables Mejores prácticas para definir nuestras funciones o variables Para que no se creen conflictos entre nuestras funciones, clases y variables de WordPress, debemos definirlas de la siguiente manera: Comprobando que una variable no exista: Comprobando que una función no exista: Comprobando que una clase no exista: Comprobando que una constante no está definida: Mostrar información de nuestro plugin según el rol que tenga la persona, is_admin();. Determina si la solicitud actual es para una página de interfaz administrativa. Para ver más acerca de esta función, podemos visitar la web oficial de WordPress developers. https://developer.wordpress.org/reference/functions/is_admin/

Comprobación de las capacidades de usuario