Version 4.9

Author: Ronef

CHANGELOG.md

@@ -1,6 +1,16 @@
 # (MODX)EvolutionCMS.plugins.ManagerManager.mm_ddMultipleFields changelog
 
 
+## Version 4.9 (2022-05-26)
+* \+ Parameters → `$params->columns[i]['alias']`:
+	* \+ The new optional parameter. Provides the ability to set a custom result key for each column instead of simple numeric index.
+	* \+ The widget also supports changing indexes to aliases for TVs already filled with existing values.
+* \* Missed icon in the “add” button has been fixed. Many thanks to @byscrimm.
+* \+ Composer.json:
+	* \+ `support` → `chat`.
+	* \+ `authors` → author → `homepage`.
+
+
 ## Version 4.8.6 (2021-10-04)
 * \* Improved working with deprecated `id` columns.
 * \* Improved working with invalid JSON field values.

CHANGELOG_ru.md

@@ -1,6 +1,16 @@
 # (MODX)EvolutionCMS.plugins.ManagerManager.mm_ddMultipleFields changelog
 
 
+## Версия 4.9 (2022-05-26)
+* \+ Параметры → `$params->columns[i]['alias']`:
+	* \+ Новый необязательный параметр. Обеспечивает возможность задать произвольный ключ каждой колонки в результатах вместо простого нумерованного индекса.
+	* \+ Виджет также поддерживает изменение индексов на псевдонимы для TV, уже заполненных существующими значениями.
+* \* Исправлено отображение иконки на кнопке «Добавить». Большое спасибо @byscrimm.
+* \+ Composer.json:
+	* \+ `support` → `chat`.
+	* \+ `authors` → author → `homepage`.
+
+
 ## Версия 4.8.6 (2021-10-04)
 * \* Улучшена работа с устаревшими колонками типа `id`.
 * \* Улучшена работа с невалидным JSON в значении полей.

README.md

