Feat/add komga latest books homepage

.gitignore

@@ -53,6 +53,7 @@ Temporary Items
 
 # Files from my local computer
 php_errors.log
+local-dev
 
 # Backup Files
 .pydio_id
@@ -178,6 +179,7 @@ api/plugins/*
 !api/plugins/speedTest/
 !api/plugins/shuck-stop/
 api/plugins/shuck-stop/drives.json
+!api/plugins/komga/
 
 # =========================
 # Custom files

.htaccess

@@ -0,0 +1,5 @@
+RewriteEngine On
+RewriteBase /api/v2
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteCond %{REQUEST_FILENAME} !-d
+RewriteRule ^ /api/v2/index.php [QSA,L]

api/classes/organizr.class.php

@@ -41,6 +41,7 @@ class Organizr
 	use ProwlarrHomepageItem;
 	use JDownloaderHomepageItem;
 	use JellyfinHomepageItem;
+	use KomgaHomepageItem;
 	use LidarrHomepageItem;
 	use MiscHomepageItem;
 	use MonitorrHomepageItem;

api/functions/sso-functions.php

@@ -169,7 +169,7 @@ public function getKomgaToken($email, $password, $fallback = false)
 			$credentials = array('auth' => new Requests_Auth_Digest(array($email, $password)));
 			$url = $this->qualifyURL($this->config['komgaURL']);
 			$options = $this->requestOptions($url, $this->getSSOTimeout(), true, false, $credentials);
-			$response = Requests::get($url . '/api/v1/users/me', ['X-Auth-Token' => 'organizrSSO'], $options);
+			$response = Requests::get($url . '/api/v2/users/me', ['X-Auth-Token' => 'organizrSSO'], $options);
 			if ($response->success) {
 				if ($response->headers['x-auth-token']) {
 					$this->setLoggerChannel('Komga')->info('Grabbed token');
@@ -395,4 +395,4 @@ public function getPetioToken($username, $password, $oAuthToken = null, $fallbac
 			return false;
 		}
 	}
-}
+}

api/homepage/komga.php

@@ -0,0 +1,58 @@
+<?php
+
+trait KomgaHomepageItem
+{
+    public function komgaSettingsArray($infoOnly = false)
+    {
+        $homepageInformation = [
+            'name' => 'Komga',
+            'enabled' => true,
+            'image' => 'plugins/images/komga.svg',
+            'category' => 'Entertainment',
+            'settingsArray' => __FUNCTION__
+        ];
+        if ($infoOnly) {
+            return $homepageInformation;
+        }
+        $homepageSettings = [
+            'debug' => true,
+            'settings' => [
+                'Enable' => [
+                    $this->settingsOption('enable', 'homepageKomgaEnabled', ['label' => 'Activate Komga', 'help' => 'Display the Komga module on the home page']),
+                    $this->settingsOption('auth', 'homepageKomgaAuth', ['label' => 'Authentification']),
+                ],
+            ]
+        ];
+        return array_merge($homepageInformation, $homepageSettings);
+    }
+
+    public function komgaHomepagePermissions($key = null)
+    {
+        $permissions = [
+            'main' => [
+                'enabled' => [
+                    'homepageKomgaEnabled'
+                ],
+                'auth' => [
+                    'homepageKomgaAuth'
+                ]
+            ]
+        ];
+        return $this->homepageCheckKeyPermissions($key, $permissions);
+    }
+
+    public function homepageOrderKomga()
+    {
+        if ($this->homepageItemPermissions($this->komgaHomepagePermissions('main'))) {
+
+            return '
+				<div id="' . __FUNCTION__ . '">
+					<div id="komgaLatestBookContainer" class="homepage-item" data-id="KOMGA">
+						<div class="white-box homepage-loading-box"><h2 class="text-center" lang="en">Loading Komga Books...</h2></div>
+					</div>
+				</div>
+				';
+        }
+    }
+
+}

api/plugins/komga/api.php

@@ -0,0 +1,109 @@
+<?php
+$app->get('/plugins/komga/books/latest', function ($request, $response, $args) {
+    $komgaPlugin = new KomgaPlugin();
+    $GLOBALS['api']['response']['data'] = [];
+
+    if ($komgaPlugin->checkRoute($request)) {
+        if ($komgaPlugin->qualifyRequest($komgaPlugin->config['KOMGA-minAuth'], true)) {
+            $url = $komgaPlugin->config['KOMGA-url'] ?? '';
+            $apiKey = $komgaPlugin->config['KOMGA-apikey'] ?? '';
+
+            // Check for group override
+            $groupId = $komgaPlugin->user['groupID'] ?? null;
+            $libraries = $komgaPlugin->config['KOMGA-libraries'] ?? 'all';
+
+            if ($groupId !== null) {
+                $groupOverride = $komgaPlugin->config['KOMGA-library-group-' . $groupId] ?? 'default';
+                if ($groupOverride !== 'default') {
+                    $libraries = $groupOverride;
+                }
+            }
+
+            if ($url && $apiKey) {
+                $endpoint = '/api/v1/books?sort=createdDate,desc&size=20';
+                if ($libraries && $libraries !== 'all') {
+                    $endpoint .= '&library_id=' . $libraries;
+                }
+
+                $ch = curl_init();
+                curl_setopt($ch, CURLOPT_URL, rtrim($url, '/') . $endpoint);
+                curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+                curl_setopt($ch, CURLOPT_HTTPHEADER, [
+                    "X-API-Key: $apiKey",
+                    "Accept: application/json"
+                ]);
+                $res = curl_exec($ch);
+                curl_close($ch);
+
+                if ($res) {
+                    $data = json_decode($res, true);
+                    // Provide settings to JS via our API response
+                    $GLOBALS['api']['response']['data'] = [
+                        'title' => $komgaPlugin->config['KOMGA-title'] ?? 'Recently added books',
+                        'baseUrl' => rtrim($url, '/') . '/book/',
+                        'books' => (isset($data['content']) ? $data['content'] : $data),
+                        'tabName' => $komgaPlugin->config['KOMGA-tab-name'] ?? 'Komga'
+                    ];
+                }
+            }
+        }
+    }
+
+    $response->getBody()->write(jsonE($GLOBALS['api']));
+    return $response
+    ->withHeader('Content-Type', 'application/json;charset=UTF-8')
+    ->withStatus($GLOBALS['responseCode']);
+});
+
+$app->get('/plugins/komga/image', function ($request, $response, $args) {
+    $komgaPlugin = new KomgaPlugin();
+
+    if ($komgaPlugin->checkRoute($request)) {
+        if ($komgaPlugin->qualifyRequest(999, true)) {
+            $apiUrl = $komgaPlugin->config['KOMGA-url'] ?? '';
+            $apiKey = $komgaPlugin->config['KOMGA-apikey'] ?? '';
+
+            // Allow full URL (if passed via query string) or just append to Komga API URL
+            $urlParams = $request->getQueryParams();
+            $thumbnailUrl = $urlParams['url'] ?? '';
+
+            if ($apiUrl && $apiKey && $thumbnailUrl) {
+                // Determine if thumbnailUrl is absolute or relative
+                if (!preg_match('~^(?:f|ht)tps?://~i', $thumbnailUrl)) {
+                    $thumbnailUrl = rtrim($apiUrl, '/') . '/' . ltrim($thumbnailUrl, '/');
+                }
+
+                $ch = curl_init();
+                curl_setopt($ch, CURLOPT_URL, $thumbnailUrl);
+                curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+                curl_setopt($ch, CURLOPT_HTTPHEADER, [
+                    "X-API-Key: $apiKey"
+                ]);
+                $res = curl_exec($ch);
+                $contentType = curl_getinfo($ch, CURLINFO_CONTENT_TYPE);
+                curl_close($ch);
+
+                if ($res) {
+                    $response->getBody()->write($res);
+                    return $response
+                    ->withHeader('Content-Type', $contentType ?: 'image/jpeg');
+                }
+            }
+        }
+    }
+
+    return $response->withStatus(404);
+});
+
+$app->get('/plugins/komga/settings', function ($request, $response, $args) {
+    $komgaPlugin = new KomgaPlugin();
+    if ($komgaPlugin->checkRoute($request)) {
+        if ($komgaPlugin->qualifyRequest(1, true)) {
+            $GLOBALS['api']['response']['data'] = $komgaPlugin->_pluginGetSettings();
+        }
+    }
+    $response->getBody()->write(jsonE($GLOBALS['api']));
+    return $response
+    ->withHeader('Content-Type', 'application/json;charset=UTF-8')
+    ->withStatus($GLOBALS['responseCode']);
+});

api/plugins/komga/config.php

@@ -0,0 +1,12 @@
+<?php
+/*
+ * Default configuration for Komga Plugin
+ */
+return array(
+    'KOMGA-enabled' => false,
+    'KOMGA-minAuth' => 1,
+    'KOMGA-url' => '',
+    'KOMGA-apikey' => '',
+    'KOMGA-libraries' => 'all',
+    'KOMGA-title' => 'Recently added books'
+);

