Site de demonstração | Código-fonte de demonstração
Uma estrutura administrativa moderna e responsiva para Ruby on Rails
Para começar a usar o Trestle, primeiro adicione-o ao Gemfile da sua aplicação:
gema 'cavalete'
Execute bundle install
e, em seguida, execute o gerador de instalação para criar o arquivo de configuração inicial e os ganchos de personalização:
$ rails generate trestle:install
Em seguida, crie seu primeiro recurso administrativo (supondo que você tenha um modelo Article
existente):
$ rails generate trestle:resource Article
Após reiniciar seu servidor Rails, visite http://localhost:3000/admin para visualizar seu administrador recém-criado. Você encontrará a definição de administrador em app/admin/articles_admin.rb
pronta para personalizar.
Trestle.resource(:postagens) fazer # Adicione um link para este administrador na navegação principal menu dogroup:blog_management,priority::first do item:posts, icon: "fa fa-file-text-o"end fim # Defina escopos personalizados para a visualização do índice escopos doscope: todos, padrão: truescope: publishedscope: rascunhos, -> {Post.unpublished} fim # Define a listagem da tabela de visualização do índice tabela docoluna: título, link: truecolumn: autor, -> (post) { post.author.name }coluna: publicado, alinhar:: centro do |post| status_tag(icon("fa fa-check"), :success) if post.published?endcolumn :updated_at, header: "Última atualização", alinhamento: :centeractions fim # Defina a estrutura do formulário para as ações novas e editadas form do# Organize os campos em guias e sidebarstab :post do text_field :title # Defina campos de formulário personalizados para facilitar a reutilização editor :bodyendtab :metadata do # Layout dos campos com base em uma grade de 12 colunas row docol(sm: 6) { select :author, User.all }col(sm: 6) { tag_select :tags } endendsidebar do # Renderiza uma parcial personalizada: app/views/admin/posts/_sidebar.html.erb renderiza "barra lateral" final fim
Os seguintes plug-ins estão disponíveis atualmente:
Nome | Descrição | Ligações |
---|---|---|
cavalete-auth | Plug-in de autenticação de usuário | GitHub | Ruby Gems |
pesquisa de cavalete | Plug-in de pesquisa | GitHub | Ruby Gems |
cavalete-tinymce | Integração TinyMCE (editor WYSIWYG) | GitHub | Ruby Gems |
cavalete-simples | Integração SimpleMDE (editor Markdown) | GitHub | Ruby Gems |
cavalete-sidekiq | Integração Sidekiq | GitHub | Ruby Gems |
cavalete-ativo_storage | Integração de armazenamento ativo | GitHub | Ruby Gems |
mobilidade por cavalete | Integração de mobilidade | GitHub | Ruby Gems |
cavalete-omniauth | Plug-in de autenticação OmniAuth | GitHub | Ruby Gems |
cavalete-auth-otp | Autenticação de usuário 2FA/OTP | Github | Ruby Gems |
Consulte CONTRIBUTING.md para obter informações sobre como desenvolver e contribuir para Trestle.
A gema está disponível como código aberto sob os termos da licença LGPLv3.