release: 1.11.1-beta1 (hotfixes for #293, #296)

- _build/config.inc.php: 1.11.0 → 1.11.1
- src/MiniShop3.php: $version 1.11.0-beta1 → 1.11.1-beta1
- CHANGELOG.md: new release block [2026-05-22] 🚀 Версия 1.11.1-beta1 + promote
  previous block to [2026-05-21] 🚀 Версия 1.11.0-beta1.
- docs/changelog.txt: new [1.11.1-beta1] block with the two hotfixes.

Hotfixes already in beta:
- a0480e2 — ProductThumbnailJoin double-backticks → SQL syntax error on
  includeThumbs (#293).
- 4a86bdd — full changelog in transport metadata → 22001 Data too long on
  install (#296).

Author: TolkIT-team

CHANGELOG.md

@@ -17,7 +17,25 @@
 
 ## Май 2026
 
-### Разработка
+### [2026-05-22] 🚀 Версия 1.11.1-beta1
+
+**Тип релиза:** PATCH (beta) — точечные хотфиксы установки и каталога с превью
+
+#### 🐛 Исправлено
+
+**SQL-ошибка в `msProducts` / `msCart` / `msGetOrder` при `includeThumbs` (#293):**
+- Хелпер `ProductThumbnailJoin::buildLeftJoinOn()` оборачивал результат `$modx->getTableName()` ещё одной парой backticks. xPDO `getTableName()` уже экранирует имя таблицы — в итоге в runtime SQL появлялись тройные backticks вокруг имени, MySQL отвергал запрос как `Error 42000`. Любой вызов `includeThumbs=...` на витрине после установки 1.11.0-beta1 отдавал пустой каталог.
+- Фикс — убраны внешние backticks вокруг `%4$s` в sprintf-шаблоне `ProductThumbnailJoin`. В код добавлен комментарий чтобы не наступить повторно.
+
+**Установка пакета 1.11.0-beta1 падала с `Data too long for column 'metadata'` (#296):**
+- В `_build/build.php` через `setPackageAttributes` передавался полный `core/components/minishop3/docs/changelog.txt` (~33 KB истории с 1.0.0-alpha) + `license.txt` (~15 KB) + `readme.txt`. На MODX-установках с колонкой `modx_transport_packages.metadata` типа `TEXT` (лимит 65 535 байт) сериализованные attributes не помещались — INSERT падал с `SQLSTATE 22001 / 1406`. В предыдущих релизах changelog был меньше и проблема не проявлялась.
+- В transport metadata теперь идёт **только блок текущего релиза** (~7 KB вместо 33 KB) через новый метод `readLatestChangelogEntry()`. Полный changelog по-прежнему есть внутри пакета (`docs/changelog.txt`) — пользователь видит полную историю в файле, а в карточке пакета MODX — последний релиз.
+
+---
+
+### [2026-05-21] 🚀 Версия 1.11.0-beta1
+
+**Тип релиза:** MINOR (beta) — крупный цикл с breaking changes и новыми фичами
 
 #### ✨ Добавлено
 

_build/config.inc.php

@@ -12,7 +12,7 @@
     'name' => 'MiniShop3',
     'name_lower' => 'minishop3',
     'name_short' => 'ms3',
-    'version' => '1.11.0',
+    'version' => '1.11.1',
     'release' => 'beta1',
     // Install package to site right after build
     'install' => false,

core/components/minishop3/docs/changelog.txt

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.11.1-beta1]
+
+### Fixed
+- `msProducts` / `msCart` / `msGetOrder` with `includeThumbs` returned an SQL syntax error in 1.11.0-beta1 (#293). The new `ProductThumbnailJoin` helper wrapped `$modx->getTableName()` result in extra backticks; xPDO already escapes the name itself, so runtime SQL had triple backticks around the table and MySQL rejected the statement. Storefront catalog listings with thumbnails were empty until reload. Fixed by stripping the outer backticks in the sprintf template.
+- Package upgrade to 1.11.0-beta1 failed on MODX installs where `modx_transport_packages.metadata` is `TEXT` (#296). The full project changelog (~33 KB of history since 1.0.0-alpha) plus license + readme + requires, serialized into package attributes, overflowed the 65 535-byte limit. Transport-package metadata now contains only the current release block from the changelog (~7 KB); the full file remains in `core/components/minishop3/docs/changelog.txt` inside the installed package.
+
 ## [1.11.0-beta1]
 
 ### Added

core/components/minishop3/src/MiniShop3.php

@@ -20,7 +20,7 @@
 
 class MiniShop3
 {
-    public $version = '1.11.0-beta1';
+    public $version = '1.11.1-beta1';
 
     /** @var modX $modx */
     public $modx;