تجاوز إلى المحتوى الرئيسي
الإصدار: 1.x

قوالب الإيصالات

يتيح لك محرر قالب الإيصال تخصيص مظهر ومحتوى الإيصالات المطبوعة من نظام نقاط البيع الخاص بك. يمكنك الوصول إلى محرر القالب من خلال التنقل إلى: WP Admin > POS > Templates

نظرة عامة​

يقدم نظام القوالب نوعين من القوالب:

  • القوالب الافتراضية: يتم اكتشافها تلقائيًا من ملفات الإضافات والقوالب الخاصة بك. لا يمكن حذفها ولكن يمكن نسخها لإنشاء إصدارات مخصصة.
  • القوالب المخصصة: قوالب تم إنشاؤها بواسطة المستخدم يمكنك تخصيصها وتعديلها وإدارتها بالكامل.

الوصول إلى محرر القالب​

  1. انتقل إلى لوحة إدارة ووردبريس الخاصة بك
  2. انتقل إلى POS > Templates
  3. سترى قائمة بالقوالب المتاحة منظمة في قسمين:
    • القوالب الافتراضية (من ملفات الإضافات/القوالب)
    • القوالب المخصصة (إنشاءاتك المخصصة)

القوالب الافتراضية​

يكتشف النظام قوالب الإيصالات تلقائيًا من ثلاثة مصادر:

مصادر القالب​

المصدرالوصفالحالة
الإضافةقالب الإيصال الأساسي المضمن مع WCPOSمتاح دائمًا
الإضافة المحترفةقالب معزز من WCPOS Proمتاح مع ترخيص نشط
القالبقالب مخصص من قالبك النشطمتاح إذا كان القالب يتضمن قالبًا

إجراءات القالب​

بالنسبة لكل قالب افتراضي، يمكنك:

  • معاينة: عرض كيف يبدو القالب مع بيانات تجريبية
  • نسخ: إنشاء نسخة مخصصة يمكنك تعديلها
  • تفعيل: تعيينه كقالب نشط لنقاط البيع الخاصة بك

إنشاء القوالب المخصصة​

الطريقة 1: النسخ من قالب افتراضي​

  1. في قسم القوالب الافتراضية، ابحث عن القالب الذي ترغب في تخصيصه
  2. انقر على زر نسخ
  3. أدخل اسمًا لقالبك المخصص
  4. انقر على نسخ القالب
  5. قم بتعديل القالب المخصص الذي تم إنشاؤه حديثًا

الطريقة 2: إنشاء من الصفر​

  1. انقر على إضافة قالب جديد في أعلى الصفحة
  2. أدخل اسم القالب
  3. اختر إيصال كنوع القالب
  4. ابدأ في كتابة الكود لقالبك في المحرر

ميزات محرر القالب​

يوفر محرر القالب:

محرر الكود​

  • تسليط الضوء على التركيب النحوي: تسليط الضوء على تركيب PHP لقراءة كود أفضل
  • أرقام الأسطر: تنقل سهل وتصحيح الأخطاء
  • تحرير ملء الشاشة: بيئة تحرير خالية من المشتتات

لوحة إعدادات القالب​

  • اللغة: ضبط على PHP لإبراز التركيب النحوي بشكل صحيح
  • نوع القالب: اختر بين قوالب الإيصال أو التقرير
  • الحالة: إدارة حالة النشر/المسودة
  • الرؤية: التحكم في رؤية القالب

إجراءات القالب​

  • معاينة: شاهد كيف يبدو قالبك مع بيانات تجريبية
  • تعيين كقالب نشط: اجعل هذا القالب هو الافتراضي لنقاط البيع الخاصة بك
  • تحديث: احفظ تغييراتك
  • نقل إلى سلة المهملات: حذف القوالب المخصصة

هيكل القالب​

قوالب الإيصالات هي ملفات PHP تُنتج مخرجات HTML. إليك الهيكل الأساسي:

<?php
/**
 * Custom Receipt Template
 */

if ( ! defined( 'ABSPATH' ) ) {
    exit; // Exit if accessed directly
}
?>
<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
    <meta charset="<?php bloginfo( 'charset' ); ?>">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <style>
        /* Your custom CSS styles */
        body { font-family: sans-serif; font-size: 14px; }
        .receipt-header { text-align: center; margin-bottom: 20px; }
        /* Add more styles as needed */
    </style>
</head>
<body>
    <!-- Your receipt content -->
    <div class="receipt-header">
        <h1><?php echo get_bloginfo( 'name' ); ?></h1>
        <p><?php echo get_bloginfo( 'description' ); ?></p>
    </div>

    <!-- Order details, items, totals, etc. -->

