diff --git a/app/code/Magento/Backend/Block/Dashboard/AbstractDashboard.php b/app/code/Magento/Backend/Block/Dashboard/AbstractDashboard.php index 254adc1df9c4a..cf2d991524454 100644 --- a/app/code/Magento/Backend/Block/Dashboard/AbstractDashboard.php +++ b/app/code/Magento/Backend/Block/Dashboard/AbstractDashboard.php @@ -10,8 +10,6 @@ /** * Adminhtml dashboard tab abstract - * - * @author Magento Core Team */ abstract class AbstractDashboard extends \Magento\Backend\Block\Widget { @@ -40,6 +38,8 @@ public function __construct( } /** + * Return a collection + * * @return array|AbstractCollection|\Magento\Eav\Model\Entity\Collection\Abstract */ public function getCollection() @@ -48,6 +48,8 @@ public function getCollection() } /** + * Return items count + * * @return int */ public function getCount() @@ -66,6 +68,8 @@ public function getDataHelper() } /** + * Prepare any data for display, if required + * * @return $this */ protected function _prepareData() @@ -74,6 +78,8 @@ protected function _prepareData() } /** + * Ensure data is prepared before layout + * * @return $this */ protected function _prepareLayout() diff --git a/app/code/Magento/Backend/Block/Dashboard/Bar.php b/app/code/Magento/Backend/Block/Dashboard/Bar.php index 87cefafd47930..a24d8e713d173 100644 --- a/app/code/Magento/Backend/Block/Dashboard/Bar.php +++ b/app/code/Magento/Backend/Block/Dashboard/Bar.php @@ -10,8 +10,6 @@ /** * Adminhtml dashboard bar block - * - * @author Magento Core Team */ class Bar extends \Magento\Backend\Block\Dashboard\AbstractDashboard { diff --git a/app/code/Magento/Backend/Block/Dashboard/Diagrams.php b/app/code/Magento/Backend/Block/Dashboard/Diagrams.php index 6f14c81e2d382..69a76f051a8af 100644 --- a/app/code/Magento/Backend/Block/Dashboard/Diagrams.php +++ b/app/code/Magento/Backend/Block/Dashboard/Diagrams.php @@ -9,8 +9,6 @@ * Adminhtml dashboard diagram tabs * @deprecated dashboard graphs were migrated to dynamic chart.js solution * @see dashboard.diagrams in adminhtml_dashboard_index.xml - * - * @author Magento Core Team */ class Diagrams extends \Magento\Backend\Block\Widget\Tabs { diff --git a/app/code/Magento/Backend/Block/Dashboard/Graph.php b/app/code/Magento/Backend/Block/Dashboard/Graph.php index ee3e5098bd160..3f5d3c80aff16 100644 --- a/app/code/Magento/Backend/Block/Dashboard/Graph.php +++ b/app/code/Magento/Backend/Block/Dashboard/Graph.php @@ -11,37 +11,27 @@ * Adminhtml dashboard google chart block * @deprecated dashboard graphs were migrated to dynamic chart.js solution * @see dashboard.chart.amounts and dashboard.chart.orders in adminhtml_dashboard_index.xml - * - * @author Magento Core Team */ class Graph extends \Magento\Backend\Block\Dashboard\AbstractDashboard { - const API_URL = 'https://image-charts.com/chart'; + public const API_URL = 'https://image-charts.com/chart'; /** - * All series - * * @var array */ protected $_allSeries = []; /** - * Axis labels - * * @var array */ protected $_axisLabels = []; /** - * Axis maps - * * @var array */ protected $_axisMaps = []; /** - * Data rows - * * @var array */ protected $_dataRows = []; @@ -78,6 +68,7 @@ class Graph extends \Magento\Backend\Block\Dashboard\AbstractDashboard * Google chart api data encoding * * @deprecated 101.0.2 since the Google Image Charts API not accessible from March 14, 2019 + * @see Nothing * @var string */ protected $_encoding = 'e'; diff --git a/app/code/Magento/Backend/Block/Dashboard/Grid.php b/app/code/Magento/Backend/Block/Dashboard/Grid.php index 6e8b17779cc5e..e81b942af7d0c 100644 --- a/app/code/Magento/Backend/Block/Dashboard/Grid.php +++ b/app/code/Magento/Backend/Block/Dashboard/Grid.php @@ -8,7 +8,6 @@ /** * Adminhtml dashboard grid * - * @author Magento Core Team * @api * @since 100.0.2 */ diff --git a/app/code/Magento/Backend/Block/Dashboard/Grids.php b/app/code/Magento/Backend/Block/Dashboard/Grids.php index aca496eb2c158..68319339392ce 100644 --- a/app/code/Magento/Backend/Block/Dashboard/Grids.php +++ b/app/code/Magento/Backend/Block/Dashboard/Grids.php @@ -14,7 +14,6 @@ * Adminhtml dashboard bottom tabs * * @api - * @author Magento Core Team * @since 100.0.2 */ class Grids extends Tabs diff --git a/app/code/Magento/Backend/Block/Dashboard/Sales.php b/app/code/Magento/Backend/Block/Dashboard/Sales.php index 68a92617e31da..d6d351b110ac0 100644 --- a/app/code/Magento/Backend/Block/Dashboard/Sales.php +++ b/app/code/Magento/Backend/Block/Dashboard/Sales.php @@ -15,7 +15,6 @@ * Adminhtml dashboard sales statistics bar * * @api - * @author Magento Core Team * @since 100.0.2 */ class Sales extends Bar diff --git a/app/code/Magento/Backend/Block/Dashboard/Tab/Amounts.php b/app/code/Magento/Backend/Block/Dashboard/Tab/Amounts.php index 87e03d4c71c45..336faf000e492 100644 --- a/app/code/Magento/Backend/Block/Dashboard/Tab/Amounts.php +++ b/app/code/Magento/Backend/Block/Dashboard/Tab/Amounts.php @@ -10,8 +10,6 @@ * Adminhtml dashboard order amounts diagram * @deprecated dashboard graphs were migrated to dynamic chart.js solution * @see dashboard.chart.amounts in adminhtml_dashboard_index.xml - * - * @author Magento Core Team */ class Amounts extends \Magento\Backend\Block\Dashboard\Graph { diff --git a/app/code/Magento/Backend/Block/Dashboard/Tab/Orders.php b/app/code/Magento/Backend/Block/Dashboard/Tab/Orders.php index 0cebb88abf27b..213ce02ec206c 100644 --- a/app/code/Magento/Backend/Block/Dashboard/Tab/Orders.php +++ b/app/code/Magento/Backend/Block/Dashboard/Tab/Orders.php @@ -10,8 +10,6 @@ * Adminhtml dashboard orders diagram * @deprecated dashboard graphs were migrated to dynamic chart.js solution * @see dashboard.chart.orders in adminhtml_dashboard_index.xml - * - * @author Magento Core Team */ class Orders extends \Magento\Backend\Block\Dashboard\Graph { diff --git a/app/code/Magento/Backend/Block/Dashboard/Tab/Products/Ordered.php b/app/code/Magento/Backend/Block/Dashboard/Tab/Products/Ordered.php index daefb0ff39c1b..59a61f65a55ff 100644 --- a/app/code/Magento/Backend/Block/Dashboard/Tab/Products/Ordered.php +++ b/app/code/Magento/Backend/Block/Dashboard/Tab/Products/Ordered.php @@ -8,7 +8,6 @@ /** * Adminhtml dashboard most ordered products grid * - * @author Magento Core Team * @SuppressWarnings(PHPMD.DepthOfInheritance) */ class Ordered extends \Magento\Backend\Block\Dashboard\Grid diff --git a/app/code/Magento/Backend/Block/Page.php b/app/code/Magento/Backend/Block/Page.php index 99cc913fcc93f..72f80e9f7982b 100644 --- a/app/code/Magento/Backend/Block/Page.php +++ b/app/code/Magento/Backend/Block/Page.php @@ -6,8 +6,6 @@ /** * Adminhtml page - * - * @author Magento Core Team */ namespace Magento\Backend\Block; @@ -62,6 +60,8 @@ public function getLang() } /** + * Returns true if we are running in single store mode + * * @return bool */ public function isSingleStoreMode() diff --git a/app/code/Magento/Backend/Block/Page/Footer.php b/app/code/Magento/Backend/Block/Page/Footer.php index da033bcf5a189..d477b357bf55b 100644 --- a/app/code/Magento/Backend/Block/Page/Footer.php +++ b/app/code/Magento/Backend/Block/Page/Footer.php @@ -9,7 +9,6 @@ * Adminhtml footer block * * @api - * @author Magento Core Team * @since 100.0.2 */ class Footer extends \Magento\Backend\Block\Template diff --git a/app/code/Magento/Backend/Block/Page/Header.php b/app/code/Magento/Backend/Block/Page/Header.php index d97e1fe126b54..a01b3ca8341d6 100644 --- a/app/code/Magento/Backend/Block/Page/Header.php +++ b/app/code/Magento/Backend/Block/Page/Header.php @@ -10,7 +10,6 @@ * Adminhtml header block * * @api - * @author Magento Core Team * @since 100.0.2 */ class Header extends \Magento\Backend\Block\Template @@ -21,8 +20,6 @@ class Header extends \Magento\Backend\Block\Template protected $_template = 'Magento_Backend::page/header.phtml'; /** - * Backend data - * * @var \Magento\Backend\Helper\Data */ protected $_backendData = null; @@ -50,6 +47,8 @@ public function __construct( } /** + * Return URL to homepage + * * @return string */ public function getHomeLink() @@ -58,6 +57,8 @@ public function getHomeLink() } /** + * Return the current user + * * @return \Magento\User\Model\User|null */ public function getUser() @@ -66,6 +67,8 @@ public function getUser() } /** + * Return URL to log out from admin + * * @return string */ public function getLogoutLink() diff --git a/app/code/Magento/Backend/Block/Page/Notices.php b/app/code/Magento/Backend/Block/Page/Notices.php index 750dbe67f4a75..c4f2d1de6ab9a 100644 --- a/app/code/Magento/Backend/Block/Page/Notices.php +++ b/app/code/Magento/Backend/Block/Page/Notices.php @@ -6,8 +6,6 @@ /** * Adminhtml header notices block - * - * @author Magento Core Team */ namespace Magento\Backend\Block\Page; diff --git a/app/code/Magento/Backend/Block/Page/System/Config/Robots/Reset.php b/app/code/Magento/Backend/Block/Page/System/Config/Robots/Reset.php index 20e2838481b36..388fe456365c6 100644 --- a/app/code/Magento/Backend/Block/Page/System/Config/Robots/Reset.php +++ b/app/code/Magento/Backend/Block/Page/System/Config/Robots/Reset.php @@ -12,25 +12,15 @@ * "Reset to Defaults" button renderer * * @deprecated 100.1.6 - * @author Magento Core Team + * @see Nothing */ class Reset extends \Magento\Config\Block\System\Config\Form\Field { /** - * Pasge robots default instructions + * Page robots default instructions */ - const XML_PATH_ROBOTS_DEFAULT_CUSTOM_INSTRUCTIONS = 'design/search_engine_robots/default_custom_instructions'; - - /** - * @param \Magento\Backend\Block\Template\Context $context - * @param array $data - */ - public function __construct( - \Magento\Backend\Block\Template\Context $context, - array $data = [] - ) { - parent::__construct($context, $data); - } + public const XML_PATH_ROBOTS_DEFAULT_CUSTOM_INSTRUCTIONS = + 'design/search_engine_robots/default_custom_instructions'; /** * Set template diff --git a/app/code/Magento/Backend/Block/System/Account/Edit.php b/app/code/Magento/Backend/Block/System/Account/Edit.php index 363c00716f8b0..7165efc131e38 100644 --- a/app/code/Magento/Backend/Block/System/Account/Edit.php +++ b/app/code/Magento/Backend/Block/System/Account/Edit.php @@ -9,12 +9,13 @@ * Adminhtml edit admin user account * * @api - * @author Magento Core Team * @since 100.0.2 */ class Edit extends \Magento\Backend\Block\Widget\Form\Container { /** + * Initialise the page + * * @return void */ protected function _construct() @@ -29,6 +30,8 @@ protected function _construct() } /** + * Return a Phrase for the header text + * * @return \Magento\Framework\Phrase */ public function getHeaderText() diff --git a/app/code/Magento/Backend/Block/System/Account/Edit/Form.php b/app/code/Magento/Backend/Block/System/Account/Edit/Form.php index 44d5b75597b0e..536ddd75ee724 100644 --- a/app/code/Magento/Backend/Block/System/Account/Edit/Form.php +++ b/app/code/Magento/Backend/Block/System/Account/Edit/Form.php @@ -10,7 +10,6 @@ /** * Adminhtml edit admin user account form - * */ class Form extends \Magento\Backend\Block\Widget\Form\Generic { diff --git a/app/code/Magento/Backend/Block/System/Cache/Edit.php b/app/code/Magento/Backend/Block/System/Cache/Edit.php index c31c39695bc79..527b9d64b90c8 100644 --- a/app/code/Magento/Backend/Block/System/Cache/Edit.php +++ b/app/code/Magento/Backend/Block/System/Cache/Edit.php @@ -7,8 +7,6 @@ /** * Cache management edit page - * - * @author Magento Core Team */ class Edit extends \Magento\Backend\Block\Widget { @@ -18,6 +16,8 @@ class Edit extends \Magento\Backend\Block\Widget protected $_template = 'Magento_Backend::system/cache/edit.phtml'; /** + * Set the page title + * * @return void */ protected function _construct() @@ -28,7 +28,7 @@ protected function _construct() } /** - * {@inheritdoc} + * @inheritDoc */ protected function _prepareLayout() { @@ -47,6 +47,8 @@ protected function _prepareLayout() } /** + * Return the HTML for the save button + * * @return string */ public function getSaveButtonHtml() @@ -55,6 +57,8 @@ public function getSaveButtonHtml() } /** + * Return the URL to save an item + * * @return string */ public function getSaveUrl() @@ -63,6 +67,8 @@ public function getSaveUrl() } /** + * Initialise the form + * * @return $this */ public function initForm() diff --git a/app/code/Magento/Backend/Block/System/Cache/Form.php b/app/code/Magento/Backend/Block/System/Cache/Form.php index ed15720538e50..9235fca7446f6 100644 --- a/app/code/Magento/Backend/Block/System/Cache/Form.php +++ b/app/code/Magento/Backend/Block/System/Cache/Form.php @@ -7,8 +7,6 @@ /** * Cache management form page - * - * @author Magento Core Team */ class Form extends \Magento\Backend\Block\Widget\Form\Generic { diff --git a/app/code/Magento/Backend/Block/System/Store/Delete.php b/app/code/Magento/Backend/Block/System/Store/Delete.php index f2bf55804d54d..2efec10544e4d 100644 --- a/app/code/Magento/Backend/Block/System/Store/Delete.php +++ b/app/code/Magento/Backend/Block/System/Store/Delete.php @@ -7,8 +7,6 @@ /** * Store / store view / website delete form container - * - * @author Magento Core Team */ class Delete extends \Magento\Backend\Block\Widget\Form\Container { diff --git a/app/code/Magento/Backend/Block/System/Store/Delete/Form.php b/app/code/Magento/Backend/Block/System/Store/Delete/Form.php index 4e88c14367b52..b4562ae9bc0d4 100644 --- a/app/code/Magento/Backend/Block/System/Store/Delete/Form.php +++ b/app/code/Magento/Backend/Block/System/Store/Delete/Form.php @@ -10,8 +10,6 @@ /** * Adminhtml cms block edit form - * - * @author Magento Core Team */ class Form extends \Magento\Backend\Block\Widget\Form\Generic { diff --git a/app/code/Magento/Backend/Block/System/Store/Delete/Group.php b/app/code/Magento/Backend/Block/System/Store/Delete/Group.php index 5933f1aec43f5..0f1844ff09881 100644 --- a/app/code/Magento/Backend/Block/System/Store/Delete/Group.php +++ b/app/code/Magento/Backend/Block/System/Store/Delete/Group.php @@ -7,13 +7,11 @@ /** * Adminhtml store delete group block - * - * @author Magento Core Team */ class Group extends \Magento\Backend\Block\Template { /** - * {@inheritdoc} + * @inheritDoc */ protected function _prepareLayout() { diff --git a/app/code/Magento/Backend/Block/System/Store/Delete/Website.php b/app/code/Magento/Backend/Block/System/Store/Delete/Website.php index e9f02b2315e3c..0c8c80aa5e821 100644 --- a/app/code/Magento/Backend/Block/System/Store/Delete/Website.php +++ b/app/code/Magento/Backend/Block/System/Store/Delete/Website.php @@ -7,13 +7,11 @@ /** * Adminhtml store delete group block - * - * @author Magento Core Team */ class Website extends \Magento\Backend\Block\Template { /** - * {@inheritdoc} + * @inheritDoc */ protected function _prepareLayout() { diff --git a/app/code/Magento/Backend/Block/System/Store/Edit/AbstractForm.php b/app/code/Magento/Backend/Block/System/Store/Edit/AbstractForm.php index e9f6bef88ccbb..45d30a6402087 100644 --- a/app/code/Magento/Backend/Block/System/Store/Edit/AbstractForm.php +++ b/app/code/Magento/Backend/Block/System/Store/Edit/AbstractForm.php @@ -8,8 +8,6 @@ /** * Adminhtml store edit form * - * @author Magento Core Team - * * @SuppressWarnings(PHPMD.DepthOfInheritance) */ abstract class AbstractForm extends \Magento\Backend\Block\Widget\Form\Generic diff --git a/app/code/Magento/Backend/Block/System/Store/Edit/Form/Group.php b/app/code/Magento/Backend/Block/System/Store/Edit/Form/Group.php index 5be3a155466b6..2a98cf9f90d76 100644 --- a/app/code/Magento/Backend/Block/System/Store/Edit/Form/Group.php +++ b/app/code/Magento/Backend/Block/System/Store/Edit/Form/Group.php @@ -8,8 +8,6 @@ /** * Adminhtml store edit form for group * - * @author Magento Core Team - * * @SuppressWarnings(PHPMD.DepthOfInheritance) */ class Group extends \Magento\Backend\Block\System\Store\Edit\AbstractForm diff --git a/app/code/Magento/Backend/Block/System/Store/Edit/Form/Store.php b/app/code/Magento/Backend/Block/System/Store/Edit/Form/Store.php index 9a6a82ae06264..3db1af1f43b92 100644 --- a/app/code/Magento/Backend/Block/System/Store/Edit/Form/Store.php +++ b/app/code/Magento/Backend/Block/System/Store/Edit/Form/Store.php @@ -11,8 +11,6 @@ /** * Adminhtml store edit form for store * - * @author Magento Core Team - * * @SuppressWarnings(PHPMD.DepthOfInheritance) */ class Store extends \Magento\Backend\Block\System\Store\Edit\AbstractForm diff --git a/app/code/Magento/Backend/Block/System/Store/Edit/Form/Website.php b/app/code/Magento/Backend/Block/System/Store/Edit/Form/Website.php index 42a1592accec2..b79efa1c6bba1 100644 --- a/app/code/Magento/Backend/Block/System/Store/Edit/Form/Website.php +++ b/app/code/Magento/Backend/Block/System/Store/Edit/Form/Website.php @@ -11,8 +11,6 @@ /** * Adminhtml store edit form for website * - * @author Magento Core Team - * * @SuppressWarnings(PHPMD.DepthOfInheritance) */ class Website extends \Magento\Backend\Block\System\Store\Edit\AbstractForm diff --git a/app/code/Magento/Backend/Block/System/Store/Grid/Render/Group.php b/app/code/Magento/Backend/Block/System/Store/Grid/Render/Group.php index a0972509eda5f..6f71ff512f993 100644 --- a/app/code/Magento/Backend/Block/System/Store/Grid/Render/Group.php +++ b/app/code/Magento/Backend/Block/System/Store/Grid/Render/Group.php @@ -9,8 +9,6 @@ /** * Store render group - * - * @author Magento Core Team */ class Group extends \Magento\Backend\Block\Widget\Grid\Column\Renderer\AbstractRenderer { diff --git a/app/code/Magento/Backend/Block/System/Store/Grid/Render/Store.php b/app/code/Magento/Backend/Block/System/Store/Grid/Render/Store.php index ae7c79817cf5a..74423f338dd3b 100644 --- a/app/code/Magento/Backend/Block/System/Store/Grid/Render/Store.php +++ b/app/code/Magento/Backend/Block/System/Store/Grid/Render/Store.php @@ -7,13 +7,11 @@ /** * Store render store - * - * @author Magento Core Team */ class Store extends \Magento\Backend\Block\Widget\Grid\Column\Renderer\AbstractRenderer { /** - * {@inheritdoc} + * @inheritDoc */ public function render(\Magento\Framework\DataObject $row) { diff --git a/app/code/Magento/Backend/Block/System/Store/Grid/Render/Website.php b/app/code/Magento/Backend/Block/System/Store/Grid/Render/Website.php index 223fe4c71dae7..0f2670638983e 100644 --- a/app/code/Magento/Backend/Block/System/Store/Grid/Render/Website.php +++ b/app/code/Magento/Backend/Block/System/Store/Grid/Render/Website.php @@ -7,13 +7,11 @@ /** * Store render website - * - * @author Magento Core Team */ class Website extends \Magento\Backend\Block\Widget\Grid\Column\Renderer\AbstractRenderer { /** - * {@inheritdoc} + * @inheritDoc */ public function render(\Magento\Framework\DataObject $row) { diff --git a/app/code/Magento/Backend/Block/System/Store/Store.php b/app/code/Magento/Backend/Block/System/Store/Store.php index b8b1a651757df..55d5cf8fdc00e 100644 --- a/app/code/Magento/Backend/Block/System/Store/Store.php +++ b/app/code/Magento/Backend/Block/System/Store/Store.php @@ -9,7 +9,6 @@ * Adminhtml store content block * * @api - * @author Magento Core Team * @since 100.0.2 */ class Store extends \Magento\Backend\Block\Widget\Grid\Container diff --git a/app/code/Magento/Backend/Block/Text/ListText.php b/app/code/Magento/Backend/Block/Text/ListText.php index f1217e0302f56..0273984e5d3f1 100644 --- a/app/code/Magento/Backend/Block/Text/ListText.php +++ b/app/code/Magento/Backend/Block/Text/ListText.php @@ -6,8 +6,6 @@ /** * Adminhtml text list block - * - * @author Magento Core Team */ namespace Magento\Backend\Block\Text; diff --git a/app/code/Magento/Backend/Block/Widget/Accordion/Item.php b/app/code/Magento/Backend/Block/Widget/Accordion/Item.php index 3b54a0982ce30..b8b5f208b602c 100644 --- a/app/code/Magento/Backend/Block/Widget/Accordion/Item.php +++ b/app/code/Magento/Backend/Block/Widget/Accordion/Item.php @@ -9,8 +9,6 @@ /** * Accordion item - * - * @author Magento Core Team */ class Item extends \Magento\Backend\Block\Widget { @@ -20,6 +18,8 @@ class Item extends \Magento\Backend\Block\Widget protected $_accordion; /** + * Set accordion objet and return self + * * @param Accordion $accordion * @return $this */ @@ -30,6 +30,8 @@ public function setAccordion($accordion) } /** + * Return the target for this item + * * @return string */ public function getTarget() @@ -38,6 +40,8 @@ public function getTarget() } /** + * Return the HTML title for this item + * * @return string */ public function getTitle() @@ -52,6 +56,8 @@ public function getTitle() } /** + * Return the HTML content for this item + * * @return null|string */ public function getContent() @@ -67,6 +73,8 @@ public function getContent() } /** + * Get the CSS class for this item + * * @return string */ public function getClass() @@ -79,6 +87,8 @@ public function getClass() } /** + * Return formatted HTML + * * @return string */ protected function _toHtml() diff --git a/app/code/Magento/Backend/Block/Widget/Breadcrumbs.php b/app/code/Magento/Backend/Block/Widget/Breadcrumbs.php index 7908abc14a7aa..13ad12ceb3b0d 100644 --- a/app/code/Magento/Backend/Block/Widget/Breadcrumbs.php +++ b/app/code/Magento/Backend/Block/Widget/Breadcrumbs.php @@ -9,7 +9,6 @@ * Magento_Backend page breadcrumbs * * @api - * @author Magento Core Team * @since 100.0.2 */ class Breadcrumbs extends \Magento\Backend\Block\Template @@ -27,6 +26,8 @@ class Breadcrumbs extends \Magento\Backend\Block\Template protected $_template = 'Magento_Backend::widget/breadcrumbs.phtml'; /** + * Add homepage to breadcrumbs + * * @return void */ protected function _construct() @@ -35,6 +36,8 @@ protected function _construct() } /** + * Add a link to the breadcrumbs + * * @param string $label * @param string|null $title * @param string|null $url @@ -48,14 +51,4 @@ public function addLink($label, $title = null, $url = null) $this->_links[] = ['label' => $label, 'title' => $title, 'url' => $url]; return $this; } - - /** - * {@inheritdoc} - */ - protected function _beforeToHtml() - { - // TODO - Moved to Beta 2, no breadcrumbs displaying in Beta 1 - // $this->assign('links', $this->_links); - return parent::_beforeToHtml(); - } } diff --git a/app/code/Magento/Backend/Block/Widget/Button.php b/app/code/Magento/Backend/Block/Widget/Button.php index fa02639f420f6..51536eb51fe6b 100644 --- a/app/code/Magento/Backend/Block/Widget/Button.php +++ b/app/code/Magento/Backend/Block/Widget/Button.php @@ -14,7 +14,6 @@ * Button widget * * @api - * @author Magento Core Team * @since 100.0.2 */ class Button extends \Magento\Backend\Block\Widget diff --git a/app/code/Magento/Backend/Block/Widget/Form/Element.php b/app/code/Magento/Backend/Block/Widget/Form/Element.php index b49bd06dcbfc9..16fa761aef4a2 100644 --- a/app/code/Magento/Backend/Block/Widget/Form/Element.php +++ b/app/code/Magento/Backend/Block/Widget/Form/Element.php @@ -9,8 +9,6 @@ /** * Form element widget block - * - * @author Magento Core Team */ class Element extends \Magento\Backend\Block\Template { @@ -35,6 +33,8 @@ class Element extends \Magento\Backend\Block\Template protected $_template = 'Magento_Backend::widget/form/element.phtml'; /** + * Set element and return self + * * @param string $element * @return $this */ @@ -45,6 +45,8 @@ public function setElement($element) } /** + * Set form and return self + * * @param Form $form * @return $this */ @@ -55,6 +57,8 @@ public function setForm($form) } /** + * Set form block and return self + * * @param \Magento\Framework\DataObject $formBlock * @return $this */ @@ -65,7 +69,7 @@ public function setFormBlock($formBlock) } /** - * {@inheritdoc} + * @inheritDoc */ protected function _beforeToHtml() { diff --git a/app/code/Magento/Backend/Block/Widget/Form/Element/Gallery.php b/app/code/Magento/Backend/Block/Widget/Form/Element/Gallery.php index f49d65bcb50e6..8eb32c56a936f 100644 --- a/app/code/Magento/Backend/Block/Widget/Form/Element/Gallery.php +++ b/app/code/Magento/Backend/Block/Widget/Form/Element/Gallery.php @@ -13,8 +13,6 @@ /** * Backend image gallery item renderer - * - * @author Magento Core Team */ class Gallery extends \Magento\Backend\Block\Template implements \Magento\Framework\Data\Form\Element\Renderer\RendererInterface diff --git a/app/code/Magento/Backend/Block/Widget/Form/Renderer/Fieldset.php b/app/code/Magento/Backend/Block/Widget/Form/Renderer/Fieldset.php index df66fa8f64b3a..efc7a33eae3ec 100644 --- a/app/code/Magento/Backend/Block/Widget/Form/Renderer/Fieldset.php +++ b/app/code/Magento/Backend/Block/Widget/Form/Renderer/Fieldset.php @@ -13,7 +13,6 @@ * Form fieldset default renderer * * @api - * @author Magento Core Team * @since 100.0.2 */ class Fieldset extends \Magento\Backend\Block\Template implements RendererInterface diff --git a/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Checkbox.php b/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Checkbox.php index 34d80f51ce1a3..4045fea5aa8ab 100644 --- a/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Checkbox.php +++ b/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Checkbox.php @@ -7,12 +7,12 @@ /** * Checkbox grid column filter - * - * @author Magento Core Team */ class Checkbox extends \Magento\Backend\Block\Widget\Grid\Column\Filter\Select { /** + * Return formatted HTML + * * @return string */ public function getHtml() @@ -21,6 +21,8 @@ public function getHtml() } /** + * Return an array of options + * * @return array */ protected function _getOptions() @@ -33,6 +35,8 @@ protected function _getOptions() } /** + * Return expression for SQL 'where' clause + * * @return array */ public function getCondition() @@ -42,6 +46,5 @@ public function getCondition() } else { return [['neq' => $this->getColumn()->getValue()], ['is' => new \Zend_Db_Expr('NULL')]]; } - // return array('like'=>'%'.$this->getValue().'%'); } } diff --git a/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Datetime.php b/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Datetime.php index 4e5ad773c1349..04c5739e0e8bf 100644 --- a/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Datetime.php +++ b/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Datetime.php @@ -9,7 +9,6 @@ /** * Date grid column filter * - * @author Magento Core Team * @todo date format */ class Datetime extends \Magento\Backend\Block\Widget\Grid\Column\Filter\Date diff --git a/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Massaction.php b/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Massaction.php index d2241135b9be0..46cb8f39ac1be 100644 --- a/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Massaction.php +++ b/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Massaction.php @@ -7,13 +7,11 @@ /** * Massaction grid column filter - * - * @author Magento Core Team */ class Massaction extends \Magento\Backend\Block\Widget\Grid\Column\Filter\Checkbox { /** - * {@inheritdoc} + * @inheritDoc */ public function getCondition() { diff --git a/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Price.php b/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Price.php index ab1e4382212a1..73d52f35908cb 100644 --- a/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Price.php +++ b/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Price.php @@ -8,8 +8,6 @@ /** * Range grid column filter * - * @author Magento Core Team - * * @SuppressWarnings(PHPMD.CouplingBetweenObjects) */ class Price extends \Magento\Backend\Block\Widget\Grid\Column\Filter\AbstractFilter diff --git a/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Radio.php b/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Radio.php index 8ac46b505a5ab..0df72d1708ea1 100644 --- a/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Radio.php +++ b/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Radio.php @@ -7,12 +7,12 @@ /** * Checkbox grid column filter - * - * @author Magento Core Team */ class Radio extends \Magento\Backend\Block\Widget\Grid\Column\Filter\Select { /** + * Return array of options + * * @return array */ protected function _getOptions() @@ -25,7 +25,7 @@ protected function _getOptions() } /** - * {@inheritdoc} + * @inheritDoc */ public function getCondition() { diff --git a/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Range.php b/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Range.php index 64aebb5ae7977..f21303b875c29 100644 --- a/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Range.php +++ b/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Range.php @@ -6,8 +6,6 @@ /** * Range grid column filter - * - * @author Magento Core Team */ namespace Magento\Backend\Block\Widget\Grid\Column\Filter; @@ -18,6 +16,8 @@ class Range extends \Magento\Backend\Block\Widget\Grid\Column\Filter\AbstractFilter { /** + * Return formatted HTML + * * @return string */ public function getHtml() @@ -56,6 +56,8 @@ public function getHtml() } /** + * Return the value at the specified index + * * @param string|null $index * @return mixed */ @@ -72,7 +74,7 @@ public function getValue($index = null) } /** - * {@inheritdoc} + * @inheritDoc */ public function getCondition() { diff --git a/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/SkipList.php b/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/SkipList.php index 2920c89e4815f..9d338535fd57e 100644 --- a/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/SkipList.php +++ b/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/SkipList.php @@ -7,13 +7,11 @@ /** * Massaction grid column filter - * - * @author Magento Core Team */ class SkipList extends \Magento\Backend\Block\Widget\Grid\Column\Filter\AbstractFilter { /** - * {@inheritdoc} + * @inheritDoc */ public function getCondition() { diff --git a/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Text.php b/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Text.php index ef33f3be3a98f..22108253340b2 100644 --- a/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Text.php +++ b/app/code/Magento/Backend/Block/Widget/Grid/Column/Filter/Text.php @@ -8,14 +8,13 @@ /** * Text grid column filter * - * @author Magento Core Team * @api * @since 100.0.2 */ class Text extends \Magento\Backend\Block\Widget\Grid\Column\Filter\AbstractFilter { /** - * {@inheritdoc} + * @inheritDoc */ public function getHtml() { diff --git a/app/code/Magento/Backend/Block/Widget/Grid/Massaction/Extended.php b/app/code/Magento/Backend/Block/Widget/Grid/Massaction/Extended.php index ed92b2e375d72..4be11ed3d5bc1 100644 --- a/app/code/Magento/Backend/Block/Widget/Grid/Massaction/Extended.php +++ b/app/code/Magento/Backend/Block/Widget/Grid/Massaction/Extended.php @@ -13,9 +13,9 @@ * * @api * @deprecated 100.2.0 in favour of UI component implementation + * @see Nothing * @method \Magento\Quote\Model\Quote setHideFormElement(boolean $value) Hide Form element to prevent IE errors * @method boolean getHideFormElement() - * @author Magento Core Team * @TODO MAGETWO-31510: Remove deprecated class * @since 100.0.2 */ @@ -36,8 +36,6 @@ class Extended extends \Magento\Backend\Block\Widget protected $_template = 'Magento_Backend::widget/grid/massaction_extended.phtml'; /** - * Backend data - * * @var \Magento\Backend\Helper\Data */ protected $_backendData = null; diff --git a/app/code/Magento/Backend/Block/Widget/Grid/Massaction/Item/Additional/AdditionalInterface.php b/app/code/Magento/Backend/Block/Widget/Grid/Massaction/Item/Additional/AdditionalInterface.php index c55cf786b7364..3adab1a4e5f6e 100644 --- a/app/code/Magento/Backend/Block/Widget/Grid/Massaction/Item/Additional/AdditionalInterface.php +++ b/app/code/Magento/Backend/Block/Widget/Grid/Massaction/Item/Additional/AdditionalInterface.php @@ -8,7 +8,6 @@ /** * Backend grid widget massaction item additional action interface * - * @author Magento Core Team * @api */ interface AdditionalInterface diff --git a/app/code/Magento/Backend/Block/Widget/Grid/Massaction/Item/Additional/DefaultAdditional.php b/app/code/Magento/Backend/Block/Widget/Grid/Massaction/Item/Additional/DefaultAdditional.php index bcd6a3ebfacb8..114740e68252b 100644 --- a/app/code/Magento/Backend/Block/Widget/Grid/Massaction/Item/Additional/DefaultAdditional.php +++ b/app/code/Magento/Backend/Block/Widget/Grid/Massaction/Item/Additional/DefaultAdditional.php @@ -7,14 +7,12 @@ /** * Backend grid widget massaction item additional action default - * - * @author Magento Core Team */ class DefaultAdditional extends \Magento\Backend\Block\Widget\Form\Generic implements \Magento\Backend\Block\Widget\Grid\Massaction\Item\Additional\AdditionalInterface { /** - * {@inheritdoc} + * @inheritDoc */ public function createFromConfiguration(array $configuration) { diff --git a/app/code/Magento/Backend/Controller/Adminhtml/Dashboard.php b/app/code/Magento/Backend/Controller/Adminhtml/Dashboard.php index be6db8593f9be..35d6e468aff80 100644 --- a/app/code/Magento/Backend/Controller/Adminhtml/Dashboard.php +++ b/app/code/Magento/Backend/Controller/Adminhtml/Dashboard.php @@ -6,8 +6,6 @@ /** * Dashboard admin controller - * - * @author Magento Core Team */ namespace Magento\Backend\Controller\Adminhtml; @@ -18,5 +16,5 @@ abstract class Dashboard extends \Magento\Backend\App\Action * * @see _isAllowed() */ - const ADMIN_RESOURCE = 'Magento_Backend::dashboard'; + public const ADMIN_RESOURCE = 'Magento_Backend::dashboard'; } diff --git a/app/code/Magento/Backend/Controller/Adminhtml/System.php b/app/code/Magento/Backend/Controller/Adminhtml/System.php index a3ba99cee1214..d06a65346d15d 100644 --- a/app/code/Magento/Backend/Controller/Adminhtml/System.php +++ b/app/code/Magento/Backend/Controller/Adminhtml/System.php @@ -9,8 +9,6 @@ /** * System admin controller - * - * @author Magento Core Team */ abstract class System extends AbstractAction { @@ -19,5 +17,5 @@ abstract class System extends AbstractAction * * @see _isAllowed() */ - const ADMIN_RESOURCE = 'Magento_Backend::system'; + public const ADMIN_RESOURCE = 'Magento_Backend::system'; } diff --git a/app/code/Magento/Backend/Controller/Adminhtml/System/Account.php b/app/code/Magento/Backend/Controller/Adminhtml/System/Account.php index a2a6ef8004966..256bea5341ac3 100644 --- a/app/code/Magento/Backend/Controller/Adminhtml/System/Account.php +++ b/app/code/Magento/Backend/Controller/Adminhtml/System/Account.php @@ -9,8 +9,6 @@ /** * Adminhtml account controller - * - * @author Magento Core Team */ abstract class Account extends Action { @@ -19,5 +17,5 @@ abstract class Account extends Action * * @see _isAllowed() */ - const ADMIN_RESOURCE = 'Magento_Backend::myaccount'; + public const ADMIN_RESOURCE = 'Magento_Backend::myaccount'; } diff --git a/app/code/Magento/Backend/Controller/Adminhtml/System/Store.php b/app/code/Magento/Backend/Controller/Adminhtml/System/Store.php index 9c16a482890d4..1642bb7074a64 100644 --- a/app/code/Magento/Backend/Controller/Adminhtml/System/Store.php +++ b/app/code/Magento/Backend/Controller/Adminhtml/System/Store.php @@ -13,7 +13,6 @@ /** * Store controller * - * @author Magento Core Team * @SuppressWarnings(PHPMD.AllPurposeAction) */ abstract class Store extends Action @@ -23,11 +22,9 @@ abstract class Store extends Action * * @see _isAllowed() */ - const ADMIN_RESOURCE = 'Magento_Backend::store'; + public const ADMIN_RESOURCE = 'Magento_Backend::store'; /** - * Core registry - * * @var \Magento\Framework\Registry */ protected $_coreRegistry; @@ -89,6 +86,7 @@ protected function createPage() * @return bool * * @deprecated 100.2.7 Backup module is to be removed. + * @see Nothing */ protected function _backupDatabase() { diff --git a/app/code/Magento/Backend/Helper/Js.php b/app/code/Magento/Backend/Helper/Js.php index 678cb337937d1..e32a4fde20582 100644 --- a/app/code/Magento/Backend/Helper/Js.php +++ b/app/code/Magento/Backend/Helper/Js.php @@ -6,8 +6,6 @@ /** * Adminhtml JavaScript helper - * - * @author Magento Core Team */ namespace Magento\Backend\Helper; @@ -39,6 +37,7 @@ public function decodeGridSerializedInput($encoded) { $isSimplified = false === strpos($encoded, '='); $result = []; + // phpcs:ignore Magento2.Functions.DiscouragedFunction.Discouraged parse_str($encoded, $decoded); foreach ($decoded as $key => $value) { if (is_numeric($key)) { @@ -46,6 +45,7 @@ public function decodeGridSerializedInput($encoded) $result[] = $key; } else { $result[$key] = null; + // phpcs:ignore Magento2.Functions.DiscouragedFunction.Discouraged parse_str(base64_decode($value), $result[$key]); } } diff --git a/app/code/Magento/Backend/Model/Auth/Credential/StorageInterface.php b/app/code/Magento/Backend/Model/Auth/Credential/StorageInterface.php index bbda31a06bfb6..e60de02521e86 100644 --- a/app/code/Magento/Backend/Model/Auth/Credential/StorageInterface.php +++ b/app/code/Magento/Backend/Model/Auth/Credential/StorageInterface.php @@ -8,7 +8,6 @@ /** * Backend Auth Credential Storage interface * - * @author Magento Core Team * @api * @since 100.0.2 */ diff --git a/app/code/Magento/Backend/Model/Locale/Manager.php b/app/code/Magento/Backend/Model/Locale/Manager.php index f680f499590ae..5d36eb9ec4f1f 100644 --- a/app/code/Magento/Backend/Model/Locale/Manager.php +++ b/app/code/Magento/Backend/Model/Locale/Manager.php @@ -8,8 +8,8 @@ /** * Locale manager model * - * @author Magento Core Team * @api + * @SuppressWarnings(PHPMD.CookieAndSessionMisuse) * @since 100.0.2 */ class Manager diff --git a/app/code/Magento/Backend/Model/Search/Order.php b/app/code/Magento/Backend/Model/Search/Order.php index 8b9b7f49fac65..6f20276908449 100644 --- a/app/code/Magento/Backend/Model/Search/Order.php +++ b/app/code/Magento/Backend/Model/Search/Order.php @@ -8,15 +8,12 @@ /** * Search Order Model * - * @author Magento Core Team * @api * @since 100.0.2 */ class Order extends \Magento\Framework\DataObject { /** - * Adminhtml data - * * @var \Magento\Backend\Helper\Data */ protected $_adminhtmlData = null;