@@ -17,10 +17,7 @@ Capabilities:
 * [(MODX)EvolutionCMS.plugins.ManagerManager](https://code.divandesign.biz/modx/managermanager) >= 0.7
 
 
-## Documentation
-
-
-### Installation
+## Installation
 
 To install you must unzip the archive to `/assets/plungins/managermanager/widgets/ddmultiplefields/`.
 
@@ -34,7 +31,7 @@ You may also read this documentation:
 Type of TV must be `textarea`.
 
 
-### Parameters description
+## Parameters description
 
 * `$params`
 	* Desctription: Parameters, the pass-by-name style is used.
@@ -75,6 +72,11 @@ Type of TV must be `textarea`.
 	* Valid values: `string`
 	* Default value: `''`
 
+* `$params->columns[i]['alias']`
+	* Desctription: An unique column alias. If empty, just numeric index will be used.
+	* Valid values: `string`
+	* Default value: —
+	
 * `$params->columns[i]['width']`
 	* Desctription: Column width, px.
 	* Valid values: `integer`
@@ -147,43 +149,43 @@ Type of TV must be `textarea`.
 	* **Required**
 
 
-### CMS events
+## CMS events
 
 * `OnDocFormPrerender`
 * `OnDocFormRender`
 
 
-### Output format
+## Output format
 
 The widget saves value to a TV as JSON object with the following structure:
 
 ```json
 {
 	"1590412453247": {
 		"0": "First row, first column value",
-		"1": "First row, second column value"
+		"customAlias": "First row, second column value"
 	},
 	"1590412497589": {
 		"0": "Second row, first column value",
-		"1": "Second row, Second column value"
+		"customAlias": "Second row, Second column value"
 	}
 }
 ```
 
 Where:
 * `1590412453247`, `1590412497589` — the unique auto generated row IDs (JS `(new Date).getTime()` is used while creating rows).
-* `0`, `1` — column numbers.
+* `0`, `customAlias` — column index or alias (if set).
 
 Rows objects with empty column values will not be saved.
 If all columns and all rows are empty, an empty string (`''`) will be saved instead of an empty JSON ojbect (`'{}'`).
 
 It is strongly recommend to use [(MODX)EvolutionCMS.snippets.ddGetMultipleField](https://code.divandesign.biz/modx/ddgetmultiplefield) >= 3.5 for rendering TVs on site.
 
 
-### Examples
+## Examples
 
 
-#### Make the TV `someImages` available for adding several number of images
+### Make the TV `someImages` available for adding several number of images
 
 Create the TV `someImages`, set it's type equal to `textarea`.
 
@@ -200,7 +202,7 @@ mm_ddMultipleFields([
 ```
 
 
-#### Create 2 columns: images with titles
+### Create 2 columns: images with titles
 
 ```php
 mm_ddMultipleFields([
@@ -219,7 +221,50 @@ mm_ddMultipleFields([
 ```
 
 
-#### Table of employees contacts
+### Using column aliases (`$params->columns[i]['alias']`)
+
+```php
+mm_ddMultipleFields([
+	'fields' => 'photos',
+	'columns' => [
+		[
+			'type' => 'image',
+			'title' => 'Photo',
+			'alias' => 'src'
+		],
+		[
+			'type' => 'text',
+			'title' => 'Title'
+			'alias' => 'alt'
+		],
+		//In the same time we can use columns without aliases, numeric index will be used in this case
+		[
+			'type' => 'textarea'
+			'title' => 'Notes'
+		]
+	]
+]);
+```
+
+Will be save something like this:
+
+```json
+{
+	"1590412453247": {
+		"src": "assets/images/ElonMusk.jpg",
+		"alt": "Elon Reeve Musk",
+		"2": "Business magnate and investor"
+	},
+	"1590412497589": {
+		"src": "assets/images/YuryDud.jpg",
+		"alt": "Yury Aleksandrovich Dud",
+		"2": "Russian journalist and YouTuber"
+	}
+}
+```
+
+
+### Table of employees contacts
 
 Create the TV `employees`, set it's type equal to `textarea`.
 
@@ -251,7 +296,7 @@ mm_ddMultipleFields([
 ```
 
 
-#### `<select>` column type
+### `<select>` column type
 
 ```php
 mm_ddMultipleFields([

README_ru.md

@@ -17,10 +17,7 @@
 * [(MODX)EvolutionCMS.plugins.ManagerManager](https://code.divandesign.ru/modx/managermanager) >= 0.7
 
 
-## Документация
-
-
-### Установка
+## Установка
 
 Для установки распакуйте архив в `/assets/plungins/managermanager/widgets/ddmultiplefields/`.
 
@@ -34,7 +31,7 @@
 Тип TV, к которой применяется виджет, должен быть `textarea`.
 
 
-### Описание параметров
+## Описание параметров
 
 * `$params`
 	* Описание: Параметры, используется стиль именованных параметров.
@@ -75,6 +72,11 @@
 	* Допустимые значения: `string`
 	* Значение по умолчанию: `''`
 
+* `$params->columns[i]['alias']`
+	* Описание: Псевдоним колонки (должен быть уникальным в пределах поля). Если не задан, будет использован обычный нумерованный индекс.
+	* Допустимые значения: `string`
+	* Значение по умолчанию: —
+	
 * `$params->columns[i]['width']`
 	* Описание: Ширина колонки в px.
 	* Допустимые значения: `integer`
@@ -147,43 +149,43 @@
 	* **Required**
 
 
-### События CMS
+## События CMS
 
 * `OnDocFormPrerender`
 * `OnDocFormRender`
 
 
-### Формат вывода
+## Формат вывода
 
 Виджет сохраняет значение в TV в виде объекта JSON со следующей структурой:
 
 ```json
 {
 	"1590412453247": {
 		"0": "First row, first column value",
-		"1": "First row, second column value"
+		"customAlias": "First row, second column value"
 	},
 	"1590412497589": {
 		"0": "Second row, first column value",
-		"1": "Second row, Second column value"
+		"customAlias": "Second row, Second column value"
 	}
 }
 ```
 
 Где:
 * `1590412453247`, `1590412497589` — уникальные автоматически сгенерированные ID строк (используется `(new Date).getTime()` в JS при создании строк).
-* `0`, `1` — номера колонок.
+* `0`, `customAlias` — индекс или псевдоним (если задан) колонки.
 
 Объекты строк с пустыми значениями колонок не будут сохранены.
 Если все строки и все колонки пустые, будет сохранена пустая строка (`''`) вместо пустого JSON объекта (`'{}'`).
 
 Настоятельно рекомендуется использовать [(MODX)EvolutionCMS.snippets.ddGetMultipleField](https://code.divandesign.ru/modx/ddgetmultiplefield) >= 3.5 для вывода TV на сайте.
 
 
-### Примеры
+## Примеры
 
 
-#### Сделать возможность добавления нескольких изобрежний в TV `someImages`
+### Сделать возможность добавления нескольких изобрежний в TV `someImages`
 
 Создаём TV `someImages`, выставляем тип `textarea`.
 
@@ -200,7 +202,7 @@ mm_ddMultipleFields([
 ```
 
 
-#### Создать 2 колонки: изображения и заголовки
+### Создать 2 колонки: изображения и заголовки
 
 ```php
 mm_ddMultipleFields([
@@ -219,7 +221,50 @@ mm_ddMultipleFields([
 ```
 
 
-#### Таблица контактов сотрудников
+### Использование псеводнимов колонок (`$params->columns[i]['alias']`)
+
+```php
+mm_ddMultipleFields([
+	'fields' => 'photos',
+	'columns' => [
+		[
+			'type' => 'image',
+			'title' => 'Фото',
+			'alias' => 'src'
+		],
+		[
+			'type' => 'text',
+			'title' => 'Подпись'
+			'alias' => 'alt'
+		],
+		//И здесь же мы можем задавать колонки без псевдонимов, в этом случае будет просто использован нумерованный индекс
+		[
+			'type' => 'textarea'
+			'title' => 'Заметки'
+		]
+	]
+]);
+```
+
+Сохранит что-то такое:
+
+```json
+{
+	"1590412453247": {
+		"src": "assets/images/ElonMusk.jpg",
+		"alt": "Илон Рив Маск",
+		"2": "Бизнес-магнат и инвестор"
+	},
+	"1590412497589": {
+		"src": "assets/images/YuryDud.jpg",
+		"alt": "Юрий Александрович Дудь",
+		"2": "Российский журналист и Ютубер"
+	}
+}
+```
+
+
+### Таблица контактов сотрудников
 
 Создаём TV `employees`, выставляем тип `textarea`.
 
@@ -251,7 +296,7 @@ mm_ddMultipleFields([
 ```
 
 
-#### Колонка типа `<select>`
+### Колонка типа `<select>`
 
 ```php
 mm_ddMultipleFields([

composer.json

@@ -1,6 +1,6 @@
 {
 	"name": "dd/evolutioncms-plugins-managermanager-mm_ddmultiplefields",
-	"version": "4.8.6",
+	"version": "4.9.0",
 	"description": "Widget for plugin ManagerManager that allows you to add any number of fields values (TV) in one document (values are written in field as a JSON object). For example: a few images.",
 	"keywords": [
 		"modx",
@@ -20,6 +20,9 @@
 		"multiple field"
 	],
 	"homepage": "https://code.divandesign.biz/modx/mm_ddmultiplefields",
+	"support": {
+		"chat": "https://t.me/dd_code"
+	},
 	"authors": [
 		{
 			"name": "DD Group",
@@ -36,22 +39,27 @@
 		{
 			"name": "Alexey Davydov",
 			"email": "davalemic@DivanDesign.ru",
+			"homepage": "https://github.com/davalemic",
 			"role": "Developer"
 		},
 		{
 			"name": "Vladislav Lavrov",
+			"homepage": "https://github.com/Tornek",
 			"role": "Developer"
 		},
 		{
 			"name": "Andrey Demchenko",
+			"homepage": "https://github.com/deversjkee",
 			"role": "Developer"
 		},
 		{
 			"name": "Andrey Dunaev",
+			"homepage": "https://github.com/svolochev",
 			"role": "Developer"
 		},
 		{
 			"name": "Pavel Unzhakov",
+			"homepage": "https://github.com/psthmn",
 			"role": "Developer"
 		}
 	],

ddmultiplefields.css

@@ -66,6 +66,9 @@
 	vertical-align: middle;
 	text-align: center;
 }
+.ddMultipleField tr td.ddMultipleField_row_col:last-child button.fa-plus {
+	font-weight: 900;
+}
 
 .ddMultipleField tr td.ddSortHandle {
 	border-right: none;