WordPress a introdus API shortcode șase ani în urmă cu lansarea WordPress 2.5. Scurtăturile sunt acum utilizate de un număr mare de pluginuri WordPress pentru a permite utilizatorilor să adauge conținut la postările și paginile lor.
API cod scurt vă permite să creați propriile scurtăturile prin adăugarea de funcții la funcțiile tematice.șablon php (acesta este situat la www.yourwebsite.com/wp-content/themes/yourtheme/).
În plus față de crearea propriilor scurtăturile, WordPress include, de asemenea, cinci scurtăturile implicite cu nucleul WordPress:
- audio – vă permite să încorporați fișiere audio.
- legendă – vă permite să înfășurați subtitrări în jurul conținutului. Este frecvent utilizat cu imagini.
- embed-vă permite să încorporați o gamă largă de conținut, cum ar fi video, audio și tweets.
- galerie-vă permite să inserați galerii de imagini.
- video – vă permite să încorporați fișiere video.
deși implicit scurtăturile WordPress sunt utilizate în mod obișnuit, foarte puțini utilizatori WordPress să profite de API shortcode și design scurtăturile unice pentru site-ul lor. În acest tutorial, aș dori să vă arăt cât de drept înainte este de a îmbunătăți site-ul dvs. cu Scurtăturile personalizate.
înainte de a începe, asigurați-vă că faceți o copie de rezervă a funcțiilor.php și orice alte fișiere pe care le editați înainte de a face modificări cu site-ul dvs. live.
crearea unui cod scurt – un exemplu de bază
pentru a vă oferi o bună înțelegere a modului în care funcționează WordPress cod scurt API, să începem cu o funcție de cod scurt de bază.vă rugăm să rețineți că scurtăturile ar trebui să fie create pentru conținutul și funcționalitatea pe care le utilizați frecvent. Întregul punct de a folosi scurtăturile este de a economisi timp pe cineva. Dacă veți folosi ceva o singură dată, nu are prea mult rost să creați un cod scurt pentru acesta.
scriu în jur de o duzină de articole pe săptămână. Un lucru pe care îl fac frecvent este să-i încurajez pe cei care s-au bucurat de articolele mele să se aboneze la blogul meu (sau la blogul pentru care scriu). Am scrie în prezent acest lucru de fiecare dată, cu toate acestea am putut salva o mulțime de timp prin crearea unui cod scurt pentru text.
pentru a face acest lucru, aș putea adăuga o funcție ca aceasta la funcțiile temei mele.șablon php:
aceia dintre voi care nu au nici o experiență de codificare poate găsi codul de mai sus un pic descurajatoare, cu toate acestea, este ușor de înțeles odată ce ați rupe codul jos linie cu linie.
primul lucru pe care îl facem este să adăugăm un comentariu deasupra funcției noastre. Acest lucru ne va ajuta să vedem rapid pentru ce este funcția noastră atunci când vizualizăm codul la o dată ulterioară.
// Function to add subscribe text to posts and pages
ne definim apoi funcția. Îmi place să folosesc nume care sunt auto-explicative, așa că am numit funcția mea „subscribe_link_shortcode”.
function subscribe_link_shortcode() {
în continuare, definim mesajul nostru. Declarația de returnare va afișa mesajul nostru atunci când este apelat. De asemenea, stochează mesajele (spre deosebire de echo, care îl va imprima, dar nu îl va stoca).
funcția este apoi închisă.
}
definim apoi codul scurt în sine folosind funcția add_shortcode. Prima variabilă specificată definește codul scurt care va fi utilizat, iar a doua variabilă apelează funcția noastră (adică cea pe care am definit-o mai sus).
add_shortcode('subscribe', 'subscribe_link_shortcode');
după salvarea funcțiilor.șablon php, putem apela acum mesajul nostru ori de câte ori dorim folosind codul scurt Aboneaza-te.
utilizarea codului scurt de abonare într-o postare sau pagină va produce următorul mesaj:
Dacă v-a plăcut acest articol, vă încurajez să vă abonați la blogul Elegant Themes prin RSS.
am folosit un mesaj simplu în exemplul meu, totuși ați putea modifica acest lucru pentru a afișa multe alte lucruri. De exemplu, puteți crea un cod scurt pentru afișarea reclamelor adsense sau un formular de abonament pentru buletinul dvs. informativ; și apoi introduceți-le oriunde doriți în articolele dvs.
crearea unui cod scurt cu atribute
atributele pot extinde funcționalitatea scurtăturile, permițându-vă să treacă date prin scurtăturile tale.
în exemplul de mai jos, vă voi arăta cum pot fi utilizate atributele pentru a extinde funcția pe care am creat-o mai devreme. După cum puteți vedea, o mare parte din cod rămâne același.$atts este numele matricei noastre de atribute. Apoi folosim funcția de extragere pentru a importa variabile din matricea noastră (prin funcția Shortcode_atts WordPress).
două atribute sunt apoi definite: subtip și și subtypeurl. Acestea reprezintă tipul de abonament și adresa URL a abonamentului. Aceste atribute sunt apoi numite în mesajul nostru.
tipul nostru de abonament implicit este RSS, iar adresa URL implicită a abonamentului estehttp://feeds.feedburner.com/ElegantThemes. Aceste informații vor fi afișate atunci când nu sunt definite atribute.
prin urmare, atunci când adăugați următoarele la o postare:
vom obține următoarea ieșire:
asigurați-vă că vă abonați la viitoarele actualizări de teme elegante prin RSS.
dacă definim atribute, rezultatul este diferit. Următorul cod:
va ieși:
asigurați-vă că vă abonați la viitoarele actualizări de teme elegante prin RSS.
Asigurați-vă că pentru a vă abona la viitoarele actualizări teme elegante de Twitter.
Asigurați-vă că vă abonați la viitoarele actualizări de teme elegante de pe Facebook.
Asigurați-vă că vă abonați la viitoarele actualizări de teme elegante de către Google.
deși acesta a fost un exemplu de bază al modului în care funcționează atributele, este ușor de văzut cum dezvoltatorii de pluginuri pot utiliza API-ul cod scurt pentru a face funcțiile complicate mai ușor de utilizat pentru utilizatori.
Prezentare generală
dacă urmați pașii menționați în acest tutorial, ar trebui să aveți acum o înțelegere de bază a modului în care puteți crea propriile scurtăturile personalizate pentru site-ul dvs. Scurtăturile sunt o modalitate foarte bună de a face sarcini complicate mai simple, așa că am să vă încurajez să păstrați WordPress API cod scurt în minte în viitor.
nu fi îngrijorat dacă acest tutorial a fost un pic dificil pentru tine. Toate temele elegante modele vin ambalate cu Scurtăturile care fac publicarea de conținut frumos ușor. Scurtăturile pot fi folosite pentru a crea slideshow-uri, coloane și tabele. Vă permite chiar să vă protejați conținutul prin parolă.
sper că v-ați bucurat de acest tutorial despre crearea unui cod scurt unic pentru site-ul dvs. Dacă este așa, vă încurajez să vă abonați la teme elegante, deoarece avem un conținut excelent în conductă
de asemenea, încă o dată, vă reamintesc să faceți o copie de rezervă a oricăror fișiere înainte de a le edita.