Comprender y usar el sistema de gancho de WordPress

Hemos cubierto muchos temas recientes de desarrollo web, por lo que probablemente haya oído hablar de ganchos, acciones y filtros. Estas son una parte esencial del uso de la arquitectura basada en el evento utilizada por WordPress. Y son su camino para crear sus propias “versiones” personalizadas por WordPress, lo que se adaptará a sus necesidades. En resumen, una arquitectura basada en el evento es una forma de escuchar eventos que cambian una determinada condición y luego reaccionan en consecuencia. Su reacción, lo que escribe, es cómo puede crear la funcionalidad que desea expandir las funciones de WordPress.
Como un ejemplo muy simple, publicar una publicación de WordPress es un ejemplo de un evento (publish_post) que cambia una condición. Esta es la base de la extensibilidad de WordPress, que hizo de CMS un ecosistema tan rico y próspero con miles de temas y complementos ricos. Hay otra razón fundamental por la cual el uso de ganchos de WordPress es crítico. Usando ganchos, puede expandirse y construir en WordPress sin tener que editar el código fuente básico. En realidad, déjame reformar la declaración. Si alguien que contrata para el desarrollo de WordPress (o que trabaja) sugiere un cambio básico del código de WordPress, active el acto.
Cualquiera que esté dispuesto a interrumpir la actualización de su sitio de WordPress, no tiene idea de lo que estoy hablando. Si tuviera una comprensión de los elementos básicos de la seguridad, ni siquiera pensaría en hacer eso. Hablé de eso antes. La actualización de WordPress (y sus temas y complementos) en la última versión disponible es uno de los elementos fundamentales de la valización de WordPress. Los desarrolladores que cambian el código fuente básico dejarán a su sitio un pato de lugar. Si sus empleadores están dispuestos a seguir un camino tan traicionero, es posible que no conozcan los elementos básicos del código. Es muy probable que sean devastadores con el código que escriben, dejándote (o con las personas que contratas) para limpiar la miseria que dejan atrás. Por otro lado, si usas ganchos y todas las demás opciones de extensibilidad que WordPress Te ofrece, se garantiza la actualización de WordPress. Esto significa que cada vez que se inicia una actualización básica de WordPress, la actualización de WordPress a la última versión no romperá ninguno de su código. No debe preocuparse por actualizar su propio desarrollo personalizado. Mientras los ganchos no sean depreciados, sus personalizaciones sobrevivirán a la actualización. Más importante aún, su WordPress se conserva protegido por cualquier vulnerabilidad de seguridad de WordPress que haya sido asegurada por la última actualización básica de WordPress.
¿Estás interesado en obtener más información? WordPress Codex ofrece una guía completa para ganchos, incluida una referencia de código para desarrolladores.

