better-i18n.com
Docs développeurCentre d'aideNotes de version

Comment activer le CMS et créer mon premier modèle de contenu ?

Mis à jour le Aug 21, 2026

Le Content CMS est un module optionnel pour gérer du contenu multilingue structuré — articles de blog, articles d'aide, notes de version, descriptions de produits — aux côtés de vos clés i18n.

Avez-vous besoin du Content CMS ? #

Le Content CMS est fait pour le contenu libre à structure riche. Si vous gérez des chaînes t('key') dans votre code, c'est l'affaire de la Translation API — le CMS n'est pas nécessaire pour cela.

Utilisez le Content CMS lorsque vous avez besoin de :

  • Articles ou documents avec un corps en markdown
  • Contenu doté de champs personnalisés (auteur, date, catégorie)
  • Plusieurs versions linguistiques gérées séparément
  • Contenu servi via API ou CDN plutôt qu'embarqué dans l'application

Étape 1 : activer le Content CMS #

  1. Ouvrez votre projet dans le tableau de bord
  2. Cliquez sur l'onglet Content
  3. S'il n'est pas déjà activé, cliquez sur « Enable Content CMS »

L'onglet Content est disponible sur tous les plans. Certaines fonctions avancées (modèles personnalisés, opérations en masse) peuvent nécessiter un plan supérieur.

Étape 2 : créer votre premier modèle de contenu #

Un modèle de contenu est le schéma de votre type de contenu. Voyez-le comme la définition d'une table de base de données.

  1. Dans l'onglet Content, cliquez sur « New model »
  2. Saisissez un nom (par ex. « Help Article ») et un slug (par ex. help-article)
  3. Ajoutez des champs personnalisés :
    • Text — chaînes courtes (titres, auteurs)
    • Textarea — textes plus longs (extraits, résumés)
    • Number — entiers ou décimaux
    • Boolean — indicateurs vrai/faux
    • Enum — liste déroulante à valeurs fixes
    • Relation — référence vers un autre modèle de contenu
  4. Pour les champs à traduire par langue, activez « Localized »
  5. Cliquez sur Create model

Un réglage au niveau du modèle mérite d'être tranché maintenant plutôt que plus tard : les entrées de ce modèle portent-elles un corps ? Les modèles avec corps (articles, billets) exigent un contenu non vide dans une langue avant que celle-ci puisse être publiée. Les modèles purement métadonnées — étiquettes, catégories, autres taxonomies — se publient sur leurs seuls champs.

Étape 3 : créer votre première entrée #

  1. Sélectionnez votre modèle dans l'onglet Content
  2. Cliquez sur « New entry »
  3. Renseignez le titre, le corps et les champs personnalisés
  4. Cliquez sur Save ou Publish

Une fois publiée, l'entrée est accessible depuis la Content API :

Bash
curl "https://content.better-i18n.com/v1/content/your-org/your-project/models/help-article/entries?status=published" \
  -H "x-api-key: YOUR_API_KEY"

Étapes suivantes #