# Hierarchy
`Hierarchy` is an internal model of `Monarchy` and should not be used unless it is really necessary.

> hmm... sounds like `private`

## Methods

### #accessible_for
You can check if user has an access to the hierarchy by calling `accessible_for(user, options = {})` on hierarchy instance, eg:
```ruby
resource_hierarchy.accessible_for(user) # returns TRUE or FALSE
```

Optionally, you can pass an `options` argument to specify custom strategy.

** We do not recommend to use it but if yo have to: **
We are using [Closure Tree][e5c808aa] behind `Hierarchy` class. There is a bunch of methods and functions available behind the hood. Check their documentation.

  [e5c808aa]: https://github.com/mceachen/closure_tree "Closure Tree"

## Scopes:

### .accessible_for
You can select all hierarchies accessible for specific user by using a scope: `accessible_for`, eg:
``` ruby
Monarchy.hierarchy_class.accessible_for(current_user)   # returns [hierarchy1, hierarchy2, hierarchy5]
```

#### Options
Optionally you can pass extra allowed roles which should be inherited for this request
``` ruby
Monarchy.hierarchy_class.accessible_for(current_user, { inherited_roles: [:blocked, :visitors] })   # returns [hierarchy1, hierarchy2, hierarchy5, hierarchy6]
```

You can also determine if read (default role) access in resource should allow to access theirs children

```ruby
Monarchy.hierarchy_class.accessible_for(current_user, { parent_access: true })
#                     (GRANTED) hierarchy1
#                                   |
#                                   |
#              (GRANTED) hierarchy2   hierarchy4 (GRANTED cuz it's a parent of granted resource)
#                            |            |
#                            |            |
#                            |       hierarchy5 (NOT granted - it's not a child of granted resource)
#                            |
#                            |
#                        hierarchy3 (member role - GRANTED)
```

### .in(resource, true)
You can select all hierarchies scoped into another by using scope: `in`:

- If the second argument is `true` (`true` is by default):
``` ruby
Monarchy.hierarchy_class.in(project.hierarchy) # returns [hierarchy1, hierarchy2, hierarchy5]
```
It will returns for you all `hierarchies` which parent is `project.hierarchy` or one of his children.

- If the second argument is `false`:
``` ruby
Monarchy.hierarchy_class.in(project.hierarchy, false) # returns [hierarchy1, hierarchy2]
```
It will returns for you all `hierarchies` which parent is `project.hierarchy`


## Relations

### #members
Return all members explicitly granted to the hierarchy.

### #users
Returns all users which have been granted explicitly to the hierarchy.

### #resource
Returns a resource model of the hierarchy.