tienda 1.0.0

data/app/controllers/tienda/users_controller.rb

@@ -0,0 +1,53 @@
+module Tienda
+  class UsersController < Tienda::ApplicationController
+
+    before_filter { @active_nav = :users }
+    before_filter { params[:id] && @user = Tienda::User.find(params[:id]) }
+    before_filter(only: [:create, :update, :destroy]) do
+      if Tienda.settings.demo_mode?
+        raise Tienda::Error, t('tienda.users.demo_mode_error')
+      end
+    end
+
+    def index
+      @users = Tienda::User.all
+    end
+
+    def new
+      @user = Tienda::User.new
+    end
+
+    def create
+      @user = Tienda::User.new(safe_params)
+      if @user.save
+        redirect_to :users, flash: { notice: t('tienda.users.create_notice') }
+      else
+        render action: "new"
+      end
+    end
+
+    def edit
+    end
+
+    def update
+      if @user.update(safe_params)
+        redirect_to [:edit, @user], flash: { notice t('tienda.users.update_notice') }
+      else
+        render action: "edit"
+      end
+    end
+
+    def destroy
+      raise Tienda::Error, t('tienda.users.self_remove_error') if @user == current_user
+      @user.destroy
+      redirect_to :users, flash: { notice: t('tienda.users.destroy_notice') }
+    end
+
+    private
+
+    def safe_params
+      params[:user].permit(:first_name, :last_name, :email_address, :password, :password_confirmation)
+    end
+
+  end
+end

data/app/controllers/tienda/variants_controller.rb

@@ -0,0 +1,50 @@
+module Tienda
+  class VariantsController < ApplicationController
+
+    before_filter { @active_nav = :products }
+    before_filter { @product = Tienda::Product.find(params[:product_id]) }
+    before_filter { params[:id] && @variant = @product.variants.find(params[:id]) }
+
+    def index
+      @variants = @product.variants.ordered
+    end
+
+    def new
+      @variant = @product.variants.build
+      render action: "form"
+    end
+
+    def create
+      @variant = @product.variants.build(safe_params)
+      if @variant.save
+        redirect_to [@product, :variants], notice: t('tienda.variants.create_notice')
+      else
+        render action: "form"
+      end
+    end
+
+    def edit
+      render action: "form"
+    end
+
+    def update
+      if @variant.update(safe_params)
+        redirect_to edit_product_variant_path(@product, @variant), notice: t('tienda.variants.update_notice')
+      else
+        render action: "form"
+      end
+    end
+
+    def destroy
+      @variant.destroy
+      redirect_to [@product, :variants], notice: t('tienda.variants.destroy_notice')
+    end
+
+    private
+
+    def safe_params
+      params[:product].permit(:name, :permalink, :sku, :default_image_file, :price, :cost_price, :tax_rate_id, :weight, :stock_control, :active, :default)
+    end
+
+  end
+end

data/app/helpers/tienda/application_helper.rb

