README.md
# Haytni
Haytni is a configurable authentication system for Phoenix, inspired (and yet the word is weak) by Devise (should be almost compatible with it).
Goals:
* security focused
* provides a strong and ready to use base
* non-bloatware:
+ all logics are not located in controllers
+ minimize changes (upgrade)
* easily customisable and extendable:
+ enable (or disable) any plugin
+ add your own plugin(s) to the stack
The only things you install in your project are:
* migrations
* views (you may need some custom helpers for your templates)
* templates (for emails and web pages)
If you need your own feature(s), you write (and test) your own plugin(s):
* no need to change some obscur and very long code you may not understand, you just need to implement the callbacks that feet your needs
* your changes will not impact and break anything else (starting by tests)
Plugins:
* [authenticable](https://hexdocs.pm/haytni/Haytni.AuthenticablePlugin.html) (`Haytni.AuthenticablePlugin`): handles hashing and storing an encrypted password in the database
* [registerable](https://hexdocs.pm/haytni/Haytni.RegisterablePlugin.html) (`Haytni.RegisterablePlugin`): the elements to create a new account or edit its own account
* [rememberable](https://hexdocs.pm/haytni/Haytni.RememberablePlugin.html) (`Haytni.RememberablePlugin`): provides "persistent" authentication (the "remember me" feature)
* [confirmable](https://hexdocs.pm/haytni/Haytni.ConfirmablePlugin.html) (`Haytni.ConfirmablePlugin`): accounts have to be validated by email
* [recoverable](https://hexdocs.pm/haytni/Haytni.RecoverablePlugin.html) (`Haytni.RecoverablePlugin`): recover for a forgotten password
* [lockable](https://hexdocs.pm/haytni/Haytni.LockablePlugin.html) (`Haytni.LockablePlugin`): automatic lock an account after a number of failed attempts to sign in
* [trackable](https://hexdocs.pm/haytni/Haytni.TrackablePlugin.html) (`Haytni.TrackablePlugin`): register users's connections (IP + when)
* [invitable](https://hexdocs.pm/haytni/Haytni.InvitablePlugin.html) (`Haytni.InvitablePlugin`): registration on invitation or sponsorship
Documentation can be found at [https://hexdocs.pm/haytni](https://hexdocs.pm/haytni).
Installation is described [here](https://hexdocs.pm/haytni/installation.html).
**BEWARE**: this README (and the whole master branch) might be out of sync with hexdocs (last release)