آموزش کامل شورت‌کد وردپرس (Shortcode): راهنمای جامع ۲۰۲۶

شورت‌کد (Shortcode) یکی از قدرتمندترین ابزارهای وردپرس است که به شما اجازه می‌دهد با نوشتن یک کد کوتاه، محتوای پیچیده و پویا را در هر جای سایت نمایش دهید. در این راهنمای جامع، همه چیز درباره شورت‌کدها را یاد می‌گیرید.

شورت‌کد (Shortcode) چیست؟

شورت‌کد یک میانبر متنی است که در براکت‌های مربعی نوشته می‌شود و وردپرس آن را با محتوای مورد نظر جایگزین می‌کند. مثلاً:

این شورت‌کد ساده، یک گالری تصاویر کامل با قابلیت‌های پیشرفته ایجاد می‌کند—بدون نیاز به نوشتن حتی یک خط کد HTML یا CSS.

مزایای استفاده از شورت‌کد:

• سادگی: نیازی به دانش برنامه‌نویسی ندارید
• انعطاف‌پذیری: در هر جای سایت قابل استفاده است (پست، صفحه، ویجت، قالب)
• قابلیت استفاده مجدد: یک بار تنظیم، هزاران بار استفاده
• نگهداری آسان: تغییر در یک جا، اعمال در همه جا

شورت‌کد در مقابل بلوک گوتنبرگ: کدام را انتخاب کنیم؟

روش ۱: افزودن شورت‌کد با بلوک Shortcode

ساده‌ترین روش استفاده از شورت‌کد در ویرایشگر بلوکی وردپرس:

نکته مهم:

می‌توانید شورت‌کد را مستقیماً در یک پاراگراف هم بچسبانید. هر دو روش نتیجه یکسانی دارند.

روش ۲: استفاده از شورت‌کد در ویجت

شورت‌کدها در ویجت‌های سایدبار و فوتر هم کار می‌کنند:

1. به نمایش ← ابزارک‌ها بروید
2. یک ویجت «متن» یا «HTML سفارشی» اضافه کنید
3. شورت‌کد را در آن وارد کنید
4. ذخیره کنید

روش ۳: استفاده در ویرایشگر کلاسیک

اگر از ویرایشگر کلاسیک (Classic Editor) استفاده می‌کنید:

1. در حالت «نوشتاری» (Visual) یا «متن» (Text)، شورت‌کد را مستقیماً تایپ کنید
2. هیچ تنظیمات خاصی نیاز نیست

روش ۴: استفاده از شورت‌کد در فایل‌های قالب (PHP)

گاهی نیاز دارید شورت‌کد را در فایل‌های قالب مثل header.php یا footer.php استفاده کنید. برای این کار از تابع do_shortcode() استفاده می‌شود:

<?php echo do_shortcode("[your_shortcode]"); ?>

به جای [your_shortcode]، شورت‌کد واقعی خود را قرار دهید.

ساخت شورت‌کد سفارشی

اگر می‌خواهید شورت‌کد اختصاصی خودتان را بسازید، کد زیر را به فایل functions.php قالب یا یک افزونه سفارشی اضافه کنید:

مثال ۱: شورت‌کد ساده «سلام»

// تابع شورت‌کد
function wpb_demo_shortcode() {
    $message = 'سلام به سایت خوش آمدید!';
    return $message;
}
// ثبت شورت‌کد
add_shortcode('greeting', 'wpb_demo_shortcode');

حالا با نوشتن [greeting] در هر جای سایت، پیام «سلام به سایت خوش آمدید!» نمایش داده می‌شود.

مثال ۲: شورت‌کد با پارامتر

function custom_button_shortcode($atts) {
    $atts = shortcode_atts(array(
        'url' => '#',
        'text' => 'کلیک کنید',
        'color' => '#4caf50'
    ), $atts);

    return '<a href="' . esc_url($atts['url']) . '"
            style="background:' . esc_attr($atts['color']) . ';
                   color:#fff; padding:10px 20px;
                   border-radius:5px; text-decoration:none;">'
           . esc_html($atts['text']) . '</a>';
}
add_shortcode('button', 'custom_button_shortcode');

استفاده:

مثال ۳: شورت‌کد برای نمایش تبلیغات

function my_ad_shortcode() {
    $ad_code = '<div class="my-ad">
        <!-- کد تبلیغات اینجا قرار می‌گیرد -->
    </div>';
    return $ad_code;
}
add_shortcode('my_ad', 'my_ad_shortcode');

شورت‌کدهای پرکاربرد وردپرس

وردپرس چند شورت‌کد پیش‌فرض دارد که بدون نصب افزونه کار می‌کنند:

افزونه‌های محبوب با شورت‌کد

بسیاری از افزونه‌های معروف وردپرس از شورت‌کد استفاده می‌کنند:

• Contact Form 7: [contact-form-7 id="123"]
• WPForms: [wpforms id="456"]
• WooCommerce: [products limit="4"]
• TablePress: [table id=1]
• Elementor: [elementor-template id="789"]

نکات امنیتی شورت‌کد

عیب‌یابی مشکلات شورت‌کد

اگر شورت‌کد کار نمی‌کند:

1. بررسی فعال بودن افزونه: مطمئن شوید افزونه مربوطه فعال است
2. بررسی نگارش: شورت‌کد را دقیقاً مثل مستندات بنویسید
3. بررسی تداخل: سایر افزونه‌ها را غیرفعال کنید و تست کنید
4. بررسی کش: کش سایت را پاک کنید

برای داشتن سایت وردپرس پایدار و سریع، استفاده از هاست وردپرس بهینه‌شده توصیه می‌شود. همچنین می‌توانید از هاست لینوکس یا سرور مجازی برای پروژه‌های بزرگ‌تر استفاده کنید.