Skip to content

jkpchang/administrate-bootstrap

 
 

Repository files navigation

UPDATES / Modifications in this fork

- Currency Field: Similar to Number field, but prefixed with $ and using currency converter to display the number better.
- Paperclip Field: Display thumbnail of Paperclip pictures properly.
- Font Picker Field: Nice widget to pick Google Fonts
- Color Picker Field: Nice widget to pick color
- TinyMCE Field: Use TinyMCE widget to write HTML
- Replace all styles with Bootstrap (currently using Bootstrap 3.3.7).

FUTURE UPDATES PLANNED in this fork

- Better UI support for Has_Many and allow users to create new parent objects easily via Bootstrap modals.
- Port some of the nicer UI features from rails_admin to here, while maintaining the overall design of Administrate.

Administrate

Circle CI Gem Version Code Climate

A framework for creating flexible, powerful admin dashboards in Rails. Try the demo.

Warning:

Administrate is still pre-1.0, and there may be occasional breaking changes to the API. Check the release notes for important updates.

administrate

What Is Administrate?

Administrate is a library for Rails apps that automatically generates admin dashboards. Administrate's admin dashboards give non-technical users clean interfaces that allow them to create, edit, search, and delete records for any model in the application.

Administrate solves the same problem as Rails Admin and ActiveAdmin, but aims to provide a better user experience for site admins, and to be easier for developers to customize.

To accomplish these goals, Administrate follows a few guiding principles:

  • No DSLs (domain-specific languages)
  • Support the simplest use cases, and let the user override defaults with standard tools such as plain Rails controllers and views.
  • Break up the library into core components and plugins, so each component stays small and easy to maintain.

Getting Started

Add Administrate to your Gemfile:

# Gemfile
gem "administrate", "~> 0.2.2"

Re-bundle, then run the installer:

$ rails generate administrate:install

Restart your server, and visit http://localhost:3000/admin to see your new dashboard in action.

To customize the appearance, behavior, and contents of the dashboard, see the guides at http://administrate-docs.herokuapp.com.

Repository Structure

This repository contains both the source code for Administrate, and a demo Rails app that uses Administrate. The demo app is hosted publicly on Heroku.

  • The gem's source code lives in the app and lib subdirectories.
  • The demo app is nested within spec/example_app.

Rails configuration files have been changed to recognize the app in the new location, so running the server or deploying to Heroku works normally.

With this structure, developing a typical feature looks like:

  • Add tests in spec/
  • Implement a feature in administrate/
  • Exercise the feature using the demo rails app (spec/example_app/app/)

Contributing Guidelines

Use the following guides for getting things done, programming well, and programming in style.

About

Rails administrate admin engine, with Bootstrap styling and several custom fields.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 51.4%
  • JavaScript 26.3%
  • HTML 18.5%
  • SCSS 2.8%
  • Other 1.0%