kete_gets_trollied 0.0.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Horowhenua Library Trust
+
+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.rdoc

@@ -0,0 +1,63 @@
+= kete_gets_trollied
+
+A Kete add-on that uses the Trollied gem to deliver ordering of items from Kete.
+
+== Usage
+
+Currently only tested against Rails 2.3.5.  When Kete moves to Rails 3, this gem will be updated to.
+
+Install the Trollied gem and this gem:
+
+  gem install trollied kete_gets_trollied
+
+After installing the gem do the following to add kete_gets_trollied to your app:
+
+In the Rails::Initializer.run config block  config/environment.rb:
+
+  config.gem "trollied"
+  config.gem "kete_gets_trollied"
+
+You also need to add config/initializers/kete_gets_trollied.rb with the following:
+
+  ActionController::Base.send(:include, HasTrolleyControllerHelpersOverrides)
+  ActionController::Base.send(:helper, OrdersHelperOverrides)
+  ActionController::Base.send(:helper, LineItemsHelperOverrides)
+
+This makes kete_gets_trollied's overrides take precedence over the straight trollied gem's stuff.
+
+Now you need to run the migration generator to add the tables and columns that kete_gets_trollied needs to work. Do this in your Kete application's root directory.
+
+  $ script/generate trollied_migrations
+
+Alter this:
+
+t.integer :purchasable_item_id, :null => false
+
+to
+
+t.integer :purchasable_item_id, :null => false, :references => nil
+
+Then run the migration command:
+
+  $ rake db:migrate # add environment if necessary, i.e. rake db:migrate RAILS_ENV=production
+
+Lastly you will want restart your Kete server and backgroundrb:
+
+  $ touch tmp/restart.txt
+  $ script/backgroundrb stop
+  ...
+  $ script/backgroundrb start
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix in a corresponding branch (even better, make an ticket first and name the branch with the ticket number in it)
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request.
+
+== Copyright
+
+Copyright (c) 2011 Horowhenua Library Trust. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,52 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "kete_gets_trollied"
+    gem.summary = %Q{Uses the trollied gem for adding item ordering to Kete.}
+    gem.description = %Q{Uses the trollied gem for adding item ordering to Kete.}
+    gem.email = "walter@katipo.co.nz"
+    gem.homepage = "http://github.com/kete/kete_gets_trollied"
+    gem.authors = ["Walter McGinnis"]
+    gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
+    gem.add_dependency "trollied", ">= 0.1.4"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  # in the future may include own tests under dummy app or generators for kete app specific tests.
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "kete_gets_trollied #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/app/views/user_notifier/cancelled.html.erb

@@ -0,0 +1,7 @@
+<%= @user.user_name %>,
+
+<%= t '.user_has_cancelled', :cancelling_user => @cancelling_user.resolved_name -%>
+
+<%= @url %>
+
+<%= render 'email_footer' %>

data/app/views/user_notifier/in_process.html.erb

@@ -0,0 +1,7 @@
+<%= @user.user_name %>,
+
+<%= t '.user_has_checked_out', :order_user => @order.user.resolved_name -%>
+
+<%= @url %>
+
+<%= render 'email_footer' %>

data/app/views/user_notifier/new_note.html.erb

@@ -0,0 +1,7 @@
+<%= @user.user_name %>,
+
+<%= t '.user_has_created_note', :note_user => @note.user.resolved_name -%>
+
+<%= @url %>
+
+<%= render 'email_footer' %>

data/app/views/user_notifier/ready.html.erb

@@ -0,0 +1,7 @@
+<%= @user.user_name %>,
+
+<%= t '.your_order_is_ready' -%>
+
+<%= @url %>
+
+<%= render 'email_footer' %>

data/app/views/user_notifier/reviewing_of.html.erb

@@ -0,0 +1,14 @@
+<%= @user.user_name %>,
+
+<%=t 'user_notifier.reviewing_of.description',
+     :revision => @revision,
+     :flag => Kete.reviewed_flag %>
+
+  <%= @url %>
+
+<% if !@message.blank? -%>
+  <%=t 'user_notifier.reviewing_of.reason' %>
+  <%= @message %>
+<% end -%>
+
+<%= render 'email_footer' %>

data/app/views/user_notifier/user_review.html.erb

@@ -0,0 +1,7 @@
+<%= @user.user_name %>,
+
+<%= t '.please_review_order' -%>
+
+<%= @url %>
+
+<%= render 'email_footer' %>

