Formtastic form builder for Devise
Ruby JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
app/views/devise
config/locales
lib
spec/dummy
.gitignore
CHANGELOG.md
Gemfile
LICENSE.txt
README.md
Rakefile
devise-formtastic.gemspec

README.md

Devise Formtastic

Devise Formtastic is a Formtastic form builder for Devise with some extra features like full I18n support and dynamic page titles.

Requirements

  • Ruby 1.9 or later
  • Rails 3.2 or later

Installation

Add this line to your application's Gemfile:

gem "devise-formtastic"

And then execute:

$ bundle

Or install it yourself as:

$ gem install devise-formtastic

Devise Formtastic depends on latest stable versions of Devise and Formtastic gems, so you don't have to add them in your Gemfile if you don't want to specify version, git repository, etc.

All generators works as normal:

$ rails generate formtastic:install
$ rails generate devise:install
$ rails generate devise User

Don't forget to require Formtastic styles in your asset pipeline:

*= require formtastic

Usage

Generating views

If you want to modify Devise Formtastic views, you can copy them to app/views/:

$ rails g devise:views

Dynamic page titles

Devise Formtastic sets @title variable for each page (if it's not already set in controllers), so you can use it in your layouts:

<head>
  <title><%= "#{@title} | " unless @title.blank? %>Dummy App</title>
</head>

<body>
  <%= content_tag(:h1, @title) unless @title.blank? %>
</body>

I18n support

All buttons, titles, links, hint texts, etc. are configurable using locales.

devise:
  buttons:
    sign_in: "Log in"
    sign_up: "Sign up"
  links:
    sign_in: "Log in"
    sign_up: "Join now"
  titles:
    sign_in: "Login"
    sign_up: "Registration"

For full list of available options please take a look at default locale file.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Support

If you have any questions or issues with Devise Formtastic, or if you like to report a bug, please create an issue on GitHub.

License

MIT License. Copyright (c) 2013 Jari Jokinen. See LICENSE for further details.