شكل البداية/المتعلقة بالمعرفة/ووردبريس/تفاصيل المحتوى

من الصفر: إتقان العمليات الأساسية وأفضل الممارسات في تطوير موضوعات ووردبريس.

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

لتطوير قالب ووردبريس (WordPress theme) متكامل وذو وظائف متعددة، من الضروري أولاً فهم هيكل الملفات الأساسية الخاصة به. أبسط قالب ووردبريس يحتاج على الأقل إلى ملفين:style.css و index.phpمن بينها،style.css ليس مجرد ملفات أنماط (style sheets)، بل هي أيضًا “بطاقة الهوية” لكل موضوع (theme)؛ حيث تحتوي كتل التعليقات في بداية ملفات هذه الملفات على جميع المعلومات الوصفية الخاصة بالموضوع.

مستند إعلان بيان الموضوع.

style.css يجب أن يحتوي بداية الملف على كتلة تعليقات محددة، تُستخدم لإعلان موضوع الووردبريس لنظام الووردبريس نفسه. تشمل هذه المعلومات اسم الموضوع، والمؤلف، والوصف، ورقم الإصدار، وغيرها، وسيتم عرضها في قائمة مواضيع واجهة الووردبريس الخلفية.

/*
Theme Name: 我的第一个主题
Theme URI: https://example.com/my-first-theme/
Author: 你的名字
Author URI: https://example.com/
Description: 这是一个简洁、响应式的自定义 WordPress 主题。
Version: 1.0
License: GPL v2 or later
Text Domain: my-first-theme
*/

ملف القالب الأساسي

index.php هذا هو ملف القالب الافتراضي للموضوع، وعندما لا يتمكن ووردبريس من العثور على ملف قالب أكثر تحديدًا، فإنه يستخدم هذا الملف بدلاً منه. يعتبر هذا الملف “الاحتياطي” ونقطة البداية للموضوع بأكمله. مع تقدم عملية التطوير، ستقوم بإنشاء المزيد من ملفات القوالب المتخصصة، مثل تلك المست single.phpمستخدم في الصفحات page.phpمستخدم في قوائم أرشيف المقالات archive.php إلخ. هذا النوع من الهياكل المتدرجة للقوالب هو الفكرة الأساسية في تصميم مواقع ووردبريس.

القراءة الموصى بها البدء من الصفر: دليل شامل وأفضل الممارسات لتطوير مواقع ووردبريس (WordPress Themes)。

بناء الميزات الأساسية والقوالب للموضوع (Building the core features and templates for a topic)

مجموعة صفحات HTML ثابتة لا يمكن أن تُعتبر قالبًا (theme) لـ WordPress، والسبب الرئيسي في ذلك هو عدم القدرة على استدعاء البيانات والوظائف التي يوفرها WordPress بشكل ديناميكي. يتم تحقيق ذلك بشكل أساسي من خلال علامات القوالب (template tags) وحلقة التكرار (The Loop) المتاحة في WordPress.

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

فهم الدورة الرئيسية لـ WordPress.

“التكرار” (Loop) هو الآلية الافتراضية التي يستخدمها ووردبريس لاسترجاع المقالات من قاعدة البيانات وعرضها على الصفحة. إنها قطعة من كود PHP تُستخدم للتحقق مما إذا كانت هناك مقالات متوفرة، وفي حال وجودها، تقوم بعرضها بشكل تكراري. تحتوي تقريبًا جميع ملفات قوالب المواقع (theme templates) على نسخ مختلفة من هذه الآلية.

<h2></h2>
    <div class="entry-content">
        
    </div>

    <p><?php esc_html_e( '抱歉，没有找到任何文章。', 'my-first-theme' ); ?></p>

في الشفرة المذكورة أعلاه،have_posts() و the_post() الدوال هي التي تقود الحلقات (الloops)، و… the_title() و the_content() هذه هي علامات القوالب (template tags) التي يتم استدعاؤها داخل الحلقة (loop)، وتُستخدم لعرض عنوان المقالة الحالية ومحتواها.

إدخال الأجزاء العامة: الرأس والقاعدة

