Pasos para el desarrollo de complementos en WordPress

A continuaci贸n te presentamos los pasos para el desarrollo de complementos en WordPress, considerando que este CMS con su c贸digo abierto tiene una fuerte presencia para el desarrollo de software y de la web.

WordPress es una plataforma de blogs que puede ser habilitada en otros scripts, como foros web, bolsas de trabajo e incluso un sistema cl谩sico de gesti贸n de contenido de p谩ginas web.

Para el tema de desarrollo de complementos para WordPress no se requiere de una gran experiencia, un conocimiento b谩sico 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.

Para esto, tendr谩s que cargar el archivo del complemento y activarlo desde el panel de administraci贸n, luego realizar un seguimiento en la funci贸n desde las p谩ginas en las que queremos que aparezca el extracto.

驴Qu茅 son los complementos en WordPress y por qu茅 trabajarlo?

Los complementos son una buena manera de mejorar la funcionalidad del sitio agregando m谩s caracter铆sticas. Con el tiempo, se ha extendido los sistemas de plugins de WordPress lo que ha permitido crecimiento y la disponibilidad de muchas piezas de software enviadas por los desarrolladores.

Como un desarrollador, puedes controlar los detalles del backend de la p谩gina, la opci贸n de 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.

Adem谩s desarrollar sobre WordPress es una pr谩ctica que ayuda a involucrarse en otras 谩reas. La creaci贸n de complementos peque帽os y widgets en la barra lateral en WordPress te ayudar谩 a comprender c贸mo funciona el sistema de fondo. Con esto se concretar谩n los pasos para el desarrollo de complementos en WordPress.

complementos en WordPress
Complementos en WordPress

1. Estructura de carpetas WP

Dentro de wp-content se encontrar谩 un directorio de complementos, aqu铆 se alojar谩n todos los complementos individuales, ya sea archivos 煤nicos o subdirectorios de propiedades.

Para complementos m谩s peque帽os que solo requieren un 煤nico archivo .php, tienes la opci贸n de colocarlo directamente en complementos/directorio, sin embargo, cuando se desarrolla aplicaciones m谩s complicadas, es mucho m谩s 煤til crear un subdirectorio con el nombre de tu complemento.

En el interior, puedes incluir JavaScript, CSS y HTML junto con sus funciones de PHP.

El archivo readme.txt tambi茅n puede ser 煤til si planeas ofrecer tu complemento para descargar. Este archivo debe incluir tu nombre y caracter铆sticas del complemento. Como autor, tambi茅n puede incluir detalles sobre cada revisi贸n y qu茅 actualizaciones han salido.

2. Inicia tu archivo PHP

Para crear un nuevo complemento deber谩s comenzar con un archivo PHP simple, se puede llamar de cualquier forma, pero generalmente debe reflejar el nombre oficial de tu complemento.

Por ejemplo si creamos el c贸digo base con un archivo hongkiat-excerpt.phps (debes guardar y cambiar el nombre del archivo a .php).

Las primeras l铆neas de tu complemento deben ser la informaci贸n para el motor de an谩lisis. Esto es muy importante ya que WordPress no podr谩 procesar su archivo sin 茅ste. Enseguida mostramos un ejemplo de fragmento de c贸digo que puede copiar y moldear hacia el tuyo.

1 <?php

2 /*

3 Plugin Name: Plugin Name here

4 4 Plugin URI: http://www.yourpluginurlhere.com/

5 5 Version: Current Version

6 6 Author: Name please

7 7 Description: What does your plugin do and what features does it offer…

8 */

El nombre del complemento es lo que aparecer谩 en tu 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 descripci贸n, hace que el complemento se vea profesional.

3. Nombres y mejores pr谩cticas

Hay algunas formas de estructurar tu complemento. Muchas veces los desarrolladores de PHP crean un completo sistema de clases para evitar colisiones con funciones y nombres de variables. Si no est谩s familiarizado con la funcionalidad avanzada de OOP de PHP, lo mejor es escribir el c贸digo en funciones de muestra.

Para nuestro c贸digo de ejemplo, escribiremos una sola funci贸n para alojar nuestros datos. Tambi茅n necesitamos definir las variables para implementar dentro de nuestros archivos de plantilla.

A continuaci贸n se muestra un ejemplo de c贸digo tomado de un archivo exclusivo de complemento con la l贸gica del n煤cleo eliminada.

Al escribir el c贸digo de muestra, es mejor seguir las regulaciones y gu铆as configuradas por WordPress, con lo que se puede evitar duplicados con el prefijo de una etiqueta a todas las variables y nombres de funciones.

1 <?php

2 define(“HK_EXAMPLE_CONSTANT”, “this is a value”);

3 function hk_example_function( $limit ) {

4 // Some code goes here.

5 }

6

7 ?>

En este ejemplo se ha colocado el prefijo de todos los nombres de configuraci贸n con hongkiat. Esto se puede reemplazar con cualquier palabra clave que est茅 relacionada con el nombre de tu complemento. El c贸digo anterior es solo una configuraci贸n de muestra y no debe pertenecer al complemento final. Esto es solo para darte una idea de c贸mo se deben escribir los nombres de funciones y variables.