data/config/locales/en.yml

@@ -0,0 +1,75 @@
+---
+en:
+  line_items:
+    new:
+      confirm_order: "Confirm Enquiry"
+    controllers:
+      created: "Added to enquiry"
+      updated: "Updated in enquiry"
+      deleted: "Deleted from enquiry"
+  orders:
+    checkout_form:
+      confirm_order: "Confirm enquiry details"
+      additional_info_for_order: "What is the subject or nature of your enquiry?"
+    helpers:
+      cancelled_orders: "Cancelled Enquiries"
+      completed_orders: "Completed Enquiries"
+      current_orders: "Current Enquiries"
+      in_process_orders: "Enquiries Under Action"
+      order_number: "Enquiry:"
+      ready_orders: "Ready Enquiries"
+      user_review_orders: "Enquiries needing user attention"
+      contact_name: "Contact Name"
+      contact_name_example: "Fill out the name of the person to speak to about the enquiry if it is different from this account's username."
+      contact_phone: "Contact Phone"
+      contact_phone_example: "A staff member may be in contact to discuss your enquiry."
+      required_by: "Date enquiry is required by"
+    index:
+      in_process: "under action"
+      new: "New Enquiry"
+      no_orders: "No enquiries match your criteria."
+      title: "Enquiries"
+      user_review: "needing user attention"
+    order:
+      order_controls_preface: "Enquiry actions:"
+      order_notes: "Notes for this enquiry:"
+    show:
+      your_order: "Your Enquiry"
+      for_user_title: "Enquiry for {{name}}"
+    controllers:
+      change_to_cancel: "Enquiry Cancelled"
+      change_to_checkout: "Enquiry Checked Out"
+      change_to_finish: "Enquiry Completed"
+      change_to_fulfilled_without_acceptance: "Enquiry Ready"
+      change_to_alteration_approve: "You approved the changes to the enquiry. It is now back in process."
+      created: "Created enquiry"
+      updated: "Updated enquiry"
+      deleted: "Deleted enquiry"
+      checkout: "Your enquiry has been made."
+  trolleys:
+    orders:
+      cancelled: "Cancelled Enquiries"
+      completed: "Completed Enquiries"
+      current: "Current Enquiries"
+      in_process: "Under Action"
+      none_pending: "No enquiries pending."
+      ready: "Ready Enquiries"
+      user_review: "Enquiries needing your attention"
+  user_notifier:
+    cancelled:
+      user_has_cancelled: "{{cancelling_user}} has cancelled the following order:"
+    in_process:
+      user_has_checked_out: "{{order_user}} has checked out the following order:"
+    new_note:
+      user_has_created_note: "{{note_user}} has created a new note on the following order:"
+    ready:
+      your_order_is_ready: "Your order is ready:"
+    user_review:
+      please_review_order: "Your enquiry has been altered, please review:"
+  user_notifier_model:
+    subject_cancelled: "An order has been cancelled."
+    subject_in_process: "An order has been checked out."
+    subject_new_note: "A new note to an order has been added."
+    subject_ready: "Your order is now available."
+    subject_user_review: "An order needs your review."
+

data/config/routes.rb

@@ -0,0 +1,26 @@
+require 'kete_gets_trollied'
+
+# extend routes for translations of kete content
+ActionController::Routing::Routes.draw do |map|
+  # Walter McGinnis, 2011-05-12
+  # adding shopping chart functionality
+  # WARNING user just for show at the moment
+  map.resources :user, :path_prefix => ':urlified_name' do |user|
+    user.resource :trolley, :only => :show do |trolley|
+      trolley.resources :orders, :shallow => true
+    end
+  end
+
+  map.resources :topics, :path_prefix => ':urlified_name', :only => [:index], :has_many => :line_items
+
+  if Object.const_defined?(:Order)
+    members = Order.workflow_event_names.inject(Hash.new) do |hash, event_name|
+      hash[event_name.to_sym] = :post
+      hash
+    end
+
+    members[:checkout_form] = :get
+
+    map.resources :orders, :path_prefix => ':urlified_name', :member => members, :except => [:new, :create], :has_many => :line_items
+  end
+end

data/lib/kete_gets_trollied.rb

@@ -0,0 +1,4 @@
+require 'kete_gets_trollied/has_trolley_controller_helpers_overrides'
+require 'kete_gets_trollied/orders_helper_overrides'
+require 'kete_gets_trollied/line_items_helper_overrides'
+require 'kete_gets_trollied/user_order_notifications'

