Archivo functions.php de WordPress: La Guía Definitiva + Fragmentos de Código Útiles

¿No sabes qué es el archivo functions.php de WordPress o qué puedes hacer con él?

En pocas palabras, el archivo functions.php de WordPress te permite añadir fragmentos de código a tu sitio. Puedes utilizar estos fragmentos de código de todo tipo de formas útiles, por lo que entender cómo funciona el archivo functions.php puede ayudarte a construir un sitio WordPress mejor.

En nuestra guía definitiva sobre el archivo functions.php de WordPress, aprenderás todo lo que necesitas saber sobre este archivo.

Una vez que sepas todo sobre el archivo functions.php, también compartiremos 17 útiles fragmentos de código de functions.php para ayudarte a empezar a personalizar tu sitio.

¿Qué Hace el Archivo functions.php de WordPress?

El archivo functions.php de WordPress es un archivo del tema que puedes utilizar para añadir fragmentos de código personalizados a tu sitio. Puedes utilizar estos fragmentos de código para modificar el funcionamiento de distintas áreas de tu sitio o para añadir nuevo contenido/código a tu sitio.

A pesar de estar incluido en tu tema, el archivo functions.php de WordPress no se limita únicamente a realizar personalizaciones en tu tema.

Puedes hacer ajustes en cualquier parte de tu sitio, de forma similar a como funcionan los plugins.

Aquí hay algunos ajustes comunes que puedes hacer usando el archivo functions.php de WordPress:

• Cambiar el comportamiento básico de WordPress, como cuántas entradas mostrar en la página de resultados de búsqueda o qué contenido incluir en el feed RSS de tu sitio.
• Crear tus propios shortcodes personalizados.
• Añadir nuevos contenidos o scripts a tu sitio, como inyectar un script de tu servicio de chat en directo en determinadas páginas o editar el pie de página de tu sitio.

Esto sólo es rascar la superficie…

Dado que el archivo functions.php te permite añadir fragmentos de código PHP personalizados a tu sitio en lugar de HTML estático, no hay límite cuando se trata de las modificaciones que puedes hacer.

¿Dónde Se Encuentra el Archivo functions.php de WordPress?

El archivo functions.php de WordPress se encuentra en la carpeta de tu tema activo, junto con otros archivos del tema. Para encontrar el archivo, puedes conectarte a tu servidor mediante FTP o una herramienta de gestión de archivos y navegar hasta …/wp-content/themes/[active-theme-name]/functions.php

Por ejemplo, si utilizas el conocido tema OceanWP, el archivo functions.php se encuentra en …/wp-content/themes/oceanwp/functions.php

Cómo Trabajar de Forma Segura con el Archivo functions.php

Dado que trabajar con el archivo functions.php de WordPress implica añadir código a tu sitio web, es importante seguir algunas prácticas recomendadas antes de empezar a realizar cualquier edición.

Incluso algo tan simple como la falta de una coma o un apóstrofe puede provocar errores en tu sitio, como la Pantalla Blanca de la Muerte de WordPress.

En las últimas versiones de WordPress, se ha mejorado la gestión de estos errores de una manera más elegante, por ejemplo, mostrando el mensaje «Se ha producido un error crítico en tu sitio web» o comprobando si hay errores de PHP antes de guardar los cambios.

Pero aún así, para evitar cualquier problema, siempre recomendamos seguir estas buenas prácticas..

Prueba tu Código functions.php en un Sitio Staging

Antes de añadir cualquier fragmento de código functions.php a tu sitio WordPress activo, siempre recomendamos probarlo primero en una versión staging de tu sitio. Esto te permitirá comprobar si hay algún error potencial y verificar que el fragmento de código funciona según lo previsto.

Si te alojas con Kinsta, Kinsta ofrece una sencilla herramienta de staging de 1 clic en todos los planes, que es uno de los beneficios de usar alojamiento administrado de WordPress.

Si te alojas en otro sitio, puedes consultar nuestra guía sobre cómo configurar un sitio staging de WordPress.

Haz una Copia de Seguridad de tu Sitio Antes de Realizar Cambios en functions.php

