VN-Designer Entwickler-Dokumentation
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 camelCase aus Buchstaben und Ziffern, kein Bindestrich, kein Umlaut, kein Unterstrich am Anfang (name, Automatische Bereiche).
  • ☐ Farbvorgaben sechsstellig (#ffffff), Schieber-Vorgaben auf dem Raster min + n × step, Bildvorgaben als ../_images/<datei> (color, range, image).
  • ☐ Bedingungen mit Texten und Zahlen als Vergleich oder !!name schreiben; Schieber-Werte sind Text, gerechnet wird mit Number(n) (vn-if, Ausdrücke).
  • ☐ Das Wort overlay nur 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-face mit 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 mit e() oder ~"@{…}"; keine BOM, kein @import, kein default() (Prüfliste LESS).
  • ☐ Kein body, html oder :root im 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).
  • ☐ !important nur gezielt (Buttons, Links) und danach in der Live-Vorschau (F5) gegengeprüft: im Editor verliert es gegen !important von 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

Formulare, Medien, Datenschutz

Theme oder Paket#

  • ☐ Dateien als UTF-8 ohne BOM; ZIP mit Schrägstrichen (eingebautes tar.exe oder Python, nicht Compress-Archive der Windows PowerShell 5.1) (Als Paket packen).
  • ☐ params.json: name, eindeutiger alias und title, components mit path, _group, _title (params.json).
  • ☐ Bilder in components/_images/ und als ../_images/<datei> verwiesen; keine Videos, kein avif (components/_images, Bilder und Dateinamen).
  • ☐ Menü und Fußzeile mit global once="menu" und global once="footers" am allerersten Element (Seitenweite Blöcke, global).
  • ☐ thumb.png je Baustein, thumbnail.jpg im Paket für die Galerie (thumb.png, thumbnail.jpg).
  • ☐ Theme-CSS ohne @scope und @layer; für oberste Ebene :scope statt :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, title nur 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änderte id; version bei 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, kein innerHTML mit Rohdaten (Sicherheitsregeln).
  • ☐ Beitrag auf null stellen und erneut exportieren: Dateien müssen verschwinden (Bauen, prüfen, ausliefern).
  • ☐ thumbnail.jpg im 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#

SymptomUrsacheLösungDetails
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 speichernOrdner und Dateien, Fehler im LESS
Paket wird abgelehntcomponents fehlt oder ist leer; appScript ohne components; params.json fehltcomponents mit mindestens einem Eintragparams.json
Hintergrund- oder Feldbild fehlt nach dem ImportVorgabe file:///… zeigt auf den Rechner des AutorsBilder in components/_images/, Vorgabe ../_images/<datei>image, Bilder und Dateinamen
Video oder avif im Paket fehltaus _images werden nur jpg, jpeg, png, gif, svg, webp entpacktVideos nicht ins Paket; Nutzer wählt Datei oder Adresse im Feld „Video“components/_images
script.js neben dem Baustein wirkt nichtder Import liest nur template.html, style.less/style.css, thumb.pngJavaScript als <script> in template.htmlKeine Skriptdatei je Baustein
Erneuter Import legt einen weiteren Eintrag an; ein Block auf der Seite ändert sich nichtjeder Import ist ein neuer Eintrag; vorhandene Blöcke behalten ihre gespeicherte VorlageBaustein neu einfügen; zum Testen den Code-Editor benutzenWeiterarbeiten
Theme-CSS wird bei erneutem Import nicht aktualisiertdie Kennung vn-theme-css-<title> ist im Projekt schon vorhanden: nichts wird neu geladen; Pakete mit gleichem title teilen sich ein Theme-CSSTheme-CSS vor dem ersten Import prüfen; in einem neuen Projekt gilt das neue CSSNur einmal pro Projekt
Farben oder Buttons zweier Themes kollidierenTheme-CSS und Bootstrap-Klassen wirken auf der ganzen Seite, nicht nur im Block; gleiche Klassennameneigene Klassen mit Präfix je Theme; title eindeutigBootstrap 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 ProjektGruppennamen bewusst wählen (menu, footers oder eigener Name)once, Seitenweite Blöcke
global wird nicht erkannt; once wirkt nichtglobal 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 Wirkungglobal und once an das Wurzelelementglobal
Baustein zeigt kein Vorschaubildthumb.png fehlt; die Galerie liest thumbnail.jpg, das Programm nichtthumb.png je Baustein, thumbnail.jpg fürs Paketthumb.png, thumbnail.jpg
Videodatei fehlt im weitergegebenen Block (⇩ / ⤓)Verweise auf assets/… kommen ins Paket, beim Import werden aber nur Bilder entpacktVideo über Adresse (YouTube/Vimeo) oder Dateiwahl im BlockExport als .vndext
Anpassungen fehlen im exportierten Benutzerblock⇩ („Als .vndext-Datei exportieren“) nimmt die gespeicherte Vorlage unverändert⤓ im Eigenschaften-Panel verwendenExport als .vndext
Code-Knopf eines Baukasten-Blocks ist gesperrtBaukasten und Freie Fläche werden nur über „+“ und das Panel umgebautBlock im Reiter „Eigener Code“ bauen oder den Baukasten benutzenVerhältnis zum Code-Editor

