feat(url): add URL field type

lib/Enum/FieldType.php

@@ -14,6 +14,7 @@ enum FieldType: string {
 	case NUMBER = 'number';
 	case BOOLEAN = 'boolean';
 	case DATE = 'date';
+	case URL = 'url';
 	case SELECT = 'select';
 	case MULTISELECT = 'multiselect';
 
@@ -26,6 +27,7 @@ public static function values(): array {
 			self::NUMBER->value,
 			self::BOOLEAN->value,
 			self::DATE->value,
+			self::URL->value,
 			self::SELECT->value,
 			self::MULTISELECT->value,
 		];

lib/ResponseDefinitions.php

@@ -10,7 +10,7 @@
 namespace OCA\ProfileFields;
 
 /**
- * @psalm-type ProfileFieldsType = 'text'|'number'|'boolean'|'date'|'select'|'multiselect'
+ * @psalm-type ProfileFieldsType = 'text'|'number'|'boolean'|'date'|'url'|'select'|'multiselect'
  * @psalm-type ProfileFieldsVisibility = 'private'|'users'|'public'
  * @psalm-type ProfileFieldsEditPolicy = 'admins'|'users'
  * @psalm-type ProfileFieldsExposurePolicy = 'hidden'|'private'|'users'|'public'

lib/Service/DataImportService.php

@@ -69,7 +69,7 @@ public function import(array $payload, bool $dryRun = false): array {
 	 * @param list<array{
 	 *     field_key: non-empty-string,
 	 *     label: non-empty-string,
-	 *     type: 'text'|'number'|'boolean'|'date'|'select'|'multiselect',
+	 *     type: 'text'|'number'|'boolean'|'date'|'url'|'select'|'multiselect',
 	 *     edit_policy: 'admins'|'users',
 	 *     exposure_policy: 'hidden'|'private'|'users'|'public',
 	 *     sort_order: int,
@@ -148,7 +148,7 @@ private function collectValueSummary(array $values, array &$summary): void {
 	 * @param list<array{
 	 *     field_key: non-empty-string,
 	 *     label: non-empty-string,
-	 *     type: 'text'|'number'|'boolean'|'date'|'select'|'multiselect',
+	 *     type: 'text'|'number'|'boolean'|'date'|'url'|'select'|'multiselect',
 	 *     edit_policy: 'admins'|'users',
 	 *     exposure_policy: 'hidden'|'private'|'users'|'public',
 	 *     sort_order: int,
@@ -248,7 +248,7 @@ private function persistValues(array $values, array $definitionsByFieldKey, arra
 	 * @param array{
 	 *     field_key: non-empty-string,
 	 *     label: non-empty-string,
-	 *     type: 'text'|'number'|'boolean'|'date'|'select'|'multiselect',
+	 *     type: 'text'|'number'|'boolean'|'date'|'url'|'select'|'multiselect',
 	 *     edit_policy: 'admins'|'users',
 	 *     exposure_policy: 'hidden'|'private'|'users'|'public',
 	 *     sort_order: int,

lib/Service/FieldDefinitionValidator.php

@@ -29,7 +29,7 @@ class FieldDefinitionValidator {
 	 * @return array{
 	 *     field_key: non-empty-string,
 	 *     label: non-empty-string,
-	 *     type: 'text'|'number'|'boolean'|'date'|'select'|'multiselect',
+	 *     type: 'text'|'number'|'boolean'|'date'|'url'|'select'|'multiselect',
 	 *     edit_policy: 'admins'|'users',
 	 *     exposure_policy: 'hidden'|'private'|'users'|'public',
 	 *     sort_order: int,

lib/Service/FieldValueService.php

@@ -108,6 +108,7 @@ public function normalizeValue(FieldDefinition $definition, array|string|int|flo
 			FieldType::NUMBER => $this->normalizeNumberValue($rawValue),
 			FieldType::BOOLEAN => $this->normalizeBooleanValue($rawValue),
 			FieldType::DATE => $this->normalizeDateValue($rawValue),
+			FieldType::URL => $this->normalizeUrlValue($rawValue),
 			FieldType::SELECT => $this->normalizeSelectValue($rawValue, $definition),
 			FieldType::MULTISELECT => $this->normalizeMultiSelectValue($rawValue, $definition),
 		};
@@ -349,6 +350,23 @@ private function normalizeDateValue(array|string|int|float|bool $rawValue): arra
 		return ['value' => $value];
 	}
 
+	/**
+	 * @param array<string, mixed>|scalar $rawValue
+	 * @return array{value: string}
+	 */
+	private function normalizeUrlValue(array|string|int|float|bool $rawValue): array {
+		if (!is_string($rawValue)) {
+			throw new InvalidArgumentException($this->l10n->t('URL fields require a valid URL.'));
+		}
+
+		$value = trim($rawValue);
+		if (filter_var($value, FILTER_VALIDATE_URL) === false) {
+			throw new InvalidArgumentException($this->l10n->t('URL fields require a valid URL.'));
+		}
+
+		return ['value' => $value];
+	}
+
 	/**
 	 * @param array<string, mixed> $value
 	 */

lib/Service/ImportPayloadValidator.php

@@ -32,7 +32,7 @@ public function __construct(
 	 *     definitions: list<array{
 	 *         field_key: non-empty-string,
 	 *         label: non-empty-string,
-	 *         type: 'text'|'number'|'boolean'|'date'|'select'|'multiselect',
+	 *     type: 'text'|'number'|'boolean'|'date'|'url'|'select'|'multiselect',
 	 *         edit_policy: 'admins'|'users',
 	 *         exposure_policy: 'hidden'|'private'|'users'|'public',
 	 *         sort_order: int,
@@ -71,7 +71,7 @@ public function validate(array $payload): array {
 	 * @return array<non-empty-string, array{
 	 *     field_key: non-empty-string,
 	 *     label: non-empty-string,
-	 *     type: 'text'|'number'|'boolean'|'date'|'select'|'multiselect',
+	 *     type: 'text'|'number'|'boolean'|'date'|'url'|'select'|'multiselect',
 	 *     edit_policy: 'admins'|'users',
 	 *     exposure_policy: 'hidden'|'private'|'users'|'public',
 	 *     sort_order: int,
@@ -119,7 +119,7 @@ private function validateDefinitions(array $definitions): array {
 	 * @param array<non-empty-string, array{
 	 *     field_key: non-empty-string,
 	 *     label: non-empty-string,
-	 *     type: 'text'|'number'|'boolean'|'date'|'select'|'multiselect',
+	 *     type: 'text'|'number'|'boolean'|'date'|'url'|'select'|'multiselect',
 	 *     edit_policy: 'admins'|'users',
 	 *     exposure_policy: 'hidden'|'private'|'users'|'public',
 	 *     sort_order: int,
@@ -255,7 +255,7 @@ private function normalizeOptionalDate(array $payload, string $key, string $mess
 	 * @param array{
 	 *     field_key: non-empty-string,
 	 *     label: non-empty-string,
-	 *     type: 'text'|'number'|'boolean'|'date'|'select'|'multiselect',
+	 *     type: 'text'|'number'|'boolean'|'date'|'url'|'select'|'multiselect',
 	 *     edit_policy: 'admins'|'users',
 	 *     exposure_policy: 'hidden'|'private'|'users'|'public',
 	 *     sort_order: int,

lib/Workflow/UserProfileFieldCheck.php

@@ -59,6 +59,14 @@ class UserProfileFieldCheck implements ICheck {
 		'is',
 		'!is',
 	];
+	private const URL_OPERATORS = [
+		self::OPERATOR_IS_SET,
+		self::OPERATOR_IS_NOT_SET,
+		'is',
+		'!is',
+		'contains',
+		'!contains',
+	];
 	private const SELECT_OPERATORS = [
 		self::OPERATOR_IS_SET,
 		self::OPERATOR_IS_NOT_SET,
@@ -122,8 +130,11 @@ public function validateCheck($operator, $value) {
 
 		if ($this->operatorRequiresValue((string)$operator)) {
 			try {
-				if (FieldType::from($definition->getType()) === FieldType::MULTISELECT) {
+				$fieldType = FieldType::from($definition->getType());
+				if ($fieldType === FieldType::MULTISELECT) {
 					$this->normalizeExpectedMultiSelectOperand($definition, $config['value']);
+				} elseif ($fieldType === FieldType::URL && ((string)$operator === 'contains' || (string)$operator === '!contains')) {
+					// URL contains search terms are plain substrings — no URL validation needed.
 				} else {
 					$this->fieldValueService->normalizeValue($definition, $config['value']);
 				}
@@ -184,6 +195,7 @@ private function isOperatorSupported(FieldDefinition $definition, string $operat
 			FieldType::NUMBER => self::NUMBER_OPERATORS,
 			FieldType::BOOLEAN => self::BOOLEAN_OPERATORS,
 			FieldType::DATE => self::DATE_OPERATORS,
+			FieldType::URL => self::URL_OPERATORS,
 			FieldType::SELECT => self::SELECT_OPERATORS,
 			FieldType::MULTISELECT => self::SELECT_OPERATORS,
 		};
@@ -249,11 +261,16 @@ private function evaluate(FieldDefinition $definition, string $operator, string|
 			return $this->evaluateMultiSelectOperator($operator, $expectedValue, $actualValue);
 		}
 
+		if ($fieldType === FieldType::URL && ($operator === 'contains' || $operator === '!contains')) {
+			return $this->evaluateTextOperator($operator, trim((string)$expectedRawValue), (string)$actualValue);
+		}
+
 		$normalizedExpected = $this->fieldValueService->normalizeValue($definition, $expectedRawValue);
 		$expectedValue = $normalizedExpected['value'] ?? null;
 
 		return match ($fieldType) {
 			FieldType::TEXT,
+			FieldType::URL,
 			FieldType::SELECT => $this->evaluateTextOperator($operator, (string)$expectedValue, (string)$actualValue),
 			FieldType::BOOLEAN => $this->evaluateBooleanOperator(
 				$operator,

openapi-administration.json

@@ -200,6 +200,7 @@
                     "number",
                     "boolean",
                     "date",
+                    "url",
                     "select",
                     "multiselect"
                 ]

openapi-full.json

@@ -275,6 +275,7 @@
                     "number",
                     "boolean",
                     "date",
+                    "url",
                     "select",
                     "multiselect"
                 ]

openapi.json

@@ -146,6 +146,7 @@
                     "number",
                     "boolean",
                     "date",
+                    "url",
                     "select",
                     "multiselect"
                 ]

src/components/AdminUserFieldsDialog.vue

@@ -211,6 +211,7 @@ export default defineComponent({
 			number: t('profile_fields', 'Only numeric values are accepted.'),
 			boolean: t('profile_fields', 'Choose either true or false.'),
 			date: t('profile_fields', 'Use a valid date in YYYY-MM-DD format.'),
+			url: t('profile_fields', 'Enter a valid URL (e.g. https://example.com).'),
 			select: t('profile_fields', 'Choose one of the predefined options.'),
 			multiselect: t('profile_fields', 'Choose one or more predefined options.'),
 		} as Record<FieldType, string>)[type]
@@ -220,6 +221,7 @@ export default defineComponent({
 			number: t('profile_fields', 'Enter a number'),
 			boolean: t('profile_fields', 'Select true or false'),
 			date: t('profile_fields', 'Select a date'),
+			url: t('profile_fields', 'Enter a URL'),
 			select: t('profile_fields', 'Select an option'),
 			multiselect: t('profile_fields', 'Select one or more options'),
 		} as Record<FieldType, string>)[type]
@@ -232,6 +234,7 @@ export default defineComponent({
 			number: 'decimal',
 			boolean: 'text',
 			date: 'numeric',
+			url: 'url',
 			select: 'text',
 			multiselect: 'text',
 		} as Record<FieldType, string>)[type]
@@ -241,6 +244,7 @@ export default defineComponent({
 			number: 'text',
 			boolean: 'text',
 			date: 'date',
+			url: 'url',
 			select: 'text',
 			multiselect: 'text',
 		} as Record<FieldType, string>)[type]
@@ -324,6 +328,15 @@ export default defineComponent({
 				}
 			}
 
+			if (field.definition.type === 'url') {
+				try {
+					// eslint-disable-next-line no-new
+					new URL(rawValue)
+				} catch {
+					return t('profile_fields', '{fieldLabel} must be a valid URL.', { fieldLabel: field.definition.label })
+				}
+			}
+
 			if (field.definition.type === 'select') {
 				const options = field.definition.options ?? []
 				if (!options.includes(rawValue)) {
@@ -355,7 +368,7 @@ export default defineComponent({
 		const hasInvalidFields = computed(() => invalidFields.value.length > 0)
 
 		const helperTextForField = (field: AdminEditableField) => {
-			return field.definition.type === 'number' || field.definition.type === 'date' || field.definition.type === 'boolean'
+			return field.definition.type === 'number' || field.definition.type === 'date' || field.definition.type === 'boolean' || field.definition.type === 'url'
 				? descriptionForType(field.definition.type)
 				: ''
 		}
@@ -430,6 +443,7 @@ export default defineComponent({
 				'number fields expect a numeric value': t('profile_fields', '{fieldLabel} must be a numeric value.', { fieldLabel: field.definition.label }),
 				'Boolean fields require true or false values.': t('profile_fields', '{fieldLabel} must be either true or false.', { fieldLabel: field.definition.label }),
 				'Date fields require a valid ISO-8601 date in YYYY-MM-DD format.': t('profile_fields', '{fieldLabel} must be a valid date in YYYY-MM-DD format.', { fieldLabel: field.definition.label }),
+				'URL fields require a valid URL.': t('profile_fields', '{fieldLabel} must be a valid URL.', { fieldLabel: field.definition.label }),
 				'current_visibility is not supported': t('profile_fields', 'The selected visibility is not supported.'),
 			}[message] ?? (message.includes('is not a valid option')
 				? t('profile_fields', '{fieldLabel}: invalid option selected.', { fieldLabel: field.definition.label })

src/tests/components/AdminSettings.spec.ts

@@ -105,4 +105,19 @@ describe('AdminSettings', () => {
 
 		expect(wrapper.text()).toContain('tr:Boolean')
 	})
+
+	it('offers the URL field type in the editor', async() => {
+		const wrapper = mount(AdminSettings, {
+			global: {
+				stubs: {
+					Draggable: defineComponent({ template: '<div><slot /></div>' }),
+				},
+			},
+		})
+
+		await flushPromises()
+		await wrapper.get('button').trigger('click')
+
+		expect(wrapper.text()).toContain('tr:URL')
+	})
 })

src/tests/components/AdminUserFieldsDialog.spec.ts

@@ -48,6 +48,17 @@ vi.mock('../../api', () => ({
 			active: true,
 			options: null,
 		},
+		{
+			id: 5,
+			field_key: 'website',
+			label: 'Website',
+			type: 'url',
+			edit_policy: 'users',
+			exposure_policy: 'private',
+			sort_order: 2,
+			active: true,
+			options: null,
+		},
 	]),
 	listAdminUserValues: vi.fn().mockResolvedValue([
 		{
@@ -131,4 +142,40 @@ describe('AdminUserFieldsDialog', () => {
 		expect(wrapper.text()).toContain('tr:True')
 		expect(wrapper.text()).toContain('tr:False')
 	})
+
+	it('renders url fields with type=url input', async() => {
+		const wrapper = mount(AdminUserFieldsDialog, {
+			props: {
+				open: true,
+				userUid: 'alice',
+				userDisplayName: 'Alice',
+			},
+		})
+
+		await flushPromises()
+
+		const urlInput = wrapper.find('#profile-fields-user-dialog-value-5')
+		expect(urlInput.exists()).toBe(true)
+		expect(urlInput.attributes('type')).toBe('url')
+	})
+
+	it('shows url helper text for url fields', async() => {
+		const wrapper = mount(AdminUserFieldsDialog, {
+			props: {
+				open: true,
+				userUid: 'alice',
+				userDisplayName: 'Alice',
+			},
+		})
+
+		await flushPromises()
+
+		// The helper text is passed via the :helper-text prop on NcInputField for the url field.
+		// Verify the URL field renders its description via a data-testid selector approach:
+		// the NcInputField mock renders with all bound attrs so helper-text appears as a DOM attribute.
+		const urlInput = wrapper.find('#profile-fields-user-dialog-value-5')
+		expect(urlInput.exists()).toBe(true)
+		// helper-text is bound as an attribute through v-bind="$attrs"
+		expect(urlInput.attributes('helper-text')).toBeTruthy()
+	})
 })