@@ -0,0 +1,60 @@
+module Tienda
+  module ApplicationHelper
+
+    def navigation_manager_link(item)
+      link_to item.description, item.url(self), item.link_options.merge(:class => item.active?(self) ? 'active' : 'inactive')
+    end
+
+    def status_tag(status)
+      content_tag :span, t("tienda.orders.statuses.#{status}"), :class => "status-tag #{status}"
+    end
+
+    def attachment_preview(attachment, options = {})
+      if attachment
+        String.new.tap do |s|
+          if attachment.image?
+            style = "style='background-image:url(#{attachment.path})'"
+          else
+            style = ''
+          end
+          s << "<div class='attachmentPreview #{attachment.image? ? 'image' : 'doc'}'>"
+          s << "<div class='imgContainer'><div class='img' #{style}></div></div>"
+          s << "<div class='desc'>"
+          s << "<span class='filename'><a href='#{attachment_path(attachment)}'>#{attachment.file_name}</a></span>"
+          s << "<span class='delete'>"
+          s << link_to(t('helpers.attachment_preview.delete', :default => 'Delete this file?'), attachment_path(attachment), :method => :delete, :data => {:confirm => t('helpers.attachment_preview.delete_confirm', :default => "Are you sure you wish to remove this attachment?")})
+          s << "</span>"
+          s << "</div>"
+          s << "</div>"
+        end.html_safe
+      elsif !options[:hide_if_blank]
+        "<div class='attachmentPreview'><div class='imgContainer'><div class='img none'></div></div><div class='desc none'>#{t('helpers.attachment_preview.no_attachment')},</div></div>".html_safe
+      end
+    end
+
+    def settings_label(field)
+      "<label for='settings_#{field}'>#{t("tienda.settings.labels.#{field}")}</label>".html_safe
+    end
+
+    def settings_field(field, options = {})
+      default = I18n.t("tienda.settings.defaults")[field.to_sym]
+      value = (params[:settings] && params[:settings][field]) || Tienda.settings[field.to_s]
+      type = I18n.t("tienda.settings.types")[field.to_sym] || 'string'
+      case type
+      when 'boolean'
+        String.new.tap do |s|
+          value = default if value.blank?
+          s << "<div class='radios'>"
+          s << radio_button_tag("settings[#{field}]", 'true', value == true, :id => "settings_#{field}_true")
+          s << label_tag("settings_#{field}_true", t("tienda.settings.options.#{field}.affirmative", :default => 'Yes'))
+          s << radio_button_tag("settings[#{field}]", 'false', value == false, :id => "settings_#{field}_false")
+          s << label_tag("settings_#{field}_false", t("tienda.settings.options.#{field}.negative", :default => 'No'))
+          s << "</div>"
+        end.html_safe
+      else
+        text_field_tag "settings[#{field}]", value, options.merge(:placeholder => default, :class => 'text')
+      end
+    end
+
+  end
+end

data/app/mailers/tienda/order_mailer.rb

@@ -0,0 +1,25 @@
+module Tienda
+  class OrderMailer < ActionMailer::Base
+
+    def received(order)
+      @order = order
+      mail :from => Tienda.settings.outbound_email_address, :to => order.email_address, :subject => I18n.t('tienda.order_mailer.received.subject', :default => "Order Confirmation")
+    end
+
+    def accepted(order)
+      @order = order
+      mail :from => Tienda.settings.outbound_email_address, :to => order.email_address, :subject => I18n.t('tienda.order_mailer.received.accepted', :default => "Order Accepted")
+    end
+
+    def rejected(order)
+      @order = order
+      mail :from => Tienda.settings.outbound_email_address, :to => order.email_address, :subject => I18n.t('tienda.order_mailer.received.rejected', :default => "Order Rejected")
+    end
+
+    def shipped(order)
+      @order = order
+      mail :from => Tienda.settings.outbound_email_address, :to => order.email_address, :subject => I18n.t('tienda.order_mailer.received.shipped', :default => "Order Shipped")
+    end
+
+  end
+end

data/app/mailers/tienda/user_mailer.rb

@@ -0,0 +1,10 @@
+module Tienda
+  class UserMailer < ActionMailer::Base
+
+    def new_password(user)
+      @user = user
+      mail :from => Tienda.settings.outbound_email_address, :to => user.email_address, :subject => "Your new Tienda password"
+    end
+
+  end
+end

data/app/models/tienda/country.rb

@@ -0,0 +1,27 @@
+module Tienda
+
+  # The Tienda::Country model stores countries which can be used for delivery & billing
+  # addresses for orders.
+  #
+  # You can use the Tienda::CountryImporter to import a pre-defined list of countries
+  # into your database. This automatically happens when you run the 'tienda:setup'
+  # rake task.
+
+  class Country < ActiveRecord::Base
+
+    self.table_name = 'tienda_countries'
+
+    # All orders which have this country set as their billing country
+    has_many :billed_orders, :dependent => :restrict_with_exception, :class_name => 'Tienda::Order', :foreign_key => 'billing_country_id'
+
+    # All orders which have this country set as their delivery country
+    has_many :delivered_orders, :dependent => :restrict_with_exception, :class_name => 'Tienda::Order', :foreign_key => 'delivery_country_id'
+
+    # All countries ordered by their name asending
+    scope :ordered, -> { order(:name => :asc) }
+
+    # Validations
+    validates :name, :presence => true
+
+  end
+end

