مقدمه

یک قالب وردپرس مجموعه‌ای از فایل‌های PHP، CSS و JavaScript است که با هم کار می‌کنند تا ظاهر سایت شما را شکل دهند. درک ساختار این فایل‌ها، اولین و مهم‌ترین گام برای توسعه یا شخصی‌سازی قالب‌های وردپرس است.

در این مقاله از مستندات wtheme.ir، به بررسی دقیق هر یک از اجزای قالب وردپرس و نقش آن‌ها می‌پردازیم.

📌 فایل‌های ضروری (حداقلی)

یک قالب وردپرس برای اینکه توسط سیستم شناخته شود، فقط به دو فایل نیاز دارد:

📄

style.css

حاوی اطلاعات قالب (هدر) و استایل‌های اصلی است.

/*
Theme Name: WTheme Demo
Theme URI: https://wtheme.ir
Author: WTheme Team
Version: 1.0.0
*/

📄

index.php

فایل اصلی قالب که به عنوان fallback برای همه صفحات استفاده می‌شود.

<?php get_header(); ?>
<main>
  <?php while(have_posts()): the_post(); ?>
    <h2><?php the_title(); ?></h2>
  <?php endwhile; ?>
</main>
<?php get_footer(); ?>

🧩 فایل‌های اصلی قالب

header.php

این فایل شامل بخش بالایی تمام صفحات سایت است (هدر، منو، لوگو). با تابع get_header() فراخوانی می‌شود.

<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
    <meta charset="<?php bloginfo('charset'); ?>">
    <?php wp_head(); ?>
</head>
<body <?php body_class(); ?>>
<header class="site-header">
    <?php wp_nav_menu(['theme_location' => 'primary']); ?>
</header>

footer.php

بخش پایینی سایت شامل فوتر، کپی‌رایت و اسکریپت‌های نهایی. با تابع get_footer() فراخوانی می‌شود.

<footer class="site-footer">
    <p>© <?php echo date('Y'); ?> <?php bloginfo('name'); ?></p>
</footer>
<?php wp_footer(); ?>
</body>
</html>

sidebar.php

فایل کناری سایت که شامل ویجت‌ها می‌شود. با get_sidebar() فراخوانی می‌شود.

<aside class="sidebar">
    <?php if(is_active_sidebar('main-sidebar')): ?>
        <?php dynamic_sidebar('main-sidebar'); ?>
    <?php endif; ?>
</aside>

functions.php

مغز قالب! این فایل برای ثبت قابلیت‌ها، هوک‌ها، فیلترها، فراخوانی فایل‌های CSS/JS و تعریف توابع سفارشی استفاده می‌شود.

<?php
// ثبت منوها
function wtheme_setup() {
    register_nav_menus([
        'primary' => __('منوی اصلی', 'wtheme')
    ]);
    add_theme_support('post-thumbnails');
}
add_action('after_setup_theme', 'wtheme_setup');

// فراخوانی استایل‌ها
function wtheme_scripts() {
    wp_enqueue_style('main-style', get_stylesheet_uri());
}
add_action('wp_enqueue_scripts', 'wtheme_scripts');

🎯 فایل‌های تکمیلی (Template Files)

این فایل‌ها برای نمایش انواع مختلف محتوا استفاده می‌شوند:

📝 single.php

نمایش یک پست تکی (مقاله)

📄 page.php

نمایش برگه‌های ثابت (درباره ما، تماس)

📚 archive.php

نمایش آرشیو دسته‌بندی، برچسب و تاریخ

🔍 search.php

نمایش نتایج جستجو

❌ 404.php

صفحه خطای “یافت نشد”

💬 comments.php

نمایش و مدیریت دیدگاه‌ها

🖼️ screenshot.png

تصویر پیش‌نمایش قالب (1200×900 px)

🏠 front-page.php

صفحه اصلی سایت (اولویت بالا)

🔄 سلسله مراتب قالب (Template Hierarchy)

وردپرس برای نمایش هر صفحه، به ترتیب از فایل‌های زیر استفاده می‌کند (اول با فایل تخصصی‌تر):

مثال: نمایش یک پست تکی

1️⃣ single-post.php (اگر وجود داشته باشد)

2️⃣ single.php

3️⃣ singular.php

4️⃣ index.php (فایل fallback نهایی)

💡 نکته: اگر هیچ‌کدام از فایل‌های تخصصی وجود نداشته باشند، وردپرس از index.php استفاده می‌کند. به همین دلیل این فایل الزامی است.

📁 ساختار پیشنهادی پوشه قالب

wtheme-demo/
├── style.css                 # اطلاعات قالب
├── index.php                 # فایل اصلی
├── header.php                # هدر سایت
├── footer.php                # فوتر سایت
├── sidebar.php               # سایدبار
├── functions.php             # توابع قالب
├── single.php                # پست تکی
├── page.php                  # برگه
├── archive.php               # آرشیو
├── search.php                # جستجو
├── 404.php                   # خطای 404
├── comments.php              # دیدگاه‌ها
├── screenshot.png            # تصویر قالب
├── assets/
│   ├── css/                  # فایل‌های استایل
│   ├── js/                   # فایل‌های جاوااسکریپت
│   ├── images/               # تصاویر قالب
│   └── fonts/                # فونت‌ها
├── inc/                      # فایل‌های کمکی
│   ├── customizer.php
│   └── template-tags.php
└── template-parts/           # بخش‌های قابل استفاده مجدد
    ├── content.php
    └── content-single.php

✅ جمع‌بندی

شناخت اجزای قالب وردپرس، پایه و اساس توسعه حرفه‌ای است. با درک Template Hierarchy و ساختار فایل‌ها، می‌توانید قالب‌هایی بسازید که هم انعطاف‌پذیر باشند و هم با استانداردهای وردپرس سازگار.

تمامی قالب‌های wtheme.ir با رعایت کامل این ساختار و استانداردهای WordPress Coding Standards توسعه داده شده‌اند.

🎨 قالب آماده می‌خواهید؟

مجموعه‌ای از حرفه‌ای‌ترین قالب‌های وردپرس با ساختار استاندارد و کدنویسی تمیز در wtheme.ir

مشاهده قالب‌ها