إتقان قوالب الصفحات المخصصة في WooCommerce: دليل تطوير عملي بدءًا من الصفر إلى واحد.

2 دقيقة للقراءة
2026-03-14
2026-06-03
2,617
أنا أحصل على عمولة عند التسوق عبر الروابط أدناه، ولا يُضاف أي تكلفة عليك.

تعرف على نظام قوالب WooCommerce ومتطلبات التخصيص.

يستخدم WooCommerce نظامًا قويًا لتجاوز القوالب، مما يسمح للمطورين بتخصيص مظهر وتخطيط صفحات المتجر دون تعديل ملفات المكوّن الإضافي الأساسية. تم بناء هذا النظام على مفهوم الموضوعات الفرعية في WordPress، مما يضمن استقرار التخصيص وقابلية التحديث في المستقبل. توجد جميع ملفات القوالب في WooCommerce في المجلد wp-content/themes/woocommerce/. plugins/woocommerce/templates إنها في الدليل، لكن يُمنع منعًا باتًا إجراء أي تعديلات مباشرةً من هنا، لأن تحديث الإضافة سيؤدي إلى الكتابة فوق جميع التغييرات.

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

الخطوات الأساسية لإنشاء قالب مخصص.

يبدأ إنشاء قالب صفحة WooCommerce مخصص بإنشاء موضوع فرعي لـ WordPress. هذا هو الأساس الآمن لجميع الأعمال المخصصة. في دليل الموضوع الفرعي الخاص بك، تحتاج إلى إنشاء ملف يسمى woocommerce مجلد. تبحث WooCommerce أولاً عن ملفات القالب في هذا المجلد، وإذا لم تجدها، فستعود إلى القوالب المضمنة في الإضافة.

القراءة الموصى بها تحليل متعمق لمكوّن WooCommerce الإضافي: دليل كامل من الإعدادات الأساسية إلى التخصيص المتقدم.

تحديد موقع ملف القالب المستهدف ونسخه.

افترض أنك تحتاج إلى تخصيص الصفحة الرئيسية للمتجر (صفحة الأرشيف). أولاً، تحتاج إلى العثور على الملف الأصلي من دليل إضافات WooCommerce:plugins/woocommerce/templates/archive-product.phpقم بنسخ هذا الملف إلى موضوعك الفرعي. woocommerce تحت "القائمة". الآن، سيتم تطبيق أي تعديلات تُجرى على هذه النسخة. هذه هي أكثر الطرق مباشرة للتخصيص، وهي مناسبة لتعديلات الأسلوب أو التغييرات الطفيفة في المنطق في القوالب الموجودة.

خادم ووردبريس من شركة UltaHost
ضمان استرداد المال خلال 30 يومًا، عرض نطاق ترددي وقواعد بيانات غير محدودين، حماية مجانية ضد هجمات DDoS، خصم 50% عند الشراء لمدة 3 سنوات (السعة المتاحة: 501–4 تيرابايت).

إضافة أو إزالة المحتوى من خلال دالات الخطاف.

يستخدم WooCommerce على نطاق واسع خطافات الإجراءات (Action Hooks) وخطافات الفلتر (Filter Hooks)، والتي توفر طريقة أخرى أكثر مرونة وأقل تدخلاً للتخصيص. على سبيل المثال، إذا أردت إضافة نص مخصص أسفل عنوان صفحة تفاصيل المنتج، فبدلاً من تعديله مباشرةً، single-product.php قالب، لماذا لا تضعه في موضوعك الفرعي؟ functions.php يتم استخدام الخطافات في المستند.

فيما يلي مثال على الكود الذي يوضح كيفية استخدامه. woocommerce_single_product_summary محتوى الإضافة الخاص بالخطاف:

add_action( 'woocommerce_single_product_summary', 'my_custom_product_text', 6 );
function my_custom_product_text() {
    echo '<p class="my-custom-text">هذا هو المحتوى المخصص الذي تم إضافته إلى منطقة ملخص المنتج.</p>';
}

من خلال ضبط الأولوية (الرقم 6 في الكود أعلاه)، يمكنك التحكم بدقة في موضع ظهور هذا المحتوى.

تطوير قوالب صفحات مخصصة متقدمة.

بالنسبة لتخطيط الصفحة الجديد بالكامل، قد لا يكون إعادة كتابة القالب الحالي كافيًا. ستحتاج إلى إنشاء ملف قالب صفحة مخصص حقيقي.

القراءة الموصى بها دليل شامل لتطوير موقع التجارة الإلكترونية على WooCommerce: دليل كامل من الصفر إلى الإطلاق.

إنشاء نموذج جديد لتصنيف المنتجات.