Template und Eingabefelder#

SymptomUrsacheLösungDetails
Das CSS erreicht ein zweites Element auf oberster Ebene nichtnur das erste Element bekommt die Instanzklassealles in ein Wurzelelement packenDas Wurzelelement
Ein Feld erscheint nicht im Paneldas Feld steht nicht direkt in <vn-parameters>, hat keinen name oder steht in einem zweiten Parameterblockdirektes Kind, name setzen, nur ein BlockÜberblick
{{…}} ergibt überall leeren Text; vn-if blendet nichts ausein Feldname ist in JavaScript kein gültiger Bezeichner (Bindestrich, Punkt, Ziffer am Anfang, reserviertes Wort)camelCase aus Buchstaben und Ziffernname
Block zeigt „⚠ CSS-Fehler“ein Feldname mit Umlaut oder $ bricht das LESSName ohne Umlaut und $name
{{n + 1}} ergibt 41 statt 5die Werte von Schiebern sind TextNumber(n) + 1, n * 1range
Der Schieber zeigt einen anderen Wert als das LESS siehtdie Vorgabe liegt nicht auf dem Raster min + n × step; gespeichert bleibt die VorgabeVorgaben auf das Raster legenrange
Das Panel zeigt Schwarz statt der VorgabefarbeFarbe nicht sechsstellig (#fff, white)#rrggbbcolor
Ein Feld bleibt trotz condition sichtbarausgeblendet wird nur bei genau false; ein Fehler (Tippfehler im Namen) oder undefined zeigt das Feld; der Wert bleibt auch im verborgenen Feld erhaltenVergleich oder !!name schreiben; das Markup mit vn-if selbst abstimmencondition
Ein Element bleibt trotz vn-if stehenvn-if entfernt nur bei genau false; ein leerer Text, undefined oder ein Tippfehler lässt es stehen!!name oder Vergleich; bei Bedarf vn-strict-ifvn-if, vn-strict-if
vn-class mit berechnetem Namen bewirkt nichtsein Schlüssel wie {'n-' + mode: true} ist ein SyntaxfehlerTextform vn-class="'n-' + mode"vn-class
vn-style setzt --variable nichteigene Eigenschaften werden verworfenstyle="--k:{{k}}" oder Variable im LESS auf der Wurzelvn-style
Abdunklung (vn-overlay) liegt über Text oder Seitenkopfdie Fläche füllt das nächste positionierte ElternelementWurzel position: relative, Inhalt position: relative; z-index: 1vn-overlay
Overlay-Felder erscheinen ungewolltdas Wort overlay steht im Template (auch als Klasse oder Kommentar) und kein eigenes Feld overlay ist deklarierteigene Felder deklarieren oder das Wort vermeidenAutomatische Overlay-Felder
Ein Text aus dem Panel bricht das Markup oder wird als HTML gesetzt{{name}} setzt den Wert unmaskiert als HTML einin Attributen {{vnEnc(name)}}, sonst nur in Textinhalt{{name}}, vnEnc
{{ oder }} im Skript liefert Unsinn oder leeren Textjedes {{ … }} im Template wird als Ausdruck ausgewertet, auch im SkriptKlammern mit Leerzeichen ({ {) oder auf getrennten ZeilenPlatzhalter in Skripten
{{beschriftung}} steht wörtlich im Knopfin <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 btnPlatzhalter in Buttons, Platzhalter in Knöpfen
Ein geänderter Vorgabewert im Paket wirkt in vorhandenen Blöcken nichtdie Werte sind im Block gespeichertBaustein neu einfügenVorgabewerte
Zwei Felder verhalten sich wie einesgleicher name teilt sich einen Werteindeutige Namenname

Stil, LESS und CSS#

SymptomUrsacheLösungDetails
Block ohne jedes CSS, Etikett „⚠ CSS-Fehler“Fehler im LESS: @bg-type ohne Hintergrund-Widget, unbekannte Variable, @import, when (default()), offener BlockMeldung im Tooltip lesen; die Ursache behebenFehler im LESS, Hintergrund-Variablen
url(@bg-value) ergibt url(#f3f4f6)@bg-value bei Farbe ist eine Farbeimmer innerhalb when (@bg-type = 'image')Hintergrund-Variablen
Selektor .'grid'-x ist ungültig; aspect-ratio: '16/9' wird verworfenAuswahl- und Textwerte kommen als LESS-Text mit Anführungszeichen ane(@x) oder ~"@{x}"Werte als Text ausgeben
when (@text = abc) ist nie wahrTexte immer in Anführungszeichen vergleichen; Zahl gegen Text (= "2") ist nie wahr@x = 'abc', Zahlen ohne AnführungszeichenGleichsetzen und Bedingungen
Division ergibt ein falsches Ergebnis10px / 2 aus Literalen wird nicht umgeschriebenKlammern: (10px / 2), (@n / 2)Rechnen
body, html, :root im Block-LESS bewirken nichtssie 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 globalKürzel im NamenBereich und Wurzel
p { font-size: 3rem; } im Block wirkt nichtdie Schriftgröße Fließtext der Site setzt font-size an p, li … mit !importantGrößen auf div/span legen oder !important setzenSite-Einstellungen
Der Block sieht im Editor anders aus als im ExportLayer-Umkehr bei !important: im Editor verliert Block-!important gegen !important von Bootstrap und Theme, im Export gewinnt es; „Eigenes CSS“ liegt im Editor ohne Layerin der Live-Vorschau (F5) oder im Export prüfen; !important nur gezieltWer 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 ProgrammfenstersLive-Vorschau mit Tablet/HandyDie Falle #canvas
Button- oder Linkfarbe aus dem Block-LESS setzt sich nicht durchTheme-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üfenButtons und Links, Farben und Links im Block-CSS
Eine !important-Regel auf .btn überstimmt die „Eigene Farbe“ des Nutzersder 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 ändernBilder nur im LESS lassen sich nicht zuordnenBildfeld, Hintergrund-Widget oder Inline-StilHintergrundbild im Inline-Style
@primaryColor u. ä. ist „undefined“Theme-Variablen fehlen ohne Themeparams.theme.settings oder eigene FelderTheme-Variablen, Theme-Eigenschaften
Parallax wirkt am Handy nichtbackground-attachment: fixedBild so planen, dass es auch ohne Effekt gut aussiehtParallax

Bearbeitbare Inhalte#

SymptomUrsacheLösungDetails
Bearbeitungen landen am falschen ElementKennungen (t3, btn0 …) sind Positionsnummern aus dem Import; ein nachträglich geändertes Template oder von Hand gelöschte Kennungen verschieben sieKennungen nie von Hand ändern; Element hinten statt dazwischen einfügenÜberblick
Eine klickbare Karte (<a class="card">) wird zu einem einzigen Textfeldein loser Link ist das Feld, die Kinder zählen nichtKarte als div mit eigenem Link oder ButtonWelche Elemente werden Textfelder
Beschriftungen im <form> sind nicht anklickbarinnerhalb von form wird nichts als Textfeld erfasstFeldtexte im Code-Editor ändernWelche Elemente werden Textfelder
<button class="btn"> lässt sich nicht bearbeitennur <a class="btn"> ist ein Button<a class="btn" role="button">a.btn
Ein eigenes Attribut im Text verschwindet beim nächsten Speichernder Text-Sanitizer lässt nur eine Erlaubnisliste durchElement außerhalb von Textfeldern bauenErlaubte Attribute und Klassen
Ein Panel-Platzhalter verschwindet nach dem Bearbeiten des Textesein Textfeld mit Platzhalter wird beim Bearbeiten vollständig ersetztPanel-Wert und freien Text in getrennte ElementePlatzhalter im Text
Die Hamburger-Farbe wirkt nichtder Block benutzt ein eigenes Symbol statt .navbar-toggler-icon.navbar-toggler-icon verwendenHamburger-Symbol
Textfarbe und Effekte fehlen auf der fertigen Seite (CMS)im CMS-Text wird style entferntKlassen im Block-CSSBedienung und Sicherheit
CMS-Block ändert nichtsSeite heißt .html oder es ist kein Passwort gesetztSeite .php, Passwort im Programm setzenEinschalten
Bild-Griffe passen nichtBild ohne verlässlich bestimmbaren Behälter (inline, position:absolute)Hintergrund-Widget für füllende BilderBilder mit der Maus skalieren
Das Symbol ist nicht änderbarein SVG, <img> oder eine CSS-Maske ist kein änderbares Symbol<i class="bi bi-…"> oder data-vn-iconSymbole verhindern oder ausschließen

Skripte#

SymptomUrsacheLösungDetails
Panel-Änderungen sind im Editor unsichtbar (zum Beispiel „Schreibmaschine zeigt das neue Wort nicht“)if (closest('#canvas')) return; steht vor dem Setzen des AnfangszustandsAnfangszustand setzen, dann beendenRegeln für Skripte im Editor
Der Inhalt eines Blocks fehlt oder ist nicht anklickbardas Skript versteckt oder verschiebt DOM (opacity:0, Reveal, Karussell-Umbau) auch im Editorim Editor nichts verstecken oder verschiebenRegeln 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 gespeichertText-Aufteilung nur zur Laufzeit außerhalb von #canvas; im Template steht der ruhige TextText-Animationen zur Laufzeit, Regeln für Skripte im Editor
Neue Blöcke werden nie initialisiertder Init-Merker ist ein data--Attribut und ein altes Skript hat Elemente neuer Blöcke damit markiertMerker als JavaScript-Eigenschaft (box.vnInit = 1)Einmal-Initialisierung
Das Skript läuft nach dem ersten Neuzeichnen im Editor nie wieder anSchutzschalter an window (window.fertig) wird pro Render verworfen, auf der echten Seite bleibt erMerker am Elementwindow-Eigenschaften
Die zweite Instanz eines Blocks ist kaputtfeste IDs oder globaler ZustandKlassen, {{vn-id}}, NamensraumEinmal-Initialisierung
is-builder oder currentScript erkennt den Editor nichtdas Programm setzt is-builder nie; currentScript ist null; es gibt keinen iframeel.closest('#canvas'); Rückfall document.querySelector(…)Was nicht zur Erkennung taugt
bootstrap, vnCookieConsent, VNPopup sind undefineddas Block-Skript läuft beim Parsen, vor Bootstrap und den VN-Bibliothekenauf DOMContentLoaded wartenReihenfolge und Wartezeit
$ oder jQuery ist undefinedjQuery gibt es nur im Bootstrap-Theme-Modusreines JavaScriptjQuery und Theme-Plugins
import im <script type="module"> schlägt im Editor fehlder Editor führt Skripte in new Function ausklassisches SkriptFallen: Skript läuft im Editor
window.vnEnc ist undefinedvnEnc, vnEmbed und {{vn-id}} sind Hilfen des Template-Ausdrucks, keine globalen Funktionenim Template data-x="{{vnEnc(x)}}", im Skript decodeURIComponentText-Daten in Attributen
Ein Text in einer Attrappe (data-vn-editor-only) ist im Editor bearbeitbardie Attrappe ist im Editor ein normales Elementohne Fließtext anlegen oder damit rechnenMarker data-vn-editor-only

Formulare#

SymptomUrsacheLösungDetails
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 fehltform.vn-sform-form mit data-mailer, SMTP im Programm einrichtenBeispiel Kontaktformular, SMTP-Einstellungen
Mehrere Empfänger in data-recipient gehen nichtmailer.php akzeptiert genau eine Adresse je FormularWeiterleitung im Postfach oder mehrere FormulareEmpfä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 hochladenEmpfänger
Ein eigenes HTML-Formular über native-form-handler.php sendet an jede Adresseohne recipients.php (Export mit einer Version vor 1.3.100) gibt es keine Empfängerlisteab Version 1.3.100 neu exportieren und hochladen: dann nur Adressen der Liste und die Absenderadressenative-form-handler.php
Pflichtfelder lassen sich umgehen„Pflicht“ prüft nur der BrowserHoneypot und IP-Begrenzung zusätzlich; Pflicht nicht als SicherheitsmerkmalPflichtfelder
Die Sicherheitsabfrage lässt sich umgehender Server prüft sie nur, wenn Antwort oder Token mitgeschickt werdenzusätzlich Honeypot und IP-BegrenzungMathe-Sicherheitsabfrage
Datei-Upload scheitertBrowser-Grenze 3 MB, Server-Grenze 8 MB; upload_max_filesize oder post_max_size zu kleinServerwerte prüfen; beim Form Renderer maxFileSizeMBDatei-Uploads
Der Form-Renderer zeigt nichts, wenn die Seite per Doppelklick geöffnet wirdrender.js lädt die Formular-JSON per fetchSeite von einem Server oder aus der Vorschau öffnenZusammenspiel
Eine Regel macht ein Feld immer sichtbareine Bedingungsgruppe ohne Bedingungen gilt als erfülltleere Gruppen entfernenRegeln
Google Font oder hCaptcha laden ohne Zustimmungdata-customfont und hcaptcha binden Fremddienste ein, der Cookie-Consent sperrt sie nichtcustomFont leer lassen; in der Datenschutzerklärung nennenDer Form-Renderer-Block, hCaptcha
config.php zeigt das SMTP-Passwortdie Datei enthält es im Klartextnur über PHP ausliefern, eigenes Postfach für den Versandconfig.php

Medien, Datenschutz und Veröffentlichen#

SymptomUrsacheLösungDetails
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 sofortgewollt; für Hintergründe ohne Einwilligung eine eigene VideodateiWiedergabe auf der Seite, Ereignis vn-cc-consent
Ein eigener Anbieter-Iframe oder ein Skript lädt trotz Cookie-Consent sofortnur bekannte Anbieter (Google Maps, YouTube, Vimeo ab 1.3.100, Google Analytics/Tag Manager, Facebook) werden automatisch gesperrtdata-vn-consent-category="functional|statistics|marketing" setzenAutomatisches Sperren, Datenschutz
Das Hintergrundvideo nimmt die YouTube-Adresse, obwohl eine Datei gewählt istdas Template setzt data-bg-video immer aus videoUrlnicht beide eintragenDer Baustein Video-Hintergrund
Der Block erzeugt eigene Fremdverbindungen (CDN, Webschriften)alles Fremde muss mitgeliefert werdenDateien in das Paket, kein CDNMitgelieferte Bibliotheken, Datenschutz
Der VN Übersetzer übersetzt ein Wort trotzdemtranslate="no" wird nicht beachtetKlasse notranslateAusnahmen markieren
PHP im Block läuft nichtdie Seite heißt .html; das Programm benennt sie nicht um, es meldet nurSeite auf .php stellenSeiten und Dateinamen
Export bricht mit „Ungültiger Dateiname“ abSeitenname nicht ^[a-z0-9_-]+\.(html|php)$nur Kleinbuchstaben, Ziffern, _, -Seiten und Dateinamen
Der Server hat noch alte Dateiendas Programm löscht auf dem Server nichtsnicht mehr benötigte Dateien selbst entfernenVeröffentlichen per FTP
In der Vorschau geht Mail nicht hinausMails gehen als .eml-Dateien an einen lokalen Mail-Fängerim echten Export und auf dem Server testenVorschau und Export

Erweiterungen#

SymptomUrsacheLösungDetails
Ein Update erscheint als zweites Werkzeugdie id wurde geändertid nie ändernmanifest.json
Nach einer Änderung läuft noch der alte Codedas 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 startenLebenszyklus
ctx.project… ist undefinedältere ProgrammversionEinträge vor dem Benutzen prüfenDie Schnittstelle ctx
„Ungültige Datei im Export-Beitrag“Pfad nicht unter assets/<eigene id>/…, zu lang oder zu große DateiPfade und Grenzen einhalten (30 Dateien, 400000 Zeichen)exportContribution
Ein Passwort mit $ kommt in PHP falsch anvor 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 hatctx.getPages() liefert Arbeitsobjekte, keine Kopiennur lesen, Änderungen über ctx.project/ctx.blocksDie Schnittstelle ctx, Sicherheitsregeln
Das data/-Verzeichnis der Erweiterung ist abrufbardas Programm schreibt keine .htaccess für Beiträgeder PHP-Code legt den Schutz selbst anPHP-Server-Teile
Die Galerie zeigt kein Vorschaubild der Erweiterungdie Vorschau wird nur im Paket gefundenthumbnail.jpg im PaketBauen, prüfen, ausliefern
Datei bleibt nach dem Entfernen des Beitrags auf dem Serverdas Programm löscht auf dem Server nichtsselbst entfernenexportContribution