Shopify

ينشر Clodix المقالات مباشرة في مدونة متجرك على Shopify. لم يعد Shopify يمنح مفاتيح وصول جاهزة، لذا تنشئ تطبيقًا صغيرًا في حساب المطوّر الخاص بك على Shopify وتعطي Clodix بيانات اعتماده، دون الحاجة إلى موافقة من Shopify، ويستغرق ذلك نحو خمس دقائق.

أنشئ التطبيق

1. انتقل إلى dev.shopify.com وافتح تطبيقك (أو أنشئ واحدًا).
2. في إعدادات التطبيق، اضبط:
   • App URL على https://www.clodix.ai: يشترط Shopify هذا الحقل، لكن يجب ألا يشير إلى متجرك أنت.
   • Embed app in Shopify admin: أوقفه (off).
   • Use legacy install flow: أوقفه (off).
3. ضمن API access انقر على Select scopes، وابحث عن «content»، وحدد read_content وwrite_content. اترك Optional scopes فارغة.
4. يحفظ Shopify الإعدادات على شكل إصدارات. بعد إجراء التغييرات، أنشئ إصدارًا جديدًا وانقر على Release، فيظل الإصدار القديم يعمل إلى أن تفعل ذلك.

ثبّته على متجرك

1. انقر على Install app، ثم اختر متجرك.
2. يعرض Shopify شاشة الصلاحيات، فانقر على Install.
   • إذا أعادك بدلًا من ذلك إلى الصفحة الرئيسية لمتجرك دون أن يحدث شيء، فهذا يعني أن الإصدار الجديد من الخطوة 4 أعلاه لم يُصدَر (Release) بعد، فارجع وأصدره.
3. افتح التطبيق → Credentials وانسخ Client ID وClient Secret.

اربطه في Clodix

1. افتح Settings → Publishing integrations وانقر على Shopify.
2. املأ:
   • Store URL: العنوان الذي يستخدمه Shopify لتسجيل دخولك، مثل mystore.myshopify.com (إذا لم تكن متأكدًا فستجده في Shopify ضمن Settings → Domains، وهو مختلف عن عنوان واجهة متجرك).
   • Client ID وClient Secret: من التطبيق الذي أنشأته للتو.
3. انقر على Connect to Shopify.

كيف يبدو المقال المنشور

• يُنشأ المقال في أول مدونة في متجرك، بعنوانك ونصك وملخص الميتا، ويُنشر فورًا.
• تُضبط صورة الغلاف كصورة للمقال، وتُسحب من نطاق موقعك نفسه وليس من العنوان التقني .myshopify.com، لتبقى الروابط بين مقالاتك على نطاقك الحقيقي.
• تعديل المقال لاحقًا وإعادة نشره يحدّث مقال Shopify نفسه، فلا ينشئ Clodix نسخة ثانية أبدًا.
• Unpublish يعيد المقال إلى حالة غير منشور (مسودة) في Shopify.

مشكلات شائعة

عندما يفشل Connect، تسمّي الرسالة أسفل النموذج المشكلة. ابحث عنها أدناه.

أدخلت عنوان واجهة متجرك

ترى: «That is your storefront address — we need the admin one» أو «Store URL should look like mystore.myshopify.com».

أدخلت النطاق العام لمتجرك (مثل mystore.com) بدلًا من عنوان الإدارة. استخدم العنوان المنتهي بـ .myshopify.com، وستجده ضمن Settings → Domains في Shopify.

لا يوجد متجر Shopify على هذا العنوان

ترى: «There is no Shopify store at …».

لا يشير Store URL إلى أي متجر، وغالبًا بسبب خطأ إملائي أو اسم خُمّن من واجهة متجرك. خذ الاسم من رابط الإدارة لديك: admin.shopify.com/store/NAME يعني NAME.myshopify.com.

لا يقبل Shopify الـ Client ID والـ Client Secret

ترى: «Shopify does not accept this Client ID and Client Secret».

الزوج من تطبيق آخر، أو أُعيد توليد السر بعد أن نسخته. افتح التطبيق نفسه في dev.shopify.com → Credentials وانسخ القيمتين من جديد.

التطبيق غير مثبَّت على متجرك

ترى: «The app is not installed on … yet».

أُنشئ التطبيق لكنه لم يُثبَّت قط على متجرك. انقر على Install app في dev.shopify.com، واختر متجرك، وأكمل شاشة الصلاحيات.

لا يجد Shopify التطبيق

ترى: «Shopify cannot find this app».

حُذف التطبيق في حساب المطوّر لديك. أنشئه من جديد، وثبّته على متجرك، واربط باستخدام Client ID وClient Secret الجديدين.

