Doku › Für Entwickler

Marker & Shortcodes

Als Template-Autor markierst du direkt im HTML, wo ein verwalteter ProntoSite-Baustein erscheinen soll – ein Formular, ein Google-Bewertungen-Block oder ein Rechts-Link. Beim Import legt ProntoSite den Baustein an, der Kunde konfiguriert ihn danach im Dashboard. So wird aus einem statischen Template direkt eine funktionierende, pflegbare Seite.

Zwei Schreibweisen #

1. Sichtbar (empfohlen) – ein Attribut data-ps an einem beliebigen Element:

<section data-ps="google-reviews">
  <!-- dein eigener Platzhalter, den du frei gestaltest -->
  <p>Kundenstimmen</p>
</section>

<div data-ps="formular:kontakt">…dein Formular-Platzhalter…</div>

Du gestaltest den Platzhalter selbst – beim lokalen Bauen und im Editor ist er sichtbar. Beim Veröffentlichen wird der Inhalt des Elements durch den echten Baustein ersetzt; Element, Klassen und Layout bleiben erhalten (der Baustein erbt dein Design). Das funktioniert an jedem Tag (div, section, li, span, p …).

2. Als HTML-Kommentar – für Stellen ohne eigenes Markup:

<!-- ps:google-reviews -->
<!-- ps:formular name="kontakt" -->

Der ganze Kommentar wird durch den Baustein ersetzt.

Verfügbare Marker #

Marker Ergebnis
google-reviews Google-Bewertungen-Block (Kunde verbindet seinen Google-Ort im Dashboard)
formular:name Verwaltetes Kontaktformular mit Spam-Schutz; Einsendungen landen im Anfragen-Postfach
impressum / datenschutz Markiert die Seite als Rechtstext-Seite
link-impressum / link-datenschutz Setzt einen Link auf die Impressums- bzw. Datenschutz-Seite
cookie-einstellungen / cookie-richtlinie Link zum Consent-Dialog bzw. zur Cookie-Richtlinie

Die Link-Marker (link-…, cookie-…) gehören auf ein <a>-Element: ProntoSite setzt dann nur das href und lässt deinen Linktext und deine Klassen unverändert. Ist ein Ziel nicht verfügbar, bleibt der Anker unangetastet – es entsteht nie ein toter Link.

Regeln #

  • Verwende ausschließlich data-ps (ohne Suffix). Der Namensraum data-ps-* (mit Bindestrich-Zusatz) ist systemreserviert – nicht selbst setzen.
  • Marker werden innerhalb von <script>, <style>, <pre> und <textarea> nicht interpretiert.
  • Denselben Marker mehrfach (auch auf mehreren Seiten) zu verwenden ist unkritisch – es entsteht trotzdem nur eine Instanz. Auch ein erneuter Import erzeugt keine Duplikate.

Die vollständigen Template-Regeln stehen in der Website-Spec.

Zuletzt aktualisiert: