الدليل الكامل لأكواد ووردبريس القصيرة

قبل محرر قوالب WordPress ، كانت الرموز القصيرة لـ WordPress واحدة من أفضل الأشياء التي يمكن الوصول إليها في محرر WordPress لتسهيل إضافة وظائف المكونات الإضافية والسمات إلى الصفحات والمنشورات والأقسام الأخرى في موقع WordPress على الويب.

مع الانتقال إلى محرر الكتلة ، ماذا يعني هذا بالنسبة لمعظم المكونات الإضافية ومواقع الويب القديمة التي لا تزال مليئة بالرموز القصيرة؟ هل ستظل الرموز المختصرة لـ WordPress تعمل؟ هل هناك طريقة للانتقال بسهولة من استخدام الرموز القصيرة لـ WordPress إلى قوالب WordPress؟

هيا نكتشف. في هذا الدليل ، سوف نستكشف رموز WordPress القصيرة في عصر محرر قوالب WordPress.

ما هي أكواد WordPress المختصرة؟

الرمز المختصر لـ WordPress عبارة عن جزء ديناميكي من التعليمات البرمجية قابل لإعادة الاستخدام وملفوف في [أقواس] . تسمح لك الرموز القصيرة بإدراج وظائف محددة بسهولة في WordPress نفسه أو من مكون إضافي أو سمة في أي منشور أو صفحة أو نوع منشور مخصص أو عنصر واجهة مستخدم. فكر في رموز WordPress المختصرة مثل "الاختصارات" أو مثل وحدات الماكرو على موقع الويب الخاص بك.

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

تنسيق الرمز القصير

عندما يتعلق الأمر بإدخال الرموز القصيرة ، يمكن "تمديد" تنسيق [الأقواس] الأساسي بعدة طرق ، مما يسمح لك بتخصيص أو إضافة معلومات إعدادات إضافية تسمى السمات . بالإضافة إلى ذلك ، يمكن أن تلتف الاختصارات بالنص (أو HTML) أو حتى تتداخل مع رمز قصير آخر.

على سبيل المثال ، يمكن أن يحتوي الرمز القصير على التنسيقات التالية:

[shortcode]

[shortcode]Some text[/shortcode]

[shortcode]<a href="http://mysite.com/">HTML content</a>[/shortcode]

[shortcode]Some text [another-shotcode] more text [/shortcode]

[shortcode icon="icon: star" background="#eeeeee" color="#F73F43" text_color="#F73F43" size="32" shape_size="16" radius="256" text_size="16" url="#" target="self" margin="0"] This is a custom icon [/shortcode]

سمات الرمز القصير

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

تقدم المكونات الإضافية والسمات أدلة ونماذج إضافية لمساعدة المستخدمين على استخدام مقتطفات الرمز المختصر الصحيحة لإضافة أو إزالة عناصر معينة في الإخراج.

فيما يلي بعض الأمثلة على الرموز القصيرة ذات السمات.

[[gallery id="123" size="medium"]]

[recent-posts posts="5"]

[recent-posts posts="5"]Posts Heading[/recent-posts]

رموز WordPress المختصرة المضمنة

يأتي WordPress مع العديد من الرموز القصيرة المضمنة لتقديم أنواع معينة من المحتوى.

[[audio]]

يسمح لك الرمز الصوتي القصير بتضمين ملفات الصوت وتشغيلها.

[[caption]]

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

[[gallery]]

يسمح لك الرمز المختصر للمعرض بإضافة معرض صور واحد أو أكثر إلى منشوراتك وصفحاتك.

[[embed]]

يسمح لك الرمز المختصر المضمن بلف العناصر المضمنة بحد أقصى (ولكن غير ثابت) للعرض والارتفاع.

[[playlist]]

يطبق الرمز المختصر لقائمة التشغيل وظيفة عرض مجموعة من ملفات الصوت أو الفيديو في WordPress في منشور.

[[video]]

يسمح لك رمز الفيديو القصير بتضمين ملفات الفيديو وتشغيلها.

البرنامج المساعد والرموز المختصرة للموضوع

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

على سبيل المثال ، غالبًا ما تُستخدم الرموز القصيرة في المكونات الإضافية الشائعة للتقويمات أو النماذج أو الجداول أو العضويات أو مؤقتات العد التنازلي أو اقتباسات السحب. توجد حتى ملحقات الرموز القصيرة التي تسمح لك بإنشاء رموز قصيرة لأي شيء.

