ATTENZIONE: I moduli di donazione di nuova creazione sono registrati come V2. Si prega di consultare il testo di aiuto relativo alla V2. I moduli di donazione in questo documento appartengono a una versione precedente!
Cos'è un modulo di donazione?
I moduli di donazione sono un'infrastruttura che ti permette di ricevere donazioni integrandoli nel tuo sito web. Puoi creare un modulo di donazione accedendo alla sezione Donazioni > Modulo di Donazione nel menu a sinistra.
Cosa considerare?
Il punto più importante da considerare quando si crea un modulo di donazione è inserire l'indirizzo del sito web in cui si utilizzerà il modulo. Quando si inserisce l'indirizzo, è necessario includere https:// all'inizio. E se il tuo sito web ha più versioni, dovresti renderlo unico. I moduli di donazione funzionano solo con HTTPS.
Ad esempio;
Se il tuo sito funziona sia come https://www.adimadim.org che come https://adimadim.org, seleziona solo uno e reindirizza l'altro nome di dominio a quello selezionato.
Integrazione del sito web
ATTENZIONE! Questa integrazione richiede conoscenze di programmazione. È necessario padroneggiare HTML e Javascript di base. Se non si possiedono queste competenze, si prega di utilizzare le nostre pagine di donazione standard.
Innanzitutto, puoi ottenere la chiave API (api_key) e il Codice Campagna (campaign) necessari per utilizzare il modulo nella tua pagina dalla sezione Azioni > Informazioni sull'integrazione nell'elenco dei moduli di donazione.
Subito prima della sezione </head> della tua pagina web
<meta name="Referrer" content="origin"><script type="text/javascript" src="https://s.fonzip.com/js/fonzip.loader.js"></script>
aggiungi il nostro script alla pagina in questo modo.
Successivamente, dopo aver preparato le sezioni della tua pagina web in cui riceverai i parametri di importo e donazione ricorrente, dovresti chiamare la funzione fz.bagis quando si clicca sul pulsante "Fai una donazione".
Parametri
api_key: La tua chiave API (Obbligatorio)
amount: Importo della Donazione (Obbligatorio)
currency: Codice ISO della valuta, di default la valuta dell'organizzazione,
recurring: Donazione ricorrente? (Obbligatorio)
campaign: Il tuo codice campagna (Obbligatorio)
lang: Vuoto o "tr" per turco, "en" per inglese, di default la lingua del browser
get_news: Consenso alla comunicazione, true se dato, false se non dato
referring: Se si desidera che la donazione per conto di qualcuno sia selezionata, true, altrimenti false
cardholder_name: Da compilare se si desidera che il nome e cognome del donatore siano precompilati
email: Da compilare se si desidera che l'indirizzo email sia precompilato
ref_to: Da compilare se si desidera che il nome della persona a cui è destinata la donazione sia precompilato
ref_email: Da compilare se si desidera che l'email della persona a cui è destinata la donazione sia precompilata
tckno: Da compilare se si desidera che il TCKN (codice fiscale turco) sia precompilato, deve essere di 11 cifre
phone: Da compilare se si desidera che il telefono sia precompilato, deve contenere solo numeri
birthday: Data di nascita, deve essere nel formato GG/MM/AAAA e da compilare se si desidera che sia precompilata
details: Campo descrizione, da compilare se si desidera che sia precompilato
api_tracking_id: Codice necessario per tracciare il modulo aperto
fundraising_campaign_id: Da inviare se si desidera che il modulo aperto sia collegato a una campagna utente
name_hidden: Il nome deve essere nascosto nella donazione alla campagna utente?
amount_visible: L'importo della donazione deve essere visibile nella donazione alla campagna utente?
custom_parameters: I tuoi parametri personalizzati
onload: Operazioni che desideri eseguire sulla tua pagina quando il modulo di donazione viene aperto
success: Operazioni che desideri eseguire sulla tua pagina quando la donazione è completata, restituisce le informazioni di donazione riuscite
error: Operazioni che desideri eseguire sulla tua pagina quando la donazione non riesce
close: Operazioni che desideri eseguire sulla tua pagina quando il modulo viene chiuso, se si chiude dopo una donazione riuscita, il parametro result restituisce true.
fz.bagis({ api_key: "API ANAHTARINIZ", amount: "Miktar", currency: "TRY", recurring: false || true, campaign: "KAMPANYA KODUNUZ", lang:"tr", // get_news: true, referring: false, cardholder_name: "Bağışçı adı soyadı", email: "E-Posta adresi", ref_to: "Adına bağış yapılacak kişi adı", ref_email: "Adına bağış yapılacak kişinin e-postası", tckno: "TCKN", phone: "Telefon", birthday: "GG/AA/YYYY", details: "Açıklama", api_tracking_id: "Takip Kodu", fundraising_campaign_id: "Kullanıcı kampanya id", name_hidden: false || true, amount_visible: false || true, custom_parameters: { //i tuoi parametri personalizzati }, onload: function() { // OPERAZIONI DA ESEGUIRE QUANDO IL CARICAMENTO È COMPLETATO }, 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; // OPERAZIONI DA ESEGUIRE IN CASO DI SUCCESSO }, error: function(data) { var hata_kodu = data.error_code; var hata_aciklamasi = data.error_description; // OPERAZIONI DA ESEGUIRE IN CASO DI FALLIMENTO }, close: function(result) { //true se donazione riuscita, altrimenti altre situazioni //Operazioni da eseguire quando il modulo si chiude }});Parametri Personalizzati
Per trasferire a Fonzip qualsiasi campo che non è definito in Fonzip ma che utilizzi durante la ricezione di donazioni, puoi utilizzare la funzione dei parametri personalizzati.
Creazione di Parametri Personalizzati
È possibile creare un parametro facendo clic su Aggiungi parametro nella sezione Parametri personalizzati, che si trova in fondo alla pagina di creazione/modifica del modulo di donazione.
Nella schermata che appare, digita il valore chiave che passerai al parametro nella sezione Nome campo, e il valore che desideri visualizzare nel sistema nella sezione Descrizione, quindi salva.
Ad esempio, abbiamo creato un parametro con il nome del campo makbuz (ricevuta) e la descrizione Richiesta Ricevuta. Se il donatore desidera una ricevuta aggiuntiva, compileremo questo campo come "Sì", altrimenti "No".
Nota: Non ci sono restrizioni sui valori che possono essere passati nei parametri.
Quando invii una richiesta di donazione, devi inviare il tuo parametro nella funzione fz.bagis come segue:
var makbuz_degeri = makbuz_checkbox.selected ? "Sì":"No";fz.bagis({ api_key: "API ANAHTARINIZ", amount: "miktar", currency: "TRY", recurring: false, campaign: "KAMPANYA KODUNUZ", custom_parameters: { makbuz: makbuz_degeri }, success: function(data) { // OPERAZIONI DA ESEGUIRE IN CASO DI SUCCESSO }, error: function(data) { // OPERAZIONI DA ESEGUIRE IN CASO DI FALLIMENTO }});Dopo che la donazione è stata completata, se l'opzione "ricevuta richiesta" è stata selezionata, è possibile vedere i dati pertinenti nei dettagli della donazione come segue:
Avvertenze sui Parametri Personalizzati
L'invio di un parametro non definito nelle impostazioni del modulo causerà un errore nel sistema.
L'invio di dati in un formato diverso da JSON causerà un errore nel sistema.
Se si modifica/cancella il nome di un campo di un parametro precedentemente aggiunto, si potrebbero perdere i dati nelle donazioni correlate.
Codice Esempio
È possibile accedere ai file HTML, CSS e Javascript di esempio all'indirizzo https://bitbucket.org/erdifonzip/fonzip-donation-form-integration.