Personalizarea funcționalității WordPress Cu funcțiile.php

Deci, aici suntem în cea de-a opta și ultima tranșă a căutării noastre de a ajunge sub pielea unui site WordPress. Sper că până acum vă veți simți mult mai confortabil jucând în jurul propriilor site-uri. Unul dintre lucrurile minunate pe care le-am găsit despre WordPress este volumul foarte mare al lucrurilor pe care le puteți face odată ce începeți să vă familiarizați cu modul în care se potrivesc lucrurile.

În tutorialul de astăzi vom aborda acel ultim dosar misterios din tema pe care o veți vedea adesea în jurul capcanelor; cel la care ați putea să aveți deja fragmente lipite de cod, fără să știți de ce sau de ce. Astăzi vom discuta cu șablonul de funcții (functions.php).

Pentru o discuție aprofundată despre acest document misterios, nu puteți trece peste ceea ce este discutat pe Codex, dar pe scurt, fișierul Functions este mijlocul prin care putem modifica funcționalitatea implicită a unora dintre site-urile noastre. Folosind acest fișier putem extinde și funcționalitatea site-ului. Este destul de puternic, iar astăzi vom trece prin câteva dintre căile pe care le putem folosi pentru a extinde site-ul nostru de testare.


Înainte de a începe

O să ai nevoie:

  • Acces FTP la site-ul dvs.
  • Software-ul dvs. de editare text
  • O imagine favicon 32x32px salvată în format .ico, numită favicon.ico

Ce vom face

  • Adăugarea în codul de urmărire Google Analytics (puteți utiliza un plugin pentru a face acest lucru, dar îl folosim ca exemplu)
  • Adăugați un favicon la site-ul dvs.

Înainte de a continua mai departe, ar trebui să acoperiți puțin despre modul în care fișierul de funcții se comportă în contextul temei copilului tău. Este puțin diferit de celelalte șabloane cu care lucrăm.

Într-o temă de copil, mai degrabă decât să înlocuiască funcționalitatea fișierului corespunzător în tema părinte așa cum am făcut-o în ultimul nostru tutorial, functions.php adaugă sau extinde funcționalitatea părintelui. Nu o înlocuiește, ceea ce, dacă vă veți aminti, este modul în care celelalte șabloane se comportă într-o temă copilărească.

Atunci când pagina noastră este chemată și serverul face magia să tragă toate șabloanele împreună, ea caută funcțiile din tema copilului, le execută și apoi privește la părinte și execută și aceste funcții.

În al doilea rând, fișierul de funcții este, de asemenea, un fișier PHP, iar funcțiile pe care le lipim / scriem vor include cod PHP, precum și eventual unele HTML. Deci ei ne ajută să nu ne gândim la credința noastră! (cinci faze în total!)

Să intrăm în asta.


Adăugarea codului de urmărire Google Analytics

Ar trebui să spun de la început, nu este nimic în neregulă cu adăugarea în codul de analiză folosind un plugin. De fapt, cele mai multe pluginuri care oferă această funcționalitate (în esențiale) nu se deosebesc foarte mult de acest proces, ci doar blochează codul din cale într-un fișier de plugin. Acestea fiind spuse, este o ilustrare utilă și nu prea dificilă pentru scopurile acestui exercițiu. Deci, haideți să aruncăm o privire.

1. Crearea fișierelor noastre funcționale

Pasul 1. Deschideți clientul dvs. FTP și navigați la dvs. temă pentru copii director.

Pasul 2. În lista de fișiere de pe serverul dvs. de la distanță, faceți clic dreapta și selectați Creați un fișier nou.


Pasul 3. Introduceți numele fișierului de funcții ca functions.php și lovit O.K.


Pasul 4. Deschideți-vă noul functions.php fișier în Editorul de text.

Pasul 5. În acest moment trebuie să setăm fișierul astfel încât serverul să îl recunoască ca fișier PHP. Deci, adăugați într-o etichetă de deschidere PHP, ca aceasta , la începutul fișierului dvs..


Pasul 6. Acum suntem gata să inserăm un cod în nostru functions.php.

Iată codul pe care îl vom lipi și mai jos este o explicație a ceea ce ne uităm:

  

Ok, haideți să o despărțim.

// Introducerea codului Google Analytics în subsol

Pe linia 1 avem o propoziție începând cu două // mărci. Acesta este un comentariu, care nu face nimic programat, și este doar acolo pentru informarea persoanei care editează fișierul. Formatarea cu marcatori este o modalitate rapidă de a comenta a o singura linie de cod PHP. Dacă comentăm un bloc întreg care traversează mai mult de o linie, vom folosi cele obișnuite / * comentariu aici * / mărcile pe care le folosim și în CSS. Este o practică bună să adăugați comentarii ca note ori de câte ori codificați, astfel încât să puteți ține pasul cu locul în care vă aflați și ceea ce ați făcut.

add_action ('wp_footer', 'mytheme_add_googleanalytics');

Pe linia 4 avem un cod ușor de complicat, începând cu ADD_ACTION.

ADD_ACTION este o funcție PHP care conectează acțiunile cu locurile din cod numite cârlige. Putem găsi o mulțime de fragmente de cod în jurul web-ului, care sunt în mod eficient funcții PHP pentru a adăuga sau a elimina funcționalitatea diferitelor cârlige din codul nostru. În acest caz, folosim acest lucru adăugați o acțiune pentru a adăuga mytheme_add_google_analytics funcția la wp_footer cârlig.

funcția mytheme_add_googleanalytics () 

Linia 5 definește și deschide mytheme_add_google_analytics funcţie:

