Administração · Docs

O admin em /nb-admin/ faz parte de todo site Nimbly. Ele é gerado a partir das definições de recursos, então um recurso novo ganha suas telas assim que o .meta dele existe. O que um usuário vê segue a função dele.

Painel

O painel mostra o que precisa de atenção e o que o site contém:

Needs attention: jobs falhos, um erro fatal recente, pouco espaço em disco, ou assets que precisam de um novo build após uma atualização do core.
Site status: quando os dados mudaram pela última vez, se o core e a aplicação estão atualizados, com uma ação de atualização para funções que podem atualizar, e a memória e o disco do servidor.
Visits: visitas, visualizações de página e tráfego de bots dos últimos 30 dias, para funções com view-stats.
Your data: todos os recursos que o usuário pode ver, com número de registros, tamanho e última alteração, e um link para o histórico.
Manage: usuários e funções, a biblioteca de mídia e a fila de jobs com suas ações de manutenção.

Uma aplicação acrescenta seu próprio painel com um dashboard-band.tpl em ext/tpl/ ou no tpl/ de um módulo.

Telas de recursos

Endereço	Tela
`/nb-admin/<resource>`	Visão geral com as colunas, a busca, os filtros e a paginação que o `.meta` define
`/nb-admin/<resource>/add`	Formulário para adicionar um registro, com importação de documento quando configurada
`/nb-admin/<resource>/<uuid>`	Formulário para editar um registro, com o painel de ações
`/nb-admin/<resource>/<uuid>/history`	Todas as alterações do registro, com restauração
`/nb-admin/<resource>/history`	As últimas alterações do recurso inteiro, incluindo registros excluídos

O painel de ações ao lado de um registro mostra as últimas alterações e as ações do registro. Um recurso acrescenta ações próprias, como um link de visualização, com record_actions no seu .meta; actions.url acrescenta um link para o registro no site.

Entre registros, um seletor pula para o próximo registro sem voltar à visão geral.

Histórico

Toda criação, alteração e exclusão feita por um usuário autenticado, um usuário da API ou um agente é guardada, com quem fez, quando e quais campos mudaram. Restore devolve um registro ao estado anterior a uma alteração, e um registro excluído pode ser restaurado a partir do histórico do recurso. O histórico é mantido por 90 dias. Textos de página editados no próprio lugar, configurações de página e menus também têm histórico.

Configurações

/nb-admin/settings edita o nome e a descrição do site, os idiomas, a direção do texto e o lado da barra do Nimbly. Nome, descrição e direção são definidos por idioma. Usuários com manage-system também ligam ou desligam aqui as páginas personalizadas e a edição da navegação.

As configurações de uma página, como o título, são editadas a partir da própria página, pelas ações da página.

Usuários e funções

/nb-admin/users e /nb-admin/roles gerenciam contas e permissões. A tela de funções mostra uma linha por recurso com uma caixa por operação e uma coluna para gerenciar tudo nesse recurso. Veja Usuários e permissões. O painel de ações de um usuário tem a chave API access, que decide se esse usuário pode pedir tokens da API.

Biblioteca de mídia

/nb-admin/media lista todos os envios, mostra onde cada um é usado e remove arquivos que não são mais necessários. Veja Mídia e edição inline.

Jobs

/nb-admin/jobs mostra a fila: jobs na fila, em execução, concluídos e falhos, com o último erro, e executa sob pedido os jobs pendentes ou remove os antigos. Veja Trabalho em segundo plano.

Substituindo uma tela do admin

O admin é um módulo do core, e suas rotas e templates são procurados primeiro em ext/, como todo o resto. Um projeto substitui uma tela colocando uma rota ou um template com o mesmo caminho em ext/, e deixa o resto com o core.