Guía suprema para funciones de WordPress.php archivo

Si ha comenzado a construir su propio tema o incluso puede crear un niño para personalizar otro tema, entonces aprenderá todo sobre los archivos de plantilla y la jerarquía de plantillas del tema. Pero, ¿qué pasa con el archivo de funciones del tema.php? El archivo de funciones es el lugar donde coloca todas las características de su tema, que no se refiere a una plantilla, por lo que no es el código que toma un solo tipo de contenido o contenido en un lugar en la página, como ser el barra lateral. o sótano. WordPress Codex define el archivo con funciones de la siguiente manera: el archivo de características se comporta como un complemento de WordPress, agregando características y funcionalidad a un sitio de WordPress. Puede usarlo para usar funciones, tanto PHP como WordPress Built -in, y para definir sus propias funciones. Puede producir los mismos resultados agregando código a un complemento de WordPress o por el archivo con el tema de WordPress.
Es importante tener en cuenta la semejanza entre el archivo de función y un archivo de complemento. Use el archivo de funciones para el mismo tipo de código que agregaría a un complemento; De hecho, si lo desea, podría tener un archivo de funciones enorme y ningún complemento en su sitio. Pero eso no sería una muy buena idea. Si tiene mucho código funcional que debe usar en su sitio o desea que ese código continúe funcionando si cambia los temas, entonces debe ponerlo en un complemento. Pero si ese código depende del tema, entonces Functions.php es el lugar correcto para decirlo. La regla general es:
Use funciones.php cuando necesite agregar características simples relacionadas con la forma en que se muestra su contenido (es decir, no funcionará sin su tema activado). Esto podría incluir la adición de fuentes adicionales, por ejemplo. Escriba un complemento cuando la funcionalidad es más compleja o cuando la funcionalidad adicional no depende del tema. Un ejemplo es la grabación de tipos de publicaciones: no desea perder sus publicaciones si cambia los temas en el futuro. En esta publicación, le presentaré algunas de las funciones de funciones.php y le mostraré cómo agregarle código y cómo activar ese código. También le mostraré cómo usar funciones.php en un tema infantil para reemplazar o agregar funcionalidad a un tema principal. Usos comunes para el archivo de características teniendo en cuenta que el archivo de función es para el código depende del tema (es decir, es, es decir, Se perderá si cambia de temas), hay algunos ejemplos específicos cuando se le agrega el código es particularmente útil. Éstos incluyen:
Agregar soporte para temas, por ejemplo, para imágenes presentadas, formatos de publicación y enlaces RSS
Diga WordPress donde está la base del tema
Registro de ubicaciones para menús de navegación para que los usuarios puedan agregar menús menús
Agregar, eliminar o sobrescribir las funcionalidades de un tema principal, utilizando un tema secundario.
En esta publicación, te mostraré cómo hacer estas cosas.
Agregar el código al archivo con funciones y activarlo Agregue el código al archivo con funciones y le indique a WordPress que lo active exactamente como con un complemento. Los métodos incluyen: escribir una función que luego llame a los archivos de plantilla de plantilla; esto es útil cuando tiene un bloque de código que desea usar en varios lugares, pero no funcionará en una parte de la plantilla.
Conectando la función a un gancho o filtro de acción. Esto ejecuta la función cuando WordPress cumple con ese gancho. El propio WordPress ofrece cientos de ganchos y también puede encontrar algunos en el tema y los complementos que puede usar. Recuerde, si escribe algo en Functions.php, desea activar a través de un gancho en un tema que compró o descargó a WordPress Plugin Director, entonces deberá crear un tema infantil para hacerlo. Si no lo hace, el archivo de funciones se sobrescribirá la próxima vez que actualice el tema.
Creación de un código corto que luego agregue al contenido. No recomendaría agregar un código corto a través del archivo con funciones: es mejor hacerlo usando un complemento para que el contenido resultante de ese código corto no pierda si cambia los temas en el futuro. También significa que puede usar ese complemento. En otros sitios, brindándole acceso al código corto una y otra vez.
Creando un widget. Es una mala práctica hacer esto en el archivo de funciones; Si desea construir un widget, cree un complemento para él.
Puede descubrir cómo hacer cada uno de ellos en nuestra guía para crear un complemento.
Entonces, veamos cómo trabaja con funciones.php y cómo agrega algunas de las características más comunes. Creación de un archivo con características Si su tema aún no tiene un archivo con las características, deberá crear uno. Cree un nuevo archivo en el directorio principal del tema y llame a Functions.php. Deberá agregar una etiqueta de apertura de PHP al archivo, pero no necesita una de cierre: Cargue el esencial 1C9DB3673E9A82CDFB72
El archivo de funciones ahora está listo para agregar el código. Tiendo a agregar grandes bloques de texto comentado antes de cada sección para poder encontrar mi código nuevamente. Algo como eso:
Cargue el esencial 1C9DB3673E9A82CDFB72
De esta manera, cuando escaneo mi archivo, puedo encontrar fácilmente cada bloque de código. Agregar el código generalmente utilizado en funciones.php para echar un vistazo a algunos de los usos más comunes con funciones y cómo codificarlas. Agregar el soporte del tema Hay ciertas funciones en WordPress para las cuales debe agregar soporte para su tema para poder aprovecharlas. Estos son:
Formatos de publicación: formatos similares de tumblr, como estándar, video, citado y aparte
Post Miniatures, también conocidas como imágenes presentadas. Si desea mostrarlos en su tema, deberá agregar el código para eliminarlos a los archivos de plantilla, pero no estarán disponibles en las pantallas de administración a menos que agregue soporte para los temas.
Un fondo personalizado: le permite (u otras personas que usan su tema) personalizar la imagen de fondo y los colores a través del personalizador
Un encabezado personalizado, que funciona de manera similar a los antecedentes personalizados
Enlaces de flujo automático para flujos RSSHTML5 para formularios de búsqueda, comentarios, galería, etc. Esto no afecta su capacidad de codificar su tema usando HTML5, pero se refiere al código de WordPress
Etiqueta de título: esto le permite agregar una etiqueta de título en a sus páginas para fines de SEO y accesibilidad. No necesitará esto si tiene un complemento SEO que lo haga por usted por usted
Entonces, para agregar soporte para temas para formatos de publicación, por ejemplo, use add_theme_support () en su archivo de características:
Cargue el esencial 1C9DB3673E9A82CDFB72
Algunas de las funciones para las que agrega soporte para temas tienen parámetros adicionales; Por ejemplo, puede especificar los formatos de publicación que desea usar al agregar para ellos:
Cargue el esencial 1C9DB3673E9A82CDFB72
Y para las imágenes presentadas, puede especificar qué tipos de publicaciones desea agregar soporte para ellas:
Cargue el esencial 1C9DB3673E9A82CDFB72
Pero nada de esto funcionará a menos que coloque el código en una función que luego se adjunte al gancho correcto, que es el gancho de acción después_setup_theme. Puede agregar todas las funciones add_theme_support () a una función más grande a la que luego se conecta después_setup_theme. Entonces, si desea agregar soporte para temas para enlaces de alimentación post-post, post-formados, HTML5 y automáticos, agregue esto al archivo de funciones:
Cargue el esencial 1C9DB3673E9A82CDFB72
Tenga en cuenta que agregué texto comentado en la parte superior de cada elemento para el cual agregé soporte para temas, por lo que si yo o alguien más regresar al archivo más adelante, será fácil ver lo que está sucediendo. Agregar un archivo de traducción Si es posible que las personas que no hablan su idioma trabajen en su sitio o usen su tema, es una buena práctica preparar su tema para la traducción. Esto no afecta el front-end de su sitio que ven los visitantes, pero las pantallas de administración que sus usuarios verán. La traducción significa que cualquier texto que agregue a las pantallas de administración a través de su base. WordPress donde el archivo de traducción del tema está utilizando la función load_theme_textdomain () desde el archivo de características, de la siguiente manera:
Cargue el esencial 1C9DB3673E9A82CDFB72
Utiliza la función get_template_directory () para encontrar el director del tema y luego busca un archivo que comience con el tema WPMU-theme en el subdirector del idioma, de modo que el contenido WP/temas/mito/lenguajes/y el nombre del archivo del idioma. El archivo comenzará con WPMU-Theme seguido de un código de idioma. Si tiene que prepararse para la traducción del tema, deberá hacer más que cargar este campo de texto: nuestra guía completa para la traducción de complementos también se aplica a los temas y le dice todo lo que necesita.
Registro de menús de navegación Algo más que haga en el archivo del archivo es registrar ubicaciones para navegar por menús. Si está acostumbrado a trabajar con temas de tercer top, se verá que muchos de ellos tienen un cuadro de navegación primario que puede seleccionar en la pantalla de administración de menús, lo que le permite agregar el menú creado en esa ubicación. Si desea que los usuarios puedan hacer esto en su tema, deberá usar la función Registro de Menus () Registro (): se carga la 1C9DB3673E9A82CDFB72 esencial.
Registra una ubicación de menú, que se mostrará en la pantalla de administración como la navegación principal y cuya identificación es principal. Luego use esa ID para eliminar el menú en el archivo Header.php del tema. Tenga en cuenta que hice el nombre de mi menú listo para traducir en el código anterior, por lo que cualquiera que use mi tema y trabaje en un idioma que no sea inglés tendrá ese texto de “navegación principal” traducido para ellos usando mi archivo de traducción. También puede usar esta función para grabar más ubicaciones en el menú de navegación. El siguiente código registra un menú principal, más uno adicional en la barra lateral:

Cargue el esencial 1C9DB3673E9A82CDFB72
Nuevamente, deberá codificar el menú en el archivo SideBar.php del tema, utilizando la función wp_nav_menu (). Tomar todo junto con los ojos de águila entre ustedes se notará que todas las funciones que hemos proporcionado anteriormente se activan por el mismo gancho de acción: después de_setup_theme. Esto significa que en lugar de escribir una serie de funciones separadas, puede agregarlas todas a una sola función en Functions.php y luego puede activarlas usando el gancho de acción. Le gustaría tener solo una función alta: el esencial 1C9DB3673E9A82CDFB72 está cargado
He agregado muchos comentarios a mi posición para saber qué sucede donde. Esto lo hará más fácil si tengo que editar o reemplazar la función en el futuro. Incluyendo archivos a veces, descubrirá que el archivo de características se vuelve más grande de lo que puede administrar cómodamente y tiene bloques de código que desea mantener por separado. Si esto sucede, es una buena idea crear archivos separados, los archivos llamados incluyen, para ese código y luego llamarlos desde el archivo de funciones. Cree una carpeta en su tema llamado incluye y luego cree un nuevo archivo PHP para cada bloque de código que desea separar. Entonces, si quiero mover el tema configurado a otro archivo, por ejemplo, muevo todo el código anterior a un archivo llamado thema_setup.php y luego lo llamo en mi archivo de características:
Cargue el esencial 1C9DB3673E9A82CDFB72
Esto llama al código en el archivo incluye y lo ejecuta en su lugar en el archivo de características donde agregué que la función incluye (). Tiendo a poner todas mis inclinaciones al comienzo del archivo con funciones, para que sea fácil de encontrar para mí, nuevamente con comentarios para decirme lo que hago. Trabajar con temas para padres e hijos, el archivo con funciones puede ser muy fuerte cuando se trabaja con la tarea y los niños. En un tema infantil, puede usar el archivo con funciones para reemplazar o eliminar las funciones del tema principal o agregar otras nuevas. Hay tres formas de cambiar o agregar funciones en un tema infantil: crear una nueva versión de una función conectada.
Deshabilite una función del tema principal.
Agregue su propia función, utilizando la prioridad para reemplazar la función del tema principal.
Echemos un vistazo rápido a cada uno de ellos uno por uno. Funciones conectables Si trabaja con un tema principal bien codificado o un marco de tema que está diseñado para usarse como tema principal, entonces es probable que las funciones en su archivo de función se conecten. Puede identificar fácilmente un tema conectado, ya que se envolverá en una etiqueta condicional para verificar si esa función ya existe, de la siguiente manera:
Cargue el esencial 1C9DB3673E9A82CDFB72
Debido a que las funciones en el tema del niño se ejecutan ante las que están en el padre, esto significa que si crea una función del mismo nombre en el niño, WordPress no ejecutará el de los padres. Entonces, para reemplazar el tema principal, solo debe crear su propia función con el mismo nombre en la función del niño. Desactivar las funciones para desactivar una función, cortarla de la acción o del gancho del filtro al que está conectado. Entonces, si el tema de sus padres tiene una función llamada Parent_Function () que se activa a través del gancho Init, desactívelo en el tema de su hijo: Cargue el esencial 1C9DB3673E9A82CDFB72
Esto significará que la función principal ya no se ejecutará. Luego puede escribir una nueva característica si desea una funcionalidad diferente en el tema de su hijo: adjuntarla al mismo gancho, pero no le dé el mismo nombre. Nota: Si la función principal tiene un parámetro de prioridad en la función add_action () que ejecuta la función que desea apagar, debe incluir la misma prioridad cuando se apaga. Llegaré a prioridades en la siguiente sección. Usando la prioridad de la función, la opción final es crear una nueva función con una prioridad más alta que la función que desea reemplazar, lo que significa que se ejecutará después de esa función. Debe hacer esto porque, por defecto, WordPress ejecutará primero las funciones sobre el tema de su hijo; Solo agregando un número de prioridad puede cambiar esto. Entonces, supongamos que su tema principal tiene una función llamada Parent_Function (), que se activa a través del gancho de prioridad 20:
Cargue el esencial 1C9DB3673E9A82CDFB72
Puede escribir una función que la reemplace y luego adjuntarla al gancho de inicio con una prioridad más alta, como 30: el esencial 1C9DB3673E9A82CDFB72 está cargado
Tenga en cuenta que si la función principal no ha tenido una prioridad asignada, usará el valor predeterminado, que es 10. por lo que puede usar más de 10 para la función de su hijo para asegurarse de que se esté ejecutando después de la función principal. El archivo de funciones es su amigo El archivo con las funciones de la base funciona de manera muy similar a un complemento, pero es específico para su tema, por lo que debe usarlo solo para agregar características que no desea perder si cambia los temas Más tarde o no desea usar en otro sitio. En esta publicación, aprendió qué se usa el archivo de características para lo que se usa y cómo implementar algunos de estos usos. ¡Trate el archivo con características cuidadosas, evite usarlo en lugar de un complemento y lo ayudará a desarrollar el tema! ¿Cómo se usa el archivo con funciones? ¿Lo evita por completo y en su lugar codifica complementos? Háganos saber en los comentarios a continuación. Etiquetas:
funciones