Wix Blocks: criar e gerenciar coleções
3 min de leitura
O Wix Blocks está aberto a todos os usuários do Wix Studio. Para ter acesso ao Wix Blocks, junte-se ao Wix Studio.
O Wix Blocks permite que você adicione coleções (bancos de dados) ao seu aplicativo. Gerenciar coleções no Blocks é semelhante a gerenciar coleções nos sites Wix. Mas há alguns pontos que são muito diferentes. Confira neste artigo.
Dica
Preste atenção às permissões de coleção e suas diretrizes de segurança.
Uma coleção no Blocks é um placeholder
A coisa mais importante a entender sobre uma coleção no Blocks é que ela é um placeholder para os dados de qualquer site em que está instalada. Isso ocorre porque uma coleção no Blocks pode ser usada em vários sites, até mesmo em milhares deles. Esses sites podem ser muito diferentes uns dos outros e ter seus próprios bancos de dados. Pense em uma coleção que contém informações de um cliente. Cada site pode ter uma lista de seus próprios clientes e seu widget pode se aplicar a todos eles.
Ao criar uma coleção no Blocks, você define os campos da coleção e possibilita referir-se a ela no código do aplicativo. Você também pode adicionar dados padrão no Blocks, mas isso não é obrigatório. Se você adicionar dados padrão, eles serão instalados automaticamente no site junto com o aplicativo e, posteriormente, podem ser substituídos por dados de qualquer site em que o aplicativo está instalado.
Se você alterar a estrutura de uma coleção no Blocks em uma versão futura do seu aplicativo, isso afetará qualquer site em que está instalado. Portanto, tenha cuidado e não faça alterações que possam danificar o site.
Observação
As coleções do Blocks são contadas de acordo com o limite de itens e coleções do CMS.
Sobre os dados padrão
Os dados que você adicionar às suas coleções do Blocks serão importados para o site em que seu aplicativo está instalado, fornecendo aos criadores do seu site dados padrão para o seu aplicativo. Se você optar por adicionar dados padrão, observe que:
- O site em que seu aplicativo está instalado pode alterar esses dados posteriormente.
- Os dados padrão só serão importados na primeira instalação. Se você lançar uma nova versão do seu aplicativo e alterar os dados na coleção, isso não substituirá os dados que já existem em qualquer site em que seu aplicativo está instalado.
Adicionar uma coleção ao seu aplicativo
- Clique no ícone Banco de dados
no menu à esquerda do seu aplicativo. - Clique em Nova coleção.
- Crie um namespace para o seu aplicativo, caso você ainda não o tenha. Torne o namespace significativo e claro (se você ainda não nomeou seu aplicativo, agora será solicitado que você dê um nome a ele).
- Dê um nome à sua coleção.
- Defina a estrutura da sua coleção no CMS.
- Opcional - adicione itens à sua coleção. Esses dados padrão serão importados junto com seu aplicativo para qualquer site em que ele estiver instalado
Veja sua coleção no Editor
Quando você importa um aplicativo do Blocks que tem uma coleção para o seu site, a coleção aparecerá na seção CMS 
, em Suas coleções. O namespace do seu aplicativo aparecerá ao lado dessa coleção, para indicar que ele é do Blocks. Agora você pode gerenciar sua coleção como em qualquer outro site Wix.
, em Suas coleções. O namespace do seu aplicativo aparecerá ao lado dessa coleção, para indicar que ele é do Blocks. Agora você pode gerenciar sua coleção como em qualquer outro site Wix. Importante
Se você excluir o aplicativo do site, a coleção também será excluída.
Acesse os dados da coleção através do código
Primeiro, escreva esta declaração import no código do widget:
1import wixData from 'wix-data';Para acessar sua coleção e executar várias ações, consultar, inserir etc., use a seguinte sintaxe com qualquer API wix-data. Por exemplo, é assim que você consulta uma coleção (saiba mais sobre seu namespace):
1wixData.query("<yourAppNamespace>/<yourCollectionName>")
2 .find()
3 .then( (results) => {
4 //your code using the "results";
5 });Saiba mais sobre como trabalhar com a API de dados do Wix
Esse artigo foi útil?
|