data/app/models/tienda/delivery_service.rb

@@ -0,0 +1,33 @@
+module Tienda
+  class DeliveryService < ActiveRecord::Base
+
+    self.table_name = 'tienda_delivery_services'
+
+    # Validations
+    validates :name, :presence => true
+    validates :courier, :presence => true
+
+    # Orders which are assigned to this delivery service
+    has_many :orders, :dependent => :restrict_with_exception, :class_name => 'Tienda::Order'
+
+    # Prices for the different levels of service within this delivery service
+    has_many :delivery_service_prices, :dependent => :destroy, :class_name => 'Tienda::DeliveryServicePrice'
+
+    # All active delivery services
+    scope :active, -> { where(:active => true)}
+
+    # Returns a tracking URL for the passed order
+    #
+    # @param order [Tienda::Order]
+    # @return [String] the full URL for the order.
+    def tracking_url_for(order)
+      return nil if self.tracking_url.blank?
+      tracking_url = self.tracking_url.dup
+      tracking_url.gsub!("{{consignment_number}}", CGI.escape(order.consignment_number.to_s))
+      tracking_url.gsub!("{{delivery_postcode}}", CGI.escape(order.delivery_postcode.to_s))
+      tracking_url.gsub!("{{billing_postcode}}", CGI.escape(order.billing_postcode.to_s))
+      tracking_url
+    end
+
+  end
+end

data/app/models/tienda/delivery_service_price.rb

@@ -0,0 +1,31 @@
+module Tienda
+  class DeliveryServicePrice < ActiveRecord::Base
+
+    # Set the table name
+    self.table_name = 'tienda_delivery_service_prices'
+
+    include Tienda::AssociatedCountries
+
+    # The delivery service which this price belongs to
+    belongs_to :delivery_service, :class_name => 'Tienda::DeliveryService'
+
+    # The tax rate which should be applied
+    belongs_to :tax_rate, :class_name => "Tienda::TaxRate"
+
+    # Validations
+    validates :code, :presence => true
+    validates :price, :numericality => true
+    validates :cost_price, :numericality => true, :allow_blank => true
+    validates :min_weight, :numericality => true
+    validates :max_weight, :numericality => true
+
+    # All prices ordered by their price ascending
+    scope :ordered, -> { order(:price => :asc) }
+
+    # All prices which are suitable for the weight passed.
+    #
+    # @param weight [BigDecimal] the weight of the order
+    scope :for_weight, -> weight { where("min_weight <= ? AND max_weight >= ?", weight, weight) }
+
+  end
+end

data/app/models/tienda/order/actions.rb

@@ -0,0 +1,98 @@
+module Tienda
+  class Order < ActiveRecord::Base
+
+    extend ActiveModel::Callbacks
+
+    # These additional callbacks allow for applications to hook into other
+    # parts of the order lifecycle.
+    define_model_callbacks :confirmation, :acceptance, :rejection
+
+    # This method should be called by the base application when the user has completed their
+    # first round of entering details. This will mark the order as "confirming" which means
+    # the customer now just must confirm.
+    #
+    # @param params [Hash] a hash of order attributes
+    # @return [Boolean]
+    def proceed_to_confirm(params = {})
+      self.status = 'confirming'
+      if self.update(params)
+        true
+      else
+        false
+      end
+    end
+
+    # This method should be executed by the application when the order should be completed
+    # by the customer. It will raise exceptions if anything goes wrong or return true if
+    # the order has been confirmed successfully
+    #
+    # @return [Boolean]
+    def confirm!
+      no_stock_of = self.order_items.select(&:validate_stock_levels)
+      unless no_stock_of.empty?
+        raise Tienda::Errors::InsufficientStockToFulfil, :order => self, :out_of_stock_items => no_stock_of
+      end
+
+      run_callbacks :confirmation do
+        # If we have successfully charged the card (i.e. no exception) we can go ahead and mark this
+        # order as 'received' which means it can be accepted by staff.
+        self.status = 'received'
+        self.received_at = Time.now
+        self.save!
+
+        self.order_items.each(&:confirm!)
+
+        # Send an email to the customer
+        deliver_received_order_email
+      end
+
+      # We're all good.
+      true
+    end
+
+    # Mark order as accepted
+    #
+    # @param user [Tienda::User] the user who carried out this action
+    def accept!(user = nil)
+      transaction do
+        run_callbacks :acceptance do
+          self.accepted_at = Time.now
+          self.accepter = user if user
+          self.status = 'accepted'
+          self.save!
+          self.order_items.each(&:accept!)
+          deliver_accepted_order_email
+        end
+      end
+    end
+
+    # Mark order as rejected
+    #
+    # @param user [Tienda::User] the user who carried out the action
+    def reject!(user = nil)
+      transaction do
+        run_callbacks :rejection do
+          self.rejected_at = Time.now
+          self.rejecter = user if user
+          self.status = 'rejected'
+          self.save!
+          self.order_items.each(&:reject!)
+          deliver_rejected_order_email
+        end
+      end
+    end
+
+    def deliver_accepted_order_email
+      Tienda::OrderMailer.accepted(self).deliver
+    end
+
+    def deliver_rejected_order_email
+      Tienda::OrderMailer.rejected(self).deliver
+    end
+
+    def deliver_received_order_email
+      Tienda::OrderMailer.received(self).deliver
+    end
+
+  end
+end

