Prise en main

Ouvrez /webadmin et connectez-vous avec un compte administrateur actif.

• super_admin peut accéder aux espaces de niveau installation et de niveau site
• site_admin et editor ne peuvent accéder qu'aux espaces d'administration limités aux sites qui leur sont attribués

Si votre installation utilise plusieurs sites, commencez par confirmer sur quel site vous travaillez.

• Les utilisateurs super_admin peuvent gérer les sites dans la section System
• Les utilisateurs site_admin et editor travaillent uniquement à l'intérieur des sites qui leur sont attribués

Avant de publier une page de contact publique, configurez l'identité du site, le domaine et le destinataire Contact. Le destinataire Contact au niveau du site dans Site -> Edit -> Contact est préférable au fait de se reposer uniquement sur .env, car il accompagne la configuration du site.

Les notifications du Contact Form utilisent la remise de courrier de Laravel. Les réglages .env habituels sont :

MAIL_* contrôle le transport SMTP. MAIL_FROM_ADDRESS est l'adresse d'expéditeur sûre et le destinataire de repli final. CONTACT_RECIPIENT_EMAIL est facultatif ; utilisez-le comme repli au niveau de l'environnement, et non comme remplacement du destinataire Contact du site lorsque le réglage du site est disponible.

Si les réglages de messagerie de .env sont modifiés après la mise en cache de la configuration, exécutez :

L'ordre de résolution du destinataire est le suivant :

1. recipient_email du bloc Contact Form
2. Destinataire de contact par défaut du site défini dans Site -> Edit -> Contact
3. CONTACT_RECIPIENT_EMAIL dans .env
4. Repli sûr MAIL_FROM_ADDRESS

Exécutez un diagnostic sans exposition des secrets avant de vous fier aux notifications :

Utilisez php artisan contact:mail-diagnose --block=ID lorsque vous devez inspecter la chaîne de repli d'un bloc Contact Form précis.

Ouvrez Pages dans la barre latérale d'administration et créez une page.

Les nouvelles pages démarrent en draft, ce qui signifie que :

• la page n'est pas encore publique
• les éditeurs peuvent continuer à la modifier librement
• la page peut être soumise à relecture lorsqu'elle est prête

Utilisez le constructeur de pages pour ajouter ou modifier des blocs dans le layout de la page.

De façon générale, vous pouvez :

• choisir la structure de la page grâce aux layouts et aux slots
• ajouter des blocs de contenu à la page
• joindre des médias là où cela est pris en charge
• construire ou modifier la navigation du site depuis l'espace Navigation

Les médias et la navigation sont gérés séparément de l'éditeur de page, mais ils fonctionnent de concert avec le contenu de la page.

Lorsque vous utilisez Gallery, considérez-le comme un bloc de collection de médias et non comme un bloc d'introduction de section.

• utilisez Content Header plus Plain Text ou Rich Text avant Gallery lorsque vous avez besoin d'un titre ou d'un texte explicatif
• Gallery ne restitue plus son propre titre ni son propre paragraphe d'introduction publics
• les anciens champs Gallery Title et Description ne sont plus des champs normaux de l'éditeur Gallery
• les éléments de la galerie sont gérés sous forme de lignes de liste compactes avec des contrôles de réordonnancement et d'édition par élément, à la place de l'ancienne grille de ressources sélectionnées
• la sélection des médias, l'ordre et la présentation de la galerie restent partagés entre les langues (locales)
• le texte alternatif, la légende, le titre de superposition et le texte de superposition de chaque élément appartiennent à chaque langue (locale)

Pour des en-têtes publics réutilisables, le modèle recommandé est le suivant :

• construisez le menu dans Admin -> Navigation
• créez ou modifiez un Shared Slot Header pour le site
• ajoutez Navbar à ce Shared Slot
• ajoutez-y des blocs enfants tels que Container, Cluster, Navbar Brand, Navbar Navigation et Header Actions
• choisissez le menu de navigation sur le bloc enfant Navbar Navigation plutôt que de saisir les liens manuellement

Navbar ne restitue que nav.wb-navbar et ses blocs enfants. Il n'ajoute pas automatiquement de Container, de conteneur de marque, de conteneur de menu ni de zone d'actions générée. Lorsqu'une largeur contrainte est nécessaire, placez un bloc Container à l'intérieur de la Navbar.

Container est avant tout une primitive de largeur. Les conteneurs hérités restituent encore un flux empilé par défaut, mais pour la composition de la navbar réglez Flow de Container sur None afin qu'il ne restitue que div.wb-container, puis placez Cluster à l'intérieur pour la composition horizontale.

