Questions fréquentes

Concepts

Qu'est-ce qu'un CMS headless ?

Un CMS headless est un système de gestion de contenu qui sépare l'endroit où l'on gère le contenu de l'écran où on l'affiche. Ici, « headless » signifie qu'aucun écran (UI) prédéfini n'y est rattaché.

Dans l'approche traditionnelle, l'endroit où l'on gère le contenu et l'écran du site web qui l'affiche ne font qu'un. Un CMS headless dissocie ces deux éléments. Le contenu se gère à un seul endroit, et il est ensuite transmis par un canal convenu (une API, une façon d'échanger des données via une adresse selon des règles définies). Vous pouvez ainsi réutiliser un même contenu sur plusieurs écrans différents, comme un site web ou une application mobile.

WEEGLOO est un CMS headless de ce type. Une fois que vous créez et publiez un contenu dans le studio de contenu, un site web ou une application en récupère la version publiée pour l'afficher à l'écran. Le fonctionnement global de WEEGLOO est traité dans Comment ça fonctionne.

Sous quelle forme le contenu est-il fourni ?

WEEGLOO fournit le contenu via une API RESTful basée sur le JSON (un format de données textuel utilisé pour échanger des données). Une API est un canal permettant d'échanger des données via une adresse selon des règles définies.

Plusieurs API sont réparties selon les usages.

• La CDA (Content Delivery API) pour lire le contenu publié : elle sert quand un site web ou une application récupère le contenu pour l'afficher aux visiteurs.
• La CMA (Content Management API) pour créer et gérer le contenu : elle sert à effectuer par le code les opérations que l'on fait dans le studio de contenu, comme la rédaction, la modification ou la publication.

Comme la lecture et la gestion sont ainsi séparées, vous pouvez choisir, selon les environnements, le seul canal dont vous avez besoin pour exploiter le contenu. Le choix de l'API selon la situation est traité dans la Référence API.

Puis-je utiliser WEEGLOO dans une application mobile ?

Oui. Comme expliqué dans Qu'est-ce qu'un CMS headless ?, WEEGLOO gère le contenu en le séparant de l'écran qui l'affiche. Vous pouvez donc récupérer et utiliser le même contenu aussi bien sur un site web que dans une application mobile. La façon de récupérer le contenu publié depuis l'application est la même que sur le web.

Un point diffère lorsque vous ajoutez la connexion des membres à une application mobile (Android, iOS). La liaison qui renvoie le résultat à l'application une fois la connexion terminée diffère du web, et une étape technique spécifique est nécessaire. Cette étape est traitée dans l'Auth API.

Un exemple complet reliant une application mobile à WEEGLOO est disponible du début à la fin dans le service de suivi de course.

Gestion du contenu

Comment diffuser du contenu en plusieurs langues ?

Pour fournir un Content ou un Media en plusieurs langues, vous ajoutez d'abord la langue (le Locale) à la Space.

1. Dans le menu de gauche, ouvrez les paramètres de la Space et allez sur l'écran de gestion des Locales.
2. Cliquez sur le bouton + Ajouter en haut à droite, puis choisissez la langue souhaitée dans la liste déroulante.
3. (Facultatif) Définissez un Fallback Locale. C'est la langue à afficher à la place lorsque la valeur de cette langue est vide.
4. Cliquez sur Enregistrer.

Après avoir ajouté un Locale, vous devez activer le multilingue sur chaque Field destiné à recevoir une valeur différente par langue. Dans l'écran d'édition du Content Type, ouvrez Configurer le Field du Field concerné et, dans l'onglet Paramètres, vérifiez que Activer la localisation pour ce Field est activé.

Pour en savoir plus, voir Gestion multilingue.

Comment effectuer la validation d'un Content ?

La validation est une fonction qui impose des conditions sur « les valeurs autorisées dans cette case » d'un Field. Une valeur qui ne respecte pas la condition n'est pas enregistrée, ce qui empêche l'accumulation de Content erronés.

Les conditions possibles diffèrent selon le type de Field. Par exemple, un Field qui relie un Media propose des conditions pour restreindre les types de fichiers autorisés ou pour limiter la taille du fichier et la taille de l'image, tandis qu'un Field numérique propose une condition pour fixer la plage des valeurs.

Pour ajouter une validation à un Field, suivez ces étapes.

1. Allez dans l'écran d'édition du Content Type et cliquez sur le Field auquel vous voulez imposer une condition.
2. Dans Configurer le Field, allez dans l'onglet Validations.
3. Les conditions applicables à ce type de Field s'affichent. Choisissez et configurez les conditions dont vous avez besoin.

Pour en savoir plus, voir Validation.

Comment définir le titre d'un Content ?

Le titre d'un Content est le nom qui permet de reconnaître chaque élément dans la liste des Content. N'importe quel Field de type ShortText peut servir de titre.

Dans l'écran d'édition du Content Type, ouvrez le Field que vous voulez utiliser comme titre, puis désignez ce Field pour servir de titre. Un Content Type ne peut avoir qu'un seul Field comme titre : si un autre Field est déjà désigné comme titre, désactivez-le avant d'en désigner un nouveau.

Le déroulement pour désigner un Field comme titre dès sa création est traité dans Modélisation de Content.

Gestion de l'Organization et de la Space

Comment inviter un utilisateur ?

Pour faire entrer un utilisateur dans une Space, celui-ci doit d'abord appartenir à l'Organization. C'est pourquoi la collaboration commence par une invitation à l'Organization.

Inviter un utilisateur dans l'Organization est une action que peut effectuer un utilisateur ayant le rôle Owner ou Admin.

1. Accédez à l'écran des paramètres de l'Organization.
2. Dans le menu de gauche, cliquez sur Memberships.
3. En haut à droite, cliquez sur le bouton Inviter, puis envoyez l'invitation en saisissant les informations comme l'e-mail et le rôle à attribuer.

L'utilisateur invité devient immédiatement membre. Il n'a pas à passer par une étape d'« acceptation » distincte, et un e-mail d'information est envoyé à l'adresse invitée.

Pour en savoir plus sur les invitations et les rôles, voir Organisation et espace de travail.

API

La valeur sys.id est-elle une valeur unique ?

Oui. Le sys.id est généré de façon unique à l'échelle de tout le service. Sa valeur ne se chevauche donc pas avec celle d'une ressource appartenant à une autre Organization ou Space.

Les informations contenues dans sys sont traitées dans Propriétés système (sys).

Comment récupérer les ressources référencées par un Content ?

Avec le paramètre include, une seule requête vous permet de récupérer un Content ainsi que les ressources référencées qu'il désigne.

GET /v1/spaces/{spaceId}/contents?include=1

La requête ci-dessus interroge la liste des Content tout en récupérant les données référencées qui y sont reliées sur un niveau de profondeur. En portant la valeur à 2 ou 3, vous les déployez et les récupérez sur un niveau plus profond.

include ne s'utilise pas seulement pour les Content : il fonctionne de la même façon pour l'interrogation de toutes les ressources. Pour en savoir plus, voir Paramètres de requête communs.

L'opération OR est-elle prise en charge dans les conditions de recherche ?

L'API REST ne prend pas directement en charge le regroupement de plusieurs conditions par OR (récupérer dès que l'une des deux conditions est remplie). Lorsque vous fournissez plusieurs conditions dans une même requête, seuls les résultats qui les satisfont toutes (AND) apparaissent. Si vous avez besoin d'un OR, envoyez une requête distincte par condition, puis combinez les résultats obtenus.

