LNK Reassurance: أشرطة طمأنة غير محدودة لـ PrestaShop تُضبط دون CSS
التوصيل، والدفع الآمن، والإرجاع، وخدمة العملاء: هذه الوعود تطمئن المشتري، بشرط أن تتمكن من عرضها في المكان المناسب وبألوان قالبك. تتيح لك وحدة الطمأنة LNK Reassurance لـ PrestaShop إنشاء ما تحتاجه من أشرطة الطمأنة، ووضعها انطلاقًا من قائمة مواضع، وضبط مظهرها من لوحة التحكم. لا CSS تكتبه، ولا override لنواة PrestaShop.
- الإصدار 3.1.0 · PrestaShop من 1.7.6 إلى 8.x
- الإصدار 3.9.0 · PrestaShop 9
- PrestaShop من 1.7.6 إلى 9.x
- PHP من 7.1 إلى 8.4
- بدون تعديل على النواة
النقاط الرئيسية
- أشرطة غير محدودة، لكل منها محتواه وموضعه ومظهره.
- وضع دون المساس بالقالب: ستة مواضع للاختيار.
- نحو ثلاثين إعدادًا للمظهر، دون كتابة CSS.
- معاينة بالعرض الحقيقي، تتحدّث أثناء الكتابة.
- 18 أيقونة متجهية، تُعرض بصيغة SVG داخل الصفحة.
- استيراد أيقونتك الخاصة بصيغة SVG، مع تنظيفها قبل الحفظ.
- محتوى متعدد اللغات، حتى 6 عناصر في كل شريط.
- إخفاء على الجوال، لكل شريط على حدة.
- متوافقة مع منشئي الصفحات (Creative Elements وما يماثله).
- لا override للنواة، ولا اتصال بخدمة خارجية، ولا ملفات تعريف ارتباط.
- PrestaShop 1.7 و8 و9، مع لوحة تحكم Symfony أصلية في الإصدار 9.
عدة أشرطة طمأنة في المتجر الواحد
كتلة الطمأنة المرفقة مع PrestaShop واحدة فقط: شريط واحد في موضع واحد. وكثيرًا ما يحتاج المتجر إلى رسائل مختلفة حسب الصفحة، مثلًا:
- شريط قصير أعلى الصفحة الرئيسية، يعرض أربعة وعود؛
- شريط خاص بسلة التسوق، يركّز على الدفع والإرجاع؛
- شريط ثالث أسفل صفحة المنتج، مخصص لآجال التوصيل.
تتيح لك LNK Reassurance إنشاء ما تحتاجه من الأشرطة، ولكل شريط محتواه وموضعه ومظهره.
مواضع تختارها، دون تعديل القالب
لكل شريط موضعه، يُختار من قائمة:
| الموضع | النتيجة |
|---|---|
| السلة ومسار الطلب | الموضع الأصلي في القوالب الرسمية |
| الصفحة الرئيسية | داخل متن الصفحة |
| قبل التذييل | فوقه مباشرة |
| فوق المحتوى | في كل الصفحات |
| مخصص | حيث تضع سطرًا واحدًا |
| لا مكان | مخصص للوضع اليدوي |
تختار الموضع ثم تحفظ، فيظهر الشريط دون فتح أي ملف.
ولمكان دقيق جدًا يكفي سطر واحد في قالبك:
{widget name='lnk_reassurance' id=1}. إذا لم يوفّر قالبك نقطة ربط في المكان المطلوب،
نضعها لك مجانًا.
كتلة طمأنة قابلة للتخصيص من لوحة التحكم
يُضبط المظهر دون CSS، عبر نحو ثلاثين إعدادًا مجمّعة حسب الموضوع:
- التخطيط: في سطر، أو في شبكة، أو أيقونة فوق النص؛ عدد الأعمدة على الحاسوب وعلى الجوال؛ التوزيع والمحاذاة.
- الكسوة: الخلفية، ولون النص، والحشوة الداخلية، والاستدارة، والإطار، والظل.
- المسافات: الأفقية، والعمودية، والخاصة بالجوال، والمسافة بين الأيقونة والنص.
- الأيقونات: اللون والحجم.
- العناوين والعناوين الفرعية: اللون، والحجم، والسماكة، والأحرف الكبيرة، والشفافية، وإخفاء العنوان الفرعي على الجوال.
- الفواصل: العرض، واللون، والارتفاع.
حقل اللون المتروك فارغًا يأخذ لون القالب، فيندمج الشريط مع بقية المتجر.
لا يُكتب أي ملف على القرص. تُطبَّق الإعدادات على شكل متغيرات CSS موضوعة على الكتلة نفسها. وبذلك تبقى الوحدة سليمة في وضع المتاجر المتعددة، ولا تستطيع شبكة CDN تقديم المظهر القديم بعد أي تعديل.
معاينة مباشرة في المحرر
تحمّل معاينة المحرر ورقة الأنماط الحقيقية للوحدة داخل إطار معزول. فهي تعيد إنتاج عرض متجرك وتتحدّث أثناء الكتابة.
أيقونات الطمأنة ونصوصها
شاحنة، قفل، درع، ورقة شجر، ميدالية، سماعة، ساعة، صاروخ: تقدّم الوحدة ثماني عشرة أيقونة متجهية، اختيرت لتغطي الوعود المعتادة لأي متجر. تُعرض بصيغة SVG مباشرة داخل الصفحة، دون خط أيقونات ودون خادم خارجي. فلا شيء يُنزَّل ولا وميض عند التحميل.
تحتاج إلى رمز غير موجود في القائمة؟ استورد رمزك بصيغة SVG، بحجم 20 كيلوبايت على الأكثر. تنظّفه الوحدة قبل حفظه: تُزال النصوص البرمجية والأنماط والروابط والعناوين الخارجية، ولا يبقى إلا الرسم. تأخذ الأيقونة حجم الأيقونات الأخرى، وبحسب اختيارك لونها أو ألوانها الأصلية.
لكل عنصر عنوان وعنوان فرعي، قابلان للترجمة إلى كل لغات المتجر.
متوافقة مع PrestaShop 1.7 و8 و9
وحدة واحدة وترخيص واحد يغطيان الفروع الثلاثة.
| الفرع | PHP | لوحة التحكم |
|---|---|---|
| 1.7.0 → 1.7.8 | 7.2 → 7.4 | متحكم كلاسيكي |
| 8.0 → 8.2 | 7.4 → 8.1 | متحكم كلاسيكي |
| 9.0 → 9.x | 8.1 → 8.4 | متحكم Symfony أصلي |
في PrestaShop 9، القائمة والنموذج متحكمات Symfony، بقوالب Twig وبتصميم لوحة التحكم الجديدة.
قبل كل نشر، يُثبَّت كل إصدار مذكور ويُضبط ويُعرض ثم يُلغى تثبيته في مصفوفة الاختبار لدينا.
وحدة طمأنة دون override
لا تثبّت هذه الوحدة أي override. المجلد override/ غير موجود.
بالنسبة إلى الوكالات، يعني ذلك: لا تعارض مع وحدة أخرى تعيد تعريف الصنف نفسه، ولا ملفات يتيمة بعد تحديث PrestaShop، ولا شيء يجب تنظيفه قبل الترحيل.
خفيفة وسريعة
أرقام مقيسة على الوحدة كما تُسلَّم، بعد ضغطها بـ gzip (المستوى 9). في واجهة المتجر: ورقة أنماط واحدة بحجم 1.5 كيلوبايت، ولا JavaScript ولا اعتماد على jQuery. يُعرض الشريط من جهة الخادم، وتنتقل إعدادات مظهره كمتغيرات CSS داخل HTML: لا ملف مُولَّد ولا أي اتصال خارجي. سكربت المحرر، 7.4 كيلوبايت، لا يُحمَّل إلا في لوحة الإدارة.
الأسئلة الشائعة
ما الذي تضيفه هذه الوحدة مقارنة بكتلة الطمأنة المرفقة مع PrestaShop؟
الكتلة الأصلية واحدة، في موضع واحد، وإعداداتها قليلة: بعد بضعة خيارات يجب كتابة CSS في القالب. تتيح لك هذه الوحدة إنشاء ما تحتاجه من الأشرطة، لكل منها موضعه ومحتواه ومظهره. ويُضبط المظهر من لوحة التحكم، دون CSS.
هل يمكنني الإبقاء على الكتلة الأصلية في الوقت نفسه؟
نعم. تتعايشان دون تعارض: لا تثبّت هذه الوحدة أي override ولا تمسّ أي إعداد في الكتلة الأصلية. معظم التجار يعطّلون الكتلة الأصلية بعد الانتقال، دون أن يكون ذلك إلزاميًا.
هل هذه الوحدة متوافقة مع إصدار PrestaShop لديّ؟
نعم، من PrestaShop 1.7.0 إلى PrestaShop 9، بترخيص واحد. في PrestaShop 9 تكون قائمة الأشرطة ونموذج الشريط متحكمات Symfony أصلية، بتصميم لوحة التحكم الجديدة. قبل كل نشر، يُثبَّت كل إصدار ويُضبط ثم يُلغى تثبيته في مصفوفة الاختبار لدينا.
هل تحتوي الوحدة على override للنواة؟
لا، لا تحتوي الوحدة على أي override، والمجلد override/ غير موجود. لذلك لا يمكن أن تتعارض مع
أي وحدة أخرى من هذه الناحية، ولا يترك تحديث PrestaShop أي ملف يتيم.
هل يجب أن أعدّل قالبي؟
في الحالة المعتادة، لا: لكل شريط موضعه، يُختار من قائمة من ستة خيارات. وإذا أردت الشريط في مكان لا يوفّره قالبك، راسلنا: نضع لك نقطة الربط مجانًا، في نحو خمس عشرة دقيقة.
هل تبطئ هذه الوحدة متجري؟
لا. يجري العرض على الخادم، والأيقونات SVG مكتوبة مباشرة داخل الصفحة، دون خط أيقونات يُنزَّل ودون اتصال بخادم خارجي. لا يُولَّد أي ملف CSS. وشيفرة JavaScript الوحيدة في الوحدة موجودة في لوحة التحكم؛ ولا يحمّل المتجر أي شيفرة منها.
كيف تتصرف إذا كان لديّ عدد كبير من الأشرطة؟
لا يحمّل كل موضع إلا الأشرطة المخصصة له. وإذا استُدعيت نقطة الربط نفسها عدة مرات في صفحة واحدة، يُعرض الشريط مرة واحدة فقط ولا يراه العميل مكررًا أبدًا.
هل المحتوى متعدد اللغات؟
نعم. يُدخَل كل عنوان وكل عنوان فرعي بكل لغات المتجر، عبر محدد اللغة المعتاد في PrestaShop. والوحدة مرفقة بالفرنسية والإنجليزية.
هل تعمل في وضع المتاجر المتعددة؟
نعم. تُطبَّق إعدادات المظهر على شكل متغيرات CSS موضوعة على الكتلة، دون توليد ملف CSS. لذلك لا يمكن لمتجر أن يطمس مظهر متجر آخر.
ماذا يبقى إذا ألغيت تثبيت الوحدة؟
لا شيء. يزيل إلغاء التثبيت جدول الوحدة وعنصرها في القائمة وإعداداتها في Symfony. لا يبقى أي
ملف في القالب ولا في override/، لأن الوحدة لم تكتب فيهما شيئًا قط. أما الأيقونات التي استوردتها، والمحفوظة في img/lnk_reassurance/،
فتُحذف مع الشرائط التي كانت تستخدمها.
هل تضع الوحدة ملفات تعريف ارتباط؟
لا. لا تضع الوحدة أي ملف تعريف ارتباط أو أداة تتبع، ولا ترسل أي بيانات إلى طرف ثالث. لا شيء تصرّح به في شريط الموافقة لديك.
أنا قادم من الإصدار 2 من الوحدة.
لا يمسّ التحديث بنية قاعدة البيانات: تبقى أشرطتك وعناصرها وإعدادات مظهرها كما هي. وفي PrestaShop 9 ينتقل عنصر القائمة إلى لوحة تحكم Symfony الجديدة.
هل يمكنني استخدام أيقونتي الخاصة؟
نعم، بصيغة SVG وبحجم 20 كيلوبايت على الأكثر: «استيراد أيقونة (SVG)» أسفل شبكة الأيقونات. قد يحتوي
ملف SVG على شيفرة؛ لذا لا تحتفظ الوحدة إلا بالرسم (المسارات والأشكال والألوان) وتزيل كل ما عداه،
بما في ذلك النصوص البرمجية والأنماط والروابط والعناوين الخارجية. يُحفظ الملف بعد تنظيفه في
img/lnk_reassurance/icons/، خارج مجلد الوحدة، فلا يمحوه أي تحديث. تأخذ الأيقونة حجم الأيقونات
الأخرى، وبحسب اختيارك لونها أو ألوانها الأصلية.
سجل الإصدارات
-
الإصدار 3.9.0 PrestaShop 9
فرع PrestaShop 9. أصبح لمتاجر 1.7.6 إلى 8.x حزمتها الخاصة، الإصدار 3.1.0، بالميزات نفسها: لم تعد حزمة PrestaShop 9 تحمل أي شيفرة من لوحة الإدارة القديمة.
الجديد
- أيقونة مستوردة (SVG): في محرر العنصر، «استيراد أيقونة (SVG)»، بحد أقصى 20 كيلوبايت. يُنظَّف الملف وفق قائمة سماح (تُزال النصوص البرمجية والأنماط والروابط و
foreignObjectوسماتon*والكيانات والعناوين الخارجية)، ويُحفظ فيimg/lnk_reassurance/icons/باسم يحمل بصمة، ثم يُعرض في الشبكة مثل الأيقونات المرفقة. يُعرض داخل الصفحة بحجم الأيقونات الأخرى؛ إمّا بلون الأيقونات أو بألوانه الأصلية.
التعديلات
- نصوص العناصر في جداول أصلية: تنتقل العناوين والعناوين الفرعية من JSON في العمود
itemsإلىlnk_reassurance_itemوlnk_reassurance_item_lang، بسطر لكل لغة (ObjectModelLnkReassuranceItem). اللغة المضافة إلى المتجر تحصل على نصوصها عبر آلية النواة. - استمارة الشريط بنموذج Symfony أصلي: النصوص حقول
TranslatableTypeمع محدد اللغة الخاص بـ PrestaShop؛ ست خانات للعناصر، والخانة التي لا عنوان لها لا تُعرض. أُزيل المكرِّر ومحدد اللغة المصنوعان يدويًا. - إعدادات Symfony تُسلَّم في مكانها داخل
config/دون نسخ عند التثبيت. - الألوان ترجع أولًا إلى أدوار الأساس المشترك لقوالب LNK (
--lnk-textو--lnk-mutedو--lnk-accentو--lnk-border)، ثم إلى المظهر السابق. - ترجمة نصوص الوحدة إلى الفرنسية والإنجليزية والعربية.
- ينقل
upgrade/upgrade-3.9.0.phpعناصر كل شريط بكل لغة، ثم يحذف العمودitems. يبقى العرض مطابقًا قبل التحديث وبعده. - لوحة إدارة مُعاد تصميمها: قائمة الأشرطة مجمّعة حسب الموضع (أيقونات، ملخّص، مفتاح تفعيل، نسخ) ومحرّر بأقسام (عناصر قابلة للطي وإعادة الترتيب، شبكة أيقونات، منتقي ألوان حقيقي مع «لون القالب»، معاينة مباشرة للحاسوب والهاتف تتبع اللغة، معاينة بعرض كامل). لم يعد العنوان الفرعي مُخفَّفًا افتراضيًا (التباين)؛ وتحتفظ الأشرطة الموجودة بإعدادها.
- عناوين ملفات CSS وJS الخاصة بالوحدة تحمل بصمة محتواها: بعد أي تحديث، لا تقدّم شبكة CDN ولا المتصفح النسخة القديمة.
الإصلاحات
- يُرفض عند الحفظ أي عنوان أو عنوان فرعي يحتوي على شيفرة.
- أيقونة مستوردة (SVG): في محرر العنصر، «استيراد أيقونة (SVG)»، بحد أقصى 20 كيلوبايت. يُنظَّف الملف وفق قائمة سماح (تُزال النصوص البرمجية والأنماط والروابط و
-
الإصدار 3.1.0 PrestaShop من 1.7.6 إلى 8.x
فرع PrestaShop من 1.7.6 إلى 8.x. أصبح لـ PrestaShop 9 حزمته الخاصة، الإصدار 3.9.0، بالميزات نفسها: لم يعد أي ملف Symfony يُسلَّم إلى متاجر 1.7 و8.
الجديد
- أيقونة مستوردة (SVG): في محرر العنصر، «استيراد أيقونة (SVG)»، بحد أقصى 20 كيلوبايت. يُنظَّف الملف وفق قائمة سماح (تُزال النصوص البرمجية والأنماط والروابط و
foreignObjectوسماتon*والكيانات والعناوين الخارجية)، ويُحفظ فيimg/lnk_reassurance/icons/باسم يحمل بصمة، ثم يُعرض في الشبكة مثل الأيقونات المرفقة. يُعرض داخل الصفحة بحجم الأيقونات الأخرى؛ إمّا بلون الأيقونات أو بألوانه الأصلية.
التعديلات
- نصوص العناصر في جداول أصلية: تنتقل العناوين والعناوين الفرعية من JSON في العمود
itemsإلىlnk_reassurance_itemوlnk_reassurance_item_lang، بسطر لكل لغة (ObjectModelLnkReassuranceItem). اللغة المضافة إلى المتجر تحصل على نصوصها عبر آلية النواة. - استمارة الشريط بـ HelperForm أصلي مع محدد اللغة الخاص بـ PrestaShop: ست خانات للعناصر، والخانة التي لا عنوان لها لا تُعرض. أُزيل المكرِّر ومحدد اللغة المصنوعان يدويًا.
- ترجمة نصوص الوحدة إلى الفرنسية والعربية عبر نظام ترجمة الوحدات (
translations/fr.phpوar.php)، وهو الوحيد الذي يحمّله PrestaShop 1.7.6 و1.7.7 للوحدة؛ ويُكتب الشريط المُنشأ عند التثبيت بكل لغة مع ترجمتها. - ينقل
upgrade/upgrade-3.1.0.phpعناصر كل شريط بكل لغة، ثم يحذف العمودitems. يبقى العرض مطابقًا قبل التحديث وبعده. - لوحة إدارة مُعاد تصميمها: قائمة الأشرطة مجمّعة حسب الموضع (أيقونات، ملخّص، مفتاح تفعيل، نسخ) ومحرّر بأقسام (عناصر قابلة للطي وإعادة الترتيب، شبكة أيقونات، منتقي ألوان حقيقي مع «لون القالب»، معاينة مباشرة للحاسوب والهاتف تتبع اللغة، معاينة بعرض كامل). لم يعد العنوان الفرعي مُخفَّفًا افتراضيًا (التباين)؛ وتحتفظ الأشرطة الموجودة بإعدادها.
- عناوين ملفات CSS وJS الخاصة بالوحدة تحمل بصمة محتواها: بعد أي تحديث، لا تقدّم شبكة CDN ولا المتصفح النسخة القديمة.
الإصلاحات
- يُرفض عند الحفظ أي عنوان أو عنوان فرعي يحتوي على شيفرة.
- أيقونة مستوردة (SVG): في محرر العنصر، «استيراد أيقونة (SVG)»، بحد أقصى 20 كيلوبايت. يُنظَّف الملف وفق قائمة سماح (تُزال النصوص البرمجية والأنماط والروابط و
-
الإصدار 3.0.0 PrestaShop من 1.7.6 إلى 8.x
أول إصدار قابل للتوزيع. كانت الإصدارات السابقة تطويرًا مخصصًا لمتجر واحد؛ أما هذا الإصدار فقد نُقل إلى فروع PrestaShop الثلاثة وأصبح معروضًا للبيع.
الجديد
- لوحة تحكم Symfony أصلية لـ PrestaShop 9: القائمة والنموذج متحكمات
PrestaShopAdminController+ Twig، تُنشر عند التثبيت وفقط إذا سمح الإصدار بذلك. والسكربت نفسه يدير مكرّر العناصر في لوحتي التحكم. LnkReassuranceDesign: خرجت تسوية المظهر وعرضه من الوحدة لتصبح صنفًا خالصًا يمكن اختباره دون متجر.tests/test-design.php: 42 عملية تحقق على التعقيم، منها القيم العدائية: لون يحاول الخروج من تصريح CSS الخاص به، ورقم خارج الحدود، وتخطيط خارج القائمة المسموح بها.lnk_reassurance::saveFromRequest(): نقطة دخول وحيدة للكتابة، تتقاسمها لوحتا التحكم.upgrade/upgrade-3.0.0.php: نقل عنصر القائمة إلى مسار Symfony في الفرع 9، دون المساس ببنية قاعدة البيانات.- توثيق كامل: التثبيت، والتوافق، ونقاط الربط، ونقاط الربط المخصصة، وصفحة المتجر، والأسئلة الشائعة.
التعديلات
- تبقى الدوال الساكنة الخاصة بالمظهر (
designDefaultsوsafeColorوsanitizeDesignوdesignStyleوdesignClasses) متاحة في الوحدة بصفتها واجهة، يمكن لقالب معاد تعريفه أن يعتمد عليها، لكنها تحيل إلىLnkReassuranceDesign.
الإصلاحات
- محتوى تجريبي خاص بأحد العملاء كان يُزرع عند التثبيت (ورشات ومدن وآجال خاصة بمتجر واحد). استُبدل بشريط عام (التوصيل، الدفع، الإرجاع، خدمة العملاء) موضوع على
displayReassurance: أصبح التاجر يرى شيئًا فور التثبيت، وهذا الشيء يعنيه. - تسميات لوحة التحكم مكتوبة بالفرنسية داخل الشيفرة، بصيغة الترجمة الخاصة بـ PrestaShop 1.6 (
mod=). أصبح كل شيء بمصدر إنجليزي مع نطاق (Modules.Lnkreassurance.Admin) وكتالوج فرنسي مرفق. - أنماط وسكربتات مكتوبة مباشرة داخل قالب إداري. أصبحت الآن في
views/css/admin.cssوviews/js/admin-items.js، وتنتقل البيانات التي يحتاجها السكربت عبر سماتdata-: لم يعد أي متغير يُكتب داخل الصفحة. - كان زر الحذف ومبدّل التفعيل يمرّان عبر رابط: أصبحا الآن نموذجين بطريقة POST، مع رمز أمان، في لوحة تحكم Symfony.
- لوحة تحكم Symfony أصلية لـ PrestaShop 9: القائمة والنموذج متحكمات
عرض 3 إصدارات سابقة
-
الإصدار 2.1.0 PrestaShop من 1.7.6 إلى 8.x
الوضع على نقاط ربط أصلية، وإعدادات المظهر في لوحة التحكم، ومعاينة مباشرة. غير موزَّع.
-
الإصدار 2.0.0 PrestaShop من 1.7.6 إلى 8.x
الانتقال إلى جدول مخصص، وأشرطة متعددة. غير موزَّع.
-
الإصدار 1.0.0 PrestaShop من 1.7.6 إلى 8.x
الإصدار الأول، تطوير مخصص. غير موزَّع.