Share
API-ul WordPress Shortcode a fost introdus în WordPress în versiunea 2.5. De atunci, aceasta a devenit o metodă pe scară largă utilizată pentru a permite personalizarea rapidă a aspectului și introducerea anumitor fragmente de formatare. Dar codurile scurte pot fi la fel de utile atunci când creați teme WordPress - iată cum puteți să le utilizați pe deplin!
Codurile scurte au multe beneficii dacă sunt utilizate corect în fișiere tematice. Dacă sunteți familiarizați cu macro-uri preprocesor în C / C ++, atunci codurile scurte pot servi o funcție oarecum similară în WordPress. Scopul principal al utilizării unui scurtcod este înlocuirea substituentului cu propria piesă personalizată de cod HTML atunci când serverul trimite pagina către client. Pașii implicați în crearea și implementarea codurilor scurte sunt după cum urmează.
În acest sfat rapid, vom folosi codurile scurte pentru a afișa postările personalizate. Am dat o explicație detaliată despre cum să creez tipuri personalizate de posturi și să folosesc teme goale la Nettuts +, dar pentru acest exemplu, vom modifica tema implicită TwentyTen oferită de WordPress.
Funcția pe care o creați pentru codul dvs. scurt definește de fapt scopul codului scurt. O funcție de bază poate fi definită în modul următor (puteți adăuga tot codul din partea de jos a fișierului functions.php):
Accentsconagua
// Definirea funcției utilizate pentru afișarea mesajelor Custom Project. funcția project_shortcode ($ atts) // Extragerea argumentelor pentru codul scurt. extrageți (shortcode_atts (array ('limit' => '10', 'orderby' => 'data',), $ atts)); / * Aceasta este dacă vom scrie codul pentru preluarea datelor * și vom construi structura HTML care va fi returnată în variabila de ieșire $ * / $ output = 'Aceasta va conține ieșirea HTML finală pentru buclă de proiect personalizată.'; returnați outputul $; Doar asigurați-vă că nu lăsați niciun spațiu alb la sfârșitul fișierului functions.php, deoarece poate provoca o problemă. Acum, să adăugăm un cod pentru a prelua proiectul personalizat și pentru a construi structura HTML care va înlocui codul nostru scurt.
funcția project_shortcode ($ atts) extract (shortcode_atts (array ('limit' => '10', 'orderby' => 'data'), $ atts); // Crearea unei interogări personalizate pentru a prelua tipul de post personalizat al proiectului. $ loop = noul WP_Query (array ('post_type' => 'proiect', 'posts_per_page' => $ limit, 'orderby' => $ orderby)); // Intindeti prin posturi si construiti structura HTML. dacă ($ loop) în timp ce ($ loop-> have_posts ()) $ loop-> the_post (); $ output = ''.Get_the_title ().'
„; $ output = ''.Get_the_excerpt ().'„; else $ output = 'Ne pare rău, niciun proiect încă. Vino în curând. '; // Acum întoarcem codul HTML înapoi la locul de unde a fost apelat codul scurt. returnați outputul $; 'Ats' sunt atributele furnizate împreună cu codul scurt. Metoda de extragere a PHP este folosită pentru a diviza elementele matricei în variabile astfel încât acestea să poată fi utilizate direct în cadrul funcției.
În acest exemplu, folosim atributele transmise în funcție pentru a crea o interogare personalizată pentru a prelua datele personale postate "proiect". Apoi, ne întoarcem prin toate posturile de proiect returnate.
În cadrul buclă, preluăm și adăugăm datele la variabila de ieșire cu etichetele HTML corespunzătoare. Odată ce buclă este completă, variabila de ieșire conține codul HTML complet pentru lista noastră de proiecte. Acest cod HTML este returnat, iar codul scurt utilizat în temă este înlocuit de acesta atunci când pagina se încarcă.
Acum că am creat funcția, trebuie să o înregistrăm în baza de date împreună cu codul scurt care va fi folosit pentru aceasta. Putem face acest lucru cu
method_shortcode furnizat de WordPress.
add_shortcode ( 'proiecte', 'project_shortcode');
Primul argument în această metodă este numele codului scurt pe care îl vom folosi în temă, iar al doilea argument este numele funcției (pe care am definit-o mai sus) referitoare la acel shortcode. Acesta este modul în care WordPress va ști ce să facă atunci când codul scurt este analizat sau întâlnit.
WordPress oferă o metodă de parsare pe scurt, pe care foarte puțini dezvoltatori o consideră utilă. Metoda do_shortcode poate fi utilizată pentru a insera codurile scurte din fișierele tematice.
Sintaxa scurtcodei este similară cu cea pe care o introduceți în editorul backend. În acest caz, treceți atributele pentru limita numărului de postări care trebuie afișate și cum să le comandați. Pe măsură ce afișăm postări personalizate "de proiect", vom crea un nou șablon de pagină dedicat și vom folosi codul scurt în acesta. Creați un șablon numit "page-project.php" și utilizați următoarele:
Acum, pentru a vedea șablonul pe care tocmai l-ați creat, creați o pagină numită "Proiect". Evitați să creați și câteva posturi demo "Proiect"!
Voila! Codul scurt afișează mesajele personalizate cu succes.
După cum puteți vedea, metoda de mai sus de a crea un scurtcod pentru posturile personalizate și de a le utiliza în tema noastră ne ajută să păstrăm fișierele tematice gestionabile și curate. Acest lucru are, de asemenea, un avantaj suplimentar pe care oricine poate introduce buclele personalizate post de la editorul WordPress backend, de asemenea.
Exemplul de mai sus arată modul în care putem folosi codurile scurte în timpul dezvoltării temelor într-un mod eficient. Există multe modalități inovatoare și productive de a utiliza scurtele coduri în temele WordPress - nu ezitați să vă împărtășiți ideile în comentariile!
