관리-도구

편집 파일: freeoptions.php

<?php
/**
 * @copyright Copyright 2003-2023 Zen Cart Development Team
 * @copyright Portions Copyright 2003 osCommerce
 * @license http://www.zen-cart.com/license/2_0.txt GNU Public License V2.0
 * @version $Id: Scott C Wilson 2022 Oct 16 Modified in v1.5.8a $
 */
class freeoptions extends base
 {
 
 /**
 * $_check is used to check the configuration key set up
 * @var int
 */
 protected $_check;
 /**
 * $code determines the internal 'code' name used to designate "this" shipping module
 *
 * @var string
 */
 public $code;
 /**
 * $description is a soft name for this shipping method
 * @var string 
 */
 public $description;
 /**
 * $enabled determines whether this module shows or not... during checkout.
 * @var boolean
 */
 public $enabled;
 /**
 * $debug is an array containing debug information
 * @var array
 */
 public $debug = [];
 /**
 * $icon is the file name containing the Shipping method icon
 * @var string
 */
 public $icon;
 /** 
 * $quotes is an array containing all the quote information for this shipping module
 * @var array
 */
 public $quotes;
 /**
 * $sort_order is the order priority of this shipping module when displayed
 * @var int
 */
 public $sort_order;
 /**
 * $tax_basis is used to indicate if tax is based on shipping, billing or store address.
 * @var string
 */
 public $tax_basis;
 /**
 * $tax_class is the Tax class to be applied to the shipping cost
 * @var string
 */
 public $tax_class;
 /**
 * $title is the displayed name for this shipping method
 * @var string
 */
 public $title;
 
 public function __construct()
 {
 $this->code = 'freeoptions';
 $this->title = MODULE_SHIPPING_FREEOPTIONS_TEXT_TITLE;
 $this->description = MODULE_SHIPPING_FREEOPTIONS_TEXT_DESCRIPTION;
 $this->sort_order = defined('MODULE_SHIPPING_FREEOPTIONS_SORT_ORDER') ? MODULE_SHIPPING_FREEOPTIONS_SORT_ORDER : null;
 if (null === $this->sort_order) return false;

$this->icon = '';
        $this->tax_class = MODULE_SHIPPING_FREEOPTIONS_TAX_CLASS;
        $this->tax_basis = MODULE_SHIPPING_FREEOPTIONS_TAX_BASIS;

// disable only when entire cart is free shipping
        if (zen_get_shipping_enabled($this->code)) {
            $this->enabled = ((MODULE_SHIPPING_FREEOPTIONS_STATUS == 'True') ? true : false);
        }

$this->update_status();
    }

/**
     * Perform various checks to see whether this module should be visible
     */
    public function update_status()
    {
        global $order, $db;
        if ($this->enabled === false || IS_ADMIN_FLAG === true) {
            return;
        }

if ((int)MODULE_SHIPPING_FREEOPTIONS_ZONE > 0) {
 $check_flag = false;
 $check = $db->Execute(
 "SELECT zone_id
 FROM " . TABLE_ZONES_TO_GEO_ZONES . "
 WHERE geo_zone_id = " . (int)MODULE_SHIPPING_FREEOPTIONS_ZONE . "
 AND zone_country_id = " . $order->delivery['country']['id'] . "
 ORDER BY zone_id"
 );
 foreach ($check as $next_zone) {
 if ($next_zone['zone_id'] < 1 || $next_zone['zone_id'] == $order->delivery['zone_id']) {
 $check_flag = true;
 break;
 }
 }

if ($check_flag === false) {
                $this->enabled = false;
            }
        }

// -----
        // If still enabled, check to see if any "Free Options" should be presented to the customer.
        //
        if ($this->enabled === true) {
            $this->checkForFreeOptions();
        }
    }

// -----
    // This function checks to see if the order's total, weight or number-of-items qualifies for the
    // Free Options shipping method.
    //
    protected function checkForFreeOptions()
    {
        global $order;

// -----
        // First, see if any of the 3 options for free shipping are configured.  If none are configured, there's no quote
        // to be returned.
        //
        $freeoptions_total = (MODULE_SHIPPING_FREEOPTIONS_TOTAL_MIN !== '' || MODULE_SHIPPING_FREEOPTIONS_TOTAL_MAX !== '');
        $freeoptions_weight = (MODULE_SHIPPING_FREEOPTIONS_WEIGHT_MIN !== '' || MODULE_SHIPPING_FREEOPTIONS_WEIGHT_MAX !== '');
        $freeoptions_items  = (MODULE_SHIPPING_FREEOPTIONS_ITEMS_MIN !== '' || MODULE_SHIPPING_FREEOPTIONS_ITEMS_MAX !== '');
        $this->debug[] = [$freeoptions_total, $freeoptions_weight, $freeoptions_items];

$this->enabled = ($freeoptions_total === true || $freeoptions_weight === true || $freeoptions_items === true);
        if ($this->enabled === false) {
            return;
        }

// -----
 // If freeoptions on the order's total is requested ...
 //
 if ($freeoptions_total === true) {
 $cart_total = $_SESSION['cart']->show_total();
 if (MODULE_SHIPPING_FREEOPTIONS_TOTAL_MIN !== '' && MODULE_SHIPPING_FREEOPTIONS_TOTAL_MAX !== '') {
 $freeoptions_total = ($cart_total >= MODULE_SHIPPING_FREEOPTIONS_TOTAL_MIN && $cart_total <= MODULE_SHIPPING_FREEOPTIONS_TOTAL_MAX);
 } elseif (MODULE_SHIPPING_FREEOPTIONS_TOTAL_MIN !== '') {
 $freeoptions_total = ($cart_total >= MODULE_SHIPPING_FREEOPTIONS_TOTAL_MIN);
 } else {
 $freeoptions_total = ($cart_total <= MODULE_SHIPPING_FREEOPTIONS_TOTAL_MAX);
 }
 $this->debug[] = ['total', $cart_total, $freeoptions_total, MODULE_SHIPPING_FREEOPTIONS_TOTAL_MIN, MODULE_SHIPPING_FREEOPTIONS_TOTAL_MAX];
 }

// -----
 // If freeoptions on the order's weight is requested ...
 //
 if ($freeoptions_weight === true) {
 $order_weight = round($_SESSION['cart']->show_weight(), 9);
 if (MODULE_SHIPPING_FREEOPTIONS_WEIGHT_MIN !== '' && MODULE_SHIPPING_FREEOPTIONS_WEIGHT_MAX !== '') {
 $freeoptions_weight = ($order_weight >= MODULE_SHIPPING_FREEOPTIONS_WEIGHT_MIN && $order_weight <= MODULE_SHIPPING_FREEOPTIONS_WEIGHT_MAX);
 } elseif (MODULE_SHIPPING_FREEOPTIONS_WEIGHT_MIN !== '') {
 $freeoptions_weight = ($order_weight >= MODULE_SHIPPING_FREEOPTIONS_WEIGHT_MIN);
 } else {
 $freeoptions_weight = ($order_weight <= MODULE_SHIPPING_FREEOPTIONS_WEIGHT_MAX);
 }
 $this->debug[] = ['weight', $order_weight, $freeoptions_weight, MODULE_SHIPPING_FREEOPTIONS_WEIGHT_MIN, MODULE_SHIPPING_FREEOPTIONS_WEIGHT_MAX];
 }

// -----
 // If freeoptions on the order's number of items is requested ...
 //
 if ($freeoptions_items === true) {
 $num_items = $_SESSION['cart']->count_contents();
 if (MODULE_SHIPPING_FREEOPTIONS_ITEMS_MIN !== '' && MODULE_SHIPPING_FREEOPTIONS_ITEMS_MAX !== '') {
 $freeoptions_items = ($num_items >= MODULE_SHIPPING_FREEOPTIONS_ITEMS_MIN && $num_items <= MODULE_SHIPPING_FREEOPTIONS_ITEMS_MAX);
 } elseif (MODULE_SHIPPING_FREEOPTIONS_ITEMS_MIN !== '') {
 $freeoptions_items = ($num_items >= MODULE_SHIPPING_FREEOPTIONS_ITEMS_MIN);
 } else {
 $freeoptions_items = ($num_items <= MODULE_SHIPPING_FREEOPTIONS_ITEMS_MAX);
 }
 $this->debug[] = ['items', $num_items, $freeoptions_items, MODULE_SHIPPING_FREEOPTIONS_ITEMS_MIN, MODULE_SHIPPING_FREEOPTIONS_ITEMS_MAX];
 }

// -----
        // The 'freeoptions' shipping method is enabled if at least one of the 3 configured options
        // are met.
        //
        $this->enabled = ($freeoptions_total === true || $freeoptions_weight === true || $freeoptions_items === true);
    }

// -----
    // Return the "Free Options" quote, as requested.
    //
    public function quote($method = '')
    {
        global $order;
        
        // -----
        // Note: Only requested by the shipping class if previous processing has indicated that the
        // module is enabled!
        //
        $this->quotes = [
            'id' => $this->code,
            'module' => MODULE_SHIPPING_FREEOPTIONS_TEXT_TITLE,
            'methods' => [
                [
                    'id' => $this->code,
                    'title' => MODULE_SHIPPING_FREEOPTIONS_TEXT_WAY,
                    'cost'  => (float)MODULE_SHIPPING_FREEOPTIONS_COST + (float)MODULE_SHIPPING_FREEOPTIONS_HANDLING
                ]
            ]
        ];

if ($this->tax_class > '0') {
            $this->quotes['tax'] = zen_get_tax_rate($this->tax_class, $order->delivery['country']['id'], $order->delivery['zone_id']);
        }

if (!empty($this->icon)) $this->quotes['icon'] = zen_image($this->icon, $this->title);

return $this->quotes;
    }

public function check()
    {
        global $db;
        if (!isset($this->_check)) {
            $check_query = $db->Execute("SELECT configuration_value FROM " . TABLE_CONFIGURATION . " WHERE configuration_key = 'MODULE_SHIPPING_FREEOPTIONS_STATUS'");
            $this->_check = $check_query->RecordCount();
        }
        return $this->_check;
    }

public function get_configuration_errors()
    {
        if (!zen_check_for_misconfigured_downloads()) {
            return TEXT_DOWNLOADABLE_PRODUCTS_MISCONFIGURED; 
        }
    }

public function install()
 {
 global $db;
 $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, set_function, date_added) VALUES ('Enable Free Options Shipping', 'MODULE_SHIPPING_FREEOPTIONS_STATUS', 'True', 'Free Options is used to display a Free Shipping option when other Shipping Modules are displayed.
It can be based on: Always show, Order Total, Order Weight or Order Item Count.
The Free Options module does not show when Free Shipper is displayed. 
Setting Total to >= 0.00 and <= nothing (leave blank) will activate this module to show with all shipping modules, except for Free Shipping - freeshipper. 
NOTE: Leaving all settings for Total, Weight and Item count blank will deactivate this module. 
NOTE: Free Shipping Options does not display if Free Shipping is used based on 0 weight is Free Shipping.
See: freeshipper Do you want to offer per freeoptions rate shipping?', '6', '0', 'zen_cfg_select_option(array(\'True\', \'False\'), ', now())");
 $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added) VALUES ('Shipping Cost', 'MODULE_SHIPPING_FREEOPTIONS_COST', '0.00', 'The shipping cost will be $0.00', '6', '0', now())");
 $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added) VALUES ('Handling Fee', 'MODULE_SHIPPING_FREEOPTIONS_HANDLING', '0', 'Handling fee for this shipping method.', '6', '0', now())");

$db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added) VALUES ('Total >=', 'MODULE_SHIPPING_FREEOPTIONS_TOTAL_MIN', '0.00', 'Free Shipping when Total >=', '6', '0', now())");
 $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added) VALUES ('Total <=', 'MODULE_SHIPPING_FREEOPTIONS_TOTAL_MAX', '', 'Free Shipping when Total <=', '6', '0', now())");

