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

Completed

Push — master ( 87a4b0...824833 )

unknown

created 2017-06-06 04:04 UTC

DMSDocumentCartController::init() A

↳ Parent: DMSDocumentCartController

Complexity

Conditions	1
Paths	1

Size

Total Lines	5
Code Lines	3

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
dl	0
loc	5
rs	9.4285
c	0
b	0
f	0
cc	1
eloc	3
nc	1
nop	0

<?php

class DMSDocumentCartController extends DMSCartAbstractController
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();
    }

    /**
     * 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;
    }
}


1		<?php
2
3		class DMSDocumentCartController extends DMSCartAbstractController
		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		* Validates a request to add a document to the cart
166		*
167		* @param int $quantity
168		* @param DMSDocument $document
169		* @return ValidationResult
170		*/
171		protected function validateAddRequest($quantity, DMSDocument $document)
172		{
173		$result = ValidationResult::create();
174
175		if (!$document->isAllowedInCart()) {
176		$result->error(_t(__CLASS__ . '.ERROR_NOT_ALLOWED', 'You are not allowed to add this document'));
177		}
178
179		if ($document->getHasQuantityLimit() && $quantity > $document->getMaximumQuantity()) {
180		$result->error(_t(
181		__CLASS__ . '.ERROR_QUANTITY_EXCEEDED',
182		'You can\'t add {quantity} of \'{title}\'',
183		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...
184		));
185		}
186
187		$this->extend('updateValidateAddRequest', $result, $quantity, $document);
188
189		return $result;
190		}
191
192		/**
193		* Updates the document quantities just before the request is sent.
194		*
195		* @param array $data
196		* @param Form $form
197		* @param SS_HTTPRequest $request
198		*
199		* @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...
200		*/
201		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...
202		{
203		if (!empty($data['ItemQuantity'])) {
204		foreach ($data['ItemQuantity'] as $itemID => $quantity) {
205		if (!is_numeric($quantity) \|\| $quantity < 0) {
206		continue;
207		}
208		// Only update if quantity has changed
209		$item = $this->getCart()->getItem($itemID);
210		if ($item->getQuantity() == $quantity) {
211		continue;
212		}
213		// No validate item
214		$validate = $this->validateAddRequest($quantity, $item->getDocument());
215		if ($validate->valid()) {
216		// Removes, then adds a item new item.
217		$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 `209` 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...
218		$this->getCart()->addItem($item->setQuantity($quantity));
219		} else {
220		$form->sessionMessage($validate->starredList(), 'bad');
221		return $this->redirectBack();
222		}
223		}
224		}
225
226		return $this->redirect($this->getCart()->getBackUrl());
227		}
228
229		/**
230		* Presents an interface for user to update the cart quantities
231		*
232		* @param SS_HTTPRequest $request
233		* @return ViewableData_Customised
234		*/
235		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...
236		{
237		$this->getCart()->setViewOnly(true);
238		$form = $this->DMSCartEditForm();
239		return $this
240		->customise(
241		array(
242		'Form' => $form,
243		'Title' => _t(__CLASS__ . '.UPDATE_TITLE', 'Updating cart items')
244		)
245		);
246		}
247
248		/**
249		* Gets and displays an editable list of items within the cart.
250		*
251		* To extend use the following from within an Extension subclass:
252		*
253		* <code>
254		* public function updateDMSCartEditForm($form)
255		* {
256		* // Do something here
257		* }
258		* </code>
259		*
260		* @return Form
261		*/
262		public function DMSCartEditForm()
263		{
264		$actions = FieldList::create(
265		FormAction::create(
266		'updateCartItems',
267		_t(__CLASS__ . '.SAVE_BUTTON', 'Save changes')
268		)
269		);
270		$form = Form::create(
271		$this,
272		'DMSCartEditForm',
273		FieldList::create(),
274		$actions
275		);
276		$form->setTemplate('DMSDocumentRequestForm');
277		$this->extend('updateDMSCartEditForm', $form);
278		return $form;
279		}
280		}
281

silverstripe / silverstripe-dms-cart

Push — master ( 87a4b0...824833 )

DMSDocumentCartController::init() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like