Además de probar en un staging, también deberías hacer una copia de seguridad de tu sitio web en producción antes de añadir el fragmento de código al archivo functions.php de tu sitio en producción.

Esta es una buena práctica que debes seguir cuando edites cualquier archivo de WordPress.

Si algo va mal con el fragmento de código, puedes restaurar a este punto de copia de seguridad para que tu sitio vuelva a funcionar al instante.

Si te alojas con Kinsta, Kinsta realiza copias de seguridad automáticas de tu sitio todos los días y también puedes crear manualmente una copia de seguridad en cualquier momento. Si te alojas en otro sitio, puedes leer nuestra guía sobre cómo hacer una copia de seguridad de un sitio WordPress.

Utiliza Siempre un Tema Hijo si Editas el Archivo functions.php

Como el archivo functions.php de WordPress se encuentra en el código de tu tema de WordPress, tu tema sobrescribirá el archivo functions.php cuando actualices tu tema.

Para evitar que se sobrescriban los cambios que has realizado en el archivo functions.php de tu tema, debes utilizar siempre un tema hijo de WordPress y añadir tus fragmentos de código al archivo functions.php del tema hijo.

Al utilizar un tema hijo, puedes seguir actualizando el tema padre cuando sea necesario, pero todas tus personalizaciones de functions.php nunca se sobrescribirán.

Para obtener más información, consulta nuestra completa guía sobre cómo crear un tema hijo de WordPress.

2 Alternativas al Archivo functions.php que Podrían Ser Mejores

Aunque el archivo functions.php de WordPress ofrece una forma sencilla de añadir fragmentos de código a tu sitio, existen algunas alternativas a functions.php que ofrecen una solución mejor en la mayoría de las situaciones:

1. Utilizar un plugin de gestión de código
2. Almacenar fragmentos de código en un plugin personalizado

Estas alternativas pueden tener algunas ventajas sobre el uso del archivo functions.php:

• No están vinculadas a tu tema — esto significa que si alguna vez cambias de tema, tus personalizaciones de functions.php seguirán ahí.
• Mejor organización — estas alternativas facilitan la organización de tus fragmentos de código, lo que puede ser útil si piensas añadir muchos fragmentos de código a tu sitio.
• Más control — en el caso de un plugin gestor de código, tienes opciones útiles como activar/desactivar un fragmento de código mediante un botón de alternancia, ejecutar fragmentos de código sólo en el frontend o en el backend, y mucho más.

Utiliza un Plugin Gestor de Código

Un plugin gestor de código es un plugin que te proporciona una interfaz fácil de usar para añadir y editar fragmentos de código que, de otro modo, irían en el archivo functions.php.

Una de las opciones más populares es el plugin gratuito Code Snippets, pero puedes encontrar otros plugins que ofrecen una funcionalidad similar.

Con Code Snippets, puedes añadir tus fragmentos de código functions.php desde el panel de control de WordPress, con opciones para…

• Añadir un título y una descripción.
• Organizar tus fragmentos mediante etiquetas.
• Ejecutar el fragmento sólo en una parte determinada de tu sitio.

Así podrás ver todos tus fragmentos en una lista y activarlos/desactivarlos fácilmente según necesites.

Como Code Snippets es un plugin, todos tus fragmentos de código seguirán ahí aunque cambies de tema de WordPress.

Crear un Plugin de Funciones Personalizadas

Otra alternativa al archivo functions.php de WordPress es crear tu propio plugin personalizado para alojar los fragmentos de código.

Aunque pueda parecer complicado, en realidad es mucho más sencillo de lo que parece.

Así es como funciona:

1. Crea una carpeta en tu ordenador local para tu plugin.
2. Crea un único archivo .php dentro de esa carpeta y edítalo con tu editor de texto favorito.
3. Añade la siguiente plantilla de código al archivo.
4. Añade tus fragmentos de código functions.php al archivo

<?php

/**
* Plugin Name: My Custom Code Snippets
* Description: This is a custom plugin to house code snippets.
* Author: Kinsta
* Version: 1.0
*/

/* Add the first code snippet below this comment - use the comment to explain what it does. */
[CODE]

/* Add the second code snippet below this comment. */
[CODE]

