Advanced Importer الملحق

استخدم Advanced Importer الملحق هي أداة احترافية مصممة لجعل عملية ترحيل ومزامنة بيانات الأحداث سلسة من خلال الربط Modern Events Calendar (ميك) إلى منصات الطرف الثالث الرئيسية 1. يسمح لك بتوثيق حساباتك من خدمات مثل فيسبوك وجوجل وإيفنت برايت ببضع نقرات فقط، مما يتيح لك جدولة عمليات الاستيراد التلقائية أو إجراء عمليات نقل جماعية من إضافات أحداث ووردبريس الأخرى.

الإعداد الأولي

لبدء استيراد الأحداث، تأكد من أن بيئتك تفي بالمتطلبات اللازمة واتبع خطوات التفعيل التالية:

متطلبات الدراسة

• MEC Lite أو Pro: على عكس العديد من الإضافات الأخرى، فإن Advanced Importer متوافق مع كل من الإصدارين Lite و Pro من Modern Events Calendar.
• التنشيط: تأكد من كليهما Modern Events Calendar و مبادئ السلوك Advanced Importer تم تثبيت الإضافات وتفعيلها على موقع ووردبريس الخاص بك.

الوصول إلى المستورد

1. تحديد موقع القائمة: بمجرد التفعيل، ستظهر قائمة جديدة تحمل اسم Advanced Importer سيظهر تحت تقويم ME قسم في لوحة معلومات WordPress الخاصة بك.
2. إعادة التوجيه: سيؤدي النقر على هذه القائمة إلى نقلك مباشرة إلى واجهة الاستيراد الرئيسية.

إعدادات النظام الأساسي (التهيئة)

قبل الاستيراد، يجب عليك ربط حساباتك الخارجية والتحقق من صحتها داخل Advanced Importer الإعدادات.

• الفيسبوك: يجب عليك تقديم عنوان URL مخصص في عناوين URI لإعادة التوجيه OAuth الصالحة قم بتمرير الحقل الموجود على بوابة مطوري فيسبوك للمتابعة.

• Eventbrite: يتطلب برنامجًا مجانيًا مفتاح APIوالتي يمكن الحصول عليها من منصة Eventbrite بعد تسجيل الدخول إلى حسابك.

• ميتوب: يتطلب عميل OAuth بيانات الاعتماد (معرف العميل والسر) من صفحة عملاء Meetup OAuth؛ لاحظ أن تفعيل بيانات الاعتماد هذه قد يستغرق ما يصل إلى ساعتين.

• تقويم Google: يجب عليك إنشاء مفتاح واجهة برمجة تطبيقات تقويم جوجل وتقديم عنوان URI لإعادة التوجيه المعتمد إلى جوجل لتمكين الاتصال.

بعد إكمال الخطوات اللازمة حسب التوجيهات، سوف تتلقى مفتاح API الخاص بك.

ملاحظة: بدءًا من الإصدار 1.8.0، يقوم الملحق تلقائيًا بتحديث رموز الوصول إلى حساب جوجل المنتهية الصلاحية قبل كل عملية استيراد ومزامنة مجدولة، مما يضمن استمرار الاتصال دون الحاجة إلى إعادة المصادقة بشكل دوري. ولا يلزم إعادة المصادقة يدويًا إلا في حال إلغاء وصول التطبيق من حساب جوجل الخاص بك أو تغيير بيانات اعتماد OAuth.

• واجهة برمجة تطبيقات MEC: يتيح لك هذا استيراد الأحداث من موقع ويب آخر باستخدام MEC 9. يجب عليك نسخ عنوان URL من موقع الويب المصدر وإدخاله مع مفتاح API في إعدادات الموقع الإلكتروني المستهدف.

ملاحظاتلاستخدام هذه الميزة، تأكد من موقع المصدر لديها أيضا Advanced Importer الإضافة مُفعّلة. يجب عليك الانتقال إلى موقع المصدر لنسخ عنوان URL المخصص ومفتاح API قبل إدخالهما في موقع الويب المستهدف الإعدادات.

هام: في الإصدار 1.8.0، يعرض حقل "رمز واجهة برمجة تطبيقات MEC" في الموقع المصدر الآن الرمز الصحيح المستخدم من قِبل واجهة برمجة تطبيقات REST. إذا كنت قد قمتَ بتهيئة موقع مستهدف قبل هذا الإصدار، فأعد نسخ الرمز من إعدادات الموقع المصدر للتأكد من تطابق الموقعين.

