14
Pièges et liste de contrôle
Listes de contrôle à cocher avant de publier un bloc, un thème ou une extension, et un tableau de tous les pièges décrits dans les chapitres (symptôme, cause, solution) avec des renvois vers les entrées détaillées.
Liste de contrôle avant publication#
Parcourez la liste point par point avant de transmettre un bloc, un thème ou une extension, ou de le téléverser dans la galerie. Chaque point renvoie à l'entrée qui donne les détails.
Bloc#
Structure et champs de saisie
- ☐ Le modèle a un seul élément racine ;
<vn-parameters>s'y trouve, ne contient que des enfants directs et n'apparaît qu'une seule fois (L'élément racine, Vue d'ensemble des champs de saisie). - ☐ Noms de champs en
camelCasecomposés de lettres et de chiffres, sans trait d'union, sans tréma, sans trait de soulignement au début (name, Sections automatiques). - ☐ Valeurs par défaut des couleurs à six chiffres (
#ffffff), valeurs par défaut des curseurs sur la grillemin + n × step, valeurs par défaut des images sous la forme../_images/<fichier>(color, range, image). - ☐ Écrire les conditions portant sur des textes et des nombres sous forme de comparaison ou de
!!name; les valeurs des curseurs sont du texte, on calcule avecNumber(n)(vn-if, Expressions). - ☐ N'utiliser le mot
overlayque si les champs de superposition automatiques sont voulus, sinon déclarer ses propres champs (Champs de superposition automatiques). - ☐ Le texte issu du panneau ne figure dans des attributs que sous la forme
{{vnEnc(…)}}(vnEnc(texte), Données de texte dans des attributs : vnEnc). - ☐ Pas d'ID fixes : dans le bloc, renvoyer avec
{{vn-id}}, car le même bloc peut figurer plusieurs fois sur une page ({{vn-id}}).
Style
- ☐ Noms de classes propres,
@keyframeset@font-faceavec l'abréviation du bloc (Bootstrap et classes, Portée et racine). - ☐
@bg-…seulement avec un widget d'arrière-plan et à l'intérieur d'une condition sur@bg-type; valeurs de liste dans les sélecteurs avece()ou~"@{…}"; pas de BOM, pas de@import, pas dedefault()(Liste de contrôle). - ☐ Pas de
body,htmlni:rootdans le LESS du bloc ; poser les variables du bloc directement sur la racine (Portée et racine). - ☐ Fixer délibérément les tailles du texte courant (
p,li) : sinon la taille de police du site l'emporte (Réglages du site qui écrasent votre CSS). - ☐
!importantseulement de façon ciblée (boutons, liens), puis vérifié dans l'aperçu en direct (F5) : dans l'éditeur, il perd contre le!importantde Bootstrap et du thème (Qui l'emporte (mesuré), Couleurs et liens dans le CSS du bloc). - ☐ Vérifier les media queries dans l'aperçu en direct (tablette, téléphone), pas dans l'éditeur (Le piège
#canvasdans le CSS du thème).
Contenus modifiables
- ☐ Boutons sous la forme
<a class="btn">avec texte et cible fixes ; pas d'espaces réservés dans les boutons (Espaces réservés dans les boutons, a.btn). - ☐ Les valeurs du panneau et le texte librement modifiable se trouvent dans des éléments différents (Espaces réservés dans le texte).
- ☐ Images d'arrière-plan via un champ d'image, un widget d'arrière-plan ou un style en ligne, pas seulement dans le LESS (Image d’arrière-plan dans le style en ligne).
- ☐ Ne jamais modifier ni supprimer à la main les identifiants (
data-vn-text-id…) (Vue d’ensemble).
Scripts
- ☐ Marqueur d'initialisation comme propriété JavaScript de l'élément, pas comme attribut
data-(Initialisation unique). - ☐ Reconnaissance de l'éditeur uniquement avec
el.closest('#canvas'); poser l'état initial dépendant des paramètres avant de quitter (Reconnaissance avec el.closest('#canvas'), Règles pour les scripts dans l'éditeur). - ☐ Ne jamais réécrire le texte des champs de texte (
data-vn-text-id) ; effets de texte seulement à l'exécution (Animations de texte à l'exécution). - ☐ N'accéder à
bootstrap,vnCookieConsent,VNPopupqu'aprèsDOMContentLoaded; pas de jQuery (Ordre et attente, jQuery et plugins de thème (mode thème Bootstrap)). - ☐ Respecter « moins de mouvement » (Moins de mouvement).
Formulaires, médias, protection des données
- ☐ Formulaires avec
form.vn-sform-formetdata-mailer, jamais comme simple décor (Exemple : formulaire de contact dans un thème). - ☐ Ne rien charger de tiers (CDN, polices web, scripts) ; construire les intégrations de façon que le consentement aux cookies puisse les bloquer (Confidentialité, Blocage automatique).
- ☐ Vidéo d'arrière-plan : ne pas renseigner le fichier et l'adresse ; pour des arrière-plans sans consentement, utiliser un fichier vidéo propre (Le bloc « Arrière-plan vidéo » (vn-bgvid), Lecture sur la page).
- ☐ Tester dans l'export réel : ouvrir
publish/index.html, console sans erreur, onglet Réseau sans requêtes vers des serveurs tiers (Ce que les auteurs peuvent influencer).
Thème ou paquet#
- ☐ Fichiers en UTF-8 sans BOM ; ZIP avec barres obliques (
tar.exeintégré ou Python, pasCompress-Archivede Windows PowerShell 5.1) (2. Empaqueter). - ☐
params.json:name,aliasettitleuniques,componentsavecpath,_group,_title(params.json). - ☐ Images dans
components/_images/et référencées sous la forme../_images/<fichier>; pas de vidéos, pas d'avif(components/_images, Images et noms de fichier). - ☐ Menu et pied de page avec
global once="menu"etglobal once="footers"sur le tout premier élément (Blocs à l'échelle du site : global et once, global). - ☐
thumb.pngpour chaque bloc,thumbnail.jpgdans le paquet pour la galerie (thumb.png, thumbnail.jpg et l'aperçu de la galerie). - ☐ CSS du thème sans
@scopeni@layer; pour le niveau supérieur,:scopeau lieu de:root; polices sous forme de fichier dans le paquet (Dans l'éditeur : layer et scope, Le piège#canvasdans le CSS du thème, Polices et images dans le CSS du thème). - ☐ Après le premier import dans un projet, le CSS du thème ne peut plus être renouvelé : vérifier soigneusement, ne modifier
titleque de façon délibérée (Une seule fois par projet). - ☐ Abréviations de classes propres à chaque thème, pour que des thèmes mélangés ne s'écrasent pas (Bootstrap et classes).
- ☐ Importer le paquet dans un nouveau projet, insérer chaque bloc, exporter (Liste de contrôle avant diffusion).
- ☐ Textes d'exemple sans noms réels, adresses uniquement
example.com.
Extension#
- ☐
manifest.json:idvalide, jamais modifiée ; augmenterversionà chaque modification (manifest.json). - ☐ Intégrer les modules importés (
dom.js,payload.js…) avec un?v=incrémenté (Cycle de vie). - ☐ Gérer l'absence d'entrées de
ctx(version plus ancienne du programme) (L'interface ctx). - ☐ Contribution à l'export uniquement sous
assets/<propre id>/…, 30 fichiers au maximum, 400000 caractères chacun (exportContribution). - ☐ Secrets uniquement via
ctx.project.secrets;{{secret-php:NAME}}seulement dans des chaînes PHP entre guillemets doubles (à partir de la version 1.3.100,$est aussi masqué) (secrets). - ☐ Parties serveur PHP : PHP 7.3 et plus récent,
php -l, protéger soi-mêmedata/, vérifier les entrées, masquer les sorties (Parties serveur PHP). - ☐ Pas de serveur tiers, pas d'
eval, pas d'innerHTMLavec des données brutes (Règles de sécurité). - ☐ Mettre la contribution sur
nullet exporter à nouveau : les fichiers doivent disparaître (Construire, vérifier, livrer). - ☐
thumbnail.jpgdans le paquet si l'extension doit aller dans la galerie (Galerie).
Les pièges en un coup d'œil#
Chaque tableau regroupe les pièges d'un domaine : à quoi on les reconnaît, d'où ils viennent, ce qui aide et où se trouvent les détails.
Paquet, import et fichiers#
| Symptôme | Cause | Solution | Détails |
|---|---|---|---|
| L'import signale « template.html introuvable sous components/… » | ZIP avec antislashs (Compress-Archive de Windows PowerShell 5.1, ZipFile.CreateFromDirectory de .NET Framework) | empaqueter avec tar.exe ou Python (chemins avec /) | 2. Empaqueter |
| L'import signale « params.json n'est pas un JSON valide » ; bloc avec « ⚠ Erreur CSS » | BOM au début de params.json ou de style.less (Set-Content -Encoding UTF8 de PowerShell 5.1) | enregistrer en UTF-8 sans BOM | 1. Créer le dossier et les fichiers, Erreurs dans le LESS |
| Le paquet est refusé | components manque ou est vide ; appScript sans components ; params.json manque | components avec au moins une entrée | params.json |
| L'image d'arrière-plan ou de champ manque après l'import | la valeur par défaut file:///… pointe vers l'ordinateur de l'auteur | images dans components/_images/, valeur par défaut ../_images/<fichier> | image, Images et noms de fichier |
La vidéo ou l'avif manque dans le paquet | de _images, seuls jpg, jpeg, png, gif, svg, webp sont extraits | ne pas mettre de vidéos dans le paquet ; l'utilisateur choisit un fichier ou une adresse dans le champ « Vidéo » | components/_images |
Un script.js à côté du bloc n'a aucun effet | l'import ne lit que template.html, style.less/style.css, thumb.png | JavaScript sous forme de <script> dans template.html | Aucun fichier de script par bloc |
| Un nouvel import crée une entrée de plus ; un bloc de la page ne change pas | chaque import est une nouvelle entrée ; les blocs existants conservent leur modèle enregistré | insérer à nouveau le bloc ; pour tester, utiliser l'éditeur de code | 5. Continuer à travailler |
| Le CSS du thème n'est pas mis à jour lors d'un nouvel import | l'identifiant vn-theme-css-<title> existe déjà dans le projet : rien n'est rechargé ; les paquets de même title partagent un CSS de thème | vérifier le CSS du thème avant le premier import ; dans un nouveau projet, le nouveau CSS s'applique | Une seule fois par projet |
| Les couleurs ou les boutons de deux thèmes entrent en collision | le CSS du thème et les classes Bootstrap agissent sur toute la page, pas seulement dans le bloc ; noms de classes identiques | classes propres avec préfixe par thème ; title unique | Bootstrap et classes, Enregistrement et auto-réparation |
| Un menu nouvellement inséré remplace l'ancien (ou le pied de page) | de chaque groupe once, il n'y a qu'un seul bloc au maximum dans le projet | choisir délibérément les noms de groupe (menu, footers ou un nom propre) | once, Blocs à l'échelle du site : global et once |
global n'est pas reconnu ; once n'a aucun effet | global doit figurer sur le tout premier élément du fichier (un bloc <vn-parameters> placé devant ou un div englobant empêche la reconnaissance) ; once sans global est sans effet | global et once sur l'élément racine | global |
| Le bloc n'affiche pas d'aperçu | thumb.png manque ; la galerie lit thumbnail.jpg, le programme non | thumb.png pour chaque bloc, thumbnail.jpg pour le paquet | thumb.png, thumbnail.jpg et l'aperçu de la galerie |
| Le fichier vidéo manque dans le bloc transmis (⇩ / ⤓) | les renvois vers assets/… entrent dans le paquet, mais à l'import seules les images sont extraites | vidéo via une adresse (YouTube/Vimeo) ou choix d'un fichier dans le bloc | Export en .vndext |
| Les personnalisations manquent dans le bloc utilisateur exporté | ⇩ (« Exporter en fichier .vndext ») prend le modèle enregistré sans modification | utiliser ⤓ dans le panneau des propriétés | Export en .vndext |
| Le bouton de code d'un bloc du constructeur est verrouillé | le constructeur et la surface libre ne se transforment que via « + » et le panneau | construire le bloc dans l'onglet « Code personnalisé » ou utiliser le constructeur | Rapport avec l’éditeur de code |
Modèle et champs de saisie#
| Symptôme | Cause | Solution | Détails |
|---|---|---|---|
| Le CSS n'atteint pas un deuxième élément de niveau supérieur | seul le premier élément reçoit la classe d'instance | tout placer dans un seul élément racine | L'élément racine |
| Un champ n'apparaît pas dans le panneau | le champ ne se trouve pas directement dans <vn-parameters>, n'a pas de name ou se trouve dans un second bloc de paramètres | enfant direct, définir name, un seul bloc | Vue d'ensemble |
{{…}} donne partout un texte vide ; vn-if ne masque rien | un nom de champ n'est pas un identificateur JavaScript valide (trait d'union, point, chiffre au début, mot réservé) | camelCase composé de lettres et de chiffres | name |
| Le bloc affiche « ⚠ Erreur CSS » | un nom de champ avec tréma ou $ casse le LESS | nom sans tréma ni $ | name |
{{n + 1}} donne 41 au lieu de 5 | les valeurs des curseurs sont du texte | Number(n) + 1, n * 1 | range |
| Le curseur affiche une autre valeur que celle que voit le LESS | la valeur par défaut n'est pas sur la grille min + n × step ; c'est la valeur par défaut qui reste enregistrée | placer les valeurs par défaut sur la grille | range |
| Le panneau affiche du noir au lieu de la couleur par défaut | couleur non à six chiffres (#fff, white) | #rrggbb | color |
Un champ reste visible malgré condition | il n'est masqué que pour exactement false ; une erreur (faute de frappe dans le nom) ou undefined affiche le champ ; la valeur est conservée même dans le champ masqué | écrire une comparaison ou !!name ; accorder soi-même le balisage avec vn-if | condition |
Un élément reste en place malgré vn-if | vn-if ne retire que pour exactement false ; un texte vide, undefined ou une faute de frappe le laisse en place | !!name ou une comparaison ; si besoin vn-strict-if | vn-if, vn-strict-if |
vn-class avec un nom calculé n'a aucun effet | une clé comme {'n-' + mode: true} est une erreur de syntaxe | forme texte vn-class="'n-' + mode" | vn-class |
vn-style ne pose pas --variable | les propriétés personnalisées sont rejetées | style="--k:{{k}}" ou variable dans le LESS sur la racine | vn-style |
L'assombrissement (vn-overlay) recouvre le texte ou l'en-tête de page | la surface remplit l'élément parent positionné le plus proche | racine position: relative, contenu position: relative; z-index: 1 | vn-overlay |
| Des champs de superposition apparaissent sans qu'on les veuille | le mot overlay figure dans le modèle (même comme classe ou commentaire) et aucun champ overlay propre n'est déclaré | déclarer ses propres champs ou éviter le mot | Champs de superposition automatiques |
| Un texte du panneau casse le balisage ou est posé comme HTML | {{name}} insère la valeur sans masquage, comme HTML | dans les attributs {{vnEnc(name)}}, sinon seulement dans le contenu de texte | {{name}}, vnEnc(texte) |
{{ ou }} dans le script donne n'importe quoi ou un texte vide | chaque {{ … }} du modèle est évalué comme une expression, même dans le script | accolades avec un espace ({ {) ou sur des lignes séparées | Espaces réservés dans les scripts et les attributs |
{{beschriftung}} apparaît tel quel dans le bouton | dans <a class="btn">, les espaces réservés du texte et de href ne sont pas évalués (éditeur et export) | texte et cible fixes dans le modèle ; pour des valeurs du panneau, un lien ordinaire sans btn | Espaces réservés dans les boutons, Espaces réservés dans les boutons |
| Une valeur par défaut modifiée dans le paquet n'agit pas dans les blocs existants | les valeurs sont enregistrées dans le bloc | insérer à nouveau le bloc | Valeurs par défaut |
| Deux champs se comportent comme un seul | un même name partage une valeur | noms uniques | name |
Style, LESS et CSS#
| Symptôme | Cause | Solution | Détails |
|---|---|---|---|
| Bloc sans aucun CSS, étiquette « ⚠ Erreur CSS » | erreur dans le LESS : @bg-type sans widget d'arrière-plan, variable inconnue, @import, when (default()), bloc ouvert | lire le message dans l'info-bulle ; supprimer la cause | Erreurs dans le LESS, Variables d'arrière-plan |
url(@bg-value) donne url(#f3f4f6) | pour une couleur, @bg-value est une couleur | toujours à l'intérieur de when (@bg-type = 'image') | Variables d'arrière-plan |
Le sélecteur .'grid'-x est invalide ; aspect-ratio: '16/9' est rejeté | les valeurs de liste et de texte arrivent comme texte LESS entre guillemets | e(@x) ou ~"@{x}" | Sortir des valeurs comme texte en CSS |
when (@text = abc) n'est jamais vrai | toujours comparer les textes entre guillemets ; un nombre contre un texte (= "2") n'est jamais vrai | @x = 'abc', nombres sans guillemets | Comparaisons et conditions |
| La division donne un résultat faux | 10px / 2 issu de littéraux n'est pas réécrit | parenthèses : (10px / 2), (@n / 2) | Calculer |
body, html, :root dans le LESS du bloc n'ont aucun effet | ils se retrouvent derrière la classe d'instance (.wurzel :root) | poser les variables sur la racine ; règles valables pour tout le site dans le CSS du thème ou « CSS personnalisé » | Portée et racine |
| Deux blocs écrasent mutuellement leur animation ou leur police | @keyframes et @font-face sont globaux | abréviation dans le nom | Portée et racine |
p { font-size: 3rem; } dans le bloc n'agit pas | la taille de police du corps de texte du site pose font-size sur p, li … avec !important | placer les tailles sur div/span ou mettre !important | Réglages du site qui écrasent votre CSS |
| Le bloc a un autre aspect dans l'éditeur que dans l'export | inversion des couches avec !important : dans l'éditeur, le !important du bloc perd contre le !important de Bootstrap et du thème, dans l'export il l'emporte ; le « CSS personnalisé » se trouve sans couche dans l'éditeur | vérifier dans l'aperçu en direct (F5) ou dans l'export ; !important seulement de façon ciblée | Qui l'emporte (mesuré) |
| Une règle du CSS du thème n'agit pas dans l'éditeur | #canvas .x, html, body, :root dans le @scope ne touchent rien | .x ; pour l'éditeur :scope#canvas .x ; pour les variables :scope { … } | Le piège #canvas dans le CSS du thème |
| Les media queries basculent « mal » dans l'éditeur | dans l'éditeur, c'est la largeur de la fenêtre du programme qui compte | aperçu en direct avec tablette/téléphone | Le piège #canvas dans le CSS du thème |
| La couleur de bouton ou de lien du LESS du bloc ne s'impose pas | le CSS du thème de spécificité plus élevée ou les règles de police du site l'emportent | !important pour les couleurs, bordures, police des boutons et des liens ; vérifier dans l'export | Boutons et liens, Couleurs et liens dans le CSS du bloc |
Une règle !important sur .btn l'emporte sur la « couleur personnalisée » de l'utilisateur | la boîte de dialogue pose la couleur comme style en ligne sans !important et retire la classe de couleur | !important sur la classe de couleur (.btn-primary) | Couleur personnalisée |
Une image d'arrière-plan de style.less ne se change pas d'un clic | les images présentes seulement dans le LESS ne peuvent pas être associées | champ d'image, widget d'arrière-plan ou style en ligne | Image d’arrière-plan dans le style en ligne |
@primaryColor et similaires sont « undefined » | les variables de thème manquent sans thème | params.theme.settings ou champs propres | Variables de thème, Propriétés du thème (params.theme) |
| La parallaxe n'agit pas sur téléphone | background-attachment: fixed | prévoir l'image de sorte qu'elle soit aussi bien sans l'effet | Parallaxe |
Contenus modifiables#
| Symptôme | Cause | Solution | Détails |
|---|---|---|---|
| Les modifications atterrissent sur le mauvais élément | les identifiants (t3, btn0 …) sont des numéros de position issus de l'import ; un modèle modifié après coup ou des identifiants supprimés à la main les décalent | ne jamais modifier les identifiants à la main ; ajouter un élément à la fin plutôt qu'au milieu | Vue d’ensemble |
Une carte cliquable (<a class="card">) devient un seul champ de texte | un lien isolé est le champ, les enfants ne comptent pas | carte sous forme de div avec son propre lien ou bouton | Quels éléments deviennent des champs de texte |
Les libellés dans le <form> ne sont pas cliquables | à l'intérieur de form, rien n'est saisi comme champ de texte | modifier les textes des champs dans l'éditeur de code | Quels éléments deviennent des champs de texte |
<button class="btn"> ne peut pas être modifié | seul <a class="btn"> est un bouton | <a class="btn" role="button"> | a.btn |
| Un attribut propre dans le texte disparaît à l'enregistrement suivant | le nettoyeur de texte ne laisse passer qu'une liste d'autorisations | construire l'élément en dehors des champs de texte | Attributs et classes autorisés |
| Un espace réservé du panneau disparaît après la modification du texte | un champ de texte contenant un espace réservé est entièrement remplacé lors de la modification | valeur du panneau et texte libre dans des éléments séparés | Espaces réservés dans le texte |
| La couleur du hamburger n'agit pas | le bloc utilise une icône propre au lieu de .navbar-toggler-icon | utiliser .navbar-toggler-icon | Icône hamburger |
| La couleur du texte et les effets manquent sur la page terminée (CMS) | dans le texte du CMS, style est retiré | classes dans le CSS du bloc | Utilisation et sécurité sur la page |
| Le bloc CMS ne change rien | la page s'appelle .html ou aucun mot de passe n'est défini | page .php, définir le mot de passe dans le programme | Activation |
| Les poignées d'image ne conviennent pas | image sans conteneur déterminable de façon fiable (en ligne, position:absolute) | widget d'arrière-plan pour les images qui remplissent | Redimensionner les images avec la souris |
| L'icône n'est pas modifiable | un SVG, un <img> ou un masque CSS n'est pas une icône modifiable | <i class="bi bi-…"> ou data-vn-icon | Empêcher ou exclure des icônes |
Scripts#
| Symptôme | Cause | Solution | Détails |
|---|---|---|---|
| Les modifications du panneau sont invisibles dans l'éditeur (par exemple « la machine à écrire n'affiche pas le nouveau mot ») | if (closest('#canvas')) return; se trouve avant la pose de l'état initial | poser l'état initial, puis quitter | Règles pour les scripts dans l'éditeur |
| Le contenu d'un bloc manque ou n'est pas cliquable | le script masque ou déplace du DOM (opacity:0, reveal, transformation en carrousel) même dans l'éditeur | dans l'éditeur, ne rien masquer ni déplacer | Règles pour les scripts dans l'éditeur |
| Le texte d'un champ de texte est « détruit » après la saisie | le script réécrit le contenu d'un élément data-vn-text-id (spans de lettres) ; pendant la saisie, l'état intermédiaire est enregistré | découpage du texte seulement à l'exécution en dehors de #canvas ; le modèle contient le texte au repos | Animations de texte à l'exécution, Règles pour les scripts dans l'éditeur |
| Les nouveaux blocs ne sont jamais initialisés | le marqueur d'initialisation est un attribut data- et un ancien script a ainsi marqué des éléments de nouveaux blocs | marqueur comme propriété JavaScript (box.vnInit = 1) | Initialisation unique |
| Le script ne redémarre jamais après le premier nouveau dessin dans l'éditeur | l'interrupteur de protection sur window (window.fertig) est rejeté à chaque rendu, alors qu'il subsiste sur la vraie page | marqueur sur l'élément | Les propriétés de window ne valent que pour une passe |
| La deuxième instance d'un bloc est cassée | ID fixes ou état global | classes, {{vn-id}}, espace de noms | Initialisation unique |
is-builder ou currentScript ne reconnaît pas l'éditeur | le programme ne pose jamais is-builder ; currentScript vaut null ; il n'y a pas d'iframe | el.closest('#canvas') ; repli document.querySelector(…) | Ce qui ne convient pas à la reconnaissance |
bootstrap, vnCookieConsent, VNPopup sont undefined | le script du bloc s'exécute pendant l'analyse, avant Bootstrap et les bibliothèques VN | attendre DOMContentLoaded | Ordre et attente |
$ ou jQuery est undefined | jQuery n'existe que dans le mode thème Bootstrap | JavaScript pur | jQuery et plugins de thème (mode thème Bootstrap) |
import dans <script type="module"> échoue dans l'éditeur | l'éditeur exécute les scripts dans new Function | script classique | Pièges : le script s'exécute dans l'éditeur et détruit du contenu |
window.vnEnc est undefined | vnEnc, vnEmbed et {{vn-id}} sont des aides de l'expression du modèle, pas des fonctions globales | dans le modèle data-x="{{vnEnc(x)}}", dans le script decodeURIComponent | Données de texte dans des attributs : vnEnc |
Un texte dans un leurre (data-vn-editor-only) est modifiable dans l'éditeur | dans l'éditeur, le leurre est un élément normal | le créer sans texte courant ou en tenir compte | Marqueur data-vn-editor-only |
Formulaires#
| Symptôme | Cause | Solution | Détails |
|---|---|---|---|
| Le formulaire n'envoie rien (« Le formulaire n'est pas encore configuré » ou inerte) | sans form.vn-sform-form, l'export ne livre ni script, ni PHP, ni configuration ; SMTP n'est pas configuré ; data-mailer manque | form.vn-sform-form avec data-mailer, configurer SMTP dans le programme | Exemple : formulaire de contact dans un thème, Paramètres SMTP dans le programme |
Plusieurs destinataires dans data-recipient ne fonctionnent pas | mailer.php n'accepte qu'une seule adresse par formulaire | redirection dans la boîte aux lettres ou plusieurs formulaires | Destinataires |
| « Ce destinataire n'est pas autorisé pour le formulaire » | l'adresse ne figure pas dans recipients.php (l'export l'écrit à partir des pages exportées) | exporter à nouveau la page et la téléverser | Destinataires |
Un formulaire HTML propre via native-form-handler.php envoie à n'importe quelle adresse | sans recipients.php (export avec une version antérieure à 1.3.100), il n'y a pas de liste de destinataires | à partir de la version 1.3.100, exporter à nouveau et téléverser : alors seulement les adresses de la liste et l'adresse de l'expéditeur | native-form-handler.php |
| Les champs obligatoires peuvent être contournés | « Obligatoire » n'est vérifié que par le navigateur | piège à robots et limitation par IP en plus ; ne pas utiliser « obligatoire » comme mesure de sécurité | Champs obligatoires |
| La question de sécurité peut être contournée | le serveur ne la vérifie que si la réponse ou le jeton sont envoyés | en plus piège à robots et limitation par IP | Question de sécurité mathématique |
| L'envoi de fichier échoue | limite du navigateur 3 Mo, limite du serveur 8 Mo ; upload_max_filesize ou post_max_size trop petit | vérifier les valeurs du serveur ; pour le Form Renderer maxFileSizeMB | Envoi de fichiers |
| Le Form Renderer n'affiche rien quand la page est ouverte par double-clic | render.js charge le JSON du formulaire par fetch | ouvrir la page depuis un serveur ou depuis l'aperçu | Fonctionnement d'ensemble |
| Une règle rend un champ toujours visible | un groupe de conditions sans conditions est considéré comme rempli | supprimer les groupes vides | Règles |
| Google Font ou hCaptcha se chargent sans consentement | data-customfont et hcaptcha intègrent des services tiers, le consentement aux cookies ne les bloque pas | laisser customFont vide ; le mentionner dans la politique de confidentialité | Le bloc Form Renderer, hCaptcha (Form Renderer uniquement) |
config.php affiche le mot de passe SMTP | le fichier le contient en clair | ne le livrer que via PHP, boîte aux lettres propre pour l'envoi | config.php |
Médias, protection des données et publication#
| Symptôme | Cause | Solution | Détails |
|---|---|---|---|
| L'arrière-plan vidéo YouTube/Vimeo ne se charge, quand le consentement aux cookies est activé, qu'après un clic sur « Marketing » | à partir de la version 1.3.100, vendor/vn-bgvideo attend le consentement à « Marketing » (l'image de remplacement reste affichée) ; sans consentement aux cookies sur la page, il se charge immédiatement | voulu ; pour des arrière-plans sans consentement, un fichier vidéo propre | Lecture sur la page, Événement vn-cc-consent |
| Un iframe ou un script d'un fournisseur propre se charge immédiatement malgré le consentement aux cookies | seuls les fournisseurs connus (Google Maps, YouTube, Vimeo à partir de 1.3.100, Google Analytics/Tag Manager, Facebook) sont bloqués automatiquement | poser data-vn-consent-category="functional|statistics|marketing" | Blocage automatique, Confidentialité |
| L'arrière-plan vidéo prend l'adresse YouTube bien qu'un fichier soit choisi | le modèle pose toujours data-bg-video à partir de videoUrl | ne pas renseigner les deux | Le bloc « Arrière-plan vidéo » (vn-bgvid) |
| Le bloc crée ses propres connexions vers des tiers (CDN, polices web) | tout ce qui est externe doit être fourni avec | fichiers dans le paquet, pas de CDN | Bibliothèques fournies, Confidentialité |
| Le VN Traducteur traduit tout de même un mot | translate="no" n'est pas pris en compte | classe notranslate | Marquer des exceptions |
| Le PHP dans le bloc ne s'exécute pas | la page s'appelle .html ; le programme ne la renomme pas, il se contente de le signaler | passer la page en .php | Pages et noms de fichier |
| L'export s'interrompt avec « Nom de fichier non valide » | nom de page ne correspondant pas à ^[a-z0-9_-]+\.(html|php)$ | uniquement minuscules, chiffres, _, - | Pages et noms de fichier |
| Le serveur contient encore d'anciens fichiers | le programme ne supprime rien sur le serveur | supprimer soi-même les fichiers qui ne sont plus nécessaires | Publier par FTP |
| Dans l'aperçu, le courriel ne part pas | les courriels partent sous forme de fichiers .eml vers un collecteur de courriels local | tester dans l'export réel et sur le serveur | Aperçu et exportation |
Extensions#
| Symptôme | Cause | Solution | Détails |
|---|---|---|---|
| Une mise à jour apparaît comme un deuxième outil | l'id a été modifiée | ne jamais modifier l'id | manifest.json |
| Après une modification, l'ancien code tourne encore | le programme conserve les modules importés jusqu'au redémarrage ; seul tool.js reçoit l'heure de modification sous forme de ?v= | incrémenter ?v= sur les fichiers importés, augmenter version, redémarrer le programme | Cycle de vie |
ctx.project… est undefined | version plus ancienne du programme | vérifier les entrées avant de les utiliser | L'interface ctx |
| « Fichier non valide dans la contribution à l'export » | chemin hors de assets/<propre id>/…, trop long ou fichier trop gros | respecter les chemins et les limites (30 fichiers, 400000 caractères) | exportContribution |
Un mot de passe contenant $ arrive faux en PHP | avant la version 1.3.100, {{secret-php:NAME}} ne masque pas le $ ; à partir de la version 1.3.100, il le fait (seulement dans des chaînes PHP entre guillemets doubles) | placer l'espace réservé dans "…" ; pour les versions plus anciennes, des valeurs sans $ | secrets |
| L'éditeur se comporte étrangement après que l'extension a modifié des objets de page | ctx.getPages() renvoie des objets de travail, pas des copies | lire seulement, modifier via ctx.project/ctx.blocks | L'interface ctx, Règles de sécurité |
Le répertoire data/ de l'extension est accessible | le programme n'écrit pas de .htaccess pour les contributions | le code PHP met lui-même la protection en place | Parties serveur PHP |
| La galerie n'affiche pas d'aperçu de l'extension | l'aperçu n'est trouvé que dans le paquet | thumbnail.jpg dans le paquet | Construire, vérifier, livrer |
| Le fichier reste sur le serveur après le retrait de la contribution | le programme ne supprime rien sur le serveur | le supprimer soi-même | exportContribution |