4. Inmersi贸n en filtros y acciones

Estos dos bits de c贸digo son est谩ndar en la API de WordPress. Los filtros y las acciones ayudan a que los desarrolladores de complementos actualicen fragmentos de c贸digo en el panel de administraci贸n de WordPress correspondiente al nuevo complemento.

Esto significa que puede agregar una nueva pesta帽a en la barra lateral o enlaces de configuraci贸n adicionales para las opciones de Complemento.

Comprender add_filter ()

Se usa un filtro cuando hay poco texto o datos que se pasan a WordPress. Con los filtros, se puede filtrar contenido a trav茅s de sus funciones escritas personalizadas para cambiar los datos.

Por ejemplo, puede crear un filtro para cambiar $the_content que es una variable establecida por WordPress que tiene el contenido de la publicaci贸n de un art铆culo de WordPress.

Para nuestro complemento, tomaremos $the_contenty y acortaremos la longitud de los caracteres en un extracto.

Los filtros son 煤tiles cuando escribes complementos para personalizar el aspecto del blog. Estos son populares cuando se escriben widgets de barra lateral o funciones para cambiar c贸mo se debe mostrar una publicaci贸n.

A continuaci贸n una l铆nea de c贸digo de muestra que ense帽a c贸mo aplicar un filtro.

1 add_filter(‘wp_title’, ‘hongkiat_func’);

Aqu铆 agregamos un filtro en el t铆tulo de la p谩gina de WordPress.

La add_filter es una funci贸n nativa de WordPress y se usa 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_titleque 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, ya que no funcionan en bits de datos, sino que se dirigen a 谩reas predefinidas en sus plantillas y panel de administraci贸n. Como ejemplo, puedes aplicar una acci贸n siempre que actualices el contenido de una p谩gina.

WordPress ofrece una lista de acciones en su documentaci贸n API. A continuaci贸n se muestra una lista de acciones de ejemplo para que familiarizarse con algunas de las 谩reas objetivo predefinidas.

  • publishing_post : cuando se publica una publicaci贸n o cuando el estado se cambia a “publicado”
  • save_post : que se crea una publicaci贸n / p谩gina desde el inicio o se actualiza
  • wp_head : se llama as铆 cuando se carga la plantilla y ejecuta la wp_head()funci贸n
  • loop_end : 聽es inmediatamente despu茅s de que la publicaci贸n final se haya procesado a trav茅s del bucle de WordPress
  • trackback_post : cada vez que se agrega un nuevo trackback a una publicaci贸n

Si puedes comprender la diferencia entre acciones y filtros, estar谩s 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. Esto no pertenece a nuestro complemento de desarrollo actual y solo se usa como un c贸digo de ejemplo para comprender la add_action() funci贸n.

1 add_action(‘save_post’, ‘notify’);

Aqu铆 vemos una configuraci贸n similar a la anterior add_filter(). Necesitamos 2 variables, la primera contiene el nombre de nuestro gancho.

En este caso, save_post 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, se puede actualizar la notificaci贸n para que el nombre de la funci贸n que desea ejecutar.

Terminar la l贸gica de plugin

Al finalizar, los pasos para el desarrollo de complementos en WordPress, agregaremos la funci贸n final directamente en nuestro archivo de complemento. La documentaci贸n de la API es muy espec铆fica y proporciona un buen recurso para los desarrolladores que pueden tener preguntas avanzadas.

La siguiente funci贸n se debe agregar directamente despu茅s del comentario del encabezado de su complemento. Alternativamente, esto tambi茅n podr铆a colocarse dentro del functions.php / archivo de tu tema.

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 ajustarnos a 55 caracteres de largo con la hk_trim_content() funci贸n. Puede llamarse f谩cilmente a este bit de c贸digo desde un widget de barra lateral o uno de sus archivos de tema para reemplazar $the_content.

1 <?php

2 function hk_trim_content( $limit ) {

 3 $content = explode( ‘ ‘, get_the_content(), $limit );

 4

 5  if ( count( $content ) >= $limit ) {

 6   array_pop( $content );

 7   $content = implode(” “,$content).’…’;

 8 } else {

 9  $content = implode(” “,$content);

10 }

11

12 $content = preg_replace(‘/\[.+\]/’,”, $content);

13 $content = apply_filters(‘the_content’, $content);

14

15  return $content;

dieciseis}

17 ?>

No se tiene que comprender todas las variables o funciones internas utilizadas. 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 usamos una llamada a apply_filtersotra funci贸n espec铆fica de WordPress.

Este es otro aspecto que no se necesita comprender completamente, pero ayuda con la programaci贸n futura a trav茅s de WP. Se recomienda utilizar la p谩gina de referencia de apply_filters para obtener m谩s detalles y preguntas frecuentes sobre el tema.

Le铆ste: Pasos para el desarrollo de complementos en WordPress, te recomendamos: Pasos para redirigir una p谩gina o URL en WordPress

Te invitamos a que nos sigas en nuestras redes sociales: Facebook, Twitter, Instagram y Youtube con el perfil:聽@tortugacode