OpenCart

تعمل إضافة SeekGist مع OpenCart بالإصدارات 2.x و3.x و4.x على PHP 7.4 أو أحدث (مع cURL وmysqli). جُرّبت على OpenCart 2.1.0.1 و3.0.4.0 و4.0.2.3 ببيانات اختبار مصطنعة.

ماذا تفعل الإضافة

• صفحة نتائج البحث. تطلب صفحة البحث في متجرك أرقام المنتجات من SeekGist، ثم يعرض OpenCart بطاقات المنتجات الخاصة به. تبقى الأسعار والعروض والضرائب وأسعار مجموعات العملاء كما يحسبها OpenCart تمامًا، ولا يتغير رابط صفحة البحث.
• رجوع آمن. إذا لم يرد SeekGist خلال 300 ملّي ثانية، أو رد بخطأ، يخدم بحث المتجر نفسه ذلك الطلب. وبعد 5 أخطاء خلال 60 ثانية تتجاوز الإضافة SeekGist لمدة 30 ثانية. راجع الرجوع إلى بحث المتجر.
• اقتراحات أثناء الكتابة تعمل بلوحة المفاتيح وبقارئات الشاشة، ومن اليمين إلى اليسار في العربية. تبقى عمليات البحث الأخيرة في متصفح المتسوق فقط.
• تتبّع النقرات على النتائج والإضافة إلى السلة والطلبات، وتُرسل لاحقًا عبر المهمة المجدولة.
• مزامنة المنتجات فور حفظ المنتج، ومن مهمة مجدولة كل 5 دقائق (تلتقط أيضًا تغيّر المخزون بسبب الطلبات)، ومزامنة كاملة مرة في اليوم.
• كتابة الترجمات في المتجر (اختيارية): تُكتب الترجمات المعتمدة من SeekGist في صفوف اللغات في متجرك. ولا يُستبدل أبدًا نص كتبه شخص.

1. قبل أن تبدأ

1. أنشئ متجرك في لوحة تحكم SeekGist واختر OpenCart في معالج الإعداد.
2. افتح الإعدادات > مفاتيح API وانسخ مفتاحين: المفتاح العام (sg_pub_...، يُستخدم في صفحاتك) والمفتاح السري (sg_sec_...، يستخدمه خادمك فقط لمزامنة المنتجات).
3. خذ نسخة احتياطية من ملفات متجرك وقاعدة بياناته.
4. اختر الحزمة المناسبة لإصدار OpenCart لديك:

2. التثبيت

OpenCart 4.x

1. Extensions > Installer: ارفع seekgist.ocmod.zip، ثم اضغط Install بجانبه.
2. Extensions > Extensions، اختر Modules، وابحث عن SeekGist Search، واضغط Install.
3. اضغط Edit وانتقل إلى الإعدادات.

OpenCart 3.x

1. Extensions > Installer: ارفع seekgist-opencart-3.x-1.0.0.ocmod.zip.
2. Extensions > Extensions، اختر Modules، وابحث عن SeekGist Search، واضغط Install (علامة + الخضراء).
3. اضغط Edit (القلم) وانتقل إلى الإعدادات.

OpenCart 2.x

ينسخ OpenCart 2.x ملفات الإضافات عبر FTP فقط، ومعظم المتاجر لا تضبط ذلك. لذا:

1. فك ضغط الحزمة. ارفع محتويات مجلد upload/ إلى المجلد الرئيسي لمتجرك (الذي فيه index.php)، عبر FTP أو SFTP أو مدير الملفات في الاستضافة.
2. Extensions > Extension Installer: ارفع seekgist.ocmod.xml (تجده في الحزمة بجانب upload/).
3. Extensions > Modifications: اضغط Refresh (الزر الأزرق أعلى اليمين).
4. Extensions > Modules: ابحث عن SeekGist Search، واضغط Install ثم Edit.

إذا كان قالبك أو إضافة أخرى قد غيّرت الملف catalog/model/catalog/product.php كثيرًا، فافتح Extensions > Modifications > Log بعد التحديث. يجب أن تظهر كل نقطة من نقاط الربط الأربع على أنها وُجدت. وإذا ظهرت إحداها NOT FOUND فسيواصل المتجر العمل دون SeekGist.

3. الإعدادات

اضغط Save، ثم:

1. Test connection. يجب أن يظهر OK للمفتاحين. وهذا يضيف متجرك أيضًا إلى لوحة تحكم SeekGist.
2. Sync all products now. يبيّن جدول الحالة عدد المنتجات المرسلة.
3. ابحث عن شيء في متجرك، بالعربية وبالإنجليزية.

4. المهمة المجدولة (ضرورية)

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

*/5 * * * * php /path/to/your/store/system/library/seekgist/cron.php >/dev/null 2>&1

في OpenCart 4.x يكون الملف extension/seekgist/system/library/seekgist/cron.php. الخيارات: --task=all (الافتراضي)، وdelta، وfull، وoutbox، وwriteback، و--root=/path إذا لم يجد السكربت مجلد متجرك.

إذا لم تكن في استضافتك مهام مجدولة من سطر الأوامر، فاستخدم عنوان الويب الظاهر في صفحة الإدارة مع أداة «URL cron» في استضافتك. احفظ رمزه سرًا: فكل من يملكه يستطيع تشغيل مزامنة.

5. تحقّق من الرجوع (اختياري)

يعرض جدول الحالة في الإدارة عدد مرات الرجوع إلى بحث المتجر (24 ساعة) وحالة مفتاح الأمان. لتجربته على نسخة اختبار من متجرك، اجعل API address عنوانًا لا يرد (مثل https://localhost:9). يجب أن يظل البحث يعرض نتائج (نتائج متجرك نفسه)، ويزيد عدّاد الرجوع.

إلغاء التثبيت

Extensions > Modules (في 2.x) أو Extensions > Extensions > Modules (في 3.x و4.x): Uninstall. يزيل هذا أحداث الإضافة وإعداداتها وجداولها الأربعة (seekgist_state، seekgist_outbox، seekgist_kv، seekgist_written). وفي 2.x احذف أيضًا التعديل من Extensions > Modifications واضغط Refresh. لا تتغير منتجاتك ولا بحث متجرك.

مشكلات وحلول

ما الذي يُحفظ ويُرسل

• يُرسل إلى SeekGist: بيانات المنتجات (الأسماء والأوصاف والعلامة التجارية والطراز وSKU/EAN والسعر والسعر الخاص والمخزون والتصنيفات والخصائص وروابط الصور والمنتجات)، ونص البحث، وأحداث مجهولة الهوية (قيمة تجزئة (hash) لمعرّف الجلسة، ولا أسماء ولا بريد إلكتروني ولا عناوين أبدًا).
• يُحفظ في قاعدة بياناتك: حالة المزامنة، وقائمة أحداث تنتظر المهمة المجدولة (تُحفظ 7 أيام)، وحالة التشغيل، والترجمات التي كتبتها الإضافة.
• يبقى المفتاح السري على خادمك. ولا يوضع في صفحاتك إلا المفتاح العام.