/* Continue as needed. */
[CODE]

?>

A continuación, sólo tienes que instalar y activar el plugin en WordPress. Aquí tienes 2 formas de hacerlo:

1. Conéctate a tu servidor mediante FTP/SFTP y sube la carpeta del plugin personalizado a la carpeta wp-content/plugins. A continuación, ve a la lista de plugins y activa el plugin.
2. Utiliza tu ordenador para crear un archivo .zip de la carpeta. A continuación, ve a Plugins → Añadir Nuevo y sube el archivo .zip para instalarlo como cualquier otro plugin.

Cómo Acceder al Archivo functions.php de WordPress: 2 Opciones

Hay diferentes formas de acceder al archivo functions.php de WordPress y editarlo. Aquí tienes 2 de los métodos más versátiles que funcionarán en cualquier alojamiento:

1. Editor de código de temas en el panel de WordPress.
2. SFTP y tu propio editor de código.

1. Utilizar el Editor de Código del Tema en el Panel de WordPress

Por defecto, WordPress te permite editar todo el código de tu tema desde el panel de control de WordPress, incluido el archivo functions.php:

1. Abre tu panel de WordPress.
2. Ve a Apariencia → Editor de Archivos del Tema.
3. Selecciona el archivo Funciones del Tema (functions.php) en la lista Archivos del Tema, a la derecha.
4. Añade tus modificaciones en el editor de código.
5. Haz clic en el botón Actualizar Archivo para guardar los cambios.

Sin embargo, mucha gente prefiere desactivar la edición de archivos en el panel de control de WordPress para mejorar la seguridad. En ese caso, puedes utilizar el siguiente método.

2. Utilizar SFTP + Tu Propio Editor de Código

Otra forma de editar el archivo functions.php de WordPress es conectarte a tu servidor mediante FTP/SFTP y editar el archivo de esa forma.

Aquí tienes cómo:

1. Descarga un cliente FTP si aún no lo has hecho —  nosotros utilizaremos el cliente gratuito FileZilla para hacer las capturas de pantalla.
2. Conéctate a tu servidor utilizando tus credenciales FTP — aquí se explica cómo utilizar SFTP para conectarse.
3. Utiliza la estructura de carpetas para ir a …/wp-content/themes/[tu-tema-hijo-activo]
4. Haz clic con el botón derecho en el archivo functions.php y selecciona Editar.

Esto debería descargar el archivo a tu ordenador local y abrirlo automáticamente en un editor de texto. Ahora puedes añadir tus fragmentos de código al archivo.

Cuando hayas terminado, guarda los cambios y cierra el archivo.

FileZilla te pedirá que vuelvas a subir la versión editada a tu servidor.

Funciones Más Útiles para Añadir a Tu Archivo functions.php de WordPress

Ahora que ya sabes cómo editar el archivo functions.php de WordPress, vamos a repasar algunos de los fragmentos de código de functions.php más útiles que puedes añadir a tu sitio.

Mostrar la Fecha de Última Modificación en las Entradas del Blog

Por defecto, la mayoría de los temas muestran la fecha de publicación de una entrada de blog. Sin embargo, si actualizas y refrescas regularmente contenido antiguo, puede que quieras mostrar también la fecha de última modificación (o sustituir la fecha de publicación por la fecha de última modificación).

Esto no sólo permite que tus visitantes humanos sepan que sigues actualizando el contenido, sino que también muestra a Google que tu contenido es fresco.

function show_last_updated( $content ) {
$u_time = get_the_time('U');
$u_modified_time = get_the_modified_time('U');
if ($u_modified_time >= $u_time + 86400) {
$updated_date = get_the_modified_time('F jS, Y');
$updated_time = get_the_modified_time('h:i a');
$custom_content .= '<p class="last-updated-date">Recently updated on '. $updated_date . ' at '. $updated_time .'</p>';
}
$custom_content .= $content;
return $custom_content;
}
add_filter( 'the_content', 'show_last_updated' );

Para más detalles, consulta nuestro post completo mostrar la fecha de última modificación en WordPress.

Desactivar la Barra de Herramientas de WordPress para Determinados Usuarios

