Guía para principiantes para el desarrollo de complementos de WordPress

El CMS de WordPress ha cambiado la cara de nuestro Internet y ha permitido que prosperen nuevas ideas y su movimiento de código abierto tiene una fuerte presencia enraizada en el software y el desarrollo web. WordPress es una plataforma de blogs que tiene la capacidad de iniciarse en muchos otros scripts, como foros web, tableros de trabajo e incluso una página web clásica..

Revisaremos algunas formas de comenzar en el desarrollo de complementos para WordPress. Los pasos son bastante simples y no requieren una gran dedicación para estudiar. El conocimiento rudimentario de PHP sería útil incluso con una comprensión básica de la estructura de archivos de WordPress y el panel de Administración.

En este breve tutorial, repasaremos los pasos básicos necesarios para crear un complemento simple de WordPress. La funcionalidad se utilizará para crear extractos dinámicos basados ​​en el número transferido a nuestra llamada de función. Deberá cargar el archivo del complemento y activarlo desde el panel de administración, luego hacer un seguimiento llamando a nuestra función desde las páginas que deseamos que aparezcan los extractos. Los enlaces al código fuente del complemento completado ya se agregaron más adelante en este artículo :)

Por qué desarrollar para WordPress?

Los complementos son una excelente manera de mejorar la funcionalidad de tu blog al agregar características adicionales. Estos pueden colocarse en cualquier lugar dentro de su plantilla mediante los ganchos de función. A lo largo del tiempo, la extensibilidad del sistema de complementos de WordPress ha permitido un enorme crecimiento y cientos de piezas de software enviadas por desarrolladores..

WordPress ofrece específicamente características tan avanzadas en su CMS que los complementos únicos son pocos y distantes entre sí. Como desarrollador, usted tiene control completo sobre las características específicas de su blog. Contratar a un desarrollador de PHP para crear un complemento del sistema costaría mucho más de lo que pueda imaginar y la API es bastante fácil de trabajar y aprender por sí mismo.

Como argumento secundario, desarrollar sobre WordPress es una gran práctica para sintonizarte en otras áreas. Crear complementos más pequeños y widgets de barra lateral en WordPress te ayudará a desarrollar una comprensión de cómo funciona realmente el sistema backend. Esto no se limita a WordPress, ya que obtendrá una comprensión más profunda de la gran mayoría de los sistemas de contenido..

1. Estructura de la carpeta WP

Una introducción a la estructura de carpetas de WordPress mostrará los directorios de aplicaciones básicas. Dentro de wp-content encontrarás una plugins directorio. Aquí es donde se alojarán todos sus complementos individuales, ya sea archivos individuales o subdirectorios con el nombre correcto.

Para los complementos más pequeños que solo requieren un único archivo .php, tiene la opción de colocar esto directamente en el directorio de complementos /. Sin embargo, cuando comienza a desarrollar aplicaciones más complicadas, es mucho más útil crear un subdirectorio con el nombre de su complemento. En su interior puede alojar JavaScript, CSS y HTML incluidos junto con sus funciones de PHP.

UNA readme.txt El archivo también puede ser útil si está planeando ofrecer su complemento para descargar. Este archivo debe incluir su nombre y lo que hace el complemento. Como autor, también puede considerar incluir detalles sobre cada revisión y qué actualizaciones se han publicado..

2. Comenzando su archivo PHP

Al crear un nuevo complemento, deberá comenzar con un archivo PHP simple. Se puede nombrar de cualquier forma, pero generalmente debe reflejar el nombre oficial de su complemento. Así, por ejemplo, he creado nuestro código base y he llamado a mi archivo hongkiat-excerpt.phps.

Las primeras líneas de tu plug-in. debe Ser información de comentarios para el motor de análisis. Esto es extremadamente importante ya que WordPress no podrá procesar su archivo sin él. A continuación se muestra un fragmento de código de ejemplo que puede copiar y moldear hacia su propio.

El Nombre del complemento es lo que aparecerá en el panel de administración de su administrador cuando vaya a activar. Lo mismo con el URI que se colocará en el panel de detalles dentro del panel de complementos. Aunque no es obligatorio incluir una versión o descripción, hace que su complemento se vea mucho más profesional..

3. Convenciones de nomenclatura de WordPress y mejores prácticas

