الشروع في العمل مع رموز WordPress المختصرة ونماذج المقتطفات

نشرت: 2021-02-18

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

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

 [button]

لتخصيص الزر ، يمكننا ببساطة إضافة شيء مثل:

 [button type="twitter"]

أو لجعله أفضل ، يمكننا استخدام رمز قصير مرفق:

 [button type="twitter"]Follow me on Twitter![/button]

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

إنشاء رمز قصير يغلق ذاتيًا

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

يتم إدخال جميع الكود في functions.php ، الموجود في /wp-content/themes/your-theme/ . إذا لم يكن لديك واحد ، فقط قم بإنشائه ووضع الكود فيه.

 <?php function button_shortcode() { return '<a href="http://twitter.com/filipstefansson" class="twitter-button">Follow me on Twitter!</a>"'; } add_shortcode('button', 'button_shortcode'); ?>

استعمال:

 [button]

ببساطة باستخدام add_shortcode() ، يمكننا ربط أي دالة PHP برمزنا القصير. في هذا المثال البسيط ، كل ما نقوم به هو إعادة رابط إلى حساب Twitter الخاص بنا ، ولكن دعنا نأخذ هذه الخطوة إلى الأمام ونضيف بعض المعلمات.

إنشاء رمز قصير يغلق ذاتيًا مع المعلمات

يحتوي الرمز القصير على دعم للمعلمات ، مما يتيح لنا تخصيص الإخراج. في هذا المثال ، لدينا زرين مختلفين ، لذلك علينا تحديد الزر الذي نريد إظهاره.

 <?php function button_shortcode($type) { extract(shortcode_atts(array( 'type' => 'type' ), $type)); // check what type user entered switch ($type) { case 'twitter': return '<a href="http://twitter.com/filipstefansson" class="twitter-button">Follw me on Twitter!</a>'; break; case 'rss': return '<a href="http://example.com/rss" class="rss-button">Subscribe to the feed!</a>' break; } } add_shortcode('button', 'button_shortcode'); ?>

يمكنك الآن اختيار الزر الذي تريد عرضه من خلال تحديد type في الرمز القصير الخاص بك.

 [button type="twitter"] [button type="rss"]

هذا عظيم. لكن ماذا لو أردنا تغيير النص؟ يمكننا الاستمرار في إضافة أنواع الرموز القصيرة مثل [button type="twitter-2"] وما إلى ذلك ، ولكن هذا ليس ديناميكيًا للغاية ، أليس كذلك؟ دعونا نرى كيف نفعل ذلك بالطريقة الصحيحة.

إنشاء رمز قصير مرفق

يسمح لك الرمز المختصر المرفق بتضمين المحتوى في الرمز القصير الخاص بك ، تمامًا مثل BBCode إذا كنت قد استخدمت ذلك من قبل.

 <?php function button_shortcode( $attr, $content = null ) { return '<a href="http://twitter.com/filipstefansson" class="twitter-button">' . $content . '</a>'; } add_shortcode('button', 'button_shortcode'); ?>

لاستخدام هذا الرمز القصير ، يجب تضمين النص الذي تريد استخدامه على النحو التالي:

 [button]Follow me on Twitter![/button]

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

 <?php function button_shortcode( $atts, $content = null ) { extract( shortcode_atts( array( 'account' => 'account', 'style' => 'style' ), $atts ) ); return '<a href="http://twitter.com/' . esc_attr($account) . '" class="twitter-button ' . esc_attr($style) . '">' . $content . '</a>'; } add_shortcode('button', 'button_shortcode'); ?>

استعمال:

 [button account="filipstefansson" style="simple"]Follow me on Twitter![/button] // Result: &lt;a href="http://twitter.com/filipstefansson" class="twitter-button simple">Follow me on Twitter!&lt;/a>

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

الرموز القصيرة في عناصر واجهة المستخدم وملفات القوالب

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

لتنشيط الرموز القصيرة في عناصر واجهة المستخدم الخاصة بك ، فقط ضع الكود التالي في function.php:

 add_filter('widget_text', 'do_shortcode')

ولاستخدام رمز قصير في ملفات القالب ، يمكنك الوصول إليها باستخدام:

 do_shortcode("[button]");

الرموز القصيرة الجاهزة للاستخدام

إليك بعض الرموز القصيرة الرائعة التي يمكنك تنفيذها على الفور.

كود في المشاركات

إذا كنت تدير مدونة تركز على البرمجة ، فربما تريد عرض رمز في مشاركاتك.

 function code_shortcode( $attr, $content = null ) { $content = clean_pre($content); // Clean pre-tags return '<pre"><code>' . str_replace('<', '<', $content) . // Escape < chars '</code></pre>'; } add_shortcode('code', 'code_shortcode');

استعمال:

 [code]&lt;?php echo 'Hello World!'; ?>

تضمين Adsense في أي مكان في مشاركاتك

باستخدام هذا الرمز المختصر ، يمكنك إضافة إعلان Google في أي مكان في مشاركاتك ببساطة باستخدام [adsense] .

 function showads() { return '<script type="text/javascript"><!-- google_ad_client = "pub-3637220125174754"; google_ad_slot = "4668915978"; google_ad_width = 468; google_ad_height = 60; //--> </script> <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> </script> '; } add_shortcode('adsense', 'showads');

تضمين فيديو يوتيوب

سيتيح لك هذا الرمز القصير تضمين مقاطع فيديو YouTube في منشورات مدونتك.

 function youtube($atts) { extract(shortcode_atts(array( "value" => 'http://', "width" => '475', "height" => '350', "name"=> 'movie', "allowFullScreen" => 'true', "allowScriptAccess"=>'always', "controls"=> '1', ), $atts)); return '<object style="height: '.$height.'px; width: '.$width.'px"><param name="'.$name.'" value="'.$value.'"><param name="allowFullScreen" value="'.$allowFullScreen.'"><param name="allowScriptAccess" value="'.$allowScriptAccess.'"><embed src="'.$value.'" type="application/x-shockwave-flash" allowfullscreen="'.$allowFullScreen.'" allowScriptAccess="'.$allowScriptAccess.'" width="'.$width.'" height="'.$height.'"></object>'; } add_shortcode("youtube", "youtube");

استعمال:

 // Optional attributes: width, height, name, allowFullScreen, allowScriptAccess, controls [youtube value="http://www.youtube.com/watch?v=1aBSPn2P9bg"]

الرمز المختصر للتبرع من باي بال

يساعدك هذا الرمز المختصر على إنشاء روابط تبرعات لحساب Paypal الخاص بك.

 function donate_shortcode( $atts, $content = null) { global $post;extract(shortcode_atts(array( 'account' => 'your-paypal-email-address', 'for' => $post->post_title, 'onHover' => '', ), $atts)); if(empty($content)) { $content='Make A Donation'; } return '<a href="https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business='.$account.'&item_name=Donation for '.$for.'" title="'.$onHover.'">'.$content.'</a>'; } add_shortcode('donate', 'donate_shortcode');

استعمال:

 [donate] [donate]Donate Now[/donate] [donate account="[email protected]" onHover="Thanks" for="Title"] [donate account="[email protected]" onHover="Thanks" for="Title"]Donate Now[/donate]

ملاحظة خاصة للمؤلفين

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

 function sc_note( $atts, $content = null ) { if ( current_user_can( 'publish_posts' ) ) return '<div class="note">'.$content.'</div>'; return ''; } add_shortcode( 'note', 'sc_note' );

خاتمة

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