From 26d2e7706294afdeeb49140235b34a8a578d66b7 Mon Sep 17 00:00:00 2001 From: Ilyas Ronef Date: Fri, 6 Sep 2024 05:05:31 +0400 Subject: [PATCH] Prerelease --- CHANGELOG.md | 18 ++++++++++++++++++ CHANGELOG_ru.md | 20 +++++++++++++++++++- composer.json | 2 +- modx.ddtools.class.php | 2 +- 4 files changed, 39 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3b470dd..2c514d0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,24 @@ # (MODX)EvolutionCMS.libraries.ddTools changelog +## Version 0.64 (2024-09-06) + +* \+ `\DDTools\Tools\Objects::extend` → Parameters → `$params->extendableProperties`: The new optional parameter. Allows to use for extending not all properties from additional objects or arrays (see README → Examples). +* \+ `\DDTools\Storage\Storage` → `items_update`, `items_updateOne`, `items_delete`, `items_deleteOne`, `items_get`, `items_getOne` → Parameters: + * \+ `$params->where` → Valid values → `null`: The new supported value. It is equal to ''. + * \+ `$params->where->{$propName}`: + * \+ You can also specify multiple value variants through an array. + * \+ You don't have to worry about passing empty arrays, they will just be ignored. +* \+ `\DDTools\Tools\Cache`: + * \+ There are now 2 levels of caching: stable (file-based) and quick (`$_SESSION`-based). All methods now utilize both levels automatically. + * \+ `getSeveral`: The new public static method. Retrieves data of several items from cache storage (see README). + * \+ `saveSeveral`: The new public static method. Saves data of several items to cache storage (see README). + * \+ `save`, `saveSeveral`, `get`, `getSeveral`, `delete` → Parameters → `$params->resourceId` → Valid values → `string`: The new supported value. You can use a custom string as the resource ID, not only an integer ID. + * \+ `getSeveral`, `delete` → Parameters → `$params->resourceId` → Valid values → `array`: The new supported value. You can specify multiple IDs. + * \+ `delete` → Parameters → `$params->resourceId` → Valid values → `'*'`: The new supported value. + * \+ `save` → Parameters → `$params->isExtendEnabled`: The new optional parameter. Allows to extend existing data (see README). + + ## Version 0.63 (2024-08-02) * \+ `\DDTools\Tools\Cache`: The new class. Allows you to cache some data (e. g. a snippet result) to a file in the `assets/cache/ddCache` folder (see README). diff --git a/CHANGELOG_ru.md b/CHANGELOG_ru.md index 3c9e449..389e435 100644 --- a/CHANGELOG_ru.md +++ b/CHANGELOG_ru.md @@ -1,6 +1,24 @@ # (MODX)EvolutionCMS.libraries.ddTools changelog +## Version 0.64 (2024-09-06) + +* \+ `\DDTools\Tools\Objects::extend` → Параметры → `$params->extendableProperties`: Новый необязательный параметр. Позволяет использовать для расширения не все свойства из дополнительных объектов или массивов (см. README → Примеры). +* \+ `\DDTools\Storage\Storage` → `items_update`, `items_updateOne`, `items_delete`, `items_deleteOne`, `items_get`, `items_getOne` → Параметры: + * \+ `$params->where` → Допустимые значения → `null`: Новое значение. Эквивалентно `''`. + * \+ `$params->where->{$propName}`: + * \+ Вы также можете указать несколько вариантов значений с помощью массива. + * \+ Вам не нужно беспокоиться о передаче пустых массивов, они будут просто проигнорированы. +* \+ `\DDTools\Tools\Cache`: + * \+ Теперь существует 2 уровня кэширования: постоянное (на основе файлов) и быстрое (на основе `$_SESSION`). Все методы используют оба уровня автоматически. + * \+ `getSeveral`: Новый публичный статичный метод. Получает из кеша данные о нескольких элементах (см. README). + * \+ `saveSeveral`: Новый публичный статичный метод. Сохраняет в кэш данные нескольких элементов (см. README). + * \+ `save`, `saveSeveral`, `get`, `getSeveral`, `delete` → Параметры → `$params->resourceId` → Допустимые значения → `string`: Новое значение. В качестве идентификатора ресурса можно использовать не только числовой идентификатор, но и произвольную строку. + * \+ `getSeveral`, `delete` → Параметры → `$params->resourceId` → Допустимые значения → `array`: Новое значение. Можно указать несколько ID. + * \+ `delete` → Параметры → `$params->resourceId` → Допустимые значения → `'*'`: Новое значение. + * \+ `save` → Параметры → `$params->isExtendEnabled`: Новый необязательный параметр. Позволяет дополнить уже существующие данные (см. README). + + ## Версия 0.63 (2024-08-02) * \+ `\DDTools\Tools\Cache`: Новый класс. Позволяет кэшировать какие-то данные (например, результаты сниппетов) в файл в папке `assets/cache/ddCache` (см. README). @@ -10,7 +28,7 @@ ## Версия 0.62.1 (2024-06-17) -* \* `\ddTools::parseText` → Parameters → `$params->isCompletelyParsingEnabled`: Неработающая поддержка устаревшего названия `$params->mergeAll` исправлена. +* \* `\ddTools::parseText` → Параметры → `$params->isCompletelyParsingEnabled`: Неработающая поддержка устаревшего названия `$params->mergeAll` исправлена. ## Версия 0.62 (2024-06-14) diff --git a/composer.json b/composer.json index b47e654..0396a73 100644 --- a/composer.json +++ b/composer.json @@ -1,7 +1,7 @@ { "name": "dd/evolutioncms-libraries-ddtools", "type": "modxevo-library-ddtools", - "version": "0.63.0", + "version": "0.64.0", "description": "A library with various tools facilitating your work.", "keywords": [ "modx", diff --git a/modx.ddtools.class.php b/modx.ddtools.class.php index 1eca0ab..6159111 100644 --- a/modx.ddtools.class.php +++ b/modx.ddtools.class.php @@ -1,7 +1,7 @@