$db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added) VALUES ('Weight >=', 'MODULE_SHIPPING_FREEOPTIONS_WEIGHT_MIN', '', 'Free Shipping when Weight >=', '6', '0', now())");
 $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added) VALUES ('Weight <=', 'MODULE_SHIPPING_FREEOPTIONS_WEIGHT_MAX', '', 'Free Shipping when Weight <=', '6', '0', now())");

$db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added) VALUES ('Item Count >=', 'MODULE_SHIPPING_FREEOPTIONS_ITEMS_MIN', '', 'Free Shipping when Item Count >=', '6', '0', now())");
 $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added) VALUES ('Item Count <=', 'MODULE_SHIPPING_FREEOPTIONS_ITEMS_MAX', '', 'Free Shipping when Item Count <=', '6', '0', now())");

$db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, use_function, set_function, date_added) VALUES ('Tax Class', 'MODULE_SHIPPING_FREEOPTIONS_TAX_CLASS', '0', 'Use the following tax class on the shipping fee.', '6', '0', 'zen_get_tax_class_title', 'zen_cfg_pull_down_tax_classes(', now())");
 $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, set_function, date_added) VALUES ('Tax Basis', 'MODULE_SHIPPING_FREEOPTIONS_TAX_BASIS', 'Shipping', 'On what basis is Shipping Tax calculated. Options are Shipping - Based on customers Shipping Address Billing Based on customers Billing address Store - Based on Store address if Billing/Shipping Zone equals Store zone', '6', '0', 'zen_cfg_select_option(array(\'Shipping\', \'Billing\', \'Store\'), ', now())");
 $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, use_function, set_function, date_added) VALUES ('Shipping Zone', 'MODULE_SHIPPING_FREEOPTIONS_ZONE', '0', 'If a zone is selected, only enable this shipping method for that zone.', '6', '0', 'zen_get_zone_class_title', 'zen_cfg_pull_down_zone_classes(', now())");
 $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added) VALUES ('Sort Order', 'MODULE_SHIPPING_FREEOPTIONS_SORT_ORDER', '0', 'Sort order of display.', '6', '0', now())");
 }