يمكن أن تستخدم سمات WordPress أيضًا الرموز القصيرة لتقديم محتوى ديناميكي معين تم تصميمه مسبقًا أو توفيره من قبلهم.

الرموز القصيرة المخصصة

يختار معظم المطورين الخبراء إنشاء الرموز القصيرة الخاصة بهم ، مما يقلل بشكل أساسي من الوقت الذي يستغرقه ترميز شيء متكرر. كل ما يتطلبه الأمر هو ملف إضافي بسيط في دليل الملفات الخاص بك لإنشاء ملف custom-shortcodes.php . إذا كنت ترغب في معرفة خيوط الرموز القصيرة المخصصة ، فإليك دليلًا لإنشاء رموز قصيرة مخصصة.

واجهة برمجة تطبيقات WordPress Shortcode API

بالنسبة للمطورين الذين يقومون بإنشاء رموز مختصرة مخصصة خاصة بهم ، توفر واجهة برمجة تطبيقات WordPress Shortcode API مجموعة بسيطة من الوظائف لإنشاء رموز قصيرة لـ WordPress لاستخدامها في المنشورات والصفحات.

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

يمكن للمطورين الحصول على وثائق WordPress Shortcode API لمعرفة المزيد حول:

• سمات المناولة
• انتاج |
• الرموز المختصرة المرفقة مقابل الإغلاق الذاتي
• مرجع الوظيفة
• محددات
• النحو الرسمي

الرموز القصيرة في المحرر الكلاسيكي

في الماضي ، تم إدراج الرموز القصيرة في المحرر الكلاسيكي لأي منشور أو صفحة ، مثل هذا:

ما هي قوالب ووردبريس؟

كانت الرموز القصيرة أولاً ... ولكن بعد ذلك جاء التحرير القائم على الكتلة. مع تقديم WordPress 5.0 ، جاء تنفيذ محرر Gutenberg المخطط له منذ فترة طويلة أو محرر قوالب WordPress باعتباره محرر الصفحة الرئيسية والمنشورات لـ WordPress ، ليحل محل محرر WordPress الكلاسيكي المستند إلى النصوص والذي كان موجودًا منذ سنوات.

إليك نظرة على محرر المحتوى قبل الإصدار 5.5 من WordPress (آه ، كانت تلك الأيام!)

تم الإعلان عن محرر Gutenberg لأول مرة في الإصدارات السابقة من WordPress ولكنه ظل اختياريًا حتى WordPress 5.0 عندما أصبح المحرر الافتراضي.

لا يوجد شيء خطأ بطبيعته في المحرر المحظور الجديد. في الواقع ، يحب معظم المستخدمين المظهر المحسن والأنظف والأقل ترهيبًا للجزء الخلفي من WordPress.

ولكن مع محرر قوالب WordPress ، ظهرت كتل WordPress. لقد ولت خيارات التنسيق في الجزء العلوي التي تذكرنا بتطبيقات معالجة الكلمات مثل Microsoft Word. بدلاً من ذلك ، تم استبدال خيارات التنسيق بخيارات الشريط الجانبي الأيمن المبوب لكل كتلة.

كتل WordPress هي في الأساس حاويات محتوى. هناك العديد من الكتل المختلفة لأنواع المحتوى المختلفة - الصور ومقاطع الفيديو والنصوص والعناوين والمعارض - سمها ما شئت.

حتى أن هناك كتلة WordPress للتنسيق والفاصل والمقسّم ، ويتم ترتيبها بشكل عرضي في فئات ليسهل الوصول إليها.

جميع الخيارات وعناصر التحكم التي كانت في الجزء العلوي موجودة الآن في الجانب الأيمن من محرر الصفحة / المنشور ، مع وجود علامات تبويب في الأعلى تشير إلى ما إذا كنت تريد رؤية خيارات الكتلة الحالية وحدها أو المستند بأكمله.

محرر الكتلة أسهل وأسرع وأكثر سهولة في الاستخدام. بالإضافة إلى ذلك ، يقوم مطورو القوالب والمكونات الإضافية أيضًا بإنشاء كتل خاصة بهم تضيف المزيد من خيارات الحظر إلى كتل WordPress الافتراضية.

