Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

a bit of rails engine magic for determining the timezone of the user's browser.

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 app
Octocat-spinner-32 config
Octocat-spinner-32 lib
Octocat-spinner-32 script
Octocat-spinner-32 test
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .rbenv-version
Octocat-spinner-32 Gemfile
Octocat-spinner-32 Gemfile.lock
Octocat-spinner-32 MIT-LICENSE
Octocat-spinner-32 README.rdoc
Octocat-spinner-32 Rakefile
Octocat-spinner-32 tz_magic.gemspec
README.rdoc

TzMagic

Description

While every sysadmin worth his or her salt runs their server in the UTC timezone, it is occasionally useful, even necessary, to know the timezone that the end user's browser is set to. Surprisingly, there isn't an easy way to do this - you'd think that the browser might supply that in a header, but no… getting it is an exercise in plumbing together raw pieces of the internet. This gem gives that to your average rails app with a minimum of fuss.

How to use it

Its a rails engine. You install it via a gem, then include various bits.

add this to your Gemfile with:

gem 'tz_magic'

then wire it up in your rails app:

add this line to your config/routes.rb file:

mount TzMagic::Engine => "/tz_magic"

add this line to your helpers/application_helper.rb file:

include TzMagic::ApplicationHelper

add this line to your app/assets/javascripts/application.js file:

require tz_magic/application

add this line to the controller that you need to ensure the timezone exists for (application_controller.rb is an acceptable, if brute-force option):

include TzMagic::BeforeFilter

you now have a helper you can refer to in your controllers or views like:

time_zone

or

<%= time_zone.name %>

This is a full fleged TimeZone instance.

How it works

by including the TzMagic::BeforeFilter into your controller, you are adding a check that the user's session contains a :timezone_name element. If that element exists, all is fine. If it doesn't exist:

  • we redirect the user to our /timezone/new view

  • this view runs some javascript that determines the user's timezone, then submits it via an ajax push to /timezone

  • this hits our timezone#create method, which sets the cookie and returns the original url the user was going to via a json block.

  • the javascript receives the json payload, extracts the original url, and redirects, with the timezone happily in the session.

the magic javascript code

The javascript at the heart of this Rube Goldberg contraption is Copyright © 2012 Jon Nylander, project maintained at bitbucket.org/pellepim/jstimezonedetect

contributing

The usual. Fork, modify, test, pullup request.

Something went wrong with that request. Please try again.