diff --git a/CHANGELOG.md b/CHANGELOG.md index 0f44bbb..99aab08 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,26 @@ # (MODX)EvolutionCMS.libraries.ddTools changelog +## Version 0.62 (2024-06-14) +* \+ `\ddTools::isEmpty`: The new public static method. Determines whether a variable is empty. +* \* `\ddTools::parseText` → Parameters: + * \+ `$params->data`: Both objects and arrays are supported regardless of nesting level. + * \+ `$params->data->{$key}` → Valid values → `boolean`: The new supported value. It will be converted to `'1'` or `'0'` respectively. + * \* `$params->isCompletelyParsingEnabled`: + * \* Has been renamed from `$params->mergeAll` (with backward compatibility). + * \+ If enabled, the method will parse everything, including document fields, settings, chunks, snippets and URLs. +* \* `\DDTools\ObjectTools::` + * \+ `getPropValue` → Parameters → `$params->notFoundResult`: The new optional parameter. Allows to define what will be returned if required property will not found (see README → Examples). + * \+ `unfold` → Parameters → `$params->isCrossTypeEnabled`: The new optional parameter. This parameter determines whether the method should process elements across different data types, such as arrays and objects, at all levels. When set to `true`, the method will recursively unfold elements of both array and object types, regardless of the type of the root parent (see README → Examples). + * \* `isPropExists` → Parameters → `$params->object`: The method will return `false` even if the parameter is not an object or array. +* \* `\DDTools\ObjectCollection::setOneItemData` → Parameters: The following have been renamed (old names are still supported but deprecated): + * \* `itemIndex` → `index`. + * \* `itemData` → `data`. +* \+ `\DDTools\Base\Base::getClassName`: The new public static method. Gets data about a class name (see README). +* \+ `\DDTools\Base\AncestorTrait::getChildClassName`: The new public static method (see README). +* \+ `\DDTools\Storage\`: The new classes. This is beta functionality, use it at your own risk. + + ## Version 0.61 (2023-10-01) * \+ `\DDTools\ObjectTools::convertType` → Parameters → `$params->type` → Valid values → `'stringHtmlAttrs'`: The new available value. Allows conversion to an HTML attributes string (see README → Examples). diff --git a/CHANGELOG_ru.md b/CHANGELOG_ru.md index 482d04c..6ac173d 100644 --- a/CHANGELOG_ru.md +++ b/CHANGELOG_ru.md @@ -1,6 +1,26 @@ # (MODX)EvolutionCMS.libraries.ddTools changelog +## Версия 0.62 (2024-06-14) +* \+ `\ddTools::isEmpty`: Новый публичный статичный метод. Проверяет, пуста ли переменная. +* \* `\ddTools::parseText` → Параметры: + * \+ `$params->data`: Поддерживаются как объекты, так и массивы одновременно, независимо от уровня вложенности. + * \+ `$params->data->{$key}` → Допустимые значения → `boolean`: Новое поддерживаемое значение. Будет сконвертировано в `'1'` или `'0'` соответственно. + * \* `$params->isCompletelyParsingEnabled`: + * \* Переименован из `$params->mergeAll` (с обратной совместимостью). + * \+ Если включён, метод будет парсить всё, включая поля документа, настройки, чанки, сниппеты и URL. +* \* `\DDTools\ObjectTools::` + * \+ `getPropValue` → Параметры → `$params->notFoundResult`: Новый необязательный параметр. Позволяет настроить, что будет возвращено, если нужное свойство не найдено (см. README → Примеры). + * \+ `unfold` → Параметры → `$params->isCrossTypeEnabled`: Новый необязательный параметр. Параметр определяет, должен ли метод обрабатывать объекты и массивы одновременно, независимо от типа, на всех уровнях вложенности. При значении `true` метод будет рекурсивно разворачивать элементы как массивов, так и объектов, независимо от типа корневого родителя (см. README → Примеры). + * \* `isPropExists` → Параметры → `$params->object`: Метод вернёт `false` даже если параметр не является объектом или массивом. +* \* `\DDTools\ObjectCollection::setOneItemData` → Параметры: Следующие переименованы (старые имена по-прежнему поддерживаются, но объявлены устаревшими): + * \* `itemIndex` → `index`. + * \* `itemData` → `data`. +* \+ `\DDTools\Base\Base::getClassName`: Новый публичный статичный метод. Получает данные об имени класса (см. README). +* \+ `\DDTools\Base\AncestorTrait::getChildClassName`: Новый публичный статичный метод (см. README). +* \+ `\DDTools\Storage\`: Новые классы. Это бета-версия, используйте её на свой страх и риск. + + ## Версия 0.61 (2023-10-01) * \+ `\DDTools\ObjectTools::convertType` → Параметры → `$params->type` → Допустимые значения → `'stringHtmlAttrs'`: Новое значение. Позволяет преобразовать в строку HTML-атрибутов (см. README → Примеры). diff --git a/composer.json b/composer.json index d124246..9d6e386 100644 --- a/composer.json +++ b/composer.json @@ -1,7 +1,7 @@ { "name": "dd/evolutioncms-libraries-ddtools", "type": "modxevo-library-ddtools", - "version": "0.61.0", + "version": "0.62.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 a53298d..40b6804 100644 --- a/modx.ddtools.class.php +++ b/modx.ddtools.class.php @@ -1,11 +1,11 @@