data/lib/kete_gets_trollied/extensions/controllers/application_controller.rb

@@ -0,0 +1,24 @@
+ApplicationController.class_eval do
+  def user_is_trolley_owner_or_appropriate_admin?
+    return false unless logged_in?
+
+    if %w(trolleys line_items orders notes).include?(params[:controller])
+      if params[:controller] == 'orders' && params[:action] == 'index'
+        return at_least_a_moderator?
+      else
+        owned_by = @trolley || @order || @line_item || @note
+        unless owned_by.blank? && params[:controller] == 'line_items' && %w(new index create).include?(params[:action])
+          return (at_least_a_moderator? || current_user == owned_by.user)
+        end
+      end
+    end
+
+    true
+  end
+
+  def authorize_trollied_action
+    return true if user_is_trolley_owner_or_appropriate_admin?
+    # otherwise they shouldn't be here
+    redirect_to DEFAULT_REDIRECTION_HASH
+  end
+end

data/lib/kete_gets_trollied/extensions/controllers/line_items_controller.rb

@@ -0,0 +1,3 @@
+LineItemsController.class_eval do
+  before_filter :authorize_trollied_action
+end

data/lib/kete_gets_trollied/extensions/controllers/notes_controller.rb

@@ -0,0 +1,3 @@
+NotesController.class_eval do
+  before_filter :authorize_trollied_action
+end

data/lib/kete_gets_trollied/extensions/controllers/orders_controller.rb

@@ -0,0 +1,36 @@
+OrdersController.class_eval do
+  before_filter :authorize_trollied_action
+
+  alias_method :original_default_conditions_hash, :default_conditions_hash
+  def default_conditions_hash
+    hash = original_default_conditions_hash
+    if @current_basket != @site_basket
+      hash[:basket_id] = @current_basket.id
+    end
+    hash
+  end
+
+   def set_defaults_for_order_checkout
+     return if @order.contact_name.present? && @order.contact_phone.present?
+
+     trolley = @trolley || current_user.trolley
+     # opted for two queries rather than one combined query
+     # and pulling apart latest values from multiple results
+     # WARNING: mysql specific select distinct syntax
+     previous_contact_name_order = trolley.orders.find(:first,
+                                                       :select => "distinct(contact_name)",
+                                                       :order => 'updated_at DESC')
+
+     @order.contact_name ||= previous_contact_name_order.contact_name if previous_contact_name_order.present? && previous_contact_name_order.contact_name.present?
+
+     previous_contact_phone_order = trolley.orders.find(:first,
+                                                        :select => "distinct(contact_phone)",
+                                                        :order => 'updated_at DESC')
+
+     @order.contact_phone ||= previous_contact_phone_order.contact_phone if previous_contact_phone_order.present? && previous_contact_phone_order.contact_phone.present?
+   end
+
+   def number_per_page
+     50
+   end
+end

data/lib/kete_gets_trollied/extensions/controllers/trolleys_controller.rb

@@ -0,0 +1,3 @@
+TrolleysController.class_eval do
+  before_filter :authorize_trollied_action
+end

data/lib/kete_gets_trollied/extensions/helpers/application_helper.rb

@@ -0,0 +1,30 @@
+ApplicationHelper.module_eval do
+  # in application layout
+  # override in your add-on to add to it
+  def add_ons_logged_in_user_list
+    link_html = link_to_unless_current("Cart",
+                                       url_for_trolley(:user => current_user),
+                                       { :tabindex => '2', :class => "trolley-button" })
+
+    content_tag('li', link_html)
+  end
+
+  # in application layout
+  # override in your add-on to add to it
+  def add_ons_basket_admin_list
+    "| " + link_to_unless_current('orders',
+                                  { :controller => :orders,
+                                    :action => :index,
+                                    :urlified_name => @current_basket.urlified_name},
+                                  :tabindex => '2')
+  end
+
+  def add_ons_site_admin_list
+    "| " + link_to_unless_current('all orders for site',
+                                  { :controller => :orders,
+                                    :action => :index,
+                                    :urlified_name => @site_basket.urlified_name},
+                                  :tabindex => '2')
+  end
+
+end

data/lib/kete_gets_trollied/extensions/models/basket.rb

@@ -0,0 +1,4 @@
+# extensions to the kete basket model
+Basket.class_eval do
+  has_many :orders
+end

