Introdução

Atributos são uma entidade que permite configurar a estrutura do seu aplicativo. Com eles, você ganha o máximo de flexibilidade e evita valores fixos no código.

Um conjunto de atributos é como uma coleção de propriedades cujos valores você gerencia pelo painel de administração. Os conjuntos diferem pelo tipo de vinculação a entidades. Os tipos estão descritos na seção "Tipos". (abre em uma nova aba)

Um conjunto de atributos define a estrutura dos dados que você depois usa no seu projeto. Por exemplo, você pode definir que a estrutura de um produto contém nome, imagem, preço e descrição em texto. Já a estrutura de um artigo de blog pode conter um texto com título e um conjunto de imagens.

Alguns atributos podem ter estrutura parecida e ser usados em entidades diferentes, por isso você pode reutilizar um conjunto de atributos em várias entidades.

Estrutura

Cada conjunto de atributos contém uma coleção configurável de atributos que armazenam o conteúdo do seu projeto. Você gerencia esses atributos pelo sistema de gerenciamento, então não precisa mais editar o código do aplicativo para alterar o projeto. Basta mover para atributos todo o conteúdo que pode mudar.

Marcadores

Marcadores não podem conter espaços nem começar com um número. Se você digitar um valor inválido no campo do marcador, o sistema ignora a entrada.

Nome

Para facilitar a orientação, cada atributo tem um nome obrigatório, que é uma string não única. Dê aos atributos nomes que facilitem o seu trabalho com eles.

Marcador

Cada atributo tem um parâmetro obrigatório, o "marcador", que é uma string única e funciona como identificador. O marcador também é a chave para acessar o atributo no código do seu projeto. Leve isso em conta ao definir o marcador, para evitar conflitos de sintaxe.

Tipo de dados

Escolha o tipo dos dados que cada campo do atributo vai armazenar.

Os tipos de dados disponíveis são:

• String: texto simples, por exemplo, "Olá, mundo!".
• Texto (Text): texto mais longo, muitas vezes formatado, por exemplo, um artigo ou uma carta.
• Texto com título (Text with header): texto com um título, que pode indicar um tema ou uma categoria.
• Inteiro (Integer): número inteiro, por exemplo, 5, 100, -2.
• Número real (Real): o mesmo que Float, mas com maior precisão.
• Ponto flutuante (Float): números de ponto flutuante, que podem ter parte decimal, por exemplo, 3.14, 1.5, -0.25.
• Data e hora (Date and Time): combinação de data e hora, por exemplo, 2023-10-27 10:00:00.
• Data (Date): data, por exemplo, 2023-10-27.
• Hora (Time): hora, por exemplo, 10:00:00.
• Arquivo (File): qualquer arquivo do seu computador, por exemplo, um documento, uma imagem ou uma música.
• Imagem (Image): imagem, por exemplo, uma foto ou um desenho.
• Grupo de imagens (Group of Images): coleção de imagens, por exemplo, um álbum de fotos.
• Botão de opção (Radio Button): botão de seleção que permite escolher apenas uma opção.
• Lista (List): lista de itens, por exemplo, uma lista de tamanhos de produtos.
• Proteção contra spam (Spam Protection): captcha que protege o formulário contra envios automáticos.
• Botão (Button): botão com um valor definido.
• Entidade (Entity): entidade que representa um objeto do mundo real, por exemplo, uma pessoa, um lugar ou uma organização.
• Intervalo de tempo (Time interval): calendário para criar, planejar e gerenciar intervalos de tempo.
• JSON: armazena dados no formato JSON.

Cada tipo está descrito em detalhes na seção "Tipos". (abre em uma nova aba)

A interface de preenchimento de conteúdo de cada campo do atributo corresponde ao tipo de dados escolhido.

Conjunto de atributos do sistema

Você pode criar um conjunto de atributos do sistema separado. Ele não está associado a nenhuma coleção e permite armazenar dados arbitrários. Para preenchê-lo, abra a página de edição do conjunto.

Recursos

Você pode adicionar validadores aos atributos. Esse mecanismo está descrito em detalhes na seção "Validators". (abre em uma nova aba)

Atributos

Se um conjunto de atributos é usado por várias entidades, tenha cuidado ao alterar os atributos desse conjunto. Se você excluir um atributo, ele será removido, junto com o conteúdo, de todos os lugares onde é usado. Se você adicionar um novo atributo ao conjunto, ele também será adicionado a todos os lugares onde esse conjunto é usado.