کد کوتاه چیست و نحوه استفاده از آن

کدهای کوتاه ابزارهای قدرتمندی هستند اما هنوز تابع ناشناخته ای در وردپرس هستند. تصور کنید که شما می تواند فقط کلمه ی “adsense”را برای نمایش یک “adsense” یا “post_count”تایپ کنید تا فورا بتوانید تعداد پستهای وبلاگ خود را پیدا کنید.
کد های کوتاه وردپرس می تواند این کار و حتی بیشتر از آن را انجام دهد و قطعا زندگی وبلاگ نویسی شما را آسانتر می کند. در این مقاله، ما به شما نحوه ایجاد و استفاده از کدهای کوتاه را نشان داده، و همچنین مخرب های (killer) کدهای کوتاه آماده به استفاده وردپرس را که تجربه وبلاگ نویسی شما را افزایش خواهند داد، ارائه میدهیم.

معرفی کدهای کوتاه

استفاده از کدهای کوتاه بسیار آسان است. برای استفاده از یکی از آنها، یک پست جدید ایجاد کنید (و یا یکی از قدیمی ها را ویرایش کنید) ویرایشگر() به حالت HTML تغییر دهید و یک کد کوتاه در پرانتز تایپ کنید، مانند:

[showcase]

همچنین استفاده کردن از ویژگیها با کدهای کوتاه ممکن است. یک کد کوتاه استفاده شده با ویژگی ها چیزی شبیه به این خواهد بود:

[showcase id="5"]

همانطور که در اینجا نشان داده شده است، کدهای کوتاه همچنین می توانند دارای محتوای باشند:

[url href="http://www.tegrahost.com"]tegrahost blog[/url]

کدهای کوتاه بر اساس مجموعه ای از توابع معرفی شده در وردپرس ۲٫۵ به کار گرفته شده اند که کد کوتاه API نامیده می شود. هنگامی که یک پست ذخیره شد، محتوای آن تجزیه می شود و کد کوتاه API به طور خودکار کدهای کوتاه را برای نمایش توابعی که در نظر دارید نمایش داده شود، تغییر می دهد.

چگونه از کد کوتاه وردپرس استفاده کنیم؟

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

معرفی کدهای کوتاه وردپرس

ابتدا به معرفی چندین کد کوتاه که خود وردپرس از آنها استفاده میکند، میپردازیم. برخی شورت کد های وردپرس عبارتند از:

1. کد کوتاه پخش موسیقی یا فایل صوتی [ audio ]
2. شورت کد پخش فیلم یا ویدیو [ video ]
3. کد کوتاه ساخت لیست پخش موسیقی یا فیلم [ playlist ]
4. شورت کد ساخت گالری عکس و تصاویر [ gallery ]
5. کد کوتاه embed قرار دادن فیلمهای یوتیوب و …
6. قرار دادن توضیحات کپشن برای تصاویر توسط [ caption ]
7. و …

تنظیمات در کد های کوتاه وردپرس

کد های کوتاه نیز دارای تنظیمات هستند البته به صورت گرافیکی فقط افزونه های کد کوتاه تنظیمات دارند اما میتوانید برای کد های کوتاهی که دروردپرس اضافه شده است یا کرده اید نیز تغییراتی اعمال کنید برای انجام تغییرات در کد کوتاه باید ابتدا آن را یافته که برای یافتن انها باید به آدرس wp-content/themes/ نام پوسته مراجعه کرده و سپس باید در فایل function.php شورت کد های خود را جست و جو کنید . قالب کدی که شما به دنبال آن هستید مانند زیر است :

function my_shortcode_function() { $i = '<p>Hello World!</p>';return $i;} add_shortcode('my-shortcode', 'my_shortcode_function');

و بعد از یافتن می توانید تغییرات دلخواه خود را انجام دهید .

دریافت ورودی توسط کد های کوتاه

در اولین روش شما می توانید ورودی را به عنوان صفت دریافت کنید

[tegra name="تگراهاست"]

با انجام این کار این ورودی ها به عنوان یک ارایه به ورودی اول تابع کد کوتاه ما ارسال می شوند . البته ممکن است برخی از صفات ضروری نباشند به همین خاطر می توانیم از تابع shortcode_atts استفاده نمود . این تابع ۲ ورودی را دارا می باشد ، ورودی اول مقادیر پیش فرض و ورودی دوم ما صفت های دریافتی تابع است .

function tegra_plugin_init(){
function tegra_function($attr){
$attr = shortcode_atts([
"val1"=>"Mhr",
"val2"=>"Developer"
],$attr);
$val1 = $attr["val1"];
$val2 = $attr["val2"];
return "ورودی های شما <br> ورودی اول : $val1 <br> ورودی دوم :‌$val2 ";
}
add_shortcode("tegra","tegra_function");
}
add_action("init","tegra_plugin_init");

در نوشته کد زیر را وارد کنید :

[tegra val1="Test Val 1"]

با انجام این مراحل ورودی اول طبق ورودی ارسالی ما می باشد اما ورودی دوم ورودی پیشفرض است .

ورودی محتوایی

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

[tegra]

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

[/tegra]

وردپرس در چنین مواقعی تمام محتوا را ( در قالب HTML) به عنوان ورودی دوم تابع برای شما می فرستد .

به مثال زیر توجه فرمایید :

function np_plugin_init(){
function npvip_function($attr,$content){
$attr = shortcode_atts([
"onlyvip"=>"true"
],$attr);
if($attr["onlyvip"] == "true"){
if(isVip()){
return "محتوای خاص و ویژه :‌ <br>".$content;
}else{
return "<hr>شما کاربر VIP نیستید ...<hr>";
}
}else{
return "محتوای ویژه :‌ <br>".$content;
}
}
add_shortcode("npvip","npvip_function");
}
add_action("init","np_plugin_init");

 

function isVip(){

// این یک تابع نمایشی است که در آن باید تست کنیم که کاربر vip است یا خیر
return false;
}

در کد بالا یک ورودی با نام isVip که اگر آن را برابر true قرار دهیم چک میکند که کاربر ویژه است یا نه اگر کاربر ویژه بود متن محتوای کد کوتاه را نمایش می دهد در غیر این صورت پیام شما کاربر VIP نیستید را نمایش میدهد .اگر isVip هم برابر true نبود که بدون در نظر گرفتن VIP بودن محتوا را نمایش می دهد .

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

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

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

و برای حذف شورت کد ها از قالب وردپرس باید از یک قطعه کد استفاده کنید البته توجه داشته باشید استفاده از شورت کد های بسیار زیاد در فایل های قالب وردپرس بسیار خطرناک است و بهتر چندان این کار انجام نشود حال برای حذف کد های کوتاه باید در فایل function.php کد زیر را قرار دهید:

add_shortcode( 'نام کد کوتاه', '__return_false' );

این کد شورت کد های مورد نظر شما را غیرفعال میکند .

چگونه از شورت کد وردپرس در پوسته استفاده کنیم؟

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

echo do_shortcode('');
// مثال
echo do_shortcode('[tegrahost-forms id="91" title="quote"]');

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