SilverCommerce\OrdersAdmin\Model\LineItem

Complexity

Total Complexity

64

Size/Duplication

Total Lines	603
Duplicated Lines	0 %

Importance

Changes	10
Bugs	0	Features	2

28 Methods

Rating	Name	Duplication	Size	Complexity
A	getTaxTotal()	0	7	1
A	FindStockItem()	0	3	1
A	getNoTaxPrice()	0	17	3
A	canView()	0	8	3
B	Image()	0	10	8
A	getCustomisationList()	0	14	4
A	getLocale()	0	3	1
A	getSubTotal()	0	7	1
A	Match()	0	12	5
A	onBeforeDelete()	0	6	2
A	canDelete()	0	8	3
A	canEdit()	0	8	3
A	generateKey()	0	9	1
A	onBeforeWrite()	0	4	1
A	canCreate()	0	8	3
A	getUnitPrice()	0	3	1
A	getTaxRate()	0	3	1
A	duplicate()	0	14	3
A	getShowTaxString()	0	3	1
A	getCustomisationAndPriceList()	0	14	4
A	getTotal()	0	7	1
A	getBasePrice()	0	3	1
A	getUnitTotal()	0	7	1
A	checkStockLevel()	0	10	2
A	getCMSFields()	0	54	2
A	CustomisationHTML()	0	17	4
A	getShowPriceWithTax()	0	14	2
A	getUnitTax()	0	8	1

<?php

namespace SilverCommerce\OrdersAdmin\Model;

use SilverStripe\i18n\i18n;
use SilverStripe\ORM\DataObject;
use SilverStripe\Forms\FieldList;
use SilverStripe\Forms\DropdownField;
use SilverStripe\Forms\ReadonlyField;
use SilverStripe\SiteConfig\SiteConfig;
use SilverCommerce\TaxAdmin\Model\TaxRate;
use SilverCommerce\TaxAdmin\Traits\Taxable;
use SilverCommerce\TaxAdmin\PricingExtension;

The type SilverCommerce\TaxAdmin\PricingExtension was not found. Maybe you did not declare it correctly or list all dependencies?

use SilverStripe\Forms\HTMLEditor\HTMLEditorField;
use SilverStripe\Forms\GridField\GridFieldEditButton;
use SilverStripe\Forms\GridField\GridFieldDataColumns;
use SilverStripe\ORM\FieldType\DBHTMLText as HTMLText;
use SilverCommerce\TaxAdmin\Interfaces\TaxableProvider;
use SilverStripe\Forms\GridField\GridFieldAddNewButton;
use SilverStripe\Forms\GridField\GridFieldDeleteAction;
use Symbiote\GridFieldExtensions\GridFieldEditableColumns;
use Symbiote\GridFieldExtensions\GridFieldAddNewInlineButton;
use SilverStripe\Forms\GridField\GridFieldAddExistingAutocompleter;

/**
 * A LineItem is a single line item on an order, extimate or even in
 * the shopping cart.
 *
 * An item has a number of fields that describes a product:
 *
 * - Key: ID used to detect this item
 * - Title: Title of the item
 * - Content: Description of this object
 * - Quantity: Number or items in this order
 * - Weight: Weight of this item (unit of measurment is defined globally)
 * - TaxRate: Rate of tax for this item (e.g. 20.00 for 20%)
 * - ProductClass: ClassName of product that this item is matched against
 * - StockID: Unique identifier of this item (used with ProductClass
 *            match to a product)
 * - Locked: Is this a locked item? Locked items cannot be changed in the
 *           shopping cart
 * - Deliverable: Is this a product that can be delivered? This can effect
 *                delivery options
 *
 * @author Mo <morven@ilateral.co.uk>
 */
class LineItem extends DataObject implements TaxableProvider
{
    use Taxable;

The trait SilverCommerce\TaxAdmin\Traits\Taxable requires the property $Rate which is not provided by SilverCommerce\OrdersAdmin\Model\LineItem.

    private static $table_name = 'LineItem';