للالتزام بمبدأ DRY (Don't Repeat Yourself)، تقوم مواضيع ووردبريس عادةً بفصل الأجزاء المشتركة عن بعضها وتخزينها في ملفات منفصلة. أهم هذه الملفات هما: header.php و footer.php。
في index.php في النص، يمكنك إدخالها بهذه الطريقة:

<?php get_header(); ?>
<!-- 主循环内容在这里 -->
<?php get_footer(); ?>

get_header() الدالة ستقوم بإدخال (أي تنفيذ أو تطبيق) الكود المطلوب. header.php الملف يجب أن يحتوي على إعلان عن نوع المستند (document type declaration).<head> المناطق المختلفة، بالإضافة إلى العلامات العامة الموجودة في أعلى الموقع (مثل الشعار وقائمة التنقل). وبالمثل،get_footer() سيتم إدخالها. footer.phpيحتوي على محتوى القائمة السفلية وعلامات HTML الخاصة بالإغلاق.

القراءة الموصى بها دليل أساسي لفهم تطوير القوالب (الثيمات) في ووردبريس: من المبادئ الأساسية إلى الاحترافية。

دمج الميزات الأساسية لبرنامج ووردبريس (WordPress)

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

قائمة التنقل للتسجيل

يسمح نظام القوائم في ووردبريس للمستخدمين بإنشاء وإدارة القوائم النافذة للتنقل من خلال الذهاب إلى قسم “المظهر” → “القوائم” في الواجهة الخلفية. كما يجب على القوالب (الثيمات) تحديد المواقع التي ت

function my_first_theme_setup() {
    register_nav_menus( array(
        'primary' => __( '主导航菜单', 'my-first-theme' ),
        'footer'  => __( '页脚菜单', 'my-first-theme' ),
    ) );
}
add_action( 'after_setup_theme', 'my_first_theme_setup' );

بعد التسجيل، سيكون بإمكانك استخدام ملفات القوالب (مثل…) header.phpفي المواقع المناسبة، استخدم… wp_nav_menu() تم استخدام دالة لعرض القائمة.

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

تفعيل منطقة الأدوات الإضافية

تسمح منطقة الأدوات الصغيرة (أو المعروفة أيضًا بـ “الشريط الجانبي”) للمستخدمين بإضافة محتوى عن طريق سحب الأدوات المتاحة. أولاً، يجب عليك تسجيل حساب للحصول على شريط جانبي خاص بك:

function my_first_theme_widgets_init() {
    register_sidebar( array(
        'name'          =&gt; __( '主侧边栏', 'my-first-theme' ),
        'id'            =&gt; 'sidebar-1',
        'description'   =&gt; __( '在此添加小工具。', 'my-first-theme' ),
        'before_widget' =&gt; '<section id="%1$s" class="widget %2$s">',
        'after_widget'  =&gt; '</section>',
        'before_title'  =&gt; '<h2 class="widget-title">',
        'after_title'   =&gt; '</h2>',
    ) );
}
add_action( 'widgets_init', 'my_first_theme_theme_widgets_init' );

ثم، في ملف القالب (مثل…) sidebar.phpفي هذا البرنامج، يتم استخدام dynamic_sidebar( ‘sidebar-1’ ) للاتصال به.

يدعم الموقع استخدام صور مميزة للمقالات.

الصورة المميزة (Post Thumbnail) هي الصورة التمثيلية للمقال. لتفعيلها، يجب إضافة دعم لها إلى ملف functions.php الخاص بالقالب (theme).

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

add_theme_support( ‘post-thumbnails’ );

بعد ذلك، يمكنك استخدامه داخل الحلقة (loop). the_post_thumbnail() تم استخدام دالة لعرض الصور المميزة لهذا المقال.

تطبيق الأنماط والبرمجيات الأمامية (Front-End Scripts)

يجب أن تكون مواضيع ووردبريس الحديثة متجاوبة (responsive)، وأن تكون قادرة على تحميل ملفات الأنماط (stylesheets) وملفات جافا سكريبت (JavaScript) بكفاءة وبشكل منظم.

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

ترتيب الأنماط والسكريبتات بشكل صحيح

يجب ألا يتم استخدامها مباشرةً داخل ملفات القوالب أبدًا. <link> أو <script> ترميز الموارد في التسميات بشكل يدوي. يجب أن تستخدم الأسلوب الصحيح لذلك. wp_enqueue_style() و wp_enqueue_script() الدالة، في… functions.php يتم تحميله من خلال خاصية “hook” (خطاف) معينة.

function my_first_theme_scripts() {
    // 排入主样式表
    wp_enqueue_style( ‘my-first-theme-style’, get_stylesheet_uri() );

// 排入自定义 JavaScript 文件
    wp_enqueue_script( ‘my-first-theme-navigation’, get_template_directory_uri() . ‘/js/navigation.js’, array(), ‘1.0’, true );

// 如果需要，排入 jQuery（WordPress 默认已包含）
    // wp_enqueue_script( ‘jquery’ );
}
add_action( ‘wp_enqueue_scripts’, ‘my_first_theme_scripts’ );

تسمح هذه الطريقة لبرنامج ووردبريس (WordPress) بإدارة العلاقات التابعة (dependencies) بين المكونات المختلفة، مما يمنع تحميل المحتويات بشكل متكرر، ويسهل على المواضيع الفرعية (subthemes) تعديل أو تغيير أجزاء معينة من

إنشاء تصميم واجهة مستجيب (Responsive Design)

تأكد من أنك style.css يتضمن استخدام استعلامات الوسائط (Media Queries) القدرة على تكييف تصميم الموقع ليناسب مختلف أحجام الشاشات، بدءًا من الهواتف المحمولة وحتى أجهزة الكمبيوتر المكتبية. في الوقت نفسه، header.php أنا أحبك، أيها الأخ الأكبر. <head> من المهم جدًا إضافة بعض علامات وصف النافذة (viewport meta tags).

<meta name="viewport" content="width=device-width, initial-scale=1">

اتباع أفضل الممارسات والمعايير الأمنية

تطوير المواضيع لا يقتصر فقط على تنفيذ الوظائف المطلوبة، بل يجب أيضًا ضمان أمان الكود وسهولة صيانته، بالإضافة إلى توافقه مع بيئة ووردبريس (WordPress).

التدويل والتوطين

استعد لحقول النصوص والسلاسل النصية القابلة للترجمة منذ البداية، حتى يتسنى لمستخدمين من جميع أنحاء العالم استخدام موضوعك. __( ‘文本’, ‘my-first-theme’ ) أو _e( ‘文本’, ‘my-first-theme’ ) لتغليف جميع السلاسل النصية التي تُعرض للمستخدمين في الواجهة الأمامية، تأكد من… style.css وتم تعيين نطاق النص (Text Domain) بشكل صحيح في جميع الدوال المستخدمة.

التحقق من صحة البيانات، تهريب القيم (escaping values)، وتنظيف البيانات (data cleaning)

لا تثق أبدًا بالبيانات القادمة من المستخدمين أو قواعد البيانات. عند إرسال البيانات، يجب تنفيذ عمليات تهريب (escaping) لها.
استخدام esc_html() تهريب محتوى HTML.
استخدام esc_url() تحويل URL إلى شكل مشفر (escaped URL).
استخدام esc_attr() تهريب خصائص HTML (HTML Attribute Escaping).
بالنسبة لمتغيرات PHP التي تُستخدم في JavaScript، يجب استخدام… wp_json_encode()。

اعتبارات تحسين الأداء

يمكن تحسين أداء الموضوع من خلال ما يلي: تعيين أرقام الإصدارات والتبعيات بشكل معقول عند تنظيم البرامج النصية والأنماط؛ ضمان أن جميع الصور قد تم تحسينها؛ النظر في تأخير تحميل الصور غير الأساسية؛ وتقليل طلبات HTTP للموارد الخارجية قدر الإمكان. الحفاظ على الشفرة بسيطة وفعالة.

الملخصات

تطوير مواقع ووردبريس باستخدام القوالب (Themes) يعتبر عملية هندسية منهجية، تبدأ من فهم أساسيات عمل نظام ووردبريس نفسه… style.css و index.php ابدأ بالتعرف على مستويات القوالب (templates)، والحلقة الرئيسية (main loop)، وكيفية دمج الوظائف الأساسية في نظام ووردبريس (WordPress). المفتاح هو استخدام علامات التنسيق (template tags) والدوال (functions) المتاحة في ووردبريس بشكل ديناميكي، مع الالتزام بمبدأ تعديد وحدات الكود المشترك (modular code). في الوقت نفسه، من المهم جدًا ترتيب موارد الواجهة الأمامية (front-end resources) بشكل صحيح، وتطبيق تصميم يتكيف مع أحجام الشاشات المختلفة (responsive design)، بالإضافة إلى أخذ الأمان (مثل تنفيذ عمليات تهريب البيانات – data escaping) والتدويل (internationalization) كأساس في عملية التطوير. باتباع هذه الإجراءات الأساسية وأفضل الممارسات، ستتمكن من إنشاء تصاميم ووردبري

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

ما هي الحد الأدنى لعدد الملفات المطلوبة لموضوع (theme) في ووردبريس (WordPress)؟

يحتاج تصميم ووردبريس (WordPress theme) إلى ملفين على الأقل:style.css و index.php。style.css يُستخدم لتوفير المعلومات الخاصة بالموضوع والأنماط الأساسية، بينما… index.php كملف قالب افتراضي، يُستخدم لعرض محتوى الموقع الإلكتروني.

كيف يمكنني إضافة صفحة إعدادات مخصصة للموضوع الخاص بي؟

عادةً ما لا يُنصح بإضافة عدد كبير من صفحات الإعدادات المعقدة مباشرةً إلى القالب (theme)، حيث قد يؤدي ذلك إلى حدوث تعارضات مع الإضافات (plugins) أو مع الميزات الأساسية الجديدة في نظام ووردبريس (WordPress). بالنسبة للخيارات البسيطة، يمكن النظر في استخدام واجهة برمجة التطبيقات (API) الخاصة بأداة تخصيص ووردبريس (WordPress Customizer). أما بالنسبة للمتطلبات الأكثر تعقيدًا، فيُفضل إنشاء إضافات (plugins) منفصلة لتلبية تلك المتطلبات. إذا كان من الضروري فعلاً إضافة هذه الصفحات إلى الق add_menu_page() أو add_theme_page() الدوال، وذلك بالتعاون مع إعدادات واجهة برمجة التطبيقات (API) لإنشائها.

لماذا تتغير ترتيب عناصر تصميم الموقع بشكل غير صحيح بعد تغيير الموضوع (theme) الذي أستخدمه؟

عادةً ما يحدث هذا بسبب الأدوات أو القوائم (widgets/menus) المسجلة مع الموضوع السابق، والتي لا يوجد مكان مناسب في الموضوع الجديد لعرضها. يحاول ووردبريس الحفاظ على هذه الإعدادات. يرجى التحقق مما إذا كان الموضوع الجديد الخاص بك يحتوي على الأدوات أ functions.php تم تسجيل مواقع عناصر التنقل في القائمة بشكل صحيح (باستخدام…). register_nav_menusومنطقة الأدوات الصغيرة (المستخدمة) register_sidebarتأكد من أن “المعرف” (ID) أو “الموقع” (Location) المسجلين فريدان من نوعهما، وأن الدوال الصحيحة قد تم استخدامها في ملف القالب (template file). wp_nav_menuيتم استدعاؤها باستخدام هذه الطريقة.

كيف يمكنني أن أجعل موضوعي يدعم الموضوعات الفرعية؟

لكي تتمكن موضوعاتك من دعم المواضيع الفرعية (subtopics)، يجب أن تكون مصممة بشكل معياري ومرن قدر الإمكان. تجنب استخدام مسارات محددة مسبقًا (hard-coded paths) داخل الدوال، بل استخدم طرق أكثر مرونة ت get_template_directory_uri() و get_stylesheet_directory_uri() مثل هذه الدوال… بالنسبة للدوال التي يمكن تعديلها، يتم استخدام… if ( ! function_exists( ‘…’ ) ) للتحقق مما إذا كان قد تم تعريفه بالفعل… الأهم من ذلك، استخدم خطافات الإجراءات (action hooks) مثل… after_setup_theme, wp_enqueue_scriptsيمكن إضافة الميزات باستخدام هذه الطريقة، مما يسمح بإزالة أو تعديل هذه “المسامير” (hooks) بسهولة من الموضوع (theme).

هل يجب استخدام إصدار معين من PHP عند تطوير المواضيع؟

على الرغم من عدم وجود متطلبات إلزامية قاطعة، إلا أنه من أجل الأمان والأداء والتوافق، يجب عليك الالتزام بمتطلبات ووردبريس الرسمية بخصوص إصدارات PHP. اعتبارًا من عام 2026، يوصي ووردبريس باستخدام إصدار PHP 7.4 أو أحدث. أثناء عملية التطوير، يجب استخدام إصدارات أحدث من PHP، وتجنب استخدام الدوال المهجورة في الكود. style.css من الجيد أن تذكر في المستندات الإصدار الأدنى المطلوب من لغة PHP لموضوعك.

ما التالي، ما التالي؟

إذا كنت تقوم بإنشاء موقع ووردبريس أو تحسينه، فإننا ننصحك بمواصلة القراءة حول تحسين الأداء وتكوين المكونات الإضافية وتخصيص المظاهر.

القراءة الموسعة والمعرفة العملية

فيما يلي بعض الموضوعات ذات الصلة بموضوع هذه المقالة وهي مناسبة لمزيد من القراءة المتعمقة. وغالباً ما يكون من الأفضل إعطاء الأولوية للبدء بالمقال الأقرب إلى مشكلتك الحالية ثم التوسع تدريجياً إلى المواضيع المحيطة.

الوسوم