ليقرأ ناشر منتجاتك، يحتاج إلى مفتاح من متجرك على ووكومرس. تنشئه بنفسك من لوحة تحكم ووردبريس. يستغرق ذلك نحو 3 دقائق ولا تحتاج إلى مطوّر.
ما يجب أن تعرفه قبل البدء:
- المفتاح يقرأ فقط. لا يستطيع تغيير متجرك ولا طلباتك ولا عملائك.
- المفتاح ملكك. يمكنك حذفه في أي وقت، فيتوقف ناشر عن القراءة فوراً.
- يجب أن تسجّل الدخول إلى ووردبريس بحساب دوره Administrator أو Shop manager.
- يجب أن يفتح موقعك عبر https (قفل في المتصفح). لا يرسل ناشر مفتاحك عبر http أبداً.
- تُستورد المنتجات المنشورة فقط. لا تُستورد المسودات ولا المنتجات الخاصة ولا المنتجات في سلة المهملات.
ستنسخ إلى ناشر ثلاث قيم: عنوان المتجر ومفتاح المستهلك (Consumer key) وسرّ المستهلك (Consumer secret).
الخطوة 1: تحقّق من الروابط الدائمة
لا يمكن قراءة ووكومرس من الخارج إلا إذا كان موقعك يستخدم روابط «جميلة».
- في لوحة تحكم ووردبريس افتح Settings ثم Permalinks.
- إذا كان الخيار Plain هو المحدَّد، فاختر Post name بدلاً منه.
- اضغط Save Changes.
إذا كان خيار آخر غير Plain محدَّداً من قبل، فلا تغيّر شيئاً.
الخطوة 2: أنشئ المفتاح
- في لوحة تحكم ووردبريس افتح WooCommerce ثم Settings.
- افتح تبويب Advanced ثم REST API.
- اضغط Add Key.
- في Description اكتب
nashir. - في User اترك مستخدمك (Administrator أو Shop manager).
- في Permissions اختر Read.
- اضغط Generate API Key.
الخطوة 3: انسخ القيمتين
يعرض ووكومرس الآن Consumer key (يبدأ بـ ck_) وConsumer secret (يبدأ بـ cs_).
- انسخ القيمتين الآن. يعرض ووكومرس الـ Consumer secret مرة واحدة فقط. إذا غادرت الصفحة دون نسخه فأنشئ مفتاحاً جديداً.
- تعامل مع السرّ ككلمة مرور: لا ترسله في محادثة ولا في بريد إلكتروني.
الخطوة 4: اربط المتجر في ناشر
- افتح صفحة المتاجر في ناشر:
- افتح ووكومرس، ثم املأ عنوان المتجر (مثل
https://example.com) ومفتاح المستهلك وسرّ المستهلك، واختر النشاط. - اضغط فحص المتجر. يعرض ناشر عدد المنتجات التي سيستوردها وأولها كما قرأها. لا يُستورد شيء بعد.
- اضغط الربط والاستيراد. إذا كان في النشاط منتجات أضفتها بنفسك، يعرض ناشر عدد المنتجات التي ستُستبدل ويطلب تأكيدك أولاً.
بعد أول استيراد، يقرأ ناشر منتجاتك من جديد كل 6 ساعات تلقائياً. تُضاف المنتجات الجديدة، وتُحدَّث الأسعار والتوفر، وتُؤرشف المنتجات التي حذفتها أو ألغيت نشرها. للتحديث فوراً، اضغط إعادة الاستيراد في البطاقة.
ما الذي يُستورد
| من متجرك | في ناشر |
|---|---|
| المنتجات المنشورة | تُستورد |
| المنتجات التي لها خيارات (variable products) | تُستورد مع كل خيار وسعره وتوفره |
| السعر العادي وسعر التخفيض | كلاهما. يُستخدم سعر التخفيض ما دام التخفيض سارياً في متجرك فقط |
| متوفر، غير متوفر، متاح بالطلب المسبق | تُستورد. «الطلب المسبق» يُعدّ متوفراً |
| الصور والتصنيفات ورابط المنتج | تُستورد |
| منتج بلا سعر | لا يُستورد |
| منتج مجمَّع (grouped) | لا يُستورد. تُستورد المنتجات التي بداخله واحداً واحداً |
| منتج مخفي من المتجر (Catalog visibility: Hidden) | لا يُستورد |
اللغات. يقرأ ناشر منتجاتك بلغة واحدة: اللغة الرئيسية لمتجرك. لا تُقرأ الترجمات المُعدّة عبر WPML أو Polylang. وإذا أعاد متجرك منتجات بعدة لغات، تذكر شاشة الفحص اللغة التي ستُستورد وعدد المنتجات التي لن تُستورد، قبل أن تؤكّد.
الضريبة. يذكر ناشر الأسعار كما أدخلتها في ووكومرس. وإذا كان متجرك يضيف الضريبة فوق هذه الأسعار، تذكر شاشة الفحص ذلك.
وضع «Coming soon». إذا كان متجرك ما زال في وضع «Coming soon»، يستورد ناشر منتجاتك بشكل طبيعي، لكن العميل الذي يفتح رابط منتج يرى صفحة «قريباً» وليس المنتج. تخبرك شاشة الفحص بذلك. عندما تكون جاهزاً، اجعل المتجر Live من WooCommerce ثم Settings ثم Site visibility.
إذا منعت إضافة حماية أو Cloudflare ناشر
يقرأ ناشر متجرك من العنوان /wp-json/wc/v3/ في موقعك. إذا أوقف شيء أمام موقعك هذا الطلب، يخبرك ناشر بمن أوقفه متى أمكن ذلك، ولا يغيّر شيئاً في الكتالوج.
إضافة حماية (مثل Wordfence أو Solid Security أو All In One WP Security). افتح إعدادات الإضافة وابحث عن الخيار الذي يقيّد واجهة REST API أو يعطّلها. اسمح بواجهة REST API، أو على الأقل بالعنوان /wp-json/wc/v3/. وإذا كان في الإضافة جدار حماية له قائمة بالعناوين المسموح بها، فأضف إليها /wp-json/wc/v3/. ثم اضغط فحص المتجر من جديد.
Cloudflare.
- في لوحة Cloudflare افتح موقعك ثم Security rules.
- اضغط Create rule ثم Custom rules.
- سمِّ القاعدة، مثلاً
nashir. - تحت When incoming requests match اختر الحقل URI Path والعامل starts with والقيمة
/wp-json/wc/v3/. - تحت Then take action اختر Skip، وحدّد وسائل الحماية التي تريد تخطّيها.
- اضغط Deploy.
توجد في Cloudflare ميزتان لا يمكن تخطّيهما بقاعدة. إذا كانت إحداهما مفعَّلة فسيبقى الطلب ممنوعاً:
- Bot Fight Mode: عطّلها من Security Settings ضمن مجموعة Bot traffic.
- Under Attack Mode: عطّلها لموقعك، أو استخدمها فقط عندما يتعرّض موقعك لهجوم فعلاً.
شركة الاستضافة. بعض شركات الاستضافة تشغّل جدار حماية خاصاً بها. إذا بقي ناشر عاجزاً عن الوصول إلى متجرك، فأرسل إلى شركة الاستضافة هذه الجملة: "Please allow GET requests to /wp-json/wc/v3/ on my site from the application nashir (User-Agent: nashir-store-sync)."
إذا حدث خطأ
| ما يقوله ناشر | ما الذي تفعله |
|---|---|
| لم يقبل متجرك مفتاح المستهلك هذا | انسخ المفتاح كاملاً من جديد. وإن كان قد حُذف فأعد الخطوة 2، واختر مستخدماً دوره Administrator أو Shop manager. |
| سرّ المستهلك لا يطابق مفتاح المستهلك | أعد الخطوة 2 واستخدم القيمتين الجديدتين. |
| هذا المفتاح لا يستطيع القراءة | أعد الخطوة 2 واختر Read في Permissions. |
| المفتاح يعمل، لكن مستخدمه لا يملك صلاحية قراءة إعدادات المتجر | أنشئ المفتاح لمستخدم دوره Administrator أو Shop manager. |
| موقعك يستخدم الروابط الدائمة بالنمط «Plain» | نفّذ الخطوة 1. |
| منع جدار حماية أو إضافة حماية ناشر | راجع القسم السابق. |
| واجهة REST API في موقعك معطّلة | تفعل ذلك إضافة حماية. راجع القسم السابق. |
| متجرك يعمل على http فقط | اطلب من شركة الاستضافة تفعيل شهادة SSL (https) لموقعك. |
| ووكومرس غير مفعَّل | في ووردبريس افتح Plugins وتأكد من أن ووكومرس مثبَّت ومفعَّل ومحدَّث. |
| موقعك لا يتعرّف على أنه يُفتح عبر https | في ووردبريس افتح Settings ثم General وتأكد من أن عنوانَي الموقع يبدآن بـ https. وإن كانا كذلك فتواصل مع شركة الاستضافة. |
| تعذّر الوصول إلى متجرك | تأكد من أن موقعك يفتح في المتصفح، ثم اضغط إعادة الاستيراد. |
لإيقاف قراءة ناشر لمتجرك، اضغط فصل المتجر في البطاقة في ناشر. ولإلغاء المفتاح أيضاً، افتح WooCommerce ثم Settings ثم Advanced ثم REST API وألغِ المفتاح المسمّى nashir.
إذا أنشأت مفتاحاً جديداً لاحقاً، فاضغط فصل المتجر في البطاقة في ناشر، ثم اربط المتجر من جديد بالقيم الجديدة. تعود منتجاتك كما كانت.
إذا فشلت المزامنة، لا يتغيّر شيء في الكتالوج ولا يُحذف. وبعد 3 محاولات فاشلة متتالية تعرض البطاقة تنبيهاً ويصل بريد إلكتروني إلى مالك الفريق.