How To Create WordPress Plugin – Ha pasado un tiempo desde que construí un nuevo complemento de WordPress desde cero, pero recientemente decidí convertir parte del código que funcionó para mí en un complemento completamente formado que puedo distribuir. Parte de este proceso implica reemplazar los datos codificados con opciones que los futuros usuarios de complementos pueden configurar.
Necesitaba crear una página de configuración en mi complemento y comencé a preguntarme cuál era el enfoque más reciente y mejor en el mundo en constante cambio de WordPress. Echemos un vistazo a las diferentes formas de agregar una página de configuración a un complemento de WordPress.
How To Create WordPress Plugin
La API de configuración de WordPress se agregó en WordPress 2.7 que permite a los desarrolladores registrar campos de configuración en formularios de configuración existentes en el tablero, así como crear nuevos formularios de configuración que WordPress muestra y se encarga de guardar los datos:
Creating WordPress Plugins The Right Way
Este es, con mucho, el método más manual de los discutidos en esta publicación, pero vale la pena entender cómo funciona y, en algunos casos, es un método bastante simple que puede ser necesario.
Primero, debemos registrar un nuevo elemento de menú y una página que contendrá nuestro formulario de configuración. Agreguemos una página debajo del elemento de menú de nivel superior “Configuración” en el tablero de WordPress:
El quinto argumento add_options_page es el nombre de la función utilizada para mostrar el contenido de la página, en este caso es el formulario de configuración. Esta función requiere un elemento de formulario y algunas llamadas de función para comunicarse con la API de configuración:
La función settings_fields genera código que le dice al formulario qué hacer, así como entradas ocultas que lo protegen con un nonce. El argumento que se pasa a la función es el nombre del grupo de configuración, que se registrará más adelante.
Best Online Course WordPress Plugins 2023
La función do_settings_sections es el cuerpo del formulario, aquí es donde se generan todas las secciones y campos (cuadros de texto, casillas de verificación, casillas de verificación, etc.) para que la entrada de un usuario pueda convertirse. Nuevamente, este argumento de función debe ser arbitrario pero único. Usaremos esto al registrar los campos.
Tres cosas están sucediendo aquí. Primero, usamos register_setting para crear un nuevo registro en la tabla wp_options para nuestra configuración, con “dbi_example_plugin_options” como option_name.
Nuestra configuración individual se almacenará como una matriz secuencial de datos. Esto es excelente para consolidar todas las configuraciones de nuestros complementos en un solo lugar, pero si no se administra correctamente, la serialización de datos puede causar problemas al migrar su base de datos de WordPress. El tercer argumento es el nombre de la función que maneja los datos válidos ingresados al guardar la selección.
En segundo lugar, registramos una categoría de grupo para la configuración, asociada a las opciones. Y finalmente, registramos tres campos para el grupo con add_settings_field. Todos estos son campos de texto para almacenar la configuración de nuestro complemento.
How To Create A WordPress Plugin?
A continuación, debemos crear una función que muestre el texto de ayuda para la sección y represente los campos del formulario:
Hay algunas partes móviles, registrando esto y aquello, copiando el código y asegurándose de que todo funcione bien. Esta no es la API de WordPress más fácil de usar o explicar. Por lo tanto, no sorprende que haya varias bibliotecas de paquetes que tienen como objetivo simplificar el proceso de agregar una página de configuración a un complemento de WordPress.
Cuando creé el complemento de WordPress para Instagram en 2012, creé la página de configuración utilizando el marco de configuración de WordPress, creado por nuestro propio Gilbert Pellegrom, incluso antes de que trabajáramos juntos o incluso antes de que nos conociéramos. El marco ahora está impulsado por el delicioso amigo de la mente James Kemp: la comunidad de WordPress realmente puede ser un mundo pequeño. 😄
Hablando del marco PHP, quería mostrar un método alternativo para crear una página de configuración sin usar la API de configuración de WordPress. Cuando construyo sitios para clientes, si necesito una página de configuración, uso campos personalizados avanzados para crear la página alternativa y luego defino los campos usando ACF.
How To Create A Custom WordPress Theme From Scratch (2023)
Esta es una de las muchas razones por las que me encanta usar ACF: toma lo complicado de WordPress y lo hace simple. (¿Ha visto ACF Blocks, un contenedor de recorte de bloques de PHP para el nuevo editor de bloques sin tocar React?)
Sin embargo, cuando crea un complemento o un tema para su distribución, no puede confiar en que el usuario instale ACF. Escribe el marco del campo de carbono. A diferencia de ACF, Carbon Fields no es un complemento y generalmente se instala como una biblioteca dentro de un complemento y utiliza el método Composer recomendado.
Sugerencia: si instala CarbonField en su complemento con Composer, asegúrese de evitar el infierno de administración de dependencias de WordPress al anteponer el espacio de nombres del paquete de Composer.
Para replicar lo que hicimos anteriormente usando la API de configuración de WordPress, simplemente use el siguiente código:
Learning How To Create A WordPress Plugin The Right Way
Como puede ver, el marco hace que sea muy fácil hacer que los campos sean más fáciles de usar, como agregar un valor predeterminado, mínimo y máximo en el campo “Límite de resultados”, así como establecer una fecha en “Fecha de inicio”. . “field. Picker: algo que requiere un poco de codificación para lograrlo a través de la API de configuración.
Los marcos pueden ser excesivos para proyectos a pequeña escala, pero son una excelente manera de hacer más con menos código, lo que le permite concentrarse en escribir su propio código.
Otro método para usar la API de configuración de WordPress con la facilidad de uso del marco es a través de uno de los muchos generadores de WordPress disponibles:
Recreemos nuestra página de configuración usando el generador de páginas de opciones de WordPress. Solo admite ciertos tipos de campos; Texto, área de texto, selección, radio, casilla de verificación, por lo que tampoco hay selector de datos.
How To Install A WordPress Plugin
Aquí está el código generado que puedo usar directamente en mi complemento y usar los datos de la misma manera que la API de configuración de WordPress.
El generador es una herramienta muy útil para lanzar un complemento con una página de configuración lista para usar que se puede modificar sin necesidad de una codificación complicada. También pueden ser buenos para aprender cómo funciona, desglosar el código existente y ver cómo encaja. Sin embargo, a la larga, es posible que no sean la mejor opción para un complemento que requiere muchos cambios en el código de configuración.
Uso de la API REST Uno de los muchos usos excelentes de la API REST de WordPress es mejorar la pantalla de configuración de su complemento o tema.
En este excelente artículo, Josh Pollock analiza cómo crear una página de configuración utilizando REST API y jQuery. No recrearé mi página de configuración con este truco ya que el artículo es un tutorial muy completo.
Best Related Post Plugins In WordPress
Solicitudes y experiencia de usuario mejorada después de hacer clic en “Guardar” y guardar la configuración del formulario en segundo plano sin actualizar la página, este enfoque parece mucho más moderno que la API de configuración de WordPress.
Josh señala que a medida que agrega configuraciones, el formulario se vuelve más complejo “usted hace más con jQuery, que es tedioso y más fácil de administrar y brinda una mejor experiencia de usuario que si estuviera usando VueJS o React”. lo que me lleva muy bien al siguiente método, la página de configuración impulsada por VueJS.
Durante el proceso de adquisición de mi complemento de membresía de WordPress el año pasado, investigué cómo se escribió el código base y descubrí que la página de configuración estaba siendo atendida por un paquete que usa la API REST y VueJS: wp-optionskit:
El paquete se puede instalar con Composer y la página de configuración se puede crear y configurar con el código que se encuentra aquí. Nuestra página de configuración de ejemplo se ve así:
Create A WordPress Plugin
Lo que me gusta de este método es que te permite crear páginas de configuración complejas con múltiples pestañas y subsecciones configurando una matriz de datos en PHP. Al igual que con los otros métodos, los datos de configuración se almacenan en un registro en la tabla de opciones, por lo que este es un método familiar para recuperar y utilizar los datos almacenados.
Si bien el mundo de WordPress está adoptando rápidamente React para editar contenido en el panel de administración de WordPress (WooCommerce incluso está reconstruyendo su administrador en React), no he visto ningún marco basado en React para crear páginas de configuración para complementos, algunos tutoriales aquí y allá. . Pero como vimos con wp-optionskit, el uso de la API REST abre la puerta para usar VueJS o reaccionar ampliamente en el panel de administración de WordPress.
¿Sabía que estamos reescribiendo toda la interfaz de usuario de WP Migrate DB Pro en React? Cuando hacemos esto, mejoramos el rendimiento y la experiencia del usuario, y hacemos que el código sea más manejable para el desarrollo futuro. (La versión beta 2.0 está disponible si habilita las actualizaciones beta en el complemento).
Como en todo lo relacionado con el desarrollo, hay muchas maneras de lograr el mismo objetivo, y el método elegido para un proyecto puede ser diferente al de otro. Mi favorito personal en este momento es wp-optionskit porque permite múltiples pestañas y subsecciones de configuración y una experiencia de usuario más agradable al guardar.
How To Create A Simple WordPress Plugin From Scratch
¿Qué método utiliza para crear páginas de configuración de WordPress para sus complementos? ¿Te perdiste algunas opciones populares? PERMITENOS conocer tus comentarios.
Esta entrada fue publicada en WP Migrate DB Pro, Desarrollo de complementos y etiquetada complementos, desarrollo, React, Vue.js, REST API.content free. Cuando realiza una compra a través de su enlace de referencia
How to create video, how to create website wordpress, how to create app, how to create business, how to create websites, how to create survey, how to create wordpress blog, how to create portfolio, how to create ebook, how to create firefox plugin, how to create wordpress theme, create wordpress plugin
