{% extends '@EasyAdmin/page/content.html.twig' %} {% block content_title %} Guide d'utilisation {% endblock %} {% block main %}

Bienvenue dans le guide BlogWeb. Cliquez sur une section pour en savoir plus. Ce guide est toujours accessible depuis le menu Aide → Guide.

{# ── 1. Premiers pas ── #}

Qu'est-ce que BlogWeb ?

BlogWeb est un CMS (systeme de gestion de contenu) qui vous permet de gerer votre site web de maniere autonome : articles, pages, medias, navigation, et plus encore.

Votre tableau de bord

Le Tableau de bord est votre page d'accueil dans l'administration. Vous y trouvez :

  • Les statistiques de visites de votre site
  • Vos derniers articles et commentaires
  • Des raccourcis vers les actions les plus courantes
  • Des astuces pour mieux utiliser votre site
Le menu de navigation

Le menu a gauche est organise par sections :

  • Contenu — Tout ce que vos visiteurs voient : articles, pages, medias
  • Communaute — Commentaires et utilisateurs
  • Reglages — Configuration du site (identite, navigation, apparence)
  • Aide — Ce guide, toujours accessible
Astuce : Commencez par configurer l'identite de votre site (nom, logo, coordonnees) dans Reglages → Identite du site.
{# ── 2. Articles ── #}

Creer un article

Depuis Contenu → Blog → Articles, cliquez sur Creer un article.

L'editeur de contenu

BlogWeb integre un editeur visuel complet pour rediger vos contenus. Consultez la section Editeur de contenu ci-dessous pour decouvrir toutes ses fonctionnalites.

Publier un article

Par defaut, un article est en brouillon (non visible). Pour le publier :

  • Cochez la case Publie dans le formulaire
  • La date de publication sera automatiquement remplie
Article vedette

Vous pouvez mettre un article en avant avec le champ Article vedette. Il sera affiche en evidence sur la page Blog.

Visibilite
  • Public — Visible par tous les visiteurs
  • Membres — Uniquement les utilisateurs connectes
  • Admin — Uniquement les administrateurs
Astuce : Ajoutez toujours une image mise en avant et un texte d'accroche. Vos articles seront plus attractifs dans les listes et sur les reseaux sociaux.
{# ── 2b. Editeur de contenu ── #}

Presentation

L'editeur visuel vous permet de rediger vos articles, pages et fiches sans toucher au code HTML. Il est utilise partout ou vous voyez une barre d'outils de mise en forme.

Mise en forme du texte

La barre d'outils propose les options suivantes :

  • Gras, Italique, Souligne, Barre — Formatage de base
  • Surlignage — Met en evidence un mot ou une phrase avec un fond colore
  • Titres H2, H3, H4 — Structurez votre contenu avec des sous-titres. Utilisez H2 pour les sections principales, H3 pour les sous-sections
  • Alignement — Gauche, centre ou droite
  • Listes — A puces ou numerotees
Blocs speciaux
  • Citation — Met en valeur une phrase importante dans un encadre
  • Code — Bloc de code avec coloration syntaxique
  • Separateur — Ligne horizontale entre deux sections
  • Encart (Callout) — Encadre colore pour attirer l'attention. 4 types : Info (bleu), Succes (vert), Attention (orange), Danger (rouge). Cliquez sur l'icone pour changer le type
  • Colonnes — Disposez votre contenu sur 2 colonnes cote a cote (sur mobile, les colonnes s'empilent automatiquement)
  • Tableaux — Inserez un tableau via la barre d'outils ou la commande rapide /tableau
Medias
  • Images — Inserez une image depuis votre bibliotheque de medias. Le bouton ouvre un panneau de selection
  • Documents — Inserez un fichier telechargeable (PDF, DOCX, XLSX, ZIP...). Le bouton ouvre la bibliotheque de documents avec une zone d'upload integree. Le fichier apparait sous forme de carte cliquable dans votre contenu
  • Videos YouTube — Collez l'URL d'une video pour l'integrer directement
  • Liens — Selectionnez du texte puis cliquez sur l'icone lien pour ajouter une URL
Commande rapide /

Tapez / dans l'editeur pour ouvrir un menu contextuel. Vous pouvez inserer rapidement un titre, une image, un document, une video, une citation, un encart ou des colonnes sans utiliser la barre d'outils.

Sauvegarde automatique

L'editeur sauvegarde automatiquement votre brouillon toutes les 30 secondes dans votre navigateur. Si vous quittez la page sans sauvegarder, votre travail sera propose a la restauration a votre prochaine visite.

Vous pouvez egalement sauvegarder manuellement a tout moment avec Ctrl+S (Windows/Linux) ou Cmd+S (Mac).

Compteur de caracteres

En bas de l'editeur, un compteur affiche le nombre de caracteres et de mots. Utile pour vos descriptions SEO et pour calibrer la longueur de vos textes.

Astuce : Utilisez la commande / pour gagner du temps ! Tapez / puis les premieres lettres de ce que vous cherchez (ex : /image, /citation, /colonnes).
{# ── 3. Pages ── #}

Pages systeme vs pages personnalisees

Il existe deux types de pages :

  • Pages systeme (mentions legales, politique de confidentialite) — Elles ne peuvent pas etre supprimees, mais leur contenu est modifiable.
  • Pages personnalisees — Creez autant de pages que vous le souhaitez (A propos, Nos services, etc.).
Mise en page

Chaque page peut utiliser un modele de mise en page different :

  • Standard — Contenu pleine largeur, ideal pour du texte
  • Avec barre laterale — Contenu + sidebar widgets
  • Landing — Page d'atterrissage sans elements de navigation superflus
Astuce : N'oubliez pas d'ajouter vos pages personnalisees dans la navigation via Reglages → Navigation.
{# ── 4. Tags & Familles ── #}

Qu'est-ce qu'un tag ?

Un tag est un mot-cle attache a un contenu. Il sert a la classification fine et genere une page automatique /tag/{slug} listant tous les contenus associes.

Les tags sont partages entre les modules : un meme tag peut etre utilise par des articles, des fiches de l'annuaire, des produits du catalogue ou des realisations du portfolio.

Familles de tags : pour quoi faire ?

Une famille de tags regroupe des tags partageant un meme theme (Villes, Metiers, Niveaux, Marques...). Chaque famille genere automatiquement un filtre dedie sur les pages qui exposent les tags.

Exemple concret pour un annuaire :

  • Creez une famille Villes avec les tags Paris, Lyon, Marseille
  • Creez une famille Metiers avec les tags Plombier, Electricien, Macon
  • Tagguez vos fiches d'annuaire
  • Sur la page /annuaire, deux bandeaux de filtres apparaissent automatiquement : « Villes » et « Metiers »
  • Les filtres se cumulent : un visiteur peut chercher « Plombier a Paris »
Comment creer une famille
  1. Menu Contenu → Classification → Familles de tags
  2. Cliquez sur Creer, donnez un nom (ex: « Villes ») et une couleur
  3. L'ordre d'affichage decide de la position des filtres front (plus petit = plus haut)
Comment rattacher les tags
  1. Menu Contenu → Classification → Tags
  2. Editez un tag existant ou creez-en un nouveau
  3. Selectionnez la famille dans le champ Famille (optionnel)

Le rattachement reste optionnel : un tag sans famille fonctionne comme avant (sujets blog, page tag classique).

Cote front
  • Annuaire : filtres par famille generes automatiquement, cumulables avec la recherche et la categorie.
  • Sidebar blog : le nuage de tags se regroupe par famille des qu'au moins un tag a une famille.
  • Page /tag/{slug} : affiche par sections les contenus associes (articles + membres + produits...) selon les modules actifs.
Astuce : Pour un nouveau cas d'usage (filtrer le catalogue par marque, le blog par niveau...), creez une famille et tagguez. Aucun developpement specifique n'est necessaire — les filtres apparaissent automatiquement.
Bonne pratique : Limitez-vous a 2-3 familles par module pour rester lisible. Trop de filtres tuent le filtre.
{# ── 5. Medias ── #}

Formats acceptes

Vous pouvez telecharger des images aux formats JPG, PNG, GIF et WebP. Taille maximale : 25 Mo.

Conversion WebP automatique

Chaque image uploadee est automatiquement convertie en WebP, un format moderne plus leger. Vos pages se chargent plus vite, et votre SEO s'ameliore.

Images responsives

BlogWeb genere automatiquement 3 tailles de chaque image (480px, 800px, 1200px) pour s'adapter a tous les ecrans (mobile, tablette, ordinateur).

Texte alternatif (alt)

Le champ Nom d'un media sert aussi de texte alternatif. C'est important pour :

  • L'accessibilite (lecteurs d'ecran pour malvoyants)
  • Le SEO (Google comprend le contenu de vos images)
Astuce : Donnez des noms descriptifs a vos images. Preferez "equipe-reunion-bureau" a "IMG_20240315.jpg".
{# ── 5b. Documents ── #}

A quoi servent les documents ?

Le module Documents vous permet d'integrer des fichiers telechargeables (PDF, Word, Excel, archives...) directement dans vos articles et pages. Ils apparaissent sous forme de carte cliquable avec icone, nom et taille — bien plus visible qu'un simple lien texte.

Formats acceptes

Taille maximale : 25 Mo. Formats supportes :

  • PDF — Documents portables (plaquettes, CV, factures...)
  • Word (.doc, .docx) et OpenDocument Texte (.odt)
  • Excel (.xls, .xlsx) et OpenDocument Calc (.ods, .csv)
  • PowerPoint (.ppt, .pptx) et OpenDocument Impress (.odp)
  • Archives (.zip, .rar, .7z)
  • Texte brut (.txt)
Deux facons d'ajouter un document

Methode 1 — Bibliotheque centrale

  1. Menu Contenu → Documents
  2. Cliquez sur Ajouter un document, donnez-lui un nom descriptif et uploadez le fichier
  3. Vous pouvez ensuite l'inserer dans plusieurs articles ou pages depuis l'editeur

Methode 2 — Directement depuis l'editeur

  1. Dans un article ou une page, placez le curseur la ou vous voulez inserer le document
  2. Cliquez sur l'icone de la barre d'outils (ou tapez /document)
  3. Dans la modale, choisissez un document existant ou uploadez un nouveau fichier directement — il sera automatiquement insere et ajoute a votre bibliotheque
Le nom affiche dans la carte

Le champ Nom que vous saisissez est utilise comme :

  • Le titre visible dans la carte cote front
  • Le nom du fichier telecharge par vos visiteurs (attribut download)

Preferez "Plaquette commerciale 2026" plutot que "doc-final-v3.pdf" : c'est ce que verront vos clients.

Cote front

La carte affiche automatiquement :

  • Une icone selon le type de fichier (PDF, Word, Excel, ZIP...)
  • Le nom que vous avez saisi
  • L'extension et la taille (ex: PDF · 1,2 Mo)
  • Une icone de telechargement a droite

Le clic ouvre le fichier dans un nouvel onglet (ou propose le telechargement selon le type).

Astuce : Pour les fichiers volumineux (videos, gros datasets), preferez un hebergeur dedie (YouTube, WeTransfer, Google Drive) avec un lien externe. Le module Documents est optimise pour les fichiers jusqu'a 25 Mo.
Bonne pratique : Si vous mettez a jour un document (ex: nouveau tarif), modifiez-le directement dans la bibliotheque (l'URL reste la meme) plutot que de creer un nouveau document — tous les articles qui l'incluent seront automatiquement a jour.
{# ── 5. Navigation ── #}

Le gestionnaire de menus

Accessible via Reglages → Navigation, il vous permet d'organiser vos menus par glisser-deposer.

Les emplacements

Votre site a 3 zones de navigation :

  • Header — Le menu principal en haut de page
  • Footer navigation — Liens utiles en bas de page
  • Footer legal — Mentions legales, CGV, politique de confidentialite
Types de liens

Vous pouvez ajouter des liens vers :

  • Des pages de votre site
  • Des categories d'articles
  • Des modules (blog, services, catalogue...)
  • Des URLs externes
Astuce : Gardez votre menu header court (5-7 liens maximum). Trop de liens perturbent la navigation.
{# ── 6. SEO ── #}

Qu'est-ce que le SEO ?

Le SEO (Search Engine Optimization) designe l'ensemble des techniques pour que votre site apparaisse dans les premiers resultats de Google.

Les champs SEO

Chaque article, page et categorie dispose d'un panneau SEO avec :

  • Titre SEO (max 70 caracteres) — Le titre affiche dans Google. S'il est vide, le titre de votre contenu est utilise.
  • Description SEO (max 160 caracteres) — Le texte sous le titre dans Google. C'est ce qui donne envie de cliquer !
  • Mots-cles — Les termes principaux de votre contenu, separes par des virgules.
  • No Index — Cochez si vous ne voulez pas que cette page apparaisse dans Google (brouillons, pages privees).
  • URL canonique — A remplir uniquement si le contenu existe aussi sur un autre site.
Ce que BlogWeb fait automatiquement
  • Generation du sitemap XML (plan du site pour Google)
  • Balises Open Graph pour les reseaux sociaux
  • Schema.org JSON-LD pour les extraits enrichis
  • robots.txt optimise
  • Images WebP et lazy-loading pour la vitesse
  • Twitter Cards — generees automatiquement avec les memes donnees que l'Open Graph
Image Open Graph

Configurez une image dediee dans Reglages → Identite (format recommande : 1200x630 px). Fallback automatique : image OG → image hero → logo.

Astuce : Remplissez les champs SEO de vos 10 pages les plus importantes. C'est le meilleur rapport effort/resultat pour votre referencement.
{# ── 7. FAQ ── #} {% if site is defined and site and 'faq' in site.enabledModules %}

A quoi sert le module FAQ ?

Le module FAQ vous permet de creer une page de questions/reponses en accordeon sur votre site. C'est ideal pour rassurer vos visiteurs et ameliorer votre referencement (Google affiche parfois les FAQ directement dans les resultats).

Categories (optionnelles)

Vous pouvez organiser vos questions par categories. Dans Modules → FAQ → Categories :

  • Creez des categories thematiques (ex : "Livraison", "Paiement", "Technique")
  • Ordonnez-les avec le champ Ordre (0 = en premier)
  • Activez ou desactivez-les a tout moment

Si vous n'avez que quelques questions, pas besoin de categories : les questions s'afficheront dans un seul groupe.

Creer une question

Dans Modules → FAQ → Questions, cliquez sur Creer :

  • Question — Le texte affiche dans le titre de l'accordeon
  • Reponse — Utilisez l'editeur visuel pour mettre en forme votre reponse (texte riche, liens, listes...)
  • Categorie — Rattachez la question a une categorie (optionnel)
  • Icone — Ajoutez une icone Bootstrap Icons (optionnel)
  • Ordre — Position dans sa categorie (0 = en premier)
  • Active — Desactivez une question sans la supprimer
Affichage sur le site

La page /faq affiche toutes les questions actives en accordeon, groupees par categorie. Le schema FAQ structuree (schema.org) est genere automatiquement pour le SEO.

Astuce : Redigez vos questions du point de vue du client ("Comment puis-je..." plutot que "Nous proposons..."). Google valorise les FAQ qui repondent aux vraies questions des internautes.
{% endif %} {# ── 8. Portfolio ── #} {% if site is defined and site and 'portfolio' in site.enabledModules %}

A quoi sert le module Portfolio ?

Le module Portfolio vous permet de presenter vos realisations, projets clients ou travaux dans une grille visuelle avec pages de detail. Ideal pour montrer votre savoir-faire a vos prospects.

Categories

Dans Modules → Portfolio → Categories, organisez vos realisations par type de projet :

  • Creez des categories (ex : "Sites web", "Applications", "Design graphique")
  • Ajoutez une icone Bootstrap Icons pour un rendu visuel dans les filtres
  • Ordonnez-les avec le champ Ordre

Vos visiteurs pourront filtrer par categorie sur la page /realisations.

Creer une realisation

Dans Modules → Portfolio → Realisations, cliquez sur Creer :

Contenu :

  • Titre — Nom du projet, affiche dans la grille et en titre de page
  • Description courte — Resume de 2-3 lignes affiche dans la grille
  • Contenu detaille — Description complete du projet (editeur visuel)
  • Image principale — Image de couverture, format 4:3 recommande

Projet :

  • Client — Nom du client ou de l'entreprise
  • Date de realisation — Date de livraison du projet
  • Lien du projet — URL complete vers le projet en ligne (ex : https://www.client.fr). Un bouton "Voir le projet" sera affiche sur la page de detail
  • Tags — Technologies ou competences utilisees. Les tags sont partages avec le blog, l'annuaire et le catalogue (voir section Tags & familles)

Parametres :

  • Categorie — Permet aux visiteurs de filtrer par type
  • Mis en avant — Les realisations mises en avant peuvent etre affichees sur la page d'accueil
  • Active — Masquer sans supprimer
Affichage sur le site
  • /realisations — Grille de toutes les realisations avec filtres par categorie
  • /realisation/mon-projet — Page de detail avec image, description, infos projet, tags et bouton lien
Astuce : Privilegiez des images de qualite et un format homogene (4:3). Remplissez les champs SEO pour chaque realisation importante — cela aide votre site a apparaitre quand un prospect cherche vos competences.
{% endif %} {# ── 8b. Services ── #} {% if site.hasModule('services') %}

Fiches de services

Le module Services permet de presenter vos prestations sous forme de grille sur la page d'accueil et en page dediee.

  • Description courte — affichee dans la grille des services
  • Contenu detaille — page de detail optionnelle (editeur visuel avec commande /)
  • Icone — classe Bootstrap Icons (ex: bi-rocket)
  • Lien — vers une page du site, un lien externe, ou la page de detail auto-generee
  • Ordre — position dans la grille (0 = premier)
{% endif %} {# ── 8c. Catalogue ── #} {% if site.hasModule('catalogue') %}

Fiches produits

Creez des fiches pour vos produits ou prestations avec tarification, variantes et galerie photos.

  • Prix HT/TTC — le mode d'affichage se configure dans Reglages > Identite > Catalogue
  • Variantes — taille, duree, formule... chaque variante peut avoir son propre prix
  • Galerie — ajoutez plusieurs photos par produit
  • Disponibilite — disponible, indisponible ou sur devis
  • Reservation — lien vers Calendly, Cal.com ou tout service de prise de rendez-vous
  • Produits lies — suggestions "Vous aimerez aussi" (auto si vide)
Categories produits

Organisez vos produits par categorie pour faciliter la navigation dans le catalogue.

{% endif %} {# ── 8d. Evenements ── #} {% if site.hasModule('events') %}

Gerer vos evenements

Publiez vos evenements a venir avec date, lieu et description detaillee.

  • Date et heure — date de debut obligatoire, date de fin optionnelle
  • Lieu — adresse ou nom du lieu
  • Evenement vedette — mis en avant sur la page d'accueil
  • Produit lie — associez un produit du catalogue pour permettre l'inscription/achat direct
  • Description — editeur visuel complet (commande / pour les blocs)

Les evenements passes sont automatiquement archives et affiches separement.

{% endif %} {# ── 8e. E-commerce ── #} {% if site.hasModule('ecommerce') %}

Panier et commandes

Le module e-commerce ajoute le panier, le tunnel de commande et le paiement Stripe.

  • Panier — les visiteurs ajoutent des produits et variantes au panier
  • Commandes — consultables dans Modules > Commandes (lecture seule)
  • Paiement Stripe — configurez vos cles dans Reglages > Identite > Paiement Stripe
  • Statuts — en attente, payee, annulee, remboursee
Configuration Stripe

Trois cles a renseigner dans Reglages > Identite :

  • Cle publique — commence par pk_test_ ou pk_live_
  • Cle secrete — commence par sk_test_ ou sk_live_
  • Secret webhook — commence par whsec_
{% endif %} {# ── 9. Personnalisation ── #} {% if is_granted('ROLE_FREELANCE') %}

Changer de theme

Dans Reglages → Apparence → Catalogue de themes, parcourez les themes disponibles et previsualisez-les avant de les activer.

Personnaliser les couleurs et polices

Dans Reglages → Apparence → Reglages du theme, modifiez :

  • Couleur principale — Boutons, liens, accents
  • Couleur secondaire — Elements d'accompagnement
  • Couleur d'accent — Details, badges, decorations
  • Polices — 20 Google Fonts disponibles

Si vous laissez un champ vide, la valeur par defaut du theme s'applique.

Images du theme

Gerez vos images hero, equipe, et galerie dans Reglages → Apparence → Images du theme.

Astuce : Changez les couleurs plutot que le theme entier. Vous gardez la structure tout en personnalisant l'identite visuelle.
{% endif %} {# ── 8. Utilisateurs ── #} {% if is_granted('ROLE_ADMIN') %}

Les roles

Chaque utilisateur a un role qui determine ce qu'il peut faire :

Role Qui Peut faire
Utilisateur Visiteur inscrit Lire, commenter, gerer son profil
Auteur Redacteur Creer et editer des articles et pages
Admin Administrateur Gestion complete du site
Freelance ROLE_FREELANCE Themes, couleurs, polices + tout ce que fait Admin
Super Admin ROLE_SUPER_ADMIN Acces total : modules, infra, configuration avancee
Astuce : Creez un compte Auteur pour vos redacteurs. Ils pourront ecrire sans acceder aux reglages sensibles.
{% endif %} {# ── 10b. Abonnes ── #}

Systeme d'abonnement

Les visiteurs peuvent s'abonner aux notifications par email sans creer de compte. Un simple formulaire avec leur email suffit.

  • Double opt-in — l'abonne recoit un email de confirmation avant d'etre actif
  • Preferences — choix entre articles, evenements ou les deux
  • Desinscription — lien en un clic dans chaque email de notification
  • Gestion — l'abonne peut modifier ses preferences via un lien tokenise (sans connexion)
Dans l'admin

Consultez et gerez vos abonnes dans Communaute → Abonnes. Vous pouvez desactiver un abonne sans le supprimer.

{% endblock %}