DMSDocumentCartController::updateCartItems() - Code Metrics - Inspection of "Merge pull request #33 from creative-commoners/iss..." - silverstripe/silverstripe-dms-cart - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( e99b85...87a4b0 )

unknown

created 2017-06-01 04:05 UTC

DMSDocumentCartController::updateCartItems() C

↳ Parent: DMSDocumentCartController

Complexity

Conditions	7
Paths	3

Size

Total Lines	27
Code Lines	16

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
dl	0
loc	27
rs	6.7272
c	0
b	0
f	0
cc	7
eloc	16
nc	3
nop	3

<?php

class DMSDocumentCartController extends ContentController
namespace YourVendor;

class YourClass { }
{
    private static $url_handlers = array(

        '$Action//$ID' => 'handleAction',
    );

    private static $allowed_actions = array(

        'DMSCartEditForm',
        'add',
        'deduct',
        'remove',
        'view'
    );

    public function init()
    {
        parent::init();
        Requirements::css(DMS_CART_DIR . '/css/dms-cart.css');
    }
    /**
     * See {@link DMSDocumentCart::getItems()}
     *
     * @return ArrayList
     */
    public function items()
    {
        return $this->getCart()->getItems();
    }

    /**
     * Prepares receiver info for the template.
     * Additionally it uses Zend_Locale to retrieve the localised spelling of the Country
     *
     * @return array
     */
    public function getReceiverInfo()
    {
        $receiverInfo = $this->getCart()->getReceiverInfo();

        if (isset($receiverInfo['DeliveryAddressCountry']) && $receiverInfo['DeliveryAddressCountry']) {
            $source = Zend_Locale::getTranslationList('territory', $receiverInfo['DeliveryAddressCountry'], 2);
            $receiverInfo['DeliveryAddressCountryLiteral'] = $source[$receiverInfo['DeliveryAddressCountry']];
        }

        if (!empty($receiverInfo)) {
            $result = $receiverInfo;
        } else {
            $result = array('Result' => 'no data');
        }

        return $result;
    }

    /**
     * See DMSDocumentCart::isCartEmpty()
     *
     * @return bool
     */
    public function getIsCartEmpty()
    {
        return $this->getCart()->isCartEmpty();
    }

    /**
     * Add quantity to an item that exists in {@link DMSDocumentCart}.
     * If the item does nt exist, try to add a new item of the particular
     * class given the URL parameters available.
     *
     * @param SS_HTTPRequest $request
     *
     * @return SS_HTTPResponse|string
     */
    public function add(SS_HTTPRequest $request)
    {
        $quantity = ($request->requestVar('quantity')) ? intval($request->requestVar('quantity')) : 1;
        $documentId = (int)$request->param('ID');
        $result = true;
        $message = '';

        if ($doc = DMSDocument::get()->byID($documentId)) {
            /** @var ValidationResult $validate */
            $validate = $this->validateAddRequest($quantity, $doc);

            if ($validate->valid()) {
                if ($this->getCart()->getItem($documentId)) {
                    $this->getCart()->updateItemQuantity($documentId, $quantity);
                } else {
                    $requestItem = DMSRequestItem::create()->setDocument($doc)->setQuantity($quantity);

                    $this->getCart()->addItem($requestItem);
                }
                $backURL = $request->getVar('BackURL');
                // make sure that backURL is a relative path (starts with /)
                if (isset($backURL) && preg_match('/^\//', $backURL)) {
                    $this->getCart()->setBackUrl($backURL);
                }
            } else {
                $message = $validate->starredList();
                $result = false;
            }
        }

        if ($request->isAjax()) {

            $this->response->addHeader('Content-Type', 'application/json');
            return Convert::raw2json(array('result' => $result, 'message' => $message));
        }

        if (!$result) {
            Session::set('dms-cart-validation-message', $message);
        }

        if ($backURL = $request->getVar('BackURL')) {
            return $this->redirect($backURL);
        }

        return $this->redirectBack();
    }

