52 lines
1.4 KiB
Markdown
52 lines
1.4 KiB
Markdown
|
## Installation
|
||
|
|
|
||
|
|
(Note: These instructions need to be rewritten for use with the new service
|
||
|
|
locator and utility modules I've made recently.)
|
||
|
|
|
||
|
|
1. From application root: `git submodule add https://github.com/lazuscripts/users users`
|
||
|
|
|
||
|
|
2. Inside your application: `@include "users/users"`
|
||
|
|
|
||
|
|
3. In migrations, do the following:
|
||
|
|
```moonscript
|
||
|
|
import create_table, types from require "lapis.db.schema"
|
||
|
|
create_table "users", {
|
||
|
|
{"id", types.serial primary_key: true}
|
||
|
|
{"name", types.varchar unique: true}
|
||
|
|
{"digest", types.text}
|
||
|
|
{"admin", types.boolean default: false}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
4. `bcrypt` Lua Rock must be installed!
|
||
|
|
|
||
|
|
5. If `@session.redirect` is defined when going to the login route, a user will be
|
||
|
|
redirected there after logging in.
|
||
|
|
|
||
|
|
Note: Assumes you have a route named "index" to redirect to when things go
|
||
|
|
wrong.
|
||
|
|
|
||
|
|
**WARNING**: Now expects you to display informational messages stored in
|
||
|
|
`@session.info`.
|
||
|
|
|
||
|
|
## Config
|
||
|
|
|
||
|
|
`digest_rounds 9` must be set. Use a higher or lower number depending on how
|
||
|
|
long it takes to calculate a digest or how paranoid you want to be. See this bit
|
||
|
|
about tuning: https://github.com/mikejsavage/lua-bcrypt#tuning
|
||
|
|
|
||
|
|
## Access
|
||
|
|
|
||
|
|
To get the Users model for use outside of this sub-application:<br>
|
||
|
|
`Users = require "users.models.Users"`
|
||
|
|
|
||
|
|
Named routes:
|
||
|
|
|
||
|
|
- user_new
|
||
|
|
- user_me
|
||
|
|
- user_admin
|
||
|
|
- user_edit
|
||
|
|
- user_login
|
||
|
|
- user_logout
|
||
|
|
- user_list
|