Mi lugar en la comunidad WordPress
- Tengo cuenta en wordpress.org desde 2006.
- He contribuido al núcleo de WordPress en las versiones 7.0 y 7.1.
- Mantengo 30 plugins en wordpress.org.
- Organizo WordCamps y hablo en ellos como ponente.
- He asistido a todas las WordCamp Europe de 2017 a 2026.
- Meetup local de WordPress: WordPress Barcelona
Una web en catalán y castellano con Next.js: lo que hay que decidir primero
Una empresa de Barcelona que vende o informa en catalán y castellano no tiene dos webs, tiene una web con dos URL por cada página. Next.js lo resuelve con el App Router, pero la parte difícil no es el código: son cuatro decisiones que conviene cerrar por escrito antes de la primera línea. Cómo se escribe la URL de cada idioma, quién traduce, qué ocurre cuando falta un texto y qué se envía a Google.
Soy Mariusz Szatkowski, trabajo solo desde Gdynia con WordPress desde 2006, y hago estos proyectos en remoto y por escrito. El diseño y la maqueta los aporta el cliente. Yo los implemento en Next.js.

Foto: Herodotptlomeu, CC BY-SA 4.0, Wikimedia Commons.
Cómo enruta Next.js un sitio por idioma
La guía de internacionalización de Next.js separa dos cosas: las rutas internacionalizadas y el contenido localizado. Las rutas pueden ir por subruta (/fr/products) o por dominio. Para el contenido, la guía propone un diccionario por idioma que se carga en el servidor.
En un sitio catalán y castellano, la estructura queda así:
- Todas las páginas cuelgan de
app/[lang], de modo quecayesson un parámetro de la ruta. - Un archivo
dictionaries.tsimportaca.jsonoes.jsonsegún el idioma, yhasLocalejunto connotFound()devuelve un 404 si alguien escribe/fr/. generateStaticParamsen el layout genera las dos versiones en la compilación.- El atributo
langde<html>se rellena con el parámetro de la ruta.
Como las páginas del App Router son Server Components por defecto, la guía señala que el tamaño de los diccionarios no afecta al JavaScript que recibe el navegador: solo viaja el HTML resultante. Con un catálogo largo en dos idiomas, eso importa.
Hay un detalle de versión. En la versión actual del paquete next, la 16.4.6 según el registro de npm, el archivo que antes se llamaba middleware se llama proxy, y la documentación indica que la convención antigua está obsoleta. Si el proyecto está en una versión anterior, el mismo código vive en middleware.ts. Lo compruebo en el package.json del cliente antes de escribir nada.
La URL sin prefijo y la detección del idioma
El patrón de la guía lee la cabecera Accept-Language, busca el mejor idioma entre los admitidos y redirige a la ruta con prefijo. Con tus dos idiomas, el núcleo es este:
// proxy.ts
import { NextResponse } from 'next/server'
const locales = ['ca', 'es']
export function proxy(request) {
const { pathname } = request.nextUrl
const hasLocale = locales.some(
(l) => pathname.startsWith(`/${l}/`) || pathname === `/${l}`
)
if (hasLocale) return
request.nextUrl.pathname = `/${getLocale(request)}${pathname}`
return NextResponse.redirect(request.nextUrl)
}
export const config = { matcher: ['/((?!_next).*)'] }getLocale es la función de la guía, con @formatjs/intl-localematcher y negotiator. En esta versión el redirect solo actúa sobre la URL sin prefijo, que no es la que quieres posicionar.
Aquí hay una decisión que no es técnica. Google recomienda una URL distinta por idioma y advierte de que, si el contenido cambia o redirige según el idioma, puede no encontrar todas las variantes, porque su rastreador suele salir desde Estados Unidos y no envía Accept-Language. También pide evitar la redirección automática de una versión a otra según el idioma que se le supone al usuario. Por eso propongo que la URL con prefijo sirva siempre su idioma, que el conmutador enlace a la otra versión y que la raíz sin prefijo sea la única que decide. Si prefieres que la raíz sea una pantalla de elección sin redirección, también es válido.
hreflang, canonical y sitemaps
Para que Google asocie /ca/ y /es/ como la misma página en dos idiomas, la documentación de versiones localizadas pide tres cosas que pasan por el código:
- Cada versión se lista a sí misma y a todas las demás.
- Las URL alternativas son absolutas, con
https://. - Los enlaces son recíprocos: si la página X enlaza a la Y, la Y debe enlazar a la X, o las anotaciones pueden ignorarse.
Next.js tiene un campo para esto. En generateMetadata, alternates.languages produce los <link rel="alternate" hreflang> y alternates.canonical el canónico. Según la referencia de generateMetadata, basta con indicar las URL por idioma, y metadataBase en el layout raíz resuelve las rutas relativas. El detalle práctico es que el canonical de la versión catalana apunta a la catalana, nunca a la castellana.
Los títulos y las descripciones también hay que traducirlos: los guardo en el mismo diccionario que el resto de textos para que no se queden en castellano. La misma regla vale para los datos estructurados y para el sitemap.xml: cada URL va con sus alternativas.
Qué dice el Codi de consum sobre el catalán
El catalán en una web comercial no es solo una cuestión de clientela. La Ley 22/2010, del Código de consumo de Cataluña, publicada en el BOE, regula los derechos lingüísticos de las personas consumidoras en su artículo 128-1:
- El apartado 1 reconoce el derecho a ser atendido, oralmente y por escrito, en la lengua oficial que el consumidor elija.
- El apartado 2 reconoce el derecho a recibir en catalán las invitaciones a comprar, la información de carácter fijo, la documentación contractual, los presupuestos, las facturas, las informaciones necesarias para el consumo y el uso adecuados y las condiciones generales.
- El artículo 211-5 añade que esa documentación e información debe estar a disposición inmediata del consumidor, salvo marcas, nombres comerciales y rotulación amparada por la propiedad industrial.
El BOE anota que el Tribunal Constitucional, en su sentencia 88/2017, declaró que los apartados 1 y 2 no son inconstitucionales si se interpretan en los términos de sus fundamentos jurídicos 4 y 5. Eso es una cuestión para tu asesor jurídico: yo no interpreto la ley, y no sustituyo a quien lo hace.
Para el desarrollo, la consecuencia es práctica. En una tienda o un servicio para consumidores, el alcance del catalán incluye lo que sale del propio Next.js (fichas, condiciones, aviso de cookies, formularios) y también lo que no sale de él: el correo de confirmación del pedido, el PDF de la factura, el presupuesto. Si el alcance del idioma se limita a las páginas, esos documentos se quedan fuera. Lo escribo en el alcance desde el principio.
Los textos que faltan, los que sobran y los que mezclan idiomas
Tres casos que en un proyecto bilingüe aparecen siempre:
Clave que falta en catalán. Con diccionarios tipados, la compilación puede comparar las claves de es.json y ca.json y fallar si no coinciden. El cliente decide: o falla, o se acepta el castellano como reserva en secciones concretas, y se anota cuáles.
Un fragmento en otro idioma dentro de una página. Una cita en castellano en una página catalana, o el nombre de un producto en inglés. El criterio 3.1.2 de WCAG 2.2, de nivel AA, pide que el idioma de cada pasaje se pueda determinar por programa, con excepciones para nombres propios y términos técnicos. En HTML se resuelve con lang en ese fragmento. El criterio 3.1.1, de nivel A, es el del idioma de la página entera, y de ahí que lang del <html> salga del parámetro de la ruta.
El conmutador. Debe llevar a la misma página en el otro idioma, no a la portada. Si una página existe solo en castellano, el conmutador lo dice en lugar de enviar a un 404. Los slugs traducidos (/ca/serveis/ frente a /es/servicios/) exigen una tabla de correspondencia que alguien mantiene. Lo acordamos por escrito antes de empezar.
Cómo trabajo en un proyecto bilingüe
- Brief por escrito: idiomas, quién escribe cada texto, si hay venta a consumidores y qué documentos genera la tienda o el CRM.
- Preguntas por escrito: inventario de las URL actuales, dominio o subruta, estructura de slugs.
- Alcance por escrito, con las suposiciones y lo que queda fuera: diseño y maquetas los aporta el cliente, y la traducción también.
- Entorno de pruebas con las dos versiones, donde se revisan los enlaces recíprocos, los canónicos y el conmutador.
- Aceptación con una lista que ambos conocemos de antemano.
- Mantenimiento como opción aparte, con horas que no pasan de un mes a otro.
Lo que tienes que preparar tú: los textos en catalán, un glosario de términos que no se traducen, la lista de URL si la web ya existe y acceso al dominio y al alojamiento.
Lista de comprobación para una web bilingüe
| Punto | Qué se comprueba |
|---|---|
| Prefijos | /ca/ y /es/ sirven siempre su idioma |
lang | El atributo de <html> coincide con el idioma de la ruta |
| hreflang | Cada versión se lista a sí misma y a la otra, con URL absolutas |
| Canónico | Cada versión apunta a sí misma |
| Sitemap | Cada URL con sus alternativas |
| Conmutador | Lleva a la misma página en el otro idioma |
| Claves | La compilación avisa si falta una en catalán |
| Documentos | Correo de pedido, factura y presupuesto en catalán cuando corresponde |
| Redirecciones | Las URL antiguas llevan por 301 a su equivalente en el mismo idioma |
Puedes usarla con cualquier desarrollador, aunque no me contrates.
Preguntas frecuentes
¿Un idioma por subruta o un dominio por idioma?
Para una empresa de Barcelona que ya tiene un dominio, casi siempre subrutas (/ca/ y /es/). La guía de Next.js admite las dos opciones. Con subrutas hay un solo dominio y un solo despliegue. Un dominio por idioma solo compensa si cada versión tiene equipo, marca o legislación propias.
¿Puedo redirigir al catalán o al castellano según el navegador?
Solo en la URL sin prefijo, y como decisión tuya. Google avisa de que su rastreador suele salir desde Estados Unidos y no envía Accept-Language, y desaconseja redirigir a otra versión según el idioma supuesto del usuario. Cada URL con prefijo debe servir siempre su idioma, y el conmutador debe enlazar a la otra versión.
¿Es obligatorio tener la web en catalán?
No hay una norma que diga “toda web en Cataluña en catalán”. El artículo 128-1 del Codi de consum da al consumidor derecho a recibir en catalán la documentación contractual, las facturas y las informaciones necesarias para usar el producto. Afecta a la venta a consumidores. Si vendes solo entre empresas, lo decide tu mercado. Para el alcance exacto, consulta a tu asesor jurídico.
¿Quién traduce los textos al catalán?
Los textos los aporta el cliente o su traductor. Yo implemento la estructura: archivos de diccionario por idioma, rutas, metadatos y un aviso en la compilación cuando falta una clave. No traduzco textos legales ni de marca.
¿Qué pasa con los textos que existen solo en castellano?
Hay que decidirlo por escrito antes de empezar. Con un diccionario tipado, la compilación puede fallar si falta una clave en catalán, o puedes aceptar el castellano como texto de reserva en secciones concretas. Lo que no recomiendo es que el fallo pase sin que nadie lo vea.
¿Cómo se migra una web bilingüe existente sin perder las URL?
Hago un inventario de las URL de las dos versiones, una tabla de redirecciones 301 de la antigua a la nueva, y compruebo en el entorno de pruebas que cada par de versiones se enlaza en las dos direcciones. Después de publicar, reviso Search Console por idioma.
Cuéntame tu web
Si tienes una web en catalán y castellano, o la vas a tener, escríbeme desde la página de contacto. Dime la dirección de la web actual, qué idiomas necesitas, si vendes a consumidores, qué stack tienes hoy y para cuándo lo necesitas. La primera estimación por escrito es gratuita, y te contesto por escrito en días laborables.
Proyectos seleccionados
Ejemplos de mi trabajo.
Desarrollo E-commerce: kredytywarszawa.pl
kredytywarszawa.pl es un sitio WordPress para una empresa de préstamos y servicios financieros, con servicios claros, rendimiento y seguridad básica.
Desarrollo E-commerce: led-lumina.pl
led-lumina.pl es una tienda online de iluminación LED para clientes particulares y empresas, con catálogo amplio, filtros, pagos y envíos.
Desarrollo E-commerce: like2slide.com
like2slide.com es un sitio creado para amantes de los deportes de tabla y deslizamiento, con una estructura pensada para noticias, comunidad y contenido temático.
Soporte y desarrollo WordPress en Barcelona
¿Buscas el servicio: Desarrollador Next.js en Barcelona?
Describe tu proyecto por e-mail. Respondo en 48 horas.
Describe tu proyectoExplora otros servicios WordPress y base de conocimiento
Migración a Astro, Next.js y headless WordPress.
Sincronización WooCommerce con ERP y mayorista.
Automatización de procesos de negocio en torno a WordPress y sistemas empresariales.
Biblioteca de casos concretos de automatización.
Headless WordPress, Sanity, Strapi y Contentful con Astro o Next.js.
Astro, MDX, edge delivery y Core Web Vitals medidos con tráfico real.
Ingeniería WordPress y arquitectura personalizada.
Arquitectura headless, ERP e IA escalable para enterprise.
Categorías relacionadas
Artículos de apoyo

De seis a dieciséis semanas para proyectos típicos, en cuatro fases: descubrimiento, alcance, construcción y cutover, ajuste. Las variables son el tamaño del catálogo, el número de integraciones, la preservación de URLs y la disposición del equipo editorial, no la elección del framework.

Análisis exhaustivo del coste total de propiedad (TCO) a 4 años, métricas reales de Core Web Vitals, arquitectura Astro 7 GraphQL APQ y matriz de decisión de 10 puntos para directores de tecnología que eligen entre WordPress desacoplado y tradicional.

La decisión entre Shopify Plus y WooCommerce headless en 2026 ya no es un compromiso binario "plataforma vs personalizado". Ambos pueden funcionar en headless, ambos integran IA, ambos sirven en el edge. Los ejes reales son el control, el coste total a lo largo de cinco años y la estrategia de salida. Este artículo recorre la matriz con datos confirmados de cada plataforma.