Ganchos, acciones o filtros? ¿Qué es? Los ganchos son prácticamente eventos que tienen lugar durante la ejecución de la funcionalidad, temas o complementos de WordPress. Pero, ¿por qué realmente se llaman ganchos? Los desarrolladores que desean expandir o implementar una funcionalidad específica pueden “conectarse” al evento tan pronto como ocurra y llevar a cabo una cierta acción relacionada con el evento. A medida que WordPress pasa por sus fases de ejecución, “verifique” para ver si algún complemento (o tema) ha registrado una función que se ejecutará en ese momento y, si encuentra alguna, esas funciones se realizan en ese momento. WordPress, como parte De la documentación de la API de WordPress, explica ganchos, acciones y filtros bastante hermosos, pero completo esta información, por supuesto. Hay dos tipos principales de ganchos
Acciones (también conocidas como ganchos de acción)
Filtros (alias ganchos para el filtro)
En realidad, son bastante similares en lo que pueden lograr, pero hay algunas diferencias sutiles. La diferencia entre los ganchos de acción y los ganchos de filtro comienza con lo que es lo mismo antes de discutir las diferencias. Tanto las acciones como los ganchos de filtro reciben datos a través de una serie de parámetros. Las acciones y los filtros también son principalmente capaces de hacer lo mismo (si puede ver el código fuente de WordPress, verá que las funciones del código que implementan las acciones son solo capas de las funciones del código de filtro).
Sin embargo, hay una diferencia clave entre los dos tipos de ganchos de WordPress. Los ganchos de filtro son necesarios para devolver un valor, los ganchos de acción no. Esencialmente, con un gancho de filtro, la función hoced recibe un cierto valor, hace su trabajo y luego devuelve una versión modificada (o no) de ese valor. Un gancho de acción no debe devolver un valor. Al ponerlo en términos más prácticos, con un gancho de filtro, generalmente trabaja en el contenido, realiza los “cambios” y luego devuelve ese contenido. Por ejemplo, como veremos a continuación, el gancho de filtro Title_Save_Pre funciona en el título de publicación, mientras que content_save_pre funciona en el contenido de la publicación). Cuando tiene lugar un evento. Publish_Post Action Publish_Post se dispara cuando se publica una publicación. Cuándo y cómo usar un gancho de acción debe usar un gancho de acción si lo desea:
Inyectar html u otro contenido en la memoria del búfer de respuesta
Cambiar una o más variables globales
Cambie los parámetros de su función de gancho
La forma de agregar un gancho de acción es la siguiente: add_action ($ gancho, $ functy_to_add, $ priority, $ aceptación_args);
Donde $ Hook sería la acción a la que desea conectarse, mientras que $ function_to_add es la función que escribió y se realizará cuando se active ese gancho. Veremos algunos ejemplos reales de hacer esto más en este artículo. Cómo y cuando usa un gancho de filtro puede usar un filtro cuando necesita hacer cualquiera de los anteriores, pero desea y necesita cambiar el parámetro de datos. De hecho, no es solo un deseo, es un requisito. Debe devolver un valor de parámetro si usa un gancho de filtro. La forma de agregar un gancho de filtro es bastante similar a agregar un gancho de acción: add_filter ($ gancho, $ functy_to_add, $ priority, $ acepth_args); Donde una vez más, $ Hook sería un gancho de filtro para usar y $ function_to_add es la función que escribirá. Eliminar el filtro y los ganchos de acción Eliminar los ganchos de WordPress que agregó es bastante simple. Es el reverso de la adición de ganchos y tiene una sintaxis muy similar: remove_action ($ gancho, $ functy_to_remove, $ priority); Remove_filter ($ gancho, $ functy_to_remove, $ priority);
El argumento prioritario $ es un argumento opcional. En el caso de add_filter y en el caso de remove_filter, $ prioirity determina el orden en que se activan los ganchos si hay varios ganchos “encadenados” o ejecutando uno tras otro en el mismo filtro o gancho.
Listo con la teoría, ¡dame algunos ejemplos de ganchos de WordPress! Aunque mencioné que hay muchos ganchos de WordPress que puedes usar, hasta ahora no te he mostrado exactamente lo que son. Aquí hay una lista de todos los ganchos de filtro que puede usar, mediante la amabilidad del códice de WordPress, mientras que esta es una lista de todos los ganchos de acción. Como puede ver, la funcionalidad de WordPress a la que puede conectarse es vasta. De hecho, es poco probable que cumpla con un caso de uso para el cual no hay gancho. ¡Y si cumple con dicho caso de uso, es posible que desee contribuir a WordPress y proponer su inclusión en futuras versiones de WordPress! Al momento de escribir, hay más de 1900 ganchos que puede usar. Veamos cómo podemos conectarnos a ellos para hacer algunas funcionalidades adicionales simples, que no están disponibles a través del núcleo de WordPress. Filter Hook Ejemplo #1 Al comienzo de este artículo, mencioné que un ejemplo de un cambio de condición es la publicación de un artículo de WordPress. En aras de este ejemplo, lo que haremos es crear un enlace de atribución en la parte inferior de cada publicación, por lo que si alguien vuelve a montar nuestros artículos en su sitio web, bloque, stock y (dos barriles de humo), tendremos al menos uno Backlink para indicar de regreso a nuestro sitio. Por esta razón, nos conectaremos al filtro content_save_pre, que se ejecuta en el contenido de la publicación antes de guardarlo en la base de datos de WordPress.
Se carga el esencial DataTard21/85D3B7C52375CB64B3AffffEdab5CCA4.
Como puede ver, siendo un gancho de filtro, cambiamos, luego devolvemos, el contenido. Filtro de gancho Ejemplo #2 Otro filtro bastante simple que realmente edita el resultado. Suponga que, para fines de marca y SEO, desea agregar el nombre de su empresa a los títulos en cada publicación de WordPress. En lugar de usar un complemento SEO o pedirles a los autores que hagan esto manualmente, puede crear un gancho de filtro que lo haga a medida que se accede a WordPress. Cargar Gist Dattard21/84CCA771961E8C603D03370F82AB852

