NGO.tools Hilfe

MergeTags (app/Support/MergeTags/AGENTS.md)

Aktualisiert am 09.11.2026

Außerhalb von NGO.tools

  • Platzhalter schreibst du überall in der Form ${Name}.
  • Platzhalter in der älteren Form {Name} und in prozentkodierter Form in Links werden ebenfalls erkannt und ersetzt.
  • Unbekannte Platzhalternamen bleiben unverändert im Text stehen.
  • Platzhalter für Kontakt-, Adress-, Spenden- und Veranstaltungswerte stehen dir überall aus demselben Katalog zur Verfügung, auch im Newsletter.
  • Platzhalter, die nur ein bestimmtes Feature füllt, etwa Spendenbetrag, Lotterie, Formularfelder oder Workflow-Variablen, kannst du nur in diesem Feature verwenden.
  • In Eingabefeldern mit Platzhaltern erscheinen diese als Badges, und du fügst sie über das „@“-Menü ein.
  • Alte Werte in der Form {Name} zeigt das Eingabefeld als Badge an und wandelt sie beim Speichern in ${Name} um.
  • Die Hilfe „Verfügbare Platzhalter“ zeigt Platzhalter immer in der Schreibweise ${Name}.

In NGO.tools: Organisation › Dokumente

  • In Word-Vorlagen funktionieren Platzhalter nur in der Schreibweise ${Name}.
  • In Word-Vorlagen setzt du Bedingungen mit ${wenn:Segment} … ${/wenn:Segment} oder mit ${wenn nicht:Segment} ….
  • Bedingungen in Word-Vorlagen werden ausgewertet, bevor die Platzhalter gefüllt werden.
  • Als Bedingung in Word-Vorlagen zählt immer die Zugehörigkeit des Kontakts zu einem Kontakt-Segment, nicht zu einer Newsletter-Liste.
  • Trennst du in einer Bedingung mehrere Segmente mit Komma oder Semikolon, greift ${wenn:…} bei Kontakten in mindestens einem und ${wenn nicht:…} bei Kontakten in keinem dieser Segmente.
  • Enthält der Name eines Segments selbst ein Komma oder Semikolon, wird er in einer Bedingung als ein Segment erkannt und nicht aufgetrennt.
  • Brauchst du in einer Bedingung einer Word-Vorlage weitere Kriterien, legst du dafür ein dynamisches Segment an, statt eine eigene Schreibweise zu verwenden.
  • Mehrzeilige Werte wie ${ContactEnvelope} füllen in Word-Vorlagen die leeren Absätze direkt unter dem Platzhalter, eine Zeile je Absatz.
  • Weil mehrzeilige Werte in Word-Vorlagen leere Absätze unter dem Platzhalter überschreiben, bleibt der Rest deines Briefs gleich hoch, egal wie viele Zeilen die Adresse hat.
  • Ein Absatz mit Inhalt wie Text, Bild, Textfeld, Feld oder einem Seiten- oder Abschnittswechsel beendet in Word-Vorlagen das Auffüllen eines mehrzeiligen Werts.
  • Mit ${Segment:A;B;C} gibst du in Word-Vorlagen die Namen der aufgeführten Segmente aus, in denen der Kontakt ist, etwa „A und C“, sonst bleibt die Stelle leer.
  • Für Segmentnamen in ${Segment:…} gelten dieselben Fehler wie bei Bedingungen, etwa bei unbekannten oder mehrdeutigen Segmentnamen.
  • Weil eine neue Zeile meist niedriger ist als ein leerer Absatz mit Abständen, bekommt der Absatz mit einem mehrzeiligen Platzhalter in Word-Vorlagen den Unterschied als Abstand danach, damit dein Brief gleich hoch bleibt.
  • Die Segmentnamen aus ${Segment:…} werden in Word-Vorlagen erst eingesetzt, nachdem die Bedingungen ausgewertet sind.

In NGO.tools: Kommunikation › Newsletter

  • Die kurzen Newsletter-Platzhalter wie FirstName oder Salutation werden nicht mehr zur Auswahl angeboten, aber weiterhin ersetzt.

In NGO.tools: Kommunikation › Serienbriefe

  • Unbekannte oder mehrdeutige Segmentnamen und fehlerhafte Abschnitte in einer Word-Vorlage führen zu einem Fehler, der schon vor dem Anlegen eines Serienbriefs geprüft wird.