Nella prima parte di questa mini serie intitolata "Raccolta di donazioni con WordPress", imparerai come scrivere un plug-in WordPress che consente agli utenti di inviarti una donazione tramite PayPal. Il plugin utilizza il proprio pannello delle impostazioni di backend ed è altamente personalizzabile. Quindi iniziamo!
Nel wp-content / plugins
directory del tuo sito, crea una nuova cartella chiamata PayPal-donazioni
.
Ora, all'interno di quella cartella, crea un file chiamato paypal-donations.php
.
Infine, devi aggiungere le informazioni sull'intestazione del plugin, che diranno a WordPress che il tuo nuovo plug-in effettivamente esiste sul tuo server. Puoi modificare questi dettagli in qualsiasi modo desideri, anche se in genere dovrebbero essere nell'ordine con un minimo di tali informazioni.
'; );Passaggio 4
Ora vedrai il tuo nuovo plug-in comparire nel plugin pagina dell'amministratore di WordPress. Vai avanti e Attivare il plugin, anche se non vedrai ancora molto successo.
Aggiungere lo Shortcode
Potrai attivare il pulsante di donazione utilizzando un semplice shortcode in qualsiasi post o pagina che crei. In sostanza, uno shortcode è una piccola porzione di testo, racchiusa tra parentesi quadre, che consente di chiamare qualsiasi funzione o azione da un plug-in o un tema, nell'editor dei post.
In questo plugin, lo shortcode sarà,
[donare]
, e questo può essere aggiunto ovunque nei tuoi post o pagine.Passo 1
Per aggiungere lo shortcode a WordPress, è necessario utilizzare il
add_shortcode
funzione, e al suo interno, definisci quale sarà lo shortcode (in questo caso, "donate"), e poi definirai i campi del modulo per il pulsante donazione e le informazioni sull'immagine per il pulsante.// Aggiunge [donate] shortcode add_shortcode ('donate', function () $ donate_options = get_option ('donate_plugin_options'); // Pulsante Deafult Immagine $ url = 'images_13 / collecting-donations-with-wordpress-paypal_2.gif' ; // Controlla quale immagine utilizzare switch ($ donate_options ['button']) case 'small': $ url = 'images_13 / collecting-donations-with-wordpress-paypal_2.gif'; break; case 'medium': $ url = 'images_13 / collecting-donations-with-wordpress-paypal_3.gif'; break; case 'large': $ url = 'images_13 / collecting-donations-with-wordpress-paypal_4.gif'; break; return '
In questa fase, puoi aggiungere il nuovo shortcode a un post o una pagina, anche se non sembrerà giusto, e probabilmente genererà alcuni errori sul tuo sito.
Ora definirai i callback necessari per far funzionare il plugin, così come il modulo per il pannello delle impostazioni nell'amministratore di WordPress.
Ora dovresti aggiungere un callback vuoto, che è necessario per garantire che il plugin funzioni correttamente. Si tratta semplicemente di definire una nuova funzione di WordPress, aprirla e quindi chiuderla di nuovo.
function donate_plugin_cb () // Callback opzionale
Quindi, aggiungerai una funzione che genera e inserisci il campo nel modulo delle impostazioni di amministrazione per il tuo indirizzo email PayPal.
// Genera impostazioni modulo modulo INPUT Campo [EMAIL] function paypal_user_id_html () $ donate_options = get_option ('donate_plugin_options'); eco "";
Ora, genererai un campo di input per le impostazioni di amministrazione con i pulsanti di opzione, in modo da poter selezionare il pulsante di ricerca che desideri - ne parleremo più avanti.
// Genera impostazioni modulo modulo INPUT Impostazioni [RADIO] paypal_donation_button_html () $ donate_options = get_option ('donate_plugin_options'); ?>
Passaggio 4
Infine, genereremo un altro campo di input con molti elementi a discesa, in modo da poter selezionare la valuta in cui verranno elaborate le donazioni PayPal, aggiungendo un array PHP.
// Genera impostazioni modulo modulo INPUT Campo [DROPDOWN] function paypal_currency_html () $ donate_options = get_option ('donate_plugin_options'); $ currency = array ('AUD' => 'Dollari australiani (A $)', 'BRL' => 'Real brasiliano', 'CAD' => 'Dollari canadesi (C $)', 'CZK' => 'Ceco Koruna ',' DKK '=>' Corona danese ',' EUR '=>' Euro (€) ',' HKD '=>' Dollaro di Hong Kong ($) ',' HUF '=>' Fiorino ungherese ',' ILS '=>' Israeli New Shekel ',' JPY '=>' Yen (¥) ',' MYR '=>' Ringgit malese ',' MXN '=>' Peso messicano ',' NOK '=>' Corona norvegese ',' NZD '=>' Dollaro neozelandese ($) ',' PHP '=>' Peso filippino ',' PLN '=>' Zloty polacco ',' GBP '=>' Sterline (£) ',' RUB '=>' Russian Ruble ',' SGD '=>' Singapore Dollar ($) ',' SEK '=>' Swedish Krona ',' CHF '=>' Swiss Franc ',' TWD '=>' Taiwan Nuovo Dollar ',' THB '=>' Thai Baht ',' TRY '=>' Turkish Lira ',' USD '=>' Dollari USA ($) ',); ?>Hooking It All Up
Ora hai generato il tuo cortocircuito e i campi del modulo, devi ricollegarlo all'amministratore di WordPress, in modo che il plugin sia funzionante.
Passo 1
Iniziamo registrando tutte le impostazioni e i relativi campi con WordPress, quindi aggiungendo l'azione all'amministratore.
// Registra tutte le impostazioni e imposta i campi come usati nella funzione wordpress register_settings_and_fields () // $ option_group, $ option_name, $ sanitize_callback register_setting ('donate_plugin_options', 'donate_plugin_options'); // $ id, $ title, $ callback, $ page add_settings_section ('donate_plugin_main_section', 'Impostazioni principali', 'donate_plugin_cb', __FILE__); // $ id, $ title, $ callback, $ page, $ section, $ args add_settings_field ('paypal_user_id', 'PayPal ID:', 'paypal_user_id_html', __FILE__, 'donate_plugin_main_section'); // $ id, $ title, $ callback, $ page, $ section, $ args add_settings_field ('button', 'Select Button:', 'paypal_donation_button_html', __FILE__, 'donate_plugin_main_section'); // $ id, $ title, $ callback, $ page, $ section, $ args add_settings_field ('currency', 'Currency:', 'paypal_currency_html', __FILE__, 'donate_plugin_main_section'); add_action ('admin_init', 'register_settings_and_fields');Passo 2
Ora genererai l'HTML della pagina delle opzioni principali in WordPress, impostando un div con la classe di
avvolgere
, e quindi aprendo il modulo e importando i campi delle impostazioni.// Genera HTML della funzione della pagina delle opzioni principali options_page_html () ?>Opzioni del plugin
Passaggio 3
Quindi aggiungerai la pagina delle impostazioni del plugin nell'amministratore di WordPress, usando il comando
options_init ()
funzione, insieme aladd_options_page
funzione.// Menu Admin Azione Funzione hook options_init () // page_title, menu_title, capability, menu_slug, function add_options_page ('Donate Plugin Options', 'Donate Plugin Options', 'administrator', __FILE__, 'options_page_html'); add_action ('admin_menu', 'options_init');Passaggio 4
L'ultimo passaggio consiste nell'aggiungere il gancio di attivazione e verificare se le impostazioni esistono già. Se lo fanno, ottimo - in caso contrario, il plugin registrerà i valori predefiniti.
// Hook di attivazione. Controllare se le impostazioni esistono, se non registrare i valori predefiniti. function donate_activate () $ defaults = array ('paypal_user_id' => get_option ('admin_email'), 'button' => 'small', 'currency' => 'USD'); se (get_option ('donate_plugin_options')) restituisce; add_option ('donate_plugin_options', $ defaults); register_activation_hook (__FILE__, 'donate_activate');Codice sorgente finale
Il tuo plugin dovrebbe ora essere completamente funzionante, aggiungendo il
[donare]
shortcode per i tuoi messaggi o pagine! Ecco il codice sorgente completo per il plug-in:'; ); function donate_plugin_cb () // Callback opzionale // Genera impostazioni modulo modulo INPUT Campo [EMAIL] function paypal_user_id_html () $ donate_options = get_option ('donate_plugin_options'); eco ""; // Genera impostazioni modulo modulo INPUT Impostazioni [RADIO] paypal_donation_button_html () $ donate_options = get_option ('donate_plugin_options');?>
'Dollari australiani (A $)', 'BRL' => 'Real brasiliano', 'CAD' => 'Dollari canadesi (C $)', 'CZK' => 'Corone ceche', 'DKK' => 'Danese Krone ',' EUR '=>' Euro (€) ',' HKD '=>' Dollaro di Hong Kong ($) ',' HUF '=>' Fiorino ungherese ',' ILS '=>' Israeli New Shekel ', 'JPY' => 'Yen (¥)', 'MYR' => 'Ringgit malese', 'MXN' => 'Peso messicano', 'NOK' => 'Corona norvegese', 'NZD' => 'Nuova Zelanda Dollar ($) ',' PHP '=>' Peso filippino ',' PLN '=>' Zloty polacco ',' GBP '=>' Sterline (£) ',' RUB '=>' Rublo russo ',' SGD '=>' Dollaro di Singapore ($) ',' SEK '=>' Corona svedese ',' CHF '=>' Franco svizzero ',' TWD '=>' Nuovo dollaro di Taiwan ',' THB '=>' Thai Baht ',' TRY '=>' Turkish Lira ',' USD '=>' US Dollari ($) ',); ?>
get_option ('admin_email'), 'button' => 'small', 'currency' => 'USD'); se (get_option ('donate_plugin_options')) restituisce; add_option ('donate_plugin_options', $ defaults); register_activation_hook (__FILE__, 'donate_activate');Opzioni del plugin
In sintesi
Ora hai imparato come sviluppare un plugin totalmente nuovo, che consente agli utenti di donare tramite PayPal. È ora possibile inizializzare un plug-in, utilizzare gli shortcode e aggiungere una pagina delle impostazioni all'amministratore di WordPress.
Nella parte successiva e finale di questa mini serie, imparerai come scrivere un plug-in simile, consentendo agli utenti di donare usando Bitcoin, invece di una valuta convenzionale con PayPal.
Se hai qualche domanda, non esitare a lasciare un commento qui sotto, e sarò sicuro di aiutarti!