14
Fallstricke und Checkliste
Abhakbare Checklisten vor dem Veröffentlichen eines Blocks, eines Themes oder einer Erweiterung und eine Tabelle aller in den Kapiteln beschriebenen Fallen (Symptom, Ursache, Lösung) mit Verweisen auf die Detail-Einträge.
Checkliste vor dem Veröffentlichen#
Gehen Sie die Liste Punkt für Punkt durch, bevor Sie einen Baustein, ein Theme oder eine Erweiterung weitergeben oder in die Galerie laden. Jeder Punkt verweist auf den Eintrag mit den Einzelheiten.
Block (Baustein)#
Aufbau und Eingabefelder
- ☐ Das Template hat ein Wurzelelement;
<vn-parameters>steht darin, enthält nur direkte Kinder und kommt genau einmal vor (Wurzelelement, Überblick Eingabefelder). - ☐ Feldnamen in
camelCaseaus Buchstaben und Ziffern, kein Bindestrich, kein Umlaut, kein Unterstrich am Anfang (name, Automatische Bereiche). - ☐ Farbvorgaben sechsstellig (
#ffffff), Schieber-Vorgaben auf dem Rastermin + n × step, Bildvorgaben als../_images/<datei>(color, range, image). - ☐ Bedingungen mit Texten und Zahlen als Vergleich oder
!!nameschreiben; Schieber-Werte sind Text, gerechnet wird mitNumber(n)(vn-if, Ausdrücke). - ☐ Das Wort
overlaynur verwenden, wenn die automatischen Overlay-Felder gewollt sind, sonst eigene Felder deklarieren (Automatische Overlay-Felder). - ☐ Text aus dem Panel steht in Attributen nur als
{{vnEnc(…)}}(vnEnc, Text-Daten in Attributen). - ☐ Keine festen IDs: Verweise im Block mit
{{vn-id}}, denn derselbe Block kann mehrfach auf einer Seite stehen ({{vn-id}}).
Stil
- ☐ Eigene Klassennamen und
@keyframes/@font-facemit Kürzel des Blocks (Bootstrap und Klassen, Bereich und Wurzel). - ☐
@bg-…nur mit Hintergrund-Widget und innerhalb einer Bedingung auf@bg-type; Auswahlwerte in Selektoren mite()oder~"@{…}"; keine BOM, kein@import, keindefault()(Prüfliste LESS). - ☐ Kein
body,htmloder:rootim Block-LESS; Variablen für den Block direkt auf der Wurzel setzen (Bereich und Wurzel). - ☐ Größen von Fließtext (
p,li) bewusst setzen: die Schriftgröße der Site gewinnt sonst (Site-Einstellungen). - ☐
!importantnur gezielt (Buttons, Links) und danach in der Live-Vorschau (F5) gegengeprüft: im Editor verliert es gegen!importantvon Bootstrap und Theme (Wer gewinnt, Farben und Links). - ☐ Medienabfragen in der Live-Vorschau (Tablet, Handy) prüfen, nicht im Editor (Falle #canvas).
Bearbeitbare Inhalte
- ☐ Knöpfe als
<a class="btn">mit festem Text und Ziel; keine Platzhalter in Knöpfen (Platzhalter in Buttons, a.btn). - ☐ Panel-Werte und frei bearbeitbarer Text stehen in verschiedenen Elementen (Platzhalter im Text).
- ☐ Hintergrundbilder über ein Bildfeld, ein Hintergrund-Widget oder einen Inline-Stil, nicht nur im LESS (Hintergrundbild im Inline-Style).
- ☐ Kennungen (
data-vn-text-id…) nie von Hand ändern oder löschen (Überblick).
Skripte
- ☐ Init-Merker als JavaScript-Eigenschaft am Element, nicht als
data--Attribut (Einmal-Initialisierung). - ☐ Editor-Erkennung nur mit
el.closest('#canvas'); den parameterabhängigen Anfangszustand vor dem Beenden setzen (Editor-Erkennung, Regeln im Editor). - ☐ Texte von Textfeldern (
data-vn-text-id) nie umschreiben; Text-Effekte nur zur Laufzeit (Text-Animationen). - ☐ Auf
bootstrap,vnCookieConsent,VNPopuperst nachDOMContentLoadedzugreifen; kein jQuery (Reihenfolge und Wartezeit, jQuery). - ☐ „Weniger Bewegung“ respektieren (Weniger Bewegung).
Formulare, Medien, Datenschutz
- ☐ Formulare mit
form.vn-sform-formunddata-mailer, nie als bloße Optik (Beispiel Kontaktformular). - ☐ Nichts von Dritten laden (CDN, Webschriften, Skripte); Einbettungen so bauen, dass der Cookie-Consent sie sperren kann (Datenschutz, Automatisches Sperren).
- ☐ Hintergrundvideo: nicht Datei und Adresse eintragen; für Hintergründe ohne Einwilligung eine eigene Videodatei (Der Baustein Video-Hintergrund, Wiedergabe).
- ☐ Im echten Export testen:
publish/index.htmlöffnen, Konsole ohne Fehler, Netzwerk-Reiter ohne Anfragen an fremde Server (Was Autoren beeinflussen können).
Theme oder Paket#
- ☐ Dateien als UTF-8 ohne BOM; ZIP mit Schrägstrichen (eingebautes
tar.exeoder Python, nichtCompress-Archiveder Windows PowerShell 5.1) (Als Paket packen). - ☐
params.json:name, eindeutigeraliasundtitle,componentsmitpath,_group,_title(params.json). - ☐ Bilder in
components/_images/und als../_images/<datei>verwiesen; keine Videos, keinavif(components/_images, Bilder und Dateinamen). - ☐ Menü und Fußzeile mit
global once="menu"undglobal once="footers"am allerersten Element (Seitenweite Blöcke, global). - ☐
thumb.pngje Baustein,thumbnail.jpgim Paket für die Galerie (thumb.png, thumbnail.jpg). - ☐ Theme-CSS ohne
@scopeund@layer; für oberste Ebene:scopestatt:root; Schriften als Datei im Paket (Im Editor, Falle #canvas, Schriften und Bilder). - ☐ Theme-CSS lässt sich nach dem ersten Import in einem Projekt nicht mehr erneuern: gründlich prüfen,
titlenur bewusst ändern (Nur einmal pro Projekt). - ☐ Eigene Klassenkürzel je Theme, damit sich gemischte Themes nicht überschreiben (Bootstrap und Klassen).
- ☐ Paket in einem neuen Projekt importieren, jeden Baustein einfügen, exportieren (Prüfliste vor dem Weitergeben).
- ☐ Beispieltexte ohne echte Namen, Adressen nur
example.com.
Erweiterung#
- ☐
manifest.json: gültige, nie geänderteid;versionbei jeder Änderung erhöhen (manifest.json). - ☐ Importierte Module (
dom.js,payload.js…) mit hochgezähltem?v=einbinden (Lebenszyklus). - ☐ Fehlende Einträge von
ctx(ältere Programmversion) abfangen (Die Schnittstelle ctx). - ☐ Export-Beitrag nur unter
assets/<eigene id>/…, höchstens 30 Dateien, je 400000 Zeichen (exportContribution). - ☐ Geheimnisse nur über
ctx.project.secrets;{{secret-php:NAME}}nur in PHP-Strings mit doppelten Anführungszeichen (ab Version 1.3.100 wird auch$maskiert) (secrets). - ☐ PHP-Server-Teile: PHP 7.3 und neuer,
php -l,data/selbst schützen, Eingaben prüfen, Ausgaben maskieren (PHP-Server-Teile). - ☐ Keine Fremdserver, kein
eval, keininnerHTMLmit Rohdaten (Sicherheitsregeln). - ☐ Beitrag auf
nullstellen und erneut exportieren: Dateien müssen verschwinden (Bauen, prüfen, ausliefern). - ☐
thumbnail.jpgim Paket, wenn die Erweiterung in die Galerie soll (Galerie).
Fallen im Überblick#
Jede Tabelle ordnet die Fallen eines Themenbereichs: woran Sie sie erkennen, woran sie liegt, was hilft und wo die Einzelheiten stehen.
Paket, Import und Dateien#
| Symptom | Ursache | Lösung | Details |
|---|---|---|---|
| Import meldet „template.html unter components/… nicht gefunden“ | ZIP mit Backslashes (Compress-Archive der Windows PowerShell 5.1, ZipFile.CreateFromDirectory des .NET Framework) | mit tar.exe oder Python packen (Pfade mit /) | Als Paket packen |
| Import meldet „params.json ist kein gültiges JSON“; Block mit „⚠ CSS-Fehler“ | BOM am Anfang von params.json bzw. style.less (Set-Content -Encoding UTF8 der PowerShell 5.1) | als UTF-8 ohne BOM speichern | Ordner und Dateien, Fehler im LESS |
| Paket wird abgelehnt | components fehlt oder ist leer; appScript ohne components; params.json fehlt | components mit mindestens einem Eintrag | params.json |
| Hintergrund- oder Feldbild fehlt nach dem Import | Vorgabe file:///… zeigt auf den Rechner des Autors | Bilder in components/_images/, Vorgabe ../_images/<datei> | image, Bilder und Dateinamen |
Video oder avif im Paket fehlt | aus _images werden nur jpg, jpeg, png, gif, svg, webp entpackt | Videos nicht ins Paket; Nutzer wählt Datei oder Adresse im Feld „Video“ | components/_images |
script.js neben dem Baustein wirkt nicht | der Import liest nur template.html, style.less/style.css, thumb.png | JavaScript als <script> in template.html | Keine Skriptdatei je Baustein |
| Erneuter Import legt einen weiteren Eintrag an; ein Block auf der Seite ändert sich nicht | jeder Import ist ein neuer Eintrag; vorhandene Blöcke behalten ihre gespeicherte Vorlage | Baustein neu einfügen; zum Testen den Code-Editor benutzen | Weiterarbeiten |
| Theme-CSS wird bei erneutem Import nicht aktualisiert | die Kennung vn-theme-css-<title> ist im Projekt schon vorhanden: nichts wird neu geladen; Pakete mit gleichem title teilen sich ein Theme-CSS | Theme-CSS vor dem ersten Import prüfen; in einem neuen Projekt gilt das neue CSS | Nur einmal pro Projekt |
| Farben oder Buttons zweier Themes kollidieren | Theme-CSS und Bootstrap-Klassen wirken auf der ganzen Seite, nicht nur im Block; gleiche Klassennamen | eigene Klassen mit Präfix je Theme; title eindeutig | Bootstrap und Klassen, Speicherung und Selbstheilung |
| Ein neu eingefügtes Menü ersetzt das alte (oder die Fußzeile) | von jeder once-Gruppe gibt es höchstens einen Block im Projekt | Gruppennamen bewusst wählen (menu, footers oder eigener Name) | once, Seitenweite Blöcke |
global wird nicht erkannt; once wirkt nicht | global muss am allerersten Element der Datei stehen (ein vorgestellter <vn-parameters>-Block oder ein umschließendes div verhindert die Erkennung); once ohne global hat keine Wirkung | global und once an das Wurzelelement | global |
| Baustein zeigt kein Vorschaubild | thumb.png fehlt; die Galerie liest thumbnail.jpg, das Programm nicht | thumb.png je Baustein, thumbnail.jpg fürs Paket | thumb.png, thumbnail.jpg |
| Videodatei fehlt im weitergegebenen Block (⇩ / ⤓) | Verweise auf assets/… kommen ins Paket, beim Import werden aber nur Bilder entpackt | Video über Adresse (YouTube/Vimeo) oder Dateiwahl im Block | Export als .vndext |
| Anpassungen fehlen im exportierten Benutzerblock | ⇩ („Als .vndext-Datei exportieren“) nimmt die gespeicherte Vorlage unverändert | ⤓ im Eigenschaften-Panel verwenden | Export als .vndext |
| Code-Knopf eines Baukasten-Blocks ist gesperrt | Baukasten und Freie Fläche werden nur über „+“ und das Panel umgebaut | Block im Reiter „Eigener Code“ bauen oder den Baukasten benutzen | Verhältnis zum Code-Editor |
Template und Eingabefelder#
| Symptom | Ursache | Lösung | Details |
|---|---|---|---|
| Das CSS erreicht ein zweites Element auf oberster Ebene nicht | nur das erste Element bekommt die Instanzklasse | alles in ein Wurzelelement packen | Das Wurzelelement |
| Ein Feld erscheint nicht im Panel | das Feld steht nicht direkt in <vn-parameters>, hat keinen name oder steht in einem zweiten Parameterblock | direktes Kind, name setzen, nur ein Block | Überblick |
{{…}} ergibt überall leeren Text; vn-if blendet nichts aus | ein Feldname ist in JavaScript kein gültiger Bezeichner (Bindestrich, Punkt, Ziffer am Anfang, reserviertes Wort) | camelCase aus Buchstaben und Ziffern | name |
| Block zeigt „⚠ CSS-Fehler“ | ein Feldname mit Umlaut oder $ bricht das LESS | Name ohne Umlaut und $ | name |
{{n + 1}} ergibt 41 statt 5 | die Werte von Schiebern sind Text | Number(n) + 1, n * 1 | range |
| Der Schieber zeigt einen anderen Wert als das LESS sieht | die Vorgabe liegt nicht auf dem Raster min + n × step; gespeichert bleibt die Vorgabe | Vorgaben auf das Raster legen | range |
| Das Panel zeigt Schwarz statt der Vorgabefarbe | Farbe nicht sechsstellig (#fff, white) | #rrggbb | color |
Ein Feld bleibt trotz condition sichtbar | ausgeblendet wird nur bei genau false; ein Fehler (Tippfehler im Namen) oder undefined zeigt das Feld; der Wert bleibt auch im verborgenen Feld erhalten | Vergleich oder !!name schreiben; das Markup mit vn-if selbst abstimmen | condition |
Ein Element bleibt trotz vn-if stehen | vn-if entfernt nur bei genau false; ein leerer Text, undefined oder ein Tippfehler lässt es stehen | !!name oder Vergleich; bei Bedarf vn-strict-if | vn-if, vn-strict-if |
vn-class mit berechnetem Namen bewirkt nichts | ein Schlüssel wie {'n-' + mode: true} ist ein Syntaxfehler | Textform vn-class="'n-' + mode" | vn-class |
vn-style setzt --variable nicht | eigene Eigenschaften werden verworfen | style="--k:{{k}}" oder Variable im LESS auf der Wurzel | vn-style |
Abdunklung (vn-overlay) liegt über Text oder Seitenkopf | die Fläche füllt das nächste positionierte Elternelement | Wurzel position: relative, Inhalt position: relative; z-index: 1 | vn-overlay |
| Overlay-Felder erscheinen ungewollt | das Wort overlay steht im Template (auch als Klasse oder Kommentar) und kein eigenes Feld overlay ist deklariert | eigene Felder deklarieren oder das Wort vermeiden | Automatische Overlay-Felder |
| Ein Text aus dem Panel bricht das Markup oder wird als HTML gesetzt | {{name}} setzt den Wert unmaskiert als HTML ein | in Attributen {{vnEnc(name)}}, sonst nur in Textinhalt | {{name}}, vnEnc |
{{ oder }} im Skript liefert Unsinn oder leeren Text | jedes {{ … }} im Template wird als Ausdruck ausgewertet, auch im Skript | Klammern mit Leerzeichen ({ {) oder auf getrennten Zeilen | Platzhalter in Skripten |
{{beschriftung}} steht wörtlich im Knopf | in <a class="btn"> werden Platzhalter in Text und href nicht ausgewertet (Editor und Export) | Text und Ziel fest ins Template; für Panel-Werte einen gewöhnlichen Link ohne btn | Platzhalter in Buttons, Platzhalter in Knöpfen |
| Ein geänderter Vorgabewert im Paket wirkt in vorhandenen Blöcken nicht | die Werte sind im Block gespeichert | Baustein neu einfügen | Vorgabewerte |
| Zwei Felder verhalten sich wie eines | gleicher name teilt sich einen Wert | eindeutige Namen | name |
Stil, LESS und CSS#
| Symptom | Ursache | Lösung | Details |
|---|---|---|---|
| Block ohne jedes CSS, Etikett „⚠ CSS-Fehler“ | Fehler im LESS: @bg-type ohne Hintergrund-Widget, unbekannte Variable, @import, when (default()), offener Block | Meldung im Tooltip lesen; die Ursache beheben | Fehler im LESS, Hintergrund-Variablen |
url(@bg-value) ergibt url(#f3f4f6) | @bg-value bei Farbe ist eine Farbe | immer innerhalb when (@bg-type = 'image') | Hintergrund-Variablen |
Selektor .'grid'-x ist ungültig; aspect-ratio: '16/9' wird verworfen | Auswahl- und Textwerte kommen als LESS-Text mit Anführungszeichen an | e(@x) oder ~"@{x}" | Werte als Text ausgeben |
when (@text = abc) ist nie wahr | Texte immer in Anführungszeichen vergleichen; Zahl gegen Text (= "2") ist nie wahr | @x = 'abc', Zahlen ohne Anführungszeichen | Gleichsetzen und Bedingungen |
| Division ergibt ein falsches Ergebnis | 10px / 2 aus Literalen wird nicht umgeschrieben | Klammern: (10px / 2), (@n / 2) | Rechnen |
body, html, :root im Block-LESS bewirken nichts | sie geraten hinter die Instanzklasse (.wurzel :root) | Variablen auf der Wurzel setzen; seitenweite Regeln in Theme-CSS oder „Eigenes CSS“ | Bereich und Wurzel |
| Zwei Blöcke überschreiben gegenseitig ihre Animation oder Schrift | @keyframes und @font-face gelten global | Kürzel im Namen | Bereich und Wurzel |
p { font-size: 3rem; } im Block wirkt nicht | die Schriftgröße Fließtext der Site setzt font-size an p, li … mit !important | Größen auf div/span legen oder !important setzen | Site-Einstellungen |
| Der Block sieht im Editor anders aus als im Export | Layer-Umkehr bei !important: im Editor verliert Block-!important gegen !important von Bootstrap und Theme, im Export gewinnt es; „Eigenes CSS“ liegt im Editor ohne Layer | in der Live-Vorschau (F5) oder im Export prüfen; !important nur gezielt | Wer gewinnt |
| Eine Regel im Theme-CSS wirkt im Editor nicht | #canvas .x, html, body, :root im @scope treffen nichts | .x; für den Editor :scope#canvas .x; für Variablen :scope { … } | Die Falle #canvas |
| Medienabfragen schalten im Editor „falsch“ | im Editor gilt die Breite des Programmfensters | Live-Vorschau mit Tablet/Handy | Die Falle #canvas |
| Button- oder Linkfarbe aus dem Block-LESS setzt sich nicht durch | Theme-CSS mit höherer Spezifität oder die Schriftregeln der Site gewinnen | !important für Farben, Rahmen, Schrift von Buttons und Links; im Export prüfen | Buttons und Links, Farben und Links im Block-CSS |
Eine !important-Regel auf .btn überstimmt die „Eigene Farbe“ des Nutzers | der Dialog setzt die Farbe als Inline-Stil ohne !important und entfernt die Farbklasse | !important auf die Farbklasse (.btn-primary) | Eigene Farbe |
Hintergrundbild aus style.less lässt sich nicht per Klick ändern | Bilder nur im LESS lassen sich nicht zuordnen | Bildfeld, Hintergrund-Widget oder Inline-Stil | Hintergrundbild im Inline-Style |
@primaryColor u. ä. ist „undefined“ | Theme-Variablen fehlen ohne Theme | params.theme.settings oder eigene Felder | Theme-Variablen, Theme-Eigenschaften |
| Parallax wirkt am Handy nicht | background-attachment: fixed | Bild so planen, dass es auch ohne Effekt gut aussieht | Parallax |
Bearbeitbare Inhalte#
| Symptom | Ursache | Lösung | Details |
|---|---|---|---|
| Bearbeitungen landen am falschen Element | Kennungen (t3, btn0 …) sind Positionsnummern aus dem Import; ein nachträglich geändertes Template oder von Hand gelöschte Kennungen verschieben sie | Kennungen nie von Hand ändern; Element hinten statt dazwischen einfügen | Überblick |
Eine klickbare Karte (<a class="card">) wird zu einem einzigen Textfeld | ein loser Link ist das Feld, die Kinder zählen nicht | Karte als div mit eigenem Link oder Button | Welche Elemente werden Textfelder |
Beschriftungen im <form> sind nicht anklickbar | innerhalb von form wird nichts als Textfeld erfasst | Feldtexte im Code-Editor ändern | Welche Elemente werden Textfelder |
<button class="btn"> lässt sich nicht bearbeiten | nur <a class="btn"> ist ein Button | <a class="btn" role="button"> | a.btn |
| Ein eigenes Attribut im Text verschwindet beim nächsten Speichern | der Text-Sanitizer lässt nur eine Erlaubnisliste durch | Element außerhalb von Textfeldern bauen | Erlaubte Attribute und Klassen |
| Ein Panel-Platzhalter verschwindet nach dem Bearbeiten des Textes | ein Textfeld mit Platzhalter wird beim Bearbeiten vollständig ersetzt | Panel-Wert und freien Text in getrennte Elemente | Platzhalter im Text |
| Die Hamburger-Farbe wirkt nicht | der Block benutzt ein eigenes Symbol statt .navbar-toggler-icon | .navbar-toggler-icon verwenden | Hamburger-Symbol |
| Textfarbe und Effekte fehlen auf der fertigen Seite (CMS) | im CMS-Text wird style entfernt | Klassen im Block-CSS | Bedienung und Sicherheit |
| CMS-Block ändert nichts | Seite heißt .html oder es ist kein Passwort gesetzt | Seite .php, Passwort im Programm setzen | Einschalten |
| Bild-Griffe passen nicht | Bild ohne verlässlich bestimmbaren Behälter (inline, position:absolute) | Hintergrund-Widget für füllende Bilder | Bilder mit der Maus skalieren |
| Das Symbol ist nicht änderbar | ein SVG, <img> oder eine CSS-Maske ist kein änderbares Symbol | <i class="bi bi-…"> oder data-vn-icon | Symbole verhindern oder ausschließen |
Skripte#
| Symptom | Ursache | Lösung | Details |
|---|---|---|---|
| Panel-Änderungen sind im Editor unsichtbar (zum Beispiel „Schreibmaschine zeigt das neue Wort nicht“) | if (closest('#canvas')) return; steht vor dem Setzen des Anfangszustands | Anfangszustand setzen, dann beenden | Regeln für Skripte im Editor |
| Der Inhalt eines Blocks fehlt oder ist nicht anklickbar | das Skript versteckt oder verschiebt DOM (opacity:0, Reveal, Karussell-Umbau) auch im Editor | im Editor nichts verstecken oder verschieben | Regeln für Skripte im Editor |
| Der Text eines Textfelds ist nach dem Tippen „zerstört“ | das Skript schreibt den Inhalt eines data-vn-text-id-Elements um (Buchstaben-Spans); beim Tippen wird der Zwischenzustand gespeichert | Text-Aufteilung nur zur Laufzeit außerhalb von #canvas; im Template steht der ruhige Text | Text-Animationen zur Laufzeit, Regeln für Skripte im Editor |
| Neue Blöcke werden nie initialisiert | der Init-Merker ist ein data--Attribut und ein altes Skript hat Elemente neuer Blöcke damit markiert | Merker als JavaScript-Eigenschaft (box.vnInit = 1) | Einmal-Initialisierung |
| Das Skript läuft nach dem ersten Neuzeichnen im Editor nie wieder an | Schutzschalter an window (window.fertig) wird pro Render verworfen, auf der echten Seite bleibt er | Merker am Element | window-Eigenschaften |
| Die zweite Instanz eines Blocks ist kaputt | feste IDs oder globaler Zustand | Klassen, {{vn-id}}, Namensraum | Einmal-Initialisierung |
is-builder oder currentScript erkennt den Editor nicht | das Programm setzt is-builder nie; currentScript ist null; es gibt keinen iframe | el.closest('#canvas'); Rückfall document.querySelector(…) | Was nicht zur Erkennung taugt |
bootstrap, vnCookieConsent, VNPopup sind undefined | das Block-Skript läuft beim Parsen, vor Bootstrap und den VN-Bibliotheken | auf DOMContentLoaded warten | Reihenfolge und Wartezeit |
$ oder jQuery ist undefined | jQuery gibt es nur im Bootstrap-Theme-Modus | reines JavaScript | jQuery und Theme-Plugins |
import im <script type="module"> schlägt im Editor fehl | der Editor führt Skripte in new Function aus | klassisches Skript | Fallen: Skript läuft im Editor |
window.vnEnc ist undefined | vnEnc, vnEmbed und {{vn-id}} sind Hilfen des Template-Ausdrucks, keine globalen Funktionen | im Template data-x="{{vnEnc(x)}}", im Skript decodeURIComponent | Text-Daten in Attributen |
Ein Text in einer Attrappe (data-vn-editor-only) ist im Editor bearbeitbar | die Attrappe ist im Editor ein normales Element | ohne Fließtext anlegen oder damit rechnen | Marker data-vn-editor-only |
Formulare#
| Symptom | Ursache | Lösung | Details |
|---|---|---|---|
| Formular sendet nichts („Formular ist noch nicht konfiguriert“ oder tot) | ohne form.vn-sform-form liefert der Export weder Skript noch PHP noch Konfiguration; SMTP ist nicht eingerichtet; data-mailer fehlt | form.vn-sform-form mit data-mailer, SMTP im Programm einrichten | Beispiel Kontaktformular, SMTP-Einstellungen |
Mehrere Empfänger in data-recipient gehen nicht | mailer.php akzeptiert genau eine Adresse je Formular | Weiterleitung im Postfach oder mehrere Formulare | Empfänger |
| „Dieser Empfänger ist für das Formular nicht freigegeben“ | die Adresse steht nicht in recipients.php (der Export schreibt sie aus den exportierten Seiten) | Seite neu exportieren und hochladen | Empfänger |
Ein eigenes HTML-Formular über native-form-handler.php sendet an jede Adresse | ohne recipients.php (Export mit einer Version vor 1.3.100) gibt es keine Empfängerliste | ab Version 1.3.100 neu exportieren und hochladen: dann nur Adressen der Liste und die Absenderadresse | native-form-handler.php |
| Pflichtfelder lassen sich umgehen | „Pflicht“ prüft nur der Browser | Honeypot und IP-Begrenzung zusätzlich; Pflicht nicht als Sicherheitsmerkmal | Pflichtfelder |
| Die Sicherheitsabfrage lässt sich umgehen | der Server prüft sie nur, wenn Antwort oder Token mitgeschickt werden | zusätzlich Honeypot und IP-Begrenzung | Mathe-Sicherheitsabfrage |
| Datei-Upload scheitert | Browser-Grenze 3 MB, Server-Grenze 8 MB; upload_max_filesize oder post_max_size zu klein | Serverwerte prüfen; beim Form Renderer maxFileSizeMB | Datei-Uploads |
| Der Form-Renderer zeigt nichts, wenn die Seite per Doppelklick geöffnet wird | render.js lädt die Formular-JSON per fetch | Seite von einem Server oder aus der Vorschau öffnen | Zusammenspiel |
| Eine Regel macht ein Feld immer sichtbar | eine Bedingungsgruppe ohne Bedingungen gilt als erfüllt | leere Gruppen entfernen | Regeln |
| Google Font oder hCaptcha laden ohne Zustimmung | data-customfont und hcaptcha binden Fremddienste ein, der Cookie-Consent sperrt sie nicht | customFont leer lassen; in der Datenschutzerklärung nennen | Der Form-Renderer-Block, hCaptcha |
config.php zeigt das SMTP-Passwort | die Datei enthält es im Klartext | nur über PHP ausliefern, eigenes Postfach für den Versand | config.php |
Medien, Datenschutz und Veröffentlichen#
| Symptom | Ursache | Lösung | Details |
|---|---|---|---|
| YouTube/Vimeo-Hintergrundvideo lädt bei eingeschaltetem Cookie-Consent erst nach einem Klick auf „Marketing“ | ab Version 1.3.100 wartet vendor/vn-bgvideo auf die Zustimmung zu „Marketing“ (Ersatzbild bleibt stehen); ohne Cookie-Consent auf der Seite lädt es sofort | gewollt; für Hintergründe ohne Einwilligung eine eigene Videodatei | Wiedergabe auf der Seite, Ereignis vn-cc-consent |
| Ein eigener Anbieter-Iframe oder ein Skript lädt trotz Cookie-Consent sofort | nur bekannte Anbieter (Google Maps, YouTube, Vimeo ab 1.3.100, Google Analytics/Tag Manager, Facebook) werden automatisch gesperrt | data-vn-consent-category="functional|statistics|marketing" setzen | Automatisches Sperren, Datenschutz |
| Das Hintergrundvideo nimmt die YouTube-Adresse, obwohl eine Datei gewählt ist | das Template setzt data-bg-video immer aus videoUrl | nicht beide eintragen | Der Baustein Video-Hintergrund |
| Der Block erzeugt eigene Fremdverbindungen (CDN, Webschriften) | alles Fremde muss mitgeliefert werden | Dateien in das Paket, kein CDN | Mitgelieferte Bibliotheken, Datenschutz |
| Der VN Übersetzer übersetzt ein Wort trotzdem | translate="no" wird nicht beachtet | Klasse notranslate | Ausnahmen markieren |
| PHP im Block läuft nicht | die Seite heißt .html; das Programm benennt sie nicht um, es meldet nur | Seite auf .php stellen | Seiten und Dateinamen |
| Export bricht mit „Ungültiger Dateiname“ ab | Seitenname nicht ^[a-z0-9_-]+\.(html|php)$ | nur Kleinbuchstaben, Ziffern, _, - | Seiten und Dateinamen |
| Der Server hat noch alte Dateien | das Programm löscht auf dem Server nichts | nicht mehr benötigte Dateien selbst entfernen | Veröffentlichen per FTP |
| In der Vorschau geht Mail nicht hinaus | Mails gehen als .eml-Dateien an einen lokalen Mail-Fänger | im echten Export und auf dem Server testen | Vorschau und Export |
Erweiterungen#
| Symptom | Ursache | Lösung | Details |
|---|---|---|---|
| Ein Update erscheint als zweites Werkzeug | die id wurde geändert | id nie ändern | manifest.json |
| Nach einer Änderung läuft noch der alte Code | das Programm hält importierte Module bis zum Neustart; nur tool.js bekommt die Änderungszeit als ?v= | ?v= an importierten Dateien hochzählen, version erhöhen, Programm neu starten | Lebenszyklus |
ctx.project… ist undefined | ältere Programmversion | Einträge vor dem Benutzen prüfen | Die Schnittstelle ctx |
| „Ungültige Datei im Export-Beitrag“ | Pfad nicht unter assets/<eigene id>/…, zu lang oder zu große Datei | Pfade und Grenzen einhalten (30 Dateien, 400000 Zeichen) | exportContribution |
Ein Passwort mit $ kommt in PHP falsch an | vor Version 1.3.100 maskiert {{secret-php:NAME}} das $ nicht; ab Version 1.3.100 geschieht das (nur in PHP-Strings mit doppelten Anführungszeichen) | Platzhalter in "…" setzen; für ältere Versionen Werte ohne $ | secrets |
| Der Editor verhält sich seltsam, nachdem die Erweiterung Seitenobjekte verändert hat | ctx.getPages() liefert Arbeitsobjekte, keine Kopien | nur lesen, Änderungen über ctx.project/ctx.blocks | Die Schnittstelle ctx, Sicherheitsregeln |
Das data/-Verzeichnis der Erweiterung ist abrufbar | das Programm schreibt keine .htaccess für Beiträge | der PHP-Code legt den Schutz selbst an | PHP-Server-Teile |
| Die Galerie zeigt kein Vorschaubild der Erweiterung | die Vorschau wird nur im Paket gefunden | thumbnail.jpg im Paket | Bauen, prüfen, ausliefern |
| Datei bleibt nach dem Entfernen des Beitrags auf dem Server | das Programm löscht auf dem Server nichts | selbst entfernen | exportContribution |