Saltar al contenido principal

Sitemap

Obtén y regenera el sitemap de tu proyecto para que los buscadores puedan descubrir e indexar tus páginas.

Más información sobre la interfaz de usuario del módulo: https://doc.oneentry.cloud/docs/category/sitemap (abre en una nueva pestaña)

El módulo Sitemap obtiene y regenera el sitemap de tu proyecto de OneEntry. updateSitemap(body) lo genera, y getSitemap() se resuelve en las URL de los archivos del sitemap generado.

Inicio rápido​

Inicializa el módulo desde defineOneEntry:


const {  } = defineOneEntry(
  , {
    
  }
);

Obtén las URL de los archivos del sitemap generado:

// Resolves to an array of sitemap file URLs (string[]).
const sitemaps = await Sitemap.getSitemap();
if ('statusCode' in sitemaps) throw new Error(sitemaps.message);

sitemaps.forEach((url) => {
  console.log(url);
});

Lectura y generación​

getSitemap() se resuelve en un array de URL de archivos del sitemap (string[]), por ejemplo:

[
  'https://your-project.oneentry.cloud/cloud-static/files/project/sitemap/sitemap-000.xml'
]

El sitemap no se genera automáticamente. Llama a updateSitemap(body) después de añadir o cambiar significativamente páginas, o después de cambiar la estructura del sitio.

updateSitemap() solo lee body.baseUrls: un objeto que asigna a cada código de idioma activo la URL base pública del sitio para ese idioma, por ejemplo { en_US: "https://example.com/", ru_RU: "https://example.com/ru/" }. Cada clave debe ser un código de idioma activo, o la llamada falla con un error 400 (Invalid or inactive locale). Incluye en_US: su URL se convierte en el <loc> de cada entrada, y los demás idiomas se añaden como enlaces alternativos hreflang. La plataforma no escribe lastmod, changefreq ni priority, así que los demás campos de ISitemapQuery (url, lastmod, changefreq, priority) no tienen efecto.

El sitemap enumera cada página que tiene una URL, además de cada producto bajo cada página de catálogo a la que pertenece. Cada ejecución elimina los archivos generados anteriormente y escribe otros nuevos, con hasta 50.000 URL por archivo (sitemap-000.xml, sitemap-001.xml, …).

Envío a los motores de búsqueda​

El módulo no envía el sitemap a los buscadores. Genéralo con updateSitemap(body), obtén las URL de los archivos con getSitemap() y envíalas en Google Search Console (en Sitemaps) o en Bing Webmaster Tools.

Métodos​

MétodoDescripción
getSitemap()Obtener las URL de los archivos del sitemap
updateSitemap()Regenerar el sitemap

Relacionado​