دليل شامل لاستخدام الاكواد المختصرة (Shortcodes) في ووردبريس

ووردبريس بيرجع لأوائل الألفينات، لما كانت منصات التدوين في قمة مجدها. ووردبريس بدأ في الأصل كمنصة للتدوين، بس مع مرور السنين، بقى اداة شعبية وفعالة لبناء المواقع مع نظام إدارة محتوى (CMS) قوي بشكل مش طبيعي. تقدر تعمل موقع شكله حلو ومتخصص اوي باستخدام منصة ووردبريس. وطريقة من الطرق اللي تعمل بيها كده هي استخدام الاكواد المختصرة (Shortcodes) في ووردبريس.

ايه هو الكود المختصر (Shortcode)؟ الكود المختصر هو اختصار بيساعدك تضيف وتحدد عناصر مختلفة في كود الصفحة بتاعتك. ببساطة، الاكواد المختصرة هي اجزاء صغيرة من الكود ممكن تعمل وظايف كتير. بتبسط كود الموقع بتاعك وبتخليه سهل انك تديره حتى لو معندكش أي خبرة في تطوير المواقع. تقدر تدخل الاجزاء الصغيرة دي من الكود في اي مقال، صفحة، او ويدجت على الموقع بتاعك علشان تضيف وظايف ديناميكية زي معارض الصور، الفيديوهات، أو محتوى من مصادر خارجية. الاكواد المختصرة بتظهر بين اقواس زي ما هو موضح في الصورة اللي تحت:

الاكواد المختصرة سهلة الاستخدام، وممكن كمان تعمل الاكواد بتاعتك من غير اي معرفة مسبقة بالكود.

الاكواد المختصرة في ووردبريس هي اكواد صغيرة تقدر تستخدمها في محرر ووردبريس العادي، الويدجتس، والقوالب علشان تخصص الموقع بتاعك. من الناحية التقنية، دوال PHP اللي بتتعرف في عملية تسجيل الكود المختصر بتشغل الاكواد المختصرة علشان تعرض المحتوى اللي عايز تدخله. بالرغم من سهولة استخدامها، الناس غالباً بيتجاهلوا أو حتى ميعرفوش عن الاكواد المختصرة في ووردبريس، بالرغم من فائدتها.

هنا نوعين من الاكواد المختصرة هيساعدوك تعيد تشكيل المحتوى بتاعك لتجربة مستخدم جذابة:

• الاكواد المختصرة ذاتية الإغلاق (Self-closing shortcodes): النوع ده من الاكواد المختصرة بيتضمن تاج واحد بس بيقفل نفسه. علشان تخصص كود مختصر ذاتي الإغلاق، محتاج تحدد خصائص زي العرض، المعرف (ID)، أو الترتيب.
• الاكواد المختصرة المحتوية (Enclosing shortcodes): من الناحية التانية، محتاج تاج قفل للنوع ده من الاكواد المختصرة. ممكن تحدد الخصائص كمان، بس المحتوى الأساسي بيكون موجود بين تاجات الفتح والقفل. في معظم الأوقات، هتلاقي الاكواد المختصرة المحتوية مستخدمة مع عناصر HTML. خلينا نبص على المثال اللي جاي للكود المختصر في ووردبريس:

ده كود مختصر محتوى لعنوان فرعي (caption) بيمكّنك تحط عناوين فرعية حوالين المحتوى، واللي غالباً بيستخدم للصور. بيكون ليه قيمة بين تاجات الكود المختصر للفتح والقفل اللي بتحدد المحتوى. في حالتنا، فيه رابط للصورة نفسها مع الخصائص المناسبة ليها. علشان نفهم الفرق بين النوعين دول من الاكواد المختصرة بشكل أحسن، خلينا نبص على الصورة اللي تحت:

معظم الاكواد المختصرة بتوضح اوي هي بتعمل ايه. على سبيل المثال، الكود المختصر [gallery] بيدخل معرض صور على موقعك في ووردبريس. علشان تستخدمه، ببساطة محتاج تلزقه جوه مقال أو صفحة، وهيكون ظاهر فوراً في الواجهة الأمامية. في الكواليس، الكود المختصر بيقول لووردبريس يشغل جزء طويل من الكود جوه واحد من ملفات الموقع بتاعك. بس الطريقة دي مش محتاجة أي مدخلات تانية منك. وده اللي بيجي فيه دور WordPress shortcode API. الـ shortcode API هي مجموعة سهلة من المميزات لعمل اكواد مختصرة في ووردبريس بتستخدم في المقالات والصفحات. الـ API بيمكّن مطوري الإضافات انهم يعملوا أنواع فريدة من المحتوى اللي المستخدمين يقدروا يوصلوها بصفحاتهم عن طريق إضافة الكود المختصر المناسب في نص صفحة الويب. الـ API بيتعامل مع كل التحليل المعقد، وبيشيل الحاجة لكتابة regex مخصص لكل وظيفة في الكود. دوال المساعدة لتعيين واستدعاء الخصائص القياسية متضمنة. الـ API بيدعم الاكواد المختصرة للقفل التلقائي والإلحاق - أو زي ما بيتسمى بشكل شعبي في مجتمع تطوير ووردبريس، لكل من الاكواد المختصرة ذاتية الإغلاق والمحتوية.

في شوية نصايح لتصميم الصفحة الرئيسية للمدونة علشان تساعدك تبدأ. (الأقواس اتشالت علشان تظهر كنص في الصفحة دي.)

• video - بمساعدة الكود المختصر ده، تقدر بسهولة تضيف محتوى فيديو لصفحة ووردبريس بتاعتك.
• playlist - استخدم الكود المختصر ده علشان تشارك قايمة من التراكات الموسيقية لزوار الموقع بتاعك.
• gallery - بيمكّنك تشارك صور متعددة على نفس الصفحة في عرض معرض.
• caption - بيديك الفرصة تلف عناوين فرعية حوالين أي نوع من المحتوى.
• embed - بيمكّنك تدخل عناصر مضمنة.
• audio - بيسمحلك تنشر ملفات صوتية على صفحة الويب بتاعتك.

دول واضحين تماماً ومش بيطلبوا اي مهارات خاصة منك علشان تستخدمهم. بس لو الاكواد المختصرة دي مش بتلبي احتياجاتك، تقدر تعمل الاكواد بتاعتك بمساعدة الدليل التعليمي اللي جاي.

الـ WordPress shortcode API بيخلي عمل الاكواد المختصرة الخاصة بك بسيط إلى حد ما. عمل ده هيمكنك تستغل مميزات القالب أو الإضافة بتاعتك من أي مكان قايم على النصوص في موقعك في ووردبريس. عمل كود مختصر بيبدأ بدالة add_shortcode. بتتضمن اتنين من المعاملات - تاج كود مختصر فريد بيمثل اسم الكود المختصر ودالة المعالج اللي بتتنفذ بعد تسجيل الكود المختصر. الصيغة البسيطة جداً للدالة معروضة تحت:

shortcode_name هو تاج كود مختصر فريد، و handler_function_name هو اسم دالة رد النداء. بالإضافة لتسجيل الكود المختصر بتاعك، محتاج تحدد دالة المعالج نفسها. الدالة دي بتدي هدف للكود المختصر بتاعك. خلينا نبص على مثال عام لدالة معالج الكود المختصر:

لازم اسم الدالة يطابق السطر التاني من دالة add_shortcode (اللي هو handler_function_name). رد النداء نفسه ممكن يتضمن لحد تلات معاملات:

• المعامل $atts بيرمز للخصائص اللي بتمرر للدالة.
• المتغير $content بيمثل المحتوى اللي المستخدم بيدخله بين تاجات الفتح والقفل للكود المختصر.
• الخاصية $shortcode_tag هي اسم فريد بيتحدد في دالة add_shortcode. محتاج تدخل الخاصية دي بس لو اتنين من الاكواد المختصرة المسجلة بيشاركوا نفس معالج الدالة.

دالة الكود المختصر ممكن تكون بسيطة زي ما انت عايز، على حسب احتياجات الموقع بتاعك. ممكن تحط سكريبت الكود المختصر في ملف functions.php جوه أي مجلد إضافة أو قالب. أو، ممكن حتى تدخله في كود الصفحة مباشرة باستخدام محرر ووردبريس الافتراضي.

مطوري ووردبريس بيحبوا يستخدموا الاكواد المختصرة علشان سهلة اوي في عملها وتنفيذها. ممكن تدخل الاكواد المختصرة في أي مكان في الموقع بتاعك وتشيك النتايج فوراً عن طريق معاينة الصفحة. هنا ازاي تستخدم الاكواد المختصرة في ووردبريس:

• في صفحات الموقع