data/lib/kete_gets_trollied/extensions/models/line_item.rb

@@ -0,0 +1,4 @@
+# kete specific tie-in to trollied line item model
+LineItem.class_eval do
+  delegate :basket, :to => :purchasable_item
+end

data/lib/kete_gets_trollied/extensions/models/order.rb

@@ -0,0 +1,81 @@
+# kete specific tie-in to trollied order model
+Order.class_eval do
+  belongs_to :basket
+  before_save :set_basket_from_line_item
+
+  # this gives us a settings hash per order
+  # that we can use for preferences
+  acts_as_configurable
+
+  ### implementing state methods, so far just for notifications
+  # corresponding methods for actual delivery are in lib/user_order_notifications.rb
+  # these methods are responsible for triggering the deliver and to whom
+
+  # notify the basket moderators that a new order is in_process
+  def checkout
+    # assumes that an in_process must have at least one line_item
+    # and therefore a basket
+    raise "An in_process order should have a basket." unless basket
+
+    basket.moderators_or_next_in_line.each do |user|
+      UserNotifier.deliver_in_process(self, user)
+    end
+
+  end
+
+  # notify the ordering user that their order is ready
+  def fulfilled_without_acceptance
+    UserNotifier.deliver_ready(self, user)
+  end
+
+  # notify the ordering user that their order has been cancelled
+  # notify basket moderators that the order has been cancelled
+  def cancel(cancelling_user)
+    UserNotifier.deliver_cancelled(self, user, cancelling_user) unless user == cancelling_user
+
+    basket.moderators_or_next_in_line.each do |user_in_line|
+      UserNotifier.deliver_cancelled(self, user_in_line, cancelling_user) unless user_in_line == cancelling_user
+    end
+  end
+
+  # notify the ordering user that their order requires user review
+  def alter
+    UserNotifier.deliver_user_review(self, user)
+  end
+
+  # notify staff that user has approved changes and the order is now in process
+  def alteration_approve
+    UserNotifier.deliver_in_process(self, user)
+  end
+
+  alias_method :original_new_note, :new_note
+
+  def new_note(note)
+    original_new_note(note)
+
+    if user == note.user
+      basket.moderators_or_next_in_line.each do |user_in_line|
+        UserNotifier.deliver_new_note(self, note, user_in_line)
+      end
+    else
+      UserNotifier.deliver_new_note(self, note, user)
+    end
+  end
+
+  def set_basket_from_line_item
+    basket ||= line_items.size > 0 ? line_items.first.basket : nil
+  end
+
+  # notes, except in the context of checkout_form, are not allowed
+  def may_note?
+    false
+  end
+
+  # TODO: this is archivescentral specific at this point, move to something that can be configured or something
+  def validate
+    if !new_record? && current?
+      errors.add('contact_name', 'Please provide a contact name for your enquiry') unless contact_name.present?
+      errors.add('contact_phone', 'Please provide a phone number where we may contact you at about your enquiry') unless contact_phone.present?
+    end
+  end
+end

data/lib/kete_gets_trollied/extensions/models/topic.rb

@@ -0,0 +1,7 @@
+# extensions to the kete topic model
+Topic.class_eval do
+  # Walter McGinnis, 2011-05-12
+  # adding shopping cart functionality
+  include GetsTrollied
+  set_up_to_get_trollied :described_as => :reference_title_date_range
+end

data/lib/kete_gets_trollied/extensions/models/trolley.rb

@@ -0,0 +1,10 @@
+Trolley.class_eval do
+  alias_method :original_correct_order, :correct_order
+
+  def correct_order(purchasable_item)
+    correct_orders = orders.with_state_current.select { |o| o.basket == purchasable_item.basket }
+    order = correct_orders.last
+    order = orders.create!(:basket => purchasable_item.basket) unless order.present?
+    order
+  end
+end

data/lib/kete_gets_trollied/extensions/models/user.rb

@@ -0,0 +1,3 @@
+User.class_eval do
+  include HasTrolley
+end

data/lib/kete_gets_trollied/extensions/models/user_notifier.rb

@@ -0,0 +1,3 @@
+UserNotifier.class_eval do
+  include UserOrderNotifications
+end

data/lib/kete_gets_trollied/has_trolley_controller_helpers_overrides.rb

