feat(manager): add tooltip for order statistics in Vue orders grid

Enhanced the Vue orders grid by adding a tooltip for the order statistics, clarifying that only placed orders are counted, excluding drafts. Updated English and Russian lexicons accordingly. Improved the logic in the OrdersController to handle draft visibility more clearly.

Author: Ibochkarev

core/components/minishop3/lexicon/en/vue.inc.php

@@ -489,6 +489,7 @@
 $_lang['orders_title'] = 'Orders';
 $_lang['orders_month'] = 'Orders';
 $_lang['orders_month_sum'] = 'Total sum';
+$_lang['orders_stat_tooltip'] = 'Count and sum for placed orders only; drafts are not included';
 $_lang['ms3_orders_show_drafts'] = 'Show drafts';
 $_lang['order_num'] = 'Number';
 $_lang['order_customer'] = 'Customer';

core/components/minishop3/lexicon/ru/vue.inc.php

@@ -489,6 +489,7 @@
 $_lang['orders_title'] = 'Заказы';
 $_lang['orders_month'] = 'Заказов';
 $_lang['orders_month_sum'] = 'На сумму';
+$_lang['orders_stat_tooltip'] = 'Количество и сумма по оформленным заказам; черновики не учитываются';
 $_lang['ms3_orders_show_drafts'] = 'Показывать черновики';
 $_lang['order_num'] = 'Номер';
 $_lang['order_customer'] = 'Клиент';

core/components/minishop3/src/Controllers/Api/Manager/OrdersController.php

@@ -1549,26 +1549,29 @@ protected function getOrdersStats(array $params = []): array
     }
 
     /**
-     * Whether draft orders should be included in manager list/stats queries.
+     * Whether draft orders should be included in the manager orders list query.
      *
-     * Request param `show_drafts` overrides the system setting `ms3_order_show_drafts`.
+     * When `show_drafts` is present in request params it overrides `ms3_order_show_drafts`.
+     * The Vue orders grid always sends this flag (initialized from ms3.config.order_show_drafts).
      */
     protected function shouldShowDrafts(array $params): bool
     {
-        if (array_key_exists('show_drafts', $params)) {
-            $value = $params['show_drafts'];
-            if ($value === '' || $value === null) {
-                return (bool) $this->modx->getOption('ms3_order_show_drafts', null, false);
-            }
+        $default = (bool) $this->modx->getOption('ms3_order_show_drafts', null, false);
+
+        if (!array_key_exists('show_drafts', $params)) {
+            return $default;
+        }
 
-            return filter_var($value, FILTER_VALIDATE_BOOLEAN);
+        $value = $params['show_drafts'];
+        if ($value === '' || $value === null) {
+            return $default;
         }
 
-        return (bool) $this->modx->getOption('ms3_order_show_drafts', null, false);
+        return filter_var($value, FILTER_VALIDATE_BOOLEAN);
     }
 
     /**
-     * Exclude draft status from query unless drafts are explicitly shown.
+     * Exclude draft status from getList query unless drafts are explicitly shown.
      */
     protected function applyDraftVisibilityFilter($c, array $params): void
     {

vueManager/src/components/OrdersGrid.vue

@@ -569,7 +569,7 @@ onMounted(async () => {
               @click="createNewOrder"
             />
           </div>
-          <div class="grid-stats">
+          <div class="grid-stats" :title="_('orders_stat_tooltip')">
             <span class="stat-item">
               <i class="pi pi-calendar"></i>
               {{ _('orders_month') }}: <strong>{{ stats.month_total }}</strong>
@@ -855,6 +855,7 @@ onMounted(async () => {
   gap: 1.5rem;
   font-size: 0.9rem;
   color: var(--ms3-text-muted);
+  cursor: help;
 }
 
 .stat-item {