Cómo escribir y activar una función en WordPress

Si comienza a desarrollar sus propios complementos de WordPress o si crea sus propios temas, una habilidad que tendrá que aprender es escribir funciones. Tal vez escribiste una función que no funcionó y renunció a la frustración. O tal vez está confundido por los ganchos de acción y filtración y no está seguro de cómo trabajar. En esta publicación, te ayudaré a superar cualquier problema inicial con las funciones de escritura. Le mostraré cómo estructurar su función, le daré las mejores prácticas y aclararé los métodos que puede usar para activar su función.
Entonces, ¡comencemos! Por qué deberá seguir este tutorial, es útil si tiene una función en la que ya está trabajando. De esta manera, puede poner en práctica lo que aprende y obtendrá más. En este caso, necesitará algunas herramientas:
Un editor de código
Una instalación de instalación de desarrollo de WordPress
El archivo para su función, que podría estar en el archivo functions.php o podría estar en un complemento.
Si no tiene esto porque aún no ha iniciado la función, no se preocupe, lea más y aprenderá cómo comenzar. ¿Dónde debes poner tu función? Antes de comenzar, debe pensar dónde colocará el código para su función. Tiene dos opciones: el archivo con los temas o un complemento.
Usted usará dependerá del propósito de su función:
Si tiene que ver con el diseño y la visualización de su contenido, colóquelo en su tema. Tiene una conexión directa con el tema y solo funcionará con el resto del código del tema.
Si es funcional (y la mayoría de las funciones lo son, la pista está en nombre), entonces póngala en un complemento.
Muchos de nosotros comenzamos en nuestro archivo de funciones, porque es más fácil, entonces vamos a la creación de complementos cuando hemos ganado confianza. Crear un complemento es en realidad muy simple: consulte nuestra guía para crear complementos. Si está seguro de que su complemento debe estar en el archivo con las características de la función y su tema aún no tiene uno, consulte nuestra guía final para el archivo de función. O el archivo del complemento) y está listo para escribir esa función. Para dividirlo en partes. Agregar comentarios sabe lo que piensa: comentarios, ¿no podemos poner y escribir algo ya? Pero siempre agrego comentarios antes de codificar mi complemento. De esta manera, puedo ver cuál es mi función cuando vuelvo a ella. A veces no tengo que volver a un código durante años y, créanme, ¡habré olvidado cómo funcionó ese código cuando lo hago! Y si alguien más tiene que trabajar en su posición, los comentarios lo ayudarán a comprender lo que está haciendo.
Mi función será simple para grabar algunas fuentes de Google en mi tema. Va al archivo con las funciones de la función, porque está relacionado con la pantalla y no con la apariencia. Pero primero agregaré algunos comentarios:
Se carga la idea 1CDC2382B6D4FB70C9A847AB51774A2C.
Formato mis comentarios para que sea claro y fácil de encontrar cuando viajo rápidamente el archivo en una fecha posterior. Abrir la función ahora es el momento de escribir la función. Ábrelo con la función de la palabra y el nombre de la función. Siempre debe usar un prefijo en el nombre de su función para asegurarse de que su nombre sea único. De esta manera, no entrará en conflicto con ninguna función en su tema o ningún tercer complemento. Use su nombre, iniciales o nombres o iniciales en el sitio o complemento para el cual escribe el código. Trabaja esto con aparatos ortopédicos, en el que el código para su tema es:
Se carga la idea 1CDC2382B6D4FB70C9A847AB51774A2C.
Popularidad de la función Todo el código que desea ejecutar la función ingresa a los aparatos ortopédicos. Esto incluye cualquier etiqueta condicionada, que explicaré más en detalle más adelante. Aquí está mi código para la función de fuentes de Google:
Se carga la idea 1CDC2382B6D4FB70C9A847AB51774A2C.
No le enseñaré cómo codificar una determinada característica aquí, porque eso dependerá de lo que esté tratando de obtener. Tenemos muchas otras publicaciones que lo ayudarán con una variedad de funciones, ¡sin mencionar nuestros cursos de la Academia sobre el desarrollo de WordPress!
Aquí está la función completa:
Se carga la idea 1CDC2382B6D4FB70C9A847AB51774A2C.
Pero una vez que haya hecho esto, puede abrir una página en su sitio y preguntarse por qué no pasa nada. Eso es porque aún no has activado tu función. Activar una función Una función es inútil si no la activa de alguna manera, diciendo WordPress cuándo activar la función. Tienes tres opciones para esto:
Code la función directamente en el archivo de plantilla de plantilla (u otro archivo de complemento).
Conéctelo a un gancho de acción. Conéctelo a un gancho de filtro.
Veamos cada uno de ellos. Codificación de la función en el archivo de plantilla de tema Esta opción solo está disponible si trabaja con su propio tema.
Si desea hacer esto con un tema de terceros, deberá crear un tema secundario, duplicar el archivo de plantilla de tema relevante del tema del niño y agregar su función a él. Si el archivo de plantilla se modifica mediante una actualización futura del tema principal, el archivo con el tema del niño (que usará WordPress) no reflejará esto. Asumiré que está trabajando con un tema que ha desarrollado solo y tiene un fragmento de código que desea repetir en varios archivos de plantilla. En lugar de crear un archivo, también incluye llamarlo en esos archivos, decidió usar el archivo de funciones y crear una función, que para un fragmento de código es más eficiente.
Imaginemos que su función de eco después de la fecha. Aquí está:
Se carga la idea 1CDC2382B6D4FB70C9A847AB51774A2C.
Ahora, para agregar este código al tema, lo agregaría al archivo de plantilla del tema, donde desea ejecutar el código:
Se carga la idea 1CDC2382B6D4FB70C9A847AB51774A2C.
¡Tan simple como eso! Simplemente agregue este código al archivo de plantilla relevante desde su tema. Gire su función a través de un gancho de acción es el uso de un gancho de acción. Este es el código que le permite ejecutar el código adjunto, cada vez que WordPress cumple con el gancho. Puede usar ganchos ya proporcionados por WordPress, o puede crear los suyos propios.
En el caso de la función de la fuente que escribí anteriormente, usaría un gancho ofrecido por WordPress: WP_ENQUEE_SCRIPTS.Entonces, para activar mi función, agregaría esto fuera de los aparatos ortopédicos: la idea 1CDC2382B6D4FB70C9A847AB51774A2C está cargada.