Cluster est la primitive de layout horizontal ou groupé. Utilisez ses réglages pour contrôler Width, Justify, Align, Wrap et Gap sans CSS personnalisé.

Navbar Brand et Navbar Navigation doivent se trouver dans l'arborescence de la Navbar, mais ils n'ont pas besoin d'être des enfants directs de Navbar. Un modèle recommandé est Navbar -> Container (Flow: None) -> Cluster (Width: Full, Justify: Between, Align: Center, Wrap: Nowrap), puis placez Navbar Brand ainsi qu'un Cluster (Justify: End, Align: Center, Wrap: Nowrap) interne contenant Navbar Navigation et Header Actions.

Lorsqu'un bloc Navbar Navigation comporte des éléments visibles, le CMS restitue désormais automatiquement un bouton hamburger pour mobile. Sur mobile, les liens de bureau en ligne se replient derrière ce bouton, la marque reste visible, les actions d'en-tête restent disponibles et le menu ouvert est restitué sous la rangée grâce au comportement de menu déroulant existant de WebBlocks UI.

Navbar Brand prend en charge un usage avec logo seul lorsqu'une image de logo est présente. Dans ce cas, le texte de titre visible est facultatif et le libellé accessible se replie sur le libellé de marque configuré ou sur le nom du site résolu.

Position est le seul réglage intégré de la Navbar : static, sticky ou fixed. Les variantes visuelles et le style de la navbar relèvent de l'usage des classes WebBlocks UI, et non de réglages CMS propres au bloc Navbar.

Dans l'éditeur de slots :

• le sélecteur de blocs s'ouvre par défaut sur un onglet Common sélectionné, chaque onglet ou résultat de recherche conserve l'ordre Name A-Z, l'en-tête de la fenêtre modale indique combien de types de blocs sont actuellement listés, et les longues listes de résultats défilent à l'intérieur de la fenêtre modale sans masquer la barre d'outils de recherche
• la poignée de glissement utilise un simple marqueur de préhension de repli afin que les lignes triables restent utilisables même si une entrée de la police d'icônes est indisponible
• Delete All Blocks n'apparaît que lorsque le slot de page ou le Shared Slot courant contient déjà des blocs, et la fenêtre modale de confirmation indique combien de blocs de premier niveau et imbriqués seront supprimés

Lorsque vous atteignez une page depuis une liste Pages filtrée, l'administration conserve désormais ce contexte de liste Pages pendant que vous passez par Edit Page, l'édition des slots, l'édition des traductions et les flux d'enregistrement, de sorte qu'un retour à Pages vous ramène aux mêmes filtres et au même ordre de tri.

Les pages passent par ces statuts :

• draft
• in_review
• published
• archived

Flux type :

1. créez la page en draft
2. modifiez la page et ses blocs
3. soumettez-la à relecture
4. publiez-la une fois approuvée

Les éditeurs peuvent préparer le contenu et le soumettre à relecture. La publication nécessite un site_admin ou un super_admin.

Seules les pages published sont publiques.

• les pages draft, in_review et archived renvoient 404 sur les routes publiques
• une page publiée respecte toujours les règles de visibilité au niveau des blocs qu'elle contient

Après la publication, ouvrez la page via sa route publique ou utilisez le lien d'aperçu/d'ouverture de l'administration pour cette page.

Dans les installations multisite, les URL publiques suivent le contexte de site et de langue (locale) résolu.

Utilisez le bloc natif contact_form pour les pages de contact. N'utilisez pas Trusted HTML, du balisage <form> brut ni des liens mailto: comme voie de soumission normale. Le moteur de rendu du CMS crée le champ caché de contrôle anti-spam ; les éditeurs et les outils IA/opérateur ne doivent pas créer ce champ manuellement, et l'ancien champ website n'est plus le contrat public.

Test rapide avant d'annoncer la page :

1. Prévisualisez ou publiez une page contenant contact_form.
2. Envoyez un nom, une adresse e-mail, un objet et un message de test.
3. Ouvrez /webadmin/contact-messages.
4. Vérifiez que le message a bien été enregistré.
5. Contrôlez l'état de la notification et les détails sûrs de l'échec si la remise n'a pas abouti.

Les soumissions réelles acceptées sont enregistrées avant toute tentative de notification. Un échec de notification ne signifie pas que la soumission du visiteur a échoué, et les visiteurs publics ne doivent pas voir les diagnostics de messagerie.

• Utilisateurs et rôles : docs/users-and-permissions.md
• Formulaires de contact et messages : docs/contact-forms-and-messages.md
• Flux de travail et approbations : docs/editorial-workflow.md
• Récupération des révisions : docs/revisions.md
• Sauvegardes, mises à jour, export/import : docs/operations.md