La manière de restreindre une liste par des conditions est traitée dans Paramètres de requête communs.

Facturation et tarifs

Puis-je changer de forfait ?

Vous pouvez à tout moment passer à un forfait supérieur (mise à niveau) ou inférieur (rétrogradation). Une mise à niveau fait l'objet d'un calcul au prorata pour la période de facturation restante, tandis qu'une rétrogradation s'applique à compter de la prochaine période de facturation.

Les limites et les prix par forfait sont traités dans Forfaits.

Comment l'utilisation de l'API est-elle calculée ?

De nombreuses plateformes de contenu comptabilisent l'utilisation en fonction du nombre d'appels d'API (le nombre de requêtes). WEEGLOO calcule l'utilisation non pas en fonction du nombre d'appels, mais en fonction de la quantité de données réellement échangées (le volume de transfert de données). Pour un même nombre de requêtes, l'utilisation comptabilisée est plus élevée lorsque les données échangées sont volumineuses.

Les forfaits Free, Basic et Pro incluent dans leur tarif mensuel un volume de transfert de données défini chaque mois. Le tableau des forfaits affiche également ce volume de transfert converti en nombre d'appels, afin de vous en donner un ordre de grandeur. Les opérations pour lesquelles une seule recherche compte comme plusieurs appels, comme Advanced Search, s'imputent elles aussi sur ce volume de transfert.

Si vous avez besoin d'une utilisation supérieure au volume de transfert défini, vous pouvez opter pour le forfait Enterprise, facturé à hauteur de votre consommation réelle. Les limites de transfert de données par forfait sont traitées dans Forfaits.