Guía de desarrollo de complementos de WordPress Plugin

Si ha usado WordPress por un período de tiempo, probablemente no sea ajeno al poder de los complementos. Sin embargo, el uso de complementos en su sitio web y creando el suyo. Hay dos cosas muy diferentes. Si está interesado en desarrollar el complemento de WordPress, puede estar confundido por dónde comenzar.

Afortunadamente, es más fácil crear sus propios complementos de los que podría esperar. Obtener una comprensión sólida de cómo funcionan los complementos y cómo se crean es el primer paso clave. Una vez que haya desarrollado los conceptos básicos, crear e instalar sus propios complementos simples es bastante fácil.
En esta publicación, explicaremos los elementos básicos del desarrollo de los complementos de WordPress, incluidos los elementos necesarios y cómo trabajan juntos. También le presentaremos a través de nuestro tutorial de complementos de WordPress en seis pasos y le daremos algunos consejos y mejores prácticas para crear su primer complemento. ¡Vamos a empezar! En este articulo
Introducción al desarrollo de los complementos de WordPress
Cómo funcionan los complementos de WordPress
Un tutorial de desarrollo de complementos de WordPress en 6 pasos
Las mejores prácticas para el desarrollo de complementos de WordPress
Preguntas frecuentes sobre el desarrollo de los complementos de WordPress
conclusión
Aquí, en WP Buffs, ayudamos a los propietarios de sitios web, socios de la agencia y socios independientes a monitorear sus sitios de WordPress 24/7. Ya sea que sea nuevo en WordPress o busque hundir los dedos en desarrollo y diseño, estamos aquí para apoyar sus necesidades.
Una introducción al desarrollo de los complementos de WordPress ️ WordPress Plugins ofrece una manera sólida de mejorar la funcionalidad de su sitio web. Puede expandir las características de su sitio más allá de lo que está disponible en la plataforma básica de WordPress, sin editar directamente ningún código. Con miles de complementos disponibles en WordPress Plugin Director, ¿por qué desarrollar los suyos? Crear sus propios complementos le permite agregar funciones personalizadas a su sitio web, que puede no estar disponible en ningún complemento existente. Crear su propio complemento es una de las mejores maneras de agregar una funcionalidad única a su sitio. Emplear a un desarrollador para hacer adiciones personalizadas en su sitio Además, es una excelente manera de aprender cómo trabajar la parte posterior de WordPress. En el nivel básico. , un complemento consta de una o más funciones y archivos escritos en PHP, el lenguaje principal de script de WordPress. También contiene cuatro elementos esenciales, que discutiremos en detalle en la siguiente sección: acciones, filtros, códigos cortos y widgets. No tiene que ser un programador experimentado para desarrollar sus propios complementos de WordPress. Sin embargo, esta tarea será significativamente más fácil si tiene conocimiento básico y familiaridad con PHP, CSS y HTML. Afortunadamente, hay muchos tutoriales en línea que pueden ayudarlo a abordar los idiomas básicos.
Cómo funcionan los complementos de WordPress para desarrollar su propio complemento, es esencial comprender primero cómo funcionan los sistemas clave. Los arados funcionan principalmente usando ganchos, que son una forma en que un código puede interactuar con (“enganchar”) otro. WordPress tiene dos tipos de ganchos: acciones y filtros. Los discutiremos más detallados a continuación, junto con otros dos elementos que se usan comúnmente en el desarrollo de complementos. Acciones Una acción de WordPress se refiere a una actividad específica que ocurrirá en un momento dado. Con acciones, puede agregar o cambiar la funcionalidad del complemento. Las funciones que se unen a una acción se realizarán una vez que se active la acción. Una acción de WordPress es Save_Post. Las acciones están definidas por la función Do_Action. Estos requieren el parámetro $ etiqueta (el nombre de la acción) y, en algunos casos, $ args (argumentos adicionales que extienden lo que hace la acción). El núcleo de WordPress viene con docenas de acciones predefinidas. Sin embargo, puede crear el suyo propio. De todos modos, cuando desarrolle su complemento de WordPress, usará Do_Action para establecer valores para su función conectada. La función add_action se usará para conectar esa función a una acción específica. Los filtros de filtros de WordPress son ganchos que aceptan una sola variable o una serie de variables y luego los envían de regreso después de que se hayan modificado. En resumen, los filtros le permiten cambiar el contenido que se muestra a los usuarios.
Los filtros de WordPress se crean utilizando la función APLICE_FILTERS y se definen dentro de la función respectiva. Estos requieren los argumentos $ TAG (nombre del filtro) y $ valor (filtrado o variable), con la opción de usar $ cal para funciones adicionales. Puede crear su propio filtro utilizando el gancho APLICE_FILTERS. Luego, para ejecutarlo, puede usar la función add_filter. Esto le permitirá conectar una determinada función al filtro para que pueda manejar la variable y devolverla. Los códigos cortos simplemente, los códigos cortos son piezas orientadas al usuario, que proporcionan a los usuarios una manera rápida y fácil de crear y mostrar características personalizadas en sus sitios. Se pueden colocar códigos cortos en publicaciones y páginas a través del editor, en menús y widgets, etc. Muchos complementos usan códigos cortos. Puede crear su propio código corto usando el add_shortcode. El nombre del código corto será la primera variable, y la segunda variable será la función de salida. La función de salida consta de tres valores: atributos, contenido y nombre. Widgets Otra forma de activar la funcionalidad del complemento a través de una interfaz simple es mediante el uso de widgets de WordPress. Puede crear un widget expandiendo la clase wp_widget. WordPress utiliza un enfoque de diseño orientado al objeto para los widgets, lo que significa que las funciones y valores se almacenan en la entidad única de una clase.
Antes de comenzar el desarrollo del complemento de WordPress, le recomendamos que lea estos temas para continuar entendiendo cómo funcionan los complementos. Aquí hay algunas herramientas y recursos útiles para desarrollar complementos de WordPress que pueda usar: Referencia de código de WordPress
WordPress Codex: escribir un complemento
Manual de complementos para desarrolladores de WordPress
Un tutorial de desarrollo de WordPress Plugin en 6 pasos ahora que observamos los elementos que conforman un complemento, es hora de hablar sobre cómo puede crear uno. Es importante tener en cuenta que antes de agregar un nuevo complemento a su sitio web o editar cualquier archivo, primero querrá configurar un entorno de prueba o un sitio de intermediación. Esto le permite experimentar de manera segura sin el riesgo de romper su sitio en vivo.
Siempre pruebe los cambios de su sitio web, incluidos los nuevos complementos, primero en un sitio intermedio. #Wordpress haga clic para enviar un tweet con él fuera de la carretera, eche un vistazo a los seis pasos en nuestro tutorial para el desarrollo de los complementos de WordPress:
Elija un nombre de complemento
Crear carpeta de complementos y archivo php
Agregue el encabezado del archivo
Programe su complemento y agregue funciones
Comprimir la carpeta del complemento
Active el complemento en su sitio web de WordPress
Paso 1: Elija un nombre de complemento El primer paso para desarrollar el complemento de WordPress es crear un nombre oficial para su complemento. Deberá elegir uno que sea relevante para lo que hace el complemento, pero que también es único.
Es una buena idea consultar el director de complementos de WordPress y hacer algunas búsquedas en Google, para asegurarse de que no haya otros complementos que ya tengan el nombre en el que está pensando. Tenga en cuenta que su nombre oficial del complemento será lo que usa para la carpeta del complemento y el archivo PHP. También puede usar una versión abreviada del nombre del complemento como prefijo, para evitar las colisiones de nombre (que discutiremos más adelante). Por lo tanto, también querrá elegir un nombre que se pueda abreviar fácilmente para crear un identificador único. Paso 2: cree primero la carpeta de complementos y el archivo PHP, su complemento necesita un lugar para vivir. Por lo tanto, después de decidir un nombre para su complemento, el siguiente paso es crear una carpeta para ello. Para iniciar, acceda al archivo WP-Content / Plugins de su instalación de WordPress. Cree una nueva carpeta y nombre con el nombre utilizando el nombre del complemento, utilizando guiones para separar las palabras (por ejemplo, “su nombre-pigeon”): una vez que haya configurado la carpeta del complemento, el siguiente paso es crear un archivo php en su interior. Querrá usar la misma convención de nombre (por ejemplo, “Your-Plugin-Name.php”):
Dependiendo de qué tan complejo será su complemento, puede contener un solo archivo PHP o más archivos. Por ejemplo, puede tener un lenguaje separado, archivos CSS, etc. Paso 3: Agregue el encabezado del archivo una vez que haya creado el archivo del complemento principal, es hora de agregar el encabezado del archivo. Esencialmente, este es un comentario de bloque PHP que incluye metadatos sobre su complemento dentro del archivo, agregue el siguiente código:/** * Nombre del complemento: Nombre de su complemento * Plugin: http://yourdomain.com * Descripción: Insertar una breve descripción de lo que su complemento aquí. * Versión: 1.0.0 * Autor: Su nombre * Autor: http://yourdomain.com * Licencias: LPL2 */Por supuesto que querrá reemplazar la información anterior con sus datos en su complemento. Si el director de sus complementos contiene Múltiples archivos PHP, asegúrese de agregar este encabezado solo a uno de ellos. Celular, este encabezado debe contener el nombre del complemento. Sin embargo, puede usar este espacio para incluir detalles sobre el autor, la licencia, etc. Cuando haya terminado, guarde sus cambios. Su complemento ahora debe agregarse a su sitio web de WordPress. Para asegurarse de que este sea el caso, navegue por el tablero del administrador de WordPress y vaya a complementos:
Debería ver su nuevo complemento en esta pantalla. Por supuesto, sigo trabajando. Paso 4: Programe su complemento para agregar funciones en este momento, ha configurado el marco básico para su complemento, sin embargo, obviamente todavía no hace nada. Para esto, deberá programar su complemento utilizando los elementos que discutimos anteriormente en esta publicación. Hay muchas maneras en que puede crear y usar complementos, demasiados para cubrir en una sola publicación. Sin embargo, si necesita ayuda para escribir el código para su complemento, le sugerimos que use WordPress Codex como guía. Tenga en cuenta que puede crear diferentes archivos para su complemento, por ejemplo, puede configurar archivos individuales para CSS, JavaScript, imágenes, etc. Aunque esto no es un requisito, puede ser extremadamente útil para fines organizacionales, especialmente si su complemento hace más de una cosa. Si alcanza varios archivos, los agregará a una carpeta comprimida antes de cargarlos en su sitio Paso 5:
Comprima la carpeta del complemento como vimos anteriormente, una vez que agrega un archivo PHP a su directorio de complementos de WordPress, el complemento se agregará automáticamente a su sitio web de WordPress. Sin embargo, al escribir el archivo PHP y el código de complemento, también puede usar un texto o editor de código. Esta puede ser una de las herramientas de desarrollo de complementos de WordPress más útiles en su arsenal antes de cargar el complemento en su sitio web de WordPress, deberá convertirlo en formato .zip. Por lo tanto, una vez que haya terminado de agregar el código completo que desea incluir, puede ir más allá y comprimir la carpeta del complemento. Para hacer esto, puede hacer clic en la carpeta y seleccionar compresión. Paso 6: active y ejecute el complemento en su sitio web de WordPress después de que termine de crear el primer boceto del complemento, eventualmente puede llegar a la parte divertida: ¡use en su sitio de WordPress! Si aún no lo ha agregado a su instalación de WordPress, puede cargar la carpeta a través de su director de complementos (consulte el paso 2 arriba para obtener más detalles). Si el complemento está en una carpeta.
Si el complemento ya estaba en su directorio de WordPress, simplemente explore la pantalla de los complementos y haga clic en el enlace de activación. Luego está listo para comenzar a probar el complemento y hacer cambios y mejoras, según sea necesario. Las mejores prácticas para el desarrollo de complementos de WordPress antes, durante y después del desarrollo del complemento de WordPress, hay un puñado de buenas prácticas que desea considerar. Estos consejos pueden ayudarlo a garantizar un proceso de desarrollo sin problemas y ayudarlo en la efectividad del complemento. Por ejemplo, cuando crea el complemento por primera vez, sea específico y estratégico sobre el nombre que elija. Deberá asegurarse de que sea único para que no tenga confusión o conflicto con otros complementos. También puede consultar las recomendaciones de WordPress sobre el nombre del complemento. Cuando llame a su complemento, asegúrese de que sea único, específico y fácilmente abreviado. #Wordpress haga clic para enviar un tweet también, le recomendamos que mantenga una estructura de WordPress de complemento limpio. Idealmente, su archivo-plugin-name.php estará en la raíz del director de arado, con cualquier otra cosa organizada en subterráneos. Para mantener una estructura de archivo limpia y simple, WordPress sugiere el uso de la siguiente jerarquía:

Otro consejo útil implica el prefijo. Al aplicar funciones, evite usar el prefijo WP_. Por defecto, las funciones del código de WordPress usan este prefijo, por lo que su uso para su complemento puede causar problemas de compatibilidad. En cambio, querrá usar algo único para su complemento, como una versión abreviada del nombre. Si es la primera vez que trabaja con complementos o crea uno desde cero, también puede considerar el uso de una calderera para complementos de WordPress. Esto le dará una base para el desarrollo del complemento de WordPress. Ofrece una guía clara que lo ayudará durante el proceso de construcción. Finalmente, no olvide hacer que la seguridad del complemento sea una prioridad. Lo último que desea es que su complemento haga que su WordPress sea similar a las intrud. Para obtener más información sobre la seguridad del complemento, puede consultar el manual del complemento. Preguntas frecuentes sobre el desarrollo de los complementos de WordPress En este momento, esperamos que haya obtenido una comprensión básica del desarrollo de complementos de WordPress y tenga una idea de cómo será el proceso. Sin embargo, puede tener preguntas. Dado esto, echemos un vistazo a algunas preguntas comunes sobre el desarrollo de los complementos de WordPress: ¿Cómo presento mi complemento en los complementos de WordPress?

Es perfecto para crear un complemento para su sitio y usarlo solo. Sin embargo, muchos desarrolladores también quieren tener complementos incluidos e incluso presentados en el director de complementos de WordPress. Para hacer esto, debe enviar el complemento al equipo de complementos de WordPress. Tienen criterios y requisitos específicos que su complemento debe cumplir para ser enviados, porque son aceptados. Por lo tanto, la mejor manera de introducir su complemento en el directorio es revisar cuidadosamente sus pautas y sugerencias. ¿Tengo que licencia mi complemento de WordPress? Si tiene la intención de usar el complemento solo para fines privados, no es necesario licencia. Sin embargo, si tiene la intención de compartirlo con la audiencia o enviarlo a los complementos de WordPress, deberá licenciarlo. Según las pautas de WordPress, todos los complementos deben adherirse a la Licencia Pública General de GNU V2 o más reciente. ¿Qué sucede si quiero desinstalar mi complemento? Puede desinstalar su complemento como cualquier otro complemento de WordPress. Por ejemplo, puede desactivarlo desde el tablero de WordPress y luego eliminarlo de su sitio. Sin embargo, hay dos métodos adicionales que puede usar. El primero es usar la función Registro_uninstall_Hook. El segundo es crear un archivo uninstall.php, luego agregarlo a la carpeta raíz del director de arado (/name-plagin/uninstall.php). ¿Cuántos archivos debería tener mi complemento?

