Construyendo un complemento de WordPress Parte 2: Comience bien

En la primera parte de nuestra serie sobre la construcción de un complemento, comenzamos las cosas con información general de fondo sobre complementos, luego inventamos un mundo de Hello Basic para demostrar que la creación de un complemento funcional está disponible para todos.Es posible que los lectores con los ojos del águila hayan notado que nuestro enfoque inicial para crear un complemento fue un poco desagradable.Solo queríamos ver algo en la pantalla y no estábamos demasiado preocupados por lo que estaba sucediendo detrás de escena.Esta vez, organizaremos un poco mejor, usando un práctico kit llamado Boilerplate de complemento de WordPress para mantener las cosas rectas y estrechas desde el principio.Lo usaremos para poner nuestro proyecto en funcionamiento, luego tomaremos algunos exploradores en los archivos que genera.
Antes de bucear, describamos rápidamente por qué adoptamos este enfoque. La necesidad de estructura como Daniel Pataki señala en su excelente artículo de WordPress Plugin Boilerplate 101 en CodeInwp, hay mucho espacio para dejar que las cosas se deslicen cuando crea un complemento: “Desde el establecimiento de complementos de WordPress, hace unos 10 años, no lo han hecho. cambió mucho en la forma en que los escribimos. Hay un archivo de complemento principal con un encabezado seguido del Wild West. Además de usar ganchos, no hay una forma estandarizada de hacer complementos. Esto no es necesariamente un problema. Hay muchos complementos simples que no necesitan un marco gubernamental y hay algunas personas que pueden escribir un código de procedimiento perfectamente coherente. Dicho esto, la calidad del código de complemento no es generalmente la mejor, un marco o una metodología contribuiría en gran medida a su crecimiento “, dijo Daniel Pataki. El manual oficial de complementos nos da un excelente punto de partida en muchos aspectos y mucho de documentación sólida sobre las mejores prácticas para confiar, pero en realidad no requieren que las cosas sean correctas desde el principio.
WordPress Boilerplate Plugin nos ayudará a mantener nuestros patos en una fila. Usando un marco como WordPress Plugin Boilerplate, inmediatamente obtenemos dos cosas:

Una estructura cuidadosamente pensada que incorpora las mejores prácticas en términos de estándares de codificación y determina un comienzo sólido en general.
Un entorno de aprendizaje útil que nos permite caminar fácilmente sin tener que reinventar demasiada rueda.
En el contexto de desarrollar un complemento por primera vez, desde aquí desea comenzar. Pasemos a la instalación efectiva de nuestro marco. El establecimiento y la operación con el complemento de WordPress Boilerplate Plugin WordPress Boilerplate está destinado en gran medida a desarrolladores intermedios, pero también funciona como un conjunto de ruedas de entrenamiento para quienes comienzan. Los usuarios más avanzados probablemente quieran comenzar desde el almacén oficial de GitHub, pero estamos buscando mantener las cosas un poco más queridas y drenadas, por lo que adoptaremos otro enfoque. Hay un generador en línea en cuestión, que nos permite evitar muchos músicos manuales simplemente completando algunos detalles y luego descargar los archivos resultantes en un directorio local. Por lo tanto, nuestro primer puerto de parada es el generador de complementos de BoilPress Boilerplate, llamado rápidamente.
WordPress Plugin Boilerplate Generator nos exime de unos pocos pasos en la línea. Como puede ver en la captura de pantalla anterior, solo tenemos que enviar algunos detalles básicos para generar un paquete descargable bien preparado para nuestras necesidades. Todo lo que tenemos que hacer ahora es descomponer nuestro archivo generado y moverlo a la carpeta WP-Content /Plugins de nuestra instalación local de WordPress. En este caso, creamos un sitio llamado www.randomquote.dev, configurado rápidamente utilizando la magia de escritorio. Llamé al complemento My Random Cotes con una babosa de my-rdm-cotes.
Simplemente descomprima y extraiga la carpeta en su directorio /complementos para instalar. Si ahora navegamos por los complementos en la parte posterior de nuestro sitio local, veremos que los huesos desnudos de nuestro futuro enchufe de citas aleatorias se crean mágicamente:

La aparición inicial de nuestro complemento en el back-end de WordPress. Obviamente, algo difícil sucede en el backstage aquí. Comencemos a mirar debajo del capó y veamos lo que acabamos de recibir en los archivos y carpetas descargados. La transición a través de la estructura plegable de los complementos Una vez que realmente miramos dentro de la carpeta /complementos /my-rdm-cotes a nivel local, es inmediatamente obvio que comenzamos mejor estructurado que en nuestro intento anterior. Nuestros valores predeterminados tienen, obviamente, tienen, obviamente , una pequeña estructura. Las primeras cosas que llaman la atención son los cuatro archivos principales principales. Proporcionan una separación útil de las preocupaciones directamente de la caja:

