WordPress How-To: Nozioni di base sullo sviluppo di plugin WP

Articolo scritto da:
  • Suggerimenti per il blog
  • Aggiornato: Aug 12, 2013

Lavoreremo su una serie di articoli incentrati su "come fare X con WordPress“. Questi articoli saranno un po 'lunghi e sono principalmente per esperti webmaster e sviluppatori; se sei nuovo su WordPress, controlla il mio Guida al tuo primo blog WordPress.

E ora, alcune introduzioni di base.

Espansione sulle funzionalità di WordPress sviluppando un nuovo plugin

Homepage di WordPress

WordPress è la piattaforma di gestione dei contenuti più popolare al mondo, con oltre 60 milioni di utenti del suo pacchetto di installazione PHP self-hosted e altri milioni utilizzando il suo servizio WordPress.com basato su Web e ospitato in remoto. Questa non è una coincidenza o un errore. WordPress è, molto semplicemente, l'applicazione di gestione dei contenuti più completa, accessibile (è gratuita!) E facilmente utilizzabile nel mondo. Tuttavia, anche questo titan di content management non è assolutamente perfetto, e molti utenti alla fine scoprono che il software manca di una o due funzioni essenziali di cui semplicemente non possono fare a meno.

entrare WordPress plugin.

Questi utenti insoddisfatti faranno poi una ricerca, una grande ricerca, nel tentativo di trovare il plugin giusto per portare a termine il lavoro. Alcune persone trovano quel plugin necessario, ma molti altri semplicemente non trovano quello che stanno cercando.

Alcuni utenti di WordPress potrebbero accontentarsi semplicemente di rinunciare alla lotta e rassegnarsi a una vita in cui manca una caratteristica essenziale dal loro sito web. Ma un gruppo considerevole di questi utenti non è semplicemente disposto a gettare la spugna, e perseguire il processo di progettazione del proprio plugin personalizzato per ottenere il lavoro fatto. Potrebbe sembrare complicato e intimidatorio, e alcune parti potrebbero esserlo. Certamente, solida conoscenza di PHP sarà richiesto per i plugin più avanzati che aggiungono funzionalità reali alla funzionalità di WordPress. Ma un plugin è una cosa relativamente facile da scrivere, specialmente per le funzioni di base che sono standard in tutto WordPress e che devono semplicemente essere "rielaborate" per fare meglio il lavoro e presentarlo in modo più gradevole.

Gli utenti che non si accontentano del secondo posto e pensano di creare il proprio plug-in, devono solo seguire i semplici passaggi seguenti per mettere la propria installazione di WordPress su un percorso verso una maggiore funzionalità e compatibilità con le loro grandi idee e grandi piani per il dominio di Internet .

Passo 1: crea un nuovo file nella directory dei plugin e dagli uno scopo

Plugin WP

Il primo passo per creare un plugin è semplicemente creare un nuovo file di plugin PHP all'interno della directory dei plugin di WordPress esistente.

Ormai, la maggior parte degli utenti dovrebbe sapere dove trovare quella directory poichè probabilmente hanno già caricato una manciata di plugin per migliorare le funzionalità delle loro installazioni WordPress. Tuttavia, per coloro che si stanno davvero avvicinando a questo processo come un novizio completo e totale, la directory contenente tutti i file in pug si trova nel seguente percorso per ogni versione e iterazione del software WordPress:

/ Public_html / wp-content / plugins /

Passa a quella directory e crea un nuovo file (vuoto, a questo punto) denominato "my-custom-plugin.php". Questo è il file che conterrà tutti i nostri lavori dall'inizio alla fine, e gli daremo un Ovviamente il nome non viene eliminato o attivato prematuramente durante il processo di sviluppo. Una volta che questo file è stato creato e caricato sul server, utilizzare un client FTP per modificare direttamente questo file (utilizzando un editor di testo incorporato) mentre è ancora ospitato sul server. Questo è il modo migliore per modificare i file remoti, poiché rende il salvataggio e il caricamento essenzialmente automatici e decisamente più semplice della gestione di più versioni dello stesso file memorizzate in posizioni diverse.

Il plug-in verrà ora denominato, descritto e assegnato un "carattere di sottofondo". Si tratta dello stesso tipo di informazioni posizionato nella parte superiore del foglio di stile "style.css" di un tema e gli sviluppatori di temi si sentiranno a casa riempendo fuori le informazioni qui sotto. Inserire queste informazioni nella parte superiore del file del plugin prima di qualsiasi altro codice. Anche il tag PHP di apertura non deve essere posizionato prima di queste righe commentate. Se queste righe vengono posizionate in modo errato o vengono completamente omesse, il plug-in stesso non verrà visualizzato all'interno di WordPress Dashboard. Ciò significa che non può essere attivato, utilizzato, testato o sottoposto a debug e che non va bene. Ecco cosa deve essere compilato prima di aprire il file e procedere alla definizione di una funzione:

