 |
Resumen | Te permite importar un sitemap para asignar automáticamente los títulos de las páginas a enlaces del foro, de manera similar a cómo funcionan las ‘Palabras Vigiladas’ (Watched Words). |
 |
Enlace al repositorio | GitHub - multidimension-al/discourse-sitemap-autolink: Turn sitemaps into automatic links in discourse. · GitHub |
 |
Guía de instalación | Cómo instalar plugins en Discourse |
Características
Esta es una alternativa a usar la función ‘Palabras Vigiladas’ (Watched Words). Te permite tomar el sitemap de tu sitio web externo e importarlo, asignar palabras para que coincidan automáticamente y luego enlazarlas durante el próximo rebake (reprocesamiento). Es muy similar a cómo funcionan las Palabras Vigiladas, pero añade el paso de ingerir sitemaps y extraer las palabras clave.
Es ideal para foros técnicos con una sección de Wiki separada, por ejemplo, o para un foro con una tienda de noticias o comercio electrónico asociada.
Tomas el sitemap de tu Wiki:
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url><loc>https://www.example.com/wiki/soldering-iron-maintenance</loc><lastmod>2026-07-02</lastmod></url>
<url><loc>https://www.example.com/wiki/mosfet-driver-board</loc><lastmod>2026-07-05</lastmod></url>
<url><loc>https://www.example.com/wiki/li-ion-battery-pack</loc><lastmod>2026-07-11</lastmod></url>
<url><loc>https://www.example.com/wiki/pcb-etching</loc><lastmod>2026-07-19</lastmod></url>
<url><loc>https://www.example.com/wiki/flux</loc><lastmod>2026-07-23</lastmod></url>
</urlset>
El plugin descargará el sitemap, obtendrá el título de la página y luego generará las palabras para coincidir. Estas se enlazarán automáticamente la próxima vez que se procesen publicaciones que contengan esas palabras, o el plugin buscará esas publicaciones y las reprocesará automáticamente.
<title> obtenido |
Título almacenado |
|---|---|
| Mantenimiento de soldador - Wiki de ejemplo | Mantenimiento de soldador |
| Placa controladora MOSFET - Wiki de ejemplo | Placa controladora MOSFET |
| Batería de iones de litio - Wiki de ejemplo | Batería de iones de litio |
| Grabado de PCB - Wiki de ejemplo | Grabado de PCB |
| Flux - Wiki de ejemplo | Flux |
Cada uno de los títulos se convierte en la frase de coincidencia, con medidas de seguridad.
| Título almacenado | Frases generadas | Estado |
|---|---|---|
| Mantenimiento de soldador | mantenimiento de soldador(es) | activo |
| Placa controladora MOSFET | placa controladora mosfet(es) | activo |
| Batería de iones de litio | batería de iones de litio(es) | activo |
| Grabado de PCB | grabado de pcb(es) | activo |
| Flux | flux, fluxes | pendiente de revisión — palabra corta y única |
Luego, cualquier publicación que contenga algo que coincida con la frase enlazará automáticamente de vuelta a la wiki de tu sitio, un máximo de 1 vez por publicación.
Así que si tengo una publicación que dice:
Estaba leyendo la página Mantenimiento de soldador y noté un problema con lo que decía…
La palabra ‘Mantenimiento de soldador’ se enlazará a la página asociada con ella en el sitemap.
Configuración
Una vez instalado, hay muchos ajustes que se pueden configurar, así como una página de Catálogo dedicada que muestra tus sitemaps siendo importados y la lista de frases que se coincidirán junto con la URL.
Busca el archivo XML del sitemap que planeas importar y asegúrate de poder conectarte a ese servidor sin limitaciones desde tu instalación de Discourse. Localiza el prefijo o sufijo común del sitio y establece los sufijos de título de enlace automático de sitemap con la parte del campo que no deseas. Un ejemplo podría ser “- Discourse Meta” si quisieras que no coincidiera con ese título de página. También puedes especificar que se omitan ciertas palabras comunes que pueden aparecer frecuentemente en tu sitio. La mayoría de los ajustes no necesitan estar habilitados, pero te permiten ajustar el tiempo y el retraso, cuánto tiempo se permite gastar verificando el sitemap y cuánto tiempo retrasar entre cada URL.
Una vez que la URL ha sido importada, guarda la hora de lastmod y no vuelve a verificar a menos que el campo lastmod cambie. Puedes asignar o eliminar manualmente frases de coincidencia, y te preguntará automáticamente sobre coincidencias de una sola palabra.
Ajustes
Enlazado
| Ajuste | Predeterminado | Propósito |
|---|---|---|
sitemap_autolink_enabled |
desactivado | Interruptor principal. |
sitemap_autolink_max_links_per_destination_per_post |
1 | Veces que cada destino puede enlazarse por publicación (ganan las primeras menciones). 0 = ilimitado. |
sitemap_autolink_max_links_per_post |
0 | Total de enlaces automáticos por publicación. 0 = ilimitado. |
sitemap_autolink_skip_quotes |
activado | Nunca enlazar dentro de material citado. |
sitemap_autolink_include_private_messages |
desactivado | También enlazar en mensajes personales. |
sitemap_autolink_excluded_categories |
– | Nunca enlazar en estas categorías (incluidas las subcategorías). |
sitemap_autolink_enabled_types |
– (todos) | Restringir qué tipos de contenido pueden enlazarse. |
sitemap_autolink_type_priority |
manual |
Orden de prioridad de colisión, del más fuerte al primero; los tipos no listados quedan al final. |
Catálogo y frases
| Ajuste | Predeterminado | Propósito |
|---|---|---|
sitemap_autolink_sources |
– | Sitemaps a ingerir, uno por entrada: https://example.com/sitemap.xml,content_type. Los índices se expanden automáticamente. |
sitemap_autolink_manual_mappings |
– | Reglas manuales frase,url,tipo. Las URLs relativas se resuelven contra el foro. |
sitemap_autolink_min_phrase_length |
5 | Las frases generadas más cortas van a revisión. |
sitemap_autolink_min_phrase_words |
2 | Las frases generadas con menos palabras van a revisión (tokens de modelo de letra+dígito exentos). |
sitemap_autolink_generate_plurals |
activado | También generar variantes plurales simples. |
sitemap_autolink_title_suffixes |
– | Texto estándar eliminado del final de los títulos obtenidos. Una entrada no puede contener ` |
sitemap_autolink_excluded_url_patterns |
– | Nunca ingerir URLs de sitemap coincidentes (subcadena o comodín *, ej. */checkout*). |
sitemap_autolink_excluded_terms |
– | Frases exactas que nunca deben generarse automáticamente. Los alias manuales anulan. |
Sincronización
| Ajuste | Predeterminado | Propósito |
|---|---|---|
sitemap_autolink_sync_enabled |
desactivado | Ejecutar el trabajo diario sitemap→catálogo. |
sitemap_autolink_page_fetch_delay_ms |
500 | Pausa de cortesía entre obtenciones de títulos (solo URLs nuevas/cambiadas). |
sitemap_autolink_sync_time_budget_minutes |
30 | Minutos máximos por ejecución; la ejecución se detiene limpiamente como Parcial y la siguiente ejecución reanuda el trabajo restante. |
sitemap_autolink_fetch_host_rewrites |
– | Obtener un host público a través de un destino interno (ver abajo). |
Reprocesamiento (Rebaking)
| Ajuste | Predeterminado | Propósito |
|---|---|---|
sitemap_autolink_auto_rebake_on_changes |
desactivado | Después de una sincronización, reprocesar publicaciones probablemente afectadas por cambios de frase — un trabajo de fondo agrupado por sincronización. |
sitemap_autolink_auto_rebake_max_phrases |
50 | Si una sincronización cambia más frases que esto, omitir el reprocesamiento automático por completo (para que una importación inicial no active un reprocesamiento casi completo del foro). |
sitemap_autolink_auto_rebake_max_posts |
500 | La mayoría de publicaciones que una ola de reprocesamiento de sincronización puede tocar. |
sitemap_autolink_max_rebakes_per_job_run |
200 | Tamaño del lote por ejecución de trabajo; olas más grandes continúan en trabajos de seguimiento separados por un minuto. |
Analíticas
| Ajuste | Predeterminado | Propósito |
|---|---|---|
sitemap_autolink_analytics_enabled |
activado | Enviar eventos internal_auto_link_click a Google Analytics vía gtag o dataLayer cuando se hacen clic en los enlaces generados. Sin efecto si ninguno existe. |
Uso esto para ayudar a enlazar mi sitio web principal con mi foro de Discourse. Así, un tema en nuestra Wiki o Tienda puede generar automáticamente un enlace.
Si alguien está hablando sobre un producto en particular, siempre y cuando mencionen una palabra clave que asignes o el nombre del producto en sí, el enlace se añadirá automáticamente en el momento del procesado.
De manera similar, si tienes un sitio de Wiki, puedes tomar los títulos de las páginas de la Wiki y enlazarlos automáticamente. Digamos que tienes un sitio de historia y alguien menciona ‘La Guerra de 1812’, que coincide con un artículo de la Wiki del mismo nombre, se enlazará automáticamente.
¡Espero que lo disfrutes!