Por defecto, WordPress muestra la barra de herramientas de WordPress a todos los usuarios registrados que utilizan los roles de usuario de WordPress. Este no es necesariamente el caso de los roles personalizados, como el rol de usuario Cliente para las tiendas Tiendas WooCommerce.

Si quieres cambiar esto, puedes utilizar un fragmento de código functions.php para ocultar la barra de herramientas de WordPress a determinados roles de usuario.

Este ejemplo ocultaría la barra de herramientas de administración para los usuarios con el rol de autor.

add_filter( 'show_admin_bar', function( $show ) {
if ( current_user_can( 'author' ) ) {
return false;
}
return $show;
} );

Retrasar la Aparición de Entradas en el Feed RSS

Por defecto, el contenido aparece en tu feed RSS en cuanto lo publicas. Esto puede dar a los «scrapers» de contenido la oportunidad de extraer tu contenido e indexarlo en Google antes incluso de que Google indexe tu publicación original.

Para evitar que otra persona se lleve el mérito de tu contenido, puedes retrasar la aparición de las publicaciones en tu canal RSS.

Aunque esto no detendrá completamente a los «scrapers» de contenido, significa que puedes dar tiempo a Google para que indexe primero tu contenido.

Aquí tienes el fragmento de código — puedes cambiar el número — «30» en este ejemplo —  por el número de minutos que quieras que dure el retraso:

function kinsta_delay_feed_content($where) {

global $wpdb;

if ( is_feed() ) {
// timestamp in WP-format
$now = gmdate('Y-m-d H:i:s');

// value for wait; + device
$wait = '30'; // integer

// http://dev.mysql.com/doc/refman/5.0/en/date-and-time-functions.html#function_timestampdiff
$device = 'MINUTE'; //MINUTE, HOUR, DAY, WEEK, MONTH, YEAR

// add SQL-sytax to default $where
$where .= " AND TIMESTAMPDIFF($device, $wpdb->posts.post_date_gmt, '$now') > $wait ";
}
return $where;
}

add_filter('posts_where', 'kinsta_delay_feed_content');

Excluir Determinadas Categorías del Feed RSS

Además de retrasar la aparición de contenidos en el canal RSS, también puede darse el caso de que quieras excluir categorías enteras de entradas de blog para que no aparezcan en el canal RSS de tu sitio.

Para conseguirlo, puedes utilizar el siguiente fragmento de código functions.php:

function kinsta_exclude_category_rss($query) {
if ($query->is_feed) {
$query->set('cat','-38');
}
return $query;
}
add_filter('pre_get_posts','kinsta_exclude_category_rss');

Asegúrate de sustituir el ID de categoría de ejemplo — «38» — por los ID de categoría reales que quieras excluir (y no quites el signo menos)

A continuación te explicamos cómo encontrar el número de ID:

1. Ve a Entradas → Categorías para ver una lista de todas las categorías de tu sitio.
2. Haz clic en Editar bajo la categoría que quieras excluir.
3. Mira la URL de la página de edición en la barra de direcciones de tu navegador. El ID de la categoría es el número que aparece después de ?taxonomy=category&tag_ID=X.

Por ejemplo, si la URL es https://yoursite.com/wp-admin/term.php?taxonomy=category&tag_ID=38&post_type=post, entonces el ID de categoría es 38.

Limitar las Revisiones de WordPress por Tipo de Entrada

Para evitar sobrecargar la base de datos de tu sitio, es posible que quieras limitar el número de revisiones que se guardan.

Aunque una forma de limitar las revisiones de entradas de WordPress en todo el sitio es editar el archivo wp-config.php de tu sitio, es posible que quieras almacenar diferentes números de revisiones para diferentes tipos de entradas, por ejemplo, entradas de blog frente a productos de WooCommerce.

Este fragmento de código functions.php te permite hacerlo. Para personalizarlo, cambia el tipo de entrada — «post» en este ejemplo — por el tipo de entrada que quieras controlar y el número — «5» en este ejemplo — por el número de revisiones que quieras almacenar.

function kinsta_post_revisions_by_type( $revisions, $post ) {

if( 'post' == $post->post_type ) {
$revisions = 5;
}

return $revisions;

}

