h1. Clearance

Forked version of Thoughtbot's Clearance, Rails authentication with email & password.

h2. Installation

Clearance is a Rails engine. It works with versions of Rails greater than 2.3.

In config/environment.rb:

<pre>
config.gem "tonkapark-clearance",
  :lib     => 'clearance',
  :source  => 'http://gems.github.com',
  :version => '0.7.0.1'
</pre>

Vendor the gem:

<pre>
rake gems:install
rake gems:unpack
</pre>

Make sure the development database exists and run the generator:

<pre>
script/generate clearance
</pre>

A number of files will be created and instructions will be printed.

You may already have some of these files. Don't worry. You'll be asked if you want to overwrite them.

Run the migration:

<pre>
rake db:migrate
</pre>

h2. If you aren't on Suspenders, you aren't done

Define a HOST constant in your environment files.
In config/environments/test.rb and config/environments/development.rb it can be:

<pre>
HOST = "localhost"
</pre>

In production.rb it must be the actual host your application is deployed to.
The constant is used by mailers to generate URLs in emails.

In config/environment.rb:

<pre>
DO_NOT_REPLY = "donotreply@example.com"
</pre>

Define root_url to *something* in your config/routes.rb:

<pre>
map.root :controller => 'home'
</pre>