guerrilla_rotate 0.1.0

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Jason King
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,46 @@
+GuerrillaRotate
+==============
+
+This plugin lets you have multiple view pages for the one action, so that you
+can rotate through different views in order to test which one is the most
+effective.  This is known as A/B testing, split testing or side-by-side
+testing.
+
+It will automatically switch between the different views for different web
+requests (uses .rand so is pseudo random, not round-robin or anything).  The
+particular view is sticky for a (rails) session, so that once that view has been
+chosen for that visitor they will see the same, consistent view each time.
+
+It integrates automagically into
+[Rubaidh::GoogleAnalytics](http://github.com/rubaidh/google_analytics) by
+setting the override_trackpageview to the name of the unique view file (instead
+of the action-based URL) so you can track it easily in Google Analytics.
+
+Without that you'll want to track it by putting different tracking codes in each
+of your view templates.
+
+Example
+-------
+
+So, in your views you will create some new templates with something (can be
+anything including nothing) between the template name and the first part of the
+extension.  So you might have the following files for the products/index action:
+
+    app/views/products/index.html.erb
+    app/views/products/index_alt.html.erb
+    app/views/products/index_new.html.erb
+
+Then all you need to do is tell your controller to rotate for that action:
+
+### app/controllers/products_controller.rb
+    class ProductsController < ApplicationController
+      guerrilla_rotate :index, :show
+
+      # etc..
+
+    end
+
+NB: guerrilla_rotate is also aliased as guerilla_rotate for the alternative
+spelling and typos.
+
+Copyright &copy; 2009 Jason King, released under the MIT license

data/lib/guerrilla_rotate.rb

@@ -0,0 +1,48 @@
+module ActionController
+	class Base
+    cattr_accessor :guerrilla_paths
+    class << self
+      def guerrilla_rotate( *actions )
+        @@guerrilla_paths = {}
+        actions.each do |a|
+          catch (:next_path) do
+            view_paths.each do |vp|
+              Dir.chdir(vp) do
+                gpath = _gr_gpath(controller_name, a)
+                guerrilla_paths[gpath] = Dir.glob(gpath + '*') and
+                  throw :next_path
+              end
+            end
+          end
+        end
+      end
+      alias_method :guerilla_rotate, :guerrilla_rotate
+    end
+
+		protected
+			def render_for_file_with_guerrilla_rotate( template_path, *others )
+        gpath = _gr_gpath(controller_name, action_name)
+				if guerrilla_paths.has_key?(gpath)
+					ga = guerrilla_paths[gpath]
+          session[:guerrilla_index] ||= {}
+          template_path = ga[ session[:guerrilla_index][gpath] ||= rand(ga.size)]
+          adjusted_action = template_path[%r{[^/]+(?=\.#{@template.template_format}\.)}]
+          if defined? Rubaidh::GoogleAnalytics
+            Rubaidh::GoogleAnalytics.override_trackpageview =
+              url_for(
+                :controller => controller_name,
+                :action => adjusted_action,
+                :only_path => true)
+          end
+				end
+				render_for_file_without_guerrilla_rotate( template_path, *others )
+			end
+			alias_method_chain :render_for_file, :guerrilla_rotate
+
+    private
+      def self._gr_gpath(c,a)
+        File.join(c.to_s, a.to_s)
+      end
+      def _gr_gpath(*p); self.class._gr_gpath(*p); end
+	end
+end

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification 
+name: guerrilla_rotate
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Jason King
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-02-16 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: |
+  GuerrillaRotate
+  ==============
+  
+  This plugin lets you have multiple view pages for the one action, so that you
+  can rotate through different views in order to test which one is the most
+  effective.  This is known as A/B testing, split testing or side-by-side
+  testing.
+  
+  It will automatically switch between the different views for different web
+  requests (uses .rand so is pseudo random, not round-robin or anything).  The
+  particular view is sticky for a (rails) session, so that once that view has been
+  chosen for that visitor they will see the same, consistent view each time.
+  
+  It integrates automagically into
+  [Rubaidh::GoogleAnalytics](http://github.com/rubaidh/google_analytics) by
+  setting the override_trackpageview to the name of the unique view file (instead
+  of the action-based URL) so you can track it easily in Google Analytics.
+  
+  Without that you'll want to track it by putting different tracking codes in each
+  of your view templates.
+  
+  Example
+  -------
+  
+  So, in your views you will create some new templates with something (can be
+  anything including nothing) between the template name and the first part of the
+  extension.  So you might have the following files for the products/index action:
+  
+      app/views/products/index.html.erb
+      app/views/products/index_alt.html.erb
+      app/views/products/index_new.html.erb
+  
+  Then all you need to do is tell your controller to rotate for that action:
+  
+  ### app/controllers/products_controller.rb
+      class ProductsController < ApplicationController
+        guerrilla_rotate :index, :show
+  
+        # etc..
+  
+      end
+  
+  NB: guerrilla_rotate is also aliased as guerilla_rotate for the alternative
+  spelling and typos.
+  
+  Copyright &copy; 2009 Jason King, released under the MIT license
+
+email: jk@handle.it
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+- LICENSE
+files: 
+- README.markdown
+- LICENSE
+- lib/guerrilla_rotate.rb
+has_rdoc: true
+homepage: http://github.com/JasonKing/guerrilla_rotate
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 2
+summary: A/B Testing made simple
+test_files: []
+