Version 0.58

CHANGELOG.md

@@ -1,6 +1,10 @@
 # (MODX)EvolutionCMS.libraries.ddTools changelog
 
 
+## Version 0.58 (2023-03-21)
+* \+ `\DDTools\Base\AncestorTrait::createChildInstance` → Parameters → `$params->parentDir`: Is no longer required and by default is equal to dirname of a class that uses this trait.
+
+
 ## 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):

CHANGELOG_ru.md

@@ -1,6 +1,10 @@
 # (MODX)EvolutionCMS.libraries.ddTools changelog
 
 
+## Версия 0.58 (2023-03-21)
+* \+ `\DDTools\Base\AncestorTrait::createChildInstance` → Параметры → `$params->parentDir`: Больше не обязателен и по умолчанию равен папке класса, использующего этот трейт.
+
+
 ## Версия 0.57 (2023-03-09)
 * \+ `\DDTools\ObjectTools::getPropValue` → Параметры → `$params->propName`: Теперь метод умеет получать значение свойства объекта или элемента массива на любом уровне вложенности. Просто используйте `'.'` в параметре для получения свойств вложенных элементов.  
 	Несколько примеров (см. полные примеры в README):

README.md

@@ -918,11 +918,6 @@ You can see an example of how it works in the [(MODX)EvolutionCMS.snippets.ddGet
 		* `arrayAssociative`
 	* **Required**
 
-* `$params->parentDir`
-	* Desctription: Directory of the parent file (e. g. `__DIR__`).
-	* Valid values: `string`
-	* **Required**
-
 * `$params->name`
 	* Desctription: Class name.
 	* Valid values: `string`
@@ -935,6 +930,11 @@ You can see an example of how it works in the [(MODX)EvolutionCMS.snippets.ddGet
 		* `arrayAssociative`
 	* Default value: `[]`
 
+* `$params->parentDir`
+	* Desctription: Directory of the parent file (e. g. `__DIR__`).
+	* Valid values: `string`
+	* Default value: — (dirname of a class that uses this trait)
+
 * `$params->capitalizeName`
 	* Desctription: Need to capitalize child name?
 	* Valid values: `boolean`

composer.json

@@ -1,7 +1,7 @@
 {
 	"name": "dd/evolutioncms-libraries-ddtools",
 	"type": "modxevo-library-ddtools",
-	"version": "0.57.0",
+	"version": "0.58.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.57 (2023-03-09)
+ * @version 0.58 (2023-03-21)
  * 
  * @see README.md
  * 

src/Base/AncestorTrait.php

@@ -4,7 +4,7 @@
 trait AncestorTrait {
 	/**
 	 * createChildInstance
-	 * @version 1.1.1 (2019-08-22)
+	 * @version 1.2 (2023-03-21)
 	 * 
 	 * @see README.md
 	 * 
@@ -15,36 +15,43 @@ public static final function createChildInstance($params){
 		$params = (object) array_merge(
 			[
 				'params' => [],
+				'parentDir' => null,
 				'capitalizeName' => true
 			],
 			(array) $params
 		);
 
-		$thisClassName = get_called_class();
+		//Capitalize child name if needed
+		if ($params->capitalizeName){
+			$params->name = ucfirst(strtolower($params->name));
+		}
+
+		$thisClassNameFull = get_called_class();
+
+		if (empty($params->parentDir)){
+			$objectClassReflector = new \ReflectionClass($thisClassNameFull);
+
+			$params->parentDir = dirname($objectClassReflector->getFileName());
+		}
 
 		$thisNameSpace = substr(
-			$thisClassName,
+			$thisClassNameFull,
 			0,
 			strrpos(
-				$thisClassName,
+				$thisClassNameFull,
 				'\\'
 			)
 		);
 
 		//Current classname without namespace
 		$thisClassName = substr(
-			$thisClassName,
+			$thisClassNameFull,
 			strrpos(
-				$thisClassName,
+				$thisClassNameFull,
 				'\\'
 			) + 1
 		);
 
-		//Capitalize child name if needed
-		if ($params->capitalizeName){
-			$params->name = ucfirst(strtolower($params->name));
-		}
-
 		$filePath =
 			$params->parentDir .
 			DIRECTORY_SEPARATOR .