Nociones introductorias con el desarrollo de los complementos de WordPress

Los complementos son scripts PHP que cambian su sitio web practicamente, piezas (¡o incluso mucho!) Código que se puede cargar en su instalación de WordPress para expandir y extender la funcionalidad de su sitio, sin la necesidad de piratear el código básico. El gran trabajo de los complementos es que le permito agregar funciones a su sitio y mantenerse intacto, incluso si cambia los temas o actualiza la instalación de WordPress. Crear su propio complemento no es tan difícil y puede resolver muchos problemas. Copiar y pegar el código útil y las características adicionales en el archivo Functions.php del tema es excelente, pero estos cambios se pueden perder al actualizar el tema. Un plug -in es una cierta manera de probar cosas nuevas y cómo ir, si tienen que implementar funciones transtatic.
Este artículo lo guiará creando un complemento y también analizaremos algunos conceptos intermedios/avanzados:
Crear un complemento simple que integra WordPress con Facebook Open Graph.
Cómo funcionan los complementos.
Usando ganchos.
Comience con los filtros.
Agregar scripts y estilos.
Creación de una página de configuración de complementos.
Activación de traducciones.
Aunque esta publicación proporciona una excelente guía para comenzar el desarrollo de complementos, si desea mejorar sus habilidades de desarrollo, ¿por qué no consultar la academia? Hay cursos sobre cualquier cosa, desde el desarrollo de WordPress y PHP Learning hasta el comienzo de un negocio en línea y múltiples maestros. Y si eres miembro de WPMU Dev, ¡la adhesión a la academia es gratuita!
Nota: Esta guía está dirigida a aquellos que comienzan con el desarrollo de complementos. Algunos conocimientos sobre la edición de archivos y algunos HTML y PHP rudimentarios son todo lo que necesita seguir. Un proyecto de complemento simple en este artículo crearemos un complemento que integre WordPress y Facebook Open Graph. Las etiquetas gráficas abiertas son etiquetas HTML especiales que proporcionan información de Facebook que necesita para compartir su página y asegurarse de que se vea genial. Aquí hay un conjunto de ejemplos de etiquetas, que podrían usarse en la página que lee en este momento: el esencial C0DD60F310AC47DF91E se carga
Puede leer todo sobre Facebook Open Graph y las mejores prácticas de intercambio de contenidos de Facebook en Facebook.
Para este proyecto, debemos asegurarnos de que cada vez que se muestre un solo artículo de blog, las etiquetas de gráficos abiertos se agregan al encabezado de nuestro sitio. Los jefes del sitio consisten principalmente en metadatos y otra información oculta y se agregan entre las etiquetas y desde un documento HTML. La siguiente parte de este artículo se centrará en lograr esto. Después de este ejemplo, me aventuraré más profundamente en el territorio del desarrollo de complementos. Crear un nuevo complemento Lo primero que debe hacer es crear una carpeta para almacenar su complemento. Vaya a WP-Content/ Plugins/ desde su instalación de WordPress y cree una carpeta llamada My-FaceBook-Tags. Tenga en cuenta que lo que llame su carpeta de complementos será su babosa.
Un complemento de babosas debe ser único en todo el almacén de complementos de WordPress si desea cargarlo y ponerlo a disposición del público. Esto significa que ningún otro complemento creado por otra persona debería tener este sirviente. Puede buscar fácilmente complementos existentes, ¡solo use Google! Tenga en cuenta que el complemento de nombre no es necesariamente el mismo que su babosa. Miró la seguridad del complemento. El último bit de la URL es el sirviente: mejor seguridad de WP. Sin embargo, el nombre del complemento es la seguridad. Si solo hace un complemento para usted, aún es importante asegurarse de que los caracoles no chocen. Durante la vida de su sitio, probablemente usará una serie de complementos y no quiera que uno colisione accidentalmente con usted y cause problemas en su sitio debido a un conflicto de nombre. Ahora que tiene mi carpeta My-FaceBook-Tags, cree una Nuevo archivo en el interior y llámelo my-sfaceBook-tags.php. Este será su archivo de complemento principal y su nombre debe ser el mismo que el de su complemento, con la extensión PHP. Abra el archivo del complemento principal e inserte el siguiente código:
El esencial C0DD60F310AC47DF91E está cargado
Este código es un comentario de PHP, que no será directamente visible en el administrador de WordPress. WordPress usa los datos para eliminar el nombre del complemento y otros datos en la sección del complemento del Backynd. He adaptado esto para mi propio sitio web, así que asegúrese de cambiar el autor del complemento y otras filas como pienses.
Una vez que haya guardado este archivo, los saludos están en orden porque acaba de crear su primer complemento. No hace absolutamente nada, por supuesto, pero debería estar disponible en la sección de complementos y debería poder activarlo, continúe y hágalo ahora. Cómo funcionan los complementos para detenerse por un momento para ver cómo funcionan los complementos antes de continuar con nuestro proyecto de gráfico abierto de Facebook. Los complementos proporcionan funcionalidad con ganchos, por lo tanto, comprender la forma en que funciona es crucial. Veamos un análogo en el mundo real para los ganchos. Conoces esas pequeñas revistas en las que la primera oración dice: Soy el diario de _________. La línea vacía es el lugar donde pones tu nombre real. La compañía podría, por supuesto, pasar por todos los nombres y crear impresiones de cada uno, pero no sería económico y muchas personas quedarían fuera. Además, ¿qué sucede si quieres poner al “maestro de la galaxia” en lugar de tu propio nombre? Esa línea vacía es un gancho. En lugar de ser particularmente impreso para una persona, le pide al usuario que agregue su propio nombre. Los ganchos funcionan algo como esto en WordPress, para ver un ejemplo. Se requieren temas para agregar la siguiente función al archivo de encabezado: wp_head (). En esta posición hay un pequeño código en el que WordPress dice: si un complemento quiere poner un código aquí, puede hacer esto. El gancho WP_head nos permite a WP_head algo en la sección Cabeza de la página, que es exactamente lo que necesitamos. Probemos esto ”
El esencial C0DD60F310AC47DF91E está cargado
La primera línea del fragmento anterior le dice a WordPress que nos gustaría adjuntar ciertas características al gancho WP_head usando la función my_facebook_tags (). La segunda línea de código crea esa función, y la tercera línea de eco es una cadena simple. Esto ahora debería ser visible en la parte superior de cualquier tema que active, siempre que define que wp_head () (la definición es un requisito). Pronto eliminaremos esa cadena con Echo, porque nunca debe mostrar texto en la sección del cabezal. En aras de la corrección, permítanme mencionar dos cosas. Hay dos tipos de ganchos: acciones y filtros. En el caso anterior, utilicé una acción que sea obvia porque usé add_action (). Las acciones se ejecutan cada vez que WordPress detecta el gancho que los llama. Los filtros son similares, pero cambia un pequeño datos que WordPress usa. Un buen ejemplo es el mensaje de desconexión que se muestra. En lugar de realizar una acción cada vez que se muestra un mensaje de desconexión, un filtro le permite cambiar el mensaje de desconexión en sí. No entraremos en los ganchos en detalle aquí. Le recomiendo que eche un vistazo a nuestro artículo, una guía rápida (y profunda) para WordPress Hooks o WordPress Codex si desea obtener más información. Lo último que quiero mencionar aquí es que, desde un punto de vista técnico, se ejecuta una función conectada cuando se ejecuta la función do_Action () o APLICE_FILTERS (). La función wp_head () contiene llamadas a estas otras funciones en ella, no es el gancho en sí.
La finalización de nuestro complemento en función de la descripción anterior, está bastante claro que debemos agregar nuestros metaéticos de Facebook usando el gancho WP_head.Aquí está el resto del código requerido para nuestro complemento, seguido de una explicación: se carga el C0DD60F310AC47DF91 esencial
Básicamente, pegamos nuestros metaetichets tal como es. Las únicas cosas que tuve que cambiar fueron los valores para asegurarse de que reflejen la publicación que ahora se muestra. Utilicé la etiqueta acondicionada is_single () para asegurar que las etiquetas se agregan solo cuando se muestra una sola publicación. Para usar el título, el fragmento, la imagen, etc. de la publicación actual utilicé etiquetas de plantilla. El único truco que usé fue verificar si la publicación tiene una imagen presentada antes de mostrar la etiqueta de Facebook para ella. Con esta función única, creé algo bastante útil. Todas las publicaciones en su sitio ahora deberían tener etiquetas amistosas para Facebook. Puede asegurarse de que estén configurados correctamente utilizando el depurador de gráficos Open. Y ahora nuestro complemento está completo. Veamos ahora algunos otros conceptos de arado. El gancho correcto para la intriga correcta ahora que sabe cómo agregar cosas al jefe de su sitio, para ver la inserción de elementos en otras partes de su sitio. Usar acciones es bastante fácil. Si desea realizar una acción cuando WordPress haga algo, está buscando un gancho. ¿Qué tal cobrar Google Analytics en cada página? Esto debe hacerse en el sótano. ¿Pueden los temas definir algo similar a wp_head? Realmente lo hago. Usando wp_footer puede eliminar el código en la parte inferior de la página. WordPress mismo usa estos dos ganchos para colocar los scripts y estilos en sus lugares correctos. Hasta ahora, esto ha sido fácil, porque estos son ganchos que puedes ver de alguna manera. Pero, ¿qué pasa con los casos más “ocultos”?
¿Qué sucede si desea enviar un correo electrónico al autor una publicación una vez que se publique la publicación? Esto grita “acción” porque dices: cuando WordPress publica una publicación, entonces haz algo. Encontrar estos ganchos se ha vuelto mucho más fácil en los últimos años. Por lo general, se llaman bien: user_register, publish_post, perfil_update, etc. Si escribe “Agregar usuario de WordPress Hook” en Google, probablemente se reunirá con “User_register”. A partir de ahí, es solo una cuestión de documentación de lectura. Usemos Publish_Post para enviar a los autores un correo electrónico cuando se publiquen sus publicaciones. Aquí está nuestro código: Cargue el esencial C0DD60F310AC47DF91E
Tenga en cuenta que cuando utilicé add_action () especifiqué dos parámetros adicionales. El tercer parámetro es la prioridad, que dicta el momento en que se ejecuta la acción. Es posible que desee agregar más funciones al mismo gancho, y WordPress en sí podría usarlo demasiado internamente. Cuanto mayor sea la prioridad, más adelante se realiza la acción. El cuarto parámetro indica cuántos argumentos se transmiten a sus funciones. Esto es algo que tiene que buscar, porque no es obvio por el nombre de la acción. Puede mirar la documentación de WordPress o mirar en el código fuente de WordPress para ver dónde se define; el primero es definitivamente más fácil si recién está comenzando.
Dentro de la función utilizo los atributos de la publicación para obtener la dirección de correo electrónico de los autores y el título y el enlace a la publicación. Construyo un mensaje corto y uso la función de correspondencia integrada de WordPress WP_Mail () para enviar un correo electrónico rápido. De nuevo, ¿dónde sabía que había eso? ¡Google! Aunque es completamente posible escribir su propia función de correo electrónico, una búsqueda rápida de “WordPress Post” revelará esta función en un momento. Las nociones introductorias con los filtros mencionados anteriormente que los filtros son similares a los ganchos, pero le permiten cambiar los datos antes de usarse en lugar de implementar acciones adicionales. Para este ejemplo, cambiemos el mensaje de error que recibe en el formulario de conexión al ingresar una contraseña incorrecta en www.example.com/wp-admin porque hay un mensaje de error independientemente de nuestro complemento, solo queremos cambiarlo, somos Es probable que mire un filtro. De hecho, hay un filtro llamado “Login_errors”, así que usemos y cambiemos el mensaje: se carga el C0DD60F310AC47DF91 esencial.
El primer parámetro de cada función que agregue a un filtro siempre serán los datos filtrados. Si devuelve esto sin cambiarlo, llegará con la funcionalidad original. En nuestro caso, mostremos siempre el mismo mensaje de error. Esto puede ser útil si desea ocultar la raíz del error. Si ingresa un nombre de usuario correcto, pero una contraseña incorrecta, WordPress realmente le dice esto, dando a los piratas informáticos un poco de información. Tener solo un mensaje de error esta información está oculta. Los filtros y las acciones se usan ampliamente para casi cualquier cosa en arados, por lo que le insto a que tenga un aspecto profundo y se familiarice con su mecanismo. Puede obtener más información en WordPress Codex. La adición de scripts y estilos son las posibilidades de que en algún momento desee agregar su propio estilo o funcionalidad de JavaScript. Esto se puede hacer poniendo el activo en cuestión. Poner la cola utiliza acciones para agregar scripts y estilos de manera modular, cuidando cualquier adicción en el proceso. Agregamos soporte para una fuente de Google, que en realidad es una hoja de estilo: el esencial C0DD60F310AC47DF91E está cargado
La acción que usamos se llama terriblemente porque wp_enqueue_scripts en realidad se usa para agregar scripts y estilos frontales.En la función hoced usamos wp_enqueue_style () para agregar nuestro estilo.El primer parámetro es la babosa o mango de script (depende de usted), y el segundo parámetro es la URL del script.Usar //url.com en lugar de http://url.com es un buen truco que permite a los navegadores tomar la versión apropiada del script.Si su conexión usa HTTPS, se hará cargo de la versión HTTPS, de lo contrario, utilizará la versión HTTP habitual.Puede, por supuesto, cargar los activos que ha creado y almacenar en su complemento. Cargamos un script personalizado que creamos utilizando el método de cola: el esencial C0DD60F310AC47DF91E Cargas
El proceso es casi el mismo, pero utilicé varios parámetros en la función wp_enqueue_script (). El tercer parámetro define las adicciones del script. WordPress asegura que todas las adicciones se carguen, de modo que incluso si pone una adicción más tarde, se cargarán correctamente. El cuarto parámetro es una serie de la versión que puede elegir usted mismo. Estos parámetros adicionales también están disponibles para la función wp_enqueue_style (). El quinto parámetro, cuando se establece en True, le pide a WordPress que cargue un script en el sótano en lugar de un encabezado. Esto es preferible si sus scripts no son necesarios en el encabezado porque reduce el tiempo de carga y optimiza JavaScript. Para obtener más información sobre cómo poner la cola, eche un vistazo a nuestro artículo sobre cómo agregar correctamente scripts y estilos a WordPress. Crear una página de configuración de complementos Muchos complementos requieren algunas opciones que el usuario puede establecer. Es posible que desee desactivar las etiquetas de Facebook de Aban Graph en algunas publicaciones o incluso desactivar el correo electrónico del autor cuando publique publicaciones, ¿escribe?
Ambos se pueden implementar utilizando opciones. Hay varias formas de crear opciones para usted, incluidas algunas opciones disponibles. Para opciones simples, es más fácil hacerlos solos y estamos aquí para aprender, así que comencemos. El mejor método para usar es un enfoque orientado al objeto, pero aquí usaré un enfoque más simple. Eche un vistazo a las páginas de las opciones de creación en el códice de WordPress para enfoques más simples y orientados a los objetos. Lo primero que haremos es crear una entrada de menú en backend donde podemos colocar la configuración de la interfaz de usuario: se carga el C0DD60F310AC47DF91 esencial
Tenga en cuenta que usamos una acción, por supuesto, para hacer esto. Cada vez que WordPress ve el gancho Admin_menu, realiza todas sus funciones asociadas. Nos ha agregado una función, por lo que tendrá esto en cuenta cuando construamos el menú. Usamos add_men_page () para crear una entrada de menú de nivel superior. Esta función toma una serie de argumentos:

