Wix Blocks : Créer et gérer les collections
Temps de lecture : 5 min
Wix Blocks est ouvert à tous les utilisateurs de Wix Studio. Pour accéder aux blocs, rejoignez Wix Studio.
Wix Blocks vous permet d'ajouter des collections (bases de données) à votre appli. La gestion des collections dans Blocks est similaire à la gestion des collections dans les sites Wix. Mais, il y a quelques points qui sont très différents. Découvrez-les dans cet article.
Suggestions
- Faites attention aux autorisations de collection et leurs directives de sécurité.
- Les collections Blocks sont comptabilisées dans la limite d'éléments et de collections du CMS
Une collection Blocks est un espace réservé
La chose la plus importantes à comprendre à propos d'une collection Blocks est qu'il s'agit d'un espace réservé pour les données de tout site sur lequel elle est installée. En effet, une collection Blocks peut être utilisée sur plusieurs sites, même sur des milliers d'entre eux. Ces sites peuvent être très différents les uns des autres et avoir leurs propres bases de données. Pensez à une collection qui contient des informations sur les clients. Chaque site peut avoir une liste de ses propres clients, et votre widget peut s'appliquer à tous d'entre eux.
Lorsque vous créez une collection dans Blocks, vous définissez les champs de la collection, et vous pouvez y faire référence dans le code de l'appli. Vous pouvez également ajouter des données par défaut dans Blocks, mais vous n'avez pas à le faire. Si vous ajoutez des données par défaut, elles sont automatiquement installées sur le site avec l'appli, et peuvent plus tard être remplacées par les données de tout site sur lequel l'appli est installée.
Si vous modifiez la structure d'une collection dans Blocks dans une future version de votre appli, cela a un impact sur tous les sites sur lesquels elle est installée. Travaillez donc avec attention et ne apportez pas de modifications qui peuvent rompr les sites.
À propos des données par défaut
Les données que vous ajoutez à vos collections Blocks seront importées sur le site dans lequel votre appli est installée, fournissant aux créateurs de sites des données par défaut pour votre appli. Si vous choisissez d'ajouter des données par défaut, notez que :
- Le site sur lequel votre appli est installée peut modifier ces données plus tard.
- Les données par défaut ne seront importées que lors de la première installation. Si vous publiez une nouvelle version de votre appli et modifiez les données de la collection, elle ne remplacera pas les données qui existent déjà sur les sites sur lesquels votre appli est installée.
Pour ajouter une collection à votre appli
- Cliquer sur l'icône Base de données
dans le menu de gauche de votre appli. - Cliquez sur Nouvelle catégorie.
- Créez un espace de noms pour votre appli, si vous ne l'avez pas déjà fait. Rendez l'espace de noms clair et significatif (si vous n'avez pas encore nommé votre application, vous serez invité à la nommer maintenant).
- Nommez votre collection.
- Configurez la structure de votre collection dans le CRM.
- Facultatif - ajoutez des éléments à votre collection. Ces données par défaut seront importées avec votre appli sur tous les sites sur lesquels elle est installée
Voir votre collection dans l'Éditeur du site
Lorsque vous importez une appli Blocks qui a une collection sur votre site, la collection apparaît dans le CMS 
la section Vos collections. L'espace de nom de votre appli apparaîtra à côté de cette collection, pour indiquer qu'elle provient de Blocks. désormais vous pouvez gérer votre collection comme dans tout autre site Wix.
la section Vos collections. L'espace de nom de votre appli apparaîtra à côté de cette collection, pour indiquer qu'elle provient de Blocks. désormais vous pouvez gérer votre collection comme dans tout autre site Wix. Important
Si vous supprimez l'appli du site, la collection sera également supprimée.
Connecter des éléments aux champs de la collection (data-binding)
Si vous souhaitez connecter un élément à un champ de collection, vous pouvez choisir. Souhaitez-vous le connecter vous-même depuis l'appli, ou permettre aux créateurs de sites de connecter cet élément eux-mêmes ? Par exemple, si vous créez une appli avec une logique complexe que vous devez contrôler, vous utiliserez probablement la première option. Si vous créez un widget plus design et que vous souhaitez donner aux créateurs de sites la liberté de connecter n'importe quel champ au design, vous utiliserez le second.
Voici quelques détails sur ces deux options :
Option 1 : Connecter un élément à une collection dans Blocks
Vous pouvez connecter un élément à un champ de collection dans Blocks, en ajoutant un dataset. Si vous le faites, notez que :
- Un widget externe ne peut pas connecter un widget-interne à un dataset. Vous devez vous rendre dans le widget interne et connecter l'élément à partir de là.
- Si vous connectez un élément d'appli à un dataset, vous ne pouvez pas autoriser un créateur de site à connecter cet élément à une collection sur son site. Par conséquent, vous ne pourrez pas non plus ajouter le bouton Connecter au système de gestion de contenu (CMS)
bouton d'action à la barre d'action de cet élément. Notez que le bouton d'action sera désactivé et apparaîtra gris.
Pour connecter un élément à un champ dans Blocks :
- Accédez à l'onglet Design .
- Cliquez sur l'élément.
- Cliquez sur Connecter au Système de gestion de contenu (CMS)
dans la barre d'action. - Sélectionnez un dataset ou ajoutez-en un si vous n'en avez pas.
- Sélectionnez le champ à connecter à votre élément.
Option 2 : Permettre au créateur de site de connecter l'élément sur un site
Vous pouvez également autoriser les créateurs de sites à connecter des éléments d'appli au système de gestion de contenu (CMS) de leur site via le 
menu déroulant Connecter au système de gestion de contenu (CMS ) bouton d'action. Si vous choisissez de le faire, notez que :
menu déroulant Connecter au système de gestion de contenu (CMS ) bouton d'action. Si vous choisissez de le faire, notez que :- Une fois que l'appli est installée sur les sites des personnes et qu'elles connectent l'élément à leurs collections, si vous connectez le même élément à votre collection dans Blocks, cela rompra la fonctionnalité de l'appli sur leur site.
- Si vous avez connecté un élément à votre propre collection dans Blocks, vous ne pourrez pas ajouter ce bouton d'action à la barre d'action de l'élément.
Pour permettre aux créateurs de sites de connecter l'élément sur leur site :
- Accédez à l'onglet Configuration .
- Cliquez sur l'élément.
- Cliquez sur Modifier la barre d'action.
- Cliquez sur + Ajouter.
- Ajouter le Connecter au Système de gestion de contenu (CMS)
et acceptez la notification.
Accéder aux données de la collection avec du code
Tout d'abord, écrivez cette déclaration d'importation dans le code de votre widget :
1import wixData from 'wix-data';Pour accéder à votre collection et effectuer diverses actions, interroger, insérer, etc., utilisez la syntaxe suivante avec n'importe quelle API wix-data . Par exemple, voici comment interroger une collection (en savoir plus sur votre namespace):
1wixData.query("/") .find() .then( (results) => { //votre code utilisant les "results"; }) ;En savoir plus sur l'utilisation de l'API Wix Data
Cela vous a-t-il aidé ?
|