تعد الرموز القصيرة لـ وورد بريس ميزة قوية للقيام بأشياء رائعة مع القليل من الجهد. يمكنك فعل أي شيء معهم. باستخدام الرموز القصيرة ، يكون تضمين العناصر التفاعلية أو إنشاء تخطيطات صفحات معقدة أمرًا سهلاً مثل إدخال سطر واحد من التعليمات البرمجية.
إذا كنت ترغب في إضافة معرض ، عليك ببساطة كتابة الكود التالي:
[معرفات المعرض = "47 ، 86 ، 92 ، 64 ، 48 ، 75 ، 89 ، 80" أعمدة = "4" حجم = "متوسط"]سيؤدي هذا إلى إخراج معرض مع معرفات الصورة المذكورة. سيكون لها 4 أعمدة وسيكون حجمها الأقصى “متوسط” (كما هو محدد بواسطة وورد بريس).
ليست هناك حاجة لأي كود HTML قبيح.
معرض صور من 4 أعمدة مع صور فردية متوسطة الحجم
مثال للرمز المختصر للمعرض
تقضي الرموز القصيرة على الحاجة إلى نصوص معقدة. حتى إذا كانت لديك مهارات برمجة قليلة أو معدومة ، يمكنك إضافة محتوى ديناميكي بسهولة بمساعدتهم.
إنها تحظى بشعبية كبيرة بين مطوري وورد بريس ، لأنها تساعد بشكل كبير في أتمتة المحتوى وإنشاء التصميم. الرموز المختصرة لمطوري وورد بريس هي وحدات الماكرو لمحللي البيانات ، أو اختصارات لوحة المفاتيح لمصممي الرسوم المحترفين.
في هذا الدليل ، ستتعرف على كل ما يمكن معرفته عن الرموز القصيرة. سوف تتعلم كيفية العمل مع Shortcode API عن طريق إنشاء الرموز القصيرة الخاصة بك. في النهاية ، سنناقش مستقبل الرموز القصيرة وأين تتلاءم مع محرر Block الجديد في وورد بريس .
باختصار ، Shortcode = Shortcut + Code .
عادةً ما تستخدم الرموز القصيرة علامات الأقواس المربعة [] لتحديد كيفية استخدامها. يؤدي كل رمز قصير وظيفة معينة في الموقع. يمكن أن يكون الأمر بسيطًا مثل تنسيق المحتوى أو معقدًا مثل تحديد بنية موقع الويب بالكامل.
على سبيل المثال ، يمكنك استخدام الرموز القصيرة لتضمين منزلقات أو نماذج أو جداول أسعار . يمكنك حتى استخدامها لإنشاء قوالب تصميم صفحات قابلة لإعادة الاستخدام.
تم نشر الرموز القصيرة لأول مرة بواسطة برنامج منتدى عبر الإنترنت يسمى Ultimate Bulletin Board (UBB). في عام 1998 ، قدموا BBCode (Bulletin Board Code) ، وهي مجموعة من العلامات سهلة الاستخدام للمستخدمين لتنسيق منشوراتهم بسهولة.
توضح أمثلة BBCode أصول الرموز القصيرة لتنسيق النص
تنسيق سهل مع BBCodes بسيط
كلغة ترميز خفيفة الوزن ، تعمل BBCode على نفس مبادئ HTML ، إلا أنها أبسط بكثير.
يعد استخدام العلامات المحددة مسبقًا أكثر أمانًا أيضًا ، حيث لا يمكن للمستخدمين إدخال كود HTML وإدخال ثغرات أمنية . على سبيل المثال ، يمكن لمستخدم لديه نية ضارة استخدام علامة <script> لتنفيذ كود JavaScript وتعطيل وظائف الموقع.
بعد فترة وجيزة ، أضافت برامج المنتديات الأخرى على الإنترنت مثل phpBB و XMB Forum و vBulletin وظائف BBCode في لوحات الرسائل الخاصة بهم.
مكنت الرموز القصيرة المشرفين من التمتع بقدر أكبر من التحكم في ما يمكن للمستخدمين وما لا يمكنهم فعله. بالإضافة إلى ذلك ، سمحوا للمستخدمين بتنسيق المحتوى الخاص بهم من خلال علامات بسيطة.
نظرًا لنفس أسباب الأمان ، يمنع وورد بريس كود PHP من العمل داخل محتوى الموقع. للتغلب على هذا القيد ، قدم وورد بريس 2.5 وظيفة الرموز القصيرة في عام 2008 مع إصدار Shortcode API . لقد أثبتت أنها واحدة من أكثر الميزات استخدامًا من قبل العديد من مطوري قوالب ووردبريس الإضافية.
الأكواد المختصرة لـ وورد بريس هي سلاسل معقوفة ( [] ) تتحول بطريقة سحرية إلى شيء رائع على الواجهة الأمامية. إنها توفر للمستخدمين طريقة سهلة لإنشاء محتوى معقد وتغييره دون القلق بشأن HTML المعقد أو رموز التضمين.
رسم بياني يوضح كيفية عمل الرموز القصيرة في وورد بريس باستخدام Shortcode API
رموز وورد بريس المختصرة بسيطة وسهلة الاستخدام
يوجد نوعان أساسيان من الرموز القصيرة في وورد بريس.
صورة إعلامية توضح نوعين من الرموز القصيرة: الإغلاق الذاتي والتضمين. يمكن أن يكون كلاهما بسمات وبدونها.
يمكن أن تكون الرموز المختصرة للإغلاق الذاتي والتضمين صالحة مع أو بدون سمات.
الرموز القصيرة ذاتية الإغلاق: لا تحتاج إلى علامة إغلاق.
مثال: لا يحتاج الرمز المختصر للمعرض إلى علامة إغلاق. نضيف كل ما تحتاجه بسمات مختلفة.
إرفاق الرموز القصيرة: هذه تحتاج إلى علامة إغلاق. تتعامل الرموز القصيرة المرفقة عمومًا مع المحتوى بين علامتي الفتح والإغلاق.
مثال : يُستخدم الرمز المختصر للتعليق في التفاف تعليق حول أي محتوى. يتم استخدامه بشكل أساسي لإضافة تعليق على الصور ، ولكنه يعمل مع أي عنصر HTML.
تعمل بعض الرموز القصيرة مع أو بدون سمات. يعتمد ذلك على كيفية تعريفها.
يأتي وورد بريس مع 6 رموز مختصرة افتراضية:
الصوت : قم بتضمين ملفات الصوت على موقع الويب الخاص بك. يتضمن عناصر تحكم تشغيل بسيطة مثل Play & Pause.
التسمية التوضيحية : التفاف الشروح حول المحتوى الخاص بك معها. يتم استخدامه في الغالب لإضافة تسميات توضيحية للصور ، ولكن يمكنك استخدامها لأي عنصر HTML.
التضمين : قم بالتوسيع على ميزة oEmbed الافتراضية. يتيح لك هذا الرمز المختصر تعيين سمات مختلفة للتضمينات ، مثل تعيين أبعادها القصوى.
المعرض : أدخل معرض صور بسيطًا على موقعك. يمكنك استخدام السمات لتحديد الصور المستخدمة وتخصيص مظهر المعرض.
قائمة التشغيل : عرض مجموعة من ملفات الصوت أو الفيديو مع هذا الرمز القصير المرفق ذاتيًا. يمكنك إعطائها وضع “مظلم” رائع مع سمة النمط الخاصة به.
video : قم بتضمين ملف فيديو وتشغيله باستخدام مشغل فيديو بسيط. يدعم هذا الرمز القصير تضمين مقاطع الفيديو بالتنسيقات التالية: mp4 و webm و m4v و webm و ogv و wmv و flv.
لمزيد من التفاصيل حول كيفية استخدام الرموز القصيرة الافتراضية والسمات التي تدعمها ، يمكنك الرجوع إلى مستندات Codex المرتبطة.
يعد استخدام الرموز القصيرة في وورد بريس عملية مباشرة. لكن ذلك يعتمد على المكان الذي تريد إضافتها إلى موقعك. تأكد من قراءة وثائق الرمز القصير لفهم كيفية عمله. تعرف على السمات التي يدعمها ، حتى تتمكن من الحصول على ما تريده بالضبط.
أولاً ، انتقل إلى محرر الصفحة / المنشور حيث تريد إدخال الرمز القصير.
إذا كنت تستخدم محرر Gutenberg ، فيمكنك إضافة علامة الرمز القصير في كتلة الرموز القصيرة المستقلة . يمكننا العثور عليها في قسم الأدوات .
كيفية إضافة كتلة الكود القصير الجديد في Block Editor
إضافة كتلة رمز قصير في جوتنبرج
كيف تبدو كتلة الرمز المختصر المستقلة في Gutenberg
كتلة الرمز المختصر المخصصة لـ Gutenberg
هل ما زلت تستخدم المحرر الكلاسيكي (أو المكون الإضافي) ؟ يمكنك كتابة علامات الرمز القصير الخاص بك بالطريقة الكلاسيكية. قد تحتوي بعض الرموز القصيرة على زر في شاشة المحرر لإدراجها بسهولة.
مثال على رمز قصير في كتلة الرمز القصير
إضافة رمز قصير في المحرر الكلاسيكي
يمكن أيضًا إدراج الرموز القصيرة في أدوات الشريط الجانبي . لإضافتها ، انتقل إلى المظهر »الحاجيات وأضف عنصر واجهة مستخدم النص إلى القسم الذي تريد إضافة الاختصار إليه.
مثال على رمز قصير في عنصر واجهة نص الشريط الجانبي
أضف رمزًا قصيرًا في الشريط الجانبي الخاص بك باستخدام أداة النص
لصق الرمز القصير داخل نص القطعة و حفظ عليه. يمكنك زيارة الواجهة الأمامية لموقعك ورؤية إخراج الرمز المختصر في الشريط الجانبي.
إخراج الرمز المختصر للمعرض على الواجهة الأمامية
يمكن رؤية إخراج الرمز القصير (المعرض) في الشريط الجانبي
ملاحظة: لا تدعم إصدارات وورد بريس 4.8 والإصدارات الأقل الرموز القصيرة في أدوات الشريط الجانبي. اقرأ تحسينات الأداة في وورد بريس 4.9 لمزيد من المعلومات.
الرموز القصيرة في وورد بريس مخصصة بشكل عام للصفحات والمنشورات والأدوات. ولكن لديك طريقة سهلة لإدخال الرموز القصيرة في أي مكان في موقعك.
لنفترض أنك تريد إضافة زر الحث على اتخاذ إجراء في تذييلك ، أو في جميع منشوراتك قبل قسم التعليقات. و ظيفة رد do_shortcode () تأتي في متناول اليدين هنا.
تحتاج إلى إضافة الكود التالي إلى header.php أو footer.php أو أي من ملفات القالب الخاصة به:
<?php echo do_shortcode("[name_of_your_shortcode]"); ?>سيؤدي هذا إلى إخراج الرمز القصير في المكان الذي أدخلت فيه الرمز.
تحتاج إلى تضمين الأقواس المربعة بين علامات الاقتباس لتكرار الرمز القصير. فقط تضمين اسمه لن ينجح.
وبالمثل ، يمكنك استخدام وظيفة رد الاتصال do_shortcode () لتمكين الرموز القصيرة في أي مكان في وورد بريس ، كما هو الحال في قسم التعليقات.
و API وورد رمز قصير يعرف كيف يمكن أن تستخدم الأرقام الهاتفية لتخصيص وتوسيع وظائف موقعك. إنه يمكّن المطورين من إنشاء محتوى فريد (مثل النماذج ، الدوارات ، أشرطة التمرير ، إلخ) يمكن للمستخدمين إضافته في مواقعهم عن طريق لصق الرمز القصير ذي الصلة.
يمكنك إضافة أي ميزة تقريبًا يمكنك تخيلها إلى موقع الويب الخاص بك بمساعدة الرموز القصيرة.
تدعم واجهة برمجة التطبيقات (API) كلاً من الأكواد المختصرة للإغلاق الذاتي والإحاطة. إنه يتعامل مع جميع عمليات التحليل الصعبة ويتضمن وظائف مساعدة لتعيين السمات الافتراضية وجلبها.
بفضل واجهة برمجة التطبيقات ، يمكنك الغوص مباشرة في تطوير الرموز القصيرة وتخصيصها ، بدلاً من إضاعة الوقت الثمين في تحديد التعبيرات العادية لكل رمز قصير تقوم بإنشائه.
في كل مرة تفتح فيها صفحة أو منشورًا في وورد بريس ، فإنها تبحث عن الرموز القصيرة المسجلة أثناء معالجة محتوى الموقع.
إذا تم العثور على رمز قصير مسجل ، تتولى Shortcode API وتعيد إخراج الرمز (الرموز) القصيرة. تحل سلسلة الإخراج التي تم إرجاعها محل علامة الرمز القصير في الموقع الذي تمت إضافته إليه.
تقوم بتسجيل رمز قصير في وورد بريس باستخدام الوظيفة add_shortcode () . إليك كيف يتم ذلك:
add_shortcode( 'shortcode_name', 'shortcode_handler_function' );shortcode_name: العلامة التي سيبحث عنها وورد بريس أثناء تحليل محتوى المنشور. توصي Shortcode API باستخدام الأحرف الصغيرة والأرقام والشرطات السفلية فقط لتحديد قيمتها (تجنب الشرطات).
shortcode_handler_function: وظيفة رد الاتصال التي سيتم تنفيذها بعد أن يؤكد وورد بريس وجود رمز قصير مسجل.
يتم تعريف وظيفة معالج الرمز القصير على النحو التالي:
function shortcode_handler_function( $atts, $content, $tag ){ }atts $: مصفوفة ترابطية من السمات (أي مصفوفة من أزواج المفتاح والقيمة). إذا لم تحدد أي سمات ، فسيتم تحويلها افتراضيًا إلى سلسلة فارغة.
المحتوى $: المحتوى المرفق ، إذا كنت تقوم بتعريف رمز قصير مرفق. تقع على عاتق وظيفة المعالج مسؤولية ضمان إرجاع قيمة المحتوى $ إلى المخرجات.
$ tag: قيمة علامة الرمز المختصر (الاسم المختصر في المثال أعلاه). إذا كان هناك رمزان قصيران أو أكثر يشتركان في نفس وظيفة رد الاتصال (وهي صالحة) ، فستساعدك قيمة $ tag في تحديد الرمز القصير الذي أدى إلى تشغيل وظيفة المعالج.
تحلل API علامة الرمز القصير والسمات والمحتوى المرفق (إن وجد) متجاوزًا القيم إلى وظيفة المعالج ، والتي تعالجها وتعيد سلسلة الإخراج.
تحل سلسلة الإخراج هذه محل ماكرو الرمز القصير على الواجهة الأمامية لموقعك. ما تراه في النهاية في المتصفح هو هذا الناتج.
يمكنك إضافة نصوصك البرمجية القصيرة المخصصة إلى ملف function.php الخاص بالقالب أو تضمينها في ملحق.
إذا كنت تضيفه إلى ملف سمة ، فيمكنك تشغيل وظيفة add_shortcode () كما هي.
ولكن إذا كنت تضيفه إلى مكون إضافي ، فإنني أوصيك بتهيئته فقط بعد تحميل وورد بريس بالكامل. يمكنك التأكد من ذلك عن طريق التفاف وظيفة add_shortcode () داخل وظيفة أخرى. وهذا ما يسمى بوظيفة الغلاف:
function shortcodes_init(){
add_shortcode( 'shortcode_name', 'shortcode_handler_function' );
}
add_action('init', 'shortcodes_init');و ADD_ACTION () وظيفة السنانير و shortcodes_init وظيفة إلى النار إلا بعد ورد ديه تحميل النهائي (انها تسمى “الحرف الأول” هوك ).
الآن بعد أن غطينا الأساسيات ، حان الوقت لإنشاء رمز قصير مخصص.
تريد أن تعرف كيف زدنا من حركة المرور لدينا أكثر من 1000 ٪؟
انضم إلى أكثر من 20000 آخرين ممن يتلقون رسائلنا الإخبارية الأسبوعية مع نصائح من الداخل حول وورد بريس!
إشترك الآن
لاتباع الخطوات الواردة أدناه ، تحتاج إلى الإلمام بالعمل مع كود PHP وتحرير ملفات سمة وورد بريس الخاصة بك . بحلول الوقت الذي تنتهي فيه من البرنامج التعليمي ، سيكون لديك أول رمز قصير مخصص في وورد بريس جاهز لإطلاقه!
سنبدأ بأبسط رمز قصير ممكن ، ثم ننتقل إلى رموز أكثر تعقيدًا. استمتع بالمعالم القصيرة الخاصة بك في طريقك إلى إتقان الرموز القصيرة!
لنقم بإنشاء رمز قصير يسمى [current_year] يخرج العام الحالي على موقع الويب الخاص بك.
هذا الرمز المختصر مفيد إذا كنت تضيف محتوى إلى موقع الويب الخاص بك يحتاج إلى تحديث كل عام. على سبيل المثال ، إضافة إشعار حقوق النشر إلى تذييل موقعك.
سأستخدم مكوّنًا إضافيًا مجردة لإضافة وظائف الرمز القصير الخاص بي. يمكنك إضافته إلى موضوع الخاص بك functions.php الملف والحصول على نفس النتائج، ولكن أنا لا أوصي به. لا بأس للاختبار والتعلم رغم ذلك!
معلومات
خذ نسخة احتياطية قبل إجراء أي تغييرات على موقعك. توفر Kinsta نسخًا احتياطية تلقائية لجميع عملائها .
لنبدأ بإنشاء مكون إضافي. أنشئ مجلدًا جديدًا في الدليل / wp-content / plugins / .
صورة توضح مكان وضع ملف البرنامج المساعد في هيكل دليل وورد بريس
لاحظ موقع دليل البرنامج المساعد
أقوم بتسمية البرنامج المساعد الخاص بي “salcodes” ولكن يمكنك تسميته بأي شيء تريده.
في دليل البرنامج المساعد salcodes ، أنشئ ملف PHP بالاسم نفسه ( salcodes.php ). بمجرد الانتهاء ، أضف الرأس التالي إلى ملف المكون الإضافي الخاص بك:
<strong><?php</strong>
/*
Plugin Name: Salcodes
Version: 1.0
Description: Output the current year in your WordPress site.
Author: Salman Ravoof
Author URI: https://www.salmanravoof.com/
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Text Domain: salcodes
*/رأس البرنامج المساعد البسيط هذا جيد بما يكفي لأغراضنا. يمكنك معرفة المزيد حول متطلبات رأس المكون الإضافي في وورد بريس Codex. احفظ هذا الملف ، ثم انتقل إلى لوحة معلومات وورد بريس الخاصة بك لتنشيط المكون الإضافي.
الآن ، دعنا نسجل الرمز القصير ووظيفة المعالج. للقيام بذلك ، أضف الكود التالي إلى ملف البرنامج المساعد الخاص بك:
/**
/**
* [current_year] returns the Current Year as a 4-digit string.
* @return string Current Year
*/
add_shortcode( 'current_year', 'salcodes_year' );
function salcodes_init(){
function salcodes_year() {
return getdate()['year'];
}
}
add_action('init', 'salcodes_init');
/** Always end your PHP files with this closing tag */
<strong>?></strong>تحدد علامة return في تعليق PHP نوع المخرجات التي تم إرجاعها. يتبعه وصف قصير لنفسه.
Current_year هي علامة أو اسم الرمز القصير. يحدد هذا علامة الإغلاق الذاتي التي تحتاج إلى إضافتها في المحتوى الخاص بك ، والتي ستكون في هذه الحالة [current_year].
salcodes_year هو اسم وظيفة معالج الرمز القصير الذي سيعيد سلسلة الإخراج. سنقوم بتعريف وظيفة رد الاتصال هذه في الأسطر التالية. نظرًا لأننا ننشئ رمزًا قصيرًا بسيطًا للإغلاق الذاتي ، فلا يتعين عليك تمرير أي قيم متغيرة مثل سمات $ أو $ content أو $ tag.
salcodes_init هي وظيفة الغلاف التي يتم ربطها بـ “init” للتأكد من تسجيل الرمز القصير وتشغيله فقط بعد انتهاء تحميل وورد بريس. وظيفة add_action () المضمنة في وورد بريس تجعل هذا ممكنًا.
getdate () هي دالة PHP تُرجع مصفوفة من معلومات التاريخ للطابع الزمني الحالي. يحتفظ مفتاح السنة بقيمة السنة الحالية (كسلسلة مكونة من 4 أرقام). لذا ، فإن getdate () [‘year’] تُرجع السنة الحالية. هذا الناتج هو بالضبط ما نريده.
احفظ ملف البرنامج المساعد الخاص بك. حان الوقت الآن لاختبار ما إذا كان الرمز القصير يعمل على النحو المنشود.
أضف الرمز المختصر في أي مكان في موقعك (الصفحة ، المنشور ، أداة الشريط الجانبي ، إلخ). أقوم بإضافته إلى عنصر واجهة نص الشريط الجانبي لموقعي .
اختبار الرمز القصير للعام الحالي عن طريق وضعه في عنصر واجهة نص الشريط الجانبي
اختبار الكود المختصر المخصص بإضافته إلى الموقع.
وكما هو متوقع ، فهو يعمل بشكل مثالي.
إخراج العام بالرمز المختصر
إخراج العام بالرمز المختصر
تهانينا على بلوغك المرحلة الأولى!
لا يحتوي الرمز المختصر الذي أنشأته للتو على أي سمات $ أو متغيرات محتوى $ مرتبطة به. ستتعلم كيفية استخدامها في الأمثلة التالية.
لنقم بإنشاء رمز قصير لزر CTA قابل للتخصيص . سيكون هذا إغلاقًا ذاتيًا أيضًا (آسف محتوى $ ، تحتاج إلى التمسك بالمحتوى التالي).
أريد أن يتمكن المستخدمون من تخصيص حجم ولون زر CTA باستخدام سمات الرمز القصير.
هل سئمت من مضيف بطيء لموقع وورد بريس الخاص بك؟ نحن نقدم خوادم فائقة السرعة ودعمًا عالميًا على مدار الساعة طوال أيام الأسبوع من خبراء وورد بريس. تحقق من خططنا
نظرًا لأن الإخراج النهائي هو عنصر زر ، يمكن استخدام سمات HTML الخاصة به مثل href و id و class و target & label لتخصيصه بسهولة.
يمكنك استخدام معرف و الطبقة سمات أسلوب زر منذ انهم على حد سواء محددات CSS المشتركة.
أنا لا أقوم بتغليف وظيفة المعالج هنا لإبقاء الأمور بسيطة في الشرح.
/**
* [cta_button] returns the HTML code for a CTA Button.
* @return string Button HTML Code
*/
add_shortcode( 'cta_button', 'salcodes_cta' );
function salcodes_cta( $atts ) {
$a = shortcode_atts( array(
'link' => '#',
'id' => 'salcodes',
'color' => 'blue',
'size' => '',
'label' => 'Button',
'target' => '_self'
), $atts );
$output = '<p><a href="' . esc_url( $a['link'] ) . '" id="' . esc_attr( $a['id'] ) . '" class="button ' . esc_attr( $a['color'] ) . ' ' . esc_attr( $a['size'] ) . '" target="' . esc_attr($a['target']) . '">' . esc_attr( $a['label'] ) . '</a></p>';
return $output;
}واو ، هناك الكثير لتفريغه هنا. سأشرحها سطراً سطراً ، حتى تتمكن من فهم كيفية عملها.
لقد قمنا بتغطية وظيفة add_shortcode () وكيف تعمل في القسم السابق.
shortcode_atts () هي إحدى وظائف وورد بريس التي تجمع بين سمات الرمز القصير للمستخدم والسمات المعروفة. يملأ القيم الافتراضية عند الحاجة (والتي يمكنك تعيينها بنفسك أيضًا). ستكون النتيجة مصفوفة تحتوي على كل مفتاح من السمات المعروفة ، مدمج مع قيم من سمات الرمز القصير المحددة من قبل المستخدم.
داخل وظيفة معالج الرمز القصير ، نحدد متغيرًا ( $ a ) ونخصصه للمصفوفة التي يتم إرجاعها بواسطة shortcode_atts () . نقوم بتعيين السمات وقيمها الافتراضية بالصيغة: ‘attribute’ => ‘default-value’ . على سبيل المثال ، في الكود أعلاه ، نقوم بتعيين القيمة الافتراضية لتسمية السمة إلى Button باستخدام الصيغة ‘label’ => ‘Button’ .
يمكننا استخراج القيم لكل مفتاح سمة باستخدام صيغة PHP للمصفوفات: $ a [‘attribute’] .
و $ الناتج متغير يخزن كود HTML العنصر زر (علامة <a> لمع الطبقة ‘زر’). إنها السلسلة التي يتم إرجاعها أخيرًا بواسطة الوظيفة.
إذا كنت تريد تعيين الارتباط الافتراضي ليكون عنوان URL للصفحة الرئيسية للموقع ، فيمكنك الاستفادة من وظيفة home_url () وورد بريس.
دعنا نحاول استخدام الرمز القصير كما هو ، بدون تحديد سمات ، ونرى ما يتم إخراجه.
اختبار الكود المختصر لزر CTA عن طريق وضعه في عنصر واجهة نص الشريط الجانبي
أقوم بإضافة الرمز القصير إلى عنصر واجهة مستخدم نص الشريط الجانبي لاختباره.
إذا كنت تتساءل عن سبب استخدام الأقواس المربعة المزدوجة ( [[ cta_button ]] ) ، فيُطلق عليها رمز الهروب القصير . إنها تساعدك على إخراج أي رمز قصير مسجل في موقعك كنص عادي ، كما في الصورة أدناه.
يظهر إخراج الرمز المختصر لزر CTA أنه يعمل بشكل مثالي كما هو متوقع
يظهر إخراج الرمز المختصر لزر CTA أنه يعمل بشكل مثالي كما هو متوقع
إظهار إخراج HTML لزر الحث على الشراء باستخدام أدوات مطوري Chrome
ناتج HTML لزر CTA بدون سمات.
يمكن للمستخدمين تخصيص حجم الزر ولونه باستخدام الرمز القصير. لقد قمنا بالفعل بتعيين قيمهم الافتراضية في وظيفة المعالج ، لكننا نحتاج إلى التسجيل وإدراج ورقة الأنماط في قائمة الموارد المتاحة. يجب أن تحتوي ورقة الأنماط هذه على جميع الفئات المحددة في الرمز القصير.
يمكنك أيضًا تعيين هذه الفئات في ورقة الأنماط العامة لموضوعك ، ولكن يوصى بتحميلها بشكل منفصل. هذا يضمن أنه حتى إذا قمت بتغيير أو تحديث سمة وورد بريس الخاصة بك ، فسيستمر تحميل هذه الفئات مع الرمز القصير.
/** Enqueuing the Stylesheet for the CTA Button */
function salcodes_enqueue_scripts() {
global $post;
if( is_a( $post, 'WP_Post' ) && has_shortcode( $post->post_content, 'cta_button') ) {
wp_register_style( 'salcodes-stylesheet', plugin_dir_url( __FILE__ ) . 'css/style.css' );
wp_enqueue_style( 'salcodes-stylesheet' );
}
}
add_action( 'wp_enqueue_scripts', 'salcodes_enqueue_scripts');و salcodes_enqueue_scripts () تحدد وظيفة آخر $ متغير عمومي، ومن ثم تؤكد شرطين عن طريق:
is_a () : للتحقق مما إذا كان $ post هو مثيللكائن WP_Post . إنه يشير إلى جميع أنواع المنشورات في وورد بريس.
has_shortcode () : للتحقق مما إذا كان محتوى المنشور يحتوي على الرمز القصير [cta_button] .
إذا كان كلا الشرطين صحيحين ، تقوم الوظيفة بتسجيل ورقة أنماط style.css المضمنة في مجلد CSS وإدراجها في قائمة الانتظار . و plugin_dir_url ($ ملف) وظيفة يجعل من السهل الحصول على URL من الدليل المساعد ل.
لن أعرض لك كود CSS هنا ، لكن يمكنك العثور عليه في الكود المصدري المرتبط في نهاية هذا القسم.
أخيرًا ، دعنا نختبر الرمز القصير [cta_button] بإضافته إلى محتوى المنشور :
إضافة الرمز المختصر لزر CTA مع سمات إلى منشور
لاحظ الارتباط المخصص واللون والحجم وسمات التسمية.
توضح الصورة أدناه كيف يبدو زر الحث على الشراء على الواجهة الأمامية:
إخراج الرمز المختصر لزر CTA في المنشور. الحجم = السمة الكبيرة تعمل كما هو متوقع.
يحتوي زر الحث على الشراء الآن على عنوان URL ولون وحجم وتسمية جديدة.
الآن بعد أن تعلمت كيفية تحديد السمات المخصصة وتضمين الأنماط ، يمكنك إضافة وظائف أخرى متنوعة إلى الرمز المختصر لزر CTA الخاص بك. على سبيل المثال ، يمكنك منح المستخدمين خيار إضافة الرسوم المتحركة وتأثيرات التمرير وأنماط الأزرار المختلفة الأخرى.
في مثالنا الأخير ، دعنا نبني رمزًا قصيرًا مرفقًا يسمى [boxed] يخرج أي محتوى بين علاماته في مربع يحتوي على عناوين ملونة.
لنبدأ بتسجيل الرمز القصير وتحديد وظيفة المعالج الخاص به.
/**
* [boxed] returns the HTML code for a content box with colored titles.
* @return string HTML code for boxed content
*/
add_shortcode( 'boxed', 'salcodes_boxed' );
function salcodes_boxed( $atts, $content = null, $tag = '' ) {
$a = shortcode_atts( array(
'title' => 'Title',
'title_color' => 'white',
'color' => 'blue',
), $atts );
$output = '<div class="salcodes-boxed" style="border:2px solid ' . esc_attr( $a['color'] ) . ';">'.'<div class="salcodes-boxed-title" style="background-color:' . esc_attr( $a['color'] ) . ';"><h3 style="color:' . esc_attr( $a['title_color'] ) . ';">' . esc_attr( $a['title'] ) . '</h3></div>'.'<div class="salcodes-boxed-content"><p>' . esc_attr( $content ) . '</p></div>'.'</div>';
return $output;
}$ content = null : هذا يسجل الكود القصير كنوع مرفق. يمكنك استخدام متغير المحتوى $ داخل دالة المعالج لتغيير مخرجاتك كما يحلو لك.
$ tag = ” : هذا يعرّف متغير $ tag للرمز القصير . ليس من الضروري في هذا المثال ، ولكن من الجيد تضمينه.
في هذا المثال ، نقوم بتعديل المحتوى باستخدام أنماط CSS المضمنة .
يتم تسجيل الأنماط الخاصة بأي فئات مستخدمة داخل الرمز القصير ووضعها في قائمة الانتظار كما فعلنا في مثال الرمز القصير السابق.
لكن وجود رمزين قصيرين يستخدمان نفس ورقة الأنماط يعني أنه يتعين عليك تحميلها إذا تم استخدام أي منهما. لذلك ، دعنا نقوم بتحديث الدالة salcodes_enqueue_scripts () :
/** Enqueuing the Stylesheet for Salcodes */
function salcodes_enqueue_scripts() {
global $post;
$has_shortcode = has_shortcode( $post->post_content, 'cta_button' ) || has_shortcode( $post->post_content, 'boxed' );
if( is_a( $post, 'WP_Post' ) && $has_shortcode ) {
wp_register_style( 'salcodes-stylesheet', plugin_dir_url( __FILE__ ) . 'css/style.css' );
wp_enqueue_style( 'salcodes-stylesheet' );
}
}
add_action( 'wp_enqueue_scripts', 'salcodes_enqueue_scripts');has_shortcode $ : متغير يحدده المستخدم يتحقق من وجود أي من الرموز القصيرة في الصفحة / المنشور . ال || (عامل التشغيل OR) يجعل ذلك ممكنًا.
الآن ، دعنا نأخذ رمزنا القصير [ المعبأ ] في جولة.
إضافة الرمز القصير Boxed إلى منشور مع سمات color و title_color و title.
أضف الكود المختصر المعبأ جنبًا إلى جنب مع العنوان ولون العنوان وسمات اللون.
توضح لقطة الشاشة أدناه الإخراج الذي نحصل عليه.
إخراج الكود القصير Boxed مع السمات المضافة ، مما يدل على أنه يعمل بشكل مثالي على النحو المنشود
صندوق جميل ليس من الصعب الحصول عليه بعد كل شيء!
الآن بعد أن تعلمت كيفية إنشاء الرموز القصيرة الخاصة بك ، يمكنك التفكير خارج [الصندوق] ومنحها دورك الخاص. لا تنسى مشاركة إبداعاتك معنا!
إذا كنت ترغب في ذلك ، يمكنك تنزيل الكود المصدري لبرنامج Shortcode Plugin من هنا .
تعمل الرموز القصيرة على تبسيط إضافة الميزات المعقدة في مواقع وورد بريس. يمكنك إضافة أي شيء تقريبًا عن طريق كتابة سطر واحد من التعليمات البرمجية.
تعمل الرموز القصيرة على أتمتة سير عمل التطوير. إنها تلغي الحاجة إلى كتابة نصوص معقدة في كل مرة تريد فيها إدراج ميزة معينة.
تعتبر الرموز القصيرة أكثر سهولة في الاستخدام من إضافة كود HTML أو نصوص PHP.
يمكن تجميع الرموز القصيرة داخل المكونات الإضافية. حتى إذا قمت بتحديث وورد بريس أو قمت بتغيير / تحديث المظهر الخاص بك ، فستظل الرموز القصيرة صالحة وستستمر في العمل كما فعلت من قبل.
تجميع الرموز القصيرة داخل المكونات الإضافية يجعلها سهلة الاستخدام عبر مواقع وورد بريس المتعددة. إذا كنت مطورًا يتعامل مع العديد من المواقع ، فإن وجود جميع الرموز القصيرة المخصصة الخاصة بك جاهزة للعمل هو المنقذ.
نظرًا لأن الرموز القصيرة تقبل أيضًا السمات ، يمكن للمستخدمين تعديل سلوك نفس الرمز القصير بمجرد تغيير خيارات السمات الخاصة به.
الرموز القصيرة ليست سهلة الاستخدام للمستخدم النهائي ، خاصةً إذا تم استخدام الكثير منها على الصفحة. في مثل هذه الحالات ، تكون أكثر ملاءمة للمطورين.
من الصعب معرفة ما يفعله الرمز القصير بمجرد النظر إليه. أطلق عليها فريق وورد بريس الأساسي اسم ” رموز تضمين اللحوم الغامضة ” لهذا السبب بالضبط.
ستتوقف الرموز القصيرة المرفقة مع السمات عن العمل إذا قمت بتغيير المظهر الخاص بك.
الأكواد القصيرة غامضة فيما يتعلق بصيغتها. على سبيل المثال ، يدعم بعضها الإغلاق الاختياري ، بحيث يمكنك استخدامها إما كإغلاق ذاتي أو مرفق أو حتى كلاهما إذا كانا متداخلين. يمكنك تخمين كيف يمكن أن تصبح مربكة للغاية بسرعة فائقة.
يمكن أن تعطل الرموز القصيرة HTML بسبب العلامات المتضاربة أو مشكلات التشغيل البيني. ليس من الجيد أبدًا رؤيتها على الواجهة الأمامية لأي موقع.
تضيف الرموز القصيرة عبئًا إضافيًا على الخادم الخاص بك. مع زيادة عدد الرموز القصيرة على صفحتك / منشوراتك ، يزداد هذا التحميل أيضًا. يمكن أن يؤدي وجود عدد كبير جدًا من الرموز القصيرة إلى موقع الويب الخاص بك في عملية الزحف (على سبيل المثال ، الإخراج بواسطة معظم منشئي الصفحات ).
أدى تقديم Gutenberg إلى تقليل الرغبة في استخدام الرموز القصيرة. يمكن للمستخدمين الآن إضافة كتل مباشرة من واجهة المحرر ، بدلاً من التعامل مع علامات الترميز القصيرة ، بغض النظر عن مدى بساطتها.
وإذا كنت ترغب في إضافة رموز قصيرة ، فإن Gutenberg يأتي مع كتلة مخصصة لإضافة رموز قصيرة. الكتل هي الرموز القصيرة الجديدة.
“إذا كان بإمكانك القيام بذلك باستخدام رمز قصير ، فيمكنك القيام بذلك ككتلة.” – جيمس هوف ، مهندس السعادة في شركة Automattic
وهذا يفسر سبب تحويل جميع الرموز القصيرة الشائعة إلى كتل . تحول العديد من مطوري وورد بريس نحو جعل منتجاتهم وخدماتهم تعمل حصريًا مع محرر الكتلة (Gutenberg).
لكن هذا لا يعني أنها نهاية العالم للرموز القصيرة. لقد وعد فريق وورد بريس الأساسي بالعديد من التحسينات على محرر الكتلة ، والتي يمكن أن تراها في Twenty Twenty ، ولكن حتى ذلك الحين ، الرموز القصيرة موجودة لتبقى!
هل تفعل المزيد مع القليل ، كما تقول؟ هذا ممكن مع رموز وورد بريس المختصرة! تعرف على ماهيتها وكيفية إنشاءها الخاصة بك باستخدام هذا الدليل المتعمق. الحياة أقصر من أن لا تستخدم الرموز القصيرة〚〛💪
انقر للتغريد
تعد إضافة وظائف معقدة في أي مكان إلى موقع وورد بريس الخاص بك أمرًا سهلاً باستخدام الرموز القصيرة. إنها تمنح المستخدمين علامات سهلة الكتابة يمكن استخدامها دون القلق بشأن العبث بالرموز المعقدة.
على الرغم من عدم وجود طرق مختصرة في الحياة ، فمن المؤكد أن هناك العديد من الرموز المختصرة لاستخدامها في وورد بريس. المفضلة هي Shortcodes Ultimate و Shortcodes من Angie Makes .
وإذا لم تتمكن من العثور على الشخص الذي تبحث عنه ، فيمكنك إنشاء واحد بنفسك.
يمكنك حتى أن تأخذ اختصارًا لإنشاء الرمز المختصر المخصص الخاص بك باستخدام البرنامج المساعد Shortcoder . يعتني بجميع الأساسيات بالنسبة لك. وتذكر: الحياة قصيرة ، استخدم الرموز القصيرة!
وفر الوقت والتكاليف وحقق أقصى قدر من أداء الموقع من خلال:
مساعدة فورية من خبراء استضافة وورد بريس ، 24/7.
تكامل Cloudflare Enterprise.
يصل الجمهور العالمي إلى 28 مركز بيانات حول العالم.
التحسين من خلال مراقبة أداء التطبيقات المضمنة لدينا.
كل ذلك وأكثر من ذلك بكثير ، في خطة واحدة بدون عقود طويلة الأجل ، وعمليات الترحيل المدعومة ، وضمان استرداد الأموال لمدة 30 يومًا. تحقق من خططنا أو تحدث إلى قسم المبيعات للعثور على الخطة المناسبة لك.