</body>
</html>

متغيرات القالب المتاحة​

عند إنشاء قوالب مخصصة، لديك الوصول إلى وظائف ووردبريس وووكومرس المختلفة والبيانات:

معلومات المتجر​

  • get_bloginfo( 'name' ) - اسم المتجر
  • get_bloginfo( 'description' ) - شعار المتجر
  • get_bloginfo( 'url' ) - عنوان URL للمتجر

بيانات الطلب​

تتوفر بيانات الطلب الحالية من خلال وظائف الطلب القياسية لووكومرس عند عرض القالب.

وظائف WCPOS​

يمكنك استخدام وظائف محددة لـ WCPOS (مسبوقة بـ wcpos_) للوصول إلى بيانات ونشاطات نقاط البيع.

أفضل الممارسات​

تطوير القالب​

  1. ابدأ بنسخة: ابدأ دائمًا بنسخ قالب افتراضي بدلاً من إنشاء واحد من الصفر
  2. اختبر بدقة: استخدم وظيفة المعاينة لاختبار قالبك قبل تفعيله
  3. احتفظ بنسخ احتياطية: قم بتصدير قوالبك المخصصة أو احتفظ بنسخ من كودك
  4. ملائم للجوَّال: تأكد من أن قوالبك تعمل بشكل جيد على أحجام الشاشات المختلفة

جودة الكود​

  1. تحقق من HTML: تأكد من أن HTML الخاص بك على نحو جيد التكوين
  2. استخدم الهروب عند الخروج: استخدم وظائف الهروب في ووردبريس لضمان الأمان
  3. معالجة الأخطاء: ضع تحققًا صحيحًا للأخطاء في كود PHP الخاص بك
  4. التعليقات: قم بتوثيق التعديلات الخاصة بك للرجوع إليها في المستقبل

الأداء​

  1. تحسين CSS: احتفظ بالأنماط بسيطة وفعالة
  2. تقليل PHP: تجنب المنطق المعقد في القوالب
  3. اختبار الطباعة: تحقق من أن القوالب تعمل بشكل جيد مع طابعات الإيصالات الخاصة بك

استكشاف الأخطاء وإصلاحها​

المشكلات الشائعة​

القالب لا يظهر التغييرات
  • تأكد من أنك نقرت على "تحديث" لحفظ تغييراتك
  • تحقق من أن القالب مضبوط على أنه "نشط"
  • امسح أي إضافات تخزين مؤقت
أخطاء التركيب النحوي
  • استخدم تسليط الضوء على التركيب النحوي لتحديد المشكلات
  • تحقق من وجود نقاط فاصلة أو أقواس أو علامات اقتباس مفقودة
  • تحقق من تركيب PHP الخاص بك
مشكلات التنسيق
  • اختبر CSS الخاص بك في وضع المعاينة
  • تأكد من توافق الأنماط مع طابعات الإيصالات
  • ابقِ مبادئ التصميم الملائمة للطباعة في ذهنك
القالب غير متاح
  • تحقق من تعيين نوع القالب إلى "إيصال"
  • تحقق من أن حالة القالب هي "منشور"
  • تأكد من أن لديك الأذونات المناسبة

الحصول على المساعدة​

إذا واجهت مشاكل مع تخصيص القالب:

  1. تحقق من معاينة القالب لرسائل الخطأ
  2. راجع سجل تصحيح الأخطاء في ووردبريس لأخطاء PHP
  3. اختبر مع نسخة من القالب الافتراضي أولاً
  4. مساعدة الذكاء الاصطناعي: تعتبر أدوات الذكاء الاصطناعي الحديثة مثل Gemini وChatGPT وClaude ممتازة في مساعدتك مع قوالب ووردبريس البسيطة مثل هذه. يمكنك لصق كود القالب الخاص بك ووصف ما تريد تحقيقه.
  5. استشر وثائق WCPOS لمزيد من التخصيص المتقدم

التخصيص المتقدم​

للمستخدمين المتقدمين الذين يحتاجون إلى مزيد من التحكم في قوالب الإيصالات:

تكامل القالب​

يمكنك تجاوز القالب الافتراضي عن طريق وضع ملف receipt.php مخصص في قالبك:

your-theme/woocommerce-pos/receipt.php

الارتباطات والترشيحات​

يوفر WCPOS العديد من الارتباطات والترشيحات لتخصيص القالب. استشر وثائق المطورين لمعرفة الخيارات المتاحة.

الحقول المخصصة​

يمكنك تضمين حقول الطلب المخصصة وسمات المنتج وبيانات وصفية أخرى في قوالب الإيصالات الخاصة بك باستخدام وظائف ووردبريس وووكومرس المناسبة.