¿Qué es el archivo functions.php en WordPress? ¿Cuál es su importancia? ¿Cómo lo editas?

En este artículo, conocerás en detalle el archivo functions.php en WordPress y aprenderás cómo modificarlo de forma segura para evitar problemas en tu sitio. También descubrirás los casos en los que es preferible modificar el código de este archivo y los casos en los que es mejor recurrir a soluciones alternativas (como complementos personalizados). Y por qué el uso de complementos personalizados en tu sitio WordPress es mejor que depender de la modificación del código del archivo functions.php. Si deseas agregar funciones y características adicionales a tu sitio WordPress, o planeas aprender a desarrollar y diseñar tus propias plantillas, este artículo está dirigido a ti.

¿Qué es el archivo Functions.php? El archivo functions.php se considera uno de los archivos más importantes en la estructura de archivos de las plantillas de WordPress, también conocido como (archivo de funciones de la plantilla), y generalmente se encuentra en la carpeta de cada plantilla instalada en tu sitio WordPress.

Este archivo funciona de manera similar a los complementos (Plugins), a través de él puedes agregar nuevas características y funciones a tu sitio, y también puedes cambiar las características predeterminadas en tu sitio WordPress. Este archivo se carga y se activa automáticamente cuando cargas y activas la plantilla actual en tu sitio.

Por lo tanto, puedes modificar el código de este archivo para invocar las funciones integradas en tu plantilla WordPress actual, o puedes definir tus propias funciones y características adicionales que desees agregar a tu sitio. Ejemplos de usos del archivo function.php Este archivo contiene código escrito en lenguaje php

Incluye la definición de las funciones que realiza la plantilla actual. Por lo tanto, puedes personalizar la plantilla utilizada en tu sitio modificando este código e agregando código personalizado para modificar las funciones existentes en esta plantilla, o agregar nuevas funciones. Por ejemplo, puedes agregar código para añadir un nuevo widget a la sección inferior del sitio, o mostrar un mensaje de bienvenida personalizado en el panel de administración del sitio, o mostrar un favicon que aparezca junto al título de tu sitio en el navegador, o mostrar una fecha de derechos de autor (Copyright) siempre actualizada que aparezca en la parte inferior del sitio.

Y muchas otras funciones y características infinitas. ¿Dónde encuentro el archivo functions.php?

El archivo functions.php se encuentra en cada carpeta de cada plantilla.

Es decir, en la siguiente ruta: /wp-content/themes/your_theme_name/functions.php siendo your_theme_name el nombre de la plantilla utilizada en tu sitio. Por ejemplo, la siguiente imagen muestra la ruta del archivo functions.php para la plantilla Twenty Eleven

(que es la plantilla predeterminada en WordPress) El archivo functions.php generalmente se encuentra en cada una de las plantillas en tu sitio, y si tu plantilla no tiene este archivo, puedes crear uno nuevo desde cualquier editor de texto y agregarlo a la plantilla. También existe un archivo function.php en la carpeta wp-include

Pero no uses este archivo a menos que seas un programador experto. Es importante notar que solo el archivo ubicado en la carpeta de la plantilla activa y habilitada actualmente en tu sitio se ejecutará o se aplicará. Es decir, es el que determinará cómo se muestra tu sitio o su apariencia general.

Para acceder a este archivo, inicia sesión en el panel de administración de tu sitio y luego elige: Apariencia < Editor de plantillas. Como se muestra en la siguiente imagen.

Aparecerá un mensaje de advertencia que te notifica que estás editando archivos de la plantilla principal y si actualizas la plantilla, estos cambios se perderán. Para continuar, haz clic en el botón "He entendido" para proceder. Después de hacer clic en este botón, se abrirá el editor de plantillas para la plantilla activa actual en tu sitio como se muestra en la siguiente imagen que muestra el nombre de la plantilla activa (OceanWP), y aparecerán los archivos de esta plantilla en el lado izquierdo.

Selecciona el archivo "propiedades de la plantilla" "functions.php" para ver su contenido. Aquí puedes agregar tu código y modificar la plantilla como desees. El propósito principal de este archivo en general es controlar cómo se muestran las cosas dentro del sitio.

Contiene bloques de código que se utilizan para varios propósitos: Definición de funciones llamadas ganchos de WordPress (WordPress Hooks), que son funciones que contienen un amplio conjunto de filtros y eventos de WordPress cuyo propósito es modificar las características predeterminadas, modifican prácticamente todo lo que hace WordPress (por ejemplo, puedes modificar el filtro excerpt-length

que determina la longitud del extracto de cada publicación mostrado al usuario, que por defecto consta de 55 palabras, y el usuario debe hacer clic en el enlace "Leer más" para leer la publicación completa) Activar características adicionales de la plantilla como activar miniaturas, menús de navegación y muchas otras características a través de la función "add_theme_support"

Definir nuevas funciones que desees utilizar en la plantilla actual o en varios archivos de plantillas. Por lo tanto, si deseas agregar un fragmento de código a tu sitio WordPress, agregarlo al archivo de funciones de la plantilla function.php

es una de las opciones posibles. Pero es recomendable que hagas una copia de seguridad del contenido del archivo antes de realizar cualquier modificación por si acaso, porque si algo sale mal podrás restaurar el original.

E intenta siempre agregar tus nuevas instrucciones de código al final del archivo. Nota: A veces es suficiente colocar algunas instrucciones de código en el archivo function.php

solo para que el resultado aparezca directamente en tu sitio. Y a veces debes colocar algunas instrucciones de código adicionales (en lenguaje php o css) en otro lugar del sitio para invocar los resultados del código que agregaste al archivo y hacerlos aparecer en el sitio. Esto depende del código escrito.

