انتقل إلى المحتوى الرئيسي

Sitemap

اجلب خريطة موقع مشروعك وأعد إنشاءها حتى تتمكن محركات البحث من اكتشاف صفحاتك وفهرستها.

مزيد من المعلومات حول واجهة مستخدم الوحدة: https://doc.oneentry.cloud/docs/category/sitemap (يفتح في علامة تبويب جديدة)

تجلب وحدة Sitemap خريطة موقع مشروع OneEntry الخاص بك وتعيد إنشاءها. تُنشئها updateSitemap(body)، وتُعيد getSitemap() عناوين URL لملفات خريطة الموقع المُنشأة.

بدء سريع​

قم بتهيئة الوحدة من defineOneEntry:


const {  } = defineOneEntry(
  , {
    
  }
);

اجلب عناوين URL لملفات خريطة الموقع المُنشأة:

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

القراءة والإنشاء​

تُعيد getSitemap() مصفوفة من عناوين URL لملفات خريطة الموقع (string[])، مثلًا:

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

لا تُنشأ خريطة الموقع تلقائيًا. استدعِ updateSitemap(body) بعد إضافة صفحات أو تغييرها تغييرًا كبيرًا، أو بعد تغيير بنية الموقع.

لا تقرأ updateSitemap() سوى body.baseUrls: كائن يربط كل رمز لغة نشطة بعنوان URL الأساسي العام للموقع بتلك اللغة، مثل { en_US: "https://example.com/", ru_RU: "https://example.com/ru/" }. يجب أن يكون كل مفتاح رمز لغة نشطة، وإلا يفشل الاستدعاء بالخطأ 400 (Invalid or inactive locale). ضمّن en_US: يصبح عنوان URL الخاص به <loc> لكل إدخال، وتُضاف اللغات الأخرى روابطَ بديلة hreflang. لا تكتب المنصة lastmod أو changefreq أو priority، لذا لا تأثير لحقول ISitemapQuery الأخرى (url وlastmod وchangefreq وpriority).

تسرد خريطة الموقع كل صفحة لها عنوان URL، إضافةً إلى كل منتج تحت كل صفحة كتالوج ينتمي إليها. يحذف كل تشغيل الملفات المُنشأة سابقًا ويكتب ملفات جديدة، بما يصل إلى 50,000 عنوان URL لكل ملف (sitemap-000.xml وsitemap-001.xml و…).

الإرسال إلى محركات البحث​

لا ترسل الوحدة خريطة الموقع إلى محركات البحث. أنشئها باستخدام updateSitemap(body)، واجلب عناوين URL للملفات باستخدام getSitemap()، ثم أرسلها في Google Search Console (ضمن Sitemaps) أو Bing Webmaster Tools.

الطرق​

الطريقةالوصف
getSitemap()جلب عناوين URL لملفات خريطة الموقع
updateSitemap()إعادة إنشاء خريطة الموقع

ذات صلة​