/*
Nome plugin: un plugin personalizzato utilizzato per imparare i modi di WordPress
Plugin URI: http://www.your-website-here.com
Descrizione: Questo plugin viene utilizzato per dimostrare come codice PHP, variabili WordPress, XHTML, CSS e altre informazioni, viene inserito in un file PHP standard per aggiungere nuove funzionalità a un'installazione standard di WordPress.
Autore: il tuo nome qui
Versione: 1.0
URI autore: http://www.your-website-here.com
*/

Una volta che queste informazioni sono state completamente compilate, il plug-in verrà ora individuato da WordPress Dashboard e le sue informazioni verranno visualizzate correttamente insieme ad altri plug-in all'interno del pannello di amministrazione dell'attivazione / eliminazione dei plug-in. Al plugin è stato ora assegnato un nome file, un nome descrittivo e uno scopo. Tutto ciò che manca a questo punto sono alcune funzioni. Ecco dove arriva il secondo passo.

Plugin WP

Passo 2: definizione di una funzione plugin (o funzioni) da utilizzare su un sito Web WordPress

Questa dimostrazione del plugin presupporrà che lo sviluppatore abbia creato a campo personalizzato. Questo campo verrà utilizzato per determinare se i collegamenti dei social media siano inclusi o meno con il post in modo che gli utenti possano condividere il post con i loro amici e familiari iscritti ai loro aggiornamenti di social network su siti come Twitter, Facebook, LinkedIn e MySpace . Un campo personalizzato è stato creato, in questo caso, denominato "social_links".

Usando il codice PHP nel plugin, determineremo se il campo di social networking contiene o meno dati al suo interno. Se lo fa, verrà visualizzata una "barra" di link per la condivisione dei social media. Se non contiene dati al suo interno, questi collegamenti verranno omessi. Questo è un ottimo modo per disabilitare la condivisione di post sul tuo sito web che semplicemente non sono pensati per la visualizzazione da parte del pubblico più ampio, e farlo in un plug-in è un ottimo modo per garantire che questa funzionalità si applichi a tutti i temi, piuttosto che semplicemente in modello di inserimento di un tema.

Questo processo si ottiene aggiungendo un'azione al codice WordPress. Questo viene fatto usando il comando PHP "add_action", parcheggiato con diverse istruzioni "echo" e le lenti esistenti del codice WordPress che possono essere trasferite direttamente dai file modello WordPress esistenti. Ricorda che praticamente qualsiasi variabile che può essere utilizzata in un modello è valida anche per l'inclusione all'interno di un file di plugin, anche se i tag PHP di apertura e chiusura devono essere omessi poiché il codice è già racchiuso in un involucro di tag PHP di apertura e chiusura onnicomprensivo .

Ecco come appare l'azione "aggiunta" all'interno del file del plugin quando è completamente compilato:

function social_links ($ post_ID) {
globale $ wp_query;
$ ID = $ wp_query-> post-> ID;
if (get_post_meta (13); == 1)
{
restituire $ post_ID. "Pulsanti di collegamento alla rete sociale";
}
altro
{
restituire $ post_ID. “”;
}
}
add_action ('the_content', 'social_links');

Le prime righe di codice vengono semplicemente utilizzate per determinare se nel dashboard di WordPress siano state compilate o meno informazioni "meta" per la specifica voce visualizzata. Questo viene fatto interrogando il database di WordPress (usando la variabile $ wp_query) e cercando informazioni all'interno del numero del campo meta 13. A ogni campo personalizzato viene assegnato un identificativo numerico, proprio come le voci, i commenti e le pagine. Questo numero può essere utilizzato all'interno di variabili per istruzioni condizionali.

Quindi, prima il plug-in cerca nel campo personalizzato per ogni voce e vede se il contenuto è presente o meno nella tabella del database del campo. Successivamente, passa attraverso il condizionale. Se il contenuto è uguale a "1", procede. L'uso di "1" in questo caso significa "se il campo ha dati presenti". L'inverso di questo sarebbe "0" che tradurrebbe in "se il campo non ha dati presenti". Quindi, se il campo ha dati presenti o uguale a "1", la funzione procede alla prima parte del condizionale. Questa sezione fornisce la visualizzazione dei link di condivisione dei social media. Ai fini della brevità, tali collegamenti non sono stati inclusi con la funzione. Tuttavia, possono fare finta di usare il semplice XHTML tra virgolette che seguono l'istruzione "return $ post_ID".

Se il campo personalizzato non ha dati presenti, equivale effettivamente a "0" per quanto riguarda il codice di questo plugin. Tuttavia, poiché questo condizionale è un enunciato / o, invece di uno con molti risultati diversi, semplicemente usiamo la costruzione "altro" per indicare al plugin di stampare il contenuto alternativo in qualsiasi altra circostanza. In questo caso, non stampa semplicemente nulla. Per questo motivo, tutto ciò che deve essere inserito all'interno della funzione è:

return $ post_ID ""

