Initial implementation of Nextcloud iTop integration

- Added complete app structure with proper info.xml and routes
- Implemented iTop API service with personal token authentication
- Created dashboard widget for assigned tickets
- Added unified search provider for tickets and CIs
- Implemented reference provider for rich link previews
- Added background job for ticket notifications
- Created admin and personal settings with templates
- Basic styling and icons included

Features:
- Dashboard widget showing user's assigned tickets
- Search integration for tickets and configuration items
- Rich previews when sharing iTop links
- Notifications for newly assigned tickets
- Admin configuration for instance URL
- User configuration for personal API tokens

Author: Alexander Askin

.gitignore

@@ -0,0 +1,11 @@
+vendor/
+.DS_Store
+*.log
+.idea/
+.vscode/
+node_modules/
+/build/
+/js/
+/css/*.css
+/css/*.css.map
+krankerl.toml

README.md

@@ -0,0 +1,40 @@
+# Nextcloud iTop integration
+
+🎫 iTop integration into Nextcloud
+
+This app provides integration between Nextcloud and iTop IT Service Management platform. It allows users to:
+
+- View assigned tickets on the Nextcloud dashboard
+- Search for tickets and configuration items from Nextcloud's unified search
+- Get notifications for new assigned tickets
+- Rich previews of iTop links in Nextcloud apps
+
+## Features
+
+- **Dashboard widget**: Shows your assigned tickets and recent activity
+- **Unified search**: Search tickets, incidents, and CIs directly from Nextcloud
+- **Notifications**: Get notified when new tickets are assigned to you
+- **Rich references**: Share iTop links with rich previews in Talk and other apps
+
+## Configuration
+
+### Admin settings
+1. Go to Settings > Administration > Connected accounts
+2. Configure your iTop server URL and admin settings
+
+### User settings
+1. Go to Settings > Connected accounts
+2. Enter your iTop server URL (if not set by admin)
+3. Configure your personal API token from iTop
+
+### iTop API Token Setup
+1. Log into your iTop instance
+2. Go to "My Account" menu
+3. Generate a personal API token with appropriate scopes
+4. Copy and paste the token into Nextcloud settings
+
+## Requirements
+
+- Nextcloud 30+
+- iTop with REST/JSON API enabled
+- iTop Authentication by Token extension installed

appinfo/info.xml

@@ -0,0 +1,32 @@
+<?xml version="1.0"?>
+<info>
+	<id>integration_itop</id>
+	<name>iTop integration</name>
+	<summary>Integration of iTop IT Service Management platform</summary>
+	<description><![CDATA[iTop integration provides a dashboard widget displaying your assigned tickets,
+a search provider for tickets and configuration items, and notifications for new assigned tickets.]]></description>
+	<version>1.0.0</version>
+	<licence>agpl</licence>
+	<author>Integration Bot</author>
+	<namespace>Itop</namespace>
+	<documentation>
+		<developer>https://github.com/nextcloud/integration_itop</developer>
+	</documentation>
+	<category>integration</category>
+	<category>dashboard</category>
+	<website>https://github.com/nextcloud/integration_itop</website>
+	<bugs>https://github.com/nextcloud/integration_itop/issues</bugs>
+	<screenshot>https://github.com/nextcloud/integration_itop/raw/main/img/screenshot1.jpg</screenshot>
+	<dependencies>
+		<nextcloud min-version="30" max-version="32"/>
+	</dependencies>
+	<background-jobs>
+		<job>OCA\Itop\BackgroundJob\CheckOpenTickets</job>
+	</background-jobs>
+	<settings>
+		<admin>OCA\Itop\Settings\Admin</admin>
+		<admin-section>OCA\Itop\Settings\AdminSection</admin-section>
+		<personal>OCA\Itop\Settings\Personal</personal>
+		<personal-section>OCA\Itop\Settings\PersonalSection</personal-section>
+	</settings>
+</info>

appinfo/routes.php

@@ -0,0 +1,18 @@
+<?php
+
+return [
+	'routes' => [
+		// Configuration routes
+		['name' => 'config#setConfig', 'url' => '/config', 'verb' => 'PUT'],
+		['name' => 'config#setAdminConfig', 'url' => '/admin-config', 'verb' => 'PUT'],
+		
+		// API routes
+		['name' => 'itopAPI#getTickets', 'url' => '/tickets', 'verb' => 'GET'],
+		['name' => 'itopAPI#getTicket', 'url' => '/tickets/{ticketId}', 'verb' => 'GET'],
+		['name' => 'itopAPI#getAvatar', 'url' => '/avatar', 'verb' => 'GET'],
+		['name' => 'itopAPI#getCIs', 'url' => '/cis', 'verb' => 'GET'],
+		
+		// Search routes
+		['name' => 'itopAPI#search', 'url' => '/search', 'verb' => 'GET'],
+	]
+];

composer.json

@@ -0,0 +1,19 @@
+{
+	"name": "nextcloud/integration_itop",
+	"description": "iTop integration for Nextcloud",
+	"type": "project",
+	"license": "AGPL-3.0+",
+	"authors": [
+		{
+			"name": "Integration Bot"
+		}
+	],
+	"require": {
+		"php": "^8.0"
+	},
+	"autoload": {
+		"psr-4": {
+			"OCA\\Itop\\": "lib/"
+		}
+	}
+}

img/app-dark.svg

@@ -0,0 +1,93 @@
+<?php
+
+/**
+ * Nextcloud - iTop
+ *
+ *
+ * @author Integration Bot
+ * @copyright Integration Bot 2025
+ */
+
+namespace OCA\Itop\AppInfo;
+
+use Closure;
+use OCA\Itop\Dashboard\ItopWidget;
+use OCA\Itop\Listener\ItopReferenceListener;
+use OCA\Itop\Notification\Notifier;
+use OCA\Itop\Reference\ItopReferenceProvider;
+use OCA\Itop\Search\ItopSearchProvider;
+use OCP\AppFramework\App;
+use OCP\AppFramework\Bootstrap\IBootContext;
+use OCP\AppFramework\Bootstrap\IBootstrap;
+
+use OCP\AppFramework\Bootstrap\IRegistrationContext;
+use OCP\Collaboration\Reference\RenderReferenceEvent;
+use OCP\IConfig;
+use OCP\IL10N;
+use OCP\INavigationManager;
+
+use OCP\IURLGenerator;
+use OCP\IUserSession;
+use OCP\Notification\IManager as INotificationManager;
+
+class Application extends App implements IBootstrap {
+
+	public const APP_ID = 'integration_itop';
+	private IConfig $config;
+
+	public function __construct(array $urlParams = []) {
+		parent::__construct(self::APP_ID, $urlParams);
+
+		$container = $this->getContainer();
+		$this->config = $container->get(IConfig::class);
+
+		$manager = $container->get(INotificationManager::class);
+		$manager->registerNotifierService(Notifier::class);
+	}
+
+	public function register(IRegistrationContext $context): void {
+		$context->registerDashboardWidget(ItopWidget::class);
+		$context->registerSearchProvider(ItopSearchProvider::class);
+
+		$context->registerReferenceProvider(ItopReferenceProvider::class);
+		$context->registerEventListener(RenderReferenceEvent::class, ItopReferenceListener::class);
+	}
+
+	public function boot(IBootContext $context): void {
+		$context->injectFn(Closure::fromCallable([$this, 'registerNavigation']));
+	}
+
+	public function registerNavigation(IUserSession $userSession): void {
+		$user = $userSession->getUser();
+		if ($user !== null) {
+			$userId = $user->getUID();
+			$container = $this->getContainer();
+
+			if ($this->config->getUserValue($userId, self::APP_ID, 'navigation_enabled', '0') === '1') {
+				$itopUrl = $this->config->getUserValue($userId, self::APP_ID, 'url', '');
+				if ($itopUrl !== '') {
+					$container->get(INavigationManager::class)->add(function () use ($container, $itopUrl) {
+						$urlGenerator = $container->get(IURLGenerator::class);
+						$l10n = $container->get(IL10N::class);
+						return [
+							'id' => self::APP_ID,
+
+							'order' => 10,
+
+							// the route that will be shown on startup
+							'href' => $itopUrl,
+
+							// the icon that will be shown in the navigation
+							// this file needs to exist in img/
+							'icon' => $urlGenerator->imagePath(self::APP_ID, 'app.svg'),
+
+							// the title of your application. This will be used in the
+							// navigation or on the settings page of your app
+							'name' => $l10n->t('iTop'),
+						];
+					});
+				}
+			}
+		}
+	}
+}

img/app.svg

@@ -0,0 +1,40 @@
+<?php
+
+/**
+ * Nextcloud - iTop
+ *
+ * This file is licensed under the Affero General Public License version 3 or
+ * later. See the COPYING file.
+ *
+ * @author Integration Bot
+ * @copyright Integration Bot 2025
+ */
+
+namespace OCA\Itop\BackgroundJob;
+
+use OCA\Itop\Service\ItopAPIService;
+use OCP\BackgroundJob\TimedJob;
+use OCP\AppFramework\Utility\ITimeFactory;
+
+use Psr\Log\LoggerInterface;
+
+class CheckOpenTickets extends TimedJob {
+
+	public function __construct(
+		ITimeFactory $time,
+		private ItopAPIService $itopAPIService,
+		private LoggerInterface $logger,
+	) {
+		parent::__construct($time);
+		// Check every 15 minutes
+		$this->setInterval(15 * 60);
+	}
+
+	/**
+	 * @param mixed $argument
+	 */
+	protected function run($argument): void {
+		$this->itopAPIService->checkOpenTickets();
+		$this->logger->info('iTop open tickets check completed');
+	}
+}