نمایش شورت کد در قالب وردپرس با استفاده از تابع do_shortcode

شورت‌کد یا کد کوتاه کمک می‌کنه بدون نوشتن کدهای طولانی، چیزهایی مثل ویدئو، گالری یا فرم رو به سایتتون اضافه کنید. توی نوشته‌ها، برگه‌ها و بخش‌های قابل‌ویرایش قالب‌های بلوکی، معمولاً بلوک شورت‌کد کارتون رو راه می‌اندازه. ولی اگه بخواید یک شورت‌کد رو داخل فایل PHP قالب اجرا کنید، باید سراغ تابع do_shortcode() برید.

توی این آموزش اول با خود شورت‌کد آشنا می‌شید و بعد می‌بینید چطور از do_shortcode در وردپرس استفاده کنید. در کنارش، تفاوت قالب‌های کلاسیک و بلوکی رو توضیح می‌دیم و می‌بینیم چرا تغییر مستقیم فایل‌های قالب اصلی فکر خوبی نیست.

شورت‌‌کد چیه؟

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

قابلیت شورت‌کد از نسخه ۲.۵ به وردپرس اضافه شده و هنوز هم می‌تونید ازش استفاده کنید. خیلی از افزونه‌ها برای نمایش فرم، اسلایدر، جدول یا محتوای اختصاصی، یک شورت‌کد آماده در اختیارتون می‌ذارن.

برای استفاده معمولی، فقط کافیه بلوک «شورت‌کد» رو به نوشته یا برگه اضافه کنید و کد کوتاهتون رو داخلش بذارید. توی قالب‌های بلوکی، یعنی قالب‌هایی که هدر، فوتر و بخش‌های دیگه‌شون با ویرایشگر سایت ساخته می‌شن، در خیلی از قسمت‌های قالب هم می‌تونید از همین بلوک استفاده کنید.

اگه می‌خواید شورت‌کد رو توی نوار کناری سایت بذارید، آموزش استفاده از شورت‌کد در ابزارک وردپرس قدم‌به‌قدم مسیرش رو بهتون نشون می‌ده.

اگه هنوز شورت‌کد براتون ناآشناست، مقاله شورت‌‌کد چیست و چرا در وردپرس استفاده می‌‌شود کمک می‌کنه با جزئیات بیشتری از این قابلیت آشنا بشید.

نمایش شورت کد در قالب وردپرس

تابع do_shortcode() وقتی به دردتون می‌خوره که بخواید شورت‌کد رو داخل یک فایل PHP اجرا کنید. این تابع متن شورت‌کد رو می‌گیره، پردازشش می‌کنه و خروجی آماده رو بهتون تحویل می‌ده.

قبل از اینکه سراغ PHP برید، ببینید محل موردنظرتون بلوک شورت‌کد داره یا نه. اگه هدر، فوتر یا اون بخش از سایت با ویرایشگر سایت قابل‌ویرایشه، اضافه‌کردن بلوک شورت‌کد معمولاً ساده‌تر و امن‌تره. در این حالت لازم نیست به فایل‌های قالب دست بزنید.

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

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

به‌جای [your_shortcode] شورت‌کد واقعی افزونه یا قابلیت موردنظرتون رو بذارید. مثلاً اگه افزونه فرم‌ساز یک شورت‌کد بهتون داده، همون کد کامل رو همراه با کروشه‌ها جایگزین کنید. اگه می‌خواید یک فرم ثابت رو در بخش‌های مختلف سایت نشون بدید، آموزش نمایش فرم تماس در تمام صفحات وردپرس هم براتون کاربردیه.

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

نکته: فایل‌های قالب اصلی رو مستقیم تغییر ندید، چون ممکنه بعد از به‌روزرسانی قالب همه تغییراتتون پاک بشن. بهتره از پوسته فرزند یا افزونه‌ای مثل Code Snippets برای افزودن توابع سفارشی کمک بگیرید. قبل از شروع کار هم حتماً یک نسخه پشتیبان سالم از سایتتون داشته باشید.

آموزش استفاده از تابع do_shortcode

برای یک مثال ساده، فرض کنید می‌خواید با شورت‌کد داخلی وردپرس یک ویدئو نشون بدید. شورت‌کد ویدئو یک جفت کروشه داره و می‌تونه به این شکل نوشته بشه:

[video mp4="VIDEO_URL"]

عبارت VIDEO_URL فقط یک جای‌نگهداره؛ یعنی باید اون رو با نشانی کامل فایل ویدئوتون عوض کنید. اگه فقط می‌خواید ویدئو رو توی یک نوشته یا برگه نشون بدید، استفاده از بلوک «ویدئو» یا بلوک «شورت‌کد» انتخاب راحت‌تریه.

