Donaties verzamelen met WordPress PayPal

In het eerste deel van deze miniserie, getiteld 'Donaties verzamelen met WordPress', leer je hoe je een WordPress-plug-in kunt schrijven waarmee gebruikers je een donatie kunnen sturen via PayPal. De plug-in gebruikt zijn eigen paneel met instellingen voor backends en is zeer aanpasbaar. Dus laten we beginnen!

Initialisatie van de plug-in

Stap 1

In de wp-content / plugins map van uw site, maak een nieuwe map genaamd paypal-donaties.

Stap 2

Maak nu in die map een bestand met de naam paypal-donations.php.

Stap 3

Ten slotte moet u de Plugin Header-informatie toevoegen, die WordPress zal vertellen dat uw nieuwe plug-in daadwerkelijk op uw server bestaat. U kunt deze gegevens wijzigen in wat u maar wilt, hoewel ze doorgaans in die volgorde moeten zijn met een minimum aan informatie.

Stap 4

U ziet nu dat uw nieuwe plug-in wordt weergegeven in de plugins pagina van de WordPress-beheerder. Ga je gang en Activeren de plug-in, hoewel je nog niet veel zult zien gebeuren.

De shortcode toevoegen

U kunt uw donatieknop gebruiken door een eenvoudige shortcode te gebruiken in berichten of pagina's die u maakt. Kort gezegd is een shortcode een klein stukje tekst, omsloten door vierkante haken, waarmee u elke functie of actie vanuit een plug-in of thema kunt aanroepen in de berichteditor.

In deze plug-in zal de shortcode zijn, [Doneren], en dit kan overal in uw berichten of pagina's worden toegevoegd.

Stap 1

Om de shortcode aan WordPress toe te voegen, moet u de add_shortcode functie, en daarbinnen, definieer wat de shortcode zal zijn (in dit geval, 'doneer'), en dan definieer je de formuliervelden voor de donatieknop en de afbeeldingsinformatie voor de knop.

// Voegt toe [doneren] shortcode add_shortcode ('doneren', functie () $ donate_options = get_option ('donate_plugin_options'); // Doovenwoord Button Image $ url = 'images_13 / collecting-donations-with-wordpress-paypal_2.gif' ; // Controleert welke schakelaar moet worden gebruikt ($ 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 '
'; );

Stap 2

In dit stadium kunt u de nieuwe shortcode toevoegen aan een bericht of pagina, hoewel deze er niet helemaal uit zal zien en waarschijnlijk een paar fouten op uw site zal opleveren..

Callbacks & formulierfuncties

U definieert nu de callbacks die vereist zijn om de plug-in te laten werken, evenals het formulier voor het instellingenpaneel in de WordPress-beheerder.

Stap 1

Je zou nu een lege callback moeten toevoegen, wat nodig is om ervoor te zorgen dat de plug-in correct functioneert. Het is gewoon een nieuwe WordPress-functie definiëren, deze openen en vervolgens weer sluiten.

function donate_plugin_cb () // Optioneel terugbellen

Stap 2

Vervolgens voeg je een functie toe die veld genereert en invoert in het admin-instellingenformulier voor je PayPal-e-mailadres.

// Genereer INPUT Formulierinstellingen veldformulier [EMAIL] functie paypal_user_id_html () $ donate_options = get_option ('donate_plugin_options'); echo "";

Stap 3

Nu genereer je een invoerveld voor de beheerdersinstellingen met keuzerondjes, zodat je kunt selecteren welke knop je leuk vindt - daarover later meer.

// Genereer INPUT veldformulier-instellingen [RADIO] -functie paypal_donation_button_html () $ donate_options = get_option ('donate_plugin_options'); ?> 

Stap 4

Ten slotte genereren we een ander invoerveld met veel drop-downitems, zodat u de valuta kunt selecteren waarin uw PayPal-donaties worden verwerkt door een PHP-array toe te voegen.

// Genereer INPUT veld formulier formulier instellingen [DROPDOWN] functie paypal_currency_html () $ donate_options = get_option ('donate_plugin_options'); $ currency = array ('AUD' => 'Australische dollar (A $)', 'BRL' => 'Braziliaanse real', 'CAD' => 'Canadese dollar (C $)', 'CZK' => 'Tsjechisch Koruna ',' DKK '=>' Danish Krone ',' EUR '=>' Euros (€) ',' HKD '=>' Hong Kong Dollar ($) ',' HUF '=>' Hungarian Forint ',' ILS '=>' Israëlische nieuwe shekel ',' JPY '=>' Yen (¥) ',' MYR '=>' Maleisische ringgit ',' MXN '=>' Mexicaanse peso ',' NOK '=>' Noorse kroon ',' NZD '=>' Nieuw-Zeelandse Dollar ($) ',' PHP '=>' Filippijnse Peso ',' PLN '=>' Poolse Zloty ',' GBP '=>' Pond Sterling (£) ',' RUB '=>' Russische roebel ',' SGD '=>' Singaporese dollar ($) ',' SEK '=>' Zweedse kroon ',' CHF '=>' Zwitserse frank ',' TWD '=>' Taiwan Nieuw Dollar ',' THB '=>' Thai Baht ',' TRY '=>' Turkish Lira ',' USD '=>' US Dollars ($) ',); ?>  

