Sha256: ee78e4bd3e6dcb66c5a6e3a658fe1aa9012fe23161daa13b419393a42a1e8ab3

Contents?: true

Size: 1.88 KB

Versions: 2

Compression:

Stored size: 1.88 KB

Contents

# ActiveAdmin Sidebar

Provides ability to manipulate sidebar position for ActiveAdmin (tested with ActiveAdmin ~> 1.0.0)

## Install

```ruby
gem 'active_admin_sidebar'
# or latest from GitHub
gem 'active_admin_sidebar', git: 'https://github.com/activeadmin-plugins/active_admin_sidebar.git'
```

Add including of CSS file

```scss
  @import "active_admin_sidebar";
```

to the  
```
app/assets/stylesheets/active_admin.css.scss
```

And including of coffee file (optional, need only for collapsed sidebar)

```coffeescript
  #= require active_admin_sidebar
```

to the  

```scss
app/assets/javascripts/active_admin.js
```

# Configuration per resource

Changing sidebar position dynamically with before_action

```ruby
  # app/admin/posts.rb
  ActiveAdmin.register Post do
    before_action :left_sidebar!, only: [:show]
  end

  # app/admin/comments.rb
  ActiveAdmin.register Comment do
    before_action :right_sidebar!
  end
```

## Global configuration

Moving sidebar to the left within all resource. Set configuration in `config/initializers/active_admin.rb`

```ruby
  # == Controller before-actions
  #
  # You can add before, after and around actions to all of your resources
  ActiveAdmin.setup do |config|
    config.before_action do
      left_sidebar! if respond_to?(:left_sidebar!)
    end
  end
```

## Collapsing sidebar

You can use sidebar collapsing.
It will add "hide/show" button. Shown/Hidden state is persisted across all pages.

```ruby
  left_sidebar!(collapsed: true)
```

You can override button color according to your color theme. For example:

```scss
  body.active_admin {
    #active_admin_content.left_sidebar, #active_admin_content.collapsed_sidebar {
      .collapse_btn, .uncollapse_btn {
          background-color: #767270;
      }
    }
   }
```

Example

![Alt text](https://raw.githubusercontent.com/activeadmin-plugins/active_admin_sidebar/master/screen/sidebar.jpg "Example")

Version data entries

2 entries across 2 versions & 1 rubygems

Version Path
active_admin_sidebar-1.1.0 README.md
active_admin_sidebar-1.0.0 README.md