Entonces mi función completa se verá así:
La idea se carga 1CDC2382B6D4FB70C9A847AB51774A2C
Ahora veamos un ejemplo en el que podría escribir mi propio gancho.En lugar de hacer mi función () para eliminar la fecha directamente al archivo de plantilla (en este caso el bucle), uso do_action () para agregar un gancho de acción, luego conecto mi función a él.
Entonces, en mi archivo de plantilla, agrego esto:
La idea se carga 1CDC2382B6D4FB70C9A847AB51774A2C
Luego adjunto mi función a esto, para que todo se ve:
La idea se carga 1CDC2382B6D4FB70C9A847AB51774A2C
Activar la función a través de un gancho de filtro El otro tipo de gancho es un gancho de filtro. Ya se incluirá en torno a un código o contenido cuando se cree, y su función lo anulará. Es útil si desea codificar algo en un archivo de plantilla de tema, pero ofrece la opción de anularlo más tarde. WordPress también le ofrece una gama de ganchos de filtro para usar con diferentes funciones. Si no está seguro de la diferencia entre los dos tipos de ganchos, nuestra guía de acción y los ganchos de filtro aclararán sus cosas. Aquí hay un ejemplo: una pieza de texto en un archivo de plantilla. Nota: Sé que escribir el texto directamente en los archivos de plantilla no es la mejor práctica. También sé que hacer esto sin internalización también es una mala práctica. Pero es un ejemplo simple, así que por favor no me ganes en los comentarios. Para agregar un gancho de filtro al archivo de plantilla, use la función Apply_filters () con el nombre del filtro como el primer parámetro y el contenido predeterminado como el segundo: la idea 1CDC2382B6D4FB70C9A847AB51774A2C está cargada.
Y así es como conectaría una función adjunta:
Se carga la idea 1CDC2382B6D4FB70C9A847AB51774A2C.
Tenga en cuenta que la función add_filter () según la función es muy similar a la función add_action (). El primer parámetro es el nombre del gancho, y el segundo es el nombre de la función. Además, tenga en cuenta que la función Apply_Filters () a menudo está precedida por Echo, porque un texto de eco (en este caso, un título). Utilizando etiquetas acondicionadas al usar ganchos para activar funciones, puede combinar esto con etiquetas condicionales para definir las circunstancias en las que se activará una función. Lo que a menudo veo que las personas están equivocadas es el posicionamiento de etiquetas condicionadas. La lógica puede decirle que desea que la función se active solo en circunstancias específicas, así que coloque la etiqueta condicional, ¿verdad? Equivocado. Aquí hay dos formas en que vi cómo se hace, ambos están equivocados. Primero, envuelva la etiqueta alrededor del gancho de acción: Cargue la idea 1CDC2382B6D4FB70C9A847AB51774A2C
Y en segundo lugar, incorporándolo alrededor de la función, también está mal:
Se carga la idea 1CDC2382B6D4FB70C9A847AB51774A2C.
La única forma correcta es introducir la etiqueta condicional alrededor del código dentro de su función. Por lo tanto, la función se activará en todos los casos, pero si la condición no se cumple, no sucederá nada. Aquí está la forma correcta de usar una etiqueta condicional para verificar que hay una sola publicación:
Se carga la idea 1CDC2382B6D4FB70C9A847AB51774A2C.
El uso de una etiqueta condicionada a medida que hace las cosas más simples y más precisas y es un uso fuerte para las funciones.Saber cómo escribir y activar las funciones le permitirá a WordPress Desarrollo comprender cómo funcionan las funciones y la escritura es una capacidad esencial si tiene la intención de codificar sus propios temas y complementos de WordPress.Con esta guía, sabrá exactamente cómo escribir las funciones correctamente y cómo seleccionar qué método para activarlas. Cuáles son algunos de los usos más creativos de las funciones que ha probado o las situaciones en las que sus funciones no han funcionado como ¿era de esperarse?¡Déjalos aquí y deje cualquier pregunta sobre el artículo!
Etiquetas:
funciones
complementos
temas