Guía para el desarrollo de plugins para WordPress: Crea tu primer plugin personalizado desde cero

Entorno de desarrollo y preparaciones básicas

Antes de comenzar a escribir código, es esencial disponer de un entorno de desarrollo local estable y eficiente. Para el desarrollo de plugins para WordPress, recomendamos utilizar entornos integrados como XAMPP, MAMP o Local by Flywheel, que permiten instalar Apache, MySQL y PHP con un solo clic, evitando así un proceso de configuración complicado. Asegúrate de que tu versión de PHP sea superior a 7.4 y tu versión de MySQL sea superior a 5.6, de acuerdo con los requisitos más recientes recomendados por WordPress.

A continuación, necesitarás un editor de código. Visual Studio Code, PhpStorm o Sublime Text son opciones excelentes, ya que ofrecen resaltado de sintaxis, sugerencias de código y funciones de depuración, lo que puede mejorar significativamente la eficiencia del desarrollo. Además, instala una herramienta de control de versiones, como Git, para gestionar el historial de cambios en tu código; esto es una práctica estándar en el desarrollo moderno.

Comprender la estructura básica de los plugins de WordPress es el primer paso. Un plugin básico contiene, al menos, un archivo PHP principal cuyas notas al comienzo del archivo (header comments) sirven como su “identificación”, para informar al sistema de WordPress sobre las características y funciones del plugin. Este archivo puede existir de manera independiente o puede ser el punto de entrada para un directorio que contenga múltiples plugins más complejos.

Lecturas recomendadas Desarrollo de plugins para WordPress: Desde los principios hasta la maestría: Crea tu primer plugin personalizado。

Crea tu primer archivo de plugin.

Comencemos creando el plugin más simple posible. Primero, acceda al directorio de instalación local de WordPress.wp-content/pluginsCarpeta. Aquí, cree una nueva carpeta y denle el nombre de…my-first-pluginTodos los archivos relacionados con los plugins se colocarán en este directorio.

Servidor de WordPress de UltaHost

Garantía de reembolso en 30 días, ancho de banda ilimitado y bases de datos, protección gratuita contra ataques DDoS; descuento del 50% al comprar por 3 años (versiones de 4 TB y 5 TB).

página de acceso

Dentro de esa carpeta, cree un archivo PHP principal, por ejemplo, llámelo `main.php`.my-first-plugin.phpLa cabecera de este archivo debe contener un bloque de comentarios con información específica sobre los plugins. A continuación se muestra un ejemplo estándar:

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个用于学习的简单WordPress插件示例。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

El campo “Nombre del Plugin” es obligatorio; WordPress lo utiliza para identificar y mostrar tu plugin en la lista de plugins del backend. Otras informaciones, como la versión y el autor, ayudan a los usuarios a conocer más detalles sobre el plugin. Después de guardar el archivo, inicia sesión en el backend de WordPress y ve la página de “Plugins”. Deberías ver que “Mi primer plugin” aparece en la lista de plugins, y podrás activarlo o desactivarlo. Actualmente no tiene ninguna función, pero has creado con éxito un marco de trabajo para un plugin legal.

Añadir funcionalidades esenciales al plugin.

Un plugin activado necesita ejecutar código a través del mecanismo de ganchos (hooks) de WordPress. Existen dos tipos de ganchos: los ganchos de acción (Action Hooks) y los ganchos de filtro (Filter Hooks). Los ganchos de acción te permiten insertar código en momentos específicos para ejecutar funciones, mientras que los ganchos de filtro te permiten modificar los datos que se transmiten durante el proceso.

Usar los ganchos de acción para agregar un menú de administración.

Para que los usuarios puedan interactuar con los plugins, generalmente es necesario agregar una página de configuración en el backend de WordPress. Esto se puede lograr de la siguiente manera:add_action()La función se ha montado (es decir, se ha asociado correctamente con el sistema o el componente en el que se utiliza).admin_menuEste accionador (action hook) se utiliza para implementar dicha función.

Lecturas recomendadas Guía definitiva para el desarrollo de plugins para WordPress: Crea tu primer plugin personalizado desde cero。

Primero, definimos una función en el archivo principal del plugin para generar el contenido HTML de la página de configuración. Esta función puede llamarse…mfp_settings_page_htmlLuego, creamos otra función, por ejemplo…mfp_add_admin_menuEn el que se utiliza WordPress.add_menu_page()Se utiliza una función para registrar un nuevo elemento de menú de nivel superior. Finalmente, se procede con…add_action('admin_menu', 'mfp_add_admin_menu')Montar la función de registro en el sistema.

Modificar el contenido de un artículo utilizando los ganchos de los filtros

Además de las funciones en el backend, los plugins se utilizan con frecuencia para modificar el contenido visual ( frontend) de un sitio web. Por ejemplo, podemos agregar automáticamente una declaración de derechos de autor al final de cada artículo. Para ello, es necesario utilizar un plugin adecuado.the_contentEste gancho de filtro.

Definimos una función, por ejemplo, llamada…mfp_add_copyright_to_contentRecibe un parámetro (es decir, el contenido original del artículo) y agrega texto HTML personalizado al final de este. Luego, se procede con…add_filter('the_content', 'mfp_add_copyright_to_content')Registre esta función como un filtro. De esta manera, cada vez que WordPress solicite el contenido de un artículo, este pasará primero por nuestra función para que se añada la información de copyright antes de ser mostrado.

