Análisis

Cada ficha que oculta una fila vacía, cada plantilla que muestra una etiqueta distinta según un parámetro, cada página de wiki que calcula una edad a partir de una fecha depende de la misma extensión: ParserFunctions. Añade lógica al wikitexto, que por sí solo solo sabe sustituir texto. Esta guía cubre las funciones que de verdad vas a usar y los tres comportamientos que explican la mayoría de las dudas sobre ellas. Todo lo que sigue se comprobó en la documentación de la extensión en mediawiki.org el 15 de octubre de 2026.

Instalación y sintaxis

ParserFunctions viene con MediaWiki. Forma parte del paquete de MediaWiki desde la versión 1.18, así que en un wiki autoalojado normalmente basta con activarla con `wfLoadExtension( 'ParserFunctions' );` en `LocalSettings.php`. No necesita actualizar la base de datos. En un wiki alojado por terceros no puedes modificar ese archivo, lo que importa para las opciones de configuración de más abajo.

Todas las funciones tienen la misma forma. Se escribe `{{#nombre: primero | segundo | tercero }}`: una almohadilla, el nombre de la función, dos puntos y luego los parámetros separados por barras verticales. La documentación indica que los espacios, saltos de línea incluidos, se eliminan al principio y al final de cada parámetro. Es cómodo para maquetar, y es el origen de la primera trampa.

Las funciones condicionales

`#if` comprueba si una cadena está vacía, nada más. `{{#if: prueba | valor si no está vacía | valor si está vacía }}` devuelve el segundo parámetro cuando el primero contiene cualquier cosa, y el tercero cuando está vacío o solo contiene espacios. No evalúa la prueba: `{{#if: 1==2 | sí | no }}` devuelve sí, porque «1==2» es una cadena no vacía, y `{{#if: 0 | sí | no }}` también devuelve sí. Para condiciones aritméticas, usa `#ifexpr`.

• #if : cadena no vacía o no (los espacios cuentan como vacío)
• #ifeq : dos valores idénticos o no (numérico si ambos son números)
• #iferror : si otra función devolvió un error
• #ifexpr : resultado verdadero o falso de una expresión aritmética
• #ifexist : si una página existe (costosa, limitada por página)
• #switch : un resultado entre varios casos, con valor por defecto
• #expr : cálculo, redondeo, lógica
• #time / #timel : dar formato a una fecha (UTC o local)
• #titleparts : dividir un título de página por sus barras
• #rel2abs : convertir una ruta de página relativa en absoluta

`#ifeq` compara dos cadenas, y los números como números. `{{#ifeq: a | b | iguales | distintas }}` devuelve el tercer o el cuarto parámetro. Cuando los dos valores son números válidos, la comparación es numérica: `01` es igual a `1` y `1e3` es igual a `1000`. Para comparar más de dos valores, `#switch` es la herramienta adecuada.

`#switch` elige un resultado entre varios. `{{#switch: valor | caso1 = resultado1 | caso2 = resultado2 | por defecto }}` devuelve el resultado del primer caso que coincide, y el último parámetro sin signo igual cuando no coincide ninguno. Varios casos pueden compartir un resultado si se escriben seguidos, con el resultado solo en el último. Sustituye a una cadena de `#ifeq` anidados que se vuelve ilegible a partir de tres niveles.

Cálculo, fechas y comprobación de páginas

`#expr` hace cálculos, no tratamiento de texto. `{{#expr: 1 + 1 }}` devuelve 2, y la función admite operadores lógicos, `round`, `trunc`, `ceil` y `floor`. Una expresión no válida devuelve un mensaje de error que `#iferror` puede capturar. La documentación es explícita: las expresiones solo funcionan con valores numéricos y no pueden comparar cadenas; para eso está `#ifeq`. Para las fechas, `#time` da formato a una fecha, y la documentación sugiere el formato `xNU` para convertirla en segundos desde el 1 de enero de 1970, que luego se pueden sumar y restar con `#expr`.

`#ifexist` es una función costosa, y falla en silencio a partir de un límite. Comprueba si una página existe. Cada página destino distinta cuenta para `$wgExpensiveParserFunctionLimit`, incluidas las comprobaciones hechas dentro de plantillas transcluidas. Una vez alcanzado el límite, cada `#ifexist` siguiente devuelve falso, exista o no la página, y la página se añade a una categoría de seguimiento. Si una plantilla muestra de repente enlaces rojos a páginas que existen, es lo primero que hay que revisar.

Las dos trampas que rompen las plantillas

Las barras verticales sin escapar rompen las tablas. Como cada barra se lee como separador de parámetros, una tabla wiki escrita dentro de `#if` o `#switch` se desarma. Desde MediaWiki 1.24, la palabra mágica `{{!}}` produce una barra que el analizador solo ve después de ejecutarse la función; antes, la mayoría de los wikis usaban una plantilla llamada `!` con el mismo fin. Para mostrar una barra literal, usa `|`.

Las funciones de cadenas están desactivadas por defecto. `#len`, `#pos`, `#sub`, `#replace`, `#explode` y las demás solo existen si `$wgPFEnableStringFunctions` vale true, y su valor por defecto es false; `$wgPFStringLengthLimit` limita por defecto las cadenas a 1.000 caracteres. La documentación añade que en 2013 se decidió que nunca se activarán en ningún wiki de Wikimedia, porque son ineficientes a gran escala. En Wikipedia y sus proyectos hermanos, el tratamiento de cadenas pasa por módulos Lua, como `{{#invoke:String|len|...}}` que ofrece Scribunto.