api/plugins/komga/main.js

@@ -0,0 +1,125 @@
+let KOMGA_TAB_NAME = 'Komga-(Livres)';
+
+window.komgaFetchAuthImage = async function (url, elementId) {
+    try {
+        const proxyUrl = `api/v2/plugins/komga/image?url=${encodeURIComponent(url)}`;
+        const res = await fetch(proxyUrl);
+        if (!res.ok) throw new Error();
+        const blob = await res.blob();
+        const objectURL = URL.createObjectURL(blob);
+        const el = document.getElementById(elementId);
+        if (el) el.style.backgroundImage = `url('${objectURL}')`;
+    } catch (err) {
+        console.error("Error loading secure image", err);
+    }
+}
+
+window.komgaLoadLatestBooks = async function () {
+    try {
+        const response = await fetch('api/v2/plugins/komga/books/latest', {
+            method: 'GET',
+            headers: { 'Accept': 'application/json' }
+        });
+        const res = await response.json();
+
+        if (response.ok && res.response?.data) {
+            const data = res.response.data;
+            if (data.tabName) KOMGA_TAB_NAME = data.tabName;
+            const books = Array.isArray(data.books) ? data.books : [];
+            if (books.length > 0) {
+                renderKomgaBooks(books, data.title, data.baseUrl);
+            }
+        }
+    } catch (e) {
+        console.error('Error Komga API:', e);
+    }
+}
+
+window.komgaOpenBook = function (komgaBaseUrl, bookId) {
+    const targetUrl = `${komgaBaseUrl}${bookId}`;
+    const sideBarLinks = document.querySelectorAll('.sidebar-nav a, .tab-menu-item, .nav-link');
+    let found = false;
+    sideBarLinks.forEach(link => {
+        if (link.textContent.trim() === KOMGA_TAB_NAME || link.textContent.includes('Komga')) {
+            link.click();
+            found = true;
+        }
+    });
+    if (!found) window.location.hash = `#${KOMGA_TAB_NAME}`;
+
+    setTimeout(() => {
+        const iframe = document.querySelector('iframe[src*="komga"]');
+        if (iframe) iframe.src = targetUrl;
+    }, 700);
+};
+
+function renderKomgaBooks(books, titleDisplay, komgaBaseUrl) {
+    const container = document.getElementById('homepage-items');
+    if (!container) return;
+
+    let html = `
+    <div class="row" style="margin-bottom: 30px; margin-top: 20px;">
+        <div class="col-lg-12">
+            <div style="display: flex; align-items: center; margin-bottom: 15px; padding-left: 5px;">
+                <img src="plugins/images/komga.svg" style="width: 22px; height: 22px; margin-right: 10px;" onerror="this.style.display='none'">
+                <span style="text-transform: uppercase; font-weight: bold; font-size: 13px; letter-spacing: 1px; color: #eee;" lang="en">${titleDisplay}</span>
+            </div>
+            <div class="komga-container" style="display: flex; flex-wrap: nowrap; overflow-x: auto; gap: 12px; padding: 5px;">`;
+
+    books.forEach((book, index) => {
+        const imgId = `komga-img-${index}`;
+        const metadata = book.metadata || {};
+        const title = metadata.title || book.name || window.lang.translate('Untitled');
+        const series = book.seriesTitle || '';
+        const number = metadata.number ? `n°${metadata.number}` : '';
+
+        html += `
+            <div style="flex: 0 0 150px; max-width: 150px; cursor: pointer;" onclick="komgaOpenBook('${komgaBaseUrl}', '${book.id}')">
+                <div id="${imgId}" class="komga-card-hover" 
+                     style="background-color: #333; background-size: cover; background-position: center; width: 100%; aspect-ratio: 2/3; border-radius: 4px; box-shadow: 0 4px 10px rgba(0,0,0,0.5); margin-bottom: 8px; transition: transform 0.2s ease;">
+                </div>
+                <div style="overflow: hidden; text-overflow: ellipsis; white-space: nowrap; padding: 0 4px;">
+                    <span style="font-size: 12px; font-weight: bold; color: #fff; display: block; overflow: hidden; text-overflow: ellipsis;">${title}</span>
+                    <span style="font-size: 11px; color: #aaa; display: block; overflow: hidden; text-overflow: ellipsis;">${series} ${number}</span>
+                </div>
+            </div>`;
+
+        const thumbUrl = book.thumbnailUrl || `/api/v1/books/${book.id}/thumbnail`;
+        window.komgaFetchAuthImage(thumbUrl, imgId);
+    });
+
+    html += `</div></div></div>`;
+
+    let hookContainer = document.getElementById('komgaLatestBookContainer');
+    if (!hookContainer) {
+        hookContainer = document.createElement('div');
+        hookContainer.id = 'komgaLatestBookContainer';
+        hookContainer.className = 'homepage-item';
+
+        const activeSessions = document.querySelector('.active-sessions-item');
+        if (activeSessions) {
+            activeSessions.after(hookContainer);
+        } else {
+            container.appendChild(hookContainer);
+        }
+    }
+
+    hookContainer.innerHTML = html;
+    hookContainer.classList.remove('hidden');
+}
+
+// Inject custom CSS
+const style = document.createElement('style');
+style.innerHTML = `
+    .komga-card-hover:hover { transform: scale(1.05) !important; }
+    .komga-container::-webkit-scrollbar { display: none; }
+    .komga-container { scrollbar-width: none; }
+`;
+document.head.appendChild(style);
+
+// Initial load handler
+setTimeout(() => {
+    if (document.getElementById('homepage-items')) {
+        window.komgaLoadLatestBooks();
+    }
+}, 800);

api/plugins/komga/plugin.json

@@ -0,0 +1,14 @@
+{
+  "Komga": {
+    "repo": "https://github.com/JamesDAdams/organizrv2-plugin-komga",
+    "author": "JamesAdams",
+    "category": "Entertainment",
+    "description": "Add the latest Komga books to the homepage",
+    "icon": "plugins/images/komga.svg",
+    "version": "1.0.9",
+    "minimum_organizr_version": "2.1.0",
+    "github_folder": "komga",
+    "project_folder": "komga",
+    "license": "personal"
+  }
+}