Aller au contenu principal

Sitemap

Récupérez et régénérez le sitemap de votre projet pour que les moteurs de recherche découvrent et indexent vos pages.

Plus d'informations sur l'interface utilisateur du module : https://doc.oneentry.cloud/docs/category/sitemap (ouvre dans un nouvel onglet)

Le module Sitemap récupère et régénère le sitemap de votre projet OneEntry. updateSitemap(body) le génère, et getSitemap() renvoie les URL des fichiers sitemap générés.

Démarrage rapide​

Initialisez le module à partir de defineOneEntry :


const {  } = defineOneEntry(
  , {
    
  }
);

Récupérer les URL des fichiers sitemap générés :

// 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);
});

Lecture et génération​

getSitemap() renvoie un tableau d'URL de fichiers sitemap (string[]), par exemple :

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

Le plan du site n'est pas généré automatiquement. Appelez updateSitemap(body) après avoir ajouté ou modifié de façon importante des pages, ou après avoir modifié la structure du site.

updateSitemap() ne lit que body.baseUrls : un objet qui associe chaque code de locale active à l'URL de base publique du site pour cette langue, par exemple { en_US: "https://example.com/", ru_RU: "https://example.com/ru/" }. Chaque clé doit être un code de locale active, sinon l'appel échoue avec une erreur 400 (Invalid or inactive locale). Incluez en_US : son URL devient le <loc> de chaque entrée, et les autres locales sont ajoutées comme liens alternatifs hreflang. La plateforme n'écrit ni lastmod, ni changefreq, ni priority : les autres champs de ISitemapQuery (url, lastmod, changefreq, priority) n'ont donc aucun effet.

Le plan du site liste chaque page qui a une URL, ainsi que chaque produit sous chaque page de catalogue à laquelle il appartient. Chaque exécution supprime les fichiers générés précédemment et en écrit de nouveaux, jusqu'à 50 000 URL par fichier (sitemap-000.xml, sitemap-001.xml, …).

Soumission aux moteurs de recherche​

Le module ne soumet pas le sitemap aux moteurs de recherche. Générez-le avec updateSitemap(body), récupérez les URL des fichiers avec getSitemap(), puis soumettez-les dans Google Search Console (rubrique Sitemaps) ou dans Bing Webmaster Tools.

Méthodes​

MéthodeDescription
getSitemap()Récupérer les URL des fichiers sitemap
updateSitemap()Régénérer le sitemap

Voir aussi​