whowish_word 0.1.4 → 0.1.5

data/README.md

@@ -1,25 +1,76 @@
-WhowishWord (This is a draft)
+WhowishWord - A Rails framework for wording
 ====================
 
 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 facilitates the process of changing wording on a website.
+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
 -------------------
 
-1. Activate edit mode by calling activate_whowish_word_edit_mode() in any controller
-2. Go back to the website, you'll see an edit icon on each word
+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
-	4.1 If it is the first time, you will need to fill master password at this point. (The instruction how to set password is below)
+	* 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
 -------------------
@@ -71,10 +122,23 @@ Performance
 It is fast because words are kept in memory. They are not kept in database while your Rails is running.
 
 
-How to extend WhowishWord to suit your need
+Help me
 -------------------------------------------------
 
-WhowishWord is nicely structure. You can extend it by writing a new handler and creator (on client-side).
+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.
 
@@ -84,4 +148,25 @@ Authors
 
 Tanin Na Nakorn
 
-Tanun Niyomjit (The design of a dialog box)
+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.

data/lib/whowish_word/action_view/template.rb

@@ -7,14 +7,23 @@ if defined?(ActionView) and defined?(ActionView::Base)
     
     def render(view, locals, buffer=nil, &block)
 
+      previous_whowish_word_page = nil
+      
+      if view.instance_variable_defined?(:@whowish_word_page)
+        previous_whowish_word_page = view.instance_variable_get(:@whowish_word_page)
+      end
+    
       view.instance_variable_set(:@whowish_word_page, @identifier)
       
       if view.controller.respond_to?(:whowish_word_edit_mode)
         view.instance_variable_set(:@whowish_word_edit_mode, view.controller.whowish_word_edit_mode)
       end
       
-      return render_original(view, locals, buffer, &block)
+      html = render_original(view, locals, buffer, &block)
+      
+      view.instance_variable_set(:@whowish_word_page, previous_whowish_word_page)
 
+      return html
     end
   
   end

data/rails/app/views/layouts/nested_test_word_for.html.erb

@@ -1,7 +1,10 @@
 <% 
 	content_for :nested_layout do 
 %>
+	<span id="nested_layout_before_yield"><%= word_for :text%></span>
+
 	<%=yield%>
+	
 	<span id="nested_layout"><%= word_for :text%></span>
 	<span id="nested_layout_attr"><%= word_for_attr :text%></span>
 	

data/rails/app/views/layouts/test_word_for.html.erb

@@ -11,6 +11,9 @@
 		<%= stylesheet_link_tag "whowish_word.css"%>
 	</head>
 	<body>
+		
+		<span id="layout_before_nested_layout"><%= word_for :text%></span>
+		
 		<%= content_for?(:nested_layout) ? yield(:nested_layout) : yield %>
 		
 		<span id="layout"><%= word_for :text%></span>

data/rails/app/views/test_word_for/index.html.erb

@@ -1,7 +1,9 @@
+<span id="view_before_partial"><%= word_for :text%></span>
+
+<%= render :partial=>"partial"%>
+
 <span id="view"><%= word_for :text%></span>
 <span id="view_attr"><%= word_for_attr :text%></span>
 
 <span id="view_with_variables"><%= word_for :text, :number=>5, :name=>"tanin" %></span>
-<span id="view_attr_with_variables"><%= word_for_attr :text, :number=>5, :name=>"tanin"%></span>
-
-<%= render :partial=>"partial"%>
+<span id="view_attr_with_variables"><%= word_for_attr :text, :number=>5, :name=>"tanin"%></span>

data/rails/spec/integration/whowish_word_generator_spec.rb

@@ -56,24 +56,36 @@ describe 'Generator spec' do
     
     goto '/test_word_for?edit_mode=yes'
     
+    html("view_before_partial").should == get_whowish_word_in_edit_mode("test_word_for/index.html.erb", "text")
+    
     html("view").should == get_whowish_word_in_edit_mode("test_word_for/index.html.erb", "text")
     html("view_attr").should == get_whowish_word_attr_in_edit_mode("test_word_for/index.html.erb", "text")
     
     html("view_with_variables").should == get_whowish_word_in_edit_mode("test_word_for/index.html.erb", "text", {:number=>5,:name=>"tanin"})
     html("view_attr_with_variables").should == get_whowish_word_attr_in_edit_mode("test_word_for/index.html.erb", "text", {:number=>5,:name=>"tanin"})
     
+    
+    
     html("partial").should == get_whowish_word_in_edit_mode("test_word_for/_partial.html.erb", "text")
     html("partial_attr").should == get_whowish_word_attr_in_edit_mode("test_word_for/_partial.html.erb", "text")
     
     html("partial_with_variables").should == get_whowish_word_in_edit_mode("test_word_for/_partial.html.erb", "text", {:number=>5,:name=>"tanin"})
     html("partial_attr_with_variables").should == get_whowish_word_attr_in_edit_mode("test_word_for/_partial.html.erb", "text", {:number=>5,:name=>"tanin"})
     
