OpenMage · kiatng · Nov 4, 2024 · Nov 2, 2024
diff --git a/.phpstan.dist.baseline.neon b/.phpstan.dist.baseline.neon
diff --git a/app/code/core/Mage/Adminhtml/Block/Sales/Order/Creditmemo/Create/Adjustments.php b/app/code/core/Mage/Adminhtml/Block/Sales/Order/Creditmemo/Create/Adjustments.php
@@ -19,7 +19,11 @@
  */
 class Mage_Adminhtml_Block_Sales_Order_Creditmemo_Create_Adjustments extends Mage_Adminhtml_Block_Template
 {
+    /**
+     * @var Mage_Sales_Model_Order_Creditmemo
+     */
     protected $_source;
+
     /**
      * Initialize creditmemo adjustment totals
      *
@@ -40,6 +44,9 @@ public function initTotals()
         return $this;
     }
 
+    /**
+     * @return Mage_Sales_Model_Order_Creditmemo
+     */
     public function getSource()
     {
         return $this->_source;

diff --git a/app/code/core/Mage/Adminhtml/Block/System/Convert/Gui/Edit/Tab/Wizard.php b/app/code/core/Mage/Adminhtml/Block/System/Convert/Gui/Edit/Tab/Wizard.php
@@ -97,8 +97,10 @@ public function getValue($key, $default = '', $defaultNew = null)
 
     /**
      * @param string $key
-     * @param string $value
+     * @param string|bool|int $value
      * @return string
+     *
+     * @todo check remove int from param value
      */
     public function getSelected($key, $value)
     {

diff --git a/app/code/core/Mage/Wishlist/Block/Abstract.php b/app/code/core/Mage/Wishlist/Block/Abstract.php
@@ -213,7 +213,7 @@ public function getItemConfigureUrl($product)
     /**
      * Retrieve Escaped Description for Wishlist Item
      *
-     * @param Mage_Catalog_Model_Product $item
+     * @param Mage_Wishlist_Model_Item $item
      * @return string
      */
     public function getEscapedDescription($item)

diff --git a/app/design/adminhtml/default/default/template/api2/attribute/buttons.phtml b/app/design/adminhtml/default/default/template/api2/attribute/buttons.phtml
@@ -12,8 +12,8 @@
  * @copyright   Copyright (c) 2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
-/** @var $this Mage_Api2_Block_Adminhtml_Attribute_Buttons */
 
+/** @var Mage_Api2_Block_Adminhtml_Attribute_Buttons $this */
 ?>
 <div class="content-header">
     <table cellspacing="0">

diff --git a/app/design/adminhtml/default/default/template/api2/role/users_grid_js.phtml b/app/design/adminhtml/default/default/template/api2/role/users_grid_js.phtml
@@ -12,12 +12,12 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
-
 ?>
+
 <script type="text/javascript">
 //<![CDATA[
 <?php
-    /** @var $myBlock Mage_Api2_Block_Adminhtml_Roles_Tab_Users */
+    /** @var Mage_Api2_Block_Adminhtml_Roles_Tab_Users $myBlock */
     $myBlock = $this->getLayout()->getBlock('adminhtml.role.edit.tab.users');
     $name = $myBlock->getJsObjectName();
 ?>

diff --git a/app/design/adminhtml/default/default/template/catalog/category/edit/form.phtml b/app/design/adminhtml/default/default/template/catalog/category/edit/form.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2021-2024 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Adminhtml_Block_Catalog_Category_Edit_Form $this */
 ?>
 
 <div class="content-header">

diff --git a/app/design/adminhtml/default/default/template/catalog/product/edit.phtml b/app/design/adminhtml/default/default/template/catalog/product/edit.phtml
@@ -12,15 +12,13 @@
  * @copyright   Copyright (c) 2021-2023 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
-?>
-<?php
+
 /**
  * Template for Mage_Adminhtml_Block_Catalog_Product_Edit
  *
  * @var Mage_Adminhtml_Block_Catalog_Product_Edit $this
  */
 ?>
-
 <div class="content-header">
     <h3 class="icon-head head-products"><?php echo $this->getHeader() ?></h3>
     <p class="content-buttons form-buttons"><?php echo $this->getBackButtonHtml() ?>

diff --git a/app/design/adminhtml/default/default/template/catalog/product/helper/gallery.phtml b/app/design/adminhtml/default/default/template/catalog/product/helper/gallery.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2018-2024 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Adminhtml_Block_Catalog_Product_Helper_Form_Gallery_Content $this */
 ?>
 <div id="<?php echo $this->getHtmlId() ?>">
     <ul class="messages">

diff --git a/app/design/adminhtml/default/default/template/cms/page/edit/form/renderer/content.phtml b/app/design/adminhtml/default/default/template/cms/page/edit/form/renderer/content.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Adminhtml_Block_Widget_Form_Renderer_Fieldset_Element $this */
 ?>
 <?php $_element = $this->getElement() ?>
 <?php if (!$_element->getNoDisplay()): ?>

diff --git a/app/design/adminhtml/default/default/template/dashboard/graph.phtml b/app/design/adminhtml/default/default/template/dashboard/graph.phtml
@@ -12,29 +12,12 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
-/*
+
+/** @see Mage_Adminhtml_Block_Dashboard_Tab_Amounts */
+/** @see Mage_Adminhtml_Block_Dashboard_Tab_Orders */
+/** @var Mage_Adminhtml_Block_Dashboard_Graph $this */
 ?>
-<div style="width:587px;margin:20px;position:relative;margin-left:-294px;left:50%">
-    <div style="position:absolute;right:1px;top:0px;left: expression(parentNode.offsetWidth - offsetWidth - 1 + 'px');">
-        <div style="padding:5px;height:15px;width:15px;background-color:#F4F4F4" id="dashboard_<?php echo $this->getHtmlId() ?>_cal_div"><img src="<?php echo Mage::getDesign()->getSkinUrl('images/grid-cal.gif') ?>" onclick="toggleCal('<?php echo $this->getHtmlId() ?>')" /></div>
-        <div style="padding:5px;display:none;width:200px;" id="dashboard_<?php echo $this->getHtmlId() ?>_range_div" class="switcher">
-            <?php echo $this->__('Select Range') ?>:
-            <select name="period" id="order_<?php echo $this->getHtmlId() ?>_period" onchange="changePeriod(this)">
-                <?php foreach ($this->helper('adminhtml/dashboard_data')->getDatePeriods() as $_value=>$_label): ?>
-                    <?php if(in_array($_value, array('custom'))) continue; ?>
-                    <option value="<?php echo $_value ?>" <?php if($this->getRequest()->getParam('period')==$_value): ?> selected<?php endif ?>><?php echo $_label ?></option>
-                <?php endforeach ?>
-            </select>
-            <img src="<?php echo Mage::getDesign()->getSkinUrl('images/dashboard-close.gif') ?>" onclick="toggleCal('<?php echo $this->getHtmlId() ?>')" />
-        </div>
-    </div>
-    <?php if($this->getCount()): ?>
-    <img src="<?php echo $this->getChartUrl() ?>" />
-    <?php else: ?>
-    <div align="center" style="width:587px;height:300px;"><?php echo $this->__('No Data Found') ?></div>
-    <?php endif ?>
-</div>
-<?php */ ?>
+
 <div style="margin:20px;">
     <p class="switcher a-right" style="padding:5px 10px;"><?php echo $this->__('Select Range') ?>:
     <select name="period" id="order_<?php echo $this->getHtmlId() ?>_period" onchange="changeDiagramsPeriod(this);">

diff --git a/app/design/adminhtml/default/default/template/dashboard/grid.phtml b/app/design/adminhtml/default/default/template/dashboard/grid.phtml
@@ -12,8 +12,8 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
-?>
-<?php
+
+/** @var Mage_Adminhtml_Block_Widget_Grid $this */
 
 $numColumns = count($this->getColumns());
 ?>

diff --git a/app/design/adminhtml/default/default/template/dashboard/index.phtml b/app/design/adminhtml/default/default/template/dashboard/index.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Adminhtml_Block_Dashboard $this */
 ?>
 
 <?php if (is_array($this->getChild('diagrams')->getTabsIds())) : ?>

diff --git a/app/design/adminhtml/default/default/template/dashboard/salebar.phtml b/app/design/adminhtml/default/default/template/dashboard/salebar.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Adminhtml_Block_Dashboard_Sales $this */
 ?>
 <?php if(count($this->getTotals()) > 0): ?>
             <?php foreach( $this->getTotals() as $_total ): ?>

diff --git a/app/design/adminhtml/default/default/template/dashboard/totalbar.phtml b/app/design/adminhtml/default/default/template/dashboard/totalbar.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Adminhtml_Block_Dashboard_Totals $this */
 ?>
 <?php if(count($this->getTotals()) > 0): ?>
 <div class="box" id="dashboard_diagram_totals">

diff --git a/...fault/default/template/downloadable/sales/items/column/downloadable/creditmemo/name.phtml b/...fault/default/template/downloadable/sales/items/column/downloadable/creditmemo/name.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Downloadable_Block_Adminhtml_Sales_Items_Column_Downloadable_Name $this */
 ?>
 
 <?php if ($_item = $this->getItem()): ?>

diff --git a/.../default/default/template/downloadable/sales/items/column/downloadable/invoice/name.phtml b/.../default/default/template/downloadable/sales/items/column/downloadable/invoice/name.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Downloadable_Block_Adminhtml_Sales_Items_Column_Downloadable_Name $this */
 ?>
 
 <?php if ($_item = $this->getItem()): ?>

diff --git a/...dminhtml/default/default/template/downloadable/sales/items/column/downloadable/name.phtml b/...dminhtml/default/default/template/downloadable/sales/items/column/downloadable/name.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Downloadable_Block_Adminhtml_Sales_Items_Column_Downloadable_Name $this */
 ?>
 
 <?php if ($_item = $this->getItem()): ?>

diff --git a/app/design/adminhtml/default/default/template/index/notifications.phtml b/app/design/adminhtml/default/default/template/index/notifications.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Index_Block_Adminhtml_Notifications $this */
 ?>
 <?php $_processes = $this->getProcessesForReindex()?>
 <?php if($_processes):?>

diff --git a/app/design/adminhtml/default/default/template/newsletter/preview/store.phtml b/app/design/adminhtml/default/default/template/newsletter/preview/store.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Adminhtml_Block_Store_Switcher $this */
 ?>
 
 <?php if ($websites = $this->getWebsites()): ?>

diff --git a/app/design/adminhtml/default/default/template/newsletter/problem/list.phtml b/app/design/adminhtml/default/default/template/newsletter/problem/list.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Adminhtml_Block_Newsletter_Problem $this */
 ?>
 <div class="content-header">
     <table cellspacing="0">

diff --git a/app/design/adminhtml/default/default/template/newsletter/queue/edit.phtml b/app/design/adminhtml/default/default/template/newsletter/queue/edit.phtml
@@ -12,6 +12,7 @@
  * @copyright   Copyright (c) 2022-2024 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
 /** @var Mage_Adminhtml_Block_Newsletter_Queue_Edit $this */
 ?>
 <div class="content-header">

diff --git a/app/design/adminhtml/default/default/template/newsletter/queue/list.phtml b/app/design/adminhtml/default/default/template/newsletter/queue/list.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Adminhtml_Block_Newsletter_Queue_Edit $this */
 ?>
 <div class="content-header">
     <table cellspacing="0">

diff --git a/app/design/adminhtml/default/default/template/newsletter/queue/preview.phtml b/app/design/adminhtml/default/default/template/newsletter/queue/preview.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2022-2023 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Core_Block_Template $this */
 ?>
 <!DOCTYPE html>
 <html lang="en">

diff --git a/app/design/adminhtml/default/default/template/newsletter/subscriber/list.phtml b/app/design/adminhtml/default/default/template/newsletter/subscriber/list.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Adminhtml_Block_Newsletter_Subscriber $this */
 ?>
 <div class="content-header">
     <table cellspacing="0">

diff --git a/app/design/adminhtml/default/default/template/newsletter/template/edit.phtml b/app/design/adminhtml/default/default/template/newsletter/template/edit.phtml
@@ -12,6 +12,7 @@
  * @copyright   Copyright (c) 2021-2024 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
 /** @var Mage_Adminhtml_Block_Newsletter_Template_Edit $this */
 ?>
 <div class="content-header">

diff --git a/app/design/adminhtml/default/default/template/newsletter/template/list.phtml b/app/design/adminhtml/default/default/template/newsletter/template/list.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Adminhtml_Block_Newsletter_Template $this */
 ?>
 <div class="content-header">
     <table cellspacing="0">

diff --git a/app/design/adminhtml/default/default/template/newsletter/template/preview.phtml b/app/design/adminhtml/default/default/template/newsletter/template/preview.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2022-2023 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Core_Block_Template $this */
 ?>
 <!DOCTYPE html>
 <html lang="en">

diff --git a/app/design/adminhtml/default/default/template/page/js/calendar.phtml b/app/design/adminhtml/default/default/template/page/js/calendar.phtml
@@ -19,7 +19,18 @@
  * Calendar localization script. Should be put into page header.
  *
  * @see Mage_Core_Block_Html_Calendar
- * @var Mage_Core_Block_Html_Calendar $this 
+ * @var Mage_Core_Block_Html_Calendar $this
+ * @var string $enUS
+ * @var array $days
+ * @var string $firstDay
+ * @var array $months
+ * @var string $am
+ * @var string $pm
+ * @var string $today
+ * @var string $weekendDays
+ * @var string $defaultFormat
+ * @var string $toolTipFormat
+ * @var string $week
  */
 ?>
 

diff --git a/app/design/adminhtml/default/default/template/page/notices.phtml b/app/design/adminhtml/default/default/template/page/notices.phtml
@@ -15,8 +15,8 @@
 ?>
 <?php
 /**
- * @see Mage_Adminhtml_Page_Block_Notices
- * @var Mage_Adminhtml_Page_Block_Notices $this
+ * @see Mage_Adminhtml_Block_Page_Notices
+ * @var Mage_Adminhtml_Block_Page_Notices $this
  */
 ?>
 <?php if ($this->displayNoscriptNotice()): ?>

diff --git a/app/design/adminhtml/default/default/template/payment/form/cashondelivery.phtml b/app/design/adminhtml/default/default/template/payment/form/cashondelivery.phtml
@@ -14,8 +14,8 @@
  */
 
 /**
- * @see Saas_Payment_Block_Form_Cashondelivery
- * @var Saas_Payment_Block_Form_Cashondelivery $this 
+ * @see Mage_Payment_Block_Form_Cashondelivery
+ * @var Mage_Payment_Block_Form_Cashondelivery $this
  */
 ?>
 <?php if ($this->getInstructions()): ?>

diff --git a/app/design/adminhtml/default/default/template/paypal/system/config/fieldset/hint.phtml b/app/design/adminhtml/default/default/template/paypal/system/config/fieldset/hint.phtml
@@ -15,8 +15,8 @@
 ?>
 <?php
 /**
- * @see Mage_Paypal_Block_System_Config_Fieldset_Hint
- * @var Mage_Paypal_Block_System_Config_Fieldset_Hint $this
+ * @see Mage_Paypal_Block_Adminhtml_System_Config_Fieldset_Hint
+ * @var Mage_Paypal_Block_Adminhtml_System_Config_Fieldset_Hint $this
  */
 ?>
 <?php if ($this->getHelpLink()): ?>

diff --git a/app/design/adminhtml/default/default/template/paypal/system/config/fieldset/store.phtml b/app/design/adminhtml/default/default/template/paypal/system/config/fieldset/store.phtml
@@ -15,8 +15,8 @@
 ?>
 <?php
 /**
- * @see Mage_Paypal_Block_System_Config_Fieldset_Store
- * @var Mage_Paypal_Block_System_Config_Fieldset_Store $this 
+ * @see Mage_Paypal_Block_Adminhtml_System_Config_Fieldset_Store
+ * @var Mage_Paypal_Block_Adminhtml_System_Config_Fieldset_Store $this
  */
 ?>
 <script type="text/javascript">

diff --git a/app/design/adminhtml/default/default/template/permissions/roleinfo.phtml b/app/design/adminhtml/default/default/template/permissions/roleinfo.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Adminhtml_Block_Permissions_Buttons $this */
 ?>
 <div class="content-header">
     <table cellspacing="0">

diff --git a/app/design/adminhtml/default/default/template/permissions/roles.phtml b/app/design/adminhtml/default/default/template/permissions/roles.phtml
@@ -12,6 +12,8 @@
  * @copyright   Copyright (c) 2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Adminhtml_Block_Permissions_Roles $this */
 ?>
 <div class="content-header">
     <table cellspacing="0">

diff --git a/app/design/adminhtml/default/default/template/promo/fieldset.phtml b/app/design/adminhtml/default/default/template/promo/fieldset.phtml
@@ -12,6 +12,9 @@
  * @copyright   Copyright (c) 2021-2022 The OpenMage Contributors (https://www.openmage.org)
  * @license     https://opensource.org/licenses/afl-3.0.php  Academic Free License (AFL 3.0)
  */
+
+/** @var Mage_Adminhtml_Block_Widget_Form_Renderer_Fieldset $this */
+/** @var Varien_Data_Form_Element_Fieldset $_element */
 ?>
 <?php $_element = $this->getElement() ?>
 <div class="rule-tree">