إجراء عملية استيراد

بعد إعداد حساباتك، يجب عليك التحقق من صحة ملفات تعريف محددة لبدء جلب البيانات.

المصادقة والاختيار

1. طلب ​​المصادقة: في أسفل علامة تبويب الإعدادات لكل منصة، ابحث عن اسم المستخدم الخاص بك وانقر فوق " طلب المصادقة" لفتح نافذة تسجيل الدخول ومنح الوصول إلى أحداثك.

٢. تصنيف البيانات: لتصنيف عملية استيراد ضمن فئة محددة، انتقل إلى "استيراد جديد" > "خيارات الاستيراد " واختر الفئة المطلوبة. بدءًا من الإصدار ١.٨.٠، يتم تطبيق الفئة المختارة تلقائيًا على الأحداث المستوردة وعلى عمليات الاستيراد المجدولة/مهام المزامنة.

3. تصفية البيانات: يمكنك استخدام معرّفات أحداث محددة لاستيراد البيانات المستهدفة، أو تحديد نطاق زمني لتاريخي البدء والانتهاء لجلب الأحداث من فترة زمنية معينة فقط. بالنسبة لاستيراد البيانات من Eventbrite، يتطابق النطاق الزمني الآن مع الأحداث التي يقع تاريخ بدايتها ضمن الفترة الزمنية المحددة.

ملاحظة: يستخدم نطاق تاريخ الاستيراد تاريخ انتهاء حصري . هذا يعني أن تاريخ الانتهاء المحدد نفسه غير مُدرج في نطاق الاستيراد. إذا كنت ترغب في تضمين أحداث من يوم محدد، فعيّن تاريخ الانتهاء إلى اليوم التالي.

إمكانية رؤية الحدث (Eventbrite)

يُتيح لك خيار "رؤية الحدث" الجديد في الإصدار 1.8.0 تصفية أحداث Eventbrite حسب مستوى ظهورها في القائمة قبل الاستيراد:

• للجمهور فقط: يستورد فقط الأحداث المدرجة علنًا والتي يمكن البحث عنها على موقع Eventbrite (افتراضيًا).
• خاص فقط: يستورد فقط الأحداث الخاصة (غير المدرجة) المخفية عن بحث Eventbrite.
• عام وخاص: يستورد جميع الأحداث من حسابك بغض النظر عن مستوى الرؤية.

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

ملاحظة: إذا قمت بالترقية من إصدار أقدم وكان Eventbrite الخاص بك يقوم بمزامنة الأحداث غير المدرجة التي تم استيرادها مسبقًا، فقم بتعيين رؤية الحدث إلى عام وخاص بعد التحديث، حيث أن عمليات الاستيراد الجديدة تكون افتراضيًا عامة فقط.

علامات Eventbrite

ابتداءً من الإصدار 1.8.0، يتم استيراد علامات النشر (كلمات البحث) التي تُضيفها إلى الأحداث في Eventbrite تلقائيًا، وتُضاف إلى أحداث MEC الخاصة بك كعلامات WordPress/MEC . هذا يُسهّل عملية تصفية وعرض الأحداث المُستوردة باستخدام كلمات Eventbrite الرئيسية.

أنواع الاستيراد

• خطوة واحدة: يقوم هذا الخيار بتنفيذ عملية الاستيراد فوراً.
• المقرر: يؤدي هذا إلى أتمتة العملية بترددات تتراوح من مرة كل ساعة إلى مرة في الشهر.

جهة تحديث الحدث

يحدد خيار " سلطة تحديث الحدث" كيفية تحديث الأحداث المستوردة أثناء المزامنة المجدولة عندما يكون الحدث موجودًا بالفعل في موقع WordPress الخاص بك.

يساعدك هذا الخيار في تحديد ما إذا كان ينبغي الاحتفاظ بالتغييرات التي تم إجراؤها مباشرة في ووردبريس أو استبدالها بأحدث البيانات من المصدر الخارجي.

يتوفر وضعان للتحديث:

احتفظ بالتعديلات المحلية