și de la linia 7, care urmează, este partea de ridicare greu, de fapt, unde vom oferi funcționalitatea. În acest moment, acesta este doar un comentariu HTML (<-- comment here -->), vom repara asta la scurt timp.

În cele din urmă, pe linia 9 închidem funcția cu parantezele curbate (observați cum a trebuit să repornim etichetă. Acest lucru se datorează faptului că codul pe care îl lipim este, de fapt, HTML, iar cele două limbi lucrează în tandem, nu în același timp, decât împreună. Deci, a trebuit să închidem eticheta PHP cu ?> după paranteze pe linia 5, apoi lipiți codul nostru (vom face acest lucru în pasul următor) și apoi re-deschideți eticheta PHP pe linia 8 înainte de a scrie orice alte funcții în fișierul nostru.

 

Pasul 7. Acum este momentul să vă conectați la contul dvs. Google Analytics și să vă luați codul de încorporare. O sa astept aici in timp ce tu faci asta ...

...

Pasul 8. Acum du-te capul și lipiți-l în linia 7 peste partea de sus a comentariului nostru HTML.


Pasul 9. Acum, salvați fișierul și încărcați-l pe serverul dvs..

Ar trebui să aveți posibilitatea să inspectați codul paginii dvs. și să vedeți codul așezat fericit acolo în partea de jos a codului dvs. sursă:



Adăugați un site Favicon la site-ul dvs.

Știi ce este un favicon, nu? Dacă aveți nevoie de un capitol de reîmprospătare la Codex pentru mai multe informații. Dar pe scurt, este pictograma mică pe care o vedeți adesea afișând un logo sau o imagine personalizată în filele browserului dvs. sau când un link către site-ul dvs. este salvat ca un marcaj.

Pasul 1. Creați-vă favicon.ico în software-ul dvs. preferat de editare a imaginilor.

Pasul 2. Încărcați faviconul în directorul tematic (subiectul copilului dvs.) prin FTP.

Pasul 3. Inserați următorul cod în functions.php fişier:

// Adăugați un Favicon site-ului add_action ('wp_head', 'mytheme_add_favicon'); funcția mytheme_add_favicon () echo '„; 

Pasul 4. Salvați fișierul și îl încărcați înapoi pe server.

După ce ați descris ce se întâmplă mai devreme într-o funcție WordPress, ar trebui să găsiți destul de ușor să înțelegeți ce se întâmplă în următoarea funcție. Mai întâi, să aruncăm o privire la cod ...

Pentru a începe, pe linia 4 putem vedea că creăm un altul ADD_ACTION funcţie. Cârligul la care ne punem codul este wp_head (deci, spre deosebire de cârligul precedent, adăugăm acest lucru în antetul site-ului nostru, mai degrabă decât subsolul) și numele funcției noastre este mytheme_add_favicon.

O notă privind funcțiile de denumire:

Este posibil să fi observat că în ambele cazuri am denumit funcțiile începând cu numele temei personalizate mytheme_ și terminând cu o descriere a ceea ce face funcția noastră de ex. add_favicon. Motivul din spatele acestei situații este dublu:

  1. Ea face ușor să vedeți dintr-o privire ceea ce este codul nostru este de a realiza, și ...
  2. Elimină riscul utilizării numelor de funcții care există deja în tema părinte sau în WordPress în sine, reducând astfel riscul ca tema noastră să rupă lucrurile.

Oricum, presupunând că aveți un a favicon.ico fișier în directorul temă, codul de mai sus ar trebui să funcționeze din cutie, dar prin explicație:

  1. Pe linia 8 îi spunem temei să insereze un șir de coduri HTML în cap de pe site-ul nostru. Acest lucru îi spune browserului unde să găsească favicon.ico.
  2. Micul fragment al PHP din acel șir (get_stylesheet_directory_uri () inserează calea către fișierul nostru din directorul tematic.

Presupunând că tot codul este corect și că fișierul este în directorul tematic, browserul va afișa, la rândul său, această pictogramă pentru site-ul nostru în colțul filelor și în alte astfel de locuri, un favicon este de obicei văzut.


S-ar putea să fi observat că în acest exemplu nu am fost nevoiți să închidem și să redeschidem PHP așa cum am făcut în etapele 7 și 8 ale exemplului anterior. Acest lucru se datorează faptului că, în acest al doilea exemplu, codul pe care l-am utilizat este PHP de la sfârșitul la sfârșit, iar în timp ce acesta include biți de cod HTML, acesta nu este un standalone HTML, deoarece există o parte a clădirii PHP a șirului de adrese URL. Pe măsură ce vă familiarizați cu astfel de funcții și pe măsură ce învățați să vă construiți funcții, veți obține o claritate în ceea ce privește diferența, însă acest gând doar vă informează că codul este corect, doar în cazul în care căutați să adăugați în și / sau ?> etichetele din acest exemplu în jurul parantezelor curbe!


Concluzie

Odată ce începeți să înțelegeți puterea functions.php fișierul va fi de neoprit, este mijlocul de a face tot felul de lucruri și de a adăuga unele funcționalități mari și puternice pe site-ul dvs. Deci, data viitoare când un tutorial pe care îl urmăriți sau un fragment pe care l-ați găsit trebuie să fie adăugat la dvs. functions.php fișier, acum ar trebui să puteți adăuga cu siguranță și să preluați controlul asupra tuturor domeniilor site-ului dvs.!

Tine minte! Înainte de a face noi modificări în fișierul dvs., pentru a salva o copie pe spațiul de lucru pentru păstrare înainte de a încărca noi modificări. Obținerea codului greșit în functions.php poate provoca probleme, având o versiune de lucru salvată pe desktop înseamnă că, dacă lucrurile nu merg bine, puteți să încărcați fișierul de siguranță și să îl porniți din nou.
Cod