Prerelease

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).

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)

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",

modx.ddtools.class.php

@@ -1,7 +1,7 @@
 <?php
 /**
  * EvolutionCMS.libraries.ddTools
- * @version 0.63 (2024-08-02)
+ * @version 0.64 (2024-09-06)
  * 
  * @see README.md
  *