عند تحديد هذا الخيار، يقوم التحديث المجدول للحدث باستخدام أحدث المعلومات من المصدر مع الحفاظ على أي حقول قمت بتعديلها يدويًا داخل ووردبريس.

هذا هو الخيار الموصى به إذا قمت بتخصيص الأحداث المستوردة بعد استيرادها ولا تريد أن تضيع هذه التغييرات أثناء عمليات المزامنة المستقبلية.

تشمل حالات الاستخدام النموذجية ما يلي:

• تعديل وصف الحدث
• تغيير الصور المميزة
• تحديث الفئات أو العلامات
• تعديل الحقول المخصصة
• إجراء تغييرات متعلقة بتحسين محركات البحث

ستستمر الحقول التي لم يتم تعديلها محلياً فقط في تلقي التحديثات من المصدر.

الكتابة فوق المصدر

يؤدي تحديد خيار "الكتابة فوق المصدر" إلى تحديث كل عملية مزامنة مجدولة بالكامل للأحداث المستوردة باستخدام أحدث البيانات المتاحة من المصدر الخارجي.

سيتم استبدال أي حقل مدعوم تم تعديله مسبقًا داخل ووردبريس بالبيانات القادمة من المصدر.

اختر هذا الخيار إذا كان التقويم الخارجي يعتبر مصدرك الأساسي للمعلومات وتريد دائمًا أن تتطابق أحداثك المستوردة معه تمامًا.

ملاحظات

يؤثر هذا الإعداد فقط على عمليات المزامنة المجدولة.

لا ينطبق إعداد "سلطة تحديث الأحداث" إلا على عمليات المزامنة المجدولة. أما عمليات الاستيراد اليدوية لمرة واحدة، فتُحدِّث دائمًا الأحداث المستوردة المطابقة بغض النظر عن الخيار المحدد.

طرق الاستيراد المتخصصة

الاستيراد عبر ملف CSV أو ICS

• تحميل الملفات مباشرةيمكنك استيراد الأحداث مباشرة باستخدام CSV or ICS الملفات التي تم تحميلها من جهاز الكمبيوتر الخاص بك.
• نوع الفاصلبالنسبة لملفات CSV، فإن نوع الفاصل يتيح لك الحقل تحديد كيفية تنظيم بياناتك، مع خيارات للفواصل أو علامات الجدولة.
• حالة الحدث: استخدم ال حالة الحدث حقل لتحديد الحالة التي يجب أن يحملها الحدث (على سبيل المثال، منشور أو مسودة) مباشرة بعد اكتمال الاستيراد.
• روابط موجز ICSإذا كان لديك رابط URL لتغذية ICS خارجية، فيمكنك استخدامه لتسهيل عملية التنزيل.
• تسميات مخصصةعند إضافة موجزات ICS خارجية، يمكنك تعيين عنوان مخصص (على سبيل المثال، "التقويم الأكاديمي") للمساعدة في تحديد وتنظيم مصادر متعددة بسهولة.
• استثناءات التكرار (EXDATE)ابتداءً من الإصدار 1.8.0، تدعم الأحداث المتكررة المستوردة من موجزات ICS بشكل كامل تاريخ انتهاء الصلاحية يتم استيراد الأحداث الملغاة أو المستبعدة في التقويم المصدر (بتنسيقات التوقيت العالمي المنسق، أو التوقيتات المتوافقة مع المناطق الزمنية، أو التوقيتات العائمة، أو التوقيتات التي تغطي اليوم بأكمله) كخاصية. أيام استثنائية في MEC، لذلك لم تعد تظهر في تقويمك.
• تحديد: يتم دعم ميزات الاستيراد والمزامنة المجدولة فقط لعناوين URL الخاصة بملفات ICS وهي غير متاحة لملفات CSV.

الانتقال من إضافات الطرف الثالث

إذا كنت تنتقل إلى MEC من Event Organiser أو My Calendar أو Eventum ، فيجب عليك إبقاء هذه الإضافات مُفعّلة أثناء عملية الاستيراد. بمجرد اكتمال عملية النقل بنجاح، يمكنك تعطيل الإضافات القديمة وإزالتها دون التأثير على فعاليات MEC الجديدة.

الإعدادات العامة وإدارة السجل