الكتل القابلة لإعادة الاستخدام مقابل الرموز القصيرة

الطريقة القديمة لحفظ مجموعة من المخرجات المحددة مسبقًا في محرر WordPress الكلاسيكي كانت من خلال إنشاء الرموز القصيرة الخاصة بك. الآن ، تم استبدال هذه الطريقة بكتل قابلة لإعادة الاستخدام .

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

على سبيل المثال ، إذا قمت بإضافة كتلة زر وقمت بتصميمها بلون معين ، وتأثيرات التمرير ، وما إلى ذلك ، فلن ترغب في الاستمرار في القيام بذلك في كل صفحة تضيف هذا الزر إليها. إذا قمت بتغييره إلى كتلة قابلة لإعادة الاستخدام ، فسيتم حفظ الزر على موقع WordPress الخاص بك ويصبح كتلة خاصة به يمكنك استخدامها في صفحات أو منشورات أخرى.

يمكنك أيضًا تحديث هذه الكتل عن طريق تحويلها إلى كتل عادية ، أو حفظها ككتلة جديدة (باسم جديد) ، أو تحديث التصميم الحالي للكتلة.

كتل المجموعة

في الإصدار 5.3 من WordPress ، تم أيضًا تقديم قوالب وقوالب المجموعة.

بشكل أساسي ، يتم منحك القدرة على تجميع كتل معينة معًا ونقلها أو تحديثها معًا. أدى هذا في النهاية إلى ظهور أنماط الحظر. جعلت أنماط الكتل تحرير المحتوى أسهل نظرًا لأن المستخدمين يفضلون كثيرًا اختيار نمط وتحديث المحتوى بدلاً من البدء من لوحة قماشية فارغة.

خيارات تصميم الكتلة

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

باستخدام محرر الكتلة ، لديك خيار تحديث نمط كل كتلة على حدة ، إما لتبرز أو لجعلها أكثر وضوحًا.

الكتل وتحرير الموقع الكامل

مع كل هذه التطورات والتغييرات في طريقة إنشاء الصفحات وإنشائها على WordPress تأتي الفكرة والانتقال النهائي إلى ما يسمى تحرير الموقع الكامل .

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

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

على سبيل المثال ، يتبع موضوع Twenty-Twenty WordPress الأحدث هذا النمط ، مما يمنح المبدعين ومالكي مواقع الويب تحكمًا أكبر في موقعهم على الويب وكيف يريدون أن يبدو عليه.

بالنظر إلى المستقبل ، سيحتاج مطورو المكونات الإضافية والقوالب إلى اعتماد نهج مختلف عند تطوير برامجهم للتكيف مع تجربة تحرير الموقع بالكامل الجديدة وبناء الصفحات لمحرر قوالب WordPress. في حين أن التطبيق الكامل لهذا لا يزال في الأفق ، إلا أنه تغيير إيجابي سنراه على الأرجح عاجلاً وليس آجلاً.

كتلة الرمز القصير الجديد

قبل محرر القوالب ، تم إدخال الرموز القصيرة مباشرة في محرر الصفحة أو الصفحة. الآن ، يتضمن محرر قوالب WordPress كتلة رمز قصير جديد.

تجعل كتلة الرمز القصير من السهل الاستمرار في استخدام الرموز القصيرة القديمة داخل منشور أو صفحة وتحافظ على تكامل إخراج الرمز القصير.

يمكن إضافة كتلة الرمز القصير إلى صفحة أو منشور بالنقر فوق الزر "إضافة كتلة". بدلاً من ذلك ، يمكنك كتابة / رمز قصير والضغط على إدخال.

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

ماذا يعني محرر الكتل لأكواد WordPress القصيرة؟

محرر قوالب WordPress له آثار كبيرة على الرموز القصيرة. دعنا نغطي بعضًا من أهم الأشياء التي يجب ملاحظتها حول الرموز القصيرة لـ WordPress في عصر محرر الكتلة.

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

نظرًا لأن محرر الكتلة هو أسلوب مختلف تمامًا لإنشاء منشور أو صفحة ، يمكن أن توجد الأجزاء الأكثر ديناميكية من الصفحة التي يتم إنشاؤها بواسطة الرموز القصيرة ككتل يمكن إضافتها بشكل فردي.

