ووردبريس الأكواد المختصرة – WordPress Shortcode

الأكواد المختصرة تقوم بعمل هوك لربط تنفيذ دالة php هي مفيدة جداً في حالات الحاجة إلي تكرار تنفيذ كود معين فيتم إستدعائه بإستخدام الـ shortcode من خلال التدوينة بالإستعنة بـ Plugin API المتمثل في الدالة add_shortcode

و الأكواد المختصرة shortcode لها إستخدامات كتير لا تعد و لكن سوف نتطرق لأهم آليات عملها

الآلية المجرده

أبسط آلية لعمل الأكواد المختصرة لنفرض أننا بحاجة إلي shortcode لتنفيذ دالة php تخرج رابط لبروفايلك علي الفيس بوك

و لتنفيذ هذة الـ php function يتم كتابة الكود المختصر ضمن التدوينة

[fbme]

و يتم كتابة هذا الكود ضمن كود إضافات ووربريس

<?php
function fbprint(){
	echo '<a href="http://www.facebook.com/abdelbary8">abdelbary8</a>';
}
add_shortcode('fbme', 'fbprint');
?>

آلية الإحتواء

تتشابه هذة الآلية مع وسوم html التقليدية لنا في الوسوم المذدوجة كمثال علي آلية الإحتواء سنكتب shortcode handler لتوسيط المحتوي

<?php
function align_center( $atts, $content = null ) {
   return '<center>' . $content . '</center>';
}
add_shortcode('cen', 'align_center');
?>

ليتم إستخدامة بهذة الطريقة

[cen]النص المراد توسيطة[cen]

آلية الخصائص

عند الحاجة إلي توسيع خيارات الكود المختصر نلجأ إلي إستخدام الخصائص مثل تطوير المثال السابق
ليعرض بروفايل معين عن طريق تمرير الـ id الخاص بالبروفايل علي الفيس بوك بالشكل التالي

[fbme id="123456"]

تقترح وئائق ووردبريس كودكس أسلوب معين لكتابة دالة الكود المختصر التي تستخلص الخصائص لمعاجتها

<?php
function my_shortcode_handler( $atts, $content = null ) {
   extract( shortcode_atts( array(
      'attr_1' => 'attribute 1 default',
      'attr_2' => 'attribute 2 default',
      // ...etc
      ), $atts ) );
}
?>

Related Posts via Categories

• تفاعل إضافات ووردبريس مع قواعد البيانات
• واجهة برمجة التطبيقات لإِضَافَات ووردبريس Plugin API
• كتابة إِضَافَات ورد بريس WordPress Plugins