• الاعدادات العامة: الإعدادات العامة: يمكنك ضبط عدد الأحداث المعروضة في كل منها جدول الصفحة (القيمة الافتراضية هي ستة). إذا كنت بحاجة إلى عرض أكثر من 50 حدثًا في وقت واحد، فتأكد من أن إعدادات الخادم لديك قادرة على التعامل مع هذا الحمل دون حدوث انقطاع في الاتصال.

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

إعدادات متقدمة

يُقدّم الإصدار الجديد علامة تبويب "متقدم" جديدة ضمن Advanced Importer → الإعدادات.

يحتوي هذا القسم على أدوات صيانة تساعد في تنظيف بيانات الاستيراد القديمة التي تم إنشاؤها بواسطة عمليات الاستيراد المجدولة ووظائف المزامنة.

بمرور الوقت، قد تقوم المواقع الإلكترونية التي تقوم بعمليات استيراد مجدولة ومزامنة مجدولة بشكل متكرر بتجميع عدد كبير من سجلات الاستيراد والبيانات الوصفية داخل قاعدة بيانات ووردبريس.

على الرغم من أن هذه السجلات تستخدم داخليًا بواسطة المستورد، إلا أنها يمكن أن تزيد تدريجيًا من حجم قاعدة البيانات وتؤثر على الأداء العام للمواقع الإلكترونية التي تقوم بمزامنة الأحداث لفترات طويلة.

تتيح أدوات تنظيف قاعدة البيانات للمسؤولين إمكانية إزالة سجلات الاستيراد القديمة بأمان مع الحفاظ على جميع أحداث MEC وبيانات التقويم سليمة.

مهم

لا تقوم أدوات التنظيف هذه بحذف أحداث MEC أو فئاتها أو منظميها أو أماكنها أو بيانات التقويم الخاصة بك.

تتم إزالة السجلات والبيانات الوصفية المتعلقة بالمستورد فقط.

للحصول على أفضل النتائج، قم بتشغيل أدوات التنظيف بالترتيب التالي.

الخطوة 1: حذف بيانات التعريف للاستيراد

تزيل هذه الخطوة البيانات الوصفية المرتبطة بما يلي:

• تاريخ الاستيراد
• سجلات الاستيراد المجدولة

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

الخطوة الثانية: حذف سجلات الاستيراد

بعد إزالة البيانات الوصفية، احذف سجلات المستورد الفعلية المخزنة بواسطة Advanced Importer.

هذا يزيل:

• سجلات تاريخ الاستيراد
• سجلات الاستيراد المجدولة

قم بتنفيذ هذه الخطوة بشكل متكرر حتى لا تبقى أي سجلات.

الخطوة 3: إزالة البيانات الوصفية القديمة

في بعض الأحيان، قد تبقى البيانات الوصفية في قاعدة البيانات بعد حذف سجلها الأصلي.

تزيل عملية التنظيف هذه أي بيانات وصفية يتيمة متبقية ناتجة عن عمليات الاستيراد السابقة أو عمليات التنظيف السابقة.

قم بتشغيل هذه الخطوة بشكل متكرر حتى لا تبقى أي بيانات وصفية قديمة.

حد التنظيف

يؤدي كل نقرة على زر التنظيف إلى إزالة ما يصل إلى 1000 إدخال في قاعدة البيانات.

اعتمادًا على حجم قاعدة البيانات الخاصة بك، قد تحتاج إلى النقر فوق الزر عدة مرات حتى يصل العدد المتبقي إلى الصفر قبل الانتقال إلى الخطوة التالية.

وأوصت الاستخدام

تُعد أدوات التنظيف مفيدة بشكل خاص للمواقع الإلكترونية التي:

• قم بتشغيل عمليات الاستيراد المجدولة لفترات طويلة
• قم بمزامنة الأحداث بشكل متكرر
• استيراد أعداد كبيرة من الأحداث من مصادر خارجية
• نرغب في تقليل نمو قاعدة البيانات غير الضروري

يساعد تشغيل أدوات التنظيف هذه بشكل دوري في الحفاظ على قاعدة بيانات المستورد نظيفة دون التأثير على أي أحداث MEC موجودة.

مهم

تؤدي عملية تنظيف قاعدة البيانات إلى إزالة سجلات الاستيراد والمزامنة بشكل دائم. لا يمكن التراجع عن هذا الإجراء.