data/app/models/tienda/order/billing.rb

@@ -0,0 +1,105 @@
+module Tienda
+  class Order < ActiveRecord::Base
+
+    # The country which this order should be billed to
+    #
+    # @return [Tienda::Country]
+    belongs_to :billing_country, :class_name => 'Tienda::Country', :foreign_key => 'billing_country_id'
+
+    # Payments which have been stored for the order
+    has_many :payments, :dependent => :destroy, :class_name => 'Tienda::Payment'
+
+    # Validations
+    with_options :if => Proc.new { |o| !o.building? } do |order|
+      order.validates :first_name, :presence => true
+      order.validates :last_name, :presence => true
+      order.validates :billing_address1, :presence => true
+      order.validates :billing_address3, :presence => true
+      order.validates :billing_address4, :presence => true
+      order.validates :billing_postcode, :presence => true
+      order.validates :billing_country, :presence => true
+    end
+
+    # The name for billing purposes
+    #
+    # @return [String]
+    def billing_name
+      company.blank? ? full_name : "#{full_name} (#{company})"
+    end
+
+    # The total cost of the order
+    #
+    # @return [BigDecimal]
+    def total_cost
+      self.delivery_cost_price +
+      order_items.inject(BigDecimal(0)) { |t, i| t + i.total_cost }
+    end
+
+    # Return the price for the order
+    #
+    # @return [BigDecimal]
+    def profit
+      total_before_tax - total_cost
+    end
+
+    # The total price of all items in the basket excluding delivery
+    #
+    # @return [BigDecimal]
+    def items_sub_total
+      order_items.inject(BigDecimal(0)) { |t, i| t + i.sub_total }
+    end
+
+    # The total price of the order before tax
+    #
+    # @return [BigDecimal]
+    def total_before_tax
+      self.delivery_price + self.items_sub_total
+    end
+
+    # The total amount of tax due on this order
+    #
+    # @return [BigDecimal]
+    def tax
+      self.delivery_tax_amount +
+      order_items.inject(BigDecimal(0)) { |t, i| t + i.tax_amount }
+    end
+
+    # The total of the order including tax
+    #
+    # @return [BigDecimal]
+    def total
+      self.delivery_price +
+      self.delivery_tax_amount +
+      order_items.inject(BigDecimal(0)) { |t, i| t + i.total }
+    end
+
+    # The total amount due on the order
+    #
+    # @return [BigDecimal]
+    def balance
+      @balance ||= total - amount_paid
+    end
+
+    # Is there a payment still outstanding on this order?
+    #
+    # @return [Boolean]
+    def payment_outstanding?
+      balance > BigDecimal(0)
+    end
+
+    # Has this order been paid in full?
+    #
+    # @return [Boolean]
+    def paid_in_full?
+      !payment_outstanding?
+    end
+
+    # Is the order invoiced?
+    #
+    # @return [Boolean]
+    def invoiced?
+      !invoice_number.blank?
+    end
+
+  end
+end