trestle

Caballete

Sitio de demostración | Código fuente de demostración

Un marco de administración moderno y responsivo para Ruby on Rails

Empezando

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.

Ejemplo

 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

Complementos

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

Desarrollo

Consulte CONTRIBUTING.md para obtener información sobre cómo desarrollar y contribuir a Trestle.

Licencia

La gema está disponible como código abierto según los términos de la licencia LGPLv3.