FAQ und Wissensdatenbank - Kann ich den Betrag und/oder andere Werte im Widget vorbelegen?

Du kannst an einen Link auf eine Seite, in die twingle eingebunden ist, Parameter anhängen. Damit lassen sich zum Beispiel der Slider auf eine bestimmte Summe, der Zahlungsrhythmus, der Spendenzweck, der Minimal- und Maximalwert des Sliders sowie alle Felder der Kontaktdaten vorbelegen.

Parameter an die URL anhängen

Die URL für den Link sieht dann folgendermaßen aus:

https://www.DeineOrganisationsurl.org/DieSeiteaufdersichdastwinglewidgetbefindet/?tw_x

tw_x musst du dabei mit einem der folgenden Parameter ersetzen:

tw_amount=55
Der Betrag (nur Werte, die auch im Min/Max Bereich des Sliders liegen).
tw_target=MeinSpendenzweck
Der Spendenzweck (der Spendenzweck als Text, url-kodiert).
tw_target_fix=MeinSpendenzweck
Nur der definierte Spendenzweck ist auswählbar (Anzeige als Button)
tw_target_id=12345
Die Buchungsnummer eines Spendenzwecks, belegt den Spendenzweck vor
tw_target_id_fix=12345
Die Buchungsnummer eines Spendenzwecks, belegt den Spendenzweck fest vor (siehe unten)
tw_rhythm=monthly
Der Zahlungsrhythmus (Mögliche Werte sind one_time, monthly, yearly, halfyearly, quarterly, funktioniert nur wenn die Auswahl im Widget auch möglich ist).
tw_lang=de
Die Sprache (Mögliche Werte sind: de, en, fr, es; Und alle manuell angelegten Sprachen; Die Sprache muss im Projekt aktiviert sein)
tw_min, tw_max
Der Minimum und Maximumwert des Sliders.
tw_firstname, tw_lastname, tw_email, tw_salutation, tw_title, tw_company, tw_street, tw_address_additional_info, tw_postal_code, tw_city, tw_telephone, tw_country, tw_birthday
Die Felder der Kontaktdaten. Für die Anrede (tw_salutation) benutze bitte die Werte male, female oder divers
tw_receiver, tw_sender
Empfänger:in und Absender:in der Spendenurkunde.
tw_extra
Das Extrafeld ("Weitere Kontaktdaten abfragen"). Wenn hier eine Checkbox aktiviert ist, kann diese mit dem Wert "1" aktiviert werden.
tw_newsletter=1
Die Checkbox zur Newsletter-Anmeldung wird vorbelegt.
tw_postinfo=1
Die Checkbox "Informationen per Post abonnieren" wird aktiviert
tw_receipt=1
Die Checkbox für die Spendenquittung wird vorbelegt
tw_remarks
Das Kommentarfeld zur Spende
tw_e
Die eindeutige ID einer Spendenaktion
tw_cat=12
Spendenshop: Die Kategorie mit dieser ID ist beim Öffnen des Shops bereits ausgewählt.
tw_product=12 bzw. tw_bundle=12
Spendenshop: Die Detailansicht des Produkts bzw. Bundles mit dieser ID wird direkt geöffnet.

Wenn du mehrere Parameter verwenden möchtest, kannst du diese hintereinander mit einem "&" als Trennung angeben. (Beispiel: ?tw_amount=55&tw_rhythm=monthly). Wenn an deiner URL bereits ein "?" mit Parametern angehängt ist, müssen die twingle Parameter mit einem "&" anstelle eines "?" daran angehängt werden.

Hinweise:

Bei der Einbindungsmethode "optimiert für Homepagebaukästen" funktioniert die Vorbelegung nicht, wenn die Parameter an deine URL angehängt werden. In dem Fall musst du die Vorbelegung direkt bei der Einbindung benutzen (siehe unten).
Wenn du Betragsbuttons in deinem Projekt benutzt und einen Betrag vorbelegst, der nicht in einem Button ist, wird der Betragsslider mit dem ausgewählten Betrag angezeigt.
Möchtest du verhindern, dass bei einem abweichenden Betrag der Slider erscheint, aktiviere in den Projekteinstellungen unter Betrag & Zahlung / Betragswahl bei "Buttons verwenden" die Option "Keine anderen Beträge erlauben". Ein Betrag aus tw_amount, der zu keinem Button passt, wird dann dem nächstliegenden Button zugeordnet. Einen Betrag fest vorzugeben, den Spender:innen nicht ändern können, ist nicht möglich.
Ohne den Parameter tw_amount startet das Widget mit dem Betrag, den du in den Projekteinstellungen unter Betrag & Zahlung / Betragswahl als "Voreinstellung" hinterlegt hast. Welcher Button vorausgewählt wird, steht in der FAQ "Wie kann ich einen bestimmten Betragsbutton vorbelegen?".
Wenn du die "Rhythmusabhängige Betragsauswahl" benutzt, achte darauf, dass deine Kombination aus Rhythmus und Betrag auch zu deinen Projekteinstellungen passt.

Links mit Sprungmarken

Wenn du diese Links für z.B. Buttons auf der Seite verwendest, auf der twingle bereits eingebunden ist, wird diese Seite mit den Parametern neu geladen. Wenn du einen Ankerlink vor das Widget setzt, kannst du diesen ebenfalls hinten mit einem "#Ankerlinkname" an die URL anhängen. Die Seite scrollt dann automatisch an die Stelle des Widgets.

Vorbelegung direkt bei der Einbindung

Parameter können auch direkt im Einbettungscode angehängt werden. Im normalen Einbettungscode hängst du die Parameter an die Einbettungs-URL an:

<!-- twingle -->
<script type="text/javascript">
	(function() {
		var u="https://spenden.twingle.de/embed/organisation/projekt/twxxxxxxxxxx/widget?tw_amount=50&tw_rhythm=monthly";
		var id = '_' + Math.random().toString(36).substr(2, 9);
		var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0], t=d.createElement('div');
		t.id = 'twingle-public-embed-' + id;
		document.currentScript.after(t);
		g.type='text/javascript'; g.async=true; g.id='tw-' + id; g.defer=true; g.src=u; s.parentNode.insertBefore(g,s);
	})();
</script>
<!-- twingle -->

Für die Variante "Optimiert für Homepagebaukästen" hängst du die Parameter an die iframe-URL an:

<!-- twingle -->
<iframe src="https://spenden.twingle.de/organisation/projekt/twxxxxxxxxxx/widget?tw_amount=50&tw_rhythm=monthly" style="width: 100%; border: none; overflow: hidden; height: 450px; position: relative; z-index: 2;" id="twingle-widget-iframe" allow="payment"></iframe>
<script src="https://spenden.twingle.de/embed/generic?cid=twingle-widget-iframe"></script>
<!-- twingle -->

Spendenzwecke fest vorbelegen

Du kannst einen Spendenzweck fest vorbelegen. Infos dazu findest du in dieser FAQ.