+    
+    
+    html("nested_layout_before_yield").should == get_whowish_word_in_edit_mode("layouts/nested_test_word_for.html.erb", "text")
+    
     html("nested_layout").should == get_whowish_word_in_edit_mode("layouts/nested_test_word_for.html.erb", "text")
     html("nested_layout_attr").should == get_whowish_word_attr_in_edit_mode("layouts/nested_test_word_for.html.erb", "text")
     
     html("nested_layout_with_variables").should == get_whowish_word_in_edit_mode("layouts/nested_test_word_for.html.erb", "text", {:number=>5,:name=>"tanin"})
     html("nested_layout_attr_with_variables").should == get_whowish_word_attr_in_edit_mode("layouts/nested_test_word_for.html.erb", "text", {:number=>5,:name=>"tanin"})
     
+    
+    
+    html("layout_before_nested_layout").should == get_whowish_word_in_edit_mode("layouts/test_word_for.html.erb", "text")
+    
     html("layout").should == get_whowish_word_in_edit_mode("layouts/test_word_for.html.erb", "text")
     html("layout_attr").should == get_whowish_word_attr_in_edit_mode("layouts/test_word_for.html.erb", "text")
     
@@ -86,24 +98,36 @@ describe 'Generator spec' do
     
     goto '/test_word_for'
     
+    html("view_before_partial").should == get_whowish_word("test_word_for/index.html.erb", "text")
+    
     html("view").should == get_whowish_word("test_word_for/index.html.erb", "text")
     html("view_attr").should == get_whowish_word("test_word_for/index.html.erb", "text")
     
     html("view_with_variables").should == get_whowish_word("test_word_for/index.html.erb", "text", {:number=>5,:name=>"tanin"})
     html("view_attr_with_variables").should == get_whowish_word("test_word_for/index.html.erb", "text", {:number=>5,:name=>"tanin"})
     
+    
+    
     html("partial").should == get_whowish_word("test_word_for/_partial.html.erb", "text")
     html("partial_attr").should == get_whowish_word("test_word_for/_partial.html.erb", "text")
     
     html("partial_with_variables").should == get_whowish_word("test_word_for/_partial.html.erb", "text", {:number=>5,:name=>"tanin"})
     html("partial_attr_with_variables").should == get_whowish_word("test_word_for/_partial.html.erb", "text", {:number=>5,:name=>"tanin"})
     
+    
+    
+    html("nested_layout_before_yield").should == get_whowish_word("layouts/nested_test_word_for.html.erb", "text")
+    
     html("nested_layout").should == get_whowish_word("layouts/nested_test_word_for.html.erb", "text")
     html("nested_layout_attr").should == get_whowish_word("layouts/nested_test_word_for.html.erb", "text")
     
     html("nested_layout_with_variables").should == get_whowish_word("layouts/nested_test_word_for.html.erb", "text", {:number=>5,:name=>"tanin"})
     html("nested_layout_attr_with_variables").should == get_whowish_word("layouts/nested_test_word_for.html.erb", "text", {:number=>5,:name=>"tanin"})
     
+    
+    
+    html("layout_before_nested_layout").should == get_whowish_word("layouts/test_word_for.html.erb", "text")
+    
     html("layout").should == get_whowish_word("layouts/test_word_for.html.erb", "text")
     html("layout_attr").should == get_whowish_word("layouts/test_word_for.html.erb", "text")
     

data/whowish_word.gemspec

@@ -3,7 +3,7 @@ $:.push File.expand_path("../lib", __FILE__)
 
 Gem::Specification.new do |s|
   s.name        = "whowish_word"
-  s.version     = "0.1.4"
+  s.version     = "0.1.5"
   s.platform    = Gem::Platform::RUBY
   s.authors     = ["Tanin Na Nakorn"]
   s.email       = ["tanin47@yahoo.com"]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: whowish_word
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
   prerelease: 
 platform: ruby
 authors:
@@ -63,7 +63,7 @@ files:
 - lib/whowish_word/rails/app/models/mongoid/whowish_word_html.rb
 - lib/whowish_word/rails/public/javascripts/0_class.js
 - lib/whowish_word/rails/public/javascripts/0_jquery-1.6.4-whowish_word.js
-- lib/whowish_word/rails/public/javascripts/1_csrf_and_authenticity_token_hook.js
+- lib/whowish_word/rails/public/javascripts/1_csrf_token_hook.js
 - lib/whowish_word/rails/public/javascripts/1_jquery.escape.js
 - lib/whowish_word/rails/public/javascripts/1_jquery.loading_button.js
 - lib/whowish_word/rails/public/javascripts/1_jquery.sizes.min.js
@@ -128,6 +128,7 @@ files:
 - rails/config/mongoid.rb
 - rails/config/mongoid.yml
 - rails/config/routes.rb
+- rails/db/.gitdummy
 - rails/log/.gitignore
 - rails/mongo.bat
 - rails/public/jasmine/MIT.LICENSE