Guía completa para principiantes para ganchos de WordPress

Si observa una página de WordPress con cualquiera de las herramientas de desarrollador disponibles, puede tener la impresión de que se compone principalmente de HTML y CSS con un JavaScript ocasional. Sin embargo, lo que ves allí es solo el producto final. En el fondo, gran parte de cualquier página de WordPress dada está realmente construida a partir de funciones de PHP y consultas de bases de datos. Son interpretados por el navegador, que luego escupe la página en forma visible. Si bien el CSS funciona bien para hacer cambios superficiales (colores, tamaños, etc.), si desea realizar cambios estructurales más grandes, deberá lidiar con el código fuente.
Una posibilidad de hacer esto es localizar las líneas de código respectivas en los archivos básicos y reemplazarlas con los suyos es un método (indiscutible) y que algunas personas continúan utilizando. Sin embargo, la desventaja de esta práctica es que, con la próxima actualización de WordPress, todas sus personalizaciones desaparecerán. Los archivos básicos se sobrescriben y – POOF – todos sus cambios desaparecen. Además, no actualizar no es una buena idea, porque presenta un riesgo de seguridad grave. ¿Entonces lo que hay que hacer? Afortunadamente, hay una manera de cambiar el código a WordPress sin cambiarlo efectivamente. ¿Suena imposible? Bueno, déjame presentar tus ganchos de WordPress.
¿Qué son los ganchos de WordPress? Los ganchos son una herramienta increíblemente poderosa. Saber cómo usarlos es uno de los conceptos más importantes tanto para el desarrollo de complementos como para el tema. Por ejemplo, los ganchos se usan ampliamente en temas, como Génesis, para permitir personalizaciones más fáciles del tema. Pero no dejes que eso te asuste. Incluso si no es un desarrollador y solo busca una forma más elegante y efectiva de hacer cambios en su sitio, puede continuar averiguando sobre WordPress. Entonces, ¿qué son? En primer lugar, los ganchos son fáciles de ver. Cada vez que ve un pedazo de código envuelto en do_action () o aplica_filters (), ha encontrado un gancho. Aparecen tanto en el núcleo de WordPress como en los complementos y los temas. Por ejemplo, en la sección del encabezado de muchos temas, encontrará una línea de código similar: [Php] <? Php WP_head (); ? } [/php] no sucede mucho aquí. Esta pieza de código crea una función llamada wp_head y la convierte en un gancho (do_action (), ¿recuerdas?). ¿Cómo es útil o incluso necesario? Bueno, te lo digo. Aunque el código realmente no realiza ninguna función por sí solo, transforma WP_head en una especie de ancla.
Esto significa que puede conectar otras funciones y códigos, que luego se realizarán una vez que WordPress procese la función WP_head. Como resultado, su código personalizado no debe colocarse físicamente en la misma ubicación, sino que se extrae del exterior. De esta manera, puede realizar sus propias funciones en la construcción básica sin cambiar ningún código en los archivos básicos. Bastante dulce, ¿verdad? La mejor parte es que, no importa con qué frecuencia actualice WordPress, sus cambios permanecerán vigentes y no se sobrescribirán. ¿Convencido? Luego, sumergamos un poco más. Sus instrumentos principales: acciones y filtros para cambiar la funcionalidad a través de los ganchos de WordPress, confiamos en dos formas principales: acciones y filtros. Las funciones apropiadas de WordPress son add_action () y add_filter (). El término ganchos a menudo se usa como un paraguas para estas funciones y, al mismo tiempo, para los sustitutos en los que podemos colgarlos. Para hacer las cosas más confundidas, a veces escuchará sobre ganchos de acción y ganchos de filtro. Sin embargo, no te preocupes demasiado por eso. Es más importante comprender la metodología detrás de esto.
Si bien las acciones y los filtros son generalmente muy similares en su sintaxis, la forma en que funcionan es bastante diferente. Al conectar una acción a un sustituto, se realiza además de cualquier función ya presente en esa ubicación especial. Por esta razón, los ganchos de acción se utilizan para agregar cosas a su sitio, por ejemplo, si desea crear un nuevo área de widget en su encabezado o sótano en su sitio web, lo haría con una acción de gancho. Los filtros, por otro lado, cambian la funcionalidad existente. Están entre la base de datos y el navegador y pueden modificar el código que se transmite en cualquier dirección. Un ejemplo para el uso de un gancho de filtro sería si desea reemplazar el saludo "bueno" en la barra de administración de WordPress. La principal diferencia entre acciones y filtros es que este último debe devolver un parámetro a la función original. Esto significa que se hacen cargo de cualquier argumento en el código que deben filtrar, modificarlo de una manera y luego devolver el parámetro modificado a su predecesor. Las acciones, por otro lado, solo ponen un código adicional en la función en la que se conectan y, en general, no les preocupa por qué ya existe algo más.
¿Sentido? No se preocupe, si todavía no está claro en los detalles, todo se volverá más claro una vez que llegemos al código real. La estructura del gancho ¿Cómo se usa acciones y filtros? La estructura general se ve así: [php] add_action ('name_cârlig', 'name_function_dvs.', [Prioridad], [parámetros_ccetati]); Funcionar your_function_name () {// El código va aquí} [/php] Como puede ver, un filtro o gancho de acción consta de cuatro partes principales. No es necesario incluirlos todos en cualquier momento, pero debe ser consciente de su existencia. Repasemos cada uno en detalle. Hook_Name El nombre de la ubicación en la que queremos ejecutar nuestra funcionalidad personalizada. Este será el nombre de la función que encontré do_action () en do_action () o aplica_filters (). En nuestro ejemplo anterior, esto fue WP_head. Nota: El nombre del gancho a veces se llama etiqueta. 2. El nombre_function_dvs aquí es el nombre de la función que conectaremos a nuestra etiqueta. Puede ser el suyo, una función PHP estándar o una existente en el núcleo de WordPress. Si decide escribir el suyo, aquí hay algunas cosas para recordar: primero, asegúrese de que su nombre esté formado por letras, figuras y personajes subrayados. No use guiones para separar las palabras, esto contraviene los estándares de codificación de WordPress.
A continuación, tenga en cuenta que PHP no permite más de una función del mismo nombre. Por lo tanto, es importante elegir un nombre único para evitar una colisión. Una práctica ordinaria para lograr esto es nick_Awesome los nombres con las iniciales u otro identificador inusual, por ejemplo, Nick_Awesome _Function. También debe asegurarse de que los nombres de sus funciones sean fáciles de entender y tener sentido. Aunque puede elegir cualquier nombre, es mucho más fácil para otros confiar en su trabajo si su código es autodocumento. 3. Prioridad El argumento de prioridad determina el orden en que se realiza el código si se conectan más funciones al mismo sustituto. La prioridad está determinada por un número entre 1 y 999, por defecto 10. Cuanto menor sea el número, más temprano se ejecutará la función. Aunque esto no es a menudo importante, en algunos casos es esencial establecer prioridad. Esta parte merece una atención especial para los ganchos de filtro, porque uno podría sobrescribirse entre sí. También es importante tener en cuenta que la prioridad tiene prioridad en orden de funciones en un archivo. Incluso si uno está al principio y al otro al final, si este último tiene una prioridad más alta, WordPress lo ejecutará primero.
4. Aceptar_Parameters Esta declaración ofrece el número de parámetros aprobados por cualquier función. La configuración predeterminada es una. Definir los parámetros aceptados es generalmente opcional. Sin embargo, a menudo es necesario para filtrar ganchos, especialmente si pasa más de un argumento. En este caso, el número de parámetros debe estar claramente definido. Después de haber terminado, todo lo que queda es escribir la función que desea realizar. Suena fácil, ¿verdad? Ok, suficiente con la teoría, veamos algunos ejemplos concretos. Ejemplos Para los siguientes casos de uso, use un sitio de desarrollo que se ejecute en veinte quince. Solo si te preguntas sobre los nombres de los ganchos. En primer lugar, quiero hacer algunos cambios en mi sótano. Cuando miro el archivo Footer.php del tema, repaso el siguiente código: [php] do_action ('veintefifteen_credit'); [/php] si usted Lo siguió, sabrá que esta es una señal de muerto para un gancho de acción. En este caso, quiero agregar algunos saludos personales al sótano de mi sitio. Puedo hacer esto, [php] add_action ('veintefifteen_credit', 'nick_footer_greeting'); La función nick_footer_greeting () {echo "¡Hola, gracias por venir a mi sitio!"; } [/php] Como debe entender hasta ahora, en la primera línea adjunto una función personalizada llamada nick_footer_greeting a veinte quince préstamos. Luego viene el código personalizado. Todo lo que hago aquí es decirle a WordPress que imprima un saludo especial además de veinte quince préstamos. El resultado se ve así:
No fue tan difícil ahora, ¿no?No se preocupe, tampoco los filtros.En mi próximo ejemplo, quiero cambiar el título de mis publicaciones pegajosas.Cada vez que pego una publicación en la primera página, quiero aparecer en las palabras "noticias de última hora" frente al título. Para este propósito, crearé una función personalizada como esta: [Php] Nick_Broting_News_Filter ($ Title) {if (( is_lipic () && in_buch ()) {return "Last -hur News:". $ Title;} else {return $ title;}} add_filter ('the_itle', 'nick_broting_news_filter'); [/php] el gancho que eres the_title.Incluye un parámetro llamado $ title, que puedo filtrar aquí.Mi función es prácticamente decirle a WordPress que tome este parámetro, para verificar si la publicación a la que se aplica es una publicación pegajosa y, sí, adjunta "noticias de última hora:" En frente.Aquí está el resultado:
Se ve bien, ¿no? Como puede ver, este tipo de cambios se pueden hacer con bastante facilidad. Una cosa más: puede haber notado que en un caso creé la función primero que el gancho, mientras que en el otro escribí primero el gancho, luego el código personalizado. Ambos funcionarán, depende de ti que te guste más. Cómo implementar bien WordPress Hooks, hasta ahora debe comprender cómo hacen los ganchos, cómo se ve y cómo escribirle. Los ganchos se pueden implementar de dos maneras: ya sea pegándolos en funciones.php (preferiblemente en un tema infantil) o creando un complemento personalizado. Si bien la elección está a su discreción, el último método tiene la ventaja que puede activar y deshabilitar las funciones directamente desde WordPress Backd. No es necesario llamar a su servidor si está intimidado por la posibilidad de crear su propio complemento, no lo sea. No es tan dificil. Si alguna vez ha configurado su propia hoja de estilo o código atascado en Functions.php, está listo. La única diferencia en la ruta de arado es que, en lugar de tener todas las funciones en un archivo, coloque cada una de ellas en su cuenta y agregue un encabezado del complemento, como: [Php] <
? Php/ * Nombre del complemento: mi complemento personalizado * /// La función personalizada y el gancho van aquí [/php] Ahora todo lo que tiene que hacer es colocar el archivo en WP-Content/Plugins (con o sin su propio director) y has terminado. Si incluso eso te abruma (no te preocupes, yo estuve allí), hay un complemento llamado PluginCting, que puede crear el encabezado para ti. Eliminar WordPress: los ganchos terrestres pueden ser momentos en los que desee eliminar completamente las acciones o filtros. Este puede ser el caso si hay un conflicto con una de sus propias funciones o si desea desconectar una acción o filtrar en un solo lugar y volver a conectarla en otro lugar. En ambos casos, esto se puede lograr mediante removi_action () y eliminar_filter (). Por ejemplo, para evitar que su sitio de WordPress ponga ping a otros blogs al publicar una nueva publicación, puede usar el siguiente código: [php] remove_action ('publish_post', 'genic_ping'); [/php] si desea realizar Una función desconectada en otro lugar, puede hacerlo a través del familiar add_action (). Solo una breve advertencia: si el gancho que desea eliminar tiene una declaración de prioridad, aparte del 10 predeterminado, debe especificar esto cuando lo desanime. Además, por supuesto, ¡no elimine nada a menos que sepa lo que hace!

Recursos Una de las partes más grandes del trabajo con WordPress Hooks es encontrar los sustituyentes correctos. Para hacer esto un poco más fácil, aquí hay tres recursos que lo ayudarán. 1. WordPress Codex: Acciones hace referencia a una lista (esperamos completar) con todas las acciones, todos los ganchos de acción presentes en el núcleo de WordPress. 2. WordPress Codex: Referencia de filtro La misma lista para los ganchos de filtro básicos de WordPress. 3. WordPress Hooks de Adam Brown encontrará cualquier gancho jamás utilizado, la versión en la que se ingresaron y si son válidos o no. La base de datos también tiene muchas opciones de filtro para mostrar solo nuevos ganchos, ganchos limpiados, ganchos tras versión y más. Resumir los ganchos de WordPress es una herramienta esencial y poderosa no solo para los desarrolladores de WordPress. Saber cómo usar ganchos permite que cualquier usuario de WordPress cambie la funcionalidad básica sin tocar ningún archivo. Las acciones y los filtros le permiten agregar y cambiar las funciones y obtener casi cualquier resultado imaginable. Junto con la capacidad de eliminar los ganchos cuando sea necesario, esto significa que puede reorganizar el aspecto de su sitio. La mejor parte: debido a que los archivos básicos permanecen intactos, todos los cambios son resistentes a la actualización. Solo puedo recomendarle que se familiarice con el uso de ganchos de WordPress. Trabajan con la plataforma mucho más dinámica. Además, una vez que vaya a los marcos temáticos y otros temas que ofrecen modificación a través de ganchos temáticos, no los evitará. ¿Ya estás familiarizado con WordPress Hooks?