LibreCodeCoop · vitormattos · Mar 18, 2026 · Mar 18, 2026 · Mar 18, 2026 · Mar 18, 2026
diff --git a/img/screenshots/admin-catalog-thumb.png b/img/screenshots/admin-catalog-thumb.png
diff --git a/img/screenshots/admin-catalog.png b/img/screenshots/admin-catalog.png
diff --git a/img/screenshots/personal-settings-thumb.png b/img/screenshots/personal-settings-thumb.png
diff --git a/img/screenshots/personal-settings.png b/img/screenshots/personal-settings.png
diff --git a/img/screenshots/user-management-dialog-thumb.png b/img/screenshots/user-management-dialog-thumb.png
diff --git a/img/screenshots/user-management-dialog.png b/img/screenshots/user-management-dialog.png
diff --git a/img/screenshots/workflow-notify-admins-thumb.png b/img/screenshots/workflow-notify-admins-thumb.png
diff --git a/img/screenshots/workflow-notify-admins.png b/img/screenshots/workflow-notify-admins.png
diff --git a/lib/Controller/FieldDefinitionApiController.php b/lib/Controller/FieldDefinitionApiController.php
@@ -61,6 +61,7 @@ public function index(): DataResponse {
 	 * @param string $initialVisibility Initial visibility applied to new values
 	 * @param int $sortOrder Display order used in admin and profile forms
 	 * @param bool $active Whether the definition is currently active
+	 * @param list<string> $options Allowed values for select fields (ignored for other types)
 	 * @return DataResponse<Http::STATUS_CREATED, ProfileFieldsDefinition, array{}>|DataResponse<Http::STATUS_BAD_REQUEST, array{message: string}, array{}>
 	 *
 	 * 201: Field definition created successfully
@@ -77,9 +78,10 @@ public function create(
 		string $initialVisibility = 'private',
 		int $sortOrder = 0,
 		bool $active = true,
+		array $options = [],
 	): DataResponse {
 		try {
-			$definition = $this->fieldDefinitionService->create([
+			$payload = [
 				'field_key' => $fieldKey,
 				'label' => $label,
 				'type' => $type,
@@ -89,7 +91,11 @@ public function create(
 				'initial_visibility' => $initialVisibility,
 				'sort_order' => $sortOrder,
 				'active' => $active,
-			]);
+			];
+			if ($options !== []) {
+				$payload['options'] = $options;
+			}
+			$definition = $this->fieldDefinitionService->create($payload);
 
 			return new DataResponse($definition->jsonSerialize(), Http::STATUS_CREATED);
 		} catch (InvalidArgumentException $exception) {
@@ -111,6 +117,7 @@ public function create(
 	 * @param string $initialVisibility Initial visibility applied to new values
 	 * @param int $sortOrder Display order used in admin and profile forms
 	 * @param bool $active Whether the definition is currently active
+	 * @param list<string> $options Allowed values for select fields (ignored for other types)
 	 * @return DataResponse<Http::STATUS_OK, ProfileFieldsDefinition, array{}>|DataResponse<Http::STATUS_BAD_REQUEST|Http::STATUS_NOT_FOUND, array{message: string}, array{}>
 	 *
 	 * 200: Field definition updated successfully
@@ -128,14 +135,15 @@ public function update(
 		string $initialVisibility = 'private',
 		int $sortOrder = 0,
 		bool $active = true,
+		array $options = [],
 	): DataResponse {
 		$existing = $this->fieldDefinitionService->findById($id);
 		if ($existing === null) {
 			return new DataResponse(['message' => 'Field definition not found'], Http::STATUS_NOT_FOUND);
 		}
 
 		try {
-			$definition = $this->fieldDefinitionService->update($existing, [
+			$payload = [
 				'label' => $label,
 				'type' => $type,
 				'admin_only' => $adminOnly,
@@ -144,7 +152,11 @@ public function update(
 				'initial_visibility' => $initialVisibility,
 				'sort_order' => $sortOrder,
 				'active' => $active,
-			]);
+			];
+			if ($options !== []) {
+				$payload['options'] = $options;
+			}
+			$definition = $this->fieldDefinitionService->update($existing, $payload);
 
 			return new DataResponse($definition->jsonSerialize(), Http::STATUS_OK);
 		} catch (InvalidArgumentException $exception) {

diff --git a/lib/Db/FieldDefinition.php b/lib/Db/FieldDefinition.php
@@ -32,6 +32,8 @@
  * @method void setSortOrder(int $value)
  * @method bool getActive()
  * @method void setActive(bool $value)
+ * @method string|null getOptions()
+ * @method void setOptions(?string $value)
  * @method \DateTimeInterface getCreatedAt()
  * @method void setCreatedAt(\DateTimeInterface $value)
  * @method \DateTimeInterface getUpdatedAt()
@@ -47,6 +49,7 @@ class FieldDefinition extends Entity {
 	protected $initialVisibility;
 	protected $sortOrder;
 	protected $active;
+	protected $options;
 	protected $createdAt;
 	protected $updatedAt;
 
@@ -73,11 +76,14 @@ public function __construct() {
 	 *     initial_visibility: string,
 	 *     sort_order: int,
 	 *     active: bool,
+	 *     options: list<string>|null,
 	 *     created_at: string,
 	 *     updated_at: string,
 	 * }
 	 */
 	public function jsonSerialize(): array {
+		$rawOptions = $this->getOptions();
+
 		return [
 			'id' => $this->getId(),
 			'field_key' => $this->getFieldKey(),
@@ -89,6 +95,7 @@ public function jsonSerialize(): array {
 			'initial_visibility' => $this->getInitialVisibility(),
 			'sort_order' => $this->getSortOrder(),
 			'active' => $this->getActive(),
+			'options' => $rawOptions !== null ? (json_decode($rawOptions, true) ?? null) : null,
 			'created_at' => $this->getCreatedAt()->format(DATE_ATOM),
 			'updated_at' => $this->getUpdatedAt()->format(DATE_ATOM),
 		];

diff --git a/lib/Db/FieldDefinitionMapper.php b/lib/Db/FieldDefinitionMapper.php
@@ -33,6 +33,7 @@ public function findByFieldKey(string $fieldKey): ?FieldDefinition {
 			'initial_visibility',
 			'sort_order',
 			'active',
+			'options',
 			'created_at',
 			'updated_at',
 		)
@@ -59,6 +60,7 @@ public function findById(int $id): ?FieldDefinition {
 			'initial_visibility',
 			'sort_order',
 			'active',
+			'options',
 			'created_at',
 			'updated_at',
 		)
@@ -88,6 +90,7 @@ public function findAllOrdered(): array {
 			'initial_visibility',
 			'sort_order',
 			'active',
+			'options',
 			'created_at',
 			'updated_at',
 		)
@@ -114,6 +117,7 @@ public function findActiveOrdered(): array {
 			'initial_visibility',
 			'sort_order',
 			'active',
+			'options',
 			'created_at',
 			'updated_at',
 		)

diff --git a/lib/Enum/FieldType.php b/lib/Enum/FieldType.php
@@ -12,6 +12,7 @@
 enum FieldType: string {
 	case TEXT = 'text';
 	case NUMBER = 'number';
+	case SELECT = 'select';
 
 	/**
 	 * @return list<string>
@@ -20,6 +21,7 @@ public static function values(): array {
 		return [
 			self::TEXT->value,
 			self::NUMBER->value,
+			self::SELECT->value,
 		];
 	}
 

diff --git a/lib/Migration/Version1000Date20260309120000.php b/lib/Migration/Version1000Date20260309120000.php
@@ -61,6 +61,10 @@ public function changeSchema(IOutput $output, Closure $schemaClosure, array $opt
 			$table->addColumn('active', Types::BOOLEAN, [
 				'default' => true,
 			]);
+			$table->addColumn('options', Types::TEXT, [
+				'notnull' => false,
+				'default' => null,
+			]);
 			$table->addColumn('created_at', Types::DATETIME, []);
 			$table->addColumn('updated_at', Types::DATETIME, []);
 

diff --git a/lib/ResponseDefinitions.php b/lib/ResponseDefinitions.php
@@ -10,7 +10,7 @@
 namespace OCA\ProfileFields;
 
 /**
- * @psalm-type ProfileFieldsType = 'text'|'number'
+ * @psalm-type ProfileFieldsType = 'text'|'number'|'select'
  * @psalm-type ProfileFieldsVisibility = 'private'|'users'|'public'
  * @psalm-type ProfileFieldsDefinitionInput = array{
  *     field_key?: string,
@@ -22,6 +22,7 @@
  *     initial_visibility?: string,
  *     sort_order?: int,
  *     active?: bool,
+ *     options?: list<string>,
  * }
  * @psalm-type ProfileFieldsDefinition = array{
  *     id: int,
@@ -34,6 +35,7 @@
  *     initial_visibility: ProfileFieldsVisibility,
  *     sort_order: int,
  *     active: bool,
+ *     options: list<string>|null,
  *     created_at: string,
  *     updated_at: string,
  * }

diff --git a/lib/Service/FieldDefinitionService.php b/lib/Service/FieldDefinitionService.php
@@ -11,6 +11,7 @@
 
 use DateTime;
 use InvalidArgumentException;
+use JsonException;
 use OCA\ProfileFields\Db\FieldDefinition;
 use OCA\ProfileFields\Db\FieldDefinitionMapper;
 use OCA\ProfileFields\Db\FieldValueMapper;
@@ -44,6 +45,11 @@ public function create(array $definition): FieldDefinition {
 		$entity->setInitialVisibility($validated['initial_visibility']);
 		$entity->setSortOrder($validated['sort_order']);
 		$entity->setActive($validated['active']);
+		try {
+			$entity->setOptions(isset($validated['options']) ? json_encode($validated['options'], JSON_THROW_ON_ERROR) : null);
+		} catch (JsonException $e) {
+			throw new InvalidArgumentException('options could not be encoded: ' . $e->getMessage(), 0, $e);
+		}
 		$entity->setCreatedAt($createdAt);
 		$entity->setUpdatedAt($updatedAt);
 
@@ -71,6 +77,11 @@ public function update(FieldDefinition $existing, array $definition): FieldDefin
 		$existing->setInitialVisibility($validated['initial_visibility']);
 		$existing->setSortOrder($validated['sort_order']);
 		$existing->setActive($validated['active']);
+		try {
+			$existing->setOptions(isset($validated['options']) ? json_encode($validated['options'], JSON_THROW_ON_ERROR) : null);
+		} catch (JsonException $e) {
+			throw new InvalidArgumentException('options could not be encoded: ' . $e->getMessage(), 0, $e);
+		}
 		$existing->setUpdatedAt($this->parseImportedDate($definition['updated_at'] ?? null) ?? new DateTime());
 
 		return $this->fieldDefinitionMapper->update($existing);

diff --git a/lib/Service/FieldDefinitionValidator.php b/lib/Service/FieldDefinitionValidator.php
@@ -25,17 +25,19 @@ class FieldDefinitionValidator {
 	 *     initial_visibility?: string,
 	 *     sort_order?: int,
 	 *     active?: bool,
+	 *     options?: list<string>,
 	 * } $definition
 	 * @return array{
 	 *     field_key: non-empty-string,
 	 *     label: non-empty-string,
-	 *     type: 'text'|'number',
+	 *     type: 'text'|'number'|'select',
 	 *     admin_only: bool,
 	 *     user_editable: bool,
 	 *     user_visible: bool,
 	 *     initial_visibility: 'private'|'users'|'public',
 	 *     sort_order: int,
 	 *     active: bool,
+	 *     options: list<string>|null,
 	 * }
 	 */
 	public function validate(array $definition): array {
@@ -65,6 +67,8 @@ public function validate(array $definition): array {
 			throw new InvalidArgumentException('user_editable cannot be enabled when the field is hidden from users');
 		}
 
+		$options = $this->validateOptions($type, $definition['options'] ?? null);
+
 		return [
 			'field_key' => $fieldKey,
 			'label' => $label,
@@ -75,9 +79,39 @@ public function validate(array $definition): array {
 			'initial_visibility' => $visibility,
 			'sort_order' => (int)($definition['sort_order'] ?? 0),
 			'active' => (bool)($definition['active'] ?? true),
+			'options' => $options,
 		];
 	}
 
+	/**
+	 * @param mixed $options
+	 * @return list<string>|null
+	 */
+	private function validateOptions(string $type, mixed $options): ?array {
+		if ($type !== FieldType::SELECT->value) {
+			return null;
+		}
+
+		if (!is_array($options) || count($options) === 0) {
+			throw new InvalidArgumentException('select fields require at least one option');
+		}
+
+		$normalized = [];
+		foreach ($options as $option) {
+			if (!is_string($option) || trim($option) === '') {
+				throw new InvalidArgumentException('each option must be a non-empty string');
+			}
+			$normalized[] = trim($option);
+		}
+
+		$deduplicated = array_values(array_unique($normalized));
+		if (count($deduplicated) !== count($normalized)) {
+			throw new InvalidArgumentException('options must not contain duplicate values');
+		}
+
+		return $deduplicated;
+	}
+
 	/**
 	 * @param array{
 	 *     field_key?: string,
@@ -89,6 +123,7 @@ public function validate(array $definition): array {
 	 *     initial_visibility?: string,
 	 *     sort_order?: int,
 	 *     active?: bool,
+	 *     options?: list<string>,
 	 * } $definition
 	 */
 	private function requireString(array $definition, string $key): string {

diff --git a/lib/Service/FieldValueService.php b/lib/Service/FieldValueService.php
@@ -103,6 +103,7 @@ public function normalizeValue(FieldDefinition $definition, array|string|int|flo
 		return match ($type) {
 			FieldType::TEXT => $this->normalizeTextValue($rawValue),
 			FieldType::NUMBER => $this->normalizeNumberValue($rawValue),
+			FieldType::SELECT => $this->normalizeSelectValue($rawValue, $definition),
 		};
 	}
 
@@ -231,6 +232,24 @@ private function normalizeTextValue(array|string|int|float|bool $rawValue): arra
 		return ['value' => trim((string)$rawValue)];
 	}
 
+	/**
+	 * @param array<string, mixed>|scalar $rawValue
+	 * @return array{value: string}
+	 */
+	private function normalizeSelectValue(array|string|int|float|bool $rawValue, FieldDefinition $definition): array {
+		if (!is_string($rawValue)) {
+			throw new InvalidArgumentException('select fields expect a string value');
+		}
+
+		$value = trim($rawValue);
+		$options = json_decode($definition->getOptions() ?? '[]', true);
+		if (!in_array($value, $options, true)) {
+			throw new InvalidArgumentException(sprintf('"%s" is not a valid option for this field', $value));
+		}
+
+		return ['value' => $value];
+	}
+
 	/**
 	 * @param array<string, mixed>|scalar $rawValue
 	 * @return array{value: int|float}

diff --git a/lib/Workflow/UserProfileFieldCheck.php b/lib/Workflow/UserProfileFieldCheck.php
@@ -43,6 +43,12 @@ class UserProfileFieldCheck implements ICheck {
 		'greater',
 		'!less',
 	];
+	private const SELECT_OPERATORS = [
+		self::OPERATOR_IS_SET,
+		self::OPERATOR_IS_NOT_SET,
+		'is',
+		'!is',
+	];
 
 	public function __construct(
 		private IUserSession $userSession,
@@ -156,6 +162,7 @@ private function isOperatorSupported(FieldDefinition $definition, string $operat
 		$operators = match (FieldType::from($definition->getType())) {
 			FieldType::TEXT => self::TEXT_OPERATORS,
 			FieldType::NUMBER => self::NUMBER_OPERATORS,
+			FieldType::SELECT => self::SELECT_OPERATORS,
 		};
 
 		return in_array($operator, $operators, true);
@@ -192,7 +199,8 @@ private function evaluate(FieldDefinition $definition, string $operator, string|
 		$expectedValue = $normalizedExpected['value'] ?? null;
 
 		return match (FieldType::from($definition->getType())) {
-			FieldType::TEXT => $this->evaluateTextOperator($operator, (string)$expectedValue, (string)$actualValue),
+			FieldType::TEXT,
+			FieldType::SELECT => $this->evaluateTextOperator($operator, (string)$expectedValue, (string)$actualValue),
 			FieldType::NUMBER => $this->evaluateNumberOperator(
 				$operator,
 				$this->normalizeNumericComparisonOperand($expectedValue),