¿Qué es el archivo functions.php en WordPress? ¿Y 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). Además, entenderás por qué utilizar complementos personalizados en WordPress es mejor que depender de modificar el 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 WordPress, y se conoce como (archivo de funciones de la plantilla) ya que generalmente está incluido 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, además puedes cambiar las características predeterminadas en tu sitio WordPress. Este archivo se carga y 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 llamar a las funciones incluidas en la plantilla WordPress actual, o 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 editando este código e agregando código personalizado para modificar las funciones existentes en esta plantilla, o agregarle nuevas funciones. Por ejemplo, puedes agregar código para añadir un nuevo widget a pie de página, o mostrar un mensaje de bienvenida personalizado en el panel de control del administrador del sitio, o mostrar un favicon que aparezca junto al título de tu sitio en el navegador, o mostrar una fecha siempre actualizada para la declaración de derechos de autor (Copyright) que aparece al pie del sitio.

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

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

Es decir, en la siguiente ruta: /wp-content/themes/your_theme_name/functions.php ten en cuenta que your_theme_name es 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 plantilla presente en tu sitio, y si tu plantilla no tiene este archivo, puedes crear uno nuevo con 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 tener en cuenta que el archivo ubicado en la carpeta de la plantilla activa y habilitada actualmente en el sitio es el único que se ejecutará o aplicará. Es decir, es el que determinará cómo se ve tu sitio o su apariencia general.

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

Aparecerá un mensaje de advertencia que te informa que estás editando archivos de la plantilla principal y si actualizas la plantilla, se perderán estos cambios. Para continuar, haz clic en el botón "Entendido" para proceder. Después de hacer clic en este botón, se abrirá el editor de plantillas de la plantilla actual activa en tu sitio como se muestra en la siguiente imagen donde aparece el nombre de la plantilla activa (OceanWP), y los archivos de esta plantilla aparecerán 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 objetivo principal de este archivo es controlar cómo se muestran las cosas dentro del sitio.

Contiene bloques de código que se utilizan para varios propósitos: Definir funciones conocidas como ganchos de WordPress (WordPress Hooks) que son funciones que incluyen 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 imágenes en miniatura, menús de navegación y muchas otras cosas a través de la función "add_theme_support".

Definir nuevas funciones que desees usar en la plantilla actual o en varios otros 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. Sin embargo, es recomendable que hagas una copia de seguridad del contenido del archivo antes de hacer cualquier cambio por si acaso, porque si algo sale mal, puedes restaurar el original.

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

para que el resultado aparezca directamente en tu sitio. A veces debes poner algunas instrucciones de código adicionales (en lenguaje php o css) en otro lugar del sitio para llamar los resultados de las instrucciones de código que agregaste al archivo y mostrarlas en tu 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 la práctica no siempre es una buena idea y puede causarte algunos problemas si no tienes cuidado y precisión al usarlo, porque el sistema WordPress 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, se presentan algunas desventajas 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 WordPress utilizada en tu sitio. También perderás todos los cambios que hayas realizado si cambias la plantilla actual por otra, porque este archivo es específico de cada plantilla.

Cualquier error en la escritura del código en el archivo impedirá que accedas a tu sitio. Cualquier error, sin importar cuán pequeño 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

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

u otros errores en el sistema WordPress. Por esta razón, es esencial que tengas la capacidad suficiente para entender el código y rastrear el error que ocurrió para poder solucionarlo y no perder acceso a tu sitio.

En caso de

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

¿Cuándo debo recurrir a modificar el código del archivo Function.php? Es preferible que edites el archivo function.php y agregues código cuando tengas

una plantilla secundaria (child theme) construida sobre la base de una plantilla principal (plantilla padre) en tu sitio.

Y desees usar 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 la 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 de modificar la plantilla principal sin riesgos. De esta manera, cuando se actualiza la plantilla principal, no hay que preocuparse por la desaparición del código agregado recientemente.

Por ejemplo, puedes querer 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. Puedes obtener el mismo resultado en la mayoría de los casos usando complementos (Plugins), porque los complementos en WordPress se almacenan generalmente

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

en una subcarpeta de la plantilla dentro de la siguiente ruta

wp-content/themes y solo se ejecuta cuando está presente en la carpeta de la plantilla activa actualmente 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 proporcione la función que deseas agregar a tu sitio.

Y en la mayoría de los casos encontrarás un complemento listo 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.

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 en caso de que encuentres uno adecuado que cumpla con tus necesidades. Y si no encuentras un complemento que cumpla con tus requisitos, puedes aprender a crear tu propio complemento WordPress que sea específico para tu sitio. Este tipo de complementos se conoce generalmente como complemento 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 usar un complemento personalizado es una mejor solución, 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 cuando lo desees, garantizando que tus instrucciones de código no desaparezcan 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 presentamos una visión integral de todo lo relacionado con este archivo, mencionamos las desventajas de depender de modificar su código y cuándo puedes recurrir a él, 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.