Blog CMS

Overview

Le blog Wagoo est un CMS complet avec éditeur riche, formatage, et publication.

Créer un article

Via l’interface

1. Ouvrez votre projet
2. Allez à l’onglet Blog
3. Cliquez New Article
4. Remplissez :
   • Titre : Nom de l’article
   • Contenu : Utilisez l’éditeur TipTap
   • Excerpt (optionnel) : Description courte
5. Cliquez Save as Draft ou Publish

Contenu supporté

L’éditeur TipTap supporte :

• ✅ Texte riche : Gras, italique, souligné
• ✅ Titres : H1, H2, H3, H4, H5, H6
• ✅ Listes : Listes à puces et numérotées
• ✅ Liens : URLs cliquables
• ✅ Images : Upload direct ou URL
• ✅ Vidéos : Embed YouTube, Vimeo
• ✅ Code : Blocs de code avec syntaxe highlighting
• ✅ Blockquotes : Citations formatées
• ✅ Tableaux : Tableaux avec édition
• ✅ Emojis : Support complet des emojis
• ✅ Mentions : @user pour mentionner

Statuts d’article

DRAFT

Brouillon (non-public). Seuls les collaborateurs peuvent voir.

Visible sur : /project/draft-articles (admin seulement)
Moteurs de recherche : Non indexés

PUBLISHED

Article publié et visible publiquement.

Visible sur : /project/blog/[slug]
Moteurs de recherche : Indexés (SEO)

ARCHIVED

Article archivé (lecture seule).

Visible sur : /project/archived (lien direct)
Moteurs de recherche : Non indexés (noindex)

Modifier un article

1. Allez à Blog → Articles
2. Cliquez sur l’article à modifier
3. Changez le contenu ou les métadonnées
4. Cliquez Save

Publier un article

D’un brouillon à la publication

1. Ouvrez l’article en Draft
2. Cliquez Publish
3. Confirmez la publication
4. L’article est maintenant visible sur /project/blog/[slug]

Programmer une publication (optionnel)

Fonctionnalité future : Programmer la publication à une date spécifique

SEO & Métadonnées

Chaque article peut avoir :

• Slug : URL-friendly (auto-généré du titre)
• Meta title : Titre pour les moteurs de recherche
• Meta description : Description courte (155 caractères)
• Meta image : Image pour les social media previews
• Mots-clés : Tags pour catégoriser

Via l’API

Créer un article

curl -X POST http://localhost:3000/api/projects/{projectId}/articles \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "title": "Mon premier article",
    "slug": "mon-premier-article",
    "content": "<h1>Contenu HTML</h1>",
    "excerpt": "Une courte description",
    "status": "DRAFT"
  }'

Récupérer les articles

# Tous les articles publics
curl http://localhost:3000/api/projects/{projectId}/articles?status=PUBLISHED
 
# Tous les articles (admin)
curl http://localhost:3000/api/projects/{projectId}/articles \
  -H "Authorization: Bearer YOUR_TOKEN"

Modifier un article

curl -X PUT http://localhost:3000/api/projects/{projectId}/articles/{articleId} \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "title": "Titre modifié",
    "content": "Nouveau contenu",
    "status": "PUBLISHED"
  }'

Supprimer un article

curl -X DELETE http://localhost:3000/api/projects/{projectId}/articles/{articleId} \
  -H "Authorization: Bearer YOUR_TOKEN"

Afficher les articles

Page publique du blog

URL : http://mon-projet.wagoo.app/blog

Affiche :

• Liste des articles publiés
• Articles triés par date (récents d’abord)
• Pagination

Article détail

URL : http://mon-projet.wagoo.app/blog/[slug]

Affiche :

• Titre et contenu riche
• Date de publication
• Auteur
• Tags
• Articles suggérés

Autocomplétion & Mentions

L’éditeur propose :

• Autocomplétion : / pour les commandes

  • /h1 → Titre H1
  • /code → Bloc de code
  • /image → Insérer image

• Mentions : @ pour mentionner

  • @user → Mention d’un collaborateur
  • Crée une notification

Images et médias

Upload d’images

1. Cliquez sur l’icône image dans la toolbar
2. Sélectionnez une image depuis votre ordinateur
3. L’image est uploadée et affichée

Limitation

• Taille max : 10 MB
• Formats supportés : JPG, PNG, WebP, GIF
• Résolution recommandée : 1200x630px

Partage social

Quand vous publiez un article :

• URL partageable : http://mon-projet.wagoo.app/blog/[slug]
• Meta preview : Titre + description + image
• Open Graph : Données optimisées pour Twitter/Facebook

Commentaires (optionnel)

Fonctionnalité future : Système de commentaires modérés.

Cas d’usage

Blog d’entreprise

Publiez des actualités, des tutoriels, des case studies.

Portfolio créatif

Présentez vos projets avec articles détaillés et images.

Documentation

Créez une base de connaissances interne ou publique.

Newsletter

Publiez du contenu régulièrement et partagez sur les réseaux.

Conseils SEO

✅ Utilisez des titres descriptifs et des slugs courts ✅ Écrivez une meta description de 150-160 caractères ✅ Ajoutez une image optimisée (1200x630px) ✅ Utilisez les heading tags (H2, H3) pour la structure ✅ Linkez vers d’autres articles pertinents ✅ Mettez en avant les mots-clés importants

Voir Système de tickets pour la gestion du support.