Ihr könnt den Standardaufruf des Tamaro-Widgets um weitere Konfigurationsparameter ergänzen:
<div class="rnw-widget-container"></div>
<script src="https://tamaro.raisenow.com/WIDGET-ID/latest/widget.js"></script>
<script>
window.rnw.tamaro.runWidget('.rnw-widget-container', {
language: 'de',
//Hier können weitere Parameter eingefügt werden
}).then(function(api) {
window.api = api;
});
</script>
Um Spendenzwecke hinzuzufügen müssen mehrere Schritte erledigt werden :
1. Der Block "payment_purposes" muss eingeblendet werden
2. Die Variablen der Spendenzwecke müssen angelegt werden ("purposes")
3. Es müssen Übersetzungen der Spendenzwecke für jede Sprache und alle Spendenvariablen angelegt werden
4. Optional können zusätzlich noch unterschiedliche Campaign-IDs und SubIDs pro Spendenzweck festgelegt werden. Dies spielt vor allem bei einer eventuellen Weiterverarbeitung der Spenden durch die Buchhaltung eine Rolle.
Im unten stehenden Beispiel findest Du den gesamten Code mit den jeweils markierten Schritten 1 - 4
<div class="rnw-widget-container"></div>
<script src="https://tamaro.raisenow.com/WIDGET-ID/latest/widget.js"></script>
<script>
window.rnw.tamaro.runWidget('.rnw-widget-container', {
language: 'de',
paymentWidgetBlocks: [ //Schritt 1
"payment_purposes",
"payment_amounts_and_intervals",
"payment_payment_methods",
"payment_profile",
{
if: "showPaymentAddress() == true",
then: ['payment_address'],
},
],
purposes: ["p1", "p2", "p3", "p4"], //Schritt 2
translations: { //Schritt 3
de: {
purposes: {
p1: 'Spendenzweck 1',
p2: 'Spendenzweck 2',
p3: 'Spendenzweck 3',
p4: 'Spendenzweck 4',
},
},
en: {
purposes: {
p1: 'Purpose 1',
p2: 'Purpose 2',
p3: 'Purpose 3',
p4: 'Purpose 4',
},
},
},
purposeDetails: { //Schritt 4
p1: {
stored_campaign_id: 11111111111111,
stored_campaign_subid: 11111,
},
p2: {
stored_campaign_id: 22222222222222,
stored_campaign_subid: 22222,
},
p3: {
stored_campaign_id: 33333333333333,
stored_campaign_subid: 33333,
},
p4: {
stored_campaign_id: 44444444444444,
stored_campaign_subid: 44444,
},
},
}).then(function(api) {
window.api = api;
});
</script>
Im "paymentWidgetBlocks" in Schritt 1 werden die jeweils anzuzeigenden Blöcke festgelegt. Hier haben wir neu den Block "payment_purposes" an oberster Stelle eingefügt. Die anderen Blöcke entsprechen der Standardkonfiguration des Widgets, müssen aber dennoch hier angegeben werden, da das "paymentWidgetBlocks" nur als Ganzes überschrieben werden kann.
In Schritt 2 legen wir fest, wieviele Spendenzwecke es geben soll und wie die jeweiligen Variablen heissen. Wir empfehlen, bei der Benennung "p1", "p2" etc zu bleiben, da dies vom Widget bei anderen optionalen Konfigurationsparametern so erwartet wird. Bitte beachten Sie dabei, dass "p1" etc. die Namen der Variablen sind, nicht deren Text-Inhalt.
Der Text dieser Variablen wird nun in Schritt 3 festgelegt. Die jeweiligen Sprachen, hier im Beispiel deutsch und englisch, müssen für das Widget freigeschaltet sein, um festgelegt werden zu können. Die Kürzel "de" und "en" entsprechenden den ISO-Bezeichnungen der jeweiligen Sprachen. Die Texte der Spenden-Variablen (hier im Beispiel "Spendenzweck 1" etc.) erscheinen im Widget als Text neben den Radiobuttons und sollten daher aussagekräftig den jeweiligen Spendenzweck beschreiben. Bitte beachte, dass ein zu langer Text das Layout des Widgets "sprengen" würde. Es empfiehlt sich daher, sich auf wenige Worte oder nur ein Wort zu beschränken.
In Schritt 4 schliesslich haben wir individuelle Campaign-IDs und SubIDs festgelegt. Diese IDs sind für das Funktionieren des Widgets nicht erforderlich und daher optional, können aber wichtig werden, wenn eine automatisierte Weiterverarbeitung der Spenden durch CRMs (nicht in allen Preispaketen verfügbar) erfolgen soll.
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.