@@ -0,0 +1,51 @@
+require 'kete_url_for'
+module HasTrolleyControllerHelpersOverrides
+  def self.included(klass)
+    klass.send :include, UrlFor
+    klass.send :include, KeteUrlFor
+  end
+  
+  module UrlFor
+    # expects user in options or @user or trolley being set
+    # unless @purchasable_item is present
+    # WARNING: in the case of @purchasable_item
+    # this method name breaks the principle of least surprise
+    # maybe alter trollied gem in future to come right
+    def url_for_trolley(options = { })
+      return url_for_dc_identifier(@purchasable_item) if @purchasable_item && params[:action] == 'create'
+
+      user = options.delete(:user)
+      trolley = options[:trolley] || @trolley || user.trolley
+
+      if trolley.blank?
+        user = @user
+      else
+        user = trolley.user
+      end
+
+      options[:user_id] = user.id
+      options[:controller] = 'trolleys'
+      options[:action] = 'show'
+      options[:urlified_name] = Basket.site_basket.urlified_name
+
+      url = url_for(options) # .split(".%23%")[0]
+    end
+
+    # expects order
+    # either as instance variables or in options
+    def url_for_order(options = { })
+      trolley = options.delete(:trolley) || @trolley
+      trolley = @order.trolley if @order
+
+      order = options.delete(:order) || @order || trolley.selected_order
+      
+      options[:id] = order
+      options[:controller] = 'orders'
+      options[:action] = 'show'
+      options[:urlified_name] = Basket.site_basket.urlified_name
+
+      url_for options
+    end
+
+  end
+end

data/lib/kete_gets_trollied/line_items_helper_overrides.rb

@@ -0,0 +1,10 @@
+module LineItemsHelperOverrides
+  unless included_modules.include? LineItemsHelperOverrides
+    def link_to_purchasable_in(line_item)
+      item = line_item.purchasable_item
+      link_to item.description_for_purchasing, :controller => zoom_class_controller(item.class.name),
+      :urlified_name => item.basket.urlified_name,
+      :action => :show, :id => item
+    end
+  end
+end

data/lib/kete_gets_trollied/orders_helper_overrides.rb