يمكنك إنشاء قالب مخصص لفئة منتج معينة. أولاً، في ملفات المظهر الفرعية. woocommerce في المجلد، قم بنسخ. archive-product.php وإعادة تسميته إلى taxonomy-product_cat-{slug}.phpو من بينها. {slug} استبدل بالأسماء المستعارة للتصنيفات المستهدفة. على سبيل المثال، لإنشاء قالب للتصنيف الذي يحمل الاسم المستعار “electronics”، يجب أن يكون اسم الملف كالتالي: taxonomy-product_cat-electronics.phpفي هذا الملف، يمكنك إعادة تنظيم الحلقات، أو إدخال استعلامات مخصصة، أو إضافة عناصر صفحات فريدة.

إنشاء ملف نموذج صفحة مخصص.

أحيانًا، تحتاج إلى صفحة مستقلة تمامًا عن المسار القياسي لـ WooCommerce. في هذه الحالة، يمكنك إنشاء قالب صفحة WordPress قياسي. قم بإنشاء ملف تحت الدليل الجذري للمظهر الفرعي الخاص بك، على سبيل المثال. template-custom-store.phpوأضف إعلان النموذج التالي في رأس المستند:

<?php
/**
 * Template Name: 自定义商店布局
 * Template Post Type: page
 */

