 |
ملخص | يتيح لك استيراد خريطة موقع، لربط عناوين الصفحات تلقائيًا بروابط المنتدى، بشكل مشابه لكيفية عمل ميزة “الكلمات المراقبة”. |
 |
رابط المستودع | GitHub - multidimension-al/discourse-sitemap-autolink: Turn sitemaps into automatic links in discourse. · GitHub |
 |
دليل التثبيت | كيفية تثبيت الإضافات في Discourse |
الميزات
هذا بديل لاستخدام ميزة “الكلمات المراقبة”. يتيح لك أخذ خريطة موقع موقعك الإلكتروني الخارجي واستيرادها، وتعيين الكلمات لتطابق تلقائيًا، ثم ربطها خلال عملية إعادة الخبز (rebake) التالية. وهو مشابه جدًا لكيفية عمل الكلمات المراقبة، لكنه يضيف خطوة استيعاب خرائط المواقع واستخراج الكلمات المفتاحية.
مناسب للمنتديات التقنية التي تحتوي على قسم منفصل للموسوعة (Wiki)، على سبيل المثال، أو للمنتدى المرتبط بموقع أخبار أو متجر للتجارة الإلكترونية.
تأخذ خريطة موقع الموسوعة الخاصة بك:
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url><loc>https://www.example.com/wiki/soldering-iron-maintenance</loc><lastmod>2026-07-02</lastmod></url>
<url><loc>https://www.example.com/wiki/mosfet-driver-board</loc><lastmod>2026-07-05</lastmod></url>
<url><loc>https://www.example.com/wiki/li-ion-battery-pack</loc><lastmod>2026-07-11</lastmod></url>
<url><loc>https://www.example.com/wiki/pcb-etching</loc><lastmod>2026-07-19</lastmod></url>
<url><loc>https://www.example.com/wiki/flux</loc><lastmod>2026-07-23</lastmod></url>
</urlset>
سيقوم البرنامج المساعد بتنزيل خريطة الموقع، وجلب العنوان من الصفحة، ثم إنشاء الكلمات للمطابقة. سيتم ربط هذه الكلمات تلقائيًا في المرة التالية التي يتم فيها خبز أي منشورات تحتوي على هذه الكلمات، أو سيقوم البرنامج المساعد بالبحث عن هذه المنشورات وإعادة خبزها تلقائيًا.
العنوان المسترجع <title> |
العنوان المخزن |
|---|---|
| صيانة المكواة - موسوعة مثال | صيانة المكواة |
| لوحة محرك MOSFET - موسوعة مثال | لوحة محرك MOSFET |
| حزمة بطارية ليثيوم أيون - موسوعة مثال | حزمة بطارية ليثيوم أيون |
| نقش لوحات الدوائر المطبوعة - موسوعة مثال | نقش لوحات الدوائر المطبوعة |
| مادة التدفق - موسوعة مثال | مادة التدفق |
تصبح كل من العناوين عبارات مطابقة، مع وجود ضوابط أمان.
| العنوان المخزن | العبارات المُنشأة | الحالة |
|---|---|---|
| صيانة المكواة | صيانة المكواة (s) | نشط |
| لوحة محرك MOSFET | لوحة محرك mosfet (s) | نشط |
| حزمة بطارية ليثيوم أيون | حزمة بطارية li-ion (s) | نشط |
| نقش لوحات الدوائر المطبوعة | نقش pcb (s) | نشط |
| مادة التدفق | مادة التدفق، مواد التدفق | قيد المراجعة — كلمة واحدة قصيرة |
ثم سيتم ربط أي منشور يحتوي على شيء يطابق العبارة تلقائيًا بملف ويكي موقعك، بحد أقصى مرة واحدة لكل منشور.
لذا إذا كان لدي منشور يقول:
كنت أقرأ صفحة صيانة المكواة ولاحظت مشكلة في ما قالته…
سيتم ربط كلمة “صيانة المكواة” بالصفحة المرتبطة بها في خريطة الموقع.
التكوين
بمجرد التثبيت، هناك العديد من الإعدادات التي يمكن تكوينها بالإضافة إلى صفحة كتالوج مخصصة تعرض خرائط المواقع التي يتم استيرادها وقائمة العبارات التي سيتم مطابقتها جنبًا إلى جنب مع عنوان URL.
اعثر على ملف XML لخريطة الموقع الذي تنوي استيراده وتأكد من قدرتك على الاتصال بذلك الخادم دون قيود من تثبيت Discourse الخاص بك. حدد بادئة أو لاحقة الموقع الشائعة وقم بتعيين لاحقات عناوين روابط خريطة الموقع تلقائيًا بالجزء من الحقل الذي لا تريده. قد يكون مثال لذلك هو “- Discourse Meta” إذا كنت لا تريد مطابقة عنوان تلك الصفحة. يمكنك أيضًا تحديد تخطي بعض الكلمات الشائعة التي قد تظهر بشكل متكرر على موقعك. لا تحتاج معظم الإعدادات إلى التفعيل، لكنها تسمح لك بضبط التوقيت والتأخير، وكمية الوقت المسموح به لفحص خريطة الموقع، وكمية الوقت للتأخير بين كل عنوان URL.
بمجرد استيراد عنوان URL، فإنه يحفظ وقت آخر تعديل ولا يتحقق مرة أخرى إلا إذا تغير حقل آخر تعديل. يمكنك تعيين أو حذف العبارات المطابقة يدويًا، وسيسألك تلقائيًا عن المطابقات المكونة من كلمة واحدة.
الإعدادات
الربط
| الإعداد | الافتراضي | الغرض |
|---|---|---|
sitemap_autolink_enabled |
إيقاف | المفتاح الرئيسي. |
sitemap_autolink_max_links_per_destination_per_post |
1 | عدد المرات التي يمكن ربط كل وجهة بها في كل منشور (تفوز الإشارات الأولى). 0 = غير محدود. |
sitemap_autolink_max_links_per_post |
0 | إجمالي الروابط التلقائية لكل منشور. 0 = غير محدود. |
sitemap_autolink_skip_quotes |
تشغيل | عدم الربط داخل المواد المقتبسة أبدًا. |
sitemap_autolink_include_private_messages |
إيقاف | الربط أيضًا في الرسائل الشخصية. |
sitemap_autolink_excluded_categories |
– | عدم الربط في هذه الفئات أبدًا (بما في ذلك الفئات الفرعية). |
sitemap_autolink_enabled_types |
– (الكل) | تقييد أنواع المحتوى التي يمكن أن تحتوي على روابط. |
sitemap_autolink_type_priority |
يدوي |
ترتيب أولوية التصادم، الأقوى أولاً؛ الأنواع غير المدرجة تأتي في المرتبة الأخيرة. |
الكتالوج والعبارات
| الإعداد | الافتراضي | الغرض |
|---|---|---|
sitemap_autolink_sources |
– | خرائط المواقع للاستيعاب، واحدة لكل إدخال: https://example.com/sitemap.xml,content_type. يتم توسيع الفهارس تلقائيًا. |
sitemap_autolink_manual_mappings |
– | قواعد يدوية عبارة، عنوان URL، نوع. تحل العناوين النسبية بالنسبة للمنتدى. |
sitemap_autolink_min_phrase_length |
5 | تذهب العبارات المُنشأة الأقصر للمراجعة. |
sitemap_autolink_min_phrase_words |
2 | تذهب العبارات المُنشأة ذات الكلمات الأقل للمراجعة (معفاة رموز أرقام الطراز المكونة من حرف+رقم). |
sitemap_autolink_generate_plurals |
تشغيل | إنشاء المتغيرات الجمع البسيطة أيضًا. |
sitemap_autolink_title_suffixes |
– | النص القياسي الذي يتم استrippه من نهاية العناوين المسترجعة. لا يمكن أن يحتوي الإدخال على ` |
sitemap_autolink_excluded_url_patterns |
– | عدم استيعاب عناوين URL المتطابقة في خريطة الموقع أبدًا (سلسلة فرعية أو * wildcard، على سبيل المثال */checkout*). |
sitemap_autolink_excluded_terms |
– | عبارات دقيقة يجب عدم إنشاؤها تلقائيًا أبدًا. تتجاوز المستعريات اليدوية. |
المزامنة
| الإعداد | الافتراضي | الغرض |
|---|---|---|
sitemap_autolink_sync_enabled |
إيقاف | تشغيل مهمة خريطة الموقع→الكتالوج اليومية. |
sitemap_autolink_page_fetch_delay_ms |
500 | توقف مهذب بين جلب العناوين (العناوين الجديدة/المعدلة فقط). |
sitemap_autolink_sync_time_budget_minutes |
30 | الحد الأقصى للدقائق لكل تشغيل؛ يتوقف التشغيل بشكل نظيف كـ جزئي ويستأنف التشغيل التالي العمل المتبقي. |
sitemap_autolink_fetch_host_rewrites |
– | جلب مضيف عام عبر هدف داخلي (انظر أدناه). |
إعادة الخبز
| الإعداد | الافتراضي | الغرض |
|---|---|---|
sitemap_autolink_auto_rebake_on_changes |
إيقاف | بعد المزامنة، أعد خبز المنشورات المتأثرة على الأرجح بتغييرات العبارات — مهمة خلفية مجمعة واحدة لكل مزامنة. |
sitemap_autolink_auto_rebake_max_phrases |
50 | إذا غيرت مزامنة واحدة عددًا من العبارات أكبر من هذا، تخطي إعادة الخبز التلقائي بالكامل (لذلك لا يؤدي الاستيراد الأولي أبدًا إلى إعادة خبز كامل المنتدى تقريبًا). |
sitemap_autolink_auto_rebake_max_posts |
500 | معظم المنشورات التي قد تلمسها موجة إعادة الخبز لمزامنة واحدة. |
sitemap_autolink_max_rebakes_per_job_run |
200 | حجم الدفعة لكل تشغيل مهمة؛ تستمر الموجات الأكبر في مهام متابعة مفصولة بدقيقة. |
تحليلات
| الإعداد | الافتراضي | الغرض |
|---|---|---|
sitemap_autolink_analytics_enabled |
تشغيل | إرسال أحداث internal_auto_link_click إلى Google Analytics عبر gtag أو dataLayer عند النقر على الروابط المُنشأة. لا يعمل إذا لم يوجد أي منهما. |
أستخدم هذا للمساعدة في ربط موقعي الإلكتروني الرئيسي بمنتدى Discourse الخاص بي. لذا يمكن لموضوع في الموسوعة أو المتجر الخاص بنا إنشاء رابط تلقائيًا.
إذا كان شخص ما يتحدث عن منتج معين، طالما ذكر كلمة مفتاحية تقوم بتعيينها أو اسم المنتج نفسه، سيتم إضافة الرابط تلقائيًا في وقت الخبز.
وبالمثل، إذا كان لديك موقع ويكي، يمكنك أخذ عناوين صفحات الموسوعة وربطها تلقائيًا. لنفترض أن لديك موقعًا تاريخيًا وشخصًا ما ذكر “حرب 1812”، والتي تتوافق مع مقال موسوعة بنفس الاسم، سيتم ربطه تلقائيًا.
أتمنى أن تستمتع!