public function help()
    {
        return ['link' => 'https://docs.zen-cart.com/user/shipping/free_shipping/']; 
    }
    
    public function remove()
    {
        global $db;
        $db->Execute("DELETE FROM " . TABLE_CONFIGURATION . " WHERE configuration_key LIKE  'MODULE\_SHIPPING\_FREEOPTIONS\_%'");
    }

public function keys()
    {
        return [
            'MODULE_SHIPPING_FREEOPTIONS_STATUS',
            'MODULE_SHIPPING_FREEOPTIONS_COST',
            'MODULE_SHIPPING_FREEOPTIONS_HANDLING',
            'MODULE_SHIPPING_FREEOPTIONS_TOTAL_MIN',
            'MODULE_SHIPPING_FREEOPTIONS_TOTAL_MAX',
            'MODULE_SHIPPING_FREEOPTIONS_WEIGHT_MIN',
            'MODULE_SHIPPING_FREEOPTIONS_WEIGHT_MAX',
            'MODULE_SHIPPING_FREEOPTIONS_ITEMS_MIN',
            'MODULE_SHIPPING_FREEOPTIONS_ITEMS_MAX',
            'MODULE_SHIPPING_FREEOPTIONS_TAX_CLASS',
            'MODULE_SHIPPING_FREEOPTIONS_TAX_BASIS',
            'MODULE_SHIPPING_FREEOPTIONS_ZONE',
            'MODULE_SHIPPING_FREEOPTIONS_SORT_ORDER'
        ];
    }
}