In fondo alla dichiarazione, aggiungiamo la nostra nuova funzione come "azione" alla variabile PHP "the_content" esistente. In questo modo i pulsanti di condivisione dei social network verranno aggiunti alla fine di una voce subito dopo aver terminato la stampa del contenuto della voce. Le affermazioni in questa istruzione parentetica sono cronologiche, il che significa che la nuova azione ("social_links") potrebbe essere collocata prima di "the_content" se quei pulsanti dovevano essere visualizzati all'inizio del contenuto, direttamente dopo che il titolo della voce è stato stampato sul schermo.

Con la funzione completata, e l'azione aggiunta al ciclo di WordPress direttamente dopo che il corpo principale del contenuto della voce è stampato sulla tot he page, il plugin è essenzialmente completo. Questo è il momento giusto per aggiungere il tag PHP di chiusura, salvare il file e caricarlo sul server per l'uso.

Passo 3: attiva il plugin e provalo

La parte più importante del processo è l'attivazione del plug-in e la verifica che le sue funzioni funzionino come previsto e non causino problemi con eventuali plug-in esistenti o funzionalità standard di WordPress. Questo è anche un buon momento per verificare l'integrità del codice PHP e garantire che qualsiasi output (XHTML o altro) venga stampato come desiderato.

Se si verificano errori durante il processo di attivazione e test, è importante controllare il file del plugin e assicurarsi che tutte le istruzioni siano correttamente aperte e chiuse. Ciò significa controllare la punteggiatura, in molti casi, tra parentesi, punti e virgola, parentesi e lettere minuscole. Ricorda che PHP fa distinzione tra maiuscole e minuscole, ed è anche sensibile alla punteggiatura: qualsiasi istruzione non chiusa essenzialmente continua all'infinito e può causare semplicemente che le pagine non vengano caricate o caricate estremamente lentamente.

Quando tutti i nodi sono stati risolti, il lavoro è in gran parte completato. Tuttavia, ci sono alcune considerazioni aggiuntive da tenere a mente per altri scenari.

Passo 4: creazione di un file Leggimi Plugin

Crea un plugin WordPress

Se il plugin è inteso solo per uso privato, non vi è alcun motivo per creare un file "ReadMe" a meno che, naturalmente, si teme che si possa dimenticare cosa fa il plugin, come è stato realizzato, o come funziona all'interno il ciclo WordPress stesso. Tuttavia, molti sviluppatori creano plugin con l'intento di distribuirli alla più ampia comunità di WordPress e, con più di 60 milioni di utenti, questo è un modo redditizio per promuovere un sito Web e guadagnare entrate secondarie.

Questi utenti sono virtualmente tenuti a creare un documento ReadMe che delinei le funzioni del plugin, come installare il file sul server e come impostarlo e personalizzare le sue funzioni. Questo file può anche contenere informazioni come il registro delle modifiche che dettaglia ogni modifica e aggiornamento apportato al plug-in nel tempo. Tuttavia, l'importante è spiegare cosa fa il plugin, come funziona e come installarlo. Gli utenti inesperti non sapranno cosa fare se non vengono guidati attraverso il processo, proprio come gli sviluppatori di plug-in principianti non sapevano come creare una nuova funzione WordPress fino all'ultimo passaggio di questa guida.

Quando il file del plugin è stato completato e associato a un file Leggimi (in genere un file .txt), è ora di inserire entrambi i documenti nella propria cartella e comprimerli utilizzando il formato file ZIP standard. Il plugin può quindi essere caricato nella comunità di estensioni e plug-in di WordPress Extend, così come nel server dello sviluppatore per una soluzione self-hosted.

Relativamente facile da fare, in particolare con le variabili e le funzioni di WordPress

Il bello dello sviluppo di un nuovo plugin per WordPress è che il file può utilizzare qualsiasi funzione PHP, variabile o loop esistente, che WordPress ha già definito e inizializzato. Ciò semplifica l'estensione delle funzionalità di WordPress e migliora le loro funzionalità su molti temi, e rende il processo di sviluppo dei plugin facile come creare un nuovo tema per il software stesso.

Ricorda sempre di verificare i bug, gli errori di convalida e i conflitti di funzione prima di mettere il plug-in in uso attivo o di condividerlo con la più ampia community di WordPress. Una volta completato questo processo e il plug-in funziona correttamente, la fase di sviluppo è completa e sarai libero di goderti il ​​successo e le nuove funzionalità appena create. ;)

Ulteriori letture su WHSR

Per approfondire questo, controlla Elenco di Jerry di 20 Essential WordPress Plugin, 25 Handy Code Snippets per sviluppatori WordPress, Hacks, suggerimenti e trucchi WordPress più ricercati; e, se stai cercando un buon hosting WordPress, guarda cosa ho usato di recente - WP motore - È un host piuttosto costoso (quindi non consigliato ai neofiti) ma ottieni quello per cui paghi.

A proposito di Jerry Low

Fondatore di WebHostingSecretRevealed.net (WHSR) - una recensione di hosting fidata e utilizzata dagli utenti di 100,000. Più di 15 anni di esperienza in web hosting, affiliate marketing e SEO. Collaboratore di ProBlogger.net, Business.com, SocialMediaToday.com e altro.