@@ -0,0 +1,141 @@
+module OrdersHelperOverrides
+  unless included_modules.include? OrdersHelperOverrides
+    def can_trigger_fulfilled_without_acceptance?
+      params[:controller] == 'orders' && at_least_a_moderator?
+    end
+
+    def can_trigger_finish?
+      params[:controller] == 'orders' && at_least_a_moderator?
+    end
+
+    def link_to_orders_for(user)
+      options = set_options_from_vars.merge({:user => user})
+      link_to(user.trolley_user_display_name, options)
+    end
+
+    def link_to_state_unless_current(state, count)
+      options = set_options_from_vars.merge({:state => state})
+      link_to_unless_current(t("orders.index.#{state}") + show_count_for(count), options)
+    end
+
+    def orders_state_headline
+      html = super
+      if @current_basket != @site_basket
+        html += ' ' + t('base.inside') + ' ' + @current_basket.name
+      end
+      html
+    end
+
+    # override ### TODO: this isn't overriding the default method
+    def add_ons_logged_in_user_list
+      link_html = super
+
+      link_html += link_to_unless_current(t('base.your_cart'),
+                                          { :user_id => current_user.id, :controller => :trolleys, :action => :show },
+                                          { :tabindex => '2', :class => "trolley-button" })
+
+      content_tag('li', link_html)
+    end
+
+    def set_options_from_vars
+      options = url_for_options_for_orders_index
+      options[:state] = @state if @state
+      options[:from] = @from if @from
+      options[:until] = @until if @until
+      options[:user] = @user if @user
+      options
+    end
+
+    def url_for_options_for_orders_index
+      { :urlified_name => @current_basket.urlified_name,
+        :controller => 'orders',
+        :action => 'index' }
+    end
+
+    def meta_data_for(order)
+      html = '<div id="order-meta-data">'
+      html += '<h3 id="order-id">' + t('orders.helpers.order_number') + " #{order.id}"
+      # TODO: move "order in" to I18n
+      html += " ("
+      if current_user == order.user && params[:controller] == 'trolleys'
+        html += council_full_name_from(order.basket.name)
+      else
+        html += link_basket_orders(order.basket)
+      end
+      html += ')</h3>'
+      if !order.current? && !(order.contact_name.blank? && order.contact_phone.blank?)
+        html += '<h4 id="order-info">'
+        html += order.contact_name + ' - ' if order.contact_name
+        html += order.contact_phone if order.contact_phone
+        html += '</h4>'
+      end
+      html += '</div>'
+    end
+
+    def link_basket_orders(basket)
+      options = set_options_from_vars.merge({:urlified_name => basket.urlified_name})
+      link_to(council_full_name_from(basket.name), options)
+    end
+    
+    def clear_extra_params
+      if @user || @from || @until
+        options = set_options_from_vars
+
+        to_be_cleared = [:user, :trolley, :from, :until]
+
+        to_be_cleared.each { |key_sym| options.delete(key_sym) }
+
+        clear_link = link_to(t("orders.helpers.clear_params"), options)
+
+        clear_link = ' [ ' + clear_link + ' ]'
+        content_tag('span', clear_link, :class => 'clear-params')
+      end
+    end
+
+    def button_to_checkout(order)
+      order_button_for('checkout', order,
+                       { :method => 'get',
+                         :target_action => 'checkout_form',
+                         :url_for_options => { :urlified_name => @site_basket.urlified_name } })
+    end
+
+    def order_checkout_fields(form)
+      html = '<div class="form-element">'
+      html += "<label for=\"order_contact_name\">#{t('orders.helpers.contact_name')}</label>"
+      html += form.text_field(:contact_name, { :tabindex => '1', :label => t('orders.helpers.contact_name')})
+      # html += "<div class=\"form-example\">#{t('orders.helpers.contact_name_example')}</div>"
+      html += '</div>'
+      html += '<div class="form-element">'
+      html += "<label for=\"order_contact_phone\">#{t('orders.helpers.contact_phone')}</label>"
+      html += form.text_field(:contact_phone, { :tabindex => '1' })
+      html += "<div class=\"form-example\">#{t('orders.helpers.contact_phone_example')}</div>"
+      html += '</div>'
+      html += '<div class="form-element">'
+      html += '</div>'
+      html
+    end
+
+    # order number
+    # order user
+    # council
+    # number of line_items
+    # date required by
+    def link_to_as_summary_of(order, user = nil)
+      link_text = t('orders.helpers.order_number') + " #{order.id}"
+      link_text += " - #{user.trolley_user_display_name}" if user.present? && params[:controller] == 'orders'
+      link_text += " - #{council_full_name_from(order.basket.name)}"
+      link_text += " - (#{order.line_items.size} #{t 'orders.helpers.items'})" if order.line_items.size > 0
+      link_text += " - #{order.updated_at.to_s(:db).split(' ')[0]}"
+
+      link_to(link_text, url_for_order(:order => order))
+    end
+
+    def sorted_state_names
+      [:in_process, :ready, :completed, :cancelled]
+    end
+
+    def checkout_form_target_action_url_hash
+      {:action => 'checkout', :id => @order, :urlified_name => @site_basket.urlified_name}
+    end
+  end
+end

data/lib/kete_gets_trollied/user_order_notifications.rb

@@ -0,0 +1,43 @@
+# each notification expects an order object
+module UserOrderNotifications
+  unless included_modules.include? UserOrderNotifications
+    def self.included(klass)
+      klass.send :include, HasTrolleyControllerHelpersOverrides
+    end
+
+    def cancelled(order, user, cancelling_user)
+      setup_email(user)
+      @subject += I18n.t("user_notifier_model.subject_cancelled")
+      @body[:order] = order
+      @body[:cancelling_user] = cancelling_user
+      set_body_url_for(order, user)
+    end
+
+    %w(in_process ready user_review).each do |state_name|
+      code = lambda { |order, user|
+        setup_email(user)
+        @subject += I18n.t("user_notifier_model.subject_#{state_name}")
+        @body[:order] = order
+        set_body_url_for(order, user)
+      }
+
+      define_method(state_name, &code)
+    end
+
+    def new_note(order, note, user)
+      setup_email(user)
+      @subject += I18n.t("user_notifier_model.subject_new_note")
+      @body[:order] = order
+      @body[:note] = note
+      set_body_url_for(order, user)
+    end
+
+    def set_body_url_for(order, user)
+      @body[:url] = url_for(:controller => :orders,
+                            :action => :show,
+                            :id => order,
+                            :urlified_name => order.basket.urlified_name,
+                            :host => Kete.site_name)
+    end
+  end
+end

data/rails/init.rb