يفشل نشر مقال مع «applicationcannotbe_found»؟ السبب نفسه لكنه اكتُشف لاحقًا: ربطت Shopify ثم حُذف التطبيق أو أُعيد إنشاؤه، فلم تعد المفاتيح التي يحتفظ بها Clodix تطابق أي شيء. تبقى مقالاتك مسودات. اضغط Manage → Disconnect، وأنشئ التطبيق من جديد، واربط بالمفاتيح الجديدة، ثم اضغط Publish على المسودات.

التطبيق يتبع حساب Shopify مختلفًا

ترى: «This app belongs to a different Shopify account».

أُنشئ التطبيق تحت حساب Shopify غير الحساب الذي يملك المتجر. أنشئ التطبيق من جديد وأنت مسجّل الدخول إلى dev.shopify.com بالحساب الذي يملك متجرك.

ينقص التطبيقَ صلاحيات المحتوى

ترى: «The app is missing the content permissions».

لا يملك التطبيق وصولًا إلى محتوى المدونة. في التطبيق → API access → Select scopes حدد read_content وwrite_content، ثم أنشئ إصدارًا جديدًا وانقر على Release.

ليس للمتجر مدونة بعد

ترى: «This store has no blog yet».

لا توجد مدونة للنشر فيها. أنشئ واحدة ضمن Content → Blog posts في Shopify، ثم اربط من جديد.

لم يرد Shopify

ترى: «Shopify did not answer — try again in a few minutes».

لم يستجب Shopify، وبياناتك ليست المشكلة. انتظر بضع دقائق واضغط Connect مرة أخرى.

بعد Install تقول صفحة إنها لأمثلة التوثيق

تنقر على Install فترى صفحة تقول «This domain is for use in documentation examples». لا توجد مشكلة، فهذا هو App URL البديل، والتطبيق مثبَّت فعلًا. ارجع إلى dev.shopify.com → تطبيقك → Credentials، وانسخ Client ID وClient Secret، واربط في Clodix.

لا يمكن تثبيت التطبيق: لا توجد طريقة توزيع

ترى: «This app can't be installed yet — the developer needs to select a distribution method».

استخدمت مسار التثبيت القديم الذي أُغلق. اتبع خطوات هذه الصفحة من البداية: أنشئ التطبيق في Dev Dashboard، واضبط النطاقات، وأصدر إصدارًا، ثم Install app.

التثبيت يحوّلني إلى الصفحة الرئيسية لمتجري

تنقر على Install فتصل إلى الصفحة الرئيسية لمتجرك ولا يُثبَّت شيء. ما زالت إعدادات التطبيق تستخدم مسار التثبيت القديم، أو أن App URL هو عنوان متجرك نفسه. في التطبيق → Versions → Create version أوقف Use legacy install flow، واضبط App URL على أي شيء عدا عنوان واجهة متجرك (يصلح https://www.clodix.ai)، ثم Release وانقر على Install app مرة أخرى.

ثبّتّ التطبيق، لكن Clodix ما زال يعرض Connect

تثبيت التطبيق على متجرك يمنحه التفويض فقط، أما الاتصال نفسه فيتم في Clodix. افتح التطبيق في dev.shopify.com → Credentials، وانسخ Client ID وClient Secret، ثم في Clodix انتقل إلى Settings → Publishing integrations → Shopify والصقهما مع عنوانك .myshopify.com.

حقل Scopes فارغ

يبدأ التطبيق الجديد دون نطاقات. في إعدادات إصدار التطبيق أدخل read_content,write_content في Scopes (مفصولة بفاصلة، دون مسافة)، أو استخدم Select scopes وابحث عن «content» وحدد الاثنين، ثم Release للإصدار وثبّت من جديد.

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

هل أحتاج إلى موافقة Shopify لاستخدام Clodix؟

لا. التطبيق موجود في حساب المطوّر الخاص بك على Shopify ويُثبَّت على متجرك أنت فقط، فلا توجد خطوة مراجعة من Shopify.

لماذا لا يمكنني ببساطة لصق رمز وصول كما في السابق؟

أوقف Shopify رموز الوصول المولَّدة مسبقًا للتطبيقات المخصصة. الزوج Client ID / Client Secret الذي تنشئه اليوم يولّد رمزًا جديدًا تلقائيًا في كل مرة ينشر فيها Clodix، فلا تحتاج إلى لمسه مرة أخرى بعد الربط.

هل سيمس هذا قالب متجري أو صفحة الدفع؟

لا. صلاحيات التطبيق مقتصرة على قراءة محتوى المدونة وكتابته (read_content وwrite_content)، وليس له وصول إلى المنتجات أو الطلبات أو القوالب أو الدفع.

ذات صلة

• ربط موقعك
• مشكلات النشر
• نشر مقال