Título de la página: se usa en la etiqueta de título de la página (que se muestra en la barra del navegador) cuando se muestra.
El título del menú: utilizado en el menú a la izquierda.
Capacidad: el nivel del usuario al que se permite el acceso a la página.
Menú de babosas: la babosa utilizada para la página URL.
Función: el nombre de la función que usará para mostrar el contenido de la página.
Icono: una URL a una imagen o cadena.
Posición: la posición de su artículo en todo el menú.
Creamos la función vacía my_pligin_settings_page () (notará que agregué esto como el quinto parámetro). También agregaré el contenido de esta función a la vez. En esta etapa, debería poder ver la nueva entrada desde el menú en la parte inferior del menú. Antes de crear la interfaz con el usuario para manejar la configuración, anunciemos WordPress qué configuraciones intentamos usar. Esto se llama el registro de nuestra configuración. Para este ejemplo, supongamos que queremos crear un lugar para almacenar la información de contacto de algunos empleados clave que no forman parte de nuestro proyecto web, por ejemplo, nuestro contador. Se cobra el C0DD310AC47DF91e esencial.
Como puede ver, conecto una función en admin_init, en la que uso registro_setting () para agregar nuestras opciones. El primer parámetro debe ser un grupo de opciones, la segunda opción real. Recomiendo usar el mismo grupo de opciones si solo tiene unas pocas opciones. Entonces, ¿dónde sabía que tenía que usar Admin_init aquí? WordPress Codex, por supuesto! En algunos casos, el gancho que necesita usar es obvio. En otros casos, tendrá que buscarlo. En algunos casos, puede usar diferentes ganchos, mientras mantiene la funcionalidad. En estos casos, generalmente hay una forma recomendada de hacer las cosas. Siempre mire en el códice antes de implementar un gancho y estará bien. Entonces, ahora que tenemos la entrada al menú de administración y hemos registrado nuestra configuración, creemos un formulario para mostrar la interfaz de usuario. Glind el código a continuación en my_plogin_settings_page () vacío: vacío:
El esencial C0DD60F310AC47DF91E está cargado
Hay tres cosas a tener en cuenta al construir un formulario como este: use la función settings_fields (), agregando el grupo de opciones como primer parámetro. Esto muestra algunos campos ocultos que WordPress usará para guardar sus datos.
Use los nombres de las opciones que definió al registrarse en el parámetro de las entradas.
Tome el valor de un campo usando la función get_option () pasando su opción como el primer parámetro
El formulario de configuración que creé. ¡Con eso, terminaste! WordPress tiene cuidado de guardar todo porque usa las opciones de API incorporadas. ¡Bien hecho! Activación de traducciones Esto ciertamente no es una prioridad cuando crea complementos para usted, pero es una buena idea acostumbrarse a prepararse para la traducción, porque es una buena práctica para cualquier complemento público. Los elementos básicos son realmente muy simples. Cada vez que elimina un texto, incluya en la función __ () o en _e (). Use el primero para devolver la cadena, más tarde para repetirla. P.ej:
El esencial C0DD60F310AC47DF91E está cargado
El primer argumento de la función es la cadena a traducir, la segunda es el campo de texto. Debe ser lo mismo que su complemento Slug. Usando estas funciones, permitirá que otros traduzcan su complemento a su propio idioma. Este es un procedimiento simple que puede ayudar a tantos, ¿por qué no hacerlo? Hay un poco más que estas dos funciones, pero sabiendo solo lo anterior, usted es el 99% de la carretera. Para obtener más información sobre la traducción de complementos, eche un vistazo a nuestro artículo sobre cómo crear un tema o complemento que pueda traducirse. Conclusión Hay toneladas y toneladas de cosas que puede hacer con los complementos y casi tantas formas que puede crear. Aunque soy un partidario muy poderoso de los estándares de WordPress y hago las cosas correctamente (orientado a objetos, en muchos casos), insto a todos a experimentar. Siempre que no cree un producto de distribución, no dude en hacer lo que quiera. No se preocupe de complicar su vida con las metodologías que aún no comprende. Haga todo lo posible para buscar ganchos que puedan ayudarlo a agregar su funcionalidad y hacer que las cosas funcionen de cualquier manera que pueda. El conocimiento de hacer las cosas bien siempre llega a usted después de que pueda hacer las cosas mal, así que no se preocupe demasiado por las reglas por el momento. ¡Éxito para crear sus propios complementos! ¿Cuáles son sus ideas para los complementos de WordPress? ¿Qué más le gustaría aprender sobre el desarrollo de complementos? Háganos saber en los comentarios a continuación.
Etiquetas:
desarrolladores
complementos premium