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

کدهای کوتاه همراه عالی هستند، و سرعت کار را به میزان قابل توجهی افزایش می دهند، اما آیا این عالی نیست که بدانید چگونه کدهای کوتاه خود را ایجاد کنید؟

در این مقاله من شما را با ایجاد چند کد کوتاه ساده وردپرس آشنا می کنم تا به شما در ایجاد هر گونه عملکردی که دوست دارید کمک کند.

یک کد کوتاه ساده

Shortcode API بسیار ساده کار می کند: ابتدا باید یک تابع callback ایجاد کنید که هر زمان که از کد کوتاه استفاده شود اجرا شود. سپس باید آن تابع را به یک کد کوتاه خاص گره بزنید تا برای استفاده آماده شود. کد اغلب در فایل functions.php قرار می گیرد، اما اگر قصد دارید روی با داشتن تعداد زیادی کد کوتاه، منطقی است که یک فایل جداگانه ایجاد کنید و آن فایل را در فایل functions.php خود قرار دهید.

در مثال اول ما می خواهیم یک کد کوتاه ایجاد کنیم که تعدادی را ایجاد کند لورم اپیسوم هر بار که تایپ می کنیم (لورم) وارد ویرایشگر ابتدا باید تابع callback را ایجاد کنیم که lorem ipsum را برمی گرداند (در کدهای کوتاه که این کار را نمی کنیم echo هر چیزی، همه چیز برگردانده می شود):

function lorem_function() {
 return 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec nec nulla vitae lacus mattis volutpat eu at sapien. Nunc interdum congue libero, quis laoreet elit sagittis ut. Pellentesque lacus erat, dictum condimentum pharetra vel, malesuada volutpat risus. Nunc sit amet risus dolor. Etiam posuere tellus nisl. Integer lorem ligula, tempor eu laoreet ac, eleifend quis diam. Proin cursus, nibh eu vehicula varius, lacus elit eleifend elit, eget commodo ante felis at neque. Integer sit amet justo sed elit porta convallis a at metus. Suspendisse molestie turpis pulvinar nisl tincidunt quis fringilla enim lobortis. Curabitur placerat quam ac sem venenatis blandit. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Nullam sed ligula nisl. Nam ullamcorper elit id magna hendrerit sit amet dignissim elit sodales. Aenean accumsan consectetur rutrum.';
}

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

add_shortcode('lorem', 'lorem_function');

این تمام چیزی است که برای ایجاد یک کد کوتاه ساده در وردپرس لازم است.

افزودن پارامترها

در ادامه با این ایده محتوای ساختگی، ما اغلب به تصاویری در محتوای خود نیاز داریم که ماکاپ های خود را آماده می کنیم و این تصاویر باید اندازه های متفاوتی داشته باشند، بنابراین اکنون یک کد کوتاه برای درج تصویری مانند این ایجاد می کنیم:

(picture width="500" height="500")

هنگامی که وردپرس با این مورد روبرو می شود ما تابعی می خواهیم که یک تصویر را وارد کند. باید ویژگی های عرض و ارتفاع را بخواند، اما فقط در صورتی که مقادیر پیش فرض را نیز ارائه کنیم تا بتوان بدون ویژگی ها از آن استفاده کرد. چون ممکن است تصویری در دسترس نداشته باشیم، از آن استفاده خواهیم کرد lorempixel.com خدماتی برای ارائه یک تصویر تصادفی به ما.

ابتدا باید تابع را ایجاد کنیم:

function random_picture($atts) {
 extract(shortcode_atts(array(
 'width' => 400,
 'height' => 200,
 ), $atts));
return '<img src="https://lorempixel.com/'. $width . "https://www.webdesignerdepot.com/". $height . '" />';
}

نام این تابع را گذاشتیم عکس_تصادفی و از آنجایی که این کد کوتاه قادر به گرفتن آرگومان ها خواهد بود، ما به آن دادیم $ atts پارامتر. برای استفاده از ویژگی ها به دو تابع نیاز داریم: the shortcode_atts که یک تابع وردپرس است که ویژگی های ما را با ویژگی های شناخته شده ترکیب می کند و در صورت نیاز پیش فرض ها را پر می کند. و استخراج کردن تابع PHP که همانطور که از نام آن پیداست، ویژگی هایی را که برای کد کوتاه خود تنظیم کرده ایم استخراج می کند. در نهایت تابع مقدار مورد نظر ما را برمی گرداند، در این مورد کد HTML تصویر ما همراه با متغیرهای عرض و ارتفاع.

تنها کاری که باید انجام دهید این است که این کد کوتاه را ثبت کنید:

add_shortcode('picture', 'random_picture');

وقتی تایپ می کنیم کد کوتاه ما کامل است (تصویر) یک تصویر تصادفی 400 در 200 به ما می دهد و اگر از ویژگی ها استفاده کنیم می توانیم تصویری با هر اندازه ای که بخواهیم ایجاد کنیم.

نتیجه

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

آیا کدهای کوتاه مفیدی برای وردپرس ایجاد کرده اید؟ دوست دارید چه کدهای کوتاهی وجود داشته باشد؟ در نظرات به ما اطلاع دهید.

تصویر/تصویر کوچک ویژه، تصویر کد از طریق Marjan Krebelj.