ATTENTION : Les formulaires de don nouvellement créés sont enregistrés en version V2. Veuillez consulter le texte d'aide relatif à la V2. Les formulaires de don de ce document appartiennent à une ancienne version !
Qu'est-ce qu'un formulaire de don ?
Les formulaires de don sont une infrastructure qui vous permet de collecter des dons en les intégrant à votre propre site web. Vous pouvez créer un formulaire de don en allant dans la section Dons > Formulaire de don dans le menu de gauche.
À quoi faut-il faire attention ?
Le point le plus important à considérer lors de la création d'un formulaire de don est de saisir l'adresse du site web où vous utiliserez le formulaire. Lorsque vous saisissez l'adresse, vous devez inclure https:// au début. Et si votre site web a plusieurs versions, vous devez le rendre unique. Les formulaires de don ne fonctionnent qu'avec HTTPS.
Par exemple ;
Si votre site fonctionne à la fois comme https://www.adimadim.org et https://adimadim.org, veuillez n'en choisir qu'un et rediriger le nom de domaine non choisi vers l'autre.
Intégration au site web
ATTENTION ! Cette intégration nécessite des connaissances en développement. Vous devez maîtriser les bases de HTML et JavaScript. Si vous n'êtes pas familier avec ces sujets, veuillez utiliser nos pages de don standard.
Tout d'abord, vous pouvez obtenir la clé API (api_key) et le code de campagne (campaign) nécessaires pour utiliser le formulaire sur votre page à partir de la section Actions > Informations d'intégration de la liste des formulaires de don.
Juste avant la section </head> de votre page web
<meta name="Referrer" content="origin"><script type="text/javascript" src="https://s.fonzip.com/js/fonzip.loader.js"></script>
Ajoutez notre script à la page.
Ensuite, après avoir préparé les sections de votre page web où vous récupérerez les paramètres de montant et de don récurrent, vous devez appeler la fonction fz.bagis lorsque le bouton de don est cliqué.
Paramètres
api_key: Votre clé API (Obligatoire)
amount: Montant du don (Obligatoire)
currency: Code ISO de la devise, par défaut la devise de l'organisation,
recurring: Est-ce un don récurrent ? (Obligatoire)
campaign: Votre code de campagne (Obligatoire)
lang: Vide ou "tr" pour le turc, "en" pour l'anglais, par défaut la langue du navigateur
get_news: Autorisation de communication, true si donnée, false sinon
referring: Si le don est fait au nom de quelqu'un, true si sélectionné, false sinon
cardholder_name: Si vous souhaitez que le nom et prénom du donateur soient préremplis, doit être rempli
email: Si vous souhaitez que l'adresse e-mail soit préremplie, doit être rempli
ref_to: Si vous souhaitez que le nom de la personne au nom de laquelle le don est fait soit prérempli, doit être rempli
ref_email: Si vous souhaitez que l'e-mail de la personne au nom de laquelle le don est fait soit prérempli, doit être rempli
tckno: Si vous souhaitez que le numéro d'identification (TCKN) soit prérempli, doit être rempli, doit être de 11 chiffres
phone: Si vous souhaitez que le numéro de téléphone soit prérempli, doit être rempli, doit contenir uniquement des chiffres
birthday: Date de naissance, doit être au format JJ/MM/AAAA et doit être remplie si vous souhaitez qu'elle soit préremplie
details: Champ de description, doit être rempli si vous souhaitez qu'il soit prérempli
api_tracking_id: Code nécessaire pour suivre le formulaire ouvert
fundraising_campaign_id: Doit être envoyé si vous souhaitez que le formulaire ouvert soit lié à une campagne utilisateur
name_hidden: Le nom doit-il être masqué pour les dons effectués dans le cadre de la campagne utilisateur ?
amount_visible: Le montant du don doit-il être visible pour les dons effectués dans le cadre de la campagne utilisateur ?
custom_parameters: Vos paramètres personnalisés
onload: Actions à effectuer sur votre page lorsque le formulaire de don s'ouvre
success: Actions à effectuer sur votre page lorsque le don est terminé, retourne les informations du don réussi
error: Actions à effectuer sur votre page lorsque le don échoue
close: Actions à effectuer sur votre page lorsque le formulaire est fermé, le paramètre result retourne true si la fermeture intervient après un don réussi.
fz.bagis({ api_key: "VOTRE CLÉ API", amount: "Montant", currency: "TRY", recurring: false || true, campaign: "VOTRE CODE DE CAMPAGNE", lang:"fr", // get_news: true, referring: false, cardholder_name: "Nom et prénom du donateur", email: "Adresse e-mail", ref_to: "Nom de la personne au nom de laquelle le don est fait", ref_email: "E-mail de la personne au nom de laquelle le don est fait", tckno: "TCKN", phone: "Téléphone", birthday: "JJ/MM/AAAA", details: "Description", api_tracking_id: "Code de suivi", fundraising_campaign_id: "ID de la campagne utilisateur", name_hidden: false || true, amount_visible: false || true, custom_parameters: { //vos paramètres personnalisés }, onload: function() { //ACTIONS À EFFECTUER LORSQUE LE CHARGEMENT EST TERMINÉ }, success: function(data) { var bagisci_adi = data.name; var bagis_miktari = data.amount; var bagisci_eposta = data.email; var kampanya = data.campaign_id; var adres = data.address; var telefon = data.phone; var tckno = data.tckno; var dogum_tarihi = data.birthday; var il = data.city; var ilce = data.district; var aciklama = data.details; var tckno = data.tckno; var birisi_adina = data.referring; var adina_bagis_yapilan_kisi = data.referring_name; var adina_bagis_yapilan_kisinin_epostasi = data.referring_email; var duzenli = data.recurring; var islem_no = data.order_id; var banka_islem_no = data.transaction_id; var banka_provizyon_no = data.provision_no; var api_tracking_id = data.api_tracking_id; // ACTIONS À EFFECTUER EN CAS DE SUCCÈS }, error: function(data) { var hata_kodu = data.error_code; var hata_aciklamasi = data.error_description; // ACTIONS À EFFECTUER EN CAS D'ÉCHEC }, close: function(result) { //true si don réussi, sinon autres cas //Actions à effectuer lorsque le formulaire est fermé }});Paramètres personnalisés
Vous pouvez utiliser la fonctionnalité de paramètres personnalisés pour transférer à Fonzip tout champ que vous utilisez lors de la collecte de dons, mais qui n'est pas défini dans Fonzip.
Création de paramètres personnalisés
Vous pouvez créer un paramètre en cliquant sur Ajouter un paramètre dans la section Paramètres personnalisés, située en bas de la page de création/modification du formulaire de don.
Sur l'écran qui apparaît, saisissez la valeur de la clé que vous utiliserez pour le paramètre dans la section Nom du champ, et la valeur que vous souhaitez voir apparaître dans le système dans la section Description, puis enregistrez.
Par exemple, nous avons créé un paramètre avec le nom de champ makbuz (reçu) et la description Demande de reçu. Si la personne qui fait le don souhaite un reçu supplémentaire, nous remplirons ce champ avec "Oui", et si elle ne souhaite pas de reçu, nous le remplirons avec "Non".
Note : Il n'y a aucune restriction sur les valeurs à passer dans les paramètres.
Lors de l'envoi d'une demande de don, vous devez envoyer votre paramètre dans la fonction fz.bagis comme suit :
var makbuz_degeri = makbuz_checkbox.selected ? "Var":"Yok";fz.bagis({ api_key: "VOTRE CLÉ API", amount: "montant", currency: "TRY", recurring: false, campaign: "VOTRE CODE DE CAMPAGNE", custom_parameters: { makbuz: makbuz_degeri }, success: function(data) { // ACTIONS À EFFECTUER EN CAS DE SUCCÈS }, error: function(data) { // ACTIONS À EFFECTUER EN CAS D'ÉCHEC }});Une fois le don terminé, si l'option de reçu est sélectionnée, vous pouvez voir les données pertinentes dans les détails du don comme suit.
Avertissements sur les paramètres personnalisés
L'envoi d'un paramètre non défini dans les paramètres du formulaire entraînera une erreur système.
L'envoi de données en dehors du format JSON entraînera une erreur système.
Si vous modifiez ou supprimez le nom d'un paramètre que vous avez ajouté précédemment, vous risquez de perdre les données des dons associés.
Exemple de code
Vous pouvez accéder aux exemples de fichiers HTML, CSS et Javascript à l'adresse https://bitbucket.org/erdifonzip/fonzip-donation-form-integration.