2. يمكن أن تحل الكتل الآن محل معظم الرموز القصيرة ، مما يلغي حاجة المستخدمين إلى تعلم كيفية استخدام الرموز القصيرة. قد يكون لمفهوم وتنسيق الرموز القصيرة منحنى تعليمي حاد لبعض المستخدمين ، لذلك قد يكون نهج الكتلة أسهل.

على سبيل المثال ، خذ المكوّن الإضافي Gravity Forms. قبل محرر الكتلة ، كانت عملية إدراج نموذج في منشور أو صفحة مختلفة. من المحرر الكلاسيكي ، كان عليك استخدام زر لإدراج نموذج في المحتوى الخاص بك.

بعد تحديد النموذج الخاص بك ، تمت إضافة الرمز المختصر للنموذج إلى المحتوى الخاص بك. بناءً على الخيارات التي حددتها ، احتوى الرمز القصير على سمات العنوان والوصف.

الآن ، يقدم المكون الإضافي Gravity Forms كتلة نماذج كتلة k. من محرر الكتلة ، حدد قالب النماذج.

بمجرد تحديد النموذج ، سترى بالفعل معاينة أفضل لكيفية ظهور النموذج على صفحتك. يمكن العثور على إعدادات النموذج في إعدادات الكتلة.

3. سيحتاج مطورو السمات والإضافات إلى اتخاذ قرار بشأن مستقبل تطبيقات الرموز القصيرة الخاصة بهم وتحويل أكوادهم القصيرة إلى مجموعات. كما هو مذكور أعلاه ، لا يزال المئات من السمات والمكونات الإضافية والمطورين يستخدمون الرموز القصيرة على مواقع الويب والتطبيقات الخاصة بهم. قد يكون اعتماد الحظر بطيئًا ، ولكن نظرًا لأن المستخدمين أصبحوا أكثر دراية بمحرر الكتلة الجديد ، فمن المرجح أن يطلب المستخدمون خيار الحظر.

بالنسبة للمطورين الذين لا يزالون على بعد أميال من تبني نظام تحرير قوالب WordPress ، يمكن لمفهوم تحرير الموقع الكامل أن يسير جنبًا إلى جنب مع الرموز القصيرة الخاصة بهم. لا تزال المكونات الإضافية مثل المكونات الإضافية للمراجعة والتقييم ، ومشغلات الصوت ، ومؤشرات التاريخ ، والمعارض ، ونماذج الاتصال ، وأي شيء آخر لا يزال يستخدم الرموز القصيرة "في اللعبة".

4. لن تختفي الرموز القصيرة في أي وقت قريبًا. ربما هذا هو السبب في أن محرر قوالب WordPress يقدم كتلة الرمز القصير للمساعدة في الحفاظ على استخدام الرمز القصير. نظرًا لأن الرموز القصيرة كان لها مثل هذا الاستخدام والتنفيذ الواسعين قبل WordPress 5.0 ومحرر الكتلة ، فمن المهم أن الإصدارات المستقبلية من WordPress لا تزال تدعم الرموز القصيرة.

5. يمكن تحويل الرموز القصيرة إلى كتلة . هل لديك سمة أو مكون إضافي مفضل يستخدم الرموز القصيرة؟ من المحتمل أن يتم تحويل هذه الرموز القصيرة إلى كتلة في مرحلة ما. إذا كنت مطورًا لمكوِّن إضافي أو سمة ، أو كنت تقوم ببناء مواقع WordPress الإلكترونية واستخدمت رموزًا قصيرة في قالب مخصص ، فمن الممكن إعادة التفكير في الرموز القصيرة ككتل.

في القسم التالي ، سنغطي بإيجاز كيفية تحويل رموز WordPress القصيرة إلى قوالب WordPress.

كيفية تحويل رموز WordPress القصيرة إلى قوالب WordPress

تمامًا كما يمكنك إضافة رموز قصيرة مخصصة وكتل قابلة لإعادة الاستخدام ، يمكنك أيضًا بسهولة تحويل الرموز القصيرة المخصصة لـ WordPress إلى كتل WordPress.

اتبع الخطوات الأولى من دليل الرمز المختصر المخصص هذا.

