WordPress Hooks: Guía esencial

Los ganchos de WordPress son una herramienta útil diseñada para desarrolladores que fabrican complementos y temas de WordPress. De hecho, son tan útiles que los creadores de WordPress los usan en toda la base de WordPress. Pero, ¿qué son exactamente los ganchos de WordPress y cómo los usas? En esta guía, echaremos un vistazo al uso eficiente de los ganchos de WordPress y sumergirnos en los elementos fundamentales. ¡Vamos a bucear!
En esta guía
¿Qué son los ganchos en WordPress? En resumen, los ganchos de WordPress son fragmentos de WordPress que capturan y realizan fragmentos de otras piezas de código de WordPress. Estos permiten a los desarrolladores esencialmente saltar entre diferentes archivos fácilmente en su tarea y complementos. Los ganchos de WordPress están empaquetados en el núcleo de WordPress. Cada tema y complemento también los usan.
WordPress Hooks explicó que el objetivo principal de WordPress Hooks es permitir que los desarrolladores cambien fundamentalmente cómo funciona el sistema de gestión de contenido sin cambiar los archivos básicos de WordPress. Debido a que WordPress es de código abierto, podría meterse con los archivos básicos, pero hay un 99% de posibilidades de arrepentirse en unos minutos. Aunque puede ser un poco difícil de entender para los desarrolladores más nuevos, es absolutamente esencial descubrir cómo funcionan los ganchos de WordPress. La mayoría de las veces, la confusión aparece debido a la terminología que usa WordPress. Aunque la acción detrás del escenario es bastante similar a la de muchos lenguajes de programación, el verbo es diferente. A menudo es el más fácil aprender a crearlos y usarlos siguiendo ejemplos, leyendo sobre ellos y luego practicando.
Para escribir ganchos de WordPress, deberá poder codificar en PHP. PHP es el lenguaje básico para la gran mayoría de WordPress. Puedes pensar en los ganchos como aperturas que otras funciones de PHP pueden atrapar. También puede pensar en WordPress Hooks como llamadas de llamadas que hacen algo sobre datos o visualización antes de ver datos. Dos tipos de ganchos de WordPress hay dos tipos principales de ganchos de WordPress que debe aprender:

Ganchos de acción de WordPress
Ganchos de filtro de WordPress
Echemos un vistazo a estos dos tipos de ganchos de WordPress y la diferencia entre ellos. También exploraremos algunos ejemplos de ganchos de acción y ganchos de filtro para ilustrar mejor su uso.
La diferencia entre los ganchos de acción de WordPress y los ganchos de filtro Si pasó tiempo examinando el código de WordPress, probablemente vio estos términos lanzados por casualidad. Desafortunadamente, una de las debilidades del códice es que está escrito por los propios desarrolladores. Como efecto secundario, algunas distinciones importantes que pueden ser obvias para ellos, no son obvias para aquellos que no están tan familiarizados con la WordPress básica. La forma más fácil de marcar la diferencia entre los dos tipos de ganchos de WordPress es que los ganchos de acción no devuelven los valores, mientras que el filtro de los gancos de retorno de retorno. Para aquellos familiarizados con los lenguajes de programación ordinarios, es como si dijeras que los ganchos de acción tienen un tipo de retorno “nulo”, mientras que los ganchos del filtro devuelven datos reales.
Los ganchos del filtro pueden considerarse como ganchos o eventos de preprocesamiento. Un gancho de filtro puede filtrar los resultados devueltos de una consulta de base de datos para contener solo entradas familiares “Smith”. Se debe llamar a este gancho de filtrado antes de que la base de datos real sea atractiva, diciéndole WordPress por adelantado que tendrá que eliminar los resultados irrelevantes antes de devolverlos. Se puede considerar que los ganchos de WordPress de Ction recuperan algo por código. Un ejemplo de gancho de acción ordinario es la inserción de un archivo CSS adicional en una página del sitio para que parezca de manera diferente. Recuerde, los ganchos cambian la forma en que se muestran los datos antes de entregarse al usuario. Un gancho de acción proporciona un nuevo archivo CSS que mejora la experiencia del usuario. Este proceso no implica la edición del núcleo de WordPress, ni requiere la edición de la raíz web básica. De esta manera, los ganchos de WordPress pueden hacer que sea mucho más fácil, junto con complementos, administrando varios sitios de WordPress.
Los ganchos y los filtros ahora explicaron que hemos analizado una imagen general más abstracta de los ganchos y filtros de WordPress, para lanzarnos los detalles más técnicos sobre cómo funcionan. Puede pensar en un gancho de WordPress como un evento que tiene lugar con un nombre. Un ejemplo de un contenido en el núcleo de WordPress se llama save_post. Con los ganchos, decimos en esencia que cuando se ejecuta save_post, queremos que nuestro gancho o filtro se conecte y ejecute con él. Adjuntamos lo que se llama llamadas de llamadas o funciones de apelación, a los ganchos en WordPress. Esta es solo una forma de fantasía de decir que le pedimos a WordPress que ejecute el código contenido en las funciones que creamos cuando el evento “colgamos” (como Save_Post se activa en nuestro ejemplo anterior). Aunque es bastante fácil agregar ganchos de WordPress , como exploraremos más adelante, recuerde que una llamada escrita inapropiada puede arruinar por completo su cadena de llamadas inversa. Si esto sucede, ¡un enlace interrumpido en la cadena de llamadas invertida puede arruinar por completo todo el trabajo duro! Siempre haga una copia de seguridad antes de hacer cambios. Aproveche un complemento de repuesto de WordPress de confianza antes de hacer cambios. ¿Está interesado en detalles aún más técnicos detrás de la forma en que funcionan los ganchos? ¡Consulte la siguiente sección! ¡Tenemos una explicación más detallada, así como un tutorial sobre la creación del primer gancho de acción y el primer gancho de filtro!
¿Cómo funcionan los ganchos en WordPress? Recuerde, aunque hay algunas diferencias, los ganchos de acción y los ganchos de filtro de WordPress se pueden ver principalmente. Pasemos brevemente cómo funcionan estos ganchos. Pasaremos un ejemplo y un tutorial más adelante en el artículo. Ambos tipos de ganchos deben grabarse en WordPress antes de usarlos. Esto ofrece a CMS la lista de funciones que debe adjuntar cuando hay un evento en que “cuelgemos” el código. Además, asegúrese de que las acciones se registren como acciones y que los filtros se registren como filtros. Cuando agrega una acción, aproveche la add_action () básica. Al agregar filtros, use la función basada en WordPress adecuada llamada add_filter (). Si sus llamadas llamadas (funcionan en la cadena cuando se ejecuta su evento o acción) no devuelva datos, debe registrarlos como una acción. Si devuelve lo que WordPress se refiere a los datos del filtro, luego registérsalos como un filtro. Lo que sea que especifique en estas funciones se enrolla cuando un usuario está abierto. WordPress tiene un generador interno que organiza todas estas acciones y filtros para nosotros. También hay funciones de eliminación apropiadas para acciones y filtros. Se pueden usar para eliminar una función de su cadena de llamadas inversa. Estos a menudo están contenidos en declaraciones condicionadas en WordPress PHP.
Al igual que nuestras funciones adicionales, se llaman reme_action () y remove_filter ().¿Cómo creo un gancho en WordPress?¡Finalmente, ha llegado el momento de hacer nuestro primer gancho en WordPress!Recuerde que crear ganchos implica agregar un código personalizado que se mostrará y se representará a los usuarios de nuestro sitio.Tenga en cuenta que cada vez que agregamos código personalizado, agregamos un cierto nivel de riesgo a la seguridad.Por lo tanto, ahora sería un momento ideal para asegurarse de tener un complemento de seguridad de WordPress donde pueda confiar y listo para usar.Esto puede ayudarlo con la tranquilidad y puede mejorar cualquier amenaza potencial para su sitio a través del código personalizado que pueda introducir nuevas vulnerabilidades.
haga clic aquí
Echemos un vistazo a cómo podemos crear un gancho de acción muy simple en WordPress. Luego analizaremos un ejemplo de gancho de filtrado en CMS. ¿Cómo creo un gancho de acción en WordPress? Para nuestro ejemplo de acción, hacer algo que casi todos los desarrolladores de WordPress tendrán que hacer en algún momento: ajuste el contenido en la página de autenticación de WordPress. La página es muy genérica. Por ejemplo, si administra un sitio de WordPress para una institución académica, puede pedirle que le recuerde que use la dirección de correo electrónico del campus para conectarse a su portal de WordPress. Podríamos agregar un recordatorio simple en los cuadros “Nombre de usuario” y “Contraseña” que usted escribe “no olviden usar el correo electrónico @ myuniversity. Esto, por supuesto, estaría más alineado con un gancho de acción que con un gancho de filtro. Esto se debe al hecho de que un ajuste simple, como editar el texto en la página del usuario principal, en realidad no devuelve ningún dato de filtro. En primer lugar, tendremos que averiguar dónde conectarse a la acción. En la mayoría de los casos, examinar el archivo PHP en el que desea agregar contenido puede ser muy inteligente. Al echar un vistazo al archivo de WordPress que contiene el contenido de conexión, hay varios desencadenantes de acción. En nuestro ejemplo de recuerdo dirigido a los estudiantes para usar sus correos electrónicos institucionales, notará el siguiente código bastante interesante en el archivo PHP de la página de autenticación: do_action (‘login_footer’);
La función Do_Action es una función básica de WordPress que realiza nuestra acción a pedido. Por supuesto, esto se ofrece si hemos grabado todas las funciones que queremos adjuntar a este gancho. En este caso, “Login_footer” es un gancho prematuro del equipo de WordPress. Aunque se incorpora, sin embargo, podemos adjuntar su propio código. Por defecto, este gancho carga el contenido del sótano de la página de conexión genérica. El sótano sería un lugar ideal para nuestro texto, por lo que aprovechamos la sección de esta página. Podemos agregar una nueva función PHP a WP-Login.php para comenzar. Todo lo que tenemos que hacer es mostrar una línea de texto, como: add_uni_email_reminder () {
¡No olvides usar la dirección de correo electrónico @ myuniversity.edu como nombre de usuario!
}
do_action (‘login_footer’, ‘add_uni_email_reminder’);
En este caso, simplemente hemos creado una nueva “acción” en el archivo wp-login.php. El nombre de la acción del gancho de acción (add_uni_email_reminder), sin paréntesis, se puede agregar a la lista de parámetros do_action () para registrarlo para que se ejecute cuando el sótano se representa aún más. ¿Cómo creo un gancho de filtro en WordPress? ¡Ahora estamos en el papel! Aprendimos los elementos básicos de los ganchos de WordPress y cómo usar su poder. ¡Incluso hicimos un pequeño cambio!