    /**
     * Deduct quantity from an item that exists in {@link DMSDocumentCart}
     *
     * @param SS_HTTPRequest $request
     *
     * @return SS_HTTPResponse|string
     */
    public function deduct(SS_HTTPRequest $request)
    {
        $quantity = ($request->requestVar('quantity')) ? intval($request->requestVar('quantity')) : 1;
        $this->getCart()->updateItemQuantity((int)$request->param('ID'), $quantity);
        $this->redirectBack();

        if ($request->isAjax()) {

            $this->response->addHeader('Content-Type', 'application/json');

            return Convert::raw2json(array('result' => true));
        }
        if ($backURL = $request->getVar('BackURL')) {
            return $this->redirect($backURL);
        }

        return $this->redirectBack();
    }

    /**
     * Completely remove an item that exists in {@link DMSDocumentCart}
     *
     * @param SS_HTTPRequest $request
     *
     * @return string

     */
    public function remove(SS_HTTPRequest $request)
    {
        $this->getCart()->removeItemByID(intval($request->param('ID')));

        if ($request->isAjax()) {
            $this->response->addHeader('Content-Type', 'application/json');

            return Convert::raw2json(array('result' => !$this->getIsCartEmpty()));
        }

        return $this->redirectBack();
    }

    /**
     * Retrieves a {@link DMSDocumentCart} instance
     *
     * @return DMSDocumentCart
     */
    public function getCart()
    {
        return singleton('DMSDocumentCart');
    }

    /**
     * Validates a request to add a document to the cart
     *
     * @param  int $quantity
     * @param  DMSDocument $document
     * @return ValidationResult
     */
    protected function validateAddRequest($quantity, DMSDocument $document)
    {
        $result = ValidationResult::create();

        if (!$document->isAllowedInCart()) {
            $result->error(_t(__CLASS__ . '.ERROR_NOT_ALLOWED', 'You are not allowed to add this document'));
        }

        if ($document->getHasQuantityLimit() && $quantity > $document->getMaximumQuantity()) {
            $result->error(_t(
                __CLASS__ . '.ERROR_QUANTITY_EXCEEDED',
                'You can\'t add {quantity} of \'{title}\'',
                array('quantity' => $quantity, 'title' => $document->getTitle())
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
            ));
        }

        $this->extend('updateValidateAddRequest', $result, $quantity, $document);

        return $result;
    }

    /**
     * Updates the document quantities just before the request is sent.
     *
     * @param array $data
     * @param Form $form
     * @param SS_HTTPRequest $request
     *
     * @return SS_HTTPResponse

     */
    public function updateCartItems($data, Form $form, SS_HTTPRequest $request)

    {
        if (!empty($data['ItemQuantity'])) {
            foreach ($data['ItemQuantity'] as $itemID => $quantity) {
                if (!is_numeric($quantity) || $quantity < 0) {
                    continue;
                }
                // Only update if quantity has changed
                $item = $this->getCart()->getItem($itemID);
                if ($item->getQuantity() == $quantity) {
                    continue;
                }
                // No validate item
                $validate = $this->validateAddRequest($quantity, $item->getDocument());
                if ($validate->valid()) {
                    // Removes, then adds a item new item.
                    $this->getCart()->removeItem($item);
/**
 * @return array|string
 */
function returnsDifferentValues($x) {
    if ($x) {
        return 'foo';
    }

    return array();
}

$x = returnsDifferentValues($y);
if (is_array($x)) {
    // $x is an array.
}
                    $this->getCart()->addItem($item->setQuantity($quantity));
                } else {
                    $form->sessionMessage($validate->starredList(), 'bad');
                    return $this->redirectBack();
                }
            }
        }

        return $this->redirect($this->getCart()->getBackUrl());
    }

    /**
     * Presents an interface for user to update the cart quantities
     *
     * @param SS_HTTPRequest $request
     * @return ViewableData_Customised
     */
    public function view(SS_HTTPRequest $request)

    {
        $this->getCart()->setViewOnly(true);
        $form = $this->DMSCartEditForm();
        return $this
            ->customise(
                array(
                'Form'  => $form,
                'Title' => _t(__CLASS__ . '.UPDATE_TITLE', 'Updating cart items')
                )
            );
    }