@@ -0,0 +1,28 @@
+require 'trollied'
+require 'kete_gets_trollied'
+
+config.to_prepare do
+  # In development/production, we want to only setup stuff if IS_CONFIGURED is true
+  # In test mode however, we always want to have it, since IS_CONFIGURED won't be true
+  # at this stage, but it will be changed to true after Rails initializes.
+  if (IS_CONFIGURED || Rails.env.test?)
+    # no duplicate view files at this time, so no need for engine's views to take precedence
+    # if that changes in the future, see kete_translatable_content/rails/init.rb for how it is done
+
+    # load our locales
+    I18n.load_path += Dir[ File.join(File.dirname(__FILE__), '../config/locales/*.{rb,yml}') ]
+
+    # override some controllers and helpers to be kete gets trollied aware
+    exts = File.join(File.dirname(__FILE__), '../lib/kete_gets_trollied/extensions/{controllers,helpers}/*')
+    # use Kernel.load here so that changes to the extensions are reloaded on each request in development
+    Dir[exts].each { |ext_path| Kernel.load(ext_path) }
+
+    # models we extend
+    Kete.extensions[:blocks] ||= Hash.new
+    Dir[ File.join(File.dirname(__FILE__), '../lib/kete_gets_trollied/extensions/models/*') ].each do |ext_path|
+      key = File.basename(ext_path, '.rb').to_sym
+      Kete.extensions[:blocks][key] ||= Array.new
+      Kete.extensions[:blocks][key] << Proc.new { Kernel.load(ext_path) }
+    end
+  end
+end

data/test/helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'kete_gets_trollied'
+
+class Test::Unit::TestCase
+end

data/test/test_kete_gets_trollied.rb

@@ -0,0 +1,7 @@
+require 'helper'
+
+class TestKeteGetsTrollied < Test::Unit::TestCase
+  should "probably rename this file and start testing for real" do
+    flunk "hey buddy, you should probably rename this file and start testing for real"
+  end
+end

metadata

@@ -0,0 +1,132 @@
+--- !ruby/object:Gem::Specification 
+name: kete_gets_trollied
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Walter McGinnis
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-10-13 00:00:00 +13:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: thoughtbot-shoulda
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: trollied
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 0
+        - 1
+        - 4
+        version: 0.1.4
+  type: :runtime
+  version_requirements: *id002
+description: Uses the trollied gem for adding item ordering to Kete.
+email: walter@katipo.co.nz
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- app/views/user_notifier/cancelled.html.erb
+- app/views/user_notifier/in_process.html.erb
+- app/views/user_notifier/new_note.html.erb
+- app/views/user_notifier/ready.html.erb
+- app/views/user_notifier/reviewing_of.html.erb
+- app/views/user_notifier/user_review.html.erb
+- config/locales/en.yml
+- config/routes.rb
+- lib/kete_gets_trollied.rb
+- lib/kete_gets_trollied/extensions/controllers/application_controller.rb
+- lib/kete_gets_trollied/extensions/controllers/line_items_controller.rb
+- lib/kete_gets_trollied/extensions/controllers/notes_controller.rb
+- lib/kete_gets_trollied/extensions/controllers/orders_controller.rb
+- lib/kete_gets_trollied/extensions/controllers/trolleys_controller.rb
+- lib/kete_gets_trollied/extensions/helpers/application_helper.rb
+- lib/kete_gets_trollied/extensions/models/basket.rb
+- lib/kete_gets_trollied/extensions/models/line_item.rb
+- lib/kete_gets_trollied/extensions/models/order.rb
+- lib/kete_gets_trollied/extensions/models/topic.rb
+- lib/kete_gets_trollied/extensions/models/trolley.rb
+- lib/kete_gets_trollied/extensions/models/user.rb
+- lib/kete_gets_trollied/extensions/models/user_notifier.rb
+- lib/kete_gets_trollied/has_trolley_controller_helpers_overrides.rb
+- lib/kete_gets_trollied/line_items_helper_overrides.rb
+- lib/kete_gets_trollied/orders_helper_overrides.rb
+- lib/kete_gets_trollied/user_order_notifications.rb
+- rails/init.rb
+- test/helper.rb
+- test/test_kete_gets_trollied.rb
+has_rdoc: true
+homepage: http://github.com/kete/kete_gets_trollied
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Uses the trollied gem for adding item ordering to Kete.
+test_files: 
+- test/helper.rb
+- test/test_kete_gets_trollied.rb