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

المقدمة

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

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

🎯 ماذا تفعل هذه الوحدة؟​

تتيح لك وحدة خريطة الموقع استرجاع وإعادة (توليد) خريطة الموقع لمشروع OneEntry الخاص بك - وهي قائمة منظمة بجميع الصفحات المستخدمة من قبل محركات البحث لفهرسة محتواك بكفاءة.

تخبر خريطة الموقع محركات البحث بالصفحات الموجودة، مما يساعد Google وBing وغيرها من الزواحف في اكتشاف وفهرسة محتواك بشكل أسرع. يتم تفعيل التوليد بشكل صريح عبر updateSitemap(body)؛ بينما تعيد getSitemap() قائمة بعناوين URL لخريطة الموقع المولدة.

🚀 البدء السريع​

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


const { Sitemap } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

استرجع قائمة بعناوين URL لخريطة الموقع المولدة:

// Returns an array of sitemap URL strings (string[]).
const sitemaps = await Sitemap.getSitemap();

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

✨ المفاهيم الأساسية​

ما هي خريطة الموقع؟​

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

قراءة خريطة الموقع مقابل تحديثها​

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

[
  'https://your-project.oneentry-cloud.com/sitemap.xml',
  'https://your-project.oneentry-cloud.com/sitemap-en.xml'
]

الحقول الخاصة بكل إدخالة url وlastmod وchangefreq وpriority هي خصائص مدخلة لـ ISitemapQuery (المُمررة إلى updateSitemap())، وليست جزءًا من استجابة getSitemap().

قيم تكرار التغيير​

تعتبر هذه القيم جزءًا من مدخل updateSitemap() (changefreq):

القيمةالمعنى
دائمًاتتغير الصفحة في كل مرة يتم الوصول إليها
ساعيًاتتغير الصفحة كل ساعة
يوميًاتتغير الصفحة كل يوم
أسبوعيًاتتغير الصفحة كل أسبوع
شهريًاتتغير الصفحة كل شهر
سنويًاتتغير الصفحة مرة واحدة في السنة
أبدًاصفحة مؤرشفة، لن تتغير

📋 ما تحتاج إلى معرفته​

توليد خريطة الموقع​

يتم توليد خريطة الموقع عندما تستدعي updateSitemap(body)، حيث يوفر body (وهو ISitemapQuery) عناوين baseUrls لكل لغة مستخدمة لبناء عناوين URL. لا يتم إنتاجها تلقائيًا - بل تقوم بتفعيل التوليد بشكل صريح.

استرجاع خريطة الموقع​

استخدم getSitemap() لاسترجاع قائمة بعناوين URL لخريطة الموقع المولدة (string[]).

تقديم إلى محركات البحث​

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

📊 جدول مرجعي سريع​

الطريقةالوصف
getSitemap()احصل على عناوين URL الحالية لخريطة الموقع
updateSitemap()توليد/تحديث خريطة الموقع

❓ الأسئلة الشائعة (FAQ)​

كيف يمكنني تقديم خريطة موقعي إلى Google؟​

قم بتوليد خرائط الموقع باستخدام updateSitemap(body) (مع تمرير baseUrls الخاصة بك)، واسترجع عناوين URL لخريطة الموقع الناتجة باستخدام getSitemap()، ثم قدم عنوان URL لخريطة الموقع في Google Search Console تحت قسم خرائط الموقع.

كم مرة يجب أن أُحدث خريطة موقعي؟​

قم بتحديث خريطة موقعك كلما أضفت صفحات جديدة، أو قمت بتحديث محتوى موجود بشكل كبير، أو غيرت هيكل موقعك. بالنسبة للمواقع ذات الحركة العالية، ضع في اعتبارك التحديثات التلقائية التي يتم تفعيلها بواسطة تغييرات المحتوى.

ماذا يعني حقل الأولوية؟​

الأولوية (من 0.0 إلى 1.0) هي تلميح لمحركات البحث حول الأهمية النسبية للصفحات على موقعك. عادةً ما تكون الصفحة الرئيسية 1.0، وصفحات الفئات 0.8، وصفحات المحتوى الفردية 0.6–0.7. وهي جزء من مدخل updateSitemap() ولا تؤثر على الترتيب بشكل مباشر.

🎓 أفضل الممارسات​

  • إعادة التوليد بعد تغييرات المحتوى - استدعِ updateSitemap() بعد إضافة أو تغيير الصفحات بشكل كبير.
  • تحديد تكرار تغيير دقيق - لا تدعي أن الصفحات تتغير أكثر مما تفعل.
  • استخدام أولويات ذات معنى - الصفحة الرئيسية > الفئات > المنتجات > المشاركات في المدونة.
  • تضمين جميع الصفحات المهمة - لا تستبعد الصفحات التي تريد فهرستها.
  • تقديم بعد التحديثات الكبيرة - قم بإخطار محركات البحث بشكل استباقي عبر أدوات مشرفي المواقع.

🔗 الوثائق ذات الصلة​