hosting.com Alojamiento compartido

Alto rendimiento con CPU AMD EPYC, almacenamiento SSD NVMe y LiteSpeed, asistencia interna de expertos 24 horas al día, 7 días a la semana, medidas de seguridad avanzadas como SSL, fuerza bruta, protección contra malware y DDoS, ahorro de hasta 73%.

página de acceso

Seguridad, optimización y publicación de plugins

Desarrollar nuevas funcionalidades es solo el primer paso; asegurar la seguridad y el rendimiento del plugin es igualmente importante. Todos los datos introducidos por los usuarios deben ser sometidos a una verificación rigurosa, a procesos de escape y a una limpieza antes de ser almacenados en la base de datos o mostrados en la página. WordPress ofrece una amplia gama de funciones de seguridad para ayudar a proteger el sistema.sanitize_text_field()(Limpieza del texto)esc_html()(Escapado HTML) ywp_kses()(Se permiten los etiquetas HTML especificadas; asegúrese de usarlas en los lugares adecuados.)

Para mejorar la mantenibilidad y el rendimiento del plugin, se recomienda seguir los principios de la programación orientada a objetos (POO) a la hora de organizar el código, encapsulando las funciones en clases. Asimismo, se debe utilizar de manera adecuada la API de caché transitoria (Transients API) de WordPress para almacenar los resultados de consultas que requieren mucho tiempo o datos obtenidos mediante solicitudes remotas, evitando que se calculen de nuevo con cada carga de la página.

Cuando tu complemento esté completamente funcional y haya superado las pruebas, podrás considerar su publicación. Necesitarás preparar una descripción clara del mismo.readme.txtLos archivos deben cumplir con los requisitos de WordPress.org en cuanto a formato, y deben contener información sobre las funciones del plugin, el método de instalación, los registros de actualizaciones y las preguntas más frecuentes. Si deseas enviar el plugin al catálogo oficial de plugins de WordPress, debes crear un repositorio SVN y seguir sus normas de codificación y guías de envío. En el caso de plugins comerciales, será necesario establecer tus propios servidores para la venta y actualización del mismo.

Lecturas recomendadas Dominar completamente el desarrollo de plugins para WordPress: construir funciones personalizadas desde cero.。

resúmenes

A través de esta guía, hemos recorrido el camino esencial para el desarrollo de plugins para WordPress: desde la configuración del entorno y la creación de la estructura básica de los archivos, hasta la incorporación de funcionalidades a los plugins mediante acciones y ganchos (hooks), y finalmente, nos hemos centrado en la seguridad, la optimización y la preparación para su publicación. La esencia del desarrollo de plugins es la extensión de las funciones principales de WordPress, y el mecanismo de los ganchos actúa como el puente que conecta tu código con el mundo de WordPress. Una vez que domines estos conceptos básicos, podrás explorar API más complejas y posibilidades mediante la consulta de los manuales oficiales de plugins y del código fuente de WordPress, lo que te permitirá crear plugins potentes, seguros y populares.

FAQ Preguntas más frecuentes

¿Qué archivos debe contener un plugin?

El plugin más simple puede consistir únicamente en un archivo PHP con las anotaciones de cabecera correctas. Sin embargo, a medida que las funciones se vuelven más complejas, suele incluir varios archivos PHP, JavaScript, CSS, recursos de imágenes, además de otros componentes adicionales.readme.txtArchivo de instrucciones. El archivo principal de PHP es esencial.

Alojamiento compartido InterServer

Alojamiento compartido $2.50 USD al mes , primer mes $0.1 USD código promocional tryinterserver, 461 scripts de aplicaciones en la nube, instalación en un clic.

página de acceso

¿Cómo puedo evitar que mi plugin entre en conflicto con otros plugins?

Agregar un prefijo único a todos los nombres de funciones, clases, constantes y variables globales es la mejor práctica para evitar conflictos de nombres. Por lo general, se utilizan abreviaturas de plugins o nombres propios como prefijo.mfp_omy_plugin_Al mismo tiempo, encapsular el código en una clase también ayuda a aislar efectivamente los ámbitos de aplicación (scopes).

¿Cómo agregar opciones de configuración personalizables a un plugin?

Se recomienda utilizar la API de Configuraciones de WordPress para crear páginas de configuración seguras y estandarizadas. Esta API proporciona funciones para registrar configuraciones, agregar campos y secciones de configuración, y puede gestionar automáticamente el almacenamiento, la validación de los datos ingresados, así como la validación mediante el mecanismo de seguridad “nonce”. Es mucho más conveniente que realizar todo esto de forma manual.$_POSTLos datos deben ser mucho más seguros y fáciles de utilizar.

¿Cómo depurar los errores en un plugin durante el desarrollo?

Primero, asegúrate de que…wp-config.phpEl modo de depuración de WordPress está activado en el archivo.WP_DEBUGLos constantes se establecen entrueAl mismo tiempo, se puede instalar y activar plugins de depuración profesionales como Query Monitor, que te ayudarán a ver las consultas a la base de datos, la ejecución de los hooks, los errores de PHP y los cuellos de botella de rendimiento. Son herramientas indispensables en el proceso de desarrollo.