feat: implement intros

Signed-off-by: Vitor Mattos <vitor@php.rio>

lib/AppInfo/Application.php

@@ -9,11 +9,13 @@
 namespace OCA\Libresign\AppInfo;
 
 use OCA\Files\Event\LoadSidebar;
+use OCA\Intros\Events\FetchIntrosEvent;
 use OCA\Libresign\Activity\Listener as ActivityListener;
 use OCA\Libresign\Events\SendSignNotificationEvent;
 use OCA\Libresign\Events\SignedEvent;
 use OCA\Libresign\Files\TemplateLoader as FilesTemplateLoader;
 use OCA\Libresign\Listener\BeforeNodeDeletedListener;
+use OCA\Libresign\Listener\FetchIntrosListener;
 use OCA\Libresign\Listener\LoadSidebarListener;
 use OCA\Libresign\Listener\MailNotifyListener;
 use OCA\Libresign\Listener\NotificationListener;
@@ -69,5 +71,7 @@ public function register(IRegistrationContext $context): void {
 		$context->registerEventListener(SendSignNotificationEvent::class, MailNotifyListener::class);
 
 		$context->registerEventListener(UserDeletedEvent::class, UserDeletedListener::class);
+
+		$context->registerEventListener(FetchIntrosEvent::class, FetchIntrosListener::class);
 	}
 }

lib/Listener/FetchIntrosListener.php

@@ -0,0 +1,91 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2024-2024 LibreCode coop and contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Libresign\Listener;
+
+use OCA\Files\Event\LoadSidebar;
+use OCA\Intros\Events\FetchIntrosEvent;
+use OCA\Libresign\AppInfo\Application;
+use OCA\Libresign\Handler\CertificateEngine\Handler as CertificateEngineHandler;
+use OCP\EventDispatcher\Event;
+use OCP\EventDispatcher\IEventListener;
+use OCP\IL10N;
+
+/**
+ * @template-implements IEventListener<Event|LoadSidebar>
+ */
+class FetchIntrosListener implements IEventListener {
+	public function __construct(
+		private IL10N $l10n,
+		private CertificateEngineHandler $certificateEngineHandler,
+	) {
+	}
+
+	public function handle(Event $event): void {
+		if (!($event instanceof FetchIntrosEvent)) {
+			return;
+		}
+		if (!$this->certificateEngineHandler->getEngine()->isSetupOk()) {
+			return;
+		}
+		$event->setData([
+			Application::APP_ID => [
+				'name' => $this->l10n->t('LibreSign'),
+				'steps' => [
+					[
+						'title' => $this->l10n->t('Welcome!'),
+						'paragraphs' => [
+							$this->l10n->t('The LibreSign app allows you to sign documents using your digital certificate or the certificate generated by LibreSign.'),
+						],
+						'choices' => [
+							[
+								'success' => false,
+								'label' => $this->l10n->t('Skip this tutorial'),
+							]
+						],
+						'element' => '',
+					],
+					[
+						'paragraphs' => [
+							$this->l10n->t('Choose the file to request signatures.'),
+						],
+						'element' => 'div#container-request',
+					],
+					[
+						'paragraphs' => [
+							$this->l10n->t('List the files that are associated to you.'),
+						],
+						'element' => 'li#timeline',
+					],
+					[
+						'paragraphs' => [
+							$this->l10n->t('Validate signature'),
+						],
+						'element' => 'li#validation',
+					],
+					[
+						'title' => $this->l10n->t('Settings'),
+						'paragraphs' => [
+							$this->l10n->t('Your personal settings.'),
+							$this->l10n->t('Here you can manage your digital certificate or your visible signature.'),
+						],
+						'element' => 'div#app-settings',
+						'open' => 'div#app-settings__header > .settings-button',
+						'position' => 'top',
+					],
+					[
+						'title' => 'See you!',
+						'paragraphs' => [
+							$this->l10n->t('Help maintain the development of this app by contributing via GitHub Sponsors.'),
+						],
+					],
+				],
+			],
+		]);
+	}
+}