From c3994b2291790f21cd219d1c5e820c274cb6e085 Mon Sep 17 00:00:00 2001
From: Nikita Kiselev <kiselev2008@gmail.com>
Date: Wed, 24 Dec 2025 01:45:50 +0300
Subject: [PATCH] feat: add setting to control category products button
 visibility

- Add show_category_products_button field to StoreDTO
- Update SettingsSerializerService to support new field
- Add setting in admin panel on 'Store' tab with toggle
- Pass setting to SPA through SettingsHandler
- Button displays only for categories with child categories
- Add default value true to configuration
---
 .cursor/agents.md                             | 24 +++++++++++++++++++
 frontend/admin/src/stores/settings.js         |  1 +
 frontend/admin/src/views/StoreView.vue        |  4 ++++
 frontend/spa/src/stores/SettingsStore.js      |  2 ++
 frontend/spa/src/views/CategoriesList.vue     |  4 +++-
 .../upload/oc_telegram_shop/configs/app.php   |  1 +
 .../src/DTO/Settings/StoreDTO.php             |  9 +++++++
 .../src/Handlers/SettingsHandler.php          |  1 +
 .../Services/SettingsSerializerService.php    |  5 ++++
 9 files changed, 50 insertions(+), 1 deletion(-)

diff --git a/.cursor/agents.md b/.cursor/agents.md
index 23e58de..fc201db 100644
--- a/.cursor/agents.md
+++ b/.cursor/agents.md
@@ -20,6 +20,30 @@
 4. **Тестируй изменения перед коммитом**
 5. **Документируй публичные API**
 
+### Правила коммитов
+
+1. **Следование Conventional Commits**
+   - Используй префиксы: `feat:`, `fix:`, `chore:`, `refactor:`, `style:`, `test:`, `docs:`
+   - Формат: `<type>: <subject>` (первая строка до 72 символов)
+   - После пустой строки - подробное описание изменений
+
+2. **Язык коммитов**
+   - Все коммиты на **английском языке**
+   - Подробное описание изменений в теле коммита
+   - Перечисляй все измененные файлы и ключевые изменения
+
+3. **Примеры правильных коммитов**
+   ```
+   feat: add setting to control category products button visibility
+   
+   - Add show_category_products_button field to StoreDTO
+   - Update SettingsSerializerService to support new field
+   - Add setting in admin panel on 'Store' tab with toggle
+   - Pass setting to SPA through SettingsHandler
+   - Button displays only for categories with child categories
+   - Add default value true to configuration
+   ```
+
 ### Запрещено
 
 - Хардкод значений (используй конфиги/настройки)
