Version 3.10

Author: Ronef

CHANGELOG.md

@@ -1,22 +1,35 @@
 # (MODX)EvolutionCMS.snippets.ddGetMultipleField changelog
 
 
+## Version 3.10 (2024-09-06)
+
+* \+ Parameters → `rowTpl` → Available placeholders:
+	* \+ `[+allColumnValuesObjectJson+]`: The new placeholder. Contains values of all columns as a JSON object, where keys are original column keys, values are values.
+	* \+ `[+`_columnKey_`.`_nestedProperty_`+]`, `[+col`_columnNumber_`.`_nestedProperty_`+]`: The new placeholders. Contain values of nested properties, when a column value is an object.
+* \* `\ddTools::getTpl` is used instead of `$modx->getTpl` (means a bit less bugs).
+* \* Attention! (MODX)EvolutionCMS.libraries.ddTools >= 0.62 is required.
+
+
 ## Version 3.9 (2023-01-11)
+
 * \+ Parameters → `inputString`: Can also be set as a [HJSON](https://hjson.github.io/) or [Query formatted](https://en.wikipedia.org/wiki/Query_string) string.
 * \* Parameters → `outerTpl`: Placeholders `[+rowY.colX+]` works fine even source object has custom string keys.
 
 
 ## Version 3.8.2 (2022-08-10)
+
 * \* Parameters:
 	* \* `columns`: Wrong working with the `0` value has been fixed.
 	* \* `colTpl`: Wrong working with the empty value has been fixed.
 
 
 ## Version 3.8.1 (2022-06-09)
+
 * \* Parameters → `colTpl`: Support of various column numbers in different rows has been improved.
 
 
 ## Version 3.8 (2022-06-04)
+
 * \* Parameters:
 	* \+ `inputString`: Supports JSON with any nesting level.
 	* \+ `colTpl[$i]` → Placeholders:
@@ -30,11 +43,13 @@
 
 
 ## Version 3.7 (2021-10-05)
+
 * \+ Parameters → `rowTpl`, `colTpl[i]`: The new placeholder `[+rowKey+]` has been added (see README).
 * \+ Parameters → `colTpl[i]`: The new placeholders `[+total+]` and `[+resultTotal+]` have beed added (see README).
 
 
 ## Version 3.6 (2021-06-28)
+
 * \* Attention! PHP >= 5.6 is required.
 * \* Attention! (MODX)EvolutionCMS.libraries.ddTools >= 0.50 is required.
 * \* Attention! (MODX)EvolutionCMS.snippets.ddTypograph >= 2.5 is required.
@@ -54,10 +69,12 @@
 
 
 ## Version 3.5.1 (2020-06-22)
+
 * \* Improved compatibility with new versions of (MODX)EvolutionCMS.libraries.ddTools.
 
 
 ## Version 3.5 (2020-05-25)
+
 * \+ Parameters → `inputString`: Can also be a JSON object, not just an array.
 * \* Parameters → `filter`:
 	* \* “Is equal” operator changed to `==` from `::` (with backward compatibility).
@@ -73,6 +90,7 @@
 
 
 ## Version 3.4 (2018-11-14)
+
 * \+ Parameters → `placeholders`:
 	* \+ Added arrays support.
 	* \+ Added JSON format support.
@@ -83,6 +101,7 @@
 
 
 ## Version 3.3 (2016-06-06)
+
 * \+ Parameters → `outerTpl`, `rowTpl`, `colTpl`: Added the ability to use inline templates in snippet call, using `'@CODE:'` prefix.
 * \+ Parameters → `rowTpl`, `colTpl`: Additional data from the `placeholders` parameter are now also will be passed into row and column templates
 * \* Parameters → `placeholders`: Additional data has to be passed through the parameter must be a Query string (the old format is still supported but deprecated).
@@ -94,6 +113,7 @@
 
 
 ## Version 3.2 (2015-06-23)
+
 * \+ Parameters → `colTpl:` The `[+rowNumber+]` placeholder is now also available within column templates.
 * \+ Parameters → `rowTpl`, `colTpl`: The new placeholder `[+rowNumber.zeroBased+]` (index of the current row, starts at 0) was added to row and column templates. It’s very useful sometimes.
 * \* Refactoring:
@@ -104,10 +124,12 @@
 
 
 ## Version 3.1 (2014-07-03)
+
 * \+ Parameters → `outputFormat`: The new output format type `htmlarray` has been added. It is a one-dimensional array, which elements are completely processed rows. As with `array`, it makes sense to use the parameter only with `resultToPlaceholder`.
 
 
 ## Version 3.0b (2014-03-02)
+
 * \* Attention! (MODX)EvolutionCMS.libraries.ddTools >= 0.11 is required.
 * \* The `\ddTools:sort2dArray` method is used for sorting instead of the local function.
 * \* The `\ddTools:getTemplateVarOutput` method is used for getting field value instead of (MODX)EvolutionCMS.snippets.ddGetDocumentField.
@@ -143,6 +165,7 @@
 
 
 ## Version 2.18 (2013-11-11)
+
 * \* Attention! (MODX)EvolutionCMS.libraries.ddTools >= 0.10 is required.
 * \+ Parameters → `tplWrap`, `tplY`: The new placeholder `[+resultTotal+]` being used in the chunks holds the total number of **RETURNED** elements.
 * \* Parameters → `tplWrap`: 
@@ -153,18 +176,22 @@
 
 
 ## Version 2.17 (2013-09-18)
+
 * \+ Parameters → `vals`: Filtration of all columns is now available.
 
 
 ## Version 2.16.2 (2013-07-11)
+
 * \* Values contained in the integer type columns are being compared like integers while sorting.
 
 
 ## Version 2.16.1 (2013-06-13)
+
 * \* Bugfix: Undeclared variables in PHP >= 5.3.
 
 
 ## Version 2.16 (2013-03-28)
+
 * \* Attention! (MODX)EvolutionCMS.snippets.ddGetDocumentField >= 2.4 is required.
 * \+ Parameters → `tplWrap`: The `[+total+]` placeholder is now available.
 * \+ Parameters → `splY`, `splX`: Can process regular expressions.
@@ -174,16 +201,19 @@
 
 
 ## Version 2.15 (2013-02-11)
+
 * \+ Parameters → `totalPlaceholder`. The new parameter. The outputting of the total number of rows into an external placeholder has been added.
 
 
 ## Version 2.14 (2013-01-10)
+
 * \+ Parameters → `tplY`: The placeholder `[+total+]` that is the number of all rows has been added into the chunk.
 
 
 ## Version 2.13 (2012-09-03)
+
 * \+ Parameters → `sortDir`: The `'REVERSE'` value of the parameter has been added. Values would be returned in reverse order if the parameter equaled `'REVERSE'`.
 
 
-<link rel="stylesheet" type="text/css" href="https://DivanDesign.ru/assets/files/ddMarkdown.css" />
+<link rel="stylesheet" type="text/css" href="https://raw.githack.com/DivanDesign/CSS.ddMarkdown/master/style.min.css" />
 <style>ul{list-style:none;}</style>

CHANGELOG_ru.md

@@ -1,22 +1,35 @@
 # (MODX)EvolutionCMS.snippets.ddGetMultipleField changelog
 
 
+## Версия 3.10 (2024-09-06)
+
+* \+ Параметры → `rowTpl` → Доступные плейсхолдеры:
+	* \+ `[+allColumnValuesObjectJson+]`: Новый плейсхолдер. Содержит значения всех колонок в виде JSON-объекта, где ключи — исходные ключи колонок, значения — значения.
+	* \+ `[+`_columnKey_`.`_nestedProperty_`+]`, `[+col`_columnNumber_`.`_nestedProperty_`+]`: Новые плейсхолдеры. Содержат значения вложенных свойств, когда значение колонки является объектом.
+* \* `\ddTools::getTpl` используется вместо `$modx->getTpl` (стало чуть меньше багов).
+* \* Внимание! Требуется (MODX)EvolutionCMS.libraries.ddTools >= 0.62.
+
+
 ## Версия 3.9 (2023-01-11)
+
 * \+ Параметры → `inputString`: Также может быть задан, как [HJSON](https://hjson.github.io/) или [Query formatted string](https://en.wikipedia.org/wiki/Query_string).
 * \* Параметры → `outerTpl`: Плейсхолдеры `[+rowY.colX+]` работают нормально даже если исходный объект имеет произвольные строковые ключи.
 
 
 ## Версия 3.8.2 (2022-08-10)
+
 * \* Параметры:
 	* \* `columns`: Исправлена некорректная работа со значением `0`.
 	* \* `colTpl`: Исправлена некорректная работа с пустым значением.
 
 
 ## Версия 3.8.1 (2022-06-09)
+
 * \* Параметры → `colTpl`: Улучшена поддержка различного количества колонок в разных строках.
 
 
 ## Версия 3.8 (2022-06-04)
+
 * \* Параметры:
 	* \+ `inputString`: Поддерживает JSON с любым уровнем вложенности.
 	* \+ `colTpl[$i]` → Плейсхолдеры:
@@ -30,11 +43,13 @@
 
 
 ## Версия 3.7 (2021-10-05)
+
 * \+ Параметры → `rowTpl`, `colTpl[i]`: Добавлен новый плейсхолдер `[+rowKey+]` (см. README).
 * \+ Параметры → `colTpl[i]`: Добавлены новые плейсхолдеры `[+total+]` и `[+resultTotal+]` (см. README).
 
 
 ## Версия 3.6 (2021-06-28)
+
 * \* Внимание! Требуется PHP >= 5.6.
 * \* Внимание! Требуется (MODX)EvolutionCMS.libraries.ddTools >= 0.50.
 * \* Внимание! Требуется (MODX)EvolutionCMS.snippets.ddTypograph >= 2.5.
@@ -54,10 +69,12 @@
 
 
 ## Версия 3.5.1 (2020-06-22)
+
 * \* Улучшена совместимость с новыми версиями (MODX)EvolutionCMS.libraries.ddTools.
 
 
 ## Версия 3.5 (2020-05-25)
+
 * \+ Параметры → `inputString`: Также может быть и JSON объектом, не только массивом.
 * \* Параметры → `filter`:
 	* \* Оператор «равно» изменён на `==` с `::` (с обратной совместимостью).
@@ -73,6 +90,7 @@
 
 
 ## Версия 3.4 (2018-11-14)
+
 * \+ Параметры → `placeholders`:
 	* \+ Добавлена поддержка массивов
 	* \+ Добавлена поддержка формата JSON.
@@ -83,6 +101,7 @@
 
 
 ## Версия 3.3 (2016-06-06)
+
 * \+ Параметры → `outerTpl`, `rowTpl`, `colTpl`: Добавлена возможность использовать встроенные шаблоны, используя префикс `'@CODE:'`.
 * \+ Параметры → `rowTpl`, `colTpl`: Дополнительные данные из параметра `placeholders` теперь также будут переданы в шаблоны строк и колонок.
 * \* Параметры → `placeholders`: Дополнительные данные, передаваемые в параметр `placeholders` должны быть в виде Query string (старый формат поддерживается, но не рекомендуется к использвоанию).
@@ -94,6 +113,7 @@
 
 
 ## Версия 3.2 (2015-06-23)
+
 * \+ Параметры → `colTpl:` Плэйсхолдер `[+rowNumber+]` также доступен в шаблонах колонок.
 * \+ Параметры → `rowTpl`, `colTpl`: Доступен довый плэйсхолдер `[+rowNumber.zeroBased+]` — номер строки, начинающийся с 0, это бывает удобно.
 * \* Рефакторинг:
@@ -104,10 +124,12 @@
 
 
 ## Версия 3.1 (2014-07-03)
+
 * \+ Параметры → `outputFormat`: Добавлен формат вывода `htmlarray` — одномерный массив, элементы которого — готовые полностью обработанные строки. Как и `array`, имеет смысл использовать вместе с параметром `resultToPlaceholder`.
 
 
 ## Версия 3.0b (2014-03-02)
+
 * \* Внимание! Требуется (MODX)EvolutionCMS.libraries.ddTools >= 0.11.
 * \* Вместо локальной функции для сортировки используется метод `\ddTools:sort2dArray`.
 * \* Значение поля получается при помощи метода `\ddTools:getTemplateVarOutput`, (MODX)EvolutionCMS.snippets.ddGetDocumentField больше не используется.
@@ -143,6 +165,7 @@
 
 
 ## Версия 2.18 (2013-11-11)
+
 * \* Внимание! Требуется (MODX)EvolutionCMS.libraries.ddTools >= 0.10.
 * \+ Параметры → `tplWrap`, `tplY`: Добавлен плэйсхолдер `[+resultTotal+]`, содержащий количество **возвращаемых** элементов.
 * \* Параметры → `tplWrap`:
@@ -153,18 +176,22 @@
 
 
 ## Версия 2.17 (2013-09-18)
+
 * \+ Параметры → `vals`: Добавлена фильтрация по всем колонкам.
 
 
 ## Версия 2.16.2 (2013-07-11)
+
 * \* При сортировке добавлена обработка числовых значений, теперь они сравниваются как числа, а не как строки.
 
 
 ## Версия 2.16.1 (2013-06-13)
+
 * \* Исправлена ошибка с обращением к не объявленным переменным (PHP >= 5.3).
 
 
 ## Версия 2.16 (2013-03-28)
+
 * \* Внимание! Требуется (MODX)EvolutionCMS.snippets.ddGetDocumentField >= 2.4.
 * \+ Параметры → `tplWrap`: Плэйсхолдер `[+total+]` теперь выводится и здесь.
 * \+ Параметры → `splY`, `splX`: Теперь могут принимать регулярные выражения.
@@ -174,16 +201,19 @@
 
 
 ## Версия 2.15 (2013-02-11)
+
 * \+ Параметры → `totalPlaceholder`: Новый параметр. Добавлена возможность выводить общее количество строк во внешний плэйсхолдер.
 
 
 ## Версия 2.14 (2013-01-10)
+
 * \+ Параметры → `tplY`: Добавлен плэйсхолдер `[+total+]`, содержащий общее количество строк.
 
 
 ## Версия 2.13 (2012-09-03)
+
 * \+ Параметры → `sortDir`: Добавлено возможное значение `'REVERSE'`, при котором значения выводятся просто в обратном порядке.
 
 
-<link rel="stylesheet" type="text/css" href="https://DivanDesign.ru/assets/files/ddMarkdown.css" />
+<link rel="stylesheet" type="text/css" href="https://raw.githack.com/DivanDesign/CSS.ddMarkdown/master/style.min.css" />
 <style>ul{list-style:none;}</style>