خذ هذا المثال الأساسي من نماذج Caldera:

 <?php /** * Handler for [cl_post_title] shortcode * * @param $atts * * @return string */ function caldera_learn_basic_blocks_post_title_shortcode_handler($atts) { $atts = shortcode_atts([ 'id' => 0, 'heading' => 'h3', ], $atts, 'cl_post_title'); return caldera_learn_basic_blocks_post_title($atts[ 'id' ], $atts[ 'heading' ]); } /** * Output the post title wrapped in a heading * * @param int $post_id The post ID * @param string $heading Allows : h2,h3,h4 only * * @return string */ function caldera_learn_basic_blocks_post_title($post_id, $heading) { if (!in_array($heading, ['h2', 'h3', 'h4'])) { $heading = 'h2'; } $title = get_the_title(absint($post_id)); return "<$heading>$title</$heading>"; } /** * Register Shortcode */ add_shortcode('cl_post_title', 'caldera_learn_basic_blocks_post_title_shortcode_handler');

يأخذ هذا الرمز معرف المنشور ومستوى العنوان (h2 ، h3 ، he) ويخرج عنوان المنشور ملفوفًا في HTML للعنوان.

بمجرد الانتهاء من ذلك واختبار عمل الكود ، يتعين عليك بعد ذلك تسجيل الرمز القصير ككتلة. إليك دليل خطوة بخطوة لتحويل رمز قصير في WordPress إلى كتلة Gutenberg كمثال.

المزيد من الموارد حول إنشاء قوالب WordPress

هناك العديد من المكونات الإضافية والموارد المتاحة عبر الإنترنت والتي من شأنها مساعدتك في الوصول إلى هذه الخطوة ، بما في ذلك الوثائق الرسمية من WordPress حول كتابة نوع الكتلة الأولى. يمكنك التحقق من منشور Igor Benic أيضًا حول كيفية إنشاء كتلة لعرض المنشورات.

بعد قراءة هذه الأدلة ، ستتمكن من معرفة كيفية إنشاء قوالب WordPress الخاصة بك باستخدام الرموز القصيرة المخصصة الخاصة بك.

الحكم على أكواد WordPress القصيرة

تعد الرموز القصيرة لـ WordPress وستظل واحدة من أهم أجزاء WordPress. ساعدت الرموز القصيرة العديد من مطوري المكونات الإضافية في جعل المكونات الإضافية أكثر سهولة في الاستخدام والعديد من مطوري السمات يوسعون وظائف السمات الخاصة بهم. قللت الرموز القصيرة أيضًا من عدد المشكلات التي يواجهها الكثير من منشئي المحتوى ومالكي مواقع الويب بعد إنشاء الرموز القصيرة المخصصة الخاصة بهم عندما يتعلق الأمر بإضافة وتحديث الأشياء التي يريدونها بشكل متكرر.

مع ذلك ، ليس هناك شك في أن محرر الكتلة هو مستقبل تجربة تحرير WordPress ، لذا توقع أن ترى المزيد من المطورين يساهمون في تحسينه وأكثر مليئًا بالميزات ، بما في ذلك أولئك الذين لا يزالون يستخدمون الرموز القصيرة. بالنظر إلى المستقبل ، نتوقع أن ينتقل المزيد من المطورين إلى استخدام وإضافة كتل WordPress بدلاً من الرموز القصيرة لـ WordPress.

نأمل أن تكون قد تعلمت الكثير عن أهمية الرموز القصيرة في WordPress ، وما الغرض منها ومتى تستخدمها. نأمل أن تبدأ في إنشاء الرموز القصيرة المخصصة الخاصة بك وفي النهاية الكتل الخاصة بك ، وكلاهما بالتأكيد لن يختفي في أي وقت قريبًا.

كريستين رايت

تكتب كريستين دروسًا تعليمية لمساعدة مستخدمي WordPress منذ 2011. يمكنك عادةً العثور عليها وهي تعمل على مقالات جديدة لمدونة iThemes أو تطور موارد لـ #WPprosper. خارج العمل ، تستمتع كريستين بكتابة اليوميات (كتبت كتابين!) ، والمشي لمسافات طويلة والتخييم ، والطهي ، والمغامرات اليومية مع عائلتها ، على أمل أن تعيش حياة أكثر حاضرًا.