استفاده از شورت کد در وردپرس

شورت کد در وردپرس که به فارسی کد کوتاه هم گفته می‌شود، قطعه کد بسیار کوتاهی است که برای اجرای دستورات استفاده می‌شود. shortcode با علامت [ ] تعریف می‌شود. از آن‌ها می‌توانیم در هر کجای سایت استفاده کنیم. در این آموزش با ۲ نوع شورت کد آشنا شده و روش‌های استفاده از آن را یاد می‌گیریم.

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

برای جذب مشتری بیشتر، دوست داریم در وسط هر محتوا، یک باکس برای دعوت کاربر به دریافت مشاوره از ما قرار دهیم. راه حل اول این است که متن cta (دعوت به اقدام) برای مشاوره و شماره تماس را در وسط محتوا بنویسیم.

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

شورت کد در وردپرس چیست ؟

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

در مثالی که زدم، فرض کنید یک شورت کد به نام [cta] ایجاد می‌کنیم. در اینصورت در هر بخش از متن که نیاز به نمایش باکس مشاوره بود، این کد کوتاه اختصاصی را قرار می‌دهیم.

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

انواع کد کوتاه وردپرس

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

نوع اول shortcodeها به صورت یک قسمتی است. یعنی با ] شروع شده و با [ تمام می‌شود. در باکس زیر ۲ شورت کد به این شکل قرار گرفته است:

[sabzdanesh]

[video url="example.ir/add-shortcode-to-wordpress.mp4" title="فیلم آموزشی"]

نوع دوم کد کوتاه در وردپرس دارای یک بخش محتوایی هم هستند. این نوع با [shortcode] شروع شده و با [/shortcode] پایان می‌یابد. به جای shortcode نام کد کوتاه قرار می‌گیرد. دو نمونه از این کدها را در زیر قرار داده‌ام:

[sabzdanesh]تیم پشتیبانی ما تا ورود به بازار کار کنارتان خواهند بود![/sabzdanesh]

[text color="red"]همیشه مهارت‌های خودتان را افزایش دهید![/text]

ساختار شورت کد در وردپرس از سه بخش اصلی تشکیل شده است:

  • نام shortcode (و در نوع دوم علامت پایان)
  • ویژگی‌های شورت کد
  • بدنه یا محتوای درون کد کوتاه

افزودن شورت کد به سایت

برای اضافه کردن کد کوتاه به وردپرس، سه محل داریم. تقریباً هر جایی از سایت که بخواهید می‌توانید یک شورت کد اضافه کنید. در ادامه این ۳ روش را با هم یاد می‌گیریم.

افزودن shortcode در ویرایشگر وردپرس

برای افزودن شورت کد در ویرایشگر گوتنبرگ ابتدا باید بلوکی به نام «کد کوتاه» (در انگلیسی shortcode) را به محتوای صفحه اضافه کنید.

بلوک کد کوتاه در گوتنبرگ وردپرس
بلوک کد کوتاه در گوتنبرگ وردپرس

حالا کد کوتاه مورد نظر را درون کادر آن وارد کنید. به همین سادگی! 🙂

باکس نمایش داده شده در ویرایشگر
باکس نمایش داده شده در ویرایشگر

معمولاً اگر قبل از ایجاد بلوک، یک کد را copy paste کنید، به طور خودکار بلوک شورت کد در وردپرس ایجاد می‌شود. اما همیشه می‌توانید از مسیر بالا یک بلوک برایش ایجاد کنید.

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

افزودن شورت کد به ابزارک وردپرس

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

افزودن کد کوتاه به ابزارک در وردپرس
افزودن کد کوتاه به ابزارک در وردپرس
افزودن کد به وردپرس (3 روش افزودن کد سفارشی)

افزودن کد به وردپرس (3 روش افزودن کد سفارشی)

کد کوتاه در قالب سایت

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

در وردپرس تابعی به نام do_shortcode() وجود دارد. این تابع یک ورودی به صورت رشته متنی php گرفته، شورت کد را اجرا کرده و خروجی را به ما برمی‌گرداند.

متناسب با اینکه تابع مربوط به شورت کد وردپرس چگونه نوشته شده است، می‌توان از دستور echo برای نمایش خروجی هم استفاده کرد.

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

حالت‌های پیچیده‌تر شورت کد را هم می‌توانیم با این تابع اجرا کنیم:

<?php echo do_shortcode("[your_shortcode attr1='one' attr2='two']"); ?>

مرور استفاده از شورت کد وردپرس

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

یاد گرفتیم که [name] ساده‌ترین حالت shortcode است.ممکن است هر شورت کد یک یا چند ویژگی یا بدنه (محتوای درون) داشته باشد.

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

  • افزودن بلوک شورت کد در گوتنبرگ
  • افزودن کد کوتاه به ابزارک متن (یا در ویرایشگر کلاسیک)
  • استفاده از تابع do_shortcode() برای اجرای آن در پوسته

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

شما از کدهای کوتاه برای چه منظوری استفاده می‌کنید؟ از بخش دیدگاه‌ها مثال‌های بیشتری برای دوستانتان بزنید.