Home → Știri → Folosind funcția get_template_part () în WordPress
Dacă dezvoltați teme pentru WordPress, probabil că ați întâlnit funcția get_template_part (). care facilitează împărțirea șabloanelor tematice în mai multe fișiere. În acest articol, vom examina caracteristicile și unele caracteristici ale acestei funcții.
Funcția get_template_part () a apărut pentru prima oară în WordPress versiunea 3.0. Acesta este conceput pentru a căuta și conecta diferite părți ale șablonului și este similar cu funcțiile interne ale PHP includ () sau requ (). dar cu unele diferențe:
- get_template_part () știe unde este localizat directorul cu temele
- Funcția nu va cauza erori sau avertismente PHP în cazul în care fișierul solicitat nu este găsit
- Funcția get_template_part () poate conecta un fișier alternativ dacă fișierul inițial solicitat nu a fost găsit
- Funcția funcționează excelent cu temele copilului în WordPress
Get_template_part ()
De cele mai multe ori, funcția get_template_part () este utilizată pentru implementarea oricărei părți a șablonului în tema WordPress (de unde vine numele), de exemplu meniul de navigare, un bloc cu intrări similare, paginare și așa mai departe.
Să ne uităm la câteva exemple simple:
Acest cod va căuta fișierul navigation.php în tema WordPress activă și îl va conecta. Spre deosebire include () sau necesită (). funcția get_template_part () nu va determina erori sau avertismente dacă un fișier cu acest nume nu este găsit.
Funcția are de asemenea un al doilea argument opțional:
Acest cod va executa și va conecta fișierul navigation-header.php în tema activă. Dacă fișierul cu astfel de nume nu există, atunci get_template_part () va încerca să conecteze fișierul navigation.php.
Subiectele copilului
În temele copilului, lucrul cu get_template_part () devine puțin mai complicat. De exemplu:
Dacă în momentul acestei funcții este activă o temă copil pe site, căutarea fișierului breadcrumbs.php va apărea mai întâi în subiectul copilului. Dacă în tema copil nu există nici un fișier cu un astfel de nume, funcția va încerca să conecteze fișierul breadcrumbs.php în tema părinte.
Cu un astfel de apel de la tema copilului, căutarea și conectarea fișierelor vor avea loc în următoarea ordine:
- breadcrumbs-header.php în tema copilului
- breadcrumbs-header.php în tema părinte
- breadcrumbs.php în tema copilului
- breadcrumbs.php în tema părinte
Deci, dacă dezvoltați o temă pentru WordPress, puteți permite utilizatorilor să schimbe sau să împiedice cu ușurință retragerea fâșiilor de pâine în anumite secțiuni ale subiectului. Pentru a face acest lucru, utilizatorii vor trebui doar să creeze un fișier cu un nume specific în subiectul copilului.
Formate de înregistrare
Începând cu tema standard Twenty Eleven, funcția get_template_part () este utilizată cu funcția get_post_format () atunci când se afișează conținutul înregistrărilor în șabloane. care returnează formatul înregistrării curente ca șir:
Această abordare vă permite să împărțiți ieșirile diferitelor formate de înregistrare în fișiere diferite, de exemplu, content-gallery.php pentru galerii, content-quote.php pentru citări, content-image.php pentru imagini etc. Dacă un fișier nu există, WordPress va căuta un fișier numit content.php.
Structura fișierelor din tema Twenty Twelve
Utilizatorii unui astfel de subiect pot schimba cu ușurință output-ul unuia sau altui format creând un fișier nou cu un anumit nume în tema WordPress copil.
Funcția locate_template ()
Funcția get_template_part (). ca multe alte funcții pentru lucrul cu fișierele șablon WordPress (inclusiv get_header (). get_sidebar () get_footer () și altele) utilizează funcția kernelului locate_template (). Această funcție vă permite să selectați și să încărcați primul fișier din matricea dată în tema WordPress copil sau mamă:
Acest cod va căuta fișiere în următoarea ordine:
- foo.php în tema copilului
- foo.php în tema părinte
- bar.php în tema copilului
- bar.php în tema părinte
- baz.php în tema copilului
- baz.php în tema părinte
Rețineți că spre deosebire de funcția get_template_part (). funcția locate_template () necesită numele complet al fișierelor din matrice, inclusiv extensia .php. Funcția locate_template () vă permite să implementați o ierarhie de șabloane în teme pentru WordPress.