    /**
     * Gets and displays an editable list of items within the cart.
     *
     * To extend use the following from within an Extension subclass:
     *
     * <code>
     * public function updateDMSCartEditForm($form)
     * {
     *     // Do something here
     * }
     * </code>
     *
     * @return Form
     */
    public function DMSCartEditForm()
    {
        $actions = FieldList::create(
            FormAction::create(
                'updateCartItems',
                _t(__CLASS__ . '.SAVE_BUTTON', 'Save changes')
            )
        );
        $form = Form::create(
            $this,
            'DMSCartEditForm',
            FieldList::create(),
            $actions
        );
        $form->setTemplate('DMSDocumentRequestForm');
        $this->extend('updateDMSCartEditForm', $form);
        return $form;
    }

    /**
     * Ensure that links for this controller use the customised route
     *
     * @param  string $action

     * @return string

     */
    public function Link($action = null)
    {
        if ($url = array_search(__CLASS__, (array)Config::inst()->get('Director', 'rules'))) {
            return $this->join_links($url, $action);
        }
    }
}


1		<?php
2
3		class DMSDocumentCartController extends ContentController
		0 ignored issues – show Coding Style Compatibility introduced 2017-05-23 04:54 UTC by Report Bug Copy Issue Report PSR1 recommends that each class must be in a namespace of at least one level to avoid collisions. You can fix this by adding a namespace to your class: namespace YourVendor; class YourClass { } When choosing a vendor namespace, try to pick something that is not too generic to avoid conflicts with other libraries. Loading history...
