Sitio de demostración | Código fuente de demostración
Un marco de administración moderno y responsivo para Ruby on Rails
Para comenzar a usar Trestle, primero agréguelo al Gemfile de su aplicación:
gema 'caballete'
Ejecute bundle install
y luego ejecute el generador de instalación para crear el archivo de configuración inicial y los enlaces de personalización:
$ rails generate trestle:install
Luego cree su primer recurso de administración (suponiendo que tenga un modelo Article
existente):
$ rails generate trestle:resource Article
Después de reiniciar su servidor Rails, visite http://localhost:3000/admin para ver su administrador recién creado. Encontrará la definición de administrador en app/admin/articles_admin.rb
lista para personalizar.
Trestle.resource(:publicaciones) hacer # Agregar un enlace a este administrador en la navegación principal menú dogroup:blog_management, prioridad::primer elemento de tarea:publicaciones, ícono: "fa fa-file-text-o"end fin # Definir ámbitos personalizados para la vista de índice ámbitos doscope: todos, predeterminado: truescope: publicadoscope: borradores, -> {Post.unpublished} fin # Definir el listado de la tabla de vista de índice columna docolumna de tabla: título, enlace: columna verdadera: autor, ->(publicación) {post.autor.nombre}columna: publicado, alinear:: centro hacer |publicación| status_tag(icon("fa fa-check"), :éxito) si post.published?endcolumn :updated_at, encabezado: "Última actualización", alinear: :centeractions fin # Definir la estructura del formulario para las acciones nuevas y de edición. form do# Organizar campos en pestañas y barras laterales tab :post do text_field :title # Definir campos de formulario personalizados para facilitar su reutilización editor :bodyendtab :metadata do # Diseñar campos basados en una fila de cuadrícula de 12 columnas docol(sm: 6) { select :author, User.all }col(sm: 6) { tag_select :tags } endendsidebar do # Representar un parcial personalizado: app/views/admin/posts/_sidebar.html.erb renderizar "barra lateral" final final
Los siguientes complementos están actualmente disponibles:
Nombre | Descripción | Campo de golf |
---|---|---|
autenticación de caballete | Complemento de autenticación de usuario | GitHub | rubígemas |
búsqueda de caballete | Complemento de búsqueda | GitHub | rubígemas |
caballete-tinymce | Integración de TinyMCE (editor WYSIWYG) | GitHub | rubígemas |
caballete-simple | Integración con SimpleMDE (editor Markdown) | GitHub | rubígemas |
caballete-sidekiq | Integración con Sidekiq | GitHub | rubígemas |
caballete-almacenamiento_activo | Integración de almacenamiento activo | GitHub | rubígemas |
movilidad de caballete | Integración de la movilidad | GitHub | rubígemas |
caballete-omniauth | Complemento de autenticación OmniAuth | GitHub | rubígemas |
caballete-auth-otp | Autenticación de usuario 2FA/OTP | GitHub | rubígemas |
Consulte CONTRIBUTING.md para obtener información sobre cómo desarrollar y contribuir a Trestle.
La gema está disponible como código abierto según los términos de la licencia LGPLv3.