Hay algunas maneras de estructurar realmente su complemento. Muchas veces los desarrolladores de PHP crearán un sistema de clases completo para evitar colisiones con funciones y nombres de variables. Si no está familiarizado con la funcionalidad OOP avanzada de PHP, es mejor escribir su código en funciones de muestra..

Entonces, para nuestro código de ejemplo, escribiremos una sola función para alojar nuestros datos. También necesitamos definir algunas variables que son clave para implementar dentro de nuestros archivos de plantilla. A continuación se muestra un ejemplo de código tomado de nuestro archivo de complemento con la lógica central eliminada.

Al escribir su código de muestra, es mejor seguir las normas y guías establecidas por WordPress. Ya que hay tantas funciones internas ya definidas, puede evitar duplicados prefijando una etiqueta a todas sus variables y nombres de funciones.

En los ejemplos anteriores prefijamos todos nuestros nombres de configuración con Hongkiat. Esto puede reemplazarse con cualquier palabra clave de su elección relacionada con el nombre de su complemento. El código anterior es justo ajustes de muestra y no debe pertenecer a nuestro complemento final. Esto es solo para darle una idea de cómo deben escribirse los nombres de las variables y las llamadas a funciones..

4. Buceando en filtros y acciones

Hay otro concepto digno de mencionar antes de saltar a nuestro código en bruto. Comportamiento y filtros Son dos conceptos completamente diferentes que se relacionan profundamente en la forma en que manipulan los datos del complemento..

Estos dos bits de código vienen estándar dentro de la API de WordPress. Los filtros y las acciones permiten a los desarrolladores de complementos actualizar bits de código en todo el panel de administración de WordPress correspondiente a su nuevo complemento. Esto significa que puede agregar una nueva pestaña en la barra lateral o enlaces de configuración adicionales para sus opciones de complemento..

Entendiendo add_filter ()

UNA filtrar se utiliza en un poco de texto o datos que se pasan a WordPress. Con los filtros puedes literalmente filtrar contenido a través de sus propias funciones escritas personalizadas para cambiar los datos de cualquier manera.

Por ejemplo, puede crear un filtro para cambiar $ the_content que es una variable establecida por WordPress que contiene todo el contenido de la publicación de un artículo de WordPress. Para nuestro plug-in estaremos tomando $ the_content y acortando la longitud de los caracteres en un extracto.

Los filtros son útiles cuando escribes complementos para personalizar la apariencia de tu blog. Estos son especialmente populares al escribir widgets de la barra lateral o funciones más pequeñas para cambiar la forma en que se debe mostrar una publicación. A continuación se muestra una línea de código de muestra que muestra cómo aplicar un filtro.

add_filter ('wp_title', 'hongkiat_func');

Aquí estamos agregando un filtro en el título de la página de WordPress. Tenga en cuenta que este código no se relaciona con nuestro complemento oficial y solo se usa como ejemplo aquí.

los Añadir filtro La función es nativa de WordPress y se usa para agregar un nuevo filtro a una variable que se encuentra dentro del contenido de la página. En la línea superior estamos apuntando $ wp_title que contiene el título de nuestra página actual. Entonces estamos pasando esta variable a una función falsa titulada hongkiat_func () que luego podría manipular y devolver una nueva etiqueta de título para cualquier propósito.

Entendiendo add_action ()

Las acciones son similares a los filtros en el sentido de que no funcionan con bits de datos, sino que se dirigen a áreas predefinidas en sus plantillas y en el panel de administración. Como ejemplo, puede aplicar una acción cada vez que actualice o edite el contenido de una página. WordPress ofrece una lista completa de acciones en su documentación API. A continuación hay una pequeña lista de acciones de ejemplo para que se familiarice con algunas de las áreas objetivo predefinidas..

• publicar_post - se llama cuando se publica una publicación o cuando el estado se cambia a “publicado”
• save_post - se llama cuando se crea una publicación / página desde el inicio o se actualiza
• wp_head - se llama cuando la plantilla se carga y ejecuta el wp_head () función
• loop_end - se llama inmediatamente después de que la publicación final se haya procesado a través del bucle de WordPress
• trackback_post - se llama cada vez que se agrega un nuevo trackback a una publicación

Nuevamente podemos ver lo simple que es este código. Si puede comprender la diferencia entre acciones y filtros, estará mucho más cerca de crear complementos de WordPress completos y funcionales. Abajo hay otra línea de código que inicializa una función de acción en el save_post gancho. Para aclarar de nuevo, esto no se refiere a nuestro complemento de desarrollo actual y solo se utiliza como una pieza de código de ejemplo para comprender el add_action () función.

