Titlezilla

Ultimate solution for dealing with titles in Rails.

Installation

Add this line to your application's Gemfile:

gem 'titlezilla'

And then execute:

$ bundle

Run the generator:

rails generate titlezilla:install

Usage

Basics

Put your titles in generated .yml file:

en:
  titles:
    application: My Application
    welcome:
      index: Welcome page title
    users:
      show: User: %{user}

Use convenient methods in your helpers:

# Assuming you are on welcome#index page:
application_title # => My Application
title # => Welcome page title
meta_title # => Welcome page title | My Application
title_tag # => <title>Welcome page title | My Application</title>

Passing variables to translations

All defined instance variables passed to translations.

YAML:

en:
  titles:
    users:
      show: User: %{user}

Model:

class User < ActiveRecord::Base
  def to_s
    user.full_name
  end
end

Controller:

def show
  @user = User.find(params[:id])

View:

title # => User: John Doe

Namespacing

Namespaced controllers/views are supported, so you can have separate set of titles for different parts of your application.

YAML:

en:
  titles:
    application: My Application
    ...
    admin:
      application: Admin Panel
      dashboard:
        index: Dashboard

View:

# Assuming you are on admin/welcome#index page:
application_title # => Admin Panel
title # => Dashboard
meta_title # => Dashboard | Admin Panel

Action aliasing (:create and :update)

Titleziila uses name of the current action for resolving titles, so when you submit a form and it fails to save, your rendered new template inside the create action. To avoid setting duplicated titles for both new and create (and edit and update), this actions is mapped in gem configuration. If your application have similar non-RESTful pair of actions, your can add them to mapping:

config/initializers/titlezilla.rb:

Titlezilla.configure do |config|
  config.action_map.merge!({perform_parse: :parse})
end

Now you can define title only for parse action, perform_parse whil use it automagically.

Custom meta title separator

If you want your title tag content to look like this: My Application > My cool page, tell Titlezilla to use custom separator.

config/initializers/titlezilla.rb:

Titlezilla.configure do |config|
  config.separator = ' > '
end

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