Gerenciando Seções

Seções permitem criar conteúdo único na sua área de trabalho, organizando-o em categorias para facilitar seu acesso. Nessa página, vamos explicar como criar e gerenciar Seções, além de mostrar como gerenciar suas categorias.

Criando Seções

O processo de criação de uma Seção é bem parecido ao da criação de um modelo, e sua estrutura também pode ser modificada de forma similar. Você pode criar Seções utilizando o mesmo editor de estrutura que modelos e formulários, e todos os tipos de grupo e campos disponíveis para modelos também ficam disponíveis para Seções. Além disso, gerenciar o conteúdo de uma Seção funciona da mesma maneira que gerenciar o conteúdo de uma entrada.

Para criar uma Seção, basta entrar em uma área de trabalho, clicar em "Seções" no menu lateral do Starlight, acessar "Todas as Seções" e então clicar em "Criar seção" no canto superior direito. Ao criar uma Seção, você verá os seguintes dados:

• Um nome (que será utilizado para identificar a Seção na interface, por exemplo: Carro do Mês)
• Um slug (que identificará unicamente a Seção, por exemplo: carro-do-mes)
• Uma categoria (que é a categoria em que a Seção será organizada, e pode ser alterada a qualquer momento; por padrão, todas as áreas de trabalho começam com uma categoria "Páginas")
• Uma estrutura (que será utilizado para definir os grupos e campos de conteúdo da Seção)

Sobre os campos

Você pode aprender mais sobre grupos e campos na página sobre campos de modelos.

Quando estiver satisfeito com a estrutura e tiver preenchido o nome, slug e categoria da Seção, basta clicar em "Salvar" no canto superior direito. Após criada, você será redirecionado à página de edição do conteúdo da Seção.

Modificando a estrutura

Para modificar a estrutura de uma Seção, entre em uma área de trabalho, clique em "Seções" no menu lateral do Starlight, acesse "Todas as Seções" ou a categoria da Seção procurada, clique no botão de três pontos ao lado da Seção que deseja modificar, e finalmente clique em "Editar Seção". Para salvar as mudanças feitas, basta clicar em "Salvar" no canto superior direito.

Chaves dos campos

Antes de tudo, é importante explicar como o Starlight lida com mudanças de chaves dos seus campos. Atualmente, quando um desenvolvedor atualiza a chave de um campo, o conteúdo daquele campo na Seção desaparecerá da interface, mas o conteúdo não será apagado ou perdido - se você alterar a chave de volta para o nome antigo, os dados antigos reaparecerão. O mesmo acontecerá quando um campo é apagado - os dados presentes nesses campos não serão perdidos caso você desfaça a alteração da estrutura.

Por conta disso, não é recomendado mudar as chaves dos campos ou apagá-los, apesar de ser possível. Uma alternativa melhor para isso seria arquivar o campo com o nome antigo (ao invés de renomeá-lo) e criar um campo com o novo nome. Dessa forma, tanto os dados antigos quanto os novos seriam retornados pela API, e o campo antigo não aparecerá no editor de entradas por padrão (mas ainda pode ser visto com a opção "Mostrar campos arquivados").

Modificando o conteúdo

Para modificar o conteúdo de uma Seção, entre em uma área de trabalho, clique em "Seções" no menu lateral do Starlight e então selecione uma das Seções da listagem. Para salvar as mudanças feitas, basta clicar em "Salvar" no canto superior direito.

Visualização na API

Ao lado do botão de "Salvar" na página de edição de conteúdo, há um botão de "Visualizar na API". Ao clicar nele, você será redirecionado para uma página que contém apenas o JSON com informações gerais daquela Seção, como a data de criação e os seus dados. Dependendo do navegador, o JSON poderá ser meio ilegível nessa forma "crua" (não-formatada), mas existem extensões nos navegadores que permitem uma melhor visualização, como essa para o Chrome. Já o Firefox, por exemplo, tem um visualizador de JSON nativo.

Usuários autorizados a visualizar

Apenas administradores ou usuários com permissão de criar ou editar Seções verão esse botão.

Apagando Seções

Para apagar uma Seção, entre em uma área de trabalho, clique em "Seções" no menu lateral do Starlight, acesse "Todas as Seções" ou a categoria da Seção procurada, clique no botão de três pontos ao lado da Seção que deseja apagar, e clique em "Apagar...".