Noțiuni de bază cu WordPress Shortcodes

În acest articol, vi se va oferi o explicație detaliată a API-ului WordPress Shortcode și veți învăța cum să creați un shortcode? calea cea buna. Veți fi apoi prezentate câteva exemple utile de coduri scurte mai avansate și cum să codificați propriile variații personalizate! Sunteți gata să vă adăugați o nouă abilitate la punga de trucuri? Să începem!

Ce sunt codurile scurte?

Codurile scurte au fost introduse în WordPress 2.5. Pentru a pune lucrurile pur și simplu, un shortcode este a scurtătură. Acestea sunt coduri WordPress specifice codului care vă permit să economisiți timp și să faceți lucruri care altfel ar necesita cunoștințe tehnice și, eventual, cantități mari de cod. Prin adăugarea de coduri scurte la temele sau pluginurile dvs., puteți face folosirea acestuia cu atât mai ușoară și mai intuitivă. Ați putea, de exemplu, să aveți un scurtcod [Most_popular_post] că atunci când a scris exact așa ar afișa cea mai populară postare pe site-ul dvs. WordPress. Dacă doriți să faceți acest lucru manual, va trebui să scrieți un cod HTML, precum și să îl schimbați manual ca și când popularitatea posturilor sa schimbat. Un cod scurt elimină nevoia pentru acest lucru și simplifică lucrurile pentru dvs..

Un cod scurt este un cod specific pentru WordPress care vă permite să faceți lucruri minunate cu foarte puține eforturi. Codurile scurte pot încorpora fișierele sau pot crea obiecte care ar necesita, în mod obișnuit, o mulțime de cod complicat, urât într-o singură linie.
Cod scurt = comenzi rapide.
-WordPress.com

Cum se creează codurile scurte?

Codurile scurte sunt create folosind API-ul WordPress shortcode. ele funcționează mult ca filtrele WordPress. Trebuie să definiți a manipulant care analizează codul scurt și returnează o anumită ieșire. Apoi, înregistrați codul scurt utilizând adauga scurtatura() funcţie. O funcție de comenzi rapide acceptă până la trei argumente, enumerate mai jos:

$ ATTS: O serie de atribute de cod scurt
conținut $: Orice conținut pe care scurtcodul îl poate închide
cod $: Numele de cod scurt (utilizat de obicei când același handler este utilizat pentru coduri scurte multiple

Îmi dau seama că acest lucru ți-ar părea puțin confuz, deci iată câteva exemple despre ce ar putea fi aceste argumente, folosind un cod scurt wptuts.

 [wptuts]

$ ATTS = array ()
conținut $ = nul

 [wptuts] Lorem ipsum dolor stai amet [/ wptuts]

$ ATTS = array ()
conținut $ = Lorem ipsum dolor stau amet

 [wptuts name = "un nume"]

$ ATTS = array ('id' => '555', 'name' => 'un nume')
conținut $ = nul

 [wptuts] Lorem ipsum dolor stai amet [/ wptuts]

$ ATTS = array ('id' => '555')
conținut $ = Lorem ipsum dolor stau amet

Aceasta ar trebui să vă dau o idee bună cu privire la modul în care sunt transmise argumentele pentru handlerul de coduri de scurtă durată.

Notă: Codurile scurte sunt autoportante. Prin urmare, [wptuts] este la fel ca [wptuts /]. Trebuie doar să utilizați etichete de deschidere și închidere a codurilor scurte atunci când este conținut între ele.

Creați primul cod scurt

Acum, că ați învățat elementele de bază ale API-ului de coduri scurte, puteți continua și creați primul cod scurt. Voi folosi tema TwentyEleven inclusă în WordPress și capturile de ecran vor reflecta acest lucru, dar puteți utiliza orice temă la alegere sau chiar să scrieți un plugin.

Pentru a începe, deschideți functions.php fișier al temei și adăugați această linie de cod în partea de sus:

 includeți 'shortcodes.php';

Ta functions.php ar trebui să arate astfel:

Apoi, creați fișierul pe care tocmai l-ați referit - shortcodes.php. Pentru a face lucrurile mai ușoare, toate codurile scurte vor fi în acest fișier. Pentru început, vom crea un shortcode foarte simplu, care generează un link către adresa URL a postării postării. Creați o funcție wptuts_first_shortcode () și completați-l cu acest cod:

funcția wptuts_first_shortcode ($ atts, $ content = null) $ post_url = get_permalink ($ post-> ID); $ post_title = get_the_title ($ post-> ID); $ tweet = 'Distribuiți pe Twitter'; returnați $ tweet;  add_shortcode ("twitter", "wptuts_first_shortcode");

Primul cod scurt este acum gata de plecare! Puteți să-l încercați tastând [stare de nervozitate] într-un post. Iată un exemplu de performanță:

Mai multe coduri scurte

Acum că ați creat un shortcode de bază, putem merge mai departe și putem crea mai multe coduri scurte care folosesc diferite argumente cum ar fi $ ATTS și conținut $.

Încorporați un videoclip YouTube

Un shortcode încorporat în YouTube servește un scop important, deoarece încorporarea unui videoclip necesită cunoștințe de codificare; cu un scurtcod, necesarul de efor este redus semnificativ. În plus, această tehnică poate fi aplicată pentru a face coduri scurte care pot încorpora alte videoclipuri sau chiar materiale media precum imagini sau fișiere audio. Inserați acest cod shortcodes.php:

 funcția wptuts_youtube ($ atts, $ content = null) extract (shortcode_atts (array ('id' = $)), $ return = $ content;

"$ return = = '„; returnați $ return;  add_shortcode ("youtube", "wptuts_youtube");

Observați ce facem aici. Codul scurt are un singur atribut: codul video (care poate fi preluat de la adresa URL a unui videoclip pe YouTube). Functia shortcode_atts () ( funcționează foarte mult wp_parse_args (). Acesta analizează atributele și utilizează matricea specificată ca una dintre valorile implicite. Valoarea returnată este o matrice cu toate cheile din prima matrice, înlocuită cu valorile corecte din $ ATTS array, dacă este prezent. Dacă conținutul dintre etichetele de coduri scurte nu este gol, îl afișăm, adăugăm câteva pauze de linii și încorporăm videoclipul. Incearca-l! Codul pe care l-am folosit a fost:

 [youtube] Verificați acest videoclip! [/ youtube]

Iată rezultatul:

Afișați cea mai recentă postare de pe blog

Un alt exemplu de cod scurt este cel care afișează cel mai recent post blog. Avantajul este că, de fiecare dată când apare un post nou, nu este necesară actualizarea manuală. Iată codul:

 funcția wptuts_recentpost ($ atts, $ content = null) $ getpost = get_posts (array ('număr' => 1)); $ getpost = $ getpost [0]; $ return = $ getpost-> post_title. "
"$ getpost-> post_excerpt."? "$ return. ="
ID). "">Citeste mai mult ?"return $ return; add_shortcode (" newestpost "," wptuts_recentpost ");

Ceea ce facem este să folosim get_posts () pentru a recupera postul cel mai recent și a afișa titlul, fragmentul și un link către postare. Codul scurt nu are atribute, dar puteți, ca exemplu, să adăugați atribute pentru a afișa postări dintr-o anumită categorie sau pentru a afișa un număr definit de utilizator pentru cele mai noi postări. Puteți încerca codul scurt cu acest cod:

Consultați ultima noastră postare: 
 [Newestpost]

Iată cum arată:

Înfășurați totul

Există câteva lucruri care pot veni la îndemână pe măsură ce vă dezvoltați în dezvoltarea avansată a codurilor scurte.

Scoaterea codurilor scurte: Codurile scurte pot fi eliminate utilizând remove_shortcode () funcţie. Utilizarea este remove_shortcode ($ shorcodename). De asemenea, puteți să eliminați toate coduri scurte utilizând funcția remove_all_shortcodes ()
Aplicarea filtrului de coduri scurte: În mod implicit, WordPress scanează conținutul mesajelor pentru codurile scurte și le aplică. Cu toate acestea, există două cazuri în care este posibil să doriți să le spuneți în mod explicit WordPress să analizeze codurile scurte într-un șir. Pentru aceasta, aveți nevoie de do_shortcode (conținut $) funcţie. Primul caz este pentru codurile scurte imbricate - folosiți-le do_shortcode pe conținut $ vi-a trecut, adică în loc de returnați conținut $;, utilizare returnați do_shortcode (conținut $). Acest lucru va asigura că sunt procesate codurile scurte imbricate.
Cel de-al doilea scenariu în care puteți dori acest lucru este atunci când doriți ca conținutul non-post să fie scanat pentru coduri scurte. De exemplu, dacă doriți să fie analizat conținutul widget-urilor, puteți adăuga acest filtru:
```
 add_filter ('widget_text', 'do_shortcode');
```
(sursa: Shortcodes In Widgets)

Hopefull ați învățat o sumă bună despre codurile scurte WordPress până acum. Acum veți putea crea o varietate de coduri scurte care simplifică și eficientizează WordPress, iar utilizatorii dvs., fie dumneavoastră, fie clienții dvs., vă mulțumesc pentru asta!

Vrei mai multe coduri scurte?

Check out cele mai recente "Roundup de resurse" pe cele mai bune și mai creative shortcodes acolo chiar acum!

Cod