مساعدة ListoMax: أدلة وأسئلة شائعة
كيف تربط متاجرك، وأين تجد مفاتيحك، وماذا تفعل عندما يفشل النشر. لم تجد سؤالك؟ راسلنا: نردّ بأنفسنا على كل رسالة.
كيف تربط متجر PrestaShop
يعمل مع PrestaShop 1.7 و8 و9. خصّص نحو خمس دقائق.
افتح إعدادات خدمة الويب
في لوحة تحكم متجرك، انتقل إلى Advanced Parameters، ثم Webservice. هذه هي الواجهة التي تتيح للبرامج الخارجية التواصل مع متجرك.
فعّل خدمة الويب
في أسفل الصفحة، اضبط Enable PrestaShop's webservice على Yes، ثم احفظ. إذا تخطيت هذه الخطوة فلن يعمل أي مفتاح.
أنشئ مفتاحًا
انقر على Add new webservice key. أعطه اسمًا تتعرف عليه، مثل "ListoMax"، ثم ولّد المفتاح.
امنح الصلاحيات
في جدول الصلاحيات، فعّل القراءة والكتابة على الأقل لـ: products وcategories وimages وlanguages وstock_availables وtaxes وtax_rules وspecific_prices وproduct_features وtags. الخيار الأبسط هو تفعيل كل شيء: هذا المفتاح لا يستخدمه إلا ListoMax.
انسخ المفتاح واحفظ
يتكون المفتاح من 32 حرفًا كبيرًا. انسخه، ثم احفظ الصفحة.
أدخله في ListoMax
في ListoMax، افتح صفحة CMS connections واختر PrestaShop. أدخل عنوان متجرك دون شرطة مائلة في النهاية والصق المفتاح. انقر على اختبار: يُتحقق من الاتصال فورًا ويظهر المتجر ضمن وجهاتك.
كيف تربط متجر WooCommerce
من لوحة تحكم WordPress. خصّص نحو ثلاث دقائق.
افتح الإعدادات المتقدمة
في WordPress، انتقل إلى WooCommerce، ثم Settings، ثم تبويب Advanced، ثم REST API.
أضف مفتاحًا
انقر على Add key. اكتب وصفًا، مثل "ListoMax"، واختر المستخدم الذي ستُنشأ المنتجات باسمه — حساب بصلاحية مدير.
اختر الصلاحيات
اختر Read/Write. صلاحية القراءة فقط لن تسمح لك بإنشاء منتجات.
انسخ القيمتين
يعرض WooCommerce Consumer key وConsumer secret. انسخهما فورًا: لا يُعرض الـ secret إلا مرة واحدة ولا يمكن رؤيته مجددًا بعد مغادرة الصفحة.
أدخلهما في ListoMax
في ListoMax، افتح صفحة CMS connections واختر WooCommerce. أدخل عنوان متجرك والـ Consumer key والـ Consumer secret، ثم اختبر الاتصال.
ساعاتك الثلاث الأولى
الترتيب الأمثل لتعلّم البرنامج دون أن تتوه.
اربط متجرًا واحدًا فقط
ابدأ بمتجر واحد، الذي تعرفه أكثر. اختبر الاتصال وتحقق من تحميل الفئات بشكل صحيح باستخدام الزر المخصص لذلك.
انشر منتجًا تجريبيًا
أنشئ صفحة بسيطة، وألغِ تحديد Active product حتى لا تظهر في متجرك، ثم انشر. تحقق منها في لوحة التحكم. ثم احذفها.
جرّب سلسلة صغيرة
متغيّران أو ثلاثة، والمنتج غير مفعّل، لتفهم طريقة العمل دون أي مخاطرة. هنا يُثبت البرنامج قيمته الحقيقية.
تحقق من فئاتك
ضع منتجًا في فئة فرعية وتحقق في متجرك من ظهوره، بما في ذلك عند التصفح من الفئة الأم.
اختبر إعادة النشر
غيّر سعر أو مخزون صفحة منشورة بالفعل، وأعد نشرها، وتحقق من أن المتجر استقبل القيمة الجديدة.
أنشئ نسخة احتياطية
من الإعدادات، صدّر النسخة الاحتياطية الكاملة. اجعلها عادة قبل كل عملية كبيرة.
المشكلات الشائعة وحلولها
فشل الاتصال بـ PrestaShop
تحقق من ثلاثة أمور بهذا الترتيب: أن خدمة الويب مفعّلة في Advanced Parameters، وأن العنوان لا ينتهي بشرطة مائلة، وأن المفتاح يملك صلاحية الكتابة على المنتجات.
خطأ 401 في WooCommerce
بيانات الاعتماد الخاصة بك مرفوضة. تأكد من أنك نسخت الـ Consumer key والـ Consumer secret دون مسافات في البداية أو النهاية، وأن المفتاح أُنشئ بصلاحية Read/Write، وليس للقراءة فقط.
الصور لا تُرفع
على الأرجح يفتقر المفتاح إلى صلاحية على الصور. في PrestaShop، تحقق من صلاحية images. وتأكد أيضًا من أن ملفاتك أقل من 8 ميغابايت وأن استضافتك تسمح برفع ملفات بهذا الحجم.
المنتج لا يظهر في المتجر
في أغلب الأحيان، يكون مربع Active product غير محدد. تحقق أيضًا من أن المنتج مُسند إلى فئة مرئية، وفي PrestaShop متعدد المتاجر، من أنه مرتبط بالمتجر الصحيح.
النشر محظور بسبب الضريبة
هذا مقصود. النسبة المطلوبة غير موجودة في المتجر المستهدف. تعرض الرسالة النسب المتاحة: اختر واحدة، أو أنشئ النسبة المفقودة في لوحة التحكم. نفضّل حظر النشر على إرسال منتج بنسبة ضريبة خاطئة.
المتغيّرات لا تُنشأ
تحقق من أن المفتاح يملك صلاحيات على التركيبات (combinations) والسمات (attributes). في WooCommerce، يجب أن يتمكن المنتج من التحول إلى النوع المتغيّر، وهذا يتطلب صلاحية كتابة كاملة.
فئة مفقودة
انقر على زر تحديث الفئات: تُعاد تحميل القائمة من المتجر. إذا كانت الفئة قد أُنشئت للتو في لوحة التحكم، فستظهر بعد التحديث.
يبدو البرنامج متجمّدًا
قد يستغرق النشر الجاري بعض الوقت إذا كانت الصور كبيرة الحجم أو المتجر بطيئًا. يعرض شريط التقدم الخطوة الحالية. وإذا لم يتحرك شيء بعد عدة دقائق، ستظهر رسالة خطأ في النهاية: لا شيء يحدث بصمت أبدًا.
البرنامج
ما إصدارات PrestaShop المدعومة؟
PrestaShop 1.7 و8 و9. يُختبر النشر في ظروف حقيقية على PrestaShop 8.2 وPrestaShop 9.0 قبل كل إصدار، على متاجر حقيقية، مع إعادة قراءة كل صفحة بعد إرسالها للتأكد من أن المتجر استقبل ما طُلب بالضبط.
هل يعمل مع القالب أو الوحدات (modules) التي أستخدمها؟
نعم. يمر ListoMax عبر واجهة API الرسمية لنظام CMS الخاص بك، وليس عبر واجهة المستخدم. قالبك ووحداتك وتخصيصاتك لا علاقة لها بالأمر ولا يمكنها التداخل مع النشر.
هل يعمل مع PrestaShop متعدد المتاجر (multistore)؟
نعم، ما دام مفتاح خدمة الويب يملك صلاحية الوصول إلى المتاجر المعنية. بعد أول عملية نشر، تحقق في لوحة التحكم من أن المنتج مرتبط بالمتجر الصحيح.
ماذا يحدث إذا فشل النشر؟
تظهر رسالة الخطأ على الشاشة مع المنتج والمتجر المعنيين. تنتقل الصفحة إلى قائمة الأخطاء، حيث يمكنك تصحيحها وإعادة إرسالها، واحدة تلو الأخرى أو جميعها دفعة واحدة. لا شيء يفشل بصمت: هذا هو المبدأ الذي يقوم عليه كل تطويرنا.
هل يمكنني تعديل منتج منشور بالفعل؟
نعم. تعدّل الصفحة في ListoMax وتعيد نشرها: يستقبل المتجر القيم الجديدة، بما في ذلك الفئات والضريبة والسعر والمخزون والوزن والأبعاد والخصائص. تُحفظ كل نسخة في السجل ويمكن مقارنتها حقلًا بحقل.
هل يحذف ListoMax منتجات من متجري؟
لا. حذف صفحة في ListoMax يزيلها من كتالوجك المحلي، وليس من متجرك الإلكتروني. يبقى الحذف من المتجر قرارك أنت، من لوحة التحكم الخاصة به.
هل أحتاج إلى اتصال دائم بالإنترنت؟
فقط للنشر ولتحميل الفئات. ملء الصفحات وتجهيز السلاسل واستيراد الملفات كلها تعمل دون اتصال.
هل يعمل ListoMax على Mac أو Linux؟
ليس بعد. نسخة Windows أولًا، ونسخة macOS مخططة بعدها، ثم Linux إن وُجد طلب. راسلنا إن كنت منهم: عدد الطلبات هو ما يحدد الأولوية.
كم منتجًا يمكنني إدارته؟
لا يوجد حد محدد. يُحفظ كتالوجك في ملف منظّم على جهازك، مع نسخ احتياطية دورية. وللكميات الكبيرة جدًا، يبقى الاستيراد من ملف أسرع من إدخال المنتجات واحدًا تلو الآخر.
ما الفرق بينه وبين استيراد CSV المدمج في PrestaShop؟
يفترض استيراد CSV المدمج أن الملف موجود بالفعل، نظيفًا ومكتملًا. فهو لا يُنشئ المتغيّرات، ولا يملأ الصفحات نيابة عنك، ولا يتعامل مع SEO متعدد اللغات، ولا ينشر على عدة أنظمة CMS في الوقت نفسه. أما ListoMax فيبني الصفحات، بما فيها السلاسل، ويرسلها إلى كل متجر. ويوفر ListoMax أيضًا استيراد CSV، كخيار مكمّل.
هل مولّد الذكاء الاصطناعي إلزامي؟
لا، إنه إضافة اختيارية. بدون مفتاح Anthropic، يعمل البرنامج بالكامل: تكتب نصوصك بنفسك كما في أي نموذج. ومع المفتاح، تدفع بضعة سنتات لكل صفحة مباشرة إلى Anthropic، وليس لنا أبدًا.
الشراء والترخيص
هل يمكنني التجربة قبل الشراء؟
نعم، ويمكنك حتى النشر. تتضمن التجربة المجانية 5 عمليات نشر حقيقية على متاجرك الفعلية: تُنشر الصفحات فعلًا على PrestaShop أو WooCommerce، مع صورها ومتغيّراتها ولغاتها الثماني. تتحقق من النتيجة في لوحة التحكم قبل أن تدفع أي شيء. جميع الميزات مفتوحة، ولا حاجة إلى بطاقة ائتمان، ولا حد زمنيًا. بعد هذه العمليات الخمس، يفتح الترخيص النشر غير المحدود — والصفحات التي جهّزتها تبقى محفوظة وتُنشر بمجرد التفعيل. راسلنا للحصول على رابط التحميل.
هل يمكنني تثبيت ترخيص Solo على جهازين؟
يغطي ترخيص Solo جهاز كمبيوتر واحدًا. إذا غيّرت جهازك، راسلنا وسننقل الترخيص مجانًا. ولعدة أجهزة تُستخدم في الوقت نفسه، صُمم ترخيص Agency لهذا الغرض تحديدًا.
ماذا يغطي ترخيص Agency بالضبط؟
الاستخدام الداخلي من قِبل أعضاء فريق مؤسستك، على ما يصل إلى 20 جهاز كمبيوتر. ولا يسمح لك بإعادة بيع البرنامج أو إتاحته لأطراف ثالثة خارج مؤسستك.
ماذا يحدث بعد انتهاء الاثني عشر شهرًا من التحديثات؟
يستمر البرنامج في العمل كما هو، إلى الأبد، دون أي تكلفة إضافية. يتوقف فقط الوصول إلى الإصدارات الجديدة. يتوفر تمديد سنوي، بنحو €19 سنويًا، لكنه اختياري تمامًا.
كيف يتم الاسترداد؟
راسلنا أولًا: معظم المشكلات تُحل في تبادل واحد. وإذا ظل البرنامج غير مناسب لك، يمكن استرداد المبلغ خلال أربعة عشر يومًا من الشراء. التفاصيل الكاملة في شروط البيع الخاصة بنا.
هل سأحصل على فاتورة؟
نعم. تتم معالجة الدفع بشكل آمن عبر Stripe، وتتلقى فاتورة نظامية يمكنك استخدامها في محاسبتك (ضريبة القيمة المضافة غير مطبّقة، article 293 B du CGI).
البيانات والأمان
هل تُرسل مفاتيح API الخاصة بي إلى أي جهة؟
لا. تبقى مفاتيحك وكتالوجك وسجلّك محفوظة على جهازك، في المساحة المحمية للتطبيق. ليس لدينا أي خادم يستقبل بيانات متجرك. يتواصل البرنامج مباشرة بين جهازك ومتاجرك، دون أي وسيط.
أين تُحفظ بياناتي بالضبط؟
في مجلد بيانات التطبيق على جهازك: الكتالوج والسجل في ملف منظّم مع نسخ احتياطية دورية، والصور في مجلد مخصص، ومفاتيح الوصول في مساحة محمية لا يقرأها إلا الإجراء الرئيسي للبرنامج.
ماذا يحدث إذا تعطّل جهازي؟
صدّر النسخة الاحتياطية الكاملة بانتظام من الإعدادات: ملف واحد يضم كتالوجك وسجلّك وتفضيلاتك. حمّله على جهاز جديد وسيعود كل شيء. والمنتجات التي نشرتها تبقى بالطبع منشورة في متاجرك.
هل يرسل مولّد الذكاء الاصطناعي بياناتي إلى Anthropic؟
فقط ما يلزم للتوليد — اسم المنتج ونقاط البيع التي تقدّمها — وفقط إذا استخدمت هذه الميزة، بمفتاحك الخاص. بدون مفتاح، لا تغادر أي بيانات جهازك.
هل يمكنني استخدام ListoMax على جهاز دون صلاحيات المسؤول؟
قد يتطلب التثبيت صلاحيات حسب إعدادات شركتك. تواصل معنا إن كان هذا وضعك وسنرى ما هو ممكن.
لم تجد سؤالك؟
راسلنا على support@listomax.io. نردّ شخصيًا، عادةً خلال 48 ساعة عمل.