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