Personalizzazione delle funzionalità di WordPress con functions.php

Quindi, eccoci all'ottava e ultima puntata della nostra ricerca per scoprire il sito Web di WordPress. Spero che ora ti senta molto più a tuo agio a giocare con i tuoi siti. Una delle grandi cose che ho trovato su WordPress è l'enorme quantità di cose che puoi fare con esso una volta che inizi a familiarizzare con il modo in cui le cose vanno bene insieme.

Nel tutorial di oggi affronteremo quell'ultimo misterioso file nel nostro tema che vedrai spesso menzionato intorno alle trappole; quello a cui potresti aver già incollato snippet di codice prima senza sapere veramente perché o perché. Oggi lavoreremo con il template delle funzioni (functions.php).

Per una discussione approfondita su questo misterioso documento non è possibile superare ciò che è discusso nel Codex, ma in breve, il file Funzioni è il mezzo con cui possiamo modificare la funzionalità predefinita di alcuni dei nostri siti. Usando questo file possiamo anche estendere ulteriormente la funzionalità del sito. È piuttosto potente e oggi esamineremo solo un paio dei modi in cui possiamo utilizzarlo per estendere il nostro sito web di test.


Prima di iniziare

Avrai bisogno:

  • Accesso FTP al tuo sito
  • Il tuo software di modifica del testo
  • Un'immagine favicon 32x32px salvata in formato .ico, denominata favicon.ico

Cosa faremo

  • Aggiunta nel codice di monitoraggio di Google Analytics (è possibile utilizzare un plug-in per fare ciò, ma lo stiamo usando come esempio)
  • Aggiunta di una favicon al tuo sito

Prima di procedere oltre, dovremmo limitarci a descrivere come si comporta il file delle funzioni nel contesto del tema figlio. È un po 'diverso dagli altri modelli con cui abbiamo lavorato.

In un tema figlio, piuttosto che sostituire la funzionalità del file corrispondente nel tema principale come abbiamo fatto nel nostro ultimo tutorial, il functions.php aggiunge o estende la funzionalità del genitore. Non lo sostituisce, il che, se lo ricorderai, è il modo in cui gli altri modelli si comportano in un tema figlio.

Quindi, quando viene chiamata la nostra pagina, e il server fa la sua magia tirando tutti i modelli insieme, cerca le funzioni nel tema figlio, le esegue, e poi guarda al genitore ed esegue anche quelle funzioni.

In secondo luogo, il file delle funzioni è anche un file PHP, e le funzioni che stiamo incollando / scrivendo includeranno il codice PHP e potenzialmente alcuni HTML. Quindi ci stanno aiutando a raggiungere il nostro credulone! (alto cinque in tutto!)

Entriamo in esso.


Aggiunta del codice di monitoraggio di Google Analytics

Dovrei dire all'inizio, non c'è niente di sbagliato nell'aggiungere il codice di analisi usando un plugin. In effetti, la maggior parte dei plugin che offrono questa funzionalità (in essenziale) non differiscono molto da questo processo, ma inseriscono semplicemente il codice in un file di plugin. Detto questo, è un'illustrazione utile e non troppo impegnativa ai fini di questo esercizio. Quindi, diamo un'occhiata.

1. Creazione del nostro file di funzioni

Passo 1. Apri il tuo client FTP e naviga verso il tuo tema del bambino elenco.

Passo 2. Nell'elenco dei file sul server remoto, fare clic con il tasto destro e selezionare Crea un nuovo file.


Passaggio 3. Inserisci il nome del tuo file di funzioni come functions.php e colpisci ok.


Passaggio 4. Apri il tuo nuovo functions.php file nel tuo editor di testo.

Passaggio 5. A questo punto dobbiamo impostare il file in modo che il nostro server lo riconosca come un file PHP. Quindi aggiungi un tag PHP di apertura, come questo , all'inizio del tuo file.


Passaggio 6. Ora siamo pronti per incollare del codice nel nostro functions.php.

Ecco il codice che incolleremo, e di seguito c'è una spiegazione di ciò che stiamo guardando:

  

Ok, rompiamolo.

// Inserimento del codice di Google Analytics nel piè di pagina

Sulla linea 1 abbiamo una frase che inizia con due // segni. Questo è un commento, che non fa nulla a livello di programmazione, ed è solo lì per le informazioni della persona che modifica il file. La formattazione con i segni di barra rappresenta un modo rapido per commentare a linea singola del codice PHP. Se stiamo commentando un intero blocco che attraversa più di una linea useremmo il solito / * commento qui * / segna anche noi usiamo in CSS. È buona norma aggiungere commenti come note ogni volta che si codifica, in modo da poter tenere il passo con ciò che si è e ciò che si è fatto.

add_action ('wp_footer', 'mytheme_add_googleanalytics');

Sulla linea 4 abbiamo un codice dall'aspetto leggermente complicato che inizia con add_action.

add_action è una funzione PHP che collega azioni con posizioni nel codice chiamate hooks. Possiamo trovare un sacco di frammenti di codice in tutto il web che sono effettivamente funzioni PHP per aggiungere o rimuovere funzionalità a diversi hook nel nostro codice. In questo caso lo stiamo usando aggiungere azione aggiungere il mytheme_add_google_analytics funzione al wp_footer gancio.

function mytheme_add_googleanalytics () 

La linea 5 in realtà definisce e apre il mytheme_add_google_analytics funzione:

e dalla riga 7, che segue, è la parte di sollevamento pesante che è in realtà dove forniremo la funzionalità. Al momento questo è solo un commento HTML (<-- comment here -->), lo ripareremo a breve.

