En el desarrollo de WordPress, un filtro se puede usar para cambiar o extender la funcionalidad de WordPress. Lo hace tomando algunos datos proporcionados por WordPress, cambiándolos a otra cosa y luego devolviéndolos.
Los filtros son una de las grandes características que hacen que WordPress sea tan personalizable. Son fragmentos de código PHP que están 'enganchados' a un evento de WordPress. Cuando se activa el evento, el filtro se aplicará a la salida de datos generada por el gancho del evento.
Son utilizados extensivamente por desarrolladores de plugins y temas. Sin embargo, si no eres un desarrollador, puedes pegar fragmentos de código de la web para agregar nuevas funciones a tu sitio web. Muchos de estos incluyen filtros.

¿Qué es un Filtro en WordPress?
Un filtro modificará el comportamiento predeterminado de una función específica en tu sitio web de WordPress. Lo hace manipulando los datos que recibe y luego devolviendo esos datos a WordPress antes de que se muestren en el navegador.
Por ejemplo, los filtros se pueden usar para truncar texto, cambiar el formato del contenido, adjuntar enlaces a publicaciones, modificar bloques en una página y cambiar opciones recuperadas de la base de datos. También podrían cambiar la longitud de un extracto, colocar publicaciones relacionadas debajo de tu contenido principal o cambiar un precio en WooCommerce.
Los filtros se agregan usando la función add_filter(). WordPress tiene varias funciones que te permiten usar acciones, pero estas son las que se usan con más frecuencia:
add_filter(): esto adjunta una función a un ganchoremove_filter(): esto elimina una función adjunta a un gancho de filtro especificadodoing_filter(): esto detecta cualquier filtro que se esté ejecutando actualmentehas_filter(): verifica si se ha registrado un filtro
Los filtros son utilizados por desarrolladores de plugins y temas para agregar funcionalidad extra a WordPress. También puedes usar filtros para personalizar tu tema agregando fragmentos de código de tutoriales en línea.
Note: If you’re a beginner, then we strongly caution against editing any WordPress files. Only experienced users who feel comfortable with editing the functions.php file and have some knowledge of PHP should try this.
Los principiantes deben usar un plugin para realizar la tarea que desean o consultar a un profesional para que edite el código por ellos.
Antes de editar cualquier código en tu sitio de WordPress, te recomendamos que hagas una copia de seguridad de tu sitio web en caso de un error de codificación. Si no tienes un plugin de copia de seguridad, asegúrate de leer nuestro artículo donde comparamos los mejores plugins de copia de seguridad de WordPress.
También te recomendamos que no agregues el código directamente a los archivos del tema, o perderás tus personalizaciones la próxima vez que actualices el tema.
En su lugar, deberías usar un plugin de fragmentos de código para agregar código personalizado en WordPress, crear un plugin específico para el sitio, o crear un tema hijo y modificarlo en lugar del tema principal.
Consulta nuestra guía sobre cómo actualizar un tema de WordPress sin perder personalizaciones.
¿Cuál es la diferencia entre Hooks, Acciones y Filtros?
Para comprender mejor los filtros en WordPress, es útil ver cómo se relacionan con otros dos términos: hooks y acciones. Comprender estos tres términos juntos hará que el término 'filtro' sea un poco más fácil de asimilar.
Hooks son la base del desarrollo de plugins y temas de WordPress. Son lugares donde los desarrolladores pueden 'enganchar' su código personalizado en WordPress en ubicaciones específicas y cambiar cómo opera WordPress sin editar los archivos principales.
Hay dos tipos de hooks.
- Los hooks de filtro te permiten cambiar algo. Interceptan datos que se están procesando y te permiten modificarlos, luego los devuelven. Se utilizan para filtrar la salida cuando se envía a una base de datos o al navegador de un usuario.
- Los hooks de Acción te permiten hacer algo. Te permiten agregar funcionalidad extra y se ejecutan cuando ocurren eventos como cuando se activa un tema o plugin, o cuando se publica una entrada. Una vez que se ha realizado la acción, no necesitan devolver ninguna información.
Estos ganchos de acción y filtro son la base de cómo funcionan el núcleo de WordPress, los temas y los plugins. Trabajan juntos para permitir a los desarrolladores una gran flexibilidad para modificar eventos, filtros y acciones predeterminados de WordPress.
Los desarrolladores también pueden crear sus propias acciones y filtros personalizados para que otros desarrolladores puedan extender sus plugins o temas.
Ejemplos de filtros de WordPress
¿Cómo se ve un filtro? Aquí hay algunos ejemplos.
Digamos que queremos mostrar un ícono de imagen cuando se muestra una publicación que pertenece a una categoría en particular. En este escenario, creamos una función que verifica si una publicación está en esa categoría en particular. Si es así, entonces muestra la imagen.
A continuación, conectamos esa función al evento the_content. Ahora, cada vez que ocurre el evento the_content, nuestra función se activa automáticamente para filtrar la salida del evento the_content.
// First we hook our own function with the_content event
add_filter( 'the_content', 'wpb_content_filter' );
// Now we define what our function would do.
// In this example it displays an image if a post is in news category.
function wpb_content_filter( $content ) {
if ( in_category('news') )
$content = sprintf('<img class="news-icon" src="%s/images/news_icon.png" alt="News icon" title="" />%s', get_bloginfo( 'stylesheet_directory' ), $content);
// Returns the content.
return $content;
}
Aquí hay otro ejemplo de uso de un filtro de WordPress.
Este código de ejemplo agrega una función wpb_custom_excerpt al filtro get_the_excerpt.
function wpb_custom_excerpt( $output ) {
if ( has_excerpt() && ! is_attachment() ) {
$output .= wpb_continue_reading_link();
}
return $output;
}
add_filter( 'get_the_excerpt', 'wpb_custom_excerpt' );
Puedes aprender más estudiando nuestras guías de WordPress que usan filtros. Por ejemplo, aquí hay algunas guías que te muestran cómo lograr algo práctico usando filtros de WordPress:
- Cómo mostrar menús diferentes a los usuarios que han iniciado sesión
- Cómo deshabilitar la barra de administración para todos los usuarios, incluidos los administradores
- Cómo actualizar automáticamente los plugins de WordPress
- Cómo deshabilitar las pistas de inicio de sesión en WordPress
- Cómo deshabilitar las notificaciones por correo electrónico sobre actualizaciones automáticas
WordPress tiene muchos filtros predefinidos que permiten a los desarrolladores agregar su propio código en puntos específicos del núcleo de WordPress. La API de plugins de WordPress proporciona una lista extensa de ganchos de filtro disponibles.
Esperamos que este artículo te haya ayudado a aprender más sobre los filtros en WordPress. También es posible que desees consultar nuestra lista de Lecturas Adicionales a continuación para ver artículos relacionados sobre consejos, trucos e ideas útiles de WordPress.
Si te gustó esta guía, considera suscribirte a nuestro Canal de YouTube para tutoriales en video de WordPress. También puedes encontrarnos en Twitter y Facebook.

