From 9acec37e18c95eefca4b7092c809cf02d4e75870 Mon Sep 17 00:00:00 2001 From: M_Viper Date: Sun, 25 Oct 2026 20:22:13 +0000 Subject: [PATCH] Upload via GUI (1 Datei) --- README.md | 23 ++++++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 2e64b180..5a63313e 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ ![DeskHub Kundenportal](DeskHub-Webseite/docs/images/customer-portal.png) -**Aktuelle Versionen:** Server **1.0.47** · Android-App **3.4.4** · Windows-Programm **2.10.2** · Minecraft-Plugin **1.0.0** +**Aktuelle Versionen:** Server **1.0.47** · Android-App **3.4.4** · Windows-Programm **2.11.0** · Minecraft-Plugin **1.0.0** > Diese Anleitung ist auch für Einsteiger geeignet. Über das Inhaltsverzeichnis kommt ihr direkt zum gewünschten Thema. Die Abschnitte [Plugins entwickeln](#plugins-entwickeln) und [API und Webhooks](#api-und-webhooks-für-entwickler) richten sich an Entwickler. @@ -26,6 +26,7 @@ - **Import aus osTicket** inklusive Abteilungen, Nachrichten und Anhängen - **Windows-Programm und Android-App** mit hellem und dunklem Design, Push-Benachrichtigungen, Verwaltung nach Rechten und Android-**Widget** in drei Größen, direkt aus dem Mitarbeiterbereich herunterladbar - **Minecraft-Plugin** (Paper, Spigot, BungeeCord in einer Datei) zum Melden von Spielern und Problemen als Ticket +- **Chrome-Erweiterung** (auch Edge und Brave; Windows, Mac, Linux) mit Zähler, Benachrichtigungen, Suche und Ticket anlegen; **Windows-Programm auch für Linux und Mac** (Mac nur selbst zu bauen) ## Einblicke @@ -96,6 +97,8 @@ Klick auf die Vorschau öffnet das Video ([deskhub-demo.mp4](DeskHub-Webseite/do - [Windows-App und Android-App](#windows-app-und-android-app) - [Update-Hinweis in den Apps](#update-hinweis-in-den-apps) - [Minecraft-Plugin zum Herunterladen](#minecraft-plugin-zum-herunterladen) + - [Chrome-Erweiterung](#chrome-erweiterung) + - [Windows-Programm für Linux und Mac](#windows-programm-für-linux-und-mac) - [System-Update und Datenbank-Update](#system-update-und-datenbank-update) - [Import aus osTicket](#import-aus-osticket) - [Plugins verwenden](#plugins-verwenden) @@ -554,6 +557,24 @@ Beide Apps (ab Windows 2.10.0 und Android 3.4.0) fragen beim Start und danach al ### Minecraft-Plugin zum Herunterladen Auf der Seite „Apps“ kann zusätzlich das Minecraft-Plugin (`DeskHub-Minecraft.jar`, siehe `minecraft-plugin/README.md`) erscheinen: mit Version, Größe, Prüfsumme und Kurzanleitung (Jar in `plugins`, `config.yml` ausfüllen, API-Schlüssel mit dem Recht „Tickets anlegen“, `/deskhubmc test`). Die Karte lässt sich unter **Einstellungen → System** („Minecraft-Plugin auf der Apps-Seite anzeigen“) ein- und ausblenden; ausgeblendet ist auch der Download gesperrt. Standard: aus. Die Jar veröffentlicht ihr wie die Apps in der Plugin-Webseite unter **Apps** (Plattform „Minecraft-Plugin (JAR)“). + +### Chrome-Erweiterung + +Im Ordner `chrome-erweiterung/` liegt eine Erweiterung für Chrome, Edge und Brave (Manifest V3), die auf Windows, Mac und Linux läuft; ausführlich in `chrome-erweiterung/README.md`. Sie zeigt am Symbol einen **Zähler** für neue Tickets (Abfrage jede Minute), meldet Neues per **Benachrichtigung**, hat eine **Übersicht** (meine offenen, überfällige, nicht zugewiesene und als Nächstes fällige Tickets), eine **Suche** und ein Formular zum **Anlegen von Tickets**, auch per Rechtsklick auf markierten Text („Als DeskHub-Ticket anlegen“). Ein Klick auf ein Ticket öffnet es in der Weboberfläche, ohne erneute Anmeldung (einmalige Adresse wie in den Apps). + +- **Installieren:** `chrome://extensions` → Entwicklermodus → „Entpackte Erweiterung laden“ → Ordner `chrome-erweiterung`. Anmelden mit Server-Adresse, E-Mail und Passwort (bei Authenticator mit Code). Chrome fragt einmal nach der Erlaubnis für **genau diesen Server**; sie wird beim Abmelden zurückgegeben. +- **Sicherheit:** Nur HTTPS, keine Cookies, keine Weiterleitungen; das Token liegt nur im lokalen Speicher der Erweiterung, Abmelden sperrt es auf dem Server. +- **Grenzen:** Meldungen nur bei geöffnetem Browser; Antworten, Zuweisen und Status ändern gehen in der Weboberfläche. Nicht im Chrome Web Store; `node pack.mjs` erzeugt ein ZIP dafür. + +### Windows-Programm für Linux und Mac + +Das Windows-Programm (Electron) lässt sich auch für Linux und Mac bauen. Dort nutzt es den normalen Fensterrahmen statt der eigenen Titelleiste, ein PNG-Symbol und auf dem Mac ein Bearbeiten-Menü (sonst gehen Kopieren und Einfügen nicht). + +- **Linux:** `npm run build:linux` im Ordner `desktop/` erzeugt ein AppImage und ein `tar.gz`. **Auf Linux bauen**, dann stimmen die Dateirechte (AppImage kann nur dort gebaut werden). Ein unter Windows gebautes `tar.gz` hat keine Ausführungsrechte: nach dem Entpacken `sh start-deskhub.sh` starten (das Skript liegt im Archiv und setzt die Rechte). Falls Chrome-Sandbox oder Schlüsselbund fehlen: ohne Schlüsselbund wird das Token in einer Datei gespeichert, die nur dein Benutzer lesen kann. +- **Mac:** `npm run build:mac` erzeugt `dmg` und `zip`, aber **nur auf einem Mac** (Signieren und Beglaubigen geht nur dort und braucht ein Apple-Entwicklerkonto). Ohne Signatur zeigt macOS beim ersten Start eine Warnung; öffnen per Rechtsklick → „Öffnen“. +- **Autostart:** Unter Linux legt das Programm dafür `~/.config/autostart/deskhub.desktop` an. +- **Update-Hinweis:** Gibt es nur für Windows (der Server liefert dort das Windows-Setup). Auf Linux und Mac neue Version selbst installieren. +- **Noch nicht getestet:** Ich konnte das Programm nicht auf Linux oder Mac starten; gebaut und geprüft ist das Archiv, nicht der Betrieb. --- ## System-Update und Datenbank-Update