ProductPromotion
Logo

Elixir

made by https://0x3d.site

GitHub - trenpixster/addict: User management lib for Phoenix Framework
User management lib for Phoenix Framework. Contribute to trenpixster/addict development by creating an account on GitHub.
Visit Site

GitHub - trenpixster/addict: User management lib for Phoenix Framework

GitHub - trenpixster/addict: User management lib for Phoenix Framework

Build Status Hex.pm Hex.pm Deps Status Inline docs

Addict

Addict allows you to manage users registration and authentication on your Phoenix Framework app easily.

What does it do?

For now, it enables your users to register, login, logout and recover/reset their passwords.

Requirements

Addict is dependent on an ecto User model and a database connection interface.

The user model must have at least the following schema:

  field :email, :string
  field :encrypted_password, :string

Plug and go

1 - Add Addict to your dependencies:

 {:addict, "~> 0.3"}

1a - Note that mailgun locks Poison to an old 1.4 version, which may cause conflicts (Poison). There's a fix in place that just hasn't been pushed to hex. Resolve by also adding to your dependencies:

 {:mailgun, github: "chrismccord/mailgun", branch: "master", override: true}

2 - Generate Addict configs via:

mix addict.generate.configs

3 - Generate (opinionated) boilerplate:

mix addict.generate.boilerplate

4 - Add Addict routes to your router.ex:

defmodule YourApp.Router do
  (...)
  use Addict.RoutesHelper
  (...)
  scope "/" do
    # Note that the `addict :routes` call should be inside the global
    # scope rather than your app's scope:
    # (i.e.: `scope "/", YourApp do: ...` vs `scope "/", do ...`)
    # otherwise Phoenix won't be able to find Addict's controllers.
    addict :routes
  end
end

5 - Visit any of these paths on your app

/login
/register
/recover_password
/reset_password

On what does it depend?

Addict depends on:

Optionally you can make Addict send e-mails for you too. At the moment only Mailgun is supported. Feel free to contribute with another service!

Addict Configs

See all available configurations here.

How can I use it?

Routes

Add the following to your router.ex:

defmodule ExampleApp.Router do
  use Phoenix.Router
  use Addict.RoutesHelper

  ...

  scope "/" do
    addict :routes
  end
end

This will generate the following routes:

        register_path  POST   / register          Addict.Controller.register/2
           login_path  POST   / login             Addict.Controller.login/2
          logout_path  DELETE / logout            Addict.Controller.logout/2
recover_password_path  POST   / recover_password  Addict.Controller.recover_password/2
  reset_password_path  POST   / reset_password    Addict.Controller.reset_password/2

You can also override the path or controller/action for a given route:

addict :routes,
  logout: [path: "/sign-out", controller: ExampleApp.UserController, action: :sign_out],
  recover_password: "/password/recover",
  reset_password: "/password/reset"

These overrides will generate the following routes:

        register_path  POST   / register          Addict.Controller.register/2
           login_path  POST   / login             Addict.Controller.login/2
          logout_path  DELETE / sign-out          ExampleApp.UserController.sign_out/2
recover_password_path  POST   / password/recover  Addict.Controller.recover_password/2
  reset_password_path  POST   / password/reset    Addict.Controller.reset_password/2

Interacting with Addict

After you've added the router and generated the configs, please take look at the optional boilerplate and the Example App. Here are the interesting bits:

Addict Helper

Addict saves information on the logged in user by setting current_user on the user's Session. You might want to use the Addict.Helper module that encapsulates this logic:

Checking for authentication

Use Addict.Plugs.Authenticated plug to validate requests on your controllers:

defmodule MyAwesomeApp.PageController do
  use Phoenix.Controller

  plug Addict.Plugs.Authenticated when action in [:foobar]
  plug :action

  def foobar(conn, _params) do
    render conn, "index.html"
  end

end

If the user is not logged in and requests for the above action, they will be redirected to not_logged_in_url.

Adding Custom Mailer

For adding a custom Mailer just follow the conventions:

  • Module must be Addict.Mailers.TheEmailProvider
  • Add the Mailer file in /lib/addict/mailers
  • Make sure the mailer implements the behaviour defined here

Once that is done, just set mail_service configuration to :the_email_provider.

TODO

Check the issues on this repository to check or track the ongoing improvements and new features.

Contributing

Feel free to send your PR with improvements or corrections!

Special thanks to the folks at #elixir-lang on freenet for being so helpful every damn time!

Articles
to learn more about the elixir concepts.

Resources
which are currently available to browse on.

mail [email protected] to add your project or resources here 🔥.

FAQ's
to know more about the topic.

mail [email protected] to add your project or resources here 🔥.

Queries
or most google FAQ's about Elixir.

mail [email protected] to add more queries here 🔍.

More Sites
to check out once you're finished browsing here.

0x3d
https://www.0x3d.site/
0x3d is designed for aggregating information.
NodeJS
https://nodejs.0x3d.site/
NodeJS Online Directory
Cross Platform
https://cross-platform.0x3d.site/
Cross Platform Online Directory
Open Source
https://open-source.0x3d.site/
Open Source Online Directory
Analytics
https://analytics.0x3d.site/
Analytics Online Directory
JavaScript
https://javascript.0x3d.site/
JavaScript Online Directory
GoLang
https://golang.0x3d.site/
GoLang Online Directory
Python
https://python.0x3d.site/
Python Online Directory
Swift
https://swift.0x3d.site/
Swift Online Directory
Rust
https://rust.0x3d.site/
Rust Online Directory
Scala
https://scala.0x3d.site/
Scala Online Directory
Ruby
https://ruby.0x3d.site/
Ruby Online Directory
Clojure
https://clojure.0x3d.site/
Clojure Online Directory
Elixir
https://elixir.0x3d.site/
Elixir Online Directory
Elm
https://elm.0x3d.site/
Elm Online Directory
Lua
https://lua.0x3d.site/
Lua Online Directory
C Programming
https://c-programming.0x3d.site/
C Programming Online Directory
C++ Programming
https://cpp-programming.0x3d.site/
C++ Programming Online Directory
R Programming
https://r-programming.0x3d.site/
R Programming Online Directory
Perl
https://perl.0x3d.site/
Perl Online Directory
Java
https://java.0x3d.site/
Java Online Directory
Kotlin
https://kotlin.0x3d.site/
Kotlin Online Directory
PHP
https://php.0x3d.site/
PHP Online Directory
React JS
https://react.0x3d.site/
React JS Online Directory
Angular
https://angular.0x3d.site/
Angular JS Online Directory