Alla fine, sulla linea 9, chiudiamo la funzione con le parentesi graffe (notate come dovevamo riaffermare la etichetta. Questo perché il codice che stiamo incollando è in effetti HTML così e le due lingue funzionano in tandem piuttosto che in purea insieme. Quindi, abbiamo dovuto chiudere il tag PHP con il ?> dopo il parentesi sulla riga 5, quindi incollare il nostro codice (lo faremo nel passaggio successivo) e quindi riaprire il tag PHP sulla riga 8 prima di scrivere altre funzioni nel nostro file.

 

Passaggio 7. Ora è il momento di accedere al tuo account Google Analytics e prendere il tuo codice di incorporamento. Aspetterò qui mentre lo fai ...

...

Passaggio 8. Ora vai a capo e incolla quello alla riga 7 nella parte superiore del nostro commento HTML.


Passaggio 9. Ora salva il tuo file e caricalo sul tuo server.

Dovresti essere in grado di ispezionare il codice della tua pagina e vedere il codice seduto felicemente lì nella parte inferiore del codice sorgente:



Aggiungi un Favicon al tuo sito

Sai cos'è una favicon, giusto? Se hai bisogno di una testa di aggiornamento per il Codex per ulteriori informazioni. Ma in breve, è la piccola icona che spesso vedi visualizzare un logo o un'immagine personalizzata nelle schede del tuo browser o quando un link al tuo sito viene salvato come un segnalibro.

Passo 1. Crea il tuo favicon.ico nel tuo software di editing di immagini preferito.

Passo 2. Carica la tua favicon nella tua directory dei temi (il tuo tema figlio) tramite FTP.

Passaggio 3. Incolla il seguente codice nel tuo functions.php file:

// Aggiungi un Favicon al sito add_action ('wp_head', 'mytheme_add_favicon'); function mytheme_add_favicon () echo ''; 

Passaggio 4. Salva il file e caricalo sul tuo server.

Avendo descritto ciò che sta accadendo in una funzione di WordPress in precedenza, dovresti trovare abbastanza semplice capire cosa sta succedendo in questa prossima funzione. Per prima cosa, diamo un'occhiata al codice ...

Per iniziare, sulla linea 4 possiamo vedere che ne stiamo creando un altro add_action funzione. Il gancio su cui stiamo lavorando è il nostro codice wp_head (quindi, contrariamente al gancio precedente, stiamo aggiungendo questo all'intestazione del nostro sito, piuttosto che al piè di pagina) e il nome della nostra funzione è mytheme_add_favicon.

Una nota sulle funzioni di denominazione:

Potresti aver notato che in entrambi questi casi ho chiamato le funzioni iniziando con il nostro nome tema personalizzato mytheme_ e terminando con una descrizione di ciò che fa la nostra funzione, ad es. add_favicon. La ragione di questo è duplice:

  1. Rende facile vedere a colpo d'occhio che cosa si suppone stia facendo il nostro codice e ...
  2. Elimina il rischio di utilizzare nomi di funzioni che già esistono nel nostro tema principale, o in WordPress stesso, e quindi riduce il rischio che il nostro tema rompa le cose.

Ad ogni modo, assumendo che tu abbia un favicon.ico file nella tua directory dei temi, il codice sopra dovrebbe funzionare fuori dagli schemi, ma a titolo di spiegazione:

  1. Sulla linea 8 stiamo dicendo al nostro tema di inserire una stringa di HTML nel file capo del nostro sito Questo dice al browser dove trovare il favicon.ico.
  2. Il poco di PHP in quella stringa (get_stylesheet_directory_uri () inserisce il percorso del nostro file nella directory dei temi.

Supponendo che tutto il codice sia corretto e il file si trova nella directory dei temi, il browser, a sua volta, visualizzerà questa icona per il nostro sito nell'angolo delle nostre schede e in altri luoghi di solito viene visualizzata una favicon.


Potresti aver notato che in questo esempio non abbiamo dovuto chiudere e riaprire il PHP tag come abbiamo fatto nei passaggi 7 e 8 dell'esempio precedente. Questo perché in questo secondo esempio, il codice che abbiamo usato è PHP da un capo all'altro, e sebbene includa bit di HTML, non è HTML standalone perché c'è PHP che costruisce parte della stringa URL. Man mano che acquisisci familiarità con funzioni come questa e mentre impari a costruire le funzioni da solo, ti renderai più chiaro sulla differenza, ma questo pensiero serve solo a farti sapere che il codice è corretto, nel caso tu stessi cercando di aggiungere nel e / o ?> tag in questo esempio attorno alle parentesi graffe!


Conclusione

Una volta che inizi a capire il potere del functions.php file sarai inarrestabile, è il modo di fare ogni sorta di cose e di aggiungere alcune potenti e potenti funzionalità al tuo sito. Quindi la prossima volta che un tutorial che stai seguendo o uno snippet che hai trovato deve essere aggiunto al tuo functions.php file, ora dovresti essere in grado di aggiungere e prendere confidenzialmente il controllo di tutte le aree del tuo sito!

Ricorda! Prima di apportare nuove modifiche al file, per salvarne una copia sul desktop per sicurezza prima di caricare nuove modifiche. Ottenere il codice sbagliato in functions.php può causare problemi, quindi avere una versione funzionante salvata sul desktop significa che se le cose vanno male, puoi semplicemente caricare il tuo file di sicurezza e ricominciare.