    /**
     * The name of the param used on a related product to
     * track Stock Levels.
     *
     * Defaults to StockLevel
     *
     * @var string
     * @config
     */
    private static $stock_param = "StockLevel";

    /**
     * Standard database columns
     *
     * @var array
     * @config
     */
    private static $db = [
        "Key"           => "Varchar(255)",
        "Title"         => "Varchar",
        "BasePrice"     => "Decimal(9,3)",
        "Price"         => "Currency",
        "Quantity"      => "Int",
        "StockID"       => "Varchar(100)",
        "ProductClass"  => "Varchar",
        "Locked"        => "Boolean",
        "Stocked"       => "Boolean",
        "Deliverable"   => "Boolean"
    ];

    /**
     * Foreign key associations in DB
     *
     * @var array
     * @config
     */
    private static $has_one = [
        "Parent"      => Estimate::class,
        "Tax"         => TaxRate::class,
        "TaxRate"     => TaxRate::class
    ];
    
    /**
     * One to many associations
     *
     * @var array
     * @config
     */
    private static $has_many = [
        "Customisations" => LineItemCustomisation::class
    ];

    /**
     * Specify default values of a field
     *
     * @var array
     * @config
     */
    private static $defaults = [
        "Quantity"      => 1,
        "ProductClass"  => "Product",
        "Locked"        => false,
        "Stocked"       => false,
        "Deliverable"   => true
    ];

    /**
     * Function to DB Object conversions
     *
     * @var array
     * @config
     */
    private static $casting = [
        "UnitPrice" => "Currency(9,3)",
        "UnitTax" => "Currency(9,3)",
        "UnitTotal" => "Currency(9,3)",
        "SubTotal" => "Currency(9,3)",
        "TaxRate" => "Decimal",
        "TaxTotal" => "Currency(9,3)",
        "Total" => "Currency(9,3)",
        "CustomisationList" => "Text",
        "CustomisationAndPriceList" => "Text",
    ];

    /**
     * Fields to display in list tables
     *
     * @var array
     * @config
     */
    private static $summary_fields = [
        "Quantity",
        "Title",
        "StockID",
        "BasePrice",
        "TaxRateID",
        "CustomisationAndPriceList"
    ];

    private static $field_labels = [
        "BasePrice"=> "Item Price",
        "Price"    => "Item Price",
        "TaxID"    => "Tax",
        "TaxRateID"=> "Tax",
        "CustomisationAndPriceList" => "Customisations"
    ];

    /**
     * Get the basic price for this object
     *
     * @return float
     */
    public function getBasePrice()
    {
        return $this->dbObject('BasePrice')->getValue();
    }

    /**
     * Return the tax rate for this Object
     *
     * @return TaxRate
     */
    public function getTaxRate()
    {
        return $this->TaxRate();

The method TaxRate() does not exist on SilverCommerce\OrdersAdmin\Model\LineItem. Since you implemented __call, consider adding a @method annotation.

    }

    /**
     * Get the locale from the site
     *
     * @return string
     */
    public function getLocale()
    {
        return i18n::get_locale();
    }

    /**
     * Get should this field automatically show the price including TAX?
     *
     * @return bool
     */
    public function getShowPriceWithTax()
    {
        $config = SiteConfig::current_site_config();
        $show = $config->ShowPriceAndTax;

        $result = $this->filterTaxableExtensionResults(
            $this->extend("updateShowPriceWithTax", $show)
        );

        if (!empty($result)) {
            return (bool)$result;
        }

        return (bool)$show;
    }

    /**
     * We don't want to show a tax string on Line Items
     *
     * @return false
     */
    public function getShowTaxString()
    {
        return false;
    }

