Mapa del Sitio XML y Hreflang (@vicacha-devs/strapi-plugin-sitemap)
Package:
@vicacha-devs/strapi-plugin-sitemap· Plugin ID:sitemap· Category:Editorial & SEO· Version:1.2.1· Routes:7
Generador automático de Sitemap XML e Índice de Sitemaps para Strapi v5 con enlaces alternativos hreflang multilingües, URLs estáticas y hoja de estilo XSL.
pnpm add @vicacha-devs/strapi-plugin-sitemap

1. Características Principales y Arquitectura
Sección titulada «1. Características Principales y Arquitectura»- Explorar Entidades Content-Type y Casos de Uso (con Diagramas Interactivos)
- Explorar la Guía de Desarrollo y Admin UI
- Explorar la Referencia Interactiva OpenAPI
2. Entidades Content-Type, Ubicación y Esquemas (strapi.documents)
Sección titulada «2. Entidades Content-Type, Ubicación y Esquemas (strapi.documents)»Registers two internal Collection Types (plugin::sitemap.sitemap-content-type and plugin::sitemap.sitemap-content-type-single-url) and one Single Type (plugin::sitemap.sitemap-option) with content-manager.visible: false, while introspecting all public api::* and plugin::* Content-Type entities to generate /api/sitemap/sitemap.xml and /api/sitemap/sitemap-{slug}.xml.
Dónde Encontrar las Entidades Content-Type en Strapi v5
Sección titulada «Dónde Encontrar las Entidades Content-Type en Strapi v5»- Settings Panel (4 Tabs):
/admin/settings/sitemap(Settings -> Sitemap -> Configuration— organized into General & Sitemap Index, Collection Types, Custom URLs, and Excluded URLs tabs) - Internal Persistence Entities:
plugin::sitemap.sitemap-content-type(strapi_5_sitemap_plugin_content_types),plugin::sitemap.sitemap-content-type-single-url(strapi_5_sitemap_plugin_content_type_single_urls), andplugin::sitemap.sitemap-option(strapi_5_sitemap_plugin_options)
plugin::sitemap.sitemap-content-type — Sitemap Content Type
Sección titulada «plugin::sitemap.sitemap-content-type — Sitemap Content Type»Per-locale URL pattern, priority, and changefreq mapping for a Strapi Content-Type entity
Kind:
collectionType· DB Table:strapi_5_sitemap_plugin_content_types· Admin Location: Internal (/admin/plugins/sitemap) · Draft & Publish:No· i18n:No
| Atributo | Tipo en Strapi | Requerido | Restricciones / Relación |
|---|---|---|---|
type |
string |
No | — |
langcode |
string |
No | — |
pattern |
string |
No | — |
priority |
float |
No | — |
frequency |
string |
No | — |
lastModified |
string |
No | — |
thumbnail |
string |
No | — |
populateLinkedModels |
string |
No | — |
plugin::sitemap.sitemap-content-type-single-url — Sitemap Single URL
Sección titulada «plugin::sitemap.sitemap-content-type-single-url — Sitemap Single URL»Custom static URL entry included alongside dynamic CMS entries in sitemap.xml
Kind:
collectionType· DB Table:strapi_5_sitemap_plugin_content_type_single_urls· Admin Location: Internal (/admin/plugins/sitemap) · Draft & Publish:No· i18n:No
| Atributo | Tipo en Strapi | Requerido | Restricciones / Relación |
|---|---|---|---|
slug |
string |
No | — |
priority |
float |
No | — |
frequency |
string |
No | — |
plugin::sitemap.sitemap-option — Sitemap Options
Sección titulada «plugin::sitemap.sitemap-option — Sitemap Options»Global sitemap configuration (baseUrl, excludedUrls, useSitemapIndex, sitemapDefinitions)
Kind:
singleType· DB Table:strapi_5_sitemap_plugin_options· Admin Location: Internal (/admin/plugins/sitemap) · Draft & Publish:No· i18n:No
| Atributo | Tipo en Strapi | Requerido | Restricciones / Relación |
|---|---|---|---|
baseUrl |
string |
No | — |
excludedUrls |
json |
No | default: [] |
useSitemapIndex |
boolean |
No | default: false |
sitemapDefinitions |
json |
No | default: [] |
Integración con el Content Manager de Strapi v5 (/admin/content-manager)
Sección titulada «Integración con el Content Manager de Strapi v5 (/admin/content-manager)»Grupo en la Barra Lateral del Content Manager:
Maps All Public Content Manager Collection Types & Single Types
Entidades y Componentes en el Content Manager
Sección titulada «Entidades y Componentes en el Content Manager»plugin::sitemap.sitemap-content-type(Internal URL pattern mapping for Content Manager entities)plugin::sitemap.sitemap-content-type-single-url(Internal custom static URL entries)plugin::sitemap.sitemap-option(Internal global sitemap settings)

