Home

Getting Started with Upmin Admin

Installation

Installing upmin-admin is incredibly easy. Simple add the gem to your Gemfile:

gem 'upmin-admin'

And then mount the engine in your routes.rb file:

mount Upmin::Engine => '/admin'

If you already have routes pointing to /admin you can use any path you want, for example you could use the following instead:

mount Upmin::Engine => '/ice-ice-baby'

And you would access your admin page at localhost:3000/ice-ice-baby or yoursite.com/ice-ice-baby.

If your Rails application uses will_paginate, Upmin Admin will use this instead of Kaminari. Upmin Admin uses Bootstrap for styling, so to style the pagination correctly for will_paginate, you should add the following to your Rails application's Gemfile:

gem 'will_paginate-bootstrap'

This won't impact the styling of your Rails application (unless you choose to use it, in which case please refer to the will_paginate-bootstrap documentation for details).

Customization

Almost everything inside of Upmin Admin can be customized, but sadly most of it isn't documented yet. If you can't figure out how to customize something please create an issue and we will try to help out and update the docs. Here are the documented ways to customize things:

• Configurations - This is used to customize things like which models are shown in Upmin Admin.
• Models
• Views

Support & Feedback

GitHub - Create an Issue