Admin: Como era de esperar del nombre, todo el código de administración vivirá aquí. Haga clic en el interior y verá carpetas ya creadas para alojar CSS y JavaScript.

Incluye: Esta carpeta contendrá gran parte de la funcionalidad para configurar y desactivar nuestro complemento. Varios archivos útiles se incluyen implícitamente allí. Los revisaremos en un minuto.

Idiomas: esta carpeta contiene un archivo .pabricado prefabricado para ayudar a la internación.

Público: Aquí la funcionalidad pública debe ser alojada aquí. Nuevamente, verá las carpetas existentes para CSS y JavaScript si mira dentro.
Ok, ahora que tenemos una idea aproximada sobre el alcance de la tierra, para elegir algunos archivos clave para tener en cuenta desde el principio.
Examinar archivos de complemento clave para llevar las cosas aquí. En el directorio principal de la carpeta Plugin, hay dos archivos principales que cambiará:
ReadMe.txt: Ábrelo en un editor de texto y ya verá una útil horizontal para ayudarlo a crear el lector perfecto cuando llegue el momento. Pligin-Name.php: En nuestro caso, este es my-rdm-quotes.php . Aquí está el encabezado del complemento. Si abre ese archivo y se desplaza un poco hacia abajo, verá que también registra ganchos importantes para activar y desactivar su complemento e incluir lo que será nuestra clase principal de complementos.
Aquí vemos el encabezado de nuestro complemento y algunas configuraciones en progreso con las opciones de activación y desactivación. Tamizando el archivo my-rdm-quotes.php, es obvio que hay muchos elementos importantes a los que se mencionan directamente en la carpeta que incluye, así que pasemos por los principales:
Los archivos predeterminados que recibimos en la carpeta Incluir. Como puede ver en la imagen de arriba, estamos tratando con cinco archivos clave de clave desde el principio, cada uno de ellos define sus propias clases. Cada uno incluirá el nombre del complemento (en nuestro caso My-RDM-Quotes) en el nombre del archivo:
Class-plugin-name-activator.php: aquí aislar las cosas que deben suceder al activar el complemento.
Class-plugin-name-deactivator.php: Aquí puede limpiar después de usted cuando deshabilite su complemento.

Class-plugin-name-i18n.php: se gestionará la funcionalidad de internacionalización.

Class-plugin-name-loader.php: este es un archivo clave, pero probablemente no lo manejará demasiado directamente. Esto es lo que gestiona la grabación de acciones y filtros definidos por sus ganchos de complemento detrás de escena.
Class-Plugin-Name.php: Aquí está gran parte de la acción. Lo principal que debemos tener en cuenta aquí es que la clase le ofrece dos métodos, cada uno utilizado para administrar la adición de ganchos en la parte delantera y posterior. Ingresaremos brevemente la última clase más detallada.
Nuestros ganchos públicos y administrativos se gestionarán aquí. Como puede ver, los dos métodos a los que aludí anteriormente existen aquí en la forma define_public_hooks () y define_admin_hooks (). Mientras agregemos nuestros propios ganchos correctamente más tarde, deberíamos poder trabajar en su funcionalidad real real y ordenada en carpetas públicas y administradores, respectivamente. De acuerdo, hemos viajado mucho hasta ahora, ¡es hora de terminar las cosas por hoy antes de que nos perdamos en demasiados detalles! Conclusión Todavía no nos hemos hundido con ninguno de nuestro propio código, pero ya se han marcado una serie de casillas importantes. Quizás lo más importante es que podemos estar seguros de que comenzamos con una base sólida para construir, lo que debería mantenernos de acuerdo con las mejores prácticas generales.
Aunque pasamos por muchos de los detalles anteriores, la forma en que el marco que usamos se resume en tres conceptos clave:
Trabajaremos en cualquier cosa relacionada con el código de administración en la carpeta de administración.
La funcionalidad de la orientación pública se enviará a la carpeta pública.
Entraremos y saldremos de la carpeta que incluye todo de vez en cuando.

¿Tenemos curiosidad por saber si alguno de ustedes ya ha pasado la carretera estándar en proyectos anteriores? ¡Póngase en contacto con la sección de comentarios a continuación y háganoslo saber! Imagen presentada: Dyanap.