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

El CMS de WordPress ha cambiado la apariencia de nuestro Internet y ha permitido que surjan nuevas ideas, y su movimiento de código abierto tiene una fuerte presencia arraigada en el desarrollo de software y web.

WordPress es una plataforma de blogs que tiene la capacidad de iniciarse en muchos otros scripts, como foros web, bolsas de trabajo e incluso un sistema clásico de gestión de contenido de páginas web.

Revisaremos algunas formas de comenzar a desarrollar complementos para WordPress. Los pasos son relativamente simples y no requieren una gran dedicación para estudiar. Un 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 necesarios para crear un simple complemento de WordPress. La funcionalidad se utilizará para desarrollar extractos dinámicos basados ​​en el número pasado a nuestra llamada de función.

Deberá cargar el archivo del complemento y activarlo desde el panel de administración, luego realice un seguimiento llamando a nuestra función desde las páginas en las que deseamos que aparezca el extracto. Los enlaces al código fuente del complemento completado ya se agregaron más adelante en este artículo 🙂

Más de 60 trucos y trucos de WordPress más buscados (actualizado)

Más de 60 trucos y trucos de WordPress más buscados (actualizado)

¿Alguna vez ha encontrado un blog de WordPress, vio algo que le gustó y pensó? cómo hicieron eso … Lee mas

¿Por qué desarrollar para WordPress?

Los complementos son una excelente manera de mejorar la funcionalidad de su blog al agregar funciones adicionales. Estos se pueden colocar en cualquier lugar dentro de su plantilla mediante ganchos de función.

Con el tiempo, la extensibilidad del sistema de complementos de WordPress ha permitido un enorme crecimiento y cientos de piezas de software enviadas por los desarrolladores.
WordPress ofrece explícitamente funciones tan avanzadas en su CMS que los complementos únicos son pocos y distantes entre sí.

Como desarrollador, usted tiene control total sobre los detalles del backend de su weblog. 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 relativamente fácil de trabajar y aprender por sí mismo.

Como argumento secundario, desarrollar sobre WordPress es una práctica excelente para sintonizarse en otras áreas. La construcción de complementos más pequeños y widgets de barra lateral en WordPress lo ayudará a comprender cómo funciona el sistema de fondo.

Esto no se limita solo a WordPress, ya que obtendrá una comprensión más profunda de la gran mayoría de los sistemas de contenido.

1. estructura de carpetas WP

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

Para complementos más pequeños que solo requieren un único archivo .php, tiene la opción de colocarlo 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 el interior, puede incluir JavaScript, CSS y HTML junto con sus funciones de PHP.

UNA readme.txt El archivo también puede ser útil si planea 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 han salido.

2. Iniciando tu archivo PHP

Al crear un nuevo complemento, deberá comenzar con un archivo PHP simple. Se puede nombrar cualquier cosa, pero generalmente debe reflejar el nombre oficial de su complemento.

Entonces, por ejemplo, he creado nuestro código base y he nombrado mi archivo hongkiat-excerpt.phps (guardar y cambiar el nombre del archivo a .php).

Las primeras líneas de tu complemento debe Se comentará información 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 el suyo.

El nombre del complemento es lo que aparecerá en su panel de administración cuando se active. 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 nombres de WordPress y mejores prácticas

Hay algunas formas 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 avanzada de OOP de PHP, lo mejor es 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 cruciales 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 del núcleo eliminada.

Al escribir su código de muestra, es mejor seguir las regulaciones y guías configuradas por WordPress. Dado que hay tantas funciones internas ya definidas, puede evitar duplicados con el prefijo de una etiqueta a todas sus variables y nombres de funciones.


En el ejemplo anterior, hemos prefijado todos nuestros nombres de configuración con hongkiat.

Esto se puede reemplazar con cualquier palabra clave de su elección generalmente relacionada con el nombre de su complemento. El código anterior es solo configuraciones de muestra y no debería pertenecer a nuestro complemento final.

Esto es solo para darle una idea de cómo se deben escribir sus nombres de variables y llamadas de función.

4. Inmersión en filtros y acciones

Hay otro concepto que vale la pena mencionar antes de saltar a nuestro código sin formato.

Comportamiento y filtros son dos conceptos completamente diferentes que se relacionan genuinamente con las formas en que manipulan los datos del complemento.

