trestle

Cavalete

Site de demonstração | Código-fonte de demonstração

Uma estrutura administrativa moderna e responsiva para Ruby on Rails

Começando

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.

Exemplo

 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

Plug-ins

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

Desenvolvimento

Consulte CONTRIBUTING.md para obter informações sobre como desenvolver e contribuir para Trestle.

Licença

A gema está disponível como código aberto sob os termos da licença LGPLv3.