Collecter des dons avec WordPress PayPal

Dans la première partie de cette mini-série intitulée "Collecter des dons avec WordPress", vous apprendrez à écrire un plugin WordPress permettant aux utilisateurs de vous envoyer un don via PayPal. Le plugin utilise son propre panneau de paramètres, et est hautement personnalisable. Alors, commençons!

Initialiser le plugin

Étape 1

dans le wp-content / plugins répertoire de votre site, créez un nouveau dossier appelé donations paypal.

Étape 2

Maintenant, dans ce dossier, créez un fichier appelé paypal-donations.php.

Étape 3

Enfin, vous devez ajouter les informations d'en-tête de plug-in, qui indiqueront à WordPress que votre nouveau plug-in existe réellement sur votre serveur. Vous pouvez modifier ces informations comme bon vous semble, même si elles doivent généralement être dans cet ordre avec un minimum d'informations..

Étape 4
Vous verrez maintenant votre nouveau plugin apparaître dans le Plugins page de l'administrateur WordPress. Allez-y et Activer le plugin, bien que vous ne voyiez pas grand chose se passer pour l'instant.
Ajout du Shortcode
Vous pourrez utiliser votre bouton de don en utilisant un simple numéro abrégé dans les publications ou les pages que vous créez. Essentiellement, un shortcode est un petit morceau de texte, entouré de crochets, qui vous permet d’appeler n’importe quelle fonction ou action depuis un plugin ou un thème, dans l’éditeur de publication..
Dans ce plugin, le shortcode sera, [faire un don], et cela peut être ajouté n'importe où dans vos publications ou pages.
Étape 1
Pour ajouter le shortcode à WordPress, vous devez utiliser le add_shortcode fonction, et en son sein, définissez ce que sera le shortcode (dans ce cas, "faire un don"), puis vous définirez les champs de formulaire pour le bouton faire un don, ainsi que les informations d'image du bouton.
// Ajoute [donate] shortcode add_shortcode ('donate', function () $ donate_options = get_option ('donate_plugin_options'); // Deafult Button Image $ url = 'images_13 / collecte-donations-avec-wordpress-paypal_2.gif' ; // Vérifie quelle image utiliser Switch ($ donate_options ['button']) case 'petit': $ url = 'images_13 / collecte-dons-avec-wordpress-paypal_2.gif'; break; case 'moyen': $ url = 'images_13 / collecte-dons-avec-wordpress-paypal_3.gif'; pause; cas 'grand': $ url = 'images_13 / collecte-dons-avec-wordpress-paypal_4.gif'; pause; retour '
 
       
 
'; );
Étape 2
À ce stade, vous pouvez ajouter le nouveau shortcode à une publication ou à une page, bien que cela ne semble pas tout à fait correct et que des erreurs risquent de se produire sur votre site..
Callbacks & Fonctions de formulaire
Vous allez maintenant définir les rappels nécessaires au bon fonctionnement du plug-in, ainsi que le formulaire pour le panneau de configuration de l'administrateur WordPress..
Étape 1
Vous devez maintenant ajouter un rappel vide, nécessaire pour garantir le bon fonctionnement du plug-in. Il s'agit simplement de définir une nouvelle fonction WordPress, de l'ouvrir, puis de la refermer.
function donate_plugin_cb () // Rappel facultatif
Étape 2
Ensuite, vous allez ajouter une fonction qui génère un champ de saisie dans le formulaire des paramètres d’administrateur pour votre adresse e-mail PayPal..
// Génération des paramètres de formulaire de champ INPUT [EMAIL], fonction paypal_user_id_html () $ donate_options = get_option ('donate_plugin_options'); écho "";
Étape 3
Maintenant, vous allez générer un champ de saisie pour les paramètres d’administration avec des boutons radio, vous pouvez donc sélectionner le bouton de votre choix - plus tard.
// Génération des paramètres de formulaire de champ INPUT [RADIO] fonction paypal_donation_button_html () $ donate_options = get_option ('donate_plugin_options'); ?> 
  >   
 
  >   
 
  > 
  
 
Étape 4
Enfin, nous allons générer un autre champ de saisie avec de nombreux éléments déroulants afin que vous puissiez sélectionner la devise dans laquelle vos dons PayPal seront traités, en ajoutant un tableau PHP..
// Générer les paramètres de formulaire de champ INPUT [DROPDOWN] function paypal_currency_html () $ donate_options = get_option ('donate_plugin_options'); $ currency = array ('AUD' => 'Dollars australiens (A $)', 'BRL' => 'Réal brésilien', 'CAD' => 'Dollars canadiens (C $)', 'CZK' => 'Tchèque Koruna ',' DKK '=>' Couronne danoise ',' EUR '=>' Euros (€) ',' HKD '=>' Dollar de Hong Kong ($) ',' HUF '=>' Forint hongrois ',' ILS '=>' Shekel israélien ',' JPY '=>' Yen (¥) ',' MYR '=>' Ringgit malaisien ',' MXN '=>' Peso mexicain ',' NOK '=>' Couronne norvégienne ',' NZD '=>' Dollar néo-zélandais ($) ',' PHP '=>' Peso philippin ',' PLN '=>' Zloty polonais ',' GBP '=>' Livres sterling (£) ',' RUB '=>' Rouble russe ',' SGD '=>' Dollar de Singapour ($) ',' SEK '=>' Couronne suédoise ',' CHF '=>' Franc suisse ',' TWD '=>' Taïwan Nouveau Dollar ',' THB '=>' Baht thaïlandais ',' TRY '=>' Livre turque ',' USD '=>' Dollars américains ($) ',); ?>   $ label): if ($ code == $ donate_options ['currency']) $ selected = "selected = 'selected'" ";  else $ selected = "; echo"$ label"; endforeach;?>  
Accrocher tout
Maintenant que vous avez généré votre shortcode et vos champs de formulaire, vous devez le reconnecter à l'administrateur WordPress pour que le plugin soit fonctionnel..
Étape 1
Commençons par enregistrer tous les paramètres et leurs champs avec WordPress, puis en ajoutant l'action à l'administrateur..
// Enregistre tous les paramètres et les champs de configuration tels qu'ils sont utilisés dans la fonction wordpress register_settings_and_fields () // $ groupe_options, $ nom_option, $ sanitize_callback register_setting ('donate_plugin_options', 'donate_plugin_options'); // $ id, $ title, $ callback, $ page add_settings_section ('donate_plugin_main_section', 'Paramètres principaux', 'donate_plugin_cb', __FILE__); // $ id, $ title, $ callback, $ page, $ section, $ args add_settings_field ('paypal_user_id', 'ID PayPal:', 'paypal_user_id_html', __FILE__, 'donate_plugin_main_section'); // $ id, $ title, $ callback, $ page, $ section, $ args add_settings_field ('button', 'Bouton de sélection:', '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');
Étape 2
Vous allez maintenant générer le code HTML de la page d’options principale dans WordPress, en mettant en place un div avec la classe emballage, puis en ouvrant le formulaire et en important les champs de paramètres.
// Génère le code HTML de la page d'options principale, fonction options_page_html () ?> 
 
