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 Bilbao
En una empresa industrial de Bizkaia la documentación técnica suele vivir en tres sitios a la vez: una carpeta compartida en la oficina técnica, adjuntos de correo que el comercial reenvía a cada distribuidor y una página de descargas en la web con PDF que nadie se atreve a borrar. El día que cambia una ficha, la versión antigua sigue circulando. El distribuidor de Burgos trabaja con una tabla de pares de apriete que ya no vale y el cliente final la encuentra en Google.
Me llamo Mariusz Szatkowski y programo con WordPress desde 2006. Soy una sola persona, trabajo en remoto desde Gdynia y todo lo acordamos por escrito. En esta página te explico cómo monto en WordPress una biblioteca de documentación técnica: fichas, manuales, declaraciones UE de conformidad y certificados, con versiones, búsqueda por referencia y una zona para distribuidores. No soy abogado; donde entra el Reglamento de máquinas, lo que te aplica lo decide tu asesor.

Foto: Fernandopascullo, CC BY-SA 3.0, Wikimedia Commons.
Qué entra en la biblioteca y qué se queda fuera
Antes de tocar WordPress conviene separar dos cosas que en la carpeta compartida están mezcladas: lo que entregas a terceros y lo que solo usa tu oficina técnica.
Entran los documentos que alguien de fuera necesita para elegir, instalar, usar o revender tu producto:
- fichas técnicas por referencia o por familia;
- manuales de instalación, de uso y de mantenimiento;
- declaraciones UE de conformidad y certificados de producto;
- planos de dimensiones y archivos CAD que publicas para integradores;
- hojas de recambios y notas de servicio para distribuidores.
Se quedan fuera los planos de fabricación, los cálculos y el expediente técnico interno. La biblioteca no sustituye a tu gestor documental ni a tu sistema PLM: publica lo que ya está aprobado allí. Si mezclas las dos funciones, la web acaba siendo el sitio donde se corrigen los documentos, y eso rompe la trazabilidad que ya tienes.
Un documento con varias versiones
Aquí está el error más común. La biblioteca de medios de WordPress guarda archivos, no documentos. Si subes la ficha corregida, WordPress crea otro archivo con otra dirección; la antigua sigue en el servidor y sigue descargándose desde cualquier enlace viejo. El núcleo de WordPress no trae versiones de archivos ni una función para sustituir uno por otro conservando la dirección.
Por eso monto la biblioteca como un modelo de datos propio:
| Elemento | Qué guarda | Ejemplo |
|---|---|---|
| Tipo de contenido «documento» | El documento como concepto, con su dirección fija | Ficha técnica de la serie de válvulas VX |
| Taxonomía «familia» | Línea de producto | Válvulas, actuadores, recambios |
| Taxonomía «tipo» | Clase de documento | Ficha, manual, declaración UE, certificado |
| Taxonomía «idioma» | Idioma del archivo | Castellano, euskera, inglés, francés |
| Campos de versión | Número, fecha de edición, estado, nota de cambios | 3.2, 2026-09-14, vigente, «tabla de pares corregida» |
| Archivo | Un archivo por versión e idioma | Cada PDF con su propio registro |
La dirección del documento, por ejemplo /documentacion/ficha-serie-vx/, no cambia nunca y muestra siempre la versión vigente. Debajo aparece el historial: versiones anteriores marcadas como sustituidas, con su fecha y la nota de qué cambió. Quien llega con un PDF antiguo en la mano ve enseguida que hay otro más reciente.
Desde WordPress 6.4, register_meta() acepta el argumento revisions_enabled, que guarda los campos personalizados en las revisiones de la entrada (referencia de register_meta). Lo activo en los campos de versión: así queda registrado quién cambió el estado de una versión y cuándo. Ojo, eso registra cambios en los datos, no en los archivos. El archivo de cada versión se conserva aparte y no se borra al publicar otra.
Para el estado uso tres valores y ninguno más: borrador, vigente y sustituida. Un documento retirado del catálogo no desaparece: pasa a sustituido sin sucesor y su página lo dice. Así el enlace impreso en una máquina vendida hace años no termina en un error 404.
Buscar por referencia, no por nombre de archivo
Un distribuidor no busca «ficha técnica serie VX». Busca la referencia que lee en la placa o en el pedido: VX-2540-B. La búsqueda estándar de WordPress no la encuentra si solo está dentro del PDF o en un campo personalizado. La documentación de WP_Query lo deja claro: la búsqueda mira las columnas post_title, post_excerpt y post_content, todas por defecto, y no lee campos personalizados ni el interior de los archivos.
Lo resuelvo de dos maneras, según el tamaño del catálogo:
- Catálogo pequeño o mediano. Cada documento lleva en el extracto la lista de referencias que cubre. La búsqueda estándar las encuentra sin nada más, y el texto del extracto también le sirve al lector para saber si está en el documento correcto.
- Catálogo grande o referencias con variantes. Un campo de referencias con su propia consulta, más filtros por familia, tipo e idioma. El distribuidor escribe la referencia, filtra por idioma y descarga.
En los dos casos, el número de referencia aparece escrito en la página del documento, no solo dentro del PDF. Así la página también sirve a quien llega desde un buscador externo.
Si fabricas máquinas: manuales y declaración UE en línea
Esta parte solo te afecta si fabricas máquinas o productos relacionados en el sentido del Reglamento (UE) 2023/1230 relativo a las máquinas. Según el texto consolidado, con la corrección publicada en el Diario Oficial, se aplica con carácter general desde el 20 de enero de 2027 (artículo 54).
Su artículo 10.7 permite dar las instrucciones de uso en formato digital, pero pone condiciones al fabricante:
- las instrucciones describen claramente el modelo al que corresponden;
- la máquina, o si no es posible su embalaje o un documento adjunto, indica cómo llegar a ellas;
- se ofrecen en un formato que el usuario pueda imprimir, descargar y guardar, para consultarlas también durante una avería;
- siguen accesibles en línea durante la vida útil prevista y al menos 10 años después de la introducción en el mercado;
- si el usuario lo pide en el momento de la compra, el fabricante le da gratis las instrucciones en papel en un plazo máximo de un mes;
- si la máquina puede acabar en manos de un usuario no profesional, la información de seguridad esencial va en papel igualmente.
El artículo 10.8 permite sustituir la declaración UE de conformidad en papel por una dirección de internet o un código legible por máquina indicado en las instrucciones, y exige que la declaración digital siga en línea el mismo tiempo. El artículo 15 pide a los distribuidores que comprueben, antes de vender, que la máquina va acompañada de esa declaración y de las instrucciones en una lengua fácilmente comprensible para los usuarios, según determine el Estado miembro.
Para la web, eso se traduce en decisiones concretas:
- Una dirección que dure más que la web actual. El código QR de la placa no puede apuntar a
/wp-content/uploads/2026/09/manual.pdf, porque esa ruta depende del mes de subida y de la instalación. Apunta a la dirección fija del documento, y yo dejo documentado en tu repositorio cómo mantener esa ruta si algún día cambias de tema o de CMS. - Descarga real, no un visor. Las instrucciones tienen que poder guardarse; un visor incrustado que no deja descargar el PDF no cumple esa condición.
- Las instrucciones de uso, públicas. Las que acompañan a la máquina las necesita también el usuario final. Si las pones detrás del acceso de distribuidores, ese usuario no llega a ellas.
- El modelo, escrito en la página. La página del documento nombra los modelos y referencias que cubre, no solo la familia.
Acceso para distribuidores sin dejar archivos abiertos
Las notas de servicio, las listas de recambios con condiciones o los archivos CAD que solo das a socios van en una zona con acceso. En WordPress eso empieza con un rol propio. El manual de roles y capacidades explica que, tras la primera llamada a add_role(), el rol y sus capacidades quedan guardados en la base de datos, y las llamadas siguientes no hacen nada. Por eso lo creo una sola vez, al activar el plugin de la biblioteca:
add_role( 'distribuidor', 'Distribuidor', array(
'read' => true,
'descargar_documentacion' => true,
) );El rol controla qué páginas ve el distribuidor. No protege el archivo. Un PDF guardado en wp-content/uploads lo sirve directamente el servidor web, sin pasar por WordPress, así que cualquiera que tenga el enlace lo descarga. Y los enlaces se reenvían.
Para que la comprobación de permisos alcance al archivo, guardo los documentos protegidos fuera de la carpeta pública y los entrego a través de PHP. En nginx, una location marcada como internal solo atiende peticiones internas, entre ellas las que llegan redirigidas con la cabecera X-Accel-Redirect (documentación de nginx):
location /documentos-protegidos/ {
internal;
alias /var/www/documentos/;
}$doc = get_post( absint( $_GET['doc'] ?? 0 ) );
if ( ! $doc || 'documento' !== $doc->post_type ) {
status_header( 404 );
exit;
}
if ( ! current_user_can( 'descargar_documentacion' ) ) {
status_header( 403 );
exit;
}
$archivo = get_post_meta( $doc->ID, 'archivo_vigente', true );
header( 'Content-Type: application/pdf' );
header( 'X-Accel-Redirect: /documentos-protegidos/' . rawurlencode( $archivo ) );
exit;El nombre del archivo sale del registro guardado al subirlo, nunca de lo que escribe el visitante en la dirección. Si cada distribuidor solo debe ver ciertas familias, la misma comprobación mira también esa relación antes de entregar el archivo. Si tu alojamiento no usa nginx, la técnica cambia y la reviso con la documentación de tu servidor antes de escribir una línea.
Hay una confusión frecuente con los buscadores. Google explica que, para que no indexe un archivo que no es HTML, como un PDF, se usa la cabecera X-Robots-Tag (especificación de Google). Eso decide si el PDF aparece en los resultados, no quién lo descarga. Las fichas técnicas públicas, en cambio, sí te interesa que Google las encuentre: cada una con su página propia, con título y referencias escritas, y el PDF enlazado desde ahí.
Qué datos guardas de cada distribuidor
Una cuenta de distribuidor es un tratamiento de datos personales: nombre, correo, empresa. El Reglamento (UE) 2016/679, en su artículo 5.1, pide que los datos sean adecuados, pertinentes y limitados a lo necesario, y que no se conserven de forma identificable más tiempo del necesario.
En la práctica, antes de construir te pregunto para qué quieres cada dato. Si quieres saber qué documentos se descargan más, basta un contador por documento. Si tu departamento de calidad necesita saber qué distribuidor descargó qué versión, eso es un registro por persona, y entonces hay que decidir con tu asesor cuánto tiempo se guarda y anotarlo en tu registro de actividades. Construyo lo que decidáis, no más.
Castellano, euskera y los idiomas de tus distribuidores
La Ley 10/1982, básica de normalización del uso del euskera, establece en su artículo 3 que el euskera y el castellano son las lenguas oficiales en la Comunidad Autónoma del País Vasco. Qué documentos publicas en cada idioma, y en cuáles más para tus mercados de exportación, lo decides tú con tu asesor.
Lo que sí resuelvo es que los idiomas no se desincronicen. En la biblioteca, cada idioma de un documento es un archivo con su propio número de versión. La página del documento muestra todos los idiomas disponibles y avisa cuando uno va por detrás: si la ficha en castellano está en la versión 3.2 y la francesa sigue en la 3.0, el distribuidor francés lo ve en la propia página en vez de descubrirlo en una reclamación.
Cómo llevo un encargo de biblioteca técnica
- Me escribes. La dirección de tu web, cuántos documentos calculas, en qué idiomas, si hay distribuidores con acceso y para cuándo lo necesitas.
- Inventario. Te envío una hoja con columnas fijas: referencia, tipo, idioma, versión vigente, fecha, público o restringido. Tu oficina técnica la rellena; ese inventario decide el modelo de datos.
- Alcance por escrito. Qué construyo, qué queda fuera y qué aportas tú. El diseño gráfico y la maqueta de las páginas los aporta tu empresa o tu estudio de diseño; yo los implemento.
- Copia de pruebas. Monto la biblioteca en un entorno de pruebas con una muestra real, por ejemplo una familia de producto completa. Dos o tres distribuidores de confianza la prueban con sus referencias.
- Carga y publicación. Importo el inventario completo, compruebo que cada código QR o enlace impreso que me pases llega a su documento y publico con una vuelta atrás probada.
- Después. La biblioteca sigue con el mantenimiento WordPress en Bilbao si lo quieres. Si necesitas conectarla con tu ERP o tu PLM, eso es desarrollo a medida.
Qué preparas tú
- El inventario de documentos con la versión vigente de cada uno.
- La lista de códigos QR y enlaces ya impresos en placas, embalajes y catálogos.
- Las reglas de acceso: qué tipo de distribuidor ve qué familias.
- El diseño o la maqueta de las páginas de la biblioteca.
- Acceso al alojamiento, o los datos de quien lo gestiona, para la configuración de nginx.
Lista de comprobación para tu biblioteca técnica
Te sirve aunque no me contrates.
| Punto | Cómo se comprueba |
|---|---|
| Cada documento tiene una dirección fija que no depende del mes de subida | Abrir la dirección impresa en un catálogo antiguo |
| Las versiones sustituidas siguen accesibles y marcadas como tales | Página de un documento con dos versiones |
| La búsqueda encuentra una referencia exacta | Buscar la referencia de una placa real |
| Un PDF de la zona de distribuidores no se descarga sin sesión | Pegar su enlace en una ventana privada |
| Un distribuidor no descarga familias que no le corresponden | Probar con una cuenta de prueba de cada tipo |
| Las instrucciones de uso de las máquinas son públicas y descargables | Descargar e imprimir desde el móvil |
| Cada idioma muestra su número de versión | Comparar castellano con otro idioma |
| Los datos de distribuidores tienen un plazo de conservación decidido | Registro de actividades de tratamiento |
Preguntas frecuentes
¿Puedo dejar de imprimir los manuales de mis máquinas y publicarlos solo en la web?
El Reglamento (UE) 2023/1230 permite dar las instrucciones de uso en formato digital, con condiciones: que se puedan imprimir, descargar y guardar, que sigan en línea durante la vida útil prevista y al menos 10 años después de la introducción en el mercado, y que el comprador las reciba gratis en papel en un mes si las pide al comprar. Para máquinas que pueda usar un no profesional, la información de seguridad esencial va en papel. Tu asesor confirma cómo encaja en tus productos.
¿Por qué no basta con subir los PDF a la biblioteca de medios?
Porque la biblioteca de medios no conoce versiones ni estados. Si subes una ficha corregida, WordPress crea un archivo nuevo con otra dirección y la antigua sigue descargándose desde cualquier enlace o correo viejo. Con un tipo de contenido propio, cada documento tiene una dirección fija que muestra siempre la versión vigente y deja las anteriores marcadas como sustituidas.
Si un archivo está en la zona de distribuidores, ¿Google puede encontrarlo?
Si está en wp-content/uploads, cualquiera que tenga el enlace lo descarga, y un enlace se reenvía en un correo. Por eso guardo los archivos protegidos fuera de la carpeta pública y los sirvo solo después de comprobar el permiso. La cabecera X-Robots-Tag con noindex evita que Google indexe un PDF, pero no impide que alguien lo descargue.
¿Los distribuidores pueden ver solo los documentos de las líneas que venden?
Sí. Cada distribuidor tiene una cuenta con un rol propio y, si hace falta, una relación con las familias de producto que vende. La biblioteca filtra el listado y la descarga con la misma regla, para que no baste con adivinar la dirección de un documento.
¿Tengo que publicar la documentación en euskera?
La Ley 10/1982 reconoce el euskera y el castellano como lenguas oficiales en la Comunidad Autónoma del País Vasco. En qué idiomas publicas cada documento es una decisión tuya y de tu asesor. La biblioteca trata cada idioma como un archivo con su propia versión, para que una ficha en euskera no se quede atrás cuando cambia la de castellano.
¿Trabajas con empresas de fuera de Bilbao?
Sí. Trabajo en remoto desde Gdynia y por escrito, igual para una empresa de la margen izquierda que para una de Durangaldea o de fuera de Bizkaia. Todo se resuelve por correo y con documentos compartidos, sin visitas, y la primera estimación que te envío es gratuita.
Escríbeme
Si tu empresa tiene la documentación técnica repartida entre carpetas, correos y una página de descargas que ya nadie controla, escríbeme desde la página de contacto. Cuéntame la dirección de tu web, cuántos documentos y referencias manejas, en qué idiomas, si tienes distribuidores que necesitan acceso y para cuándo lo quieres. Te respondo por escrito, en día laborable, con las preguntas que falten y una primera estimación, que no te cuesta nada.
Proyectos seleccionados
Ejemplos de mi trabajo.
Sztuczne-rosliny.pl - plataforma e-commerce de plantas artificiales premium
Sztuczne-rosliny.pl es una plataforma e-commerce para una empresa polaca especializada en importación y distribución de plantas artificiales de alta calidad.
Vector Solutions - Pionero en Tecnología de Telecomunicaciones
Vector Solutions es una empresa reconocida en Polonia y toda Europa como pionera en el sector tecnológico, transformando las comunicaciones modernas con soluciones innovadoras para operadores de cable y empresas de telecomunicaciones.
WPPoland: reconstrucción de un sitio basado en evidencia para WordPress, Astro y SEO técnico
Estudio de caso guiado por el método sobre la reconstrucción de WPPoland: Astro, contenido Markdown/MDX, seis idiomas, SEO técnico, datos estructurados, AEO/GEO y controles de calidad de contenido.
Soporte y desarrollo WordPress en Bilbao
¿Buscas el servicio: Desarrollador WordPress en Bilbao?
Describe tu proyecto por e-mail. Respondo en 48 horas.
Describe tu proyectoExplora otros servicios WordPress y base de conocimiento
Ingeniería WordPress y arquitectura personalizada.
Arquitectura headless, ERP e IA escalable para enterprise.
Tiendas, checkout y lógica comercial.
Estabilidad, actualizaciones y soporte continuo.
Qué cubre la cuota mensual y qué la cambia.
Automatización de procesos de negocio en torno a WordPress y sistemas empresariales.
Headless WordPress, Sanity, Strapi y Contentful con Astro o Next.js.
Astro, MDX, edge delivery y Core Web Vitals medidos con tráfico real.
Categorías relacionadas
Artículos de apoyo

WordPress 7.0 con AI Client frente a Astro 7 con compilador Rust y Vite 8. Velocidad, coste, SEO y seguridad comparados, más la factura real de mi propia migración desde Astro 6.

WordPress 7.0 con AI Client vs Astro 6 tras la adquisición de Cloudflare. Comparativa de velocidad, coste, SEO y seguridad. Mi opinión tras 20 años como desarrollador WP - cuándo migrar y cuándo quedarse.

Guía de arquitectura para WordPress desacoplado en 2026. Islas Astro 7, Next.js 16, WPGraphQL, vista previa, cache tags en el edge y WordPress 7.1 como origin. El coste está en la guía TCO.