Qué es el filtro «Capital P Dangit» y cómo quitarlo

Matt Mullenweg es uno de los fundadores de WordPress (¡gracias!) y en 2010 añadió un pedazo de de código pequeño para corregir automáticamente cada «Wordpress», sin P mayúscula, a «WordPress«, con P mayúscula. Esta corrección automática se conoce comúnmente como el filtro «Capital P Dangit».

Si prefieres tener control editorial total sobre el uso de las mayúsculas, puedes desactivar este filtro. El impacto en el rendimiento al dejarlo activado es mínimo, ya que capital_P_dangit() es una simple sustitución de cadenas que se aplica en algunos contextos. Para la mayoría de los sitios web, esto se trata de estilo y coherencia editorial, no de velocidad. Si realmente quieres mejorar la velocidad de tu sitio WordPress, te puedo ayudar.

Para hacer esto, este es el fragmento de código que necesitarás:

/* Quitar el filtro de capital P dangit en todos lados */
remove_filter( 'the_title', 'capital_P_dangit', 11 );
remove_filter( 'the_content', 'capital_P_dangit', 11 );
remove_filter( 'comment_text', 'capital_P_dangit', 31 );
remove_filter( 'document_title', 'capital_P_dangit', 11 );
remove_filter( 'widget_text_content', 'capital_P_dangit', 11 );
remove_filter( 'wp_title', 'capital_P_dangit', 11 ); // para temas antiguos usando wp_title()

Guarda los cambios y ¡listos!

Cuándo deberías (o no) desactivar esto

• Deberías: Tu guía de estilo permite usar «Wordpress» en minúsculas en citas o ejemplos de código, o si no quieres que se realicen cambios automáticos en títulos, contenido, comentarios y widgets.
• No deberías: Tu equipo sigue las normas oficiales del proyecto WordPress y quiere que esa coherencia se aplique automáticamente.

Notas de seguridad (lee antes de editar nada)

Para cambios permanentes y a prueba de actualizaciones, evita editar el archivo functions.php del tema padre. En su lugar, utiliza una de las siguientes opciones:

• Tema hijo: Añade el código al archivo functions.php del tema hijo para que las actualizaciones del tema padre no lo sobrescriban.
• Plugin específico para el sitio: Crea un plugin pequeño que contenga solo este fragmento de código. Actívalo como cualquier plugin normal. Esto mantendrá el cambio por separado de tu tema.
• Plugin MU: Coloca un único archivo PHP en /wp-content/mu-plugins/. Se carga automáticamente con cada solicitud y con cada cambio de tema.

Pruebalo primero en el entorno de pruebas y luego implementa el cambio en producción. Ten a mano el acceso a archivos (SFTP o administrador de archivos del host) y el acceso de administrador por si necesitas revertir los cambios.

Revertir

• Si has añadido el código en un tema hijo: elimina las líneas y guarda.
• Si has creado un plugin específico para el sitio: desactívalo o cambia temporalmente el nombre de la carpeta del plugin.
• Si has usado un plugin MU: cambia el nombre o elimina el archivo en mu-plugins (no hay pantalla de desactivación para los plugins MU).

Cómo implementar

Opción A: Tema hijo

1. Abre (o crea) el archivo functions.php de tu tema hijo mediante SFTP, el administrador de archivos del host o el editor de archivos de tema del panel de administración de WordPress (Apariencia → Editor de archivos de tema, si está disponible).
2. Añade el fragmento de código al final del archivo.
3. Guarda el archivo. Si lo editas localmente, súbelo a /wp-content/themes/tu-tema-hijo/functions.php, sobrescribiendo el archivo existente.
4. Borra la caché y verifica.

Un par de notas específicas sobre esta opción:

• No incluyas una etiqueta de apertura <?php si pegas el código en medio de un archivo functions.php existente. Este archivo ya debería tener una al principio. Solo añádela si el archivo está vacío.
• Esto solo funciona si estás usando un tema hijo. Si lo añades al archivo functions.php de un tema padre, se eliminará en la próxima actualización del tema, que es precisamente lo que advierte la nota de seguridad al principio.

Opción B: Plugin específico para el sitio

1. Crea un nuevo archivo llamado mi-plugin.php en tu ordenador (sustituye mi-plugin por el nombre que quieras).
2. Pega este código y guarda (recuerda cambiar los textos correspondientes):

<?php
/**
 * Plugin Name: Mi plugin
 * Description: Descripcion del plugin
 */

el_fragmento_de_codigo_va_aqui

3. Sube el archivo a /wp-content/plugins/ y actívalo en Plugins.
4. Borra la caché y verifica.

Opción C: Plugin de uso obligatorio (MU)

1. Si no existe todavía, crea la carpeta /wp-content/mu-plugins/.
2. Crea un archivo llamado mi-plugin.php con el mismo código que en la opción B.
3. Sube el archivo a /wp-content/mu-plugins/. Los plugins MU se cargan automáticamente; no hay pantalla de activación/desactivación.

Verificación

• Crea una entrada de prueba titulada «Prueba de Wordpress». El título debe permanecer tal cual (sin autocorrección a WordPress).
• Añade la frase «Wordpress» al contenido y a un comentario de la entrada de prueba; confirma que no se autocorrija.
• Observa en la pestaña/título del navegador de una entrada individual y de la página de inicio; comprueba que no se ve afectado el <title>.
• Coloca un widget de texto (o un bloque de párrafo en un área de widgets) con «Wordpress» y confirma que no hay cambios.