Como puede ver, una vez más, nuestro ejemplo de un gancho de filtro usa Title_Save_Pre para hacer algunos cambios en el título y luego devolverlo. Ejemplos de filtros, pasemos a algunos ejemplos de ganchos de acción. Como verá, las principales diferencias con ellos serán que no devolverán ningún valor. Ejemplos de Action Hook #1 probablemente (debe) saber que presionar el botón de publicación en su publicación representa el final de la fase de publicación, pero el comienzo real de la fase de marketing. En términos de transmitir su contenido, es posible que desee comenzar enviando el contenido a las redes sociales, tan pronto como se publique la publicación. Al menos es posible que desee agregarlos a su programa de marketing en redes sociales. Ahora, si desea semiautomatizar este proceso, puede conectarse al gancho de acción Publish_Post y publicar el contenido en sus redes sociales.
El esencial DATATARD21/F7B86BD8AD4A72E81BF7FA8FACBBDAE4 está cargado

No profundizaré en el código exacto para la publicación, porque esto depende mucho de lo que quieras hacer exactamente y hay muchos tutoriales en el Interweb para ello. Action Hook Ejemplo #2 Suponga que creó un sitio con complementos de membresía. También creó una serie de recursos de bonificación que desea enviar como un correo electrónico separado del correo electrónico de registro. Lo que haremos es usar el gancho de acción después_signup_user para enviar un correo electrónico adicional con el contenido de bonificación.
Como puede ver, en realidad no devolvemos ningún valor (ya que este es un gancho de acción, no un gancho de filtro). El tercer argumento de la add_action en el código anterior es la llamada prioridad de gancho que especifica el orden en el que se ejecutará la función conectada a after_signup_user. El valor predeterminado (si no es un valor específico) se establecerá en 10. El cuarto argumento indica el número de argumentos que la función de la función aceptará, que es predeterminada 1 si está vacía. El ejemplo de código omnipresente: agregar Google Analytics a WordPress usando un gancho de acción solo porque este es uno de los ejemplos más extendidos en línea, ¡no significa que no sea un gran ejemplo del uso de ganchos de acción! NE wp_head al gancho de acción wp_head para agregar nuestro código de análisis de Google.
Se carga el esencial DatatarD21/7895D353EEEEEEEC2DCABFBFEAD6027.
¿Dónde se pueden usar los ganchos de WordPress? Complementos y temas, por supuesto. Tanto los complementos y los temas básicos y personalizados de WordPress expondrán sus propios ganchos para que los desarrolladores puedan agregar su propia funcionalidad personalizada al tema o complemento sin romper el tema o el complemento. En cuanto al código real, pueden ocurrir cambios simples en el archivo Functions.php, pero no existe una especificidad real o límite donde deben ir los filtros. Ganchos útiles que puede usar si está convencido por la utilidad de los ganchos, es posible que desee usar algunos de estos fragmentos de código usando ganchos. Fragmentos de código útiles para WordPress del detector de temas WP: muchos de ellos realmente usan varios ganchos de WordPress (descargo de responsabilidad: no han sido probados ni aprobados). Fragmentos de código más útiles para WordPress de WP Kube usando diferentes ganchos. Y hay muchos ganchos en esta enorme lista de trucos de WordPress. WordPress Hooks: su imaginación es el único límite como ha visto en este artículo, los ganchos de WordPress le brindan mucho poder y posibilidades para extender las funciones básicas de WordPress. Esto ofrece un gran poder para los diseñadores, desarrolladores e incluso freelancers de WordPress que solo quieren hacer pequeños ajustes. ¿Es algo que no entiende sobre WordPress Hobs? Tiene un ejemplo creativo de cómo usó WordPress Hooks para alcanzar una determinada personalización. ¿Tiene la intención de continuar usando a los ladrones de WordPress en sus proyectos futuros? Cuéntanos en los comentarios a continuación.
Etiquetas:
desarrollo
filtros
manos