Contrato de generación de QR
El generador de QR resuelve los destinos seleccionados en URLs, los agrupa y renderiza códigos para su descarga. Esta página documenta qué selecciona, qué produce y qué determina su disponibilidad.
Tipos de destino
| Selección | Se resuelve en |
|---|---|
| Inicio | La URL de inicio del sitio, por idioma cuando corresponda |
| Archivo de menú | La URL del archivo del tipo de contenido para ese tipo de menú |
| Archivo de categoría | La URL del archivo del término para esa categoría |
| URL personalizada | La dirección introducida, usada literalmente |
Reglas de disponibilidad
Los archivos de menú aparecen solo cuando el tipo de contenido publica un archivo. El generador resuelve el enlace del archivo y omite cualquier tipo de menú que no tenga ninguno.
Los archivos de categoría se listan para las taxonomías de menú admitidas, cada una etiquetada con el tipo de menú al que pertenece.
Por eso un sitio cuyos tipos de menú no publican sus propios archivos sigue teniendo una cobertura de QR completa: sus archivos de categoría son los menús públicos.
Agrupación por idioma
Los resultados se agrupan, y la agrupación depende de la capa de traducción presente:
| Entorno | Agrupación |
|---|---|
| Polylang activo | Un grupo por idioma, resuelto por idioma |
| POM Translate activo | Un grupo por idioma configurado, localizado a partir de las URLs base |
| Ninguno | Un único grupo predeterminado |
Cada resultado lleva una etiqueta de grupo, un título visible y partes de nombre de archivo, para que los archivos descargados identifiquen su destino y su idioma.
Formatos de salida
Cada resultado ofrece PNG y SVG. El SVG es la forma vectorial y es la elección correcta para imprimir; el PNG es una imagen rasterizada para pantallas.
Los códigos codifican una URL y nada más. No hay parámetro de seguimiento, ni capa de redirección ni analíticas asociadas.
La URL personalizada
Se usa exactamente como se introduce y se valida antes de la generación. Una dirección sin esquema se rechaza en lugar de codificarse.
Una URL personalizada no se localiza: es una dirección literal, por lo que un sitio multilingüe necesita una por idioma si la dirección difiere según el idioma.
Estabilidad de la dirección codificada
Como el código contiene la dirección de destino:
- los cambios de contenido nunca invalidan un código;
- los cambios de dirección siempre lo hacen.
Cambios de dirección que importan: renombrar o eliminar una categoría, retirar un tipo de menú, cambiar el dominio del sitio o reestructurar la página de inicio.
Las integraciones que generan material impreso deberían, por tanto, preferir la página de inicio o un archivo de menú antes que una categoría, y deberían registrar la URL codificada junto con el material gráfico.
Acceso
El generador es una pantalla administrativa que requiere el permiso para editar entradas, y su solicitud de datos está protegida con un nonce. No expone ningún endpoint público para generar códigos.
Orientación
- Resuelve y verifica el destino antes de generar.
- Guarda el SVG como el original de impresión.
- Registra la URL de destino, el idioma y la fecha junto con cada archivo generado.
- Trata un código de categoría como la opción menos duradera.
- No incrustes tokens ni datos de sesión en una URL personalizada; un código impreso es público para siempre.