Het allemaal vasthaken

Nu u uw shortcode- en formuliervelden hebt gegenereerd, moet u deze opnieuw verbinden met de WordPress-beheerder, zodat de plug-in functioneel is.

Stap 1

Laten we beginnen met het registreren van alle instellingen en hun velden met WordPress en vervolgens de actie toevoegen aan de beheerder.

// Registreer alle instellingen en velden instellen zoals gebruikt in WordPress-functie 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', 'Main Settings', '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');

Stap 2

Je gaat nu de HTML van de hoofdoptiespagina in WordPress genereren door een div op te zetten met de klasse van wikkelen, en vervolgens het openen van het formulier en het importeren van de instellingenvelden.

// Genereer HTML van de hoofdopties van de optiespagina options_page_html () ?> 

Plugin-opties

Stap 3

Vervolgens voegt u de instellingenpagina van de plug-in toe aan de WordPress-beheerder, met behulp van de options_init () functie, samen met de add_options_page functie.

// Admin Menu Actie Hook-functie 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');

Stap 4

De allerlaatste stap is om de activeringshaak toe te voegen en om te controleren of de instellingen al bestaan. Als ze dat doen, geweldig - zo niet, dan zal de plug-in de standaardinstellingen registreren.

// Activeringshaak. Controleer of er instellingen bestaan, of niet registerstandaarden. function donate_activate () $ default = array ('paypal_user_id' => get_option ('admin_email'), 'button' => 'small', 'currency' => 'USD'); als (get_option ('donate_plugin_options')) terugkomt; add_option ('donate_plugin_options', $ standaard);  register_activation_hook (__FILE__, 'donate_activate');

Laatste broncode

Uw plug-in zou nu volledig functioneel moeten zijn, door de [Doneren] shortcode naar uw berichten of pagina's! Hier is de volledige broncode voor de plug-in:

 
'; ); function donate_plugin_cb () // Optioneel terugbellen // Genereer INPUT veldformulier instellingen [EMAIL] functie paypal_user_id_html () $ donate_options = get_option ('donate_plugin_options'); echo ""; // Genereer INPUT Formulier-veldformulier-instellingen [RADIO] -functie paypal_donation_button_html () $ donate_options = get_option ('donate_plugin_options');?>

'Australische dollar (A $)', 'BRL' => 'Braziliaanse real', 'CAD' => 'Canadese dollar (C $)', 'CZK' => 'Tsjechische kroon', 'DKK' => 'Deens Krone ',' EUR '=>' Euros (€) ',' HKD '=>' Hong Kong Dollar ($) ',' HUF '=>' Hungarian Forint ',' ILS '=>' Israelische Nieuwe Sjekel ', 'JPY' => 'Yen (¥)', 'MYR' => 'Malaysian Ringgit', 'MXN' => 'Mexican Peso', 'NOK' => 'Norwegian Krone', 'NZD' => 'Nieuw-Zeeland Dollar ($) ',' PHP '=>' Filippijnse Peso ',' PLN '=>' Poolse Zloty ',' GBP '=>' Pond Sterling (£) ',' RUB '=>' Russische Roebel ',' SGD '=>' Singaporese dollar ($) ',' SEK '=>' Zweedse kroon ',' CHF '=>' Zwitserse frank ',' TWD '=>' Taiwan nieuwe dollar ',' THB '=>' Thais Baht ',' TRY '=>' Turkish Lira ',' USD '=>' US Dollars ($) ',); ?>

Plugin-opties

get_option ('admin_email'), 'button' => 'small', 'currency' => 'USD'); als (get_option ('donate_plugin_options')) terugkomt; add_option ('donate_plugin_options', $ standaard); register_activation_hook (__FILE__, 'donate_activate');

Samengevat

U hebt nu geleerd hoe u een volledig nieuwe plug-in kunt ontwikkelen, waarmee gebruikers kunnen doneren via PayPal. U kunt nu een plug-in initialiseren, shortcodes gebruiken en een instellingenpagina toevoegen aan uw WordPress-beheerder.

In het volgende - en laatste - deel van deze minireeks leer je hoe je een vergelijkbare plug-in kunt schrijven, zodat gebruikers kunnen doneren met Bitcoins in plaats van een conventionele valuta met PayPal.

Als u vragen heeft, kunt u hieronder een reactie achterlaten en ik zal u zeker helpen!