From 5724fffed97ed3c10bdee1d27d41092ae4a41873 Mon Sep 17 00:00:00 2001
From: Ilyas Ronef <ilyas@DivanDesign.ru>
Date: Thu, 9 Mar 2023 03:05:18 +0400
Subject: [PATCH] Prerelease

---
 CHANGELOG.md           | 8 ++++++++
 CHANGELOG_ru.md        | 8 ++++++++
 composer.json          | 2 +-
 modx.ddtools.class.php | 2 +-
 4 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b3a90ac..74d0686 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,14 @@
 # (MODX)EvolutionCMS.libraries.ddTools changelog
 
 
+## Version 0.57 (2023-03-09)
+* \+ `\DDTools\ObjectTools::getPropValue` → Parameters → `$params->propName`: The method can now get the value of an object property or an array element in any nesting level. Just use `'.'` to get nested properties.  
+	Several examples (see full examples in README):
+	* \* `somePlainProp` — get first-level property.
+	* \* `someObjectProp.secondLevelProp` — get property of the `someObjectProp` object|array.
+	* \* `someArrayProp.0.thirdLevelProp` — get property of the zero element of the `someArrayProp` array.
+
+
 ## Version 0.56 (2023-01-29)
 * \+ `\ddTools::sort2dArray` → Parameters → `$array[$i]`: Can also be set as object.
 * \* `\DDTools\Base\Base`:
diff --git a/CHANGELOG_ru.md b/CHANGELOG_ru.md
index cb625b7..5488a54 100644
--- a/CHANGELOG_ru.md
+++ b/CHANGELOG_ru.md
@@ -1,6 +1,14 @@
 # (MODX)EvolutionCMS.libraries.ddTools changelog
 
 
+## Версия 0.57 (2023-03-09)
+* \+ `\DDTools\ObjectTools::getPropValue` → Параметры → `$params->propName`: Теперь метод умеет получать значение свойства объекта или элемента массива на любом уровне вложенности. Просто используйте `'.'` в параметре для получения свойств вложенных элементов.  
+	Несколько примеров (см. полные примеры в README):
+	* \* `somePlainProp` — получить свойство первого уровня.
+	* \* `someObjectProp.secondLevelProp` — получить свойство объекта|массива `someObjectProp`.
+	* \* `someArrayProp.0.thirdLevelProp` — получить свойство нулевого элемента массива `someArrayProp`.
+
+
 ## Версия 0.56 (2023-01-29)
 * \+ `\ddTools::sort2dArray` → Параметры → `$array[$i]`: Также может быть задан, как объект.
 * \* `\DDTools\Base\Base`:
diff --git a/composer.json b/composer.json
index 2bb3bd4..abda380 100644
--- a/composer.json
+++ b/composer.json
@@ -1,7 +1,7 @@
 {
 	"name": "dd/evolutioncms-libraries-ddtools",
 	"type": "modxevo-library-ddtools",
-	"version": "0.56.0",
+	"version": "0.57.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 87ada1b..6580be9 100644
--- a/modx.ddtools.class.php
+++ b/modx.ddtools.class.php
@@ -1,7 +1,7 @@
 <?php
 /**
  * EvolutionCMS.libraries.ddTools
- * @version 0.56 (2023-01-29)
+ * @version 0.57 (2023-03-09)
  * 
  * @see README.md
  *