Noțiuni introductive cu coduri scurte WordPress și fragmente de exemplu

Codurile scurte WordPress au fost introduse în 2.5 și vă ajută să creați coduri macro pe care să le utilizați în conținutul dvs. Dacă vă gândiți bine, aceasta este o modalitate excelentă de a crea ceva precum un spot publicitar dinamic sau un buton de îndemn în postările dvs.

Dacă folosim exemplul de îndemn, ați putea adăuga ceva de genul acesta la postarea de pe blog pentru a afișa butonul și apoi editați rezultatul în fișierul templates functions.php, la care vom ajunge într-un minut.

 [button]

Pentru a personaliza butonul, am putea adăuga pur și simplu ceva de genul:

 [button type="twitter"]

Sau, pentru a o face și mai bună, am putea folosi un shortcode care include:

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

Cu puțină imaginație, îți dai seama în curând de potențialul codurilor scurte și de ce se poate face cu ele. În acest articol, vă voi arăta cum să creați și să utilizați aceste trei tipuri diferite de coduri scurte, apoi vă voi prezenta câteva coduri scurte gata de utilizat pentru a le utiliza pe propriul site WordPress.

Crearea unui shortcode cu auto-închidere

Cel mai simplu shortcode este cel cu auto-închidere. Vom crea un link simplu către contul nostru de Twitter și apoi îl vom adăuga la o postare de blog.

Tot codul merge în functions.php , care se află în /wp-content/themes/your-theme/ . Dacă nu aveți unul, trebuie doar să îl creați și să introduceți codul în el.

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

Utilizare:

 [button]

Folosind pur și simplu funcția add_shortcode() , putem lega orice funcție PHP la codul nostru scurt. În acest exemplu simplu, tot ceea ce facem este să returnăm un link către contul nostru de Twitter, dar haideți să facem acest lucru un pas mai departe și să adăugăm câțiva parametri.

Crearea unui cod scurt cu auto-închidere cu parametri

Shortcode are suport pentru parametri, ceea ce ne permite să personalizăm rezultatul. În acest exemplu, avem două butoane diferite, așa că trebuie să definim ce buton vrem să arătăm.

 <?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'); ?>

Acum puteți alege ce buton să afișați definind type în codul scurt.

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

Asta e super. Dar dacă am vrea să schimbăm textul? Am putea continua să adăugăm tipuri de coduri scurte precum [button type="twitter-2"] și așa mai departe, dar asta nu este foarte dinamic, nu-i așa? Să vedem cum să facem asta în mod corect.

Crearea unui cod scurt de includere

Codul scurt de închidere vă permite să încorporați conținut în codul scurt, la fel ca BBCode dacă ați folosit vreodată asta.

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

Pentru a utiliza acest cod scurt, încorporați textul pe care doriți să îl utilizați astfel:

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

Pentru a face acest buton și mai bun, am putea adăuga parametri așa cum am făcut în exemplul anterior. Să adăugăm de data aceasta doi parametri, unul pentru numele de utilizator Twitter și unul pentru stilul butonului. Apoi putem avea diferite tipuri de butoane și alegem la ce cont de Twitter vrem să legăm butonul.

 <?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'); ?>

Utilizare:

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

Acum avem un buton personalizabil pe care îl putem conecta la orice cont Twitter. După cum sunt sigur că înțelegeți, puteți crea coduri scurte mult mai avansate decât acesta, dar acesta este un început bun.

Shortcodes în widget-uri și fișiere șablon

Acum, când ați văzut puterea codurilor scurte, probabil vă întrebați de ce nu le puteți utiliza în widget-urile și fișierele șablon. Ei bine, se dovedește că poți.

Pentru a activa shortcodes în widget-urile dvs., trebuie doar să introduceți următorul cod în functions.php:

 add_filter('widget_text', 'do_shortcode')

Și pentru a utiliza un shortcode în fișierele șablon, le puteți accesa folosind:

 do_shortcode("[button]");

Shortoduri gata de utilizare

Iată câteva shortcode-uri interesante pe care le puteți implementa imediat.

Cod în postări

Dacă conduceți un blog care se concentrează pe programare, probabil că doriți să afișați cod în postările dvs.

 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');

Utilizare:

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

Încorporați AdSense oriunde în postările dvs

Cu acest cod scurt, puteți adăuga un anunț Google oriunde în postările dvs. pur și simplu folosind [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');

Încorporați videoclipul YouTube

Acest shortcode vă va permite să încorporați videoclipuri YouTube în postările de pe blog.

 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");

Utilizare:

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

Cod scurt pentru donații Paypal

Acesta este un cod scurt care vă ajută să creați legături de donații către contul dvs. 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');

Utilizare:

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

Notă privată pentru autori

Acesta din urmă este inteligent. Cu acest shortcode, puteți crea note în postările dvs. pe care doar autorii le pot vedea.

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

Concluzie

După ce ați citit acest articol, sper că vă plac shortcode-urile WordPress la fel de mult ca mine și sper că veți începe să le implementați în propriul blog.