WhowishWord - A wording framework for Rails
====================

Have you ever been bored when a project manager (or marketing department) keeps changing wording on a website?
This kind of tasks can make programmers go crazy.

WhowishWord allows normal users to change wording on a Rails website, directly.

The beauty of WhowishWord is that:

* It is almost transparent to programmers
* Programmers don't have to care how wording should be. This makes them work much faster


How you should work
-------------------

In your view, e.g. index.html.erb, use word_for(:identifier) and word_for_attr(:identifier):

```erb
<h1><%= word_for :title%></h1>
<h3><%= word_for :you_are_here_for_number_of_times, :number=> 10 %></h3>

<b><%= word_for :name_label%><b> <%= word_for :my_name%><br/>

<b><%= word_for :your_name_label%></b> 
<input type="text" placeholder="<%= word_for_attr :your_name_here%>"><br/>
<a href="#" title="<%= word_for_attr :your_name_will_be_kept_secret%>">?</a>

<button><%= word_for_attr :submit_button%></button>
```

Now when you want to edit wording:

1. Activate edit mode by calling:
```
activate_whowish_word_edit_mode() 
```
 in any controller. 
 (The usual way is to use user's session to determine whether or not to activate WhowishWord's edit mode)

2. You'll see an edit icon on each word
3. Click on an edit icon to edit the corresponding word
4. Fill in a new word, and click save
	* If it is the first time, you will need to fill master password at this point. (The instruction how to set password is in 'How to use it' section)

And when you have finished, deactivate edit mode.

WhowishWord empowers normal users (project manager, marketing department, or sales) to change wording on a website.
This take the burden off programmers because it is extremely boring to change wording...

Demo: http://whowish-word.heroku.com

### Note

WhowishWord supports variables:

```erb
<%= word_for :you_are_here_for_number_of_times, :number=> 10 %>
```

If you set the word :you_are_here_for_number_of_times to be 

```
You are here {number} times already
```

WhowishWord renders it as:

```
You are here 10 times already
```


Prerequisite
-------------------

Rails 3.1.*

It does not work with Rails 3.0.*, yet. Please send me an issue and I will fix it. (I'm just lazy)



How to use it
-------------------

First, install it:
```
gem install whowish_word
```

Or, in your Gemfile, put in the below line:
```
gem 'whowish_word'
```

Second, create RAILS_ROOT/config/initializers/whowish_word.rb that contains:

```ruby
require 'whowish_word'

WhowishWord.init(:active_record)

WhowishWord.username = "root"
WhowishWord.password = "pass"
```

You can use either use :active_record or :mongoid

And, in your layout, please drop this line inside the tag header:

```erb
<%= whowish_word_javascript_and_css%>
```

It is to include the required Javascript and css files, when the edit mode is activated.


Performance
-------------------

It is fast because words are kept in memory. They are not kept in database while your Rails is running.


Help me
-------------------------------------------------

1. Fork the project
	* Run all tests first:
		* Go to ROOT, type 
		```
			bundle exec rspec spec/*
		```
		* Go to ROOT/rails, type
		```
			bundle exec rspec spec/*
		```
		* If all tests pass, you are ready to add a feature
2. Add a feature
3. Write a test for it
4. Send me a pull request

Please learn the code structure. If you have any question, feel free to ask me.


Authors
-------------------

Tanin Na Nakorn

Tanun Niyomjit (Designer)


Boring license stuffs
-----------------------

WhowishWord relies on several libraries that you won't see.
They are embedded into whowish_word.js.

The libraries:

* jQuery 1.6.4 http://jquery.com/
* Class.js (John Resig) http://ejohn.org/blog/simple-javascript-inheritance/
* jQuery.escape http://plugins.jquery.com/project/escape
* JSizes http://www.bramstein.com/projects/jsizes/
* jQuery.loading_button (This is mine)

Please be aware of the licenses of other libraries.

For WhowishWord's code itself, it is under this license: http://creativecommons.org/licenses/by/3.0/

Basically, you can do whatever you want with it. Just give us some credits.