Por Qué Este Plugin Crea e Integra Entidades en el Content Manager
Sección titulada «Por Qué Este Plugin Crea e Integra Entidades en el Content Manager»@vicacha-devs/strapi-plugin-sitemap keeps its 3 configuration schemas (sitemap-content-type, sitemap-content-type-single-url, sitemap-option) hidden from the Content Manager sidebar (content-manager.visible: false) to prevent accidental schema edits, while dynamically reading published documents and i18n localizations from every public Content Manager Collection Type (api::* and plugin::*):
- Automatic Sync with Content Manager Publishing: Whenever an editor publishes, updates, or unpublishes an
Article,Event,Donation Campaign, orResource Publicationin Content Manager,/api/sitemap/sitemap.xmlautomatically reflects itslastmodandxhtml:linkhreflangalternates.
Cómo Usarlo en el Content Manager de Strapi (Paso a Paso)
Sección titulada «Cómo Usarlo en el Content Manager de Strapi (Paso a Paso)»- Publish Content in Content Manager: Author and publish localized entries in any
api::*orplugin::*collection inside/admin/content-manager. - Map URL Patterns in Sitemap Settings: Open
/admin/settings/sitemap-> Collection Types tab and bind each Content Manager collection UID + locale to its frontend route pattern (e.g.,/[locale]/articles/[slug]). - Configure Sitemap Index, Custom & Excluded URLs: Use the General & Sitemap Index tab (
Use sitemap index with multiple sitemaps+getSitemapBySlug in Users & Permissions → Public → Sitemap), Custom URLs tab, and Excluded URLs tab in/admin/settings/sitemap.
Sincronización entre el Content Manager y el Espacio del Plugin
Sección titulada «Sincronización entre el Content Manager y el Espacio del Plugin»Casos de Uso en el Content Manager y Flujos Editoriales
Sección titulada «Casos de Uso en el Content Manager y Flujos Editoriales»Content Manager Use Case 1 — Auto-Syndicating Published Content Manager Entries to Multilingual XML Sitemaps
Sección titulada «Content Manager Use Case 1 — Auto-Syndicating Published Content Manager Entries to Multilingual XML Sitemaps»- Para qué sirve y por qué usarlo: Ensure every newly published localized Event, Article, or Publication in Content Manager is immediately indexed with
hreflangalternates. - Cómo ejecutarlo en el Content Manager: Publish the entry across
es,en,ar, andtrin/admin/content-managerand verify its<url>block inGET /api/sitemap/sitemap.xml.
3. Casos de Uso y Flujos de Trabajo
Sección titulada «3. Casos de Uso y Flujos de Trabajo»Use Case 1 — Dynamic Multilingual Entity URL Pattern Mapping & xhtml:link Hreflang
Sección titulada «Use Case 1 — Dynamic Multilingual Entity URL Pattern Mapping & xhtml:link Hreflang»- What it is for: Map any localized Strapi Content-Type entity (
api::article.article,plugin::events.event,plugin::resources.publication) to dynamic URL patterns with automatichreflangalternates. - How it works: In
/admin/settings/sitemap(Collection Types tab), map a content type +langcodeto a pattern (e.g.,/[locale]/articles/[slug]),priority, andfrequency(plugin::sitemap.sitemap-content-type).

Use Case 2 — Hybrid Static + CMS Sitemap with Custom Single URLs & Excluded Paths
Sección titulada «Use Case 2 — Hybrid Static + CMS Sitemap with Custom Single URLs & Excluded Paths»- What it is for: Include static frontend routes (
/es,/es/about-us,/en/about-us) alongside dynamic CMS entries in the same XML sitemap while excluding internal paths (/admin,/api,/404). - How it works: Add static route entries in the Custom URLs tab (
plugin::sitemap.sitemap-content-type-single-url) and exclude internal routes in the Excluded URLs tab of/admin/settings/sitemap.

Use Case 3 — Multi-File Sitemap Index (sitemap-{slug}.xml) for Large Sites
Sección titulada «Use Case 3 — Multi-File Sitemap Index (sitemap-{slug}.xml) for Large Sites»- What it is for: Split large portals into dedicated sub-sitemaps (e.g.,
/api/sitemap/sitemap-pages.xml,/api/sitemap/sitemap-editorial-and-library.xml,/api/sitemap/sitemap-events-and-liturgy.xml) referenced by a master<sitemapindex>. - How it works: Enable Use sitemap index with multiple sitemaps (
useSitemapIndex: true), grantgetSitemapBySluginUsers & Permissions → Public → Sitemap, and definesitemapDefinitionsin the General & Sitemap Index tab of/admin/settings/sitemap(PUT /sitemap/settings).

4. Endpoints REST API (content-api y admin)
Sección titulada «4. Endpoints REST API (content-api y admin)»| Método | Ruta del Endpoint | Ámbito | Controlador | Autenticación |
|---|---|---|---|---|
GET |
/api/sitemap/sitemap.xml |
content-api |
controller.getSitemap |
Bearer JWT |
GET |
/api/sitemap/sitemap-{slug}.xml |
content-api |
controller.getSitemapBySlug |
Bearer JWT |
GET |
/sitemap/settings |
admin |
controller.getSettings |
Bearer JWT |
PUT |
/sitemap/settings |
admin |
controller.updateSettings |
Bearer JWT |
GET |
/sitemap/content-types |
admin |
controller.getContentTypes |
Bearer JWT |
GET |
/sitemap/locales |
admin |
controller.getLocales |
Bearer JWT |
GET |
/sitemap/allowed-fields |
admin |
controller.getAllowedFields |
Bearer JWT |