إدارة عمليات الاستيراد المجدولة والمزامنة

يتولى هذا القسم المخصص أتمتة بيانات الحدث الخاصة بك وصيانتها على المدى الطويل.

• علامة تبويب الاستيرادات المجدولة: يمكنك هنا عرض جميع عمليات الاستيراد المخطط لها والمتكررة وإدارتها. تعمل هذه الصفحة كمركز رئيسي لمراقبة مهامك المؤتمتة والتأكد من اطلاعك على جميع التحديثات المخطط لها.

• علامة تبويب المزامنة: تُدير هذه العلامة التبويب deep، المزامنة الآلية. عندما "إضافة إلى المزامنة التلقائية" عند النقر على زر الاستيراد، تُنقل المهمة بأكملها إلى هنا. وبناءً على الجدول الزمني الحالي، في كل مرة تتم فيها مزامنة الاستيراد، أي التغييرات أو الحذف أو الإضافات سيتم تطبيق التغييرات التي أُجريت على الأحداث في المصدر تلقائيًا على تقويم MEC الخاص بك للمزامنة المستقبلية. بالنسبة لمهام مزامنة Eventbrite، يتم تكوينها رؤية الحدث يتم تطبيق الفلتر في كل عملية تشغيل.

حالات الاستخدام (متى تكون هذه الإضافة مفيدة)

• مزامنة الشبكات الاجتماعية الآلية: اسحب الأحداث تلقائيًا من صفحة الفيسبوك or مفكرة لذلك لن تحتاج إلا إلى تحديث جدولك في مكان واحد.
• ترحيل المنصة: انقل بسرعة مئات الأحداث من إضافات منافسة مثل Eventum or بلدي التقويم إلى مركز التعليم المستمر.
• مزامنة المواقع المتعددة: استخدم واجهة برمجة تطبيقات MEC إعدادات للحفاظ على تزامن مواقع الويب المتعددة الخاصة بالفعاليات على ووردبريس. هذا يتطلب Advanced Importer يجب تفعيل الإضافة على كل من الموقع الذي تستورد منه (المصدر) والموقع الذي تستورد إليه (الهدف).

قد لا تكون هذه الإضافة مثالية في بعض الحالات

• تحديثات جوجل الفورية: تُطبّق التغييرات التي تُجرى على تقويم جوجل عند الاستيراد التالي أو المزامنة المجدولة، وليس فورًا. وبفضل التحديث التلقائي للرمز المميز، لم يعد الاتصال نفسه ينتهي صلاحيته، لذا لا حاجة لإعادة المصادقة بشكل دوري.
• الخوادم ذات الموارد المحدودة: يتطلب جلب أعداد كبيرة جدًا من الأحداث (أكثر من 50 في وقت واحد) موارد خادم مناسبة وقد يتسبب في حدوث مهلات على خطط الاستضافة الضعيفة.
• أتمتة ملفات CSV: بما أن ملفات CSV لا تدعم المزامنة المجدولة، فهي مثالية فقط لعمليات النقل اليدوية لمرة واحدة.

استكشاف الأخطاء وإصلاحها للمبتدئين

• اتصال جوجل: يتم الآن تحديث رموز الوصول تلقائيًا قبل كل عملية استيراد ومزامنة. في حالة فشل الاتصال، انقر فوق بحاجة إلى المصادقة مرة واحدة لإعادة إنشائه - لا مزيد من إعادة المصادقة كل 30 دقيقة.
• تأجيل اللقاء: إذا لم يعمل اتصالك بـ Meetup على الفور، فتذكر أن عملية تفعيل عملاء OAuth قد تستغرق وقتًا. من ساعة إلى ساعتين.
• التحقق من أوراق الاعتماد: في حالة فشل عمليات الاستيراد، تحقق أولاً من أن جميع مفاتيح واجهة برمجة التطبيقات ورموز الوصول يتم إدخالها بشكل صحيح ويتم منح الأذونات اللازمة خلال خطوة "الحاجة إلى المصادقة".
• فعاليات مفقودة على Eventbrite: إذا توقفت أحداث Eventbrite غير المدرجة (الخاصة) عن الظهور بعد الترقية، فقم بتعيين رؤية الحدث إلى عام و شخصي في خيارات استيراد Eventbrite.

---

الأسئلة الشائعة