¿Cuáles son los aspectos negativos de modificar el código del archivo functions.php? Aunque el sistema WordPress te permite agregar fragmentos de código al archivo function.php de tu plantilla para activar funciones y características adicionales en tu sitio WordPress, y aunque muchos tutoriales en línea te ofrecen soluciones para modificar el archivo function.php para agregar características y funciones adicionales únicas al sitio.

Sin embargo, este método en realidad no siempre es una buena idea, y puede causar algunos problemas si no tienes cuidado y precisión al tratar con él, porque el sistema WordPress para gestión de contenidos está diseñado para separar (el diseño del sitio) de (las funciones del sitio) tanto como sea posible, y en este caso estás agregando funciones al sitio dentro de los archivos de la plantilla. A continuación hay algunos inconvenientes de agregar características a tu sitio editando el archivo function.php

Perderás todos los cambios que hayas realizado en el archivo function.php si actualizas la plantilla de WordPress utilizada en tu sitio. También perderás todos los cambios realizados si cambias la plantilla actual por otra, porque este archivo es específico de cada plantilla.

Cualquier error cometido al escribir el código en el archivo causará que no puedas acceder a tu sitio. Cualquier error, sin importar cuán simple sea, como un error al escribir el nombre de una variable o olvidar un punto y coma, puede hacer que tu sitio desaparezca completamente y muestre la pantalla de error conocida como

la pantalla blanca de la muerte "white screen of death"

u otros errores en el sistema WordPress. Por esta razón, es necesario que tengas la capacidad suficiente para entender el código y rastrear el error que ocurrió para poder corregirlo si llega a ocurrir, para que no pierdas la capacidad de acceder a tu sitio.

Si

deseas agregar funciones y características nuevas a tu sitio y deseas que estén disponibles independientemente de la plantilla utilizada en tu sitio, se recomienda depender de las otras soluciones alternativas que presentaremos más adelante en este artículo.

¿Cuándo debo recurrir a la modificación del código del archivo Function.php? Se recomienda que edites el archivo function.php y agregues código a él en caso de que tengas

una plantilla secundaria (child theme) construida en base a una plantilla principal (tema padre) en tu sitio.

Y deseas utilizar fragmentos de código solo con esta plantilla secundaria activa para modificarla y no con la plantilla padre. Para que puedas actualizar la plantilla original sin afectar su plantilla secundaria.

En ese caso, puedes usar el archivo function.php de la plantilla secundaria para aumentar o reemplazar las funciones de la plantilla original. Agregar código al archivo de funciones secundario se considera una forma segura y sin riesgos de modificar la plantilla principal. De esta manera, cuando se actualiza la plantilla principal, no necesitas preocuparte de que desaparezca el código recientemente agregado.

Por ejemplo, es posible que desees incluir fragmentos de fuentes personalizadas o código CSS o agregar un archivo de idioma para traducir la plantilla secundaria específica. ¿Cuáles son las soluciones alternativas para modificar el archivo function.php? Hay soluciones alternativas que puedes seguir si no deseas

modificar el archivo function.php. Donde en la mayoría de los casos, puedes obtener el mismo resultado utilizando complementos (Plugins), porque los complementos en WordPress generalmente se almacenan

en subcarpetas en la siguiente ruta: wp-content/plugins mientras que el archivo functions.php, como mencionamos anteriormente,

se almacena en una subcarpeta de la plantilla dentro de la siguiente ruta

wp-content/theme y se ejecuta solo cuando está presente en la carpeta de la plantilla actualmente activa en tu sitio. Por lo tanto, los complementos te permiten modificar las funciones del sitio sin afectar su diseño, independientemente de la plantilla utilizada. Por lo tanto, puedes buscar un complemento que te proporcione la función que deseas agregar a tu sitio.

Y en la mayoría de los casos, encontrarás un complemento listo para usar que cumple con tus requisitos y realiza lo que necesitas, la plataforma oficial de WordPress te proporciona un directorio de complementos que contiene más de 5000 complementos que puedes instalar en tu sitio WordPress para agregar características y funciones adicionales a tu sitio.

También puedes encontrar miles de otros complementos publicados por desarrolladores y programadores en plataformas como Github

Por lo tanto, puedes depender de complementos listos para usar en caso de que encuentres un complemento apropiado que satisfaga tus necesidades. Y si no encuentras un complemento que cumpla con tus requisitos, puedes aprender a crear tu propio complemento de WordPress que sea específico para tu sitio. Este tipo de complementos generalmente se denomina complemento de WordPress personalizado (Custom WordPress Plugin) porque será un complemento específico para tu sitio, y no se compartirá en el directorio de complementos de WordPress.

Y el uso de un complemento personalizado es una solución mejor, porque el código de la función requerida se almacenará por separado del archivo de funciones function.php de la plantilla. Puedes activar o desactivar el complemento siempre que desees, con la garantía de que tus instrucciones de código no desaparecerán si actualizas la plantilla o la cambias por otra. Finalmente, el archivo function.php

es uno de los archivos más importantes que los desarrolladores de WordPress necesitan dominar para desarrollar plantillas y agregar características y funciones adicionales al sitio. En este artículo te hemos presentado una visión integral sobre todo lo relacionado con este archivo, y hemos mencionado los inconvenientes de depender de la modificación de su código y cuándo puedes recurrir a él, y también mencionamos las soluciones alternativas para modificarlo, donde puedes agregar nuevas funciones a tu sitio WordPress usando el archivo function.php o usando complementos.