4		{
5		private static $url_handlers = array(
		0 ignored issues – show Comprehensibility introduced 2017-05-23 04:54 UTC by Report Bug Copy Issue Report Consider using a different property name as you override a private property of the parent class. Loading history... Unused Code introduced 2017-05-23 04:54 UTC by Report Bug Copy Issue Report The property `$url_handlers` is not used and could be removed. This check marks private properties in classes that are never used. Those properties can be removed. Loading history...
6		'$Action//$ID' => 'handleAction',
7		);
8
9		private static $allowed_actions = array(
		0 ignored issues – show Unused Code introduced 2017-05-23 04:54 UTC by Report Bug Copy Issue Report The property `$allowed_actions` is not used and could be removed. This check marks private properties in classes that are never used. Those properties can be removed. Loading history... Comprehensibility introduced 2017-05-26 03:49 UTC by Report Bug Copy Issue Report Consider using a different property name as you override a private property of the parent class. Loading history...
10		'DMSCartEditForm',
11		'add',
12		'deduct',
13		'remove',
14		'view'
15		);
16
17		public function init()
18		{
19		parent::init();
20		Requirements::css(DMS_CART_DIR . '/css/dms-cart.css');
21		}
22		/**
23		* See {@link DMSDocumentCart::getItems()}
24		*
25		* @return ArrayList
26		*/
27		public function items()
28		{
29		return $this->getCart()->getItems();
30		}
31
32		/**
33		* Prepares receiver info for the template.
34		* Additionally it uses Zend_Locale to retrieve the localised spelling of the Country
35		*
36		* @return array
37		*/
38		public function getReceiverInfo()
39		{
40		$receiverInfo = $this->getCart()->getReceiverInfo();
41
42		if (isset($receiverInfo['DeliveryAddressCountry']) && $receiverInfo['DeliveryAddressCountry']) {
43		$source = Zend_Locale::getTranslationList('territory', $receiverInfo['DeliveryAddressCountry'], 2);
44		$receiverInfo['DeliveryAddressCountryLiteral'] = $source[$receiverInfo['DeliveryAddressCountry']];
45		}
46
47		if (!empty($receiverInfo)) {
48		$result = $receiverInfo;
49		} else {
50		$result = array('Result' => 'no data');
51		}
52
53		return $result;
54		}
55
56		/**
57		* See DMSDocumentCart::isCartEmpty()
58		*
59		* @return bool
60		*/
61		public function getIsCartEmpty()
62		{
63		return $this->getCart()->isCartEmpty();
64		}
65
66		/**
67		* Add quantity to an item that exists in {@link DMSDocumentCart}.
68		* If the item does nt exist, try to add a new item of the particular
69		* class given the URL parameters available.
70		*
71		* @param SS_HTTPRequest $request
72		*
73		* @return SS_HTTPResponse\|string
74		*/
75		public function add(SS_HTTPRequest $request)
76		{
77		$quantity = ($request->requestVar('quantity')) ? intval($request->requestVar('quantity')) : 1;
78		$documentId = (int)$request->param('ID');
79		$result = true;
80		$message = '';
81
82		if ($doc = DMSDocument::get()->byID($documentId)) {
83		/** @var ValidationResult $validate */
84		$validate = $this->validateAddRequest($quantity, $doc);
		0 ignored issues – show Compatibility introduced 2017-05-25 05:15 UTC by Report Bug Copy Issue Report `$doc` of type `object<DataObject>` is not a sub-type of `object<DMSDocument>`. It seems like you assume a child class of the class `DataObject` to be always present. This check looks for parameters that are defined as one type in their type hint or doc comment but seem to be used as a narrower type, i.e an implementation of an interface or a subclass. Consider changing the type of the parameter or doing an instanceof check before assuming your parameter is of the expected type. Loading history...
85		if ($validate->valid()) {
86		if ($this->getCart()->getItem($documentId)) {
87		$this->getCart()->updateItemQuantity($documentId, $quantity);
88		} else {
89		$requestItem = DMSRequestItem::create()->setDocument($doc)->setQuantity($quantity);
		0 ignored issues – show Compatibility introduced 2017-05-23 04:54 UTC by Report Bug Copy Issue Report `$doc` of type `object<DataObject>` is not a sub-type of `object<DMSDocument>`. It seems like you assume a child class of the class `DataObject` to be always present. This check looks for parameters that are defined as one type in their type hint or doc comment but seem to be used as a narrower type, i.e an implementation of an interface or a subclass. Consider changing the type of the parameter or doing an instanceof check before assuming your parameter is of the expected type. Loading history...
90		$this->getCart()->addItem($requestItem);
91		}
92		$backURL = $request->getVar('BackURL');
93		// make sure that backURL is a relative path (starts with /)
94		if (isset($backURL) && preg_match('/^\//', $backURL)) {
95		$this->getCart()->setBackUrl($backURL);
96		}
97		} else {
98		$message = $validate->starredList();
99		$result = false;
100		}
101		}
102
103	View Code Duplication	if ($request->isAjax()) {
		0 ignored issues – show Duplication introduced 2017-05-23 04:54 UTC by Report Bug Copy Issue Report This code seems to be duplicated across your project. Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation. You can also find more detailed suggestions in the “Code” section of your repository. Loading history...
104		$this->response->addHeader('Content-Type', 'application/json');
105		return Convert::raw2json(array('result' => $result, 'message' => $message));
106		}
107
108		if (!$result) {
109		Session::set('dms-cart-validation-message', $message);
110		}
111
112		if ($backURL = $request->getVar('BackURL')) {
113		return $this->redirect($backURL);
114		}
115
116		return $this->redirectBack();
117		}
118
119		/**
120		* Deduct quantity from an item that exists in {@link DMSDocumentCart}
121		*
122		* @param SS_HTTPRequest $request
123		*
124		* @return SS_HTTPResponse\|string
125		*/
126		public function deduct(SS_HTTPRequest $request)
127		{
128		$quantity = ($request->requestVar('quantity')) ? intval($request->requestVar('quantity')) : 1;
129		$this->getCart()->updateItemQuantity((int)$request->param('ID'), $quantity);
130		$this->redirectBack();
131
132	View Code Duplication	if ($request->isAjax()) {
		0 ignored issues – show Duplication introduced 2017-05-23 04:54 UTC by Report Bug Copy Issue Report This code seems to be duplicated across your project. Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation. You can also find more detailed suggestions in the “Code” section of your repository. Loading history...
133		$this->response->addHeader('Content-Type', 'application/json');
134
135		return Convert::raw2json(array('result' => true));
136		}
137		if ($backURL = $request->getVar('BackURL')) {
138		return $this->redirect($backURL);
139		}
140
141		return $this->redirectBack();
142		}
143
144		/**
145		* Completely remove an item that exists in {@link DMSDocumentCart}
146		*
147		* @param SS_HTTPRequest $request
148		*
149		* @return string
		0 ignored issues – show Documentation introduced 2017-05-24 11:00 UTC by Report Bug Copy Issue Report Should the return type not be `string\|SS_HTTPResponse\|null\|false`? This check compares the return type specified in the `@return` annotation of a function or method doc comment with the types returned by the function and raises an issue if they mismatch. Loading history...
150		*/
151		public function remove(SS_HTTPRequest $request)
152		{
153		$this->getCart()->removeItemByID(intval($request->param('ID')));
154
155		if ($request->isAjax()) {
156		$this->response->addHeader('Content-Type', 'application/json');
157
158		return Convert::raw2json(array('result' => !$this->getIsCartEmpty()));
159		}
160
161		return $this->redirectBack();
162		}
163
164		/**
165		* Retrieves a {@link DMSDocumentCart} instance
166		*
167		* @return DMSDocumentCart
168		*/
169		public function getCart()
170		{
171		return singleton('DMSDocumentCart');
172		}
173
174		/**
175		* Validates a request to add a document to the cart
176		*
177		* @param int $quantity
178		* @param DMSDocument $document
179		* @return ValidationResult
180		*/
181		protected function validateAddRequest($quantity, DMSDocument $document)
182		{
183		$result = ValidationResult::create();
184
185		if (!$document->isAllowedInCart()) {
186		$result->error(_t(__CLASS__ . '.ERROR_NOT_ALLOWED', 'You are not allowed to add this document'));
187		}
188
189		if ($document->getHasQuantityLimit() && $quantity > $document->getMaximumQuantity()) {
190		$result->error(_t(
191		__CLASS__ . '.ERROR_QUANTITY_EXCEEDED',
192		'You can\'t add {quantity} of \'{title}\'',
193		array('quantity' => $quantity, 'title' => $document->getTitle())
		0 ignored issues – show Documentation introduced 2017-05-31 23:56 UTC by Report Bug Copy Issue Report `array('quantity' => $qua... $document->getTitle())` is of type `array<string,integer\|str...ger","title":"string"}>`, but the function expects a `string`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
194		));
195		}
196
197		$this->extend('updateValidateAddRequest', $result, $quantity, $document);
198
199		return $result;
200		}
201
202		/**
203		* Updates the document quantities just before the request is sent.
204		*
205		* @param array $data
206		* @param Form $form
207		* @param SS_HTTPRequest $request
208		*
209		* @return SS_HTTPResponse
		0 ignored issues – show Documentation introduced 2017-06-01 03:20 UTC by Report Bug Copy Issue Report Should the return type not be `SS_HTTPResponse\|null`? This check compares the return type specified in the `@return` annotation of a function or method doc comment with the types returned by the function and raises an issue if they mismatch. Loading history...
210		*/
211		public function updateCartItems($data, Form $form, SS_HTTPRequest $request)
		0 ignored issues – show Unused Code introduced 2017-05-31 20:48 UTC by Report Bug Copy Issue Report The parameter `$request` is not used and could be removed. This check looks from parameters that have been defined for a function or method, but which are not used in the method body. Loading history...
212		{
213		if (!empty($data['ItemQuantity'])) {
214		foreach ($data['ItemQuantity'] as $itemID => $quantity) {
215		if (!is_numeric($quantity) \|\| $quantity < 0) {
216		continue;
217		}
218		// Only update if quantity has changed
219		$item = $this->getCart()->getItem($itemID);
220		if ($item->getQuantity() == $quantity) {
221		continue;
222		}
223		// No validate item
224		$validate = $this->validateAddRequest($quantity, $item->getDocument());
225		if ($validate->valid()) {
226		// Removes, then adds a item new item.
227		$this->getCart()->removeItem($item);
		0 ignored issues – show Bug introduced 2017-05-31 20:48 UTC by Report Bug Copy Issue Report It seems like `$item` defined by `$this->getCart()->getItem($itemID)` on line `219` can also be of type `boolean`; however, `DMSDocumentCart::removeItem()` does only seem to accept `object<DMSRequestItem>`, maybe add an additional type check? If a method or function can return multiple different values and unless you are sure that you only can receive a single value in this context, we recommend to add an additional type check: /** * @return array\|string */ function returnsDifferentValues($x) { if ($x) { return 'foo'; } return array(); } $x = returnsDifferentValues($y); if (is_array($x)) { // $x is an array. } If this a common case that PHP Analyzer should handle natively, please let us know by opening an issue. Loading history...
228		$this->getCart()->addItem($item->setQuantity($quantity));
229		} else {
230		$form->sessionMessage($validate->starredList(), 'bad');
231		return $this->redirectBack();
232		}
233		}
234		}
235
236		return $this->redirect($this->getCart()->getBackUrl());
237		}
238
239		/**
240		* Presents an interface for user to update the cart quantities
241		*
242		* @param SS_HTTPRequest $request
243		* @return ViewableData_Customised
244		*/
245		public function view(SS_HTTPRequest $request)
		0 ignored issues – show Unused Code introduced 2017-05-31 20:48 UTC by Report Bug Copy Issue Report The parameter `$request` is not used and could be removed. This check looks from parameters that have been defined for a function or method, but which are not used in the method body. Loading history...
246		{
247		$this->getCart()->setViewOnly(true);
248		$form = $this->DMSCartEditForm();
249		return $this
250		->customise(
251		array(
252		'Form' => $form,
253		'Title' => _t(__CLASS__ . '.UPDATE_TITLE', 'Updating cart items')
254		)
255		);
256		}
257
258		/**
259		* Gets and displays an editable list of items within the cart.
260		*
261		* To extend use the following from within an Extension subclass:
262		*
263		* <code>
264		* public function updateDMSCartEditForm($form)
265		* {
266		* // Do something here
267		* }
268		* </code>
269		*
270		* @return Form
271		*/
272		public function DMSCartEditForm()
273		{
274		$actions = FieldList::create(
275		FormAction::create(
276		'updateCartItems',
277		_t(__CLASS__ . '.SAVE_BUTTON', 'Save changes')
278		)
279		);
280		$form = Form::create(
281		$this,
282		'DMSCartEditForm',
283		FieldList::create(),
284		$actions
285		);
286		$form->setTemplate('DMSDocumentRequestForm');
287		$this->extend('updateDMSCartEditForm', $form);
288		return $form;
289		}
290
291		/**
292		* Ensure that links for this controller use the customised route
293		*
294		* @param string $action
		0 ignored issues – show Documentation introduced 2017-06-01 01:51 UTC by Report Bug Copy Issue Report Should the type for parameter `$action` not be `string\|null`? This check looks for `@param` annotations where the type inferred by our type inference engine differs from the declared type. It makes a suggestion as to what type it considers more descriptive. Most often this is a case of a parameter that can be null in addition to its declared types. Loading history...
295		* @return string
		0 ignored issues – show Documentation introduced 2017-05-31 20:48 UTC by Report Bug Copy Issue Report Should the return type not be `string\|null`? This check compares the return type specified in the `@return` annotation of a function or method doc comment with the types returned by the function and raises an issue if they mismatch. Loading history...
296		*/
297		public function Link($action = null)
298		{
299		if ($url = array_search(__CLASS__, (array)Config::inst()->get('Director', 'rules'))) {
300		return $this->join_links($url, $action);
301		}
302		}
303		}
304

silverstripe / silverstripe-dms-cart

Push — master ( e99b85...87a4b0 )

DMSDocumentCartController::updateCartItems() C

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like