آموزش کار با فریمورک tailwind css در وردپرس نسخه نهایی

مقدمه

Tailwind CSS یک فریم‌ورک CSS مبتنی بر کلاس‌های کاربردی (Utility-First) است که سرعت توسعه رابط کاربری را به شدت افزایش می‌دهد. استفاده از Tailwind در قالب‌های وردپرس به شما این امکان را می‌دهد که بدون نوشتن کدهای CSS سفارشی و طولانی، طراحی‌های مدرن، ریسپانسیو و سبک ایجاد کنید.

در این مقاله از مستندات wtheme.ir، روش‌های مختلف ادغام Tailwind CSS در قالب‌های وردپرس و نکات طلایی برای جلوگیری از تداخل آن با هسته وردپرس را بررسی می‌کنیم.

روش‌های اضافه کردن Tailwind به وردپرس

برای استفاده از Tailwind در وردپرس، سه روش اصلی وجود دارد. بسته به سطح دانش فنی و نیاز پروژه، می‌توانید یکی را انتخاب کنید.

1 استفاده از CDN (فقط برای تست و توسعه اولیه)

⚠️ توجه: این روش به هیچ وجه برای محیط Production (سایت اصلی) توصیه نمی‌شود، زیرا فایل CSS نهایی بهینه (Purge) نخواهد شد و حجم بالایی خواهد داشت.

برای این کار، کد زیر را در فایل functions.php قالب خود قرار دهید:

function wtheme_enqueue_tailwind_cdn() {
    // اسکریپت Play CDN تیلویند
    wp_enqueue_script( 'tailwindcss-cdn', 'https://cdn.tailwindcss.com', array(), '3.3.0', false );
}
add_action( 'wp_enqueue_scripts', 'wtheme_enqueue_tailwind_cdn' );

2 استفاده از فایل CSS کامپایل شده (روش سنتی)

در این روش، شما Tailwind را در سیستم خود (لوکال) کامپایل می‌کنید و فایل خروجی (tailwind.css) را در پوشه قالب آپلود کرده و آن را فراخوانی می‌کنید.

function wtheme_enqueue_tailwind_compiled() {
    wp_enqueue_style( 'tailwind-css', get_template_directory_uri() . '/assets/css/tailwind.css', array(), '1.0.0' );
}
add_action( 'wp_enqueue_scripts', 'wtheme_enqueue_tailwind_compiled' );

3 استفاده از Build Process (روش حرفه‌ای و پیشنهادی)

✅ پیشنهاد: این بهترین و استانداردترین روش برای توسعه قالب‌های مدرن وردپرس است. شما از ابزارهایی مثل Vite یا Webpack به همراه PostCSS استفاده می‌کنید تا Tailwind دقیقاً همان کلاس‌هایی را تولید کند که در فایل‌های .php قالب استفاده شده‌اند.

مراحل راه‌اندازی:

  1. در ریشه قالب، Tailwind را نصب کنید: npm install -D tailwindcss postcss autoprefixer
  2. فایل کانفیگ را بسازید: npx tailwindcss init
  3. فایل input.css خود را در مسیر src/input.css بسازید:
@tailwind base;
@tailwind components;
@tailwind utilities;
  1. در فایل tailwind.config.js مسیر فایل‌های PHP قالب را به آن معرفی کنید (بسیار مهم):
/** @type {import('tailwindcss').Config} */
module.exports = {
  content: [
    "./**/*.php", // اسکن تمام فایل‌های PHP قالب
    "./src/**/*.js",
  ],
  theme: {
    extend: {},
  },
  plugins: [],
}
  1. پس از بیلد گرفتن، فایل نهایی را در functions.php فراخوانی کنید.

⚠️ ۳ نکته حیاتی و طلایی در استفاده از Tailwind در وردپرس

استفاده از Tailwind در وردپرس چالش‌های خاص خود را دارد. در wtheme.ir برای جلوگیری از بروز باگ در قالب‌ها، رعایت ۳ نکته زیر الزامی است:

۱. جلوگیری از تداخل با هسته وردپرس و گوتنبرگ (استفاده از Prefix)

Tailwind به صورت پیش‌فرض استایل‌های Reset (Preflight) را اعمال می‌کند که ممکن است ظاهر پیش‌خوان وردپرس، ویرایشگر گوتنبرگ یا افزونه‌هایی مثل ووکامرس را به هم بریزد.

راه حل: در فایل tailwind.config.js یک پیشوند (Prefix) برای تمام کلاس‌ها تعریف کنید:

module.exports = {
  // ...
  prefix: 'tw-', // تمام کلاس‌ها با tw- شروع می‌شوند (مثل tw-flex, tw-text-white font-red-500)
}

با این کار، کلاس‌های Tailwind هیچ تداخلی با کلاس‌های پیش‌فرض وردپرس نخواهند داشت.

۲. مشکل کلاس‌های داینامیک (Dynamic Classes)

Tailwind فقط کلاس‌هایی را می‌سازد که به صورت متن کامل (String) در فایل‌های شما وجود داشته باشند. اگر کلاسی را به صورت داینامیک بسازید، Tailwind آن را نادیده می‌گیرد.

❌ روش اشتباه:

<div class="bg-dark section-<?php echo $color; ?>-500">

✅ روش صحیح:

<?php 
$colors = [
    'red' => 'bg-dark section-red-500',
    'blue' => 'bg-dark section-blue-500'
];
?>
<div class="<?php echo esc_attr($colors[$color]); ?>">

۳. مدیریت استایل‌های ویرایشگر گوتنبرگ (Block Editor)

اگر می‌خواهید استایل‌های Tailwind در ویرایشگر گوتنبرگ هم اعمال شوند تا کاربر پیش‌نمایش دقیقی از قالب ببیند، باید فایل CSS تیلویند را برای ویرایشگر هم فراخوانی کنید:

function wtheme_add_tailwind_to_editor() {
    add_editor_style( 'assets/css/tailwind-editor.css' );
}
add_action( 'after_setup_theme', 'wtheme_add_tailwind_to_editor' );

💡 نکته: بهتر است برای ویرایشگر، یک فایل جداگانه و بدون Prefix کامپایل کنید تا کلاس‌های گوتنبرگ به درستی کار کنند.

جمع‌بندی

استفاده از Tailwind CSS در قالب‌های وردپرس می‌تواند تجربه توسعه شما را متحول کند. با استفاده از روش Build Process و اعمال Prefix (پیشوند)، می‌توانید قالب‌هایی بسازید که هم از نظر ظاهری بی‌نظیر باشند و هم از نظر عملکردی با هسته وردپرس و افزونه‌ها کاملاً سازگار باشند.

تیم توسعه wtheme.ir در تمامی قالب‌های فروشگاهی و شرکتی خود، بهترین استانداردهای ادغام Tailwind را رعایت کرده است تا شما تجربه‌ای بی‌نقص از طراحی داشته باشید.

🚀 آماده شروع هستید؟

اگر در زمینه شخصی‌سازی قالب‌های wtheme.ir یا استفاده از Tailwind سوالی دارید، از طریق بخش تیکت پشتیبانی با ما در ارتباط باشید.

تماس با پشتیبانی
منو
حساب کاربری فروشگاه