← All changes | backend/src/Factory/Field/FieldFactory.php +126 -14 0.8.2 → 1.5 View file →

		@@ -1,19 +1,16 @@
1	1	<?php
2	2
3	3	namespace IvyForms\Factory\Field;
4	4
5		-// phpcs:disable PSR1.Files.SideEffects
6		-if (!defined('ABSPATH')) {
7		- exit; // Exit if accessed directly
8		-}
9		-
10	5	use IvyForms\Common\Exceptions\ValidationException;
	6	+use IvyForms\Common\Helpers\NameFieldKeyHelper;
11	7	use IvyForms\Entity\Field\Field as FieldEntity;
12	8	use IvyForms\ValueObjects\Field\Field;
13	9	use IvyForms\ValueObjects\Field\FieldGeneralSettings;
14	10	use IvyForms\ValueObjects\Field\FieldOptions;
15	11	use IvyForms\ValueObjects\Field\FieldAdvancedSettings;
	12	+use IvyForms\ValueObjects\Field\FileUploadFieldAdvancedSettings;
16	13	use IvyForms\ValueObjects\Field\ConfirmationGeneralSettings;
17	14	use IvyForms\ValueObjects\Field\TimeFieldGeneralSettings;
18	15	use IvyForms\ValueObjects\Field\DateFieldGeneralSettings;
19	16
		@@ -32,9 +29,9 @@