Como recuerda, su complemento puede tener un solo archivo PHP o más archivos en su carpeta.La estructura del complemento de WordPress depende de usted y variará dependiendo de qué tan simple o complejo desee ser su complemento si tiene un complemento complejo, dividiendo su código en diferentes archivos y carpetas generalmente será la ruta más segura y puede inteligencia.Esto facilita la navegación en el código de complemento, por lo que puede encontrar rápidamente y hacer cambios cuando sea necesario.En la sección Las mejores prácticas para el desarrollo de complementos de WordPress, discutimos algunos consejos para estructurar las carpetas de complementos.Siéntase libre de referirse a esto como una guía para crear la jerarquía del archivo y las carpetas.¿Puedo escribir funciones de complementos en el archivo Functions.php del tema?

Si ha trabajado o desarrollado temas de WordPress antes, probablemente sepa que un tema usa un archivo Functions.php. Sin embargo, la diferencia entre complementos y temas es que los complementos son módulos independientes. No afectan el WordPress básico. Aunque es posible agregar funciones de tipo de complemento a las funciones.php de su base, insistemos en esto. Cuando actualiza o cambia su tarea, puede perder ese código. Esto también puede complicar la búsqueda y la resolución de problemas. El hermoso trabajo de los complementos es que son entidades independientes y no están relacionadas con el tema de su sitio. Por lo tanto, no tendrá que preocuparse de que su funcionalidad se vuelva inactiva si cambia los temas. Los complementos de finalización son una manera sólida de expandir la funcionalidad de su sitio de WordPress. Ingresar el desarrollo de complementos de WordPress lo ayuda a agregar características personalizadas en su sitio, sin tener que confiar en otros desarrolladores. En esta publicación, analizamos cómo puede desarrollar un complemento de WordPress en solo seis pasos: llame al complemento, asegurándose de que sea específico y único.
Cree una carpeta de complementos y un archivo PHP en su directorio de WordPress.

Agregue el encabezado del archivo del complemento.

Programe su complemento agregando funciones.
Comprima la carpeta del complemento en un archivo .zip.
Active el complemento en su sitio web de WordPress.