البدء من الصفر: إتقان المعرفة الأساسية لمواضيع ووردبريس (WordPress Themes)
لفهم تطوير مواضيع ووردبريس (WordPress themes)، من الضروري أولاً توضيح مكوناتها الأساسية. موضوع ووردبريس في جوهره عبارة عن مجموعة من الملفات التي تحدد مظهر الموقع الإلكتروني ووظائفه، وتشمل هذه الملفات أنماط الصفحات (style sheets)، ملفات القوالب (template files)، سكريبتات الدوال (function scripts)، بالإضافة إلى الموارد مثل الصور وغيرها. الملف الأساسي في أي موضوع ووردبريس هو… style.css و index.phpالأول هو ملف “بطاقة الهوية” للموضوع وملف تعريف الأسلوب (style definition file)، بينما الثاني هو ملف القالب الافتراضي (default template file).
ملف رأس معلومات الموضوع (Theme Information Header File)
يجب أن يحتوي المجلد الرئيسي لكل موضوع على عنصر واحد على الأقل. style.css الملف يحتوي في بدايته على تعليق خاص، يُستخدم لإعلام ووردبريس بالمعلومات الأساسية عن القالب (التيمة). هذا التعليق الأساسي هو المفتاح لتمييز القالب وتفعيله من قبل ووردبريس.
/*
Theme Name: 我的第一个主题
Theme URI: https://example.com/my-first-theme
Author: 开发者名称
Author URI: https://example.com
Description: 这是一个用于学习 WordPress 主题开发的简单主题。
Version: 1.0.0
License: GNU General Public License v2 or later
Text Domain: my-first-theme
*/ من بينها،Text Domain يُستخدم لأغراض التدويل، وهو الرمز الأساسي لتحميل ملفات الترجمة لاحقًا.
القراءة الموصى بها دليل البدء في تطوير مواقع ووردبريس: بناء مواقع مخصصة من الصفر。
دور ملفات القالب الأساسية.
بالإضافة إلى… style.cssيجب أن يحتوي الموضوع على ملف قالب PHP واحد على الأقل. والأساسي من بينها هو… index.phpإنه القالب الاحتياطي لجميع الصفحات؛ يتم استخدامه عندما لا يتمكن WordPress من العثور على ملف قالب أكثر تحديدًا. تشمل ملفات القوالب الهامة الأخرى تلك المستخدمة لعرض مقال واحد. single.phpيُستخدم لعرض قوائم المقالات. archive.phpيُستخدم لعرض المحتوى على الصفحة. page.php وكذلك تعريف الجزء العلوي والسفلي من الموقع الإلكتروني. header.php و footer.php。
بناء مستويات القوالب الأساسية للموضوع (Building the core template hierarchy for a topic)
يستخدم WordPress نظام مستويات القوالب (template hierarchy) لتحديد ملف القالب الذي سيتم استخدامه للصفحة المطلوبة. يعمل هذا النظام وفقًا لمبدأ “من الخاص إلى العام” (from specific to general)، مما يتيح للمطورين تصميم صفحات مخصصة بدقة لأنواع مختلفة من الصفحات.
فهم ترتيب تحميل القوالب (Templates)
عندما يزور المستخدم مقالة في مدونة، يقوم WordPress بالبحث تباعاً عن ملفات القوالب (templates) التالية:single-{post-type}-{slug}.php、single-{post-type}.php、single.phpوفي النهاية، singular.php و index.phpعلى سبيل المثال، بالنسبة لصفحة بعنوان “about” (حيث نوع المنشور هو “page”)، سيبدأ ووردبريس أولاً بالبحث عن… page-about.phpثم ابحث. page.phpويتم استخدامها في النهاية فقط. index.php。
إنشاء ملفات قوالب شائعة الاستخدام
عادةً ما يحتوي الموضوع الشامل والمتكامل الوظائف على الملفات القالبية الأساسية التالية:
- header.phpيحتوي على إعلان نوع المستند (document type declaration).<head> الجزء الأول من المنطقة والموقع الإلكتروني (مثل قائمة التنقل). يمكن استخدامه في قوالب أخرى. get_header() إدخال الدوال (Function Introduction).
- footer.phpيحتوي على الجزء النهائي من الموقع الإلكتروني (مثل معلومات حقوق النشر). استخدمه. get_footer() إدخال الدوال (Function Introduction).
- index.phpالقالب الرئيسي، يعتبر الخيار الاحتياطي النهائي لجميع الصفحات.
- page.phpيُستخدم لعرض الصفحات الثابتة.
- single.phpيُستخدم لعرض مقال واحد فقط.
- archive.phpيُستخدم لعرض التصنيفات، والتسميات، والمؤلفين، والتواريخ، وغيرها من محتويات صفحات الأرشيف.
من خلال تقسيم هذه الأجزاء، يمكن تحسين قابلية إعادة استخدام الكود وصيانته بشكل كبير. في قوالب الحلقة الرئيسية، يتم عادةً استخدام هيكل مشابه لما يلي:
القراءة الموصى بها دليل عملي للبدء في تطوير مواقع ووردبريس: إنشاء هيكل وقوالب مواقع مخصصة من الصفر。
<?php
if ( have_posts() ) :
while ( have_posts() ) : the_post();
// 显示文章内容
the_title( '<h2>', '</h2>' );
the_content();
endwhile;
else :
// 如果没有文章
echo '<p>暂无内容。</p>';
endif;
?> استخدام الدوال والمكونات الإضافية (الهوكس – hooks) لتعزيز وظائف الموضوع (theme functions).
موضوع ممتاز لا يجب أن يتمتع فقط بواجهة جميلة، بل يجب أن يكون أيضًا قابلًا للتوسعة بشكل كبير. يتم تحقيق ذلك بشكل أساسي من خلال ميزتين أساسيتين في ووردبريس: الدوال (Functions) والخطافات (Hooks). الملف الرئيسي (Main File). functions.php هذا هو المكان الرئيسي الذي سيتم فيه إضافة هذه الميزات.
ملف وظائف الموضوع (Theme Function File)
functions.php يتم تحميل الملف تلقائيًا عند تهيئة الموضوع (theme)، ويُستخدم لتعريف وظائف الموضوع، وتسجيل القوائم (menus)، والشرائط الجانبية (sidebars)، بالإضافة إلى إضافة مختلف المرشحات (filters) والإجراءات (actions). إنه يعمل كـ “الدماغ” للمو
على سبيل المثال، الكود المستخدم لتسجيل قائمة تنقل وتفعيل ميزة ملخصات المقالات هو كالتالي:
<?php
function my_theme_setup() {
// 注册一个导航菜单位置
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-first-theme' ),
) );
// 启用文章特色图像支持
add_theme_support( 'post-thumbnails' );
}
add_action( 'after_setup_theme', 'my_theme_setup' );
?> تم استخدام "خطافات الإجراءات" (Action Hooks) هنا. after_setup_themeيسمح لنا بتنفيذ الدوال الخاصة بنا بعد إكمال الإعدادات الأساسية للموضوع. my_theme_setup。
فهم الإجراءات (Actions) والمرشحات (Filters)
تنقسم الأدوات المستخدمة في ووردبريس (WordPress) إلى نوعين: الأفعال (Actions) والمرشحات (Filters). تسمح الأفعال بإدخال وتنفيذ كودك الخاص في نقاط زمنية محددة، مثل عرض محتوى إضافي بعد نص المقالة. أما المرشحات فهي تسمح بتعديل البيانات التي يتم إنتاجها أثناء تشغيل ووردبريس.
على سبيل المثال، استخدام مرشح لتعديل طول نص الملخص:
القراءة الموصى بها دليل تطوير مواقع ووردبريس: بناء مواقع مهنية من الصفر。
<?php
function my_excerpt_length( $length ) {
return 20; // 将摘要长度改为20个单词
}
add_filter( 'excerpt_length', 'my_excerpt_length' );
?> واستخدم خطوة لإضافة إشعار حقوق النشر في نهاية محتوى المقال:
<?php
function my_post_footer( $content ) {
if ( is_single() ) {
$content .= '<p class="copyright">本文版权归本站所有。</p>';
}
return $content;
}
add_filter( 'the_content', 'my_post_footer' );
?> تحقيق التصميم التكيفي (الريسبونسيف) وتخصيص الثيمات (Themes)
يجب أن تكون مواضيع ووردبريس الحديثة متجاوبة (responsive) وأن توفر خيارات تخصيص سهلة الاستخدام. ويتطلب ذلك الجمع بين تقنيات CSS وواجهة برمجة التطبيقات الخاصة بووردبريس (WordPress’s Custom API) لتحقيق ذلك.
تطبيق أنماط CSS التكيفية (Responsive CSS)
يتم تنفيذ التصميم التفاعلي عادةً من خلال استخدام استعلامات وسائط CSS. style.css في هذا النص، يمكنك تعريف الأنماط (styles) بناءً على أحجام الشاشات المختلفة.
/* 基础样式 */
.container {
width: 100%;
padding: 20px;
}
/* 平板设备(宽度大于768px) */
@media (min-width: 768px) {
.container {
width: 750px;
margin: 0 auto;
}
}
/* 桌面设备(宽度大于992px) */
@media (min-width: 992px) {
.container {
width: 970px;
}
} تكامل إعدادات المخصصات
يتيح أداة تخصيص WordPress للمستخدمين معاينة إعدادات القالب وتعديلها في الوقت الفعلي. يتم تحقيق ذلك من خلال functions.phpيمكنك إضافة مجموعة متنوعة من الخيارات للموضوع، مثل تحميل الشعار (Logo)، واختيار الألوان، وغيرها.
فيما يلي مثال على خيار لإضافة نص حقوق النشر في القسم السفلي من الصفحة:
<?php
function my_theme_customize_register( $wp_customize ) {
// 添加一个设置项
$wp_customize->add_setting( 'footer_copyright_text', array(
'default' => '© 2026 我的网站。',
'sanitize_callback' => 'sanitize_text_field',
) );
// 为设置项添加一个控件(输入框)
$wp_customize->add_control( 'footer_copyright_text', array(
'label' => __( '页脚版权文本', 'my-first-theme' ),
'section' => 'title_tagline', // 放在“站点身份”区域
'type' => 'text',
) );
}
add_action( 'customize_register', 'my_theme_customize_register' );
?> في ملف القالب (template file) footer.php في هذا السياق، يمكنك عرض قيمة هذا الخيار بالطريقة التالية:
<p class="site-info">
<?php echo esc_html( get_theme_mod( 'footer_copyright_text', '© 2026 我的网站。' ) ); ?>
</p> الملخصات
تطوير مواقع ووردبريس (WordPress themes) يمثل مهارة شاملة تجمع بين معرفة برمجة لغة PHP، وهيكلة صفحات الويب باستخدام HTML، وتصميم الأنماط باستخدام CSS، بالإضافة إلى فهم لواجهات برمجة التطبيقات الأساسية الخاصة بنظام ووردبريس (WordPress API). يبدأ هذا المسار من فهم المبادئ الأساسية لك style.css ابدأ بملفات القوالب، وتدرجياً امتلكي فهماً شاملاً لنظام مستويات القوالب، وتعلمي كيفية استخدامها بشكل صحيح. functions.php استخدام الأدوات المتاحة (مثل “الخطافات” – hooks) لتوسيع وظائف الموضوع، وفي النهاية تحقيق تصميم متجاوب مع أحجام الشاشات المختلفة وتوفير خيارات تخصيصية واسعة، يعتبر طريقًا واضحًا للتحول إلى مطور مواضيع محترف. أثناء عملية التطوير، اتباع المعايير الرسمية للكود وأفضل الممارسات يضمن ليس فقط جودة وأمان الموضوع، بل يوفر أيض
الأسئلة الشائعة الأسئلة المتداولة
ما هي المعرفة الأساسية المطلوبة لتعلم تطوير مواقع ووردبريس (WordPress themes)؟
يُنصح بامتلاك المعرفة الأساسية للغات HTML وCSS، وهي الأسس الضرورية لبناء صفحات الويب. كما يجب أن يكون لديك فهم أساسي للغة PHP، نظرًا لأن نواة منصة WordPress ونظام قوالبها يعتمدان بشكل أساسي على هذه اللغة. سيكون من المفيد أيضًا امتلاك معرفة أولية بلغة JavaScript عند القيام بتطوير وظائف تفاعلية لاحقًا.
هل سيحدث تعارض بين ملف functions.php الخاص بالموضوع الرئيسي وملف functions.php الخاص بالموضوع الفرعي؟
لن يحدث تعارض؛ سيتم تحميل كلاهما. الموضوع الفرعي (الsubtopic) سيتم أيضًا تحميله بشكل كامل. functions.php سيتم وضع المستندات ضمن الموضوع الأم. functions.php يتم تحميل الملفات بعد ذلك. هذا يعني أنه يمكنك إضافة ميزات جديدة إلى الموضوع الفرعي أو تغيير الميزات المعرفة في الموضوع الرئيسي (شريطة أن تكون الدوال الموجودة في الموضوع الرئيسي معرفة كقابلة للتغيير). هذه الطريقة موصى بها لتعديل الميزات الأساسية للمو
كيف يمكنني جعل موقعي الإلكتروني يدعم عدة لغات (التدويل)؟
يجب عليك استخدام دوال التدويل في ووردبريس (WordPress) لتغليف جميع سلاسل النصوص التي يجب عرضها في واجهة المستخدم. الطريقة الرئيسية للقيام بذلك هي استخدام الدالة `wpgettext()` أو دوالها المشتقة، مثل `wp_get_text()` و`wp __() و _e() الدوال، وتحديد مواقع تنفيذها (أي المكان الذي ستتم فيه تنفيذ هذه الدوال). style.css مُعرّفة في C#. Text Domainثم، استخدم أداة مثل Poedit لإنشاء ملف قالب بصيغة .pot، حتى يتمكن المترجمون من إنشاء ملفات الترجمة بصيغة .po و .mo، ووضع هذه الملفات في الموضوع المطلوب. /languages/ تحت القائمة.
ماهي المسائل القانونية والتنظيمية التي يجب مراعاتها عند تطوير موضوع تجاري؟
الأهم من ذلك كله هو الالتزام برخصة GNU GPL الخاصة ببرنامج WordPress نفسه. هذا يعني أن جزء الكود المكتوب بلغة PHP في موضوعك يجب أن يكون مرخصًا برخصة تتوافق مع رخصة GPL. عادةً ما يتم تطبيق رخصة GPL على الموضوع بأكمله. بالإضافة إلى ذلك، يجب التأكد من أن الموارد الخارجية التي تستخدمها (مثل الأيقونات، الخطوط، مكتبات JavaScript) تحمل تراخيص تسمح باستخدامها في الأغراض التجارية. من ناحية معايير الكود، يجب اتباع المعايير الرسمية لكود WordPress، وضمان أن موضوعك يجتاز المراجعة الأساسية باستخدام إضافة Theme Check، لزيادة احتمالية تضمينه في الدليل الرسمي لمواقع WordPress.
ما التالي، ما التالي؟
القراءة الموسعة والمعرفة العملية
فيما يلي بعض الموضوعات ذات الصلة بموضوع هذه المقالة وهي مناسبة لمزيد من القراءة المتعمقة. وغالباً ما يكون من الأفضل إعطاء الأولوية للبدء بالمقال الأقرب إلى مشكلتك الحالية ثم التوسع تدريجياً إلى المواضيع المحيطة.
- تطوير مواقع ووردبريس من المبتدئين إلى الخبراء: دليل شامل لبناء مواقع إلكترونية مخصصة
- تطوير مواقع ووردبريس من الصفر: إنشاء واجهات مواقع فريدة ومميزة
- دليل تطوير مواقع ووردبريس: بناء مواقع مخصصة من الصفر
- دليل شامل لتطوير مواقع ووردبريس: دورة عملية من الصفر إلى الاحتراف
- دليل شامل لتطوير مواضيع ووردبريس: بناء قوالب مواقع إلكترونية محترفة من الصفر