r38y / ck_fu

Adds a development toolbar to your site that makes it easy to tell the difference between development, staging, and production.

Home Page:http://github.com/randy/ck_fu/tree/master

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

CkFu
====

Where does the name ck_fu come from? It's a play on attachment_fu and I think curse words are funny.

This will put a bar across the top of your screen (except in production unless :if is specified and true) that shows the environment, 
databases, revision, etc. Why do we need something like this? because the development and staging sites often look identical to the 
production site. This makes it easy to tell the difference between the sites at a glance.

Example
=======

* Run rake ck_fu:copy_styles
* Add ck_fu.css to your list of stylesheets
* Add the following directly below your <body> tag
<%= ck_fu %>

More Advanced Usage
===================

* ck_fu (default) will not show up in production
<div class="test" id="ck_fu">Env: Test &sect; Current DB: myapp_dev</div>

* If RAILS_ROOT/REVISION exists (created by capistrano when deploying) (can suppress with :revision => false)
<div class="test" id="ck_fu">Env: Test &sect; Current DB: myapp_dev &sect; Revision: <rev></div>

* If RAILS_ROOT/DATE exists (can suppress with :date => false)
<div class="test" id="ck_fu">Env: Test &sect; Current DB: myapp_dev &sect; Deployed: <date></div>
To make this exist on the server, add something like the following to deploy.rb:
task :after_symlink, :roles => :web do
  run "date > #{current_release}/DATE"
end

* Arbitrary links
ck_fu(:links => [['Public site', root_path]])
<div class="test" id="ck_fu">Env: Test &sect; Current DB: myapp_dev &sect; <a href="/">Public site</a></div>

* Display based on some condition like the current_user is an admin
ck_fu(:if => current_user.try(:admin?)) - will display in production as well if the user is an admin.

For more information and screenshots, visit http://ck_fu.me

Copyright (c) 2008 umlatte LLC, released under the MIT license

About

Adds a development toolbar to your site that makes it easy to tell the difference between development, staging, and production.

http://github.com/randy/ck_fu/tree/master

License:MIT License


Languages

Language:Ruby 100.0%