Estos dos bits de código son estándar en la API de WordPress. Los filtros y las acciones permiten que los desarrolladores de complementos actualicen fragmentos 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.

CodeLobster PHP IDE
Comprender add_filter ()

UNA filtrar se usa en un poco de texto o datos que se pasan a WordPress. Con filtros, literalmente eres capaz de 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 complemento vamos a tomar $the_content y acortando la longitud de los personajes en un extracto.

Los filtros son útiles cuando escribes complementos para personalizar el aspecto de tu blog. Estos son especialmente populares cuando se escriben widgets de barra lateral o funciones más pequeñas para cambiar cómo 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 add_filter La función es nativa de WordPress y se utiliza para agregar un nuevo filtro a una variable encontrada dentro del contenido de la página.

En la línea de arriba estamos apuntando $wp_title que contiene el título de nuestra página actual.

Luego 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.

Comprender add_action ()

Las acciones son similares a los filtros en el sentido de que no funcionan en bits de datos, sino que se dirigen a áreas predefinidas en sus plantillas y panel de administración. Como ejemplo, puede aplicar una acción siempre 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 se muestra 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 se carga la plantilla 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 cuán simple se reduce este bit de código. Si puede comprender la diferencia entre acciones y filtros, estará mucho más cerca de crear complementos de WordPress completos y funcionales.

A continuación hay otra línea de código que inicializa una función de acción en el save_post gancho. Para aclarar nuevamente esto no pertenece a nuestro plugin de desarrollo actual y solo se usa como un código de ejemplo para comprender add_action() función.

add_action('save_post', 'notify');

Así que aquí vemos una configuración similar a la anterior con add_filter(). 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 guarda una nueva publicación vamos a llamar a nuestra función definida en la segunda posición (notify()) Obviamente, puede actualizar la notificación para que sea el nombre de la función que desea ejecutar, sin embargo, esto no es necesario para nuestro complemento de ejemplo actual.

Terminando nuestra lógica de plugin

Al finalizar nuestro camino, agregaremos nuestra función final directamente en nuestro archivo de complemento. La documentación de la API es muy específica y proporciona un recurso excelente 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 naturalmente!

La función a continuación debe agregarse directamente después del comentario del encabezado de su complemento. Alternativamente, esto también podría colocarse dentro del tema functions.php expediente.

El código se usa para crear contenido de publicación dinámico basado en un rango limitado de caracteres.

Entonces, para nuestro ejemplo, podemos limitar los extractos de historias de solo 55 caracteres de largo con el hk_trim_content() función. Podrías llamar fácilmente a este bit de código desde un widget de barra lateral o uno de tus archivos de tema para reemplazar $the_content.

= $limit ) {
    array_pop( $content );
    $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 variables o funciones internas utilizadas aquí. Simplemente obtener una comprensión general de cómo deberían escribirse sus funciones y cómo se vería un conjunto de ejemplos es un muy buen comienzo.

También puede notar que estamos usando una llamada para 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. Consulte la página de referencia de apply_filters para obtener más detalles y preguntas frecuentes sobre el tema.

La función principal anterior se llama hk_trim_content(). Esto solo requiere 1 parámetro llamado $limit.

Esto también podría acortarse a $lim que debe almacenar un número entero que especifique a cuántos caracteres limitar su extracto. El contenido se utiliza en páginas de publicación completas y también en páginas estáticas (sobre nosotros, contacto).

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

Instalar y ejecutar el complemento

Creé un archivo de muestra para que el complemento lo demuestre si desea omitir la codificación rígida.

Simplemente descargue este archivo (guarde y cambie el nombre del archivo a .php) o copie / pegue el código en un nuevo documento PHP y cárguelo en su /wp-content/plugins directorio.

Complemento de demostración de HK instalado

Una vez completado, querrá acceder al panel de administración de WordPress y explorar su conjunto actual de complementos para la demostración que 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 navega Appearance -> Editor y busca single.php.

Este archivo contiene toda la plantilla HTML / CSS para su página básica de publicación de artículos. Desplácese hacia abajo hasta que encuentre the_content() y reemplace con el código de ejemplo anterior. Esto limitará todas sus páginas de 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 funcionalidades 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.

Deja un comentario

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