Skip to content
View helpers for Rails applications
Ruby Shell
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
gemfiles Drop support for EOL rails earlier than 5.0 Sep 4, 2019
lib
spec
.gitignore
.rspec
.rubocop.yml Once over on project config Sep 27, 2018
.travis.yml Add ruby 2.7.0 to travis list Jan 2, 2020
Appraisals Drop support for EOL rails earlier than 5.0 Sep 4, 2019
CHANGELOG.md Release version 2.2.0 Sep 10, 2019
CONTRIBUTING.md Add `bin/setup` file, modernize CONTRIBUTING Jan 26, 2015
Gemfile
Gemfile.lock
LICENSE Extend copyright year through 2013 Jan 4, 2013
README.md
Rakefile
flutie.gemspec

README.md

Flutie

Build Status

Flutie provides some utility view helpers for use with Rails applications.

There are helpers for setting a page title and for generating body classes.

Installation & Upgrading

Flutie is a Railtie. We support the versions of Ruby and Rails listed in .travis.yml.

It should be run as a gem and included in your Gemfile:

gem "flutie"

Helpers

Flutie provides helper methods for use within Rails layouts and views.

Page Title

The page_title method can be used like:

<title><%= page_title %></title>

By default, it will produce results like:

<title>Appname : page title</title>
  • "App name" comes from the module name of the rails application created by your app, i.e. Appname::Application will produce "Appname"
  • "page" comes from trying content_for(:page_title) and assumes you are using content_for with :page_title symbol on your pages.
  • The separator defaults to " : "

These can be overridden by passing an options hash including :app_name, :page_title_symbol and :separator hash keys. For example:

content_for(:site_page_title, 'My title of my page')
page_title(:app_name => 'My app name', :page_title_symbol => :site_page_title, :separator => " | ")

would produce:

<title>My app name | My title of my page</title>

You can also reverse the position of the :app_name and the :site_page_title values by using the :reverse option. For example:

content_for(:site_page_title, 'My title of my page')
page_title(:app_name => 'My app name', :page_title_symbol => :site_page_title, reverse: true)

would produce:

<title>My title of my page : My app name</title>

Body Class

The body_class method can be used like this in a layout:

<body class="<%= body_class %>">

This will produce a string including the controller name and controller-action name pair. For example, The WidgetsController#show action would produce:

<body class="widgets widgets-show">

Anything which has been added via content_for(:extra_body_classes) will be added to the end, for example views like:

content_for(:extra_body_classes, 'special-page')
<body class="<%= body_class %>">

would produce:

<body class="widgets widgets-show special-page">

How to contribute

Please see the CONTRIBUTING file for details.

Credits

thoughtbot

Flutie is maintained and funded by thoughtbot, inc.

Thank you to all the contributors!

The names and logos for thoughtbot are trademarks of thoughtbot, inc.

License

Flutie is Copyright © 2010 thoughtbot, inc. It is free software, and may be redistributed under the terms specified in the LICENSE file.

You can’t perform that action at this time.