# vue-acl3

> Plugin of Access Control List from Vue JS 2

Latest version **1.0.5** (published 2017-07-03) · ISC license · 0 weekly downloads

## Install

```sh
npm install vue-acl3
pnpm add vue-acl3
yarn add vue-acl3
bun add vue-acl3
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.5 |
| Published | 2017-07-03 |
| First published | 2017-06-05 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | Leonardo Vilarinho |
| Maintainers | tenstone |
| Keywords | acl, vuejs, control, user |

## Links

- npm: https://www.npmjs.com/package/vue-acl3
- Repository: https://github.com/tenstone/vue-acl
- Homepage: https://github.com/tenstone/vue-acl#readme
- Issues: https://github.com/tenstone/vue-acl/issues
- npm.io page: https://npm.io/package/vue-acl3

## Recent versions

- 1.0.5 (latest) — 2017-07-03
- 1.0.4 (vue-acl3@1.0.4) — 2017-06-05
- 1.0.3 (vue-acl3@1.0.3) — 2017-06-05
- 1.0.2 (vue-acl3@1.0.2) — 2017-06-05
- 1.0.1 (vue-acl3@1.0.1) — 2017-06-05
- 1.0.0 (vue-acl3@1.0.0) — 2017-06-05

## README

# Plugin of Access Control List from Vue JS 2

>This plugin aims to control the layout of the system and block access to certain routes of the vue-router, that according to the current active permission on the system.

### Dependencies:
- VueJS version 2
- vue-router

### Installation

We have two methods of installed, you can use the npm or a standalone.

#### To install with NPM

Use the following command to install as dependency:
```bash
npm install vue-acl3 --save
```
#### For standalone installation

To install just copy the file `src/Acl.js` to your plugins directory.

### Get Started:

**[1]:** Import the plugin and register it on VueJS, it is necessary to send as a parameter the vue router-router and the default system permission:

```js
import Acl from 'vue-acl3'
Vue.use( Acl, { router: Router, init: 'any|admin' } )
```

**[2]:** Add metadata in their routes saying which permission required to access the route, use pipe (|) to separate more than one permission, other metadata used is the ' fail ', which will indicate which route to redirect on error:
```js
[
  {
    path: '/',
    component: require('./components/Public.vue'),
  },
  {
    path: '/manager',
    component: require('./components/Manager.vue'),
    meta: {
      permission: 'admin',
      fail: '/error'
    }
  },
  {
    path: '/client',
    component: require('./components/Client.vue'),
    meta: {
      permission: 'any',
      fail: '/error'
    }
  },
  {
    path: '/error',
    component: require('./components/Error.vue'),
  },
]
```



**[3]:** The components use the global method `$can()` to verify that the system gives access to permission passed by parameter:
```vue
<router-link v-show='$can("any")' to='/client'>To client</router-link> |
<router-link v-show='$can("admin")' to='/manager'>To manager</router-link> |
<router-link v-show='$can("admin")' to='/'>To Public</router-link>
```
This method receives a parameter with the permissions to check, separated by a pipe (|), and returns a `bool` saying if permission has been granted.

To change the current system permission use the global method `$access()`, passing as parameter the new permission:
```js
 this.$access(['admin','any'])
```
To see the current system permission, just call the `$access()` method with no parameter.

### Contributing

To help in the development and expansion of this repository take a FORK to your account, after you have made your modifications do a PULL REQUEST, it will be parsed and included here since it helps the plugin.

If you prefer, write code ES5 and transpile to ES6 using the Babel.

Node dependencies need to be written in ES5, but chose to write the plugin in ES6, using so the Babel to convert the code:

https://babeljs.io/repl/

### Demo
To install demo run:
```bash
npm run demo:install
```
To execute, run:
```js
npm run demo
```

---
_Source: https://npm.io/package/vue-acl3 · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