add_action ('save_post', 'notificar');

Así que aquí vemos una configuración similar a antes con Añadir filtro(). Necesitamos 2 variables, la primera contiene el nombre de nuestro gancho al que nos dirigimos. En este caso save_post lo que significa que cada vez que se guarde una nueva publicación, llamaremos nuestra función definida en la segunda posición (notificar()). Obviamente, podría actualizar notificar a cualquier nombre de función que desee ejecutar, sin embargo, esto no es necesario para nuestro ejemplo de complemento actual.

Terminando nuestra lógica de plugin

Al terminar nuestra ruta, agregaremos nuestra función final directamente a nuestro archivo de complemento. La documentación de la API es muy específica y proporciona un excelente recurso para los desarrolladores que pueden tener preguntas avanzadas. El material puede parecer difícil si no está familiarizado con PHP pero tómese su tiempo con los conceptos y las cosas comenzarán a fluir de forma natural.!

La función a continuación debe agregarse directamente después del comentario del encabezado de su complemento. Alternativamente, esto también podría ser colocado dentro de su tema funciones.php expediente. El código se utiliza para crear contenido dinámico de publicaciones basado en un rango limitado de caracteres.

Entonces, para nuestro ejemplo, podemos limitar los extractos de la historia de solo 55 caracteres con la hk_trim_content () función. Fácilmente puede llamar a este bit de código desde un widget de barra lateral o uno de sus archivos de tema para reemplazar $ the_content.

= $ límite) array_pop ($ contenido); $ content = implode ("", $ content). '...';  else $ content = implode ("", $ content);  $ content = preg_replace ('/\[.+\◆/', ", $ content); $ content = apply_filters ('the_content', $ content); return $ content;? 

No debe esperarse que comprenda completamente todas las funciones o variables internas utilizadas aquí. Solo es un buen comienzo obtener una comprensión general de cómo deberían escribirse sus funciones y cómo sería un conjunto de ejemplos..

También puede notar que estamos usando una llamada a apply_filters que es otra función específica de WordPress. Este es otro aspecto que no necesita comprender completamente, pero ayuda con la programación futura a través de WP. Visite la página de referencia de apply_filters para obtener más detalles y preguntas frecuentes sobre el tema..

La función principal de arriba se llama hk_trim_content (). Esto solo requiere 1 parámetro llamado $ limite. Esto también podría reducirse a $ lim que debería almacenar un número entero que especifique a cuántos caracteres limitar su extracto. El contenido se utiliza en páginas de publicación completa y también en páginas estáticas (sobre nosotros, contacto).

Por lo tanto, para poder llamar a esta función necesitaríamos agregar el parámetro a nuestros archivos de plantilla. Esto sería colocado en algún lugar posiblemente en su index.php o loop.php Archivo (s) y requerirá que instale el complemento primero. Ejemplo abajo:

Instalar y ejecutar el complemento

He creado un archivo de muestra para el complemento a modo de demostración si desea omitir la codificación. Simplemente descargue este archivo (cambie su nombre por .php) o copie / pegue el código en un nuevo documento PHP y cárguelo en su / wp-content / plugins directorio.

Una vez completado, querrá acceder al panel de administración de WordPress y explorar su conjunto actual de complementos para la demostración que se acaba de instalar. Una vez que active, no ocurrirá nada nuevo, no hasta que agreguemos manualmente nuestra llamada de función. Para hacer esto simplemente navegar Apariencia -> Editor y buscar single.php.

Este archivo contiene toda la plantilla HTML / CSS para la página de publicación de un artículo básico. Desplácese hacia abajo hasta que encuentre el contenido() y reemplazar con el código de ejemplo anterior. Esto limitará todas las páginas de sus artículos a 55 caracteres sin importar qué vista se esté utilizando. También puede agregar esta función a páginas similares en su directorio de plantillas, como search.php o archive.php.

Conclusión

Estos son algunos de los conceptos básicos para comenzar a trabajar en el desarrollo de WordPress. El sistema de complementos es amplio y contiene una gran cantidad de funciones internas. Si ya tiene una idea para un complemento, pruébelo en una instalación local de WordPress para practicar estos temas..

Si todavía está confundido por gran parte de la información, puede revisar la documentación de WordPress y buscar su respuesta allí. La comunidad de desarrollo está llena de usuarios útiles y los foros contienen archivos con preguntas de años atrás..