بعد ذلك، قم بإنشاء صفحة جديدة في الواجهة الخلفية لـ WordPress، واختر “تخطيط المتجر المخصص” في القائمة المنسدلة “القوالب”. داخل ملف القالب هذا، يمكنك استخدام وظائف القوالب و المتغيرات العالمية لـ WooCommerce (مثل $product, WC()يمكنك استخدام واجهة برمجة التطبيقات (API) للبحث عن المنتجات وعرضها، وتصميم تخطيط ومنطق الصفحة بأكملها بحرية، دون أي قيود على هيكل صفحة المتجر الافتراضي.

استضافة.كوم استضافة مشتركة
أداء عالٍ مع وحدات المعالجة المركزية AMD EPYC، ووحدات تخزين NVMe SSD وLiteSpeed، ودعم داخلي متخصص على مدار الساعة طوال أيام الأسبوع، وتدابير أمنية متقدمة بما في ذلك SSL، وقوة الغاشمة، والحماية من البرامج الضارة والحماية من DDoS، وتوفير ما يصل إلى 731 تيرابايت 4 تيرابايت

تقنيات متقدمة وممارسات فضلى لتخصيص القوالب.

عند تطوير قوالب مخصصة، اتباع بعض أفضل الممارسات يضمن قوة الشفرة وسهولة صيانتها.

استدعاء وظائف وبيانات WooCommerce بأمان.

في قالب مخصص، تأكد من تحميل بيئة WooCommerce. يمكنك إجراء فحص حالي قبل استخدام أي وظيفة أو متغير عالمي خاص بـ WooCommerce. على سبيل المثال، في منتجات الدورة، من الممارسة المعتادة استخدام In a custom template, make sure that the WooCommerce environment has been loaded. You can perform a conditional check before using any WooCommerce-specific functions or global variables. For example, in product loops, it's standard practice to use wc_get_loop_prop( 'name' ) تحقق من نوع الحلقة، أو استخدم is_product()is_shop() علامات التبويب الخاصة بالشروط. عند الوصول إلى بيانات المنتج، يجب استخدامها كأولوية. WC()->product_factory->get_product() أو wc_get_product() استخدم وظيفة للحصول على كائن المنتج، بدلاً من التعامل مع المتغيرات العالمية مباشرةً.

تأكد من أن قالبك متجاوب وذو أداء مُحسّن.

لا يجب أن تؤدي القوالب المخصصة إلى تدمير تصميم الموقع الإلكتروني القابل للتكيف مع أحجام الشاشات المختلفة (التصميم الاستجابي). تأكد من أن الكود HTML وCSS الذي تضيفه قادر على التكيف مع أحجام الشاشات المتنوعة. كما يجب أن تكون حذرًا من المشاكل التي قد تؤثر على أداء الموقع نتيجة استخدام هذه القوالب؛ تجنب تنفيذ عمليات استعلام معقدة على قواعد البيانات أو استدعاء عدد كبير من الخدمات الخارجية (APIs) داخل الحلقات (loops). استخدم آليات التخزين المؤقت (الكاش) المتاحة في منصة WooCommerce بشكل مناسب، م wc_get_products هذه الوظيفة الفعالة للبحث عن المنتجات، إنها أفضل من الوظيفة القياسية. WP_Query إنه أكثر ملاءمة لبيانات منتجات WooCommerce.

القراءة الموصى بها الدليل النهائي لـ WooCommerce: ​​دليل كامل لإنشاء متجر على الإنترنت من الصفر إلى الإطلاق.

تنظيم قوالب المواضيع الفرعية.

يجب أن تُكتب جميع الأنماط المخصصة في الموضوع الفرعي. style.css في الوثيقة. ومن أجل الحفاظ على التنظيم والوضوح، يُفضل كتابة كتل CSS منفصلة لمكونات قوالب WooCommerce المختلفة، وإضافة تعليقات مفصلة. استخدم محددات الانتقاء (selectors) التي تتوافق مع بنية ملف القالب الأصلي من أجل إجراء تغييرات على الأنماط، بحيث تكون أنماطك محددة بشكل كافٍ لتغطية الأنماط الافتراضية. على سبيل المثال، بالنسبة لقالب التصنيف المخصص الخاص بك، يمكنك تحديد: body.term-product_cat-electronics أضف قواعد أسلوب محددة.

الملخصات

إن إتقان تطوير قوالب الصفحات المخصصة لـ WooCommerce هو مهارة أساسية لتحسين تفرد ووظائف مواقع التجارة الإلكترونية على WordPress. يبدأ الأمر بفهم نظام الكتابة فوق القوالب، ومن ثم إجراء تخصيصات أساسية عن طريق نسخ وتعديل القوالب الحالية، وصولاً إلى استخدام الدوال المشتركة لتحقيق تحكم مرن في المحتوى، وأخيرًا إنشاء ملفات قوالب جديدة تمامًا لتلبية متطلبات التصميم المعقدة. تؤكد العملية بأكملها على العمل في المظاهر الفرعية لضمان أمان التحديثات الأساسية. اتباع أفضل الممارسات، مثل الاستدعاء الآمن للبيانات، والتركيز على الاستجابة والأداء، وتنظيم شفرة الأنماط، هي ضمانات لتطوير صفحات متجر مخصصة احترافية ومستقرة وفعالة. من خلال دليل "من الصفر إلى واحد"، ستتمكن من تجاوز قيود القوالب الافتراضية وإنشاء متجر WooCommerce يلبي أهداف عملك حقًا.

الاستضافة المشتركة InterServer
استضافة مشتركة $2.50 دولار أمريكي في الشهر، الشهر الأول $0.1 دولار أمريكي الرمز الترويجي tryinterserver، 461 نص برمجي للتطبيقات السحابية، تثبيت بنقرة واحدة.

الأسئلة الشائعة الأسئلة المتداولة

هل يجب استخدام موضوعات فرعية لتعديل قوالب WooCommerce؟

يُنصح بشدة ويعد هذا أفضل ممارسة في هذا المجال. إن تعديل ملفات القالب مباشرةً في الموضوع الأم أو دليل المكون الإضافي سيتم استبدالها بالكامل عند تحديث WooCommerce أو الموضوع، مما يؤدي إلى فقدان جميع المحتوى المخصص. باستخدام الموضوع الفرعي، يمكنك عزل تعديلاتك عن الملفات الأساسية، وضمان قابلية صيانة موقع الويب وأمانه.

كيف يمكنني البحث عن ملف القالب الخاص بـ WooCommerce المقابل لصفحة معينة؟

يوفر WooCommerce وضعًا للاكتشاف للمساعدة في تحديد موقع ملفات القالب. في قوالبك الفرعية، functions.php أضف الشفرة التالية إلى الملف:add_filter( 'woocommerce_template_debug_mode', '__return_true' );بعد التفعيل، سيعرض WooCommerce في أسفل الصفحة الرئيسية للموقع جميع مسارات ملفات القالب المستخدمة في الصفحة الحالية، مما يسهل عليك العثور بسرعة على الملفات المستهدفة التي تحتاج إلى الكتابة فوقها.

بعد تخصيص القالب، لماذا لا تظهر التغييرات في الواجهة الأمامية؟

أولاً، تأكد من أنك قمت بإفراغ ذاكرة التخزين المؤقت للموقع والمتصفح بشكل صحيح. ثانياً، تحقق مما إذا كان مسار الملف واسمه صحيحين، وتأكد من أن أي ملفات قوالب مخصصة موجودة في الموضوع الفرعي. /woocommerce/ تحت الدليل، ويجب أن يكون اسم الملف متطابقًا تمامًا مع هيكل قوالب WooCommerce. وأخيرًا، تحقق من وجود أي أخطاء نحوية في الكود، ويمكنك محاولة تمكين WordPress مؤقتًا. WP_DEBUG استخدم النموذج للتحقق مما إذا كان يتم إخراج رسائل الخطأ في PHP أم لا.

هل يمكن إنشاء قالب مخصص لمنتج واحد؟

يمكنك ذلك. تسمح WooCommerce بإنشاء قوالب مخصصة لمنتج واحد. ستحتاج إلى إجراء ذلك في ملف style.css للمظهر الفرعي. woocommerce في المجلد، قم بنسخ. single-product.php وإعادة تسميته إلى single-product-{slug}.php أو single-product-{id}.php. سوف {slug} استبدله باسم مستعار للمنتج، أو قم بـ {id} يمكنك استبدالها بالمعرف الرقمي للمنتج، مما يسمح بتطبيق تخطيط نموذجي فريد من نوعه لهذا المنتج المحدد.