feat: workflow webhook action

.github/workflows/behat-sqlite.yml

@@ -50,6 +50,13 @@ jobs:
     env:
       APP_NAME: profile_fields
 
+    services:
+      mailpit:
+        image: axllent/mailpit:v1.27
+        ports:
+          - 1025:1025
+          - 8025:8025
+
     name: SQLite PHP 8.2 Nextcloud master
 
     steps:
@@ -71,7 +78,7 @@ jobs:
         uses: shivammathur/setup-php@accd6127cb78bee3e8082180cb391013d204ef9f # v2.37.0
         with:
           php-version: '8.2'
-          extensions: bz2, ctype, curl, dom, fileinfo, gd, iconv, intl, json, libxml, mbstring, openssl, pcntl, posix, session, simplexml, sqlite, pdo_sqlite, xmlreader, xmlwriter, zip, zlib
+          extensions: bz2, ctype, curl, dom, fileinfo, gd, iconv, intl, json, libxml, mbstring, openssl, pcntl, posix, session, simplexml, sockets, sqlite, pdo_sqlite, xmlreader, xmlwriter, zip, zlib
           coverage: none
           ini-file: development
           ini-values: disable_functions=
@@ -85,6 +92,7 @@ jobs:
 
       - name: Set up Nextcloud
         run: |
+          echo "127.0.0.1 mailpit" | sudo tee -a /etc/hosts
           mkdir data
           ./occ maintenance:install \
             --verbose \
@@ -93,6 +101,12 @@ jobs:
             --admin-user admin \
             --admin-pass admin
           ./occ app:enable --force ${{ env.APP_NAME }}
+          git clone --depth 1 https://github.com/nextcloud/notifications apps/notifications
+          composer --working-dir=apps/notifications install --no-dev
+          ./occ app:enable --force notifications
+          git clone --depth 1 https://github.com/nextcloud/spreed apps/spreed
+          composer --working-dir=apps/spreed install --no-dev
+          ./occ app:enable --force spreed
           ./occ config:system:set auth.bruteforce.protection.enabled --value false --type boolean
           ./occ config:system:set ratelimit.protection.enabled --value false --type boolean
           ./occ config:system:set debug --value true --type boolean

README.md

@@ -39,4 +39,14 @@ Notes:
 
 ## Screenshots
 
+### Admin catalog
 ![Admin catalog](img/screenshots/admin-catalog.png)
+
+### User management dialog
+![User management dialog](img/screenshots/user-management-dialog.png)
+
+### Personal settings
+![Personal settings](img/screenshots/personal-settings.png)
+
+### Workflow automation
+![Workflow automation](img/screenshots/workflow-notify-admins.png)

REUSE.toml