La única parte importante que queda es practicar con ganchos de filtro. Recuerde, estos son ganchos que devuelven un cierto tipo de datos que podemos filtrar. Estos son un poco más complejos que los ganchos de acción, pero ahora que comprende los elementos básicos de los ganchos, debería ser un poco más fácil. Comencemos con nuestro gancho de filtro de WordPress. Primero, tendremos que decidir qué filtro específico queremos agregar. Un elemento que su cliente podría solicitar es personalizar la función agregando. Aquí los usuarios de WordPress pueden agregar nuevas publicaciones de blog. Para mantenerlo lo más simple posible, decir que queremos editar el texto “Ingrese el título aquí” contenido en el cuadro de texto “Título”. Supongamos que queremos hacerlo más específico y decirle “Ingrese el título de publicación en el blog”. Observe que, en nuestro ejemplo de gancho de filtrado a continuación, nuestra función tiene un parámetro. Además, la ejecución efectiva de nuestro filtro tiene un parámetro adicional de “prioridad”. También notará que la función real que usamos para grabar nuestro gancho es exactamente la misma que nuestro ejemplo de “acción”, add_action. La forma en que podemos decir que esta función es más bien un gancho de filtro que un gancho de acción es que cuando se ejecuta realmente, la función ejecutada como podemos ver en el código básico de WordPress es Apply_filters (‘Enter_itle_re’, __ (‘Ingrese el título aquí ‘), $ post); . Aplicamos filtros como sugiere fuertemente el nombre de la función. Este es a menudo un punto de activación para los usuarios más nuevos. De hecho, es solo un problema de fácil formulación;
Una vez que pasas por esto, ¡descifrar la diferencia entre ganchos y filtros en WordPress se vuelve bastante simple!Sin otras adiciones, ¡sumergamos para cambiar el texto sustituyente!works_nou_titlu_aici ($ títulos) {$ title = __ (“Ingrese el título en el blog”, “Text-Domain”);
Devuelve $ Título;
}
add_action (‘enter_itle_here’, ‘our_new_itle_here’, 10);Es posible preguntarse qué significa “10” en nuestra función add_action.Esperamos que comprenda los dos primeros parámetros;
El primero es el gancho predeterminado de WordPress, y el segundo es el nombre de la función y el filtro que adjuntamos a Enter_title_here. “10” es el nivel de prioridad que atribuimos a este filtro. Recuerde, tanto las acciones como los filtros de WordPress son una serie de “llamadas” en la cascada o funciones personalizadas que se ejecutan. Se les dan diferentes niveles de prioridad. Exploraremos qué significan los diferentes números, cuáles son los parámetros aceptables, etc., un poco más tarde. Sin embargo, es importante comprender que 10 es el nivel de prioridad implícita “normal” de WordPress para filtros y acciones por ahora. ¿Dónde se almacenan los ganchos de WordPress? Es posible que se pregunte dónde WordPress podría almacenar todas estas acciones y filtros. Hice una referencia al núcleo de WordPress, pero esta es simplemente la ubicación de las acciones y filtros construidos y las funciones adjuntas a ellos. Los usuarios experimentados con WordPress probablemente sepan que estos ganchos no se almacenan en ninguna base de datos creada cuando se instala WordPress. ¡Una de las características más singulares de las acciones y filtros de WordPress es que no están “almacenados” en ningún lado! Después de agregar una acción o filtro, se puede acceder a la acción o filtro a nivel mundial en nuestro sitio web de WordPress. Si crees que no hay forma posible de almacenar en ningún lado, ¡tienes razón! Aunque la estructura es bastante compleja, hay una variable PHP en la que se almacenan todas nuestras acciones y filtros. Esta variable es global y se llama $ wp_filter. ¡No te equivoces directamente con esta variable!
Para aquellos interesados ​​en los detalles técnicos, esta variable $ wp_filter es una matriz PHP. Contiene una gran serie de objetos de tipo wp_hoook. En el archivo PHP que puede leer en WP-Includes / Class-WP-Hook.php, hay un método importante: this-> Aplice_filters (). Este método es el que desencadena todas nuestras llamadas y “registra” nuestros filtros y ganchos personalizados. El pan y la mantequilla de los ganchos de WordPress son esencialmente. Para aprovechar al máximo esta maravillosa característica de WordPress, necesitaremos conocer algunos de los Hoooks de WordPress más comunes. ¡No mires más allá de la hoja de trucos a continuación! Lista de ganchos de WordPress: WordPress Hooks Trucos para comenzar con una pequeña dosis de realismo: no hay forma posible de superar cada gancho de WordPress. Afortunadamente, algunos investigadores han compilado una lista de (literalmente) cada acción y filtro, para aquellos que tienen curiosidad. Puede ver aquí una lista completa de todos los ganchos de WordPress, pero tenga cuidado de ver las advertencias de seguridad sobre cada gancho. No debe usar ninguno que esté etiquetado como “depreciado”. Esto significa que pueden ser aceptados en la versión más moderna de WordPress, pero en cualquier caso, no serán aceptados pronto. Después de toda probabilidad, el 90% del tiempo, solo estará interesado en algunos ganchos de WordPress. ¡Aquí hay cinco de las acciones y filtros de WordPress más populares, junto con una breve explicación de lo que son!
Add_setting () – Como su nombre indica, esta acción se agrega a su configuración de WordPress. Probablemente no quiera incluir esta acción en ninguna página orientada al usuario, pero puede ser un salvador si cambia las páginas administrativas.apply_filters () – ¿Parece familiar? ¡Debería, porque lo usé antes! Esto inmediatamente llama a toda nuestra cadena de llamadas asociadas con un gancho.
ESC_ATTR () – Su nombre se acorta para “HTML’s Escape”. Escape HTML significa que usamos códigos ASCII para símbolos HTML. Esto se usa casi universal para la “higiene de las entradas” de las páginas. En otras palabras, esta acción sería extremadamente deseada adjuntar a un gancho ejecutado cuando un usuario envía un formulario. Evite que los usuarios atacen su sitio con ataques de script entre sitios en particular.
The_content (): el nombre de este gancho probablemente suena simple, ¡porque lo es! Simplemente capture el contenido de la publicación vista actual. Esto es ideal si permite a los usuarios exportar el contenido de una publicación. Por ejemplo, algunos sitios brindan a los usuarios premium la oportunidad de exportar cualquier artículo como un archivo PDF.
Wp_nav_menu () – Estenografía para el “menú de navegación de WordPress”, este gancho es un gancho de acción. Se utiliza simplemente para mostrar el menú de navegación principal que crea cuando crea su sitio de WordPress por primera vez. Esto es genial si tiene páginas que tienen un aspecto significativamente diferente y desea mostrar el menú en un área alternativa.
¿En qué orden se ejecuta WordPress Hooks? Desafortunadamente, la secuencia de activación de WordPress ganchos, el orden exacto ejecutado por WordPress Hooks, no es tan obvio como se puede imaginar. Esto se debe al gran volumen de ganchos. Un investigador realizó un análisis avanzado de esto para contar el número de ganchos que se ejecutan y el orden en el que se hicieron enrollados al visitar un sitio web de WordPress. ¡Como si esto no fuera lo suficientemente complejo, algunos ganchos de WordPress tienen ganchos adjuntos a diferentes prioridades! Puede echar un vistazo a los cientos de ganchos enrollados y sus comandos en esta publicación sobre la secuencia de lanzamiento de WordPress Hook. Nota: ¡No debe intentar ejecutar este análisis en algo más que un servidor de prueba en el que puede permitirse perder todo! Aunque no podemos hacer mucho sobre el orden de los ganchos predeterminados, podemos hacer algo sobre el orden de los ganchos que especificamos. Aquí viene la prioridad de los ganchos. Aludí a esto antes. ¿Cómo funciona la prioridad en los ganchos de WordPress?
Como mencioné, el nivel de prioridad predeterminado atribuido a un gancho de WordPress es “10”. Independientemente de lo que decida hacer la prioridad, recuerde que el valor debe ser un entero positivo. Esto significa que, desafortunadamente, “0” no es un valor válido. Además, -100 no sería válido y 0.5 no sería válido. Sin embargo, 1 funcionaría, así como 1111. En general, cuanto más bajo sea el todo, menor será la prioridad. Si desea que se ejecute un gancho después de un gancho, ha asignado el valor predeterminado 10, por ejemplo, puede hacer su prioridad 9. Su gancho con la prioridad más baja puede recibir 1. Además, se pueden asignar ganchos de WordPress, así como prioridad. Que si no le importa qué orden se ejecuta. Escritura: Hooks en WordPress Uno de los mayores obstáculos para los nuevos desarrolladores de WordPress es cómo no están estandarizados puede ser mucha de esta información. Aunque encontrará muchos blogs técnicos, muchos cubren temas estrechos y pueden ser difíciles de agregar. La mejor manera es comenzar a experimentar con ganchos de acción de WordPress y ganchos de filtro en su sitio. Una vez que haya creado ganchos de WordPress más complejos, deberá aprender los ganchos que tiende a usar con más frecuencia. Con el tiempo, memorizarás estos ganchos. Es un proceso difícil y nadie puede memorizar cada uno de estos ganchos. WordPress Codex es el mejor recurso que puede usar en su viaje para ser el próximo desarrollador de WordPress en el mundo. Kristen Wright
Kristen escribió tutoriales para ayudar a los usuarios de WordPress en 2011. Por lo general, puede encontrarlo trabajando en nuevos artículos para IThems Blog o desarrollar recursos para #WpProsper.Fuera del trabajo, Kristen disfruta del diario (¡escribió dos libros!), Senderismo y acampar, cocinar y aventuras diarias con su familia, con la esperanza de llevar una vida más presente.