Options du plugin
 
  
  
 
 
 
Étape 3
Ensuite, vous allez ajouter la page des paramètres du plugin dans l’administrateur de WordPress, en utilisant le options_init () fonction, avec le add_options_page une fonction.
// Admin Menu Action Hook function options_init () // titre_page, titre_menu, fonctionnalité, menu_slug, fonction add_options_page ('Donate Plugin Options', 'Donate Plugin Options', 'administrateur', __FILE__, 'options_page_html');  add_action ('admin_menu', 'options_init');
Étape 4
La toute dernière étape consiste à ajouter le crochet d’activation et à vérifier si les paramètres existent déjà. Si c'est le cas, très bien - sinon, le plugin enregistrera les valeurs par défaut.
// crochet d'activation. Vérifiez si les paramètres existent, sinon enregistrez les valeurs par défaut. function donate_activate () $ defaults = array ('paypal_user_id' => get_option ('admin_email'), 'button' => 'petit', 'currency' => 'USD'); if (get_option ('donate_plugin_options')) retourne; add_option ('donate_plugin_options', $ defaults);  register_activation_hook (__FILE__, 'donate_activate');
Code source final
Votre plugin devrait maintenant être entièrement fonctionnel, en ajoutant le [faire un don] shortcode à vos messages ou pages! Voici le code source complet du plugin:
 
       
 '; ); function donate_plugin_cb () // Rappel facultatif // Générer les paramètres de formulaire de champ INPUT [EMAIL] function paypal_user_id_html () $ donate_options = get_option ('donate_plugin_options'); écho ""; // Génération des paramètres de formulaire de champ INPUT [RADIO], fonction [paypal_donation_button_html () $ donate_options = get_option ('donate_plugin_options');?>> 
  >   
 
  >   
 
  > 
  
  'Dollars australiens (A $)', 'BRL' => 'Réal brésilien', 'CAD' => 'Dollars canadiens (C $)', 'CZK' => 'Couronne tchèque', 'DKK' => 'Danois Krone ',' EUR '=>' Euros (€) ',' HKD '=>' Dollar de Hong Kong ($) ',' HUF '=>' Forint hongrois ',' ILS '=>' Shekel israélien ', 'JPY' => 'Yen (¥)', 'MYR' => 'Ringgit malaisien', 'MXN' => 'Peso mexicain', 'NOK' => 'Couronne norvégienne', 'NZD' => 'Nouvelle Zélande Dollar ($) ',' PHP '=>' Peso philippin ',' PLN '=>' Zloty polonais ',' GBP '=>' Livres sterling (£) ',' RUB '=>' Rouble russe ',' SGD '=>' Dollar de Singapour ($) ',' SEK '=>' Couronne suédoise ',' CHF '=>' Franc suisse ',' TWD '=>' Nouveau dollar de Taiwan ',' THB '=>' Thaï Baht ',' TRY '=>' Livre turque ',' USD '=>' US Dollars ($) ',); ?>   $ label): if ($ code == $ donate_options ['currency']) $ selected = "selected = 'selected'" ";  else $ selected = "; echo"$ label"; endforeach;?>   
 
Options du plugin
 
  
  
 
 
  get_option ('admin_email'), 'button' => 'petit', 'currency' => 'USD'); if (get_option ('donate_plugin_options')) retourne; add_option ('donate_plugin_options', $ defaults);  register_activation_hook (__FILE__, 'donate_activate');
En résumé
Vous avez maintenant appris à développer un tout nouveau plugin, qui permet aux utilisateurs de faire un don via PayPal. Vous pouvez maintenant initialiser un plugin, utiliser des codes abrégés et ajouter une page de paramètres à votre administrateur WordPress..
Dans la prochaine et dernière partie de cette mini série, vous apprendrez à écrire un plugin similaire, permettant ainsi aux utilisateurs de faire un don en Bitcoins, au lieu d’une monnaie conventionnelle avec PayPal..
Si vous avez des questions, n'hésitez pas à laisser un commentaire ci-dessous, et je ne manquerai pas de vous aider!



		
			
	   
	




Code