@@ -26,6 +26,7 @@ path = [
   "openapi.json",
   "package-lock.json",
   "package.json",
+  "playwright/fixtures/*.png",
   "psalm.xml",
   "src/types/openapi/*.ts",
   "tests/integration/composer.json",

appinfo/info.xml

@@ -36,8 +36,9 @@ Developed with ❤️ by [LibreCode](https://librecode.coop). Help us transform
 	<bugs>https://github.com/LibreCodeCoop/profile_fields/issues</bugs>
 	<repository type="git">https://github.com/LibreCodeCoop/profile_fields</repository>
 	<screenshot small-thumbnail="https://raw.githubusercontent.com/LibreCodeCoop/profile_fields/main/img/screenshots/admin-catalog-thumb.png">https://raw.githubusercontent.com/LibreCodeCoop/profile_fields/main/img/screenshots/admin-catalog.png</screenshot>
-	<screenshot small-thumbnail="https://raw.githubusercontent.com/LibreCodeCoop/profile_fields/main/img/screenshots/personal-settings-thumb.png">https://raw.githubusercontent.com/LibreCodeCoop/profile_fields/main/img/screenshots/personal-settings.png</screenshot>
 	<screenshot small-thumbnail="https://raw.githubusercontent.com/LibreCodeCoop/profile_fields/main/img/screenshots/user-management-dialog-thumb.png">https://raw.githubusercontent.com/LibreCodeCoop/profile_fields/main/img/screenshots/user-management-dialog.png</screenshot>
+	<screenshot small-thumbnail="https://raw.githubusercontent.com/LibreCodeCoop/profile_fields/main/img/screenshots/personal-settings-thumb.png">https://raw.githubusercontent.com/LibreCodeCoop/profile_fields/main/img/screenshots/personal-settings.png</screenshot>
+	<screenshot small-thumbnail="https://raw.githubusercontent.com/LibreCodeCoop/profile_fields/main/img/screenshots/workflow-notify-admins-thumb.png">https://raw.githubusercontent.com/LibreCodeCoop/profile_fields/main/img/screenshots/workflow-notify-admins.png</screenshot>
 	<donation title="Donate via GitHub Sponsors">https://github.com/sponsors/LibreSign</donation>
 	<dependencies>
 		<nextcloud min-version="32" max-version="34"/>

lib/AppInfo/Application.php

@@ -10,14 +10,23 @@
 namespace OCA\ProfileFields\AppInfo;
 
 use OCA\ProfileFields\Listener\BeforeTemplateRenderedListener;
+use OCA\ProfileFields\Listener\LoadWorkflowSettingsScriptsListener;
+use OCA\ProfileFields\Listener\RegisterWorkflowCheckListener;
+use OCA\ProfileFields\Listener\RegisterWorkflowEntityListener;
+use OCA\ProfileFields\Listener\RegisterWorkflowOperationListener;
 use OCA\ProfileFields\Listener\UserDeletedCleanupListener;
+use OCA\ProfileFields\Notification\Notifier;
 use OCP\AppFramework\App;
 use OCP\AppFramework\Bootstrap\IBootContext;
 use OCP\AppFramework\Bootstrap\IBootstrap;
 use OCP\AppFramework\Bootstrap\IRegistrationContext;
 use OCP\IRequest;
 use OCP\User\Events\UserDeletedEvent;
 use OCP\Util;
+use OCP\WorkflowEngine\Events\LoadSettingsScriptsEvent;
+use OCP\WorkflowEngine\Events\RegisterChecksEvent;
+use OCP\WorkflowEngine\Events\RegisterEntitiesEvent;
+use OCP\WorkflowEngine\Events\RegisterOperationsEvent;
 
 /**
  * @codeCoverageIgnore
@@ -32,8 +41,13 @@ public function __construct() {
 
 	#[\Override]
 	public function register(IRegistrationContext $context): void {
+		$context->registerNotifierService(Notifier::class);
 		$context->registerEventListener('\\OCA\\Settings\\Events\\BeforeTemplateRenderedEvent', BeforeTemplateRenderedListener::class);
 		$context->registerEventListener(UserDeletedEvent::class, UserDeletedCleanupListener::class);
+		$context->registerEventListener(RegisterEntitiesEvent::class, RegisterWorkflowEntityListener::class);
+		$context->registerEventListener(RegisterOperationsEvent::class, RegisterWorkflowOperationListener::class);
+		$context->registerEventListener(RegisterChecksEvent::class, RegisterWorkflowCheckListener::class);
+		$context->registerEventListener(LoadSettingsScriptsEvent::class, LoadWorkflowSettingsScriptsListener::class);
 	}
 
 	#[\Override]

lib/Command/Developer/Reset.php

@@ -9,6 +9,7 @@
 
 namespace OCA\ProfileFields\Command\Developer;
 
+use OCA\ProfileFields\AppInfo\Application;
 use OCP\IDBConnection;
 use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Input\InputInterface;
@@ -65,12 +66,31 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
 		if ($resetDefinitions) {
 			$this->deleteTable('profile_fields_definitions');
+			$this->deleteWorkflowTables();
+			$this->deleteProfileFieldNotifications();
 		}
 
 		$output->writeln('<info>Profile Fields data reset complete.</info>');
 		return self::SUCCESS;
 	}
 
+	private function deleteWorkflowTables(): void {
+		foreach (['flow_checks', 'flow_operations', 'flow_operations_scope'] as $tableName) {
+			$this->deleteTable($tableName);
+		}
+	}
+
+	private function deleteProfileFieldNotifications(): void {
+		if (!$this->connection->tableExists('notifications')) {
+			return;
+		}
+
+		$query = $this->connection->getQueryBuilder();
+		$query->delete('notifications')
+			->where($query->expr()->eq('app', $query->createNamedParameter(Application::APP_ID)))
+			->executeStatement();
+	}
+
 	private function deleteTable(string $tableName): void {
 		if (!$this->connection->tableExists($tableName)) {
 			return;

lib/Listener/LoadWorkflowSettingsScriptsListener.php

@@ -0,0 +1,31 @@
+<?php
+
+/**
+ * SPDX-FileCopyrightText: 2026 LibreCode coop and LibreCode contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+declare(strict_types=1);
+
+namespace OCA\ProfileFields\Listener;
+
+use OCA\ProfileFields\AppInfo\Application;
+use OCP\EventDispatcher\Event;
+use OCP\EventDispatcher\IEventListener;
+use OCP\Util;
+use OCP\WorkflowEngine\Events\LoadSettingsScriptsEvent;
+
+/**
+ * @template-implements IEventListener<LoadSettingsScriptsEvent>
+ */
+class LoadWorkflowSettingsScriptsListener implements IEventListener {
+	#[\Override]
+	public function handle(Event $event): void {
+		if (!$event instanceof LoadSettingsScriptsEvent) {
+			return;
+		}
+
+		Util::addStyle(Application::APP_ID, 'profile_fields-workflow');
+		Util::addScript(Application::APP_ID, 'profile_fields-workflow', 'workflowengine');
+	}
+}

lib/Listener/RegisterWorkflowCheckListener.php

@@ -0,0 +1,34 @@
+<?php
+
+/**
+ * SPDX-FileCopyrightText: 2026 LibreCode coop and LibreCode contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+declare(strict_types=1);
+
+namespace OCA\ProfileFields\Listener;
+
+use OCA\ProfileFields\Workflow\UserProfileFieldCheck;
+use OCP\EventDispatcher\Event;
+use OCP\EventDispatcher\IEventListener;
+use OCP\WorkflowEngine\Events\RegisterChecksEvent;
+
+/**
+ * @template-implements IEventListener<RegisterChecksEvent>
+ */
+class RegisterWorkflowCheckListener implements IEventListener {
+	public function __construct(
+		private UserProfileFieldCheck $check,
+	) {
+	}
+
+	#[\Override]
+	public function handle(Event $event): void {
+		if (!$event instanceof RegisterChecksEvent) {
+			return;
+		}
+
+		$event->registerCheck($this->check);
+	}
+}

lib/Listener/RegisterWorkflowEntityListener.php

@@ -0,0 +1,34 @@
+<?php
+
+/**
+ * SPDX-FileCopyrightText: 2026 LibreCode coop and LibreCode contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+declare(strict_types=1);
+
+namespace OCA\ProfileFields\Listener;
+
+use OCA\ProfileFields\Workflow\ProfileFieldValueEntity;
+use OCP\EventDispatcher\Event;
+use OCP\EventDispatcher\IEventListener;
+use OCP\WorkflowEngine\Events\RegisterEntitiesEvent;
+
+/**
+ * @template-implements IEventListener<RegisterEntitiesEvent>
+ */
+class RegisterWorkflowEntityListener implements IEventListener {
+	public function __construct(
+		private ProfileFieldValueEntity $entity,
+	) {
+	}
+
+	#[\Override]
+	public function handle(Event $event): void {
+		if (!$event instanceof RegisterEntitiesEvent) {
+			return;
+		}
+
+		$event->registerEntity($this->entity);
+	}
+}

lib/Listener/RegisterWorkflowOperationListener.php

@@ -0,0 +1,46 @@
+<?php
+
+/**
+ * SPDX-FileCopyrightText: 2026 LibreCode coop and LibreCode contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+declare(strict_types=1);
+
+namespace OCA\ProfileFields\Listener;
+
+use OCA\ProfileFields\Workflow\CreateTalkConversationProfileFieldChangeOperation;
+use OCA\ProfileFields\Workflow\EmailUserProfileFieldChangeOperation;
+use OCA\ProfileFields\Workflow\LogProfileFieldChangeOperation;
+use OCA\ProfileFields\Workflow\NotifyAdminsOrGroupsProfileFieldChangeOperation;
+use OCA\ProfileFields\Workflow\SendWebhookProfileFieldChangeOperation;
+use OCP\EventDispatcher\Event;
+use OCP\EventDispatcher\IEventListener;
+use OCP\WorkflowEngine\Events\RegisterOperationsEvent;
+
+/**
+ * @template-implements IEventListener<RegisterOperationsEvent>
+ */
+class RegisterWorkflowOperationListener implements IEventListener {
+	public function __construct(
+		private LogProfileFieldChangeOperation $operation,
+		private EmailUserProfileFieldChangeOperation $emailUserOperation,
+		private NotifyAdminsOrGroupsProfileFieldChangeOperation $notifyAdminsOrGroupsOperation,
+		private CreateTalkConversationProfileFieldChangeOperation $createTalkConversationOperation,
+		private SendWebhookProfileFieldChangeOperation $sendWebhookOperation,
+	) {
+	}
+
+	#[\Override]
+	public function handle(Event $event): void {
+		if (!$event instanceof RegisterOperationsEvent) {
+			return;
+		}
+
+		$event->registerOperation($this->operation);
+		$event->registerOperation($this->emailUserOperation);
+		$event->registerOperation($this->notifyAdminsOrGroupsOperation);
+		$event->registerOperation($this->createTalkConversationOperation);
+		$event->registerOperation($this->sendWebhookOperation);
+	}
+}

lib/Notification/Notifier.php

@@ -0,0 +1,65 @@
+<?php
+
+/**
+ * SPDX-FileCopyrightText: 2026 LibreCode coop and LibreCode contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+declare(strict_types=1);
+
+namespace OCA\ProfileFields\Notification;
+
+use OCA\ProfileFields\AppInfo\Application;
+use OCP\IURLGenerator;
+use OCP\L10N\IFactory;
+use OCP\Notification\INotification;
+use OCP\Notification\INotifier;
+use OCP\Notification\UnknownNotificationException;
+
+class Notifier implements INotifier {
+	public function __construct(
+		private IFactory $factory,
+		private IURLGenerator $urlGenerator,
+	) {
+	}
+
+	#[\Override]
+	public function getID(): string {
+		return Application::APP_ID;
+	}
+
+	#[\Override]
+	public function getName(): string {
+		return $this->factory->get(Application::APP_ID)->t('Profile fields');
+	}
+
+	#[\Override]
+	public function prepare(INotification $notification, string $languageCode): INotification {
+		if ($notification->getApp() !== Application::APP_ID) {
+			throw new UnknownNotificationException();
+		}
+
+		$l10n = $this->factory->get(Application::APP_ID, $languageCode);
+
+		if ($notification->getSubject() === 'profile_field_updated') {
+			$notification->setParsedSubject($l10n->t('Profile field updated'));
+		} elseif ($notification->getParsedSubject() === '') {
+			$notification->setParsedSubject($notification->getSubject());
+		}
+
+		if ($notification->getMessage() === 'profile_field_updated_message') {
+			$notification->setParsedMessage($l10n->t(
+				'%1$s changed %2$s\'s %3$s profile field.',
+				$notification->getMessageParameters(),
+			));
+		} elseif ($notification->getMessage() !== '' && $notification->getParsedMessage() === '') {
+			$notification->setParsedMessage($notification->getMessage());
+		}
+
+		if ($notification->getIcon() === '') {
+			$notification->setIcon($this->urlGenerator->getAbsoluteURL($this->urlGenerator->imagePath(Application::APP_ID, 'app.svg')));
+		}
+
+		return $notification;
+	}
+}