اگه واقعاً نیاز دارید همین شورت‌کد توی فایل PHP یک قالب کلاسیک اجرا بشه، کدتون به این شکل درمیاد:

<?php echo do_shortcode( '[video mp4="VIDEO_URL"]' ); ?>

حالا VIDEO_URL رو با نشانی کامل ویدئوتون جایگزین کنید. این کد رو فقط داخل فایل PHP مناسب در پوسته فرزند بذارید. قبل از انتشار روی سایت اصلی هم نتیجه رو توی یک محیط آزمایشی بررسی کنید.

تفاوت قالب کلاسیک و قالب بلوکی

اگه توی پیشخوان وردپرس وارد بخش «نمایش» می‌شید و گزینه «ویرایشگر» رو می‌بینید، احتمالاً سایتتون از یک قالب بلوکی استفاده می‌کنه. توی این نوع قالب می‌تونید بخش‌هایی مثل هدر و فوتر رو با بلوک‌ها ویرایش کنید و هرجا پشتیبانی بشه، بلوک شورت‌کد رو هم بذارید.

اگه قالب کلاسیک دارید، ساختار بخش‌های مختلف سایت معمولاً داخل فایل‌های PHP قالب قرار گرفته. بااین‌حال، بهتره فایل‌ها رو مستقیم از پیشخوان ویرایش نکنید. ممکنه این امکان به‌خاطر تنظیمات امنیتی غیرفعال باشه و حتی یک اشتباه کوچک در کد هم ظاهر سایتتون رو به‌هم بریزه.

برای تغییر یک قالب کلاسیک، بهتره اول پوسته فرزند بسازید، فایل موردنظرتون رو به اون منتقل کنید و تغییر رو توی محیط آزمایشی انجام بدید. اگه نمی‌دونید کد باید داخل کدوم فایل قرار بگیره، از توسعه‌دهنده قالب کمک بگیرید؛ چون انتخاب فایل اشتباه می‌تونه نتیجه‌ای متفاوت با چیزی که می‌خواید بسازه.

چند نکته برای استفاده امن از do_shortcode

• اول ببینید بلوک اختصاصی افزونه یا بلوک شورت‌کد کارتون رو راه می‌اندازه یا نه.
• کد PHP رو داخل قالب اصلی نذارید؛ چون به‌روزرسانی قالب می‌تونه تغییراتتون رو پاک کنه.
• شورت‌کد رو دقیقاً با یک جفت کروشه وارد کنید و علامت‌های نقل‌قول داخل کد رو تغییر ندید.
• قبل از تغییر سایت اصلی، کد رو توی محیط آزمایشی امتحان کنید و یک نسخه پشتیبان قابل‌بازیابی داشته باشید.
• اگه افزونه سازنده شورت‌کد رو غیرفعال کردید، صفحه موردنظرتون رو دوباره بررسی کنید.

تابع do_shortcode() هنوز بخشی از وردپرسه و برای اجرای شورت‌کد داخل PHP به کار می‌ره. بااین‌حال، توی خیلی از سایت‌های امروزی استفاده از بلوک اختصاصی افزونه یا بلوک شورت‌کد ساده‌تر و کم‌ریسک‌تره. پس فقط وقتی از این تابع کمک بگیرید که واقعاً لازم باشه شورت‌کد رو داخل یک فایل PHP اجرا کنید.

جمع‌بندی

اگه فقط می‌خواید یک فرم، ویدئو یا محتوای دیگه رو داخل نوشته، برگه، هدر یا فوتر نشون بدید، اول سراغ بلوک اختصاصی افزونه یا بلوک «شورت‌کد» برید. تابع do_shortcode() زمانی انتخاب مناسبیه که محل موردنظرتون داخل یک فایل PHP از قالب کلاسیک باشه. در این حالت شورت‌کد رو دقیق وارد کنید، تغییر رو داخل پوسته فرزند انجام بدید و قبل از دست‌زدن به سایت اصلی، از سایتتون نسخه پشتیبان بگیرید و کد رو توی محیط آزمایشی بررسی کنید.

سوالات متداول

تیم تولید محتوا

ما در تیم تولید محتوای میهن وردپرس در تلاش هستیم تا بهترین مقالات آموزشی در زمینه وردپرس و کسب‌و‌کارهای اینترنتی را تهیه کنیم. صحت محتوای این صفحه توسط رضا راد بررسی خواهد شد.