32	29	* @throws ValidationException
33	30	*/
34	31	public static function create(array $data): FieldEntity
35	32	{
36		- $settings = isset($data['settings']) ? json_decode($data['settings'], true) : [];
	33	+ $settings = self::parseSettings($data['settings'] ?? null);
37	34
38	35	if (!empty($settings)) {
39	36	$data['hideLabel'] = $settings['hideLabel'] ?? false;
40	37	$data['readOnly'] = $settings['readOnly'] ?? false;
		@@ -41,8 +38,9 @@
41	38	$data['description'] = $settings['description'] ?? '';
42	39	$data['requiredMessage'] = $settings['requiredMessage'] ?? '';
43	40	$data['cssClasses'] = $settings['cssClasses'] ?? '';
44	41	$data['limitMaxLength'] = $settings['limitMaxLength'] ?? false;
	42	+ $data['limitRange'] = $settings['limitRange'] ?? false;
45	43	$data['maxLength'] = $settings['maxLength'] ?? 255;
46	44	$data['labelPosition'] = $settings['labelPosition'] ?? 'default';
47	45	$data['noDuplicates'] = $settings['noDuplicates'] ?? false;
48	46	$data['shuffleOptions'] = $settings['shuffleOptions'] ?? false;
		@@ -57,13 +55,16 @@
57	55	$data['phoneAutoDetect'] = $settings['phoneAutoDetect'] ?? false;
58	56	$data['minValue'] = $settings['minValue'] ?? null;
59	57	$data['maxValue'] = $settings['maxValue'] ?? null;
60	58	$data['step'] = $settings['step'] ?? 1;
	59	+ $data['showGrid'] = $settings['showGrid'] ?? false;
61	60	$data['numberFormat'] = $settings['numberFormat'] ?? '';
62	61	$data['inputPrefix'] = $settings['inputPrefix'] ?? '';
63	62	$data['inputSuffix'] = $settings['inputSuffix'] ?? '';
64	63	$data['timeFieldType'] = $settings['timeFieldType'] ?? '';
65	64	$data['timeFormat'] = $settings['timeFormat'] ?? '';
	65	+ $data['minTimeValue'] = $settings['minTimeValue'] ?? '';
	66	+ $data['maxTimeValue'] = $settings['maxTimeValue'] ?? '';
66	67	$data['dateFieldType'] = $settings['dateFieldType'] ?? '';
67	68	$data['dateFormat'] = $settings['dateFormat'] ?? '';
68	69	$data['minDateValue'] = $settings['minDateValue'] ?? '';
69	70	$data['maxDateValue'] = $settings['maxDateValue'] ?? '';
		@@ -68,8 +69,19 @@
68	69	$data['minDateValue'] = $settings['minDateValue'] ?? '';
69	70	$data['maxDateValue'] = $settings['maxDateValue'] ?? '';
70	71	$data['showRatingText'] = $settings['showRatingText'] ?? false;
71	72	$data['ratingIcon'] = $settings['ratingIcon'] ?? 'star';
	73	+ $data['htmlContent'] = $settings['htmlContent'] ?? '';
	74	+ $data['agreementText'] = $settings['agreementText'] ?? '';
	75	+ $data['limitDateRange'] = $settings['limitDateRange'] ?? false;
	76	+ $data['limitTimeRange'] = $settings['limitTimeRange'] ?? false;
	77	+ $data['maxFileSizeMb'] = isset($settings['maxFileSizeMb']) ? (int) $settings['maxFileSizeMb'] : 0;
	78	+ $data['saveUploadsTo'] = isset($settings['saveUploadsTo'])
	79	+ ? (string) $settings['saveUploadsTo']
	80	+ : 'ivyforms';
	81	+ if (!array_key_exists('allowedFileExtensions', $data) && isset($settings['allowedFileExtensions'])) {
	82	+ $data['allowedFileExtensions'] = $settings['allowedFileExtensions'];
	83	+ }
72	84	// Grid layout: prioritize direct database columns over settings JSON
73	85	// This ensures backward compatibility while preferring the dedicated columns
74	86	$data['rowIndex'] = $data['rowIndex'] ?? ($settings['rowIndex'] ?? 0);
75	87	$data['columnIndex'] = $data['columnIndex'] ?? ($settings['columnIndex'] ?? 0);
		@@ -79,10 +91,34 @@
79	91	: true;
80	92	if ($data['visible'] === null) {
81	93	$data['visible'] = true;
82	94	}
	95	+ if (isset($settings['nameFieldType'])) {
	96	+ $data['nameFieldType'] = (string)$settings['nameFieldType'];
	97	+ }
	98	+ if (array_key_exists('subFieldIndex', $settings)) {
	99	+ $data['subFieldIndex'] = is_numeric($settings['subFieldIndex'])
	100	+ ? (int)$settings['subFieldIndex']
	101	+ : null;
	102	+ }
83	103	}
84	104
	105	+ if (isset($data['nameFieldType'])) {
	106	+ $data['nameFieldType'] = (string)$data['nameFieldType'];
	107	+ }
	108	+ if (array_key_exists('subFieldIndex', $data)) {
	109	+ $data['subFieldIndex'] = is_numeric($data['subFieldIndex'])
	110	+ ? (int)$data['subFieldIndex']
	111	+ : null;
	112	+ }
	113	+
	114	+ if (empty($data['nameFieldType'])) {
	115	+ $inferredNameFieldType = NameFieldKeyHelper::inferNameFieldKeyFromLabel($data['label'] ?? '');
	116	+ if ($inferredNameFieldType !== null) {
	117	+ $data['nameFieldType'] = $inferredNameFieldType;
	118	+ }
	119	+ }
	120	+
85	121	/**
86	122	* Allows modification of the settings data before creating the Field entity.
87	123	* This filter runs for both:
88	124	* - Fields loaded from database (settings from JSON string)
		@@ -93,8 +129,9 @@
93	129	* @param mixed[] $settings The settings array (from database or empty for API).
94	130	* @return mixed[] The modified field data.
95	131	*/
96	132	$data = apply_filters('ivyforms/field/factory/extract_settings', $data, $settings);
	133	+
97	134	$generalSettings = new FieldGeneralSettings(
98	135	self::validateString($data['label'] ?? '', 255, 'label'),
99	136	self::validateBool($data['required'] ?? false),
100	137	self::validateString($data['placeholder'] ?? '', 255, 'placeholder'),
		@@ -99,9 +136,9 @@
99	136	self::validateBool($data['required'] ?? false),
100	137	self::validateString($data['placeholder'] ?? '', 255, 'placeholder'),
101	138	self::validateBool($data['hideLabel'] ?? false),
102	139	self::validateBool($data['readOnly'] ?? false),
103		- self::validateString($data['description'] ?? '', 255, 'description'),
	140	+ self::validateString($data['description'] ?? '', 1000, 'description'),
104	141	self::validateString($data['requiredMessage'] ?? '', 255, 'requiredMessage'),
105	142	self::validateString($data['cssClasses'] ?? '', 255, 'cssClasses'),
106	143	self::validateBool($data['shuffleOptions'] ?? false),
107	144	self::validateBool($data['showValues'] ?? false),
		@@ -110,8 +147,9 @@
110	147	self::validateBool($data['phoneAutoDetect'] ?? false),
111	148	self::validateNumberValue($data['minValue'] ?? null, 'minValue'),
112	149	self::validateNumberValue($data['maxValue'] ?? null, 'maxValue'),
113	150	self::validateStep($data['step'] ?? 1),
	151	+ self::validateBool($data['showGrid'] ?? false),
114	152	self::validateNumberFormat($data['numberFormat'] ?? ''),
115	153	new ConfirmationGeneralSettings(
116	154	self::validateBool($data['confirmFieldEnabled'] ?? false),
117	155	self::validateString(
		@@ -126,24 +164,33 @@
126	164	),
127	165	self::validateBool($data['confirmFieldHideLabel'] ?? false)
128	166	),
129	167	new TimeFieldGeneralSettings(
	168	+ self::validateBool($data['limitTimeRange'] ?? false),
130	169	self::validateString($data['timeFieldType'] ?? '', 50, 'timeFieldType'),
131		- self::validateString($data['timeFormat'] ?? '', 50, 'timeFormat')
	170	+ self::validateString($data['timeFormat'] ?? '', 50, 'timeFormat'),
	171	+ isset($data['minTimeValue']) && $data['minTimeValue'] !== '' ?
	172	+ self::validateString($data['minTimeValue'], 255, 'minTimeValue') : null,
	173	+ isset($data['maxTimeValue']) && $data['maxTimeValue'] !== '' ?
	174	+ self::validateString($data['maxTimeValue'], 255, 'maxTimeValue') : null,
132	175	),
133	176	new DateFieldGeneralSettings(
	177	+ self::validateBool($data['limitDateRange'] ?? false),
134	178	self::validateString($data['dateFieldType'] ?? '', 50, 'dateFieldType'),
135	179	self::validateString($data['dateFormat'] ?? '', 50, 'dateFormat'),
136	180	isset($data['minDateValue']) && $data['minDateValue'] !== '' ?
137	181	self::validateString($data['minDateValue'], 255, 'minDateValue') : null,
138	182	isset($data['maxDateValue']) && $data['maxDateValue'] !== '' ?
139		- self::validateString($data['maxDateValue'], 255, 'maxDateValue') : null
	183	+ self::validateString($data['maxDateValue'], 255, 'maxDateValue') : null,
140	184	),
141	185	self::validateBool($data['showRatingText'] ?? false),
142		- self::validateBool($data['visible'] ?? true)
	186	+ self::validateBool($data['visible'] ?? true),
	187	+ self::validateString($data['htmlContent'] ?? '', 4294967295, 'htmlContent'),
	188	+ self::validateString($data['agreementText'] ?? '', 1000, 'agreementText'),
	189	+ self::validateBool($data['limitRange'] ?? false),
143	190	);
144	191	$advancedSettings = new FieldAdvancedSettings(
145		- self::validateString($data['defaultValue'] ?? '', 255, 'defaultValue'),
	192	+ self::resolveDefaultValue($data),
146	193	self::validateBool($data['limitMaxLength'] ?? false),
147	194	(int)($data['maxLength'] ?? 255),
148	195	self::validateString($data['labelPosition'] ?? '', 255, 'labelPosition'),
149	196	self::validateBool($data['noDuplicates'] ?? false),
		@@ -148,9 +195,16 @@
148	195	self::validateString($data['labelPosition'] ?? '', 255, 'labelPosition'),
149	196	self::validateBool($data['noDuplicates'] ?? false),
150	197	self::validateString($data['inputPrefix'] ?? '', 255, 'inputPrefix'),
151	198	self::validateString($data['inputSuffix'] ?? '', 255, 'inputSuffix'),
152		- self::validateString($data['ratingIcon'] ?? 'star', 50, 'ratingIcon')
	199	+ self::validateString($data['ratingIcon'] ?? 'star', 50, 'ratingIcon'),
	200	+ new FileUploadFieldAdvancedSettings(
	201	+ (int) ($data['maxFileSizeMb'] ?? 0),
	202	+ (string) ($data['saveUploadsTo'] ?? 'ivyforms'),
	203	+ is_array($data['allowedFileExtensions'] ?? null)
	204	+ ? $data['allowedFileExtensions']
	205	+ : []
	206	+ )
153	207	);
154	208	$fieldOptions = new FieldOptions($data['options'] ?? []);
155	209
156	210	$fieldObject = new Field(
		@@ -165,9 +219,10 @@
165	219	$data['parentId'] ?? null,
166	220	$data['rows'] ?? 0,
167	221	$data['rowIndex'] ?? 0,
168	222	$data['columnIndex'] ?? 0,
169		- $data['width'] ?? 100
	223	+ $data['width'] ?? 100,
	224	+ $data['pageId'] ?? null
170	225	);
171	226
172	227	/**
173	228	* Allows setting of additional properties for the Field value object.
		@@ -204,8 +259,12 @@
204	259	if (isset($data['parentId'])) {
205	260	$field->setParentId($data['parentId']);
206	261	}
207	262
	263	+ if (isset($data['pageId'])) {
	264	+ $field->setPageId($data['pageId']);
	265	+ }
	266	+
208	267	if (isset($data['rows'])) {
209	268	$field->setRows((int)$data['rows']);
210	269	}
211	270
		@@ -216,12 +275,40 @@
216	275	* @param FieldEntity $field The current field data.
217	276	* @param mixed[] $data The settings array from the database.
218	277	* @return mixed[] The modified field data.
219	278	*/
220		- return apply_filters('ivyforms/field/entity/set_properties', $field, $data);
	279	+ $field = apply_filters('ivyforms/field/entity/set_properties', $field, $data);
	280	+
	281	+ if (!empty($data['nameFieldType'])) {
	282	+ $field->setAdditionalProperty('nameFieldType', (string)$data['nameFieldType']);
	283	+ }
	284	+ if (array_key_exists('subFieldIndex', $data) && $data['subFieldIndex'] !== null) {
	285	+ $field->setAdditionalProperty('subFieldIndex', (int)$data['subFieldIndex']);
	286	+ }
	287	+
	288	+ return $field;
221	289	}
222	290
223	291	/**
	292	+ * @param mixed $rawSettings
	293	+ * @return array<string, mixed>
	294	+ */
	295	+ private static function parseSettings($rawSettings): array
	296	+ {
	297	+ if (is_array($rawSettings)) {
	298	+ return $rawSettings;
	299	+ }
	300	+
	301	+ if (!is_string($rawSettings) || $rawSettings === '') {
	302	+ return [];
	303	+ }
	304	+
	305	+ $decoded = json_decode($rawSettings, true);
	306	+
	307	+ return is_array($decoded) ? $decoded : [];
	308	+ }
	309	+
	310	+ /**
224	311	* Validate and convert a value to boolean.
225	312	*
226	313	* @param mixed $value The value to validate.
227	314	*
		@@ -229,8 +316,33 @@
229	316	*/
230	317	private static function validateBool($value): bool
231	318	{
232	319	return (bool)$value;
	320	+ }
	321	+
	322	+ /**
	323	+ * Resolve and validate field default value (Pro may override for rich_text, etc.).
	324	+ *
	325	+ * @param array<string, mixed> $data
	326	+ *
	327	+ * @return string
	328	+ *
	329	+ * @throws ValidationException
	330	+ */
	331	+ private static function resolveDefaultValue(array $data): string
	332	+ {
	333	+ $filtered = apply_filters(
	334	+ 'ivyforms/field/validate_default_value',
	335	+ null,
	336	+ $data['defaultValue'] ?? '',
	337	+ $data
	338	+ );
	339	+
	340	+ if (is_string($filtered)) {
	341	+ return $filtered;
	342	+ }
	343	+
	344	+ return self::validateString($data['defaultValue'] ?? '', 255, 'defaultValue');
233	345	}
234	346
235	347	/**
236	348	* Validate a string's length.