diff --git a/frontend/admin/src/stores/settings.js b/frontend/admin/src/stores/settings.js
index cee5dae..e9952dd 100644
--- a/frontend/admin/src/stores/settings.js
+++ b/frontend/admin/src/stores/settings.js
@@ -39,6 +39,7 @@ export const useSettingsStore = defineStore('settings', {
         enable_store: true,
         feature_coupons: true,
         feature_vouchers: true,
+        show_category_products_button: true,
       },
 
       orders: {
diff --git a/frontend/admin/src/views/StoreView.vue b/frontend/admin/src/views/StoreView.vue
index 54d2870..ba42143 100644
--- a/frontend/admin/src/views/StoreView.vue
+++ b/frontend/admin/src/views/StoreView.vue
@@ -21,6 +21,10 @@
       <a :href="`/admin/index.php?route=sale/voucher&user_token=${userToken}`"
          target="_blank">подарочные сертификаты OpenCart</a> при оформлении заказа.</p>
   </ItemBool>
+
+  <ItemBool label="Показывать кнопку «Показать товары из текущей категории»" v-model="settings.items.store.show_category_products_button">
+    <p>Включите, чтобы пользователи видели кнопку «Показать товары из "название текущей категории"» на странице категории, если у неё есть дочерние категории. Настройка работает только для страниц категорий с дочерними категориями, при отключении кнопка скрыта.</p>
+  </ItemBool>
 </template>
 
 <script setup>
diff --git a/frontend/spa/src/stores/SettingsStore.js b/frontend/spa/src/stores/SettingsStore.js
index 54a6b3e..322047d 100644
--- a/frontend/spa/src/stores/SettingsStore.js
+++ b/frontend/spa/src/stores/SettingsStore.js
@@ -12,6 +12,7 @@ export const useSettingsStore = defineStore('settings', {
         ya_metrika_enabled: false,
         feature_coupons: false,
         feature_vouchers: false,
+        show_category_products_button: true,
         currency_code: null,
         theme: {
             light: 'light', dark: 'dark', variables: {
@@ -43,6 +44,7 @@ export const useSettingsStore = defineStore('settings', {
             this.store_enabled = settings.store_enabled;
             this.feature_coupons = settings.feature_coupons;
             this.feature_vouchers = settings.feature_vouchers;
+            this.show_category_products_button = settings.show_category_products_button ?? true;
             this.currency_code = settings.currency_code;
             this.texts = settings.texts;
             this.mainpage_blocks = settings.mainpage_blocks;
diff --git a/frontend/spa/src/views/CategoriesList.vue b/frontend/spa/src/views/CategoriesList.vue
index e548b8d..8932bf3 100644
--- a/frontend/spa/src/views/CategoriesList.vue
+++ b/frontend/spa/src/views/CategoriesList.vue
@@ -18,7 +18,7 @@
       </button>
 
       <button
-          v-if="parentCategory"
+          v-if="parentCategory && parentCategory.children?.length && settings.show_category_products_button"
           class="py-2 px-4 flex items-center mb-3 cursor-pointer border-b w-full pb-2 border-base-200"
           @click.prevent="showProductsInParentCategory"
       >
@@ -59,11 +59,13 @@ import {useCategoriesStore} from "@/stores/CategoriesStore.js";
 import {useRoute} from "vue-router";
 import CategoryItem from "@/components/CategoriesList/CategoryItem.vue";
 import {useYaMetrikaStore} from "@/stores/yaMetrikaStore.js";
+import {useSettingsStore} from "@/stores/SettingsStore.js";
 import BaseViewWrapper from "@/views/BaseViewWrapper.vue";
 
 const route = useRoute();
 const categoriesStore = useCategoriesStore();
 const yaMetrika = useYaMetrikaStore();
+const settings = useSettingsStore();
 
 const parentId = computed(() => route.params.id ? Number(route.params.id) : null);
 
diff --git a/module/oc_telegram_shop/upload/oc_telegram_shop/configs/app.php b/module/oc_telegram_shop/upload/oc_telegram_shop/configs/app.php
index e6b1a08..26d1309 100755
--- a/module/oc_telegram_shop/upload/oc_telegram_shop/configs/app.php
+++ b/module/oc_telegram_shop/upload/oc_telegram_shop/configs/app.php
@@ -55,6 +55,7 @@ HTML,
         'enable_store' => true,
         'feature_coupons' => true,
         'feature_vouchers' => true,
+        'show_category_products_button' => true,
     ],
 
     'texts' => [
diff --git a/module/oc_telegram_shop/upload/oc_telegram_shop/src/DTO/Settings/StoreDTO.php b/module/oc_telegram_shop/upload/oc_telegram_shop/src/DTO/Settings/StoreDTO.php
index de25ef2..31f8cb9 100755
--- a/module/oc_telegram_shop/upload/oc_telegram_shop/src/DTO/Settings/StoreDTO.php
+++ b/module/oc_telegram_shop/upload/oc_telegram_shop/src/DTO/Settings/StoreDTO.php
@@ -7,6 +7,7 @@ final class StoreDTO
     private bool $enableStore;
     private bool $featureCoupons;
     private bool $featureVouchers;
+    private bool $showCategoryProductsButton;
     private string $ocDefaultCurrency;
     private bool $ocConfigTax;
     private int $ocStoreId;
@@ -15,6 +16,7 @@ final class StoreDTO
         bool $enableStore,
         bool $featureCoupons,
         bool $featureVouchers,
+        bool $showCategoryProductsButton,
         string $ocDefaultCurrency,
         bool $ocConfigTax,
         int $ocStoreId
@@ -22,6 +24,7 @@ final class StoreDTO
         $this->enableStore = $enableStore;
         $this->featureCoupons = $featureCoupons;
         $this->featureVouchers = $featureVouchers;
+        $this->showCategoryProductsButton = $showCategoryProductsButton;
         $this->ocDefaultCurrency = $ocDefaultCurrency;
         $this->ocConfigTax = $ocConfigTax;
         $this->ocStoreId = $ocStoreId;
@@ -42,6 +45,11 @@ final class StoreDTO
         return $this->featureVouchers;
     }
 
+    public function isShowCategoryProductsButton(): bool
+    {
+        return $this->showCategoryProductsButton;
+    }
+
     public function getOcDefaultCurrency(): string
     {
         return $this->ocDefaultCurrency;
@@ -63,6 +71,7 @@ final class StoreDTO
             'enable_store' => $this->enableStore,
             'feature_coupons' => $this->featureCoupons,
             'feature_vouchers' => $this->featureVouchers,
+            'show_category_products_button' => $this->showCategoryProductsButton,
             'oc_default_currency' => $this->ocDefaultCurrency,
             'oc_config_tax' => $this->ocConfigTax,
             'oc_store_id' => $this->ocStoreId,
diff --git a/module/oc_telegram_shop/upload/oc_telegram_shop/src/Handlers/SettingsHandler.php b/module/oc_telegram_shop/upload/oc_telegram_shop/src/Handlers/SettingsHandler.php
index 371ecf0..1648acc 100755
--- a/module/oc_telegram_shop/upload/oc_telegram_shop/src/Handlers/SettingsHandler.php
+++ b/module/oc_telegram_shop/upload/oc_telegram_shop/src/Handlers/SettingsHandler.php
@@ -48,6 +48,7 @@ class SettingsHandler
             'store_enabled' => $this->settings->config()->getStore()->isEnableStore(),
             'feature_coupons' => $this->settings->config()->getStore()->isFeatureCoupons(),
             'feature_vouchers' => $this->settings->config()->getStore()->isFeatureVouchers(),
+            'show_category_products_button' => $this->settings->config()->getStore()->isShowCategoryProductsButton(),
             'currency_code' => $this->settings->config()->getStore()->getOcDefaultCurrency(),
             'texts' => $this->settings->config()->getTexts()->toArray(),
             'mainpage_blocks' => $this->settings->get('mainpage_blocks', []),
diff --git a/module/oc_telegram_shop/upload/oc_telegram_shop/src/Services/SettingsSerializerService.php b/module/oc_telegram_shop/upload/oc_telegram_shop/src/Services/SettingsSerializerService.php
index 1206dd7..d1cd459 100755
--- a/module/oc_telegram_shop/upload/oc_telegram_shop/src/Services/SettingsSerializerService.php
+++ b/module/oc_telegram_shop/upload/oc_telegram_shop/src/Services/SettingsSerializerService.php
@@ -141,6 +141,7 @@ class SettingsSerializerService
             $data['enable_store'] ?? true,
             $data['feature_coupons'] ?? true,
             $data['feature_vouchers'] ?? true,
+            $data['show_category_products_button'] ?? true,
             $data['oc_default_currency'],
             $data['oc_config_tax'],
             $data['oc_store_id']
@@ -281,6 +282,10 @@ class SettingsSerializerService
             throw new InvalidArgumentException('store.feature_vouchers must be a boolean');
         }
 
+        if (isset($data['show_category_products_button']) && ! is_bool($data['show_category_products_button'])) {
+            throw new InvalidArgumentException('store.show_category_products_button must be a boolean');
+        }
+
         if (! isset($data['oc_default_currency'])) {
             throw new InvalidArgumentException('store.oc_default_currency is required');
         }