در قسمت قبل درمورد کدهای کوتاه و فلسفهی آنها صحبت کردیم، در این قسمت از سری مقالات “آموزش کدهای کوتاه”، با هم اولین کدکوتاه را میسازیم. برای اینکه این مقاله را به خوبی متوجه شوید، باید PHP را حداقل در سطح مبتدی بدانید.
کدهایی که در این مقاله مینویسیم را میتوانید در فایل functions.php ذخیره کنید یا اینکه یک پلاگین بسازید. در صورتی که قصد داریم کدها را روی یک سایت زنده امتحان کنید، بهتر است یک پلاگین جدا بسازید.
برای افزودن یک کدکوتاه به سیستم وردپرس، به دو مورد نیاز داریم:
- نام کد، برای مثال اگر نام کد را abc انتخاب کنیم، کاربر میتواند با استفاده از کد [abc] آن را فراخوانی کند.
- تابع بازگشتی (Callback) برای بازگرداندن خروجی HTML به جای کد
دقت کنید که نام کد باید حتماً انگلیسی باشد و از حروف انگلیسی کوچک، اعداد و کاراکترهای – و _ تشکیل شده باشد.
برای معرفی کدکوتاه به سیستم، از تابع add_shortcode استفاده میکنیم
add_shortcode( string $name, callback $function );
برای استفاده از تابع add_shortcode نیازی به هک (Hook) زدن نیست و با فراخوانی آن در فایل پلاگین، تابع کار خواهد کرد.
برای شروع، ابتدا یک کدکوتاه با نام my-first و با تابع بازگشتی my_first_callback اضافه میکنیم.
add_shortcode( 'my-first', 'my_first_callback' );
حالا تابع بازگشتی را با نام my_first_callback میسازیم. دقت کنید که نام تابعتان حتماً باید با پارامتر دوم add_shortcode یکسان باشد.
function my_first_callback() { }
حالا تابع بازگشتی ما تعریف شده و ما باید از این تابع برای نمایش محتوای کدکوتاه خود استفاده کنیم.
بسیاری از توسعهدهندگان در تابع بازگشتی کدکوتاه از echo استفاده میکنند که باعث به همریختگی نوشته میشود. راه درست برای چاپ مطالب کدکوتاه، استفاده از return است. برای مثال، من عبارت Hello, World! را جایگزین کدکوتاه میکنم:
function my_first_callback() { return 'Hello, World!'; }
حالا با اضافهکردن کدکوتاه [my-first] به یک نوشته، میتوانید عملکردن آن را ببینید 🙂
به همین سادگی شما یک کدکوتاه ساختید! در مقالات بعدی نحوه گرفتن پارامترها و داینامیککردن کدکوتاه را با هم فرامیگیریم.