add_filter( 'wp_revisions_to_keep', 'kinsta_post_revisions_by_type', 10, 2 );

* Nota: estás editando el «post» que aparece inmediatamente después de la sentencia «if». Por ejemplo, para dirigirte a los productos, esa línea tendría el siguiente aspecto:

if( 'product' == $post->post_type ) {

Desactivar la Función de Búsqueda de WordPress

Si tu sitio no necesita la funcionalidad de búsqueda, quizá quieras desactivar la función de búsqueda de WordPress para evitar posibles abusos.

Por ejemplo, aunque no muestres un cuadro de búsqueda en tu sitio, los robots pueden seguir utilizando la función de búsqueda añadiendo ?s=[término de búsqueda] a tu URL.

Para ello, puedes añadir el siguiente fragmento de código:

function kinsta_disable_wp_search( $query, $error = true ) {

if ( is_search() ) {
$query->is_search = false;
$query->query_vars[s] = false;
$query->query[s] = false;

// to error
if ( $error == true )
$query->is_404 = true;
}
}

add_action( 'parse_query', 'kinsta_disable_wp_search' );
add_filter( 'get_search_form', create_function( '$a', "return null;" ) );

Si alguien intenta utilizar la función de búsqueda directamente, tu sitio devolverá una página 404.

Cree Tus Propios Shortcodes Personalizados ( Por ejemplo, Año Actual)

Los shortcodes de WordPress son atajos muy útiles que te permiten incrustar contenido dinámico en tu sitio.

Aunque muchos plugins de WordPress se basan en shortcodes para potenciar su funcionalidad, también puedes crear tus propios shortcodes personalizados utilizando el archivo functions.php de WordPress y la función add_shortcode().

Por ejemplo, un caso de uso común es crear un shortcode que muestre el año actual. Esto te permite mostrar automáticamente el año actual en todo tu contenido sin necesidad de actualizarlo todo manualmente cada 1 de enero.

Para crear un shortcode de este tipo, puedes utilizar el siguiente código:

function year_shortcode() {
$year = date('Y');
return $year;
}
add_shortcode('currentyear', 'year_shortcode');

Entonces, cuando añadas el shortcode [currentyear] a tu contenido, se sustituirá automáticamente por el año actual — por ejemplo, 2023.

Permitir Códigos Cortos en los Títulos de las Entradas

Por defecto, WordPress no ejecutará ningún shortcode que coloques en el campo del título de tu entrada. Si quieres utilizar shortcodes en los títulos de las entradas de WordPress, puedes activar esta funcionalidad añadiendo un simple fragmento de código al archivo functions.php de WordPress.

Por ejemplo, combinado con el fragmento de código anterior, te permitiría incluir automáticamente el año actual en el título de la entrada añadiendo el shortcode [currentyear].

add_filter( 'the_title', 'do_shortcode' );

Ocultar los Errores de Inicio de Sesión para Mejorar la Seguridad

Por defecto, WordPress mostrará un mensaje informativo en los intentos fallidos de inicio de sesión. Este mensaje puede revelar cierta información, como si una determinada dirección de correo electrónico está o no registrada en tu sitio (incluso si la contraseña es incorrecta).

Para evitar la filtración de información potencialmente sensible, puedes ocultar estos errores de inicio de sesión añadiendo el siguiente fragmento de código a tu archivo functions.php.

function kinsta_hide_login_errors(){
return 'These are not valid credentials';
}
add_filter( 'login_errors', 'kinsta_hide_login_errors' );

Este fragmento de código sustituye el texto de error de inicio de sesión predeterminado por el siguiente mensaje — Estas credenciales no son válidas.

Puedes personalizar el texto según tus preferencias — pero intenta evitar el uso de guiones, barras oblicuas u otros caracteres, ya que puede provocar un error (a menos que «escapes» de estos caracteres),

Cambiar la Longitud del Extracto

Por defecto, el extracto de WordPress muestra las primeras 55 palabras de una entrada.

Si quieres ajustarlo, puedes añadir el siguiente fragmento de código al archivo functions.php.

function kinsta_change_excerpt_length($length) {
return 90;
}
add_filter('excerpt_length', 'kinsta_change_excerpt_length');

El fragmento de código anterior cambiará la longitud del extracto a 90 palabras. Si prefieres un número diferente, puedes cambiar «90» por el número exacto de palabras que quieras utilizar.

Elimina el Número de Versión de WordPress

Para que a los actores maliciosos les resulte más difícil detectar qué versión de WordPress estás utilizando, a algunos usuarios les gusta eliminar el número de versión de WordPress para que no aparezca en ninguna parte del código del frontend de tu sitio.

Para ello, puedes añadir los siguientes fragmentos de código a tu archivo functions.php.

function kinsta_hide_version() {
return '';
}
add_filter('the_generator', 'kinsta_hide_version');

Configurar la Paginación de WordPress

Si no estás satisfecho con el funcionamiento de la paginación en tu tema, puedes utilizar un fragmento de código de functions.php para ajustar el comportamiento de la paginación o incluso crear tu propio sistema de paginación.

Si te interesa este tipo de modificación, tenemos una guía completa sobre la paginación en WordPress que incluye algunos fragmentos de código functions.php de ejemplo que puedes utilizar.

Cambiar el Número de Resultados a Incluir en la Página del Listado de Búsqueda

WordPress te ofrece una opción en el panel de control para controlar cuántas entradas incluir en las páginas de archivo (Ajustes → Lectura).

Sin embargo, esto cambia el número para todas las páginas de archivo. ¿Y si sólo quieres utilizar un número diferente para la página de resultados de búsqueda?

Para ello, puedes añadir este fragmento a tu archivo functions.php — asegúrate de cambiar el número («12» en este ejemplo) por el número real de resultados que deseas mostrar antes de paginar los resultados adicionales.

function kinsta_search_results_list() {
if ( is_search() )
set_query_var('posts_per_archive_page', 12);
}

add_filter('pre_get_posts', 'kinsta_search_results_list');

Incluir Imágenes Destacadas en el Feed RSS de WordPress

Si quieres incluir las imágenes destacadas de tus entradas en el contenido de tu feed RSS, puedes añadir el siguiente fragmento a tu archivo functions.php.

function kinsta_featured_image_rss($content) {
global $post;
if ( has_post_thumbnail( $post->ID ) ){
$content = '<div>' . get_the_post_thumbnail( $post->ID, 'full', array( 'style' => 'margin-bottom: 15px;' ) ) . '</div>' . $content;
}
return $content;
}

add_filter('the_excerpt_rss', 'kinsta_featured_image_rss');
add_filter('the_content_feed', 'kinsta_featured_image_rss');

Tal y como está escrito, el fragmento de código anterior insertará la imagen a tamaño completo. Para utilizar un tamaño de miniatura diferente, puedes cambiar «full» por un tamaño de miniatura diferente, por ejemplo, «large» o «middle».

Añadir Soporte de Subida para Tipos de Archivo (por ejemplo, SVG)

Por defecto, WordPress te impide subir determinados tipos de archivos, como archivos SVG.

Para habilitar la compatibilidad con estos tipos de archivo bloqueados, puedes añadir el siguiente fragmento de código al archivo functions.php de WordPress:

function kinsta_myme_types($mime_types){
$mime_types['svg'] = 'image/svg+xml';
return $mime_types;
}
add_filter('upload_mimes', 'kinsta_myme_types', 1, 1);

Este fragmento de código sólo permite subir archivos SVG, pero puedes modificarlo para añadir compatibilidad con otros tipos de archivos si es necesario.

Ocultar los Avisos de Actualización de WordPress para los No Administradores

Por defecto, WordPress mostrará mensajes a todos los usuarios con acceso al panel de control cuando haya una nueva actualización disponible.

Aunque la función de un usuario no le permita aplicar la actualización, el mensaje del panel de control le indicará que se ponga en contacto con el administrador.

Para ajustar esto, puedes utilizar este fragmento de código para ocultar las notificaciones de actualización a todos los usuarios que no sean administradores:

function kinsta_hide_update_nag() {
if ( ! current_user_can( 'update_core' ) ) {
remove_action( 'admin_notices', 'update_nag', 3 );
}
}

add_action('admin_menu','kinsta_hide_update_nag');

Para otras variaciones, consulta nuestra guía sobre cómo desactivar las notificaciones de actualización de WordPress.

Cambiar la Calidad de la Optimización JPEG Automática

Aunque no todo el mundo conoce esta función, WordPress comprime automáticamente las imágenes JPEG cuando crea miniaturas para tu sitio después de subir las imágenes.

Desde WordPress 4.5, WordPress ha establecido el nivel de calidad por defecto en 82 (siendo 100 compresión cero).

Si quieres que este nivel de calidad sea mayor o menor, puedes añadir el siguiente fragmento de código a tu archivo functions.php — asegúrate de cambiar el número («90» en este ejemplo) por el nivel de calidad real que quieras utilizar:

add_filter( 'jpeg_quality', create_function( '', 'return 90;' ) );

Buenas Prácticas para Organizar tu Archivo functions.php de WordPress

Si sólo utilizas el archivo functions.php de WordPress para añadir un par de fragmentos de código, probablemente no necesites preocuparte por la organización.

Pero si estás añadiendo muchos fragmentos de código a tu sitio, rápidamente puede llegar a ser difícil de manejar y complejo si no estás siguiendo algunas de las mejores prácticas de organización de archivos functions.php.

Aquí tienes algunas buenas prácticas para mantener organizados tus fragmentos de código…

Añade Comentarios al Código para Explicarlo Todo

Cuando añades por primera vez un fragmento de código a tu archivo functions.php, sabes exactamente lo que hace el fragmento y por qué lo has añadido. Pero cuando vuelvas a mirar el archivo functions.php un año después, puede que las cosas no estén tan claras.

Para evitarlo, deberás añadir comentarios de código a cada fragmento que expliquen lo que hace y por qué lo has añadido.

Los comentarios de código son texto que WordPress no ejecuta, pero que los usuarios humanos pueden leer para entender lo que hace el fragmento de código.

Para añadir un comentario de código de una sola línea, puedes utilizar este formato:

// This is a single-line code comment

Para añadir un comentario de código de varias líneas, puedes utilizar este formato:

/**
* This is a code comment that spans multiple lines
* This text is also in the same comment
* This is the last line in the code comment
*/

Aquí tienes un ejemplo de cómo puedes utilizar los comentarios de código — puedes ver que el comentario que precede a cada fragmento explica lo que hace el fragmento.

Utiliza Archivos Include para Separar Fragmentos en Distintos Archivos

Si realmente tienes muchos fragmentos de código, puedes almacenarlos en archivos separados en lugar de utilizar sólo el archivo functions.php.

Luego, puedes incluir esos fragmentos de código en el archivo functions.php utilizando include o require. Mike Schinkel tiene un buen ejemplo de cómo hacerlo en StackExchange.

Considera una de las Alternativas Anteriores a functions.php

Si crees que tu archivo functions.php está un poco desordenado, quizá prefieras una de las alternativas a functions.php que hemos detallado antes.

Por ejemplo, el plugin gratuito Code Snippets facilita mucho la organización porque puedes añadir cada fragmento de código por separado, con su propio título y descripción. También puedes utilizar etiquetas para organizar tus fragmentos.

Resumen

El archivo functions.php de WordPress es un archivo específico de un tema que te permite añadir fragmentos de código PHP a tu sitio web.

Si quieres añadir fragmentos de código al archivo functions.php, debes utilizar siempre un tema hijo para que tus cambios no se sobrescriban cuando actualices tu tema. También te recomendamos que hagas una copia de seguridad de tu sitio antes de añadir fragmentos y que los pruebes en un sitio de prueba siempre que sea posible.

Como alternativa al uso del archivo functions.php, también puedes considerar un plugin gestor de código o crear tu propio plugin personalizado para alojar tus fragmentos.

Ahora que sabes cómo funciona el archivo functions.php de WordPress, puedes empezar a personalizar tu sitio de todas las formas posibles.

Los fragmentos de functions.php de ejemplo anteriores te ofrecen algunos buenos puntos de partida, pero las posibilidades son infinitas.