    /**
     * Modify default field scaffolding in admin
     *
     * @return FieldList
     */
    public function getCMSFields()
    {
        $this->beforeUpdateCMSFields(function ($fields) {
            $config = SiteConfig::current_site_config();

            $fields->removeByName("Customisation");

            $fields->addFieldToTab(
                "Root.Main",
                ReadonlyField::create("Key"),
                "Title"
            );

            $fields->addFieldToTab(
                "Root.Main",
                DropdownField::create(
                    "TaxID",
                    $this->fieldLabel("TaxID"),
                    $config->TaxRates()->map()
                ),
                "Weight"
            );

            $fields->addFieldsToTab(
                "Root.Description",
                [
                    HTMLEditorField::create("Content")
                        ->addExtraClass("stacked")
                ]
            );

            // Change unlink button to remove on customisation
            $custom_field = $fields->dataFieldByName("Customisations");

            if ($custom_field) {
                $config = $custom_field->getConfig();
                $config
                    ->removeComponentsByType(GridFieldDeleteAction::class)
                    ->removeComponentsByType(GridFieldDataColumns::class)
                    ->removeComponentsByType(GridFieldEditButton::class)
                    ->removeComponentsByType(GridFieldAddNewButton::class)
                    ->removeComponentsByType(GridFieldAddExistingAutocompleter::class)
                    ->addComponents(
                        new GridFieldEditableColumns(),
                        new GridFieldAddNewInlineButton(),
                        new GridFieldEditButton(),
                        new GridFieldDeleteAction()
                    );
                
                    $custom_field->setConfig($config);
            }
        });

        return parent::getCMSFields();
    }
    
    /**
     * Get the price for a single line item (unit), minus any tax
     *
     * @return float
     */
    public function getNoTaxPrice()
    {
        $price = $this->getBasePrice();

        foreach ($this->Customisations() as $customisation) {

The method Customisations() does not exist on SilverCommerce\OrdersAdmin\Model\LineItem. Since you implemented __call, consider adding a @method annotation.

            $price += $customisation->Price;
        }

        $result = $this->getOwner()->filterTaxableExtensionResults(

The method getOwner() does not exist on SilverCommerce\OrdersAdmin\Model\LineItem. Since you implemented __call, consider adding a @method annotation.

            $this->extend("updateNoTaxPrice", $price)
        );

        if (!empty($result)) {
            return $result;
        }

        return $price;
    }

    public function getUnitPrice()
    {
        return $this->getNoTaxPrice();
    }

    /**
     * Get the amount of tax for a single unit of this item
     *
     * **NOTE** Tax is rounded at the single item price to avoid multiplication
     * weirdness. For example 49.995 + 20% is 59.994 for one product,
     * but 239.976 for 4 (it should be 239.96)
     *
     * @return float
     */
    public function getUnitTax()
    {
        // Calculate and round tax now to try and minimise penny rounding issues
        $total = ($this->UnitPrice / 100) * $this->TaxPercentage;

The property TaxPercentage does not exist on SilverCommerce\OrdersAdmin\Model\LineItem. Since you implemented __get, consider adding a @property annotation.

The property UnitPrice does not exist on SilverCommerce\OrdersAdmin\Model\LineItem. Since you implemented __get, consider adding a @property annotation.

        $this->extend("updateUnitTax", $total);

        return $total;
    }

    /**
     * Get the total price and tax for a single unit
     *
     * @return float
     */
    public function getUnitTotal()
    {
        $total = $this->UnitPrice + $this->UnitTax;

The property UnitPrice does not exist on SilverCommerce\OrdersAdmin\Model\LineItem. Since you implemented __get, consider adding a @property annotation.

The property UnitTax does not exist on SilverCommerce\OrdersAdmin\Model\LineItem. Since you implemented __get, consider adding a @property annotation.

        $this->extend("updateUnitTotal", $total);

        return $total;
    }

    /**
     * Get the value of this item, minus any tax
     *
     * @return float
     */
    public function getSubTotal()
    {
        $total = $this->NoTaxPrice * $this->Quantity;

The property NoTaxPrice does not exist on SilverCommerce\OrdersAdmin\Model\LineItem. Since you implemented __get, consider adding a @property annotation.

The property Quantity does not exist on SilverCommerce\OrdersAdmin\Model\LineItem. Since you implemented __get, consider adding a @property annotation.

        $this->extend("updateSubTotal", $total);

        return $total;
    }

    /**
     * Get the total amount of tax for a single unit of this item
     *
     * @return float
     */
    public function getTaxTotal()
    {
        $total = $this->UnitTax * $this->Quantity;

The property UnitTax does not exist on SilverCommerce\OrdersAdmin\Model\LineItem. Since you implemented __get, consider adding a @property annotation.

The property Quantity does not exist on SilverCommerce\OrdersAdmin\Model\LineItem. Since you implemented __get, consider adding a @property annotation.

        $this->extend("updateTaxTotal", $total);

        return $total;
    }

    /**
     * Get the value of this item, minus any tax
     *
     * @return float
     */
    public function getTotal()
    {
        $total = $this->SubTotal + $this->TaxTotal;

The property SubTotal does not exist on SilverCommerce\OrdersAdmin\Model\LineItem. Since you implemented __get, consider adding a @property annotation.

The property TaxTotal does not exist on SilverCommerce\OrdersAdmin\Model\LineItem. Since you implemented __get, consider adding a @property annotation.

        $this->extend("updateTotal", $total);
    
        return $total;
    }

    /**
     * Get an image object associated with this line item.
     * By default this is retrieved from the base product.
     *
     * @return Image | null

The type SilverCommerce\OrdersAdmin\Model\Image was not found. Maybe you did not declare it correctly or list all dependencies?

     */
    public function Image()
    {
        $product = $this->FindStockItem();

        if ($product && method_exists($product, "SortedImages")) {
            return  $product->SortedImages()->first();
        } elseif ($product && method_exists($product, "Images")) {
            return $product->Images()->first();
        } elseif ($product && method_exists($product, "Image") && $product->Image()->exists()) {
            return $product->Image();
        }
    }
    
    /**
     * Provide a string of customisations seperated by a comma but not
     * including a price
     *
     * @return string
     */
    public function getCustomisationList()
    {
        $return = [];
        $items = $this->Customisations();

        if ($items && $items->exists()) {
            foreach ($items as $item) {
                $return[] = $item->Title . ': ' . $item->Value;
            }
        }

        $this->extend("updateCustomisationList", $return);

        return implode(", ", $return);
    }

    /**
     * Provide a string of customisations seperated by a comma and
     * including a price
     *
     * @return string
     */
    public function getCustomisationAndPriceList()
    {
        $return = [];
        $items = $this->Customisations();

        if ($items && $items->exists()) {
            foreach ($items as $item) {
                $return[] = $item->Title . ': ' . $item->Value . ' (' . $item->getFormattedPrice() . ')';
            }
        }

        $this->extend("updateCustomisationAndPriceList", $return);

        return implode(", ", $return);
    }
    
    /**
     * Get list of customisations rendering into a basic
     * HTML string
     *
     * @return HTMLText
     */
    public function CustomisationHTML()
    {
        $return = HTMLText::create();
        $items = $this->Customisations();
        $html = "";
        
        if ($items && $items->exists()) {
            foreach ($items as $item) {
                $html .= $item->Title . ': ' . $item->Value . ";<br/>";
            }
        }

        $return->setValue($html);

        $this->extend("updateCustomisationHTML", $return);

        return $return;
    }
        
    /**
     * Match this item to another object in the Database, by the
     * provided details.
     *
     * @param $relation_name = The class name of the related dataobject

The doc comment = at position 0 could not be parsed: Unknown type name '=' at position 0 in =.

     * @param $relation_col = The column name of the related object
     * @param $match_col = The column we use to match the two objects
     * @return DataObject
     */
    public function Match($relation_name = null, $relation_col = "StockID", $match_col = "StockID")
    {
        // Try to determine relation name
        if (!$relation_name && !$this->ProductClass) {

The property ProductClass does not exist on SilverCommerce\OrdersAdmin\Model\LineItem. Since you implemented __get, consider adding a @property annotation.

            $relation_name = "Product";
        } elseif (!$relation_name && $this->ProductClass) {
            $relation_name = $this->ProductClass;
        }
        
        return $relation_name::get()
            ->filter($relation_col, $this->$match_col)
            ->first();
    }

    /**
     * Find our original stock item (useful for adding links back to the
     * original product).
     *
     * This function is a synonym for @Link Match (as a result of) merging
     * LineItem
     *
     * @return DataObject
     */
    public function FindStockItem()
    {
        return $this->Match();
    }

    /**
     * Check stock levels for this item, will return the actual number
     * of remaining stock after removing the current quantity
     *
     * @param $qty The quantity we want to check against

The type SilverCommerce\OrdersAdmin\Model\The was not found. Maybe you did not declare it correctly or list all dependencies?

     * @return Int
     */
    public function checkStockLevel($qty)
    {
        $stock_param = $this->config()->get("stock_param");
        $item = $this->Match();
        $stock = ($item->$stock_param) ? $item->$stock_param : 0;
        $return = $stock - $qty;

        $this->extend("updateCheckStockLevel", $return);
        
        return $return;
    }

    /**
     * Generate a key based on this item and its customisations
     *
     * @return string
     */
    public function generateKey()
    {
        // Generate a unique item key based on the current ID and customisations
        $key = base64_encode(
            json_encode(
                $this->Customisations()->map("Title", "Value")->toArray()
            )
        );
        return $this->StockID . ':' . $key;

The property StockID does not exist on SilverCommerce\OrdersAdmin\Model\LineItem. Since you implemented __get, consider adding a @property annotation.

    }

    /**
     * Only order creators or users with VIEW admin rights can view
     *
     * @return Boolean
     */
    public function canView($member = null, $context = [])

The parameter $context is not used and could be removed.

    {
        $extended = $this->extend('canView', $member);
        if ($extended && $extended !== null) {
            return $extended;
        }

        return $this->Parent()->canView($member);

The method Parent() does not exist on SilverCommerce\OrdersAdmin\Model\LineItem. Since you implemented __call, consider adding a @method annotation.

    }

    /**
     * Anyone can create an order item
     *
     * @return Boolean
     */
    public function canCreate($member = null, $context = [])
    {
        $extended = $this->extend('canCreate', $member);
        if ($extended && $extended !== null) {
            return $extended;
        }

        return true;
    }

    /**
     * No one can edit items once they are created
     *
     * @return Boolean
     */
    public function canEdit($member = null, $context = [])

The parameter $context is not used and could be removed.

    {
        $extended = $this->extend('canEdit', $member);
        if ($extended && $extended !== null) {
            return $extended;
        }

        return $this->Parent()->canEdit($member);
    }

    /**
     * No one can delete items once they are created
     *
     * @return Boolean
     */
    public function canDelete($member = null, $context = [])

The parameter $context is not used and could be removed.

    {
        $extended = $this->extend('canDelete', $member);
        if ($extended && $extended !== null) {
            return $extended;
        }

        return $this->Parent()->canEdit($member);
    }

    /**
     * Overwrite default duplicate function
     *
     * @param boolean $doWrite (write the cloned object to DB)
     * @return DataObject $clone The duplicated object
     */
    public function duplicate($doWrite = true, $manyMany = "many_many")
    {
        $clone = parent::duplicate($doWrite);

        // Ensure we clone any customisations
        if ($doWrite) {
            foreach ($this->Customisations() as $customisation) {
                $new_item = $customisation->duplicate(false);
                $new_item->ParentID = $clone->ID;
                $new_item->write();
            }
        }

        return $clone;
    }

    /**
     * Pre-write tasks
     *
     * @return void
     */
    public function onBeforeWrite()
    {
        parent::onBeforeWrite();
        $this->Key = $this->generateKey();

The property Key does not exist. Although not strictly required by PHP, it is generally a best practice to declare properties explicitly.

    }

    /**
     * Clean up DB on deletion
     *
     * @return void
     */
    public function onBeforeDelete()
    {
        parent::onBeforeDelete();

        foreach ($this->Customisations() as $customisation) {
            $customisation->delete();
        }
    }
}