PHPMD: suppressed warning for unused parameters

app/code/core/Mage/Admin/Model/Acl/Assert/Ip.php

@@ -36,6 +36,8 @@ class Mage_Admin_Model_Acl_Assert_Ip implements Zend_Acl_Assert_Interface
      * @param Mage_Admin_Model_Acl_Resource|null $resource
      * @param string|null $privilege
      * @return bool|null
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     public function assert(
         Mage_Admin_Model_Acl $acl,
@@ -48,6 +50,8 @@ public function assert(
 
     /**
      * @param string|false $ip
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     protected function _isCleanIP($ip)
     {

app/code/core/Mage/Admin/Model/Acl/Assert/Time.php

@@ -36,6 +36,8 @@ class Mage_Admin_Model_Acl_Assert_Time implements Zend_Acl_Assert_Interface
      * @param Mage_Admin_Model_Acl_Resource|null $resource
      * @param string|null $privilege
      * @return bool|null
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     public function assert(
         Mage_Admin_Model_Acl $acl,
@@ -48,6 +50,8 @@ public function assert(
 
     /**
      * @param int $time
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     protected function _isCleanTime($time)
     {

app/code/core/Mage/Admin/Model/Observer.php

@@ -34,6 +34,8 @@ class Mage_Admin_Model_Observer
      * Handler for controller_action_predispatch event
      *
      * @param Varien_Event_Observer $observer
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     public function actionPreDispatchAdmin($observer)
     {
@@ -112,6 +114,8 @@ public function actionPreDispatchAdmin($observer)
      *
      * @deprecated after 1.4.0.1, logic moved to admin session
      * @param Varien_Event_Observer $event
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     public function actionPostDispatchAdmin($event)
     {

app/code/core/Mage/AdminNotification/Helper/Data.php

@@ -77,6 +77,8 @@ public function getUnreadNoticeCount($severity)
      * @param bool $withExt
      * @return string
      * @deprecated v19.4.16
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     public function getPopupObjectUrl($withExt = false)
     {

app/code/core/Mage/AdminNotification/Model/Observer.php

@@ -32,6 +32,8 @@ class Mage_AdminNotification_Model_Observer
      * Predispath admin action controller
      *
      * @param Varien_Event_Observer $observer
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     public function preDispatch(Varien_Event_Observer $observer)
     {

app/code/core/Mage/AdminNotification/Model/Resource/Inbox.php

@@ -68,6 +68,8 @@ public function loadLatestNotice(Mage_AdminNotification_Model_Inbox $object)
      *
      * @param Mage_AdminNotification_Model_Inbox $object
      * @return array
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     public function getNoticeStatus(Mage_AdminNotification_Model_Inbox $object)
     {
@@ -87,6 +89,8 @@ public function getNoticeStatus(Mage_AdminNotification_Model_Inbox $object)
      *
      * @param Mage_AdminNotification_Model_Inbox $object
      * @param array $data
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     public function parse(Mage_AdminNotification_Model_Inbox $object, array $data)
     {

app/code/core/Mage/Adminhtml/Block/Cache/Grid.php

@@ -110,6 +110,8 @@ protected function _prepareColumns()
      * Decorate status column values
      *
      * @return string
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     public function decorateStatus($value, $row, $column, $isExport)
     {

app/code/core/Mage/Adminhtml/Block/Catalog/Product/Composite/Fieldset/Grouped.php

@@ -110,6 +110,8 @@ public function setPreconfiguredValue()
      *
      * @param Mage_Catalog_Model_Product $product
      * @return bool
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     public function getCanShowProductPrice($product)
     {

app/code/core/Mage/Adminhtml/Block/Catalog/Product/Frontend/Product/Watermark.php

@@ -30,6 +30,10 @@ class Mage_Adminhtml_Block_Catalog_Product_Frontend_Product_Watermark extends Ma
 {
     public const XML_PATH_IMAGE_TYPES = 'global/catalog/product/media/image_types';
 
+    /**
+     * @param Varien_Data_Form_Element_Abstract $element
+     * @return string
+     */
     public function render(Varien_Data_Form_Element_Abstract $element)
     {
         $html = $this->_getHeaderHtml($element);
@@ -75,6 +79,11 @@ public function render(Varien_Data_Form_Element_Abstract $element)
         return $html;
     }
 
+    /**
+     * @param Varien_Data_Form_Element_Abstract $element
+     * @return string
+     * @throws Exception
+     */
     protected function _getHeaderHtml($element)
     {
         $id = $element->getHtmlId();
@@ -94,6 +103,12 @@ protected function _getHeaderHtml($element)
         return $html;
     }
 
+    /**
+     * @param Varien_Data_Form_Element_Abstract $element
+     * @return string
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
+     */
     protected function _getFooterHtml($element)
     {
         return '</tbody></table></fieldset>';

app/code/core/Mage/Adminhtml/Block/Catalog/Product/Helper/Form/Price.php

@@ -82,6 +82,8 @@ protected function _getTaxObservingCode($attribute)
     /**
      * @param null $index deprecated
      * @return string|null
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     public function getEscapedValue($index = null)
     {

app/code/core/Mage/Adminhtml/Block/Report/Grid/Abstract.php

@@ -312,6 +312,8 @@ protected function _addOrderStatusFilter($collection, $filterData)
      * @param Mage_Reports_Model_Resource_Report_Collection_Abstract $collection
      * @param Varien_Object $filterData
      * @return $this
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     protected function _addCustomFilter($collection, $filterData)
     {

app/code/core/Mage/Adminhtml/Block/Review/Rating/Detailed.php

@@ -29,6 +29,7 @@
 class Mage_Adminhtml_Block_Review_Rating_Detailed extends Mage_Adminhtml_Block_Template
 {
     protected $_voteCollection = false;
+
     public function __construct()
     {
         parent::__construct();
@@ -38,6 +39,10 @@ public function __construct()
         }
     }
 
+    /**
+     * @return Mage_Rating_Model_Resource_Rating_Collection
+     * @throws Mage_Core_Exception
+     */
     public function getRating()
     {
         if (!$this->getRatingCollection()) {
@@ -94,12 +99,19 @@ public function getRating()
         return $this->getRatingCollection();
     }
 
+    /**
+     * @return $this
+     */
     public function setIndependentMode()
     {
         $this->setIsIndependentMode(true);
         return $this;
     }
 
+    /**
+     * @return bool
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
+     */
     public function isSelected($option, $rating)
     {
         if ($this->getIsIndependentMode()) {

app/code/core/Mage/Adminhtml/Block/Sales/Order/Create/Form/Abstract.php

@@ -39,7 +39,7 @@ abstract class Mage_Adminhtml_Block_Sales_Order_Create_Form_Abstract extends Mag
      * Prepare global layout
      * Add renderers to Varien_Data_Form
      *
-     * @return Mage_Adminhtml_Block_Sales_Order_Create_Form_Abstract
+     * @return $this
      */
     protected function _prepareLayout()
     {
@@ -76,7 +76,7 @@ public function getForm()
     /**
      * Prepare Form and add elements to form
      *
-     * @return Mage_Adminhtml_Block_Sales_Order_Create_Form_Abstract
+     * @return $this
      */
     abstract protected function _prepareForm();
 
@@ -110,7 +110,9 @@ protected function _getAdditionalFormElementRenderers()
      * Add additional data to form element
      *
      * @param Varien_Data_Form_Element_Abstract $element
-     * @return Mage_Adminhtml_Block_Sales_Order_Create_Form_Abstract
+     * @return $this
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     protected function _addAdditionalFormElementData(Varien_Data_Form_Element_Abstract $element)
     {
@@ -122,7 +124,7 @@ protected function _addAdditionalFormElementData(Varien_Data_Form_Element_Abstra
      *
      * @param array|Varien_Data_Collection $attributes
      * @param Varien_Data_Form_Abstract $form
-     * @return Mage_Adminhtml_Block_Sales_Order_Create_Form_Abstract
+     * @return $this
      */
     protected function _addAttributesToForm($attributes, Varien_Data_Form_Abstract $form)
     {

app/code/core/Mage/Adminhtml/Block/Sales/Order/Status/Grid.php

@@ -38,6 +38,10 @@ public function __construct()
         $this->setDefaultDir('DESC');
     }
 
+    /**
+     * @return $this
+     * @throws Exception
+     */
     protected function _prepareCollection()
     {
         $collection = Mage::getResourceModel('sales/order_status_collection');
@@ -47,6 +51,9 @@ protected function _prepareCollection()
         return $this;
     }
 
+    /**
+     * @inheritDoc
+     */
     protected function _prepareColumns()
     {
         $this->addColumn('label', [
@@ -96,6 +103,8 @@ protected function _prepareColumns()
      * Decorate status column values
      *
      * @return string
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     public function decorateState($value, $row, $column, $isExport)
     {
@@ -107,6 +116,9 @@ public function decorateState($value, $row, $column, $isExport)
         return $cell;
     }
 
+    /**
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
+     */
     public function decorateAction($value, $row, $column, $isExport)
     {
         $cell = '';

app/code/core/Mage/Adminhtml/Block/System/Config/Form/Field/Array/Abstract.php

@@ -116,6 +116,8 @@ protected function _getElementHtml(Varien_Data_Form_Element_Abstract $element)
      * Prepare existing row data object
      *
      * @param Varien_Object $row
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     protected function _prepareArrayRow(Varien_Object $row)
     {

app/code/core/Mage/Adminhtml/Block/System/Config/Form/Fieldset.php

@@ -178,6 +178,8 @@ protected function _getFooterHtml($element)
      * @param Varien_Data_Form_Element_Abstract $element
      * @param bool $tooltipsExist Init tooltips observer or not
      * @return string
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     protected function _getExtraJs($element, $tooltipsExist = false)
     {

app/code/core/Mage/Adminhtml/Block/Widget/Form.php

@@ -247,6 +247,8 @@ protected function _getAdditionalElementTypes()
     /**
      * @param Varien_Data_Form_Element_Abstract $element
      * @return string
+     *
+     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
      */
     protected function _getAdditionalElementHtml($element)
     {