Download admin panel provider - Download do código fonte admin panel provider

admin panel provider

Outras categorias

1.0.0

Baixar

Painel de administrador ✍️

O painel de administração facilita a configuração e a manutenção de recursos de administrador para o seu projeto de vapor. Aqui está uma lista de algumas das principais fendas que saem da caixa com este pacote:

Componentes da interface do usuário: O painel de administração é construído usando o AdminLTE, um modelo de painel de controle altamente testado e mantido. Isso significa que você terá acesso a recursos do adminlte através de tags de folhas.
Sistema do usuário: este pacote vem com um sistema de usuário (painel de administrador) com funções embutidas. O pacote também lida com e-mails de boas-vindas e fluxos de reset-pas-word.
Suporte ao SSO: suporte interno para adicionar seu próprio provedor SSO personalizado.
Atividades : precisa transmitir determinadas atualizações para os usuários do painel de administrador? Não há problema, o painel de administração fornece uma funcionalidade conveniente para gerenciar um log de atividades.

? Instalação

Instale o pacote usando SPM

Atualize seu arquivo Package.swift :

 . package ( url : " https://github.com/nodes-vapor/admin-panel-provider.git " , . upToNextMinor ( from : " 0.7.0 " ) ) ,

targets: [
    . target (
        name : " App " ,
        dependencies : [
            ...
            " AdminPanelProvider "
        ]
    ) ,
    ...
]

Na próxima vez que você executar, por exemplo, o painel de administração vapor update será instalado.

Instalar recursos

Copie os Resources e as pastas Public deste repositório para o seu projeto. Você pode baixar o repo como um zip e mover as pastas para a raiz do seu projeto. Lembre -se de verificar se você não está substituindo nenhum arquivo em seu projeto.

Se você estiver usando a meta, não se esqueça de adicionar os seguintes caminhos à matriz exceptPaths no meta.json :

"/bower_components/*"
"/dist/*"
"/plugins/*"

Começando

Adicionar provedor

Na sua Config+Setup.swift (ou onde quer que você configure seus provedores), adicionar o provedor do painel de administrador:

import AdminPanelProvider

// ...

private func setupProviders ( ) throws {
    // ...
    try addProvider ( AdminPanelProvider . Provider . self )
}

Também certifique -se de adicionar o provedor fluente, se ainda não foi:

 try addProvider ( FluentProvider . Provider . self )

Renderizador de visualização de configuração

Este pacote depende muito do renderizador de visualização da folha. Para que o painel de administração funcione, verifique se você adicionou o LeafProvider :

import LeafProvider

// ...

private func setupProviders ( ) throws {
    // ...
    try addProvider ( LeafProvider . Provider . self )
}

Verifique se o seu projeto está usando o Leaf como renderizador de visualização. Você pode definir o Leaf como seu renderizador, definindo a view de chave para o valor da leaf de valor em sua droplet.json . Caso ainda não tenha sido dado, basta adicioná -lo:

 "//" : " Choose which view renderer to use " ,
"//" : " leaf: Vapor's Leaf renderer " ,
"view" : " leaf " ,

Semear um usuário

Se você não adicionou um provedor de SSO, a próxima coisa que você precisa fazer é semear um usuário para poder fazer login no seu novo painel de administrador. Para fazer isso, adicione o comando SEEDER à sua matriz de commands em seu droplet.json :

 "//" : " Choose which commands this application can run " ,
"//" : " prepare: Supplied by the Fluent provider. Prepares the database (configure in fluent.json) " ,
"commands" : [
    " prepare " ,
    " admin-panel:seeder "
],

Agora você tem duas maneiras de administrar a semeadora. Você executa o semeador em seu terminal:

 vapor build; vapor run admin-panel:seeder

Ou você edita temporariamente o esquema Run no Xcode e adiciona admin-panel:seeder em "Argumentos passados no lançamento". Isso executará o semeador quando você executar o projeto. Execute o projeto e remova o argumento depois que o usuário foi semeado.

O usuário que será criado usando o semeador terá as seguintes credenciais:

E -mail: [email protected]
Senha: Admin

Vapor & Fuzzy Array

O vapor possui uma matriz Node.fuzzy usada para fundição dinamicamente em tempo de execução. Se você estiver experimentando inconsistências com os modelos de renderização, é mais provável que sua matriz difusa esteja faltando ViewData.self Verifique -se que você a adicionou à matriz ou que todos os seus modelos estão em conformidade com o JSON / Node . Exemplo Node.fuzzy :

 extension Config {
    public func setup ( ) throws {
        // allow fuzzy conversions for these types
        // (add your own types here)
        Node . fuzzy = [ JSON . self , Node . self , ViewData . self ]

Tags de folhas personalizadas

O painel de administração vem com um monte de etiquetas de folhas personalizadas que ajudam a aliviar o ônus do desenvolvimento do front -end. Confira a lista completa aqui.

Cors:

É altamente recomendável que você adicione o middleware CORS ao seu projeto.

? Configurações

O painel de administrador pode ser configurado (adicionando ou) modificando o arquivo de configuração adminpanel.json . Abaixo está um detalhamento das teclas disponíveis.

Chave	Valor de exemplo	Obrigatório	Descrição
`name`	`My Tech Blog`	Não	Este será o título dentro do painel de administrador.
`baseUrl`	`http://mytechblog.com`	Não	Isso será usado para gerar URLs para o painel de administração (por exemplo, ao redefinir uma senha).
`skin`	`green-light`	Não	A pele a ser usada para o painel de administrador. As opções corresponderão às peles disponíveis suportadas pelo Adminlte. Por favor, omite o prefixo `skin-` ao especificar a pele.
`email`	`{"fromName": "Admin Panel", "fromAddress": "[email protected]"}` `	Não	Isso será usado para configurar a correspondência do adminPanel.