Dokumentation der erforderlichen GitHub Token Berechtigungen (Fine-grained Tokens)

README.md

@@ -98,10 +98,52 @@ Für das Hochladen zu GitHub:
    - **Branch**: Ziel-Branch (z.B. `main`)
    - **Author**: Dein Name für die Metadaten
 
-### 3. GitHub-Token für private Repositories (optional)
-1. GitHub → Settings → Developer settings → Personal access tokens
-2. Token mit Repository-Berechtigung erstellen
-3. Token in den Addon-Einstellungen hinterlegen
+### 3. GitHub-Token konfigurieren (optional, aber empfohlen)
+
+#### Wann wird ein Token benötigt?
+- **Private Repositories**: Zugriff auf nicht-öffentliche Repositories
+- **Höhere Rate-Limits**: GitHub erlaubt mehr API-Anfragen mit Token
+- **Upload-Funktionalität**: Zum Hochladen von Modulen/Templates/Classes zu GitHub
+
+#### Token erstellen
+1. GitHub → **Settings** → **Developer settings** → **Personal access tokens** → **Fine-grained tokens**
+2. **Generate new token**
+3. Token-Name vergeben (z.B. "REDAXO GitHub Installer")
+4. **Repository access** auswählen:
+   - **All repositories** (für alle Repositories) oder
+   - **Only select repositories** (für bestimmte Repositories)
+5. **Erforderliche Berechtigungen auswählen**:
+
+   **Repository permissions:**
+
+   **Nur zum Installieren (Lesen):**
+   - ✅ **Contents**: `Read-only` (Repository-Inhalte lesen)
+   - ✅ **Metadata**: `Read-only` (automatisch gesetzt)
+
+   **Zum Installieren UND Hochladen:**
+   - ✅ **Contents**: `Read and write` (Repository-Inhalte lesen und schreiben)
+   - ✅ **Metadata**: `Read-only` (automatisch gesetzt)
+
+   **Alle anderen Berechtigungen sind NICHT erforderlich**:
+   - ❌ Actions
+   - ❌ Administration
+   - ❌ Codespaces
+   - ❌ Commit statuses
+   - ❌ Discussions
+   - ❌ Environments
+   - ❌ Issues
+   - ❌ Pull requests
+   - ❌ etc.
+
+5. **Expiration** festlegen (empfohlen: 90 Tage oder weniger)
+6. Token generieren und **sofort kopieren** (wird nur einmal angezeigt!)
+7. Token in REDAXO einfügen: Backend → Addons → GitHub Installer → **Einstellungen**
+
+#### Sicherheitshinweise
+- ⚠️ Token niemals öffentlich teilen oder in Code committen
+- 🔒 Token mit minimalen Berechtigungen erstellen
+- 🔄 Token regelmäßig erneuern (Ablaufdatum setzen)
+- 🗑️ Ungenutzte Token löschen
 
 ## 🎯 Verwendung
 

lang/de_de.lang

@@ -122,8 +122,9 @@ cache_no_cache = Keine Cache-Dateien gefunden
 # Settings
 settings_title = Einstellungen
 github_token = GitHub Personal Access Token
-github_token_help = Erforderlich für höhere Rate-Limits und private Repositories
+github_token_help = Erforderlich für höhere Rate-Limits und private Repositories. <strong>Erforderliche Berechtigungen:</strong> Repository permissions: "Contents" (Read-only für Installieren, Read and write für Upload). Alle anderen Berechtigungen sind <strong>nicht</strong> erforderlich.
 github_token_placeholder = GitHub Token eingeben (optional)
+github_token_create_info = Token erstellen: GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token
 cache_lifetime = Cache-Lebensdauer (Sekunden)
 cache_lifetime_help = Wie lange Repository-Daten gecacht werden sollen
 save_settings = Einstellungen speichern

lang/en_gb.lang

@@ -86,8 +86,9 @@ cache_no_cache = No cache files found
 # Settings
 settings_title = Settings
 github_token = GitHub Personal Access Token
-github_token_help = Required for higher rate limits and private repositories
+github_token_help = Required for higher rate limits and private repositories. <strong>Required permissions:</strong> Repository permissions: "Contents" (Read-only for installing, Read and write for upload). All other permissions are <strong>not</strong> required.
 github_token_placeholder = Enter your GitHub token (optional)
+github_token_create_info = Create token: GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token
 cache_lifetime = Cache Lifetime (seconds)
 cache_lifetime_help = How long to cache repository data
 save_settings = Save Settings

pages/settings.php

@@ -34,7 +34,8 @@
 $n['field'] = '<input type="password" id="github-token" name="config[github_token]" class="form-control" 
                       placeholder="' . $addon->i18n('github_token_placeholder') . '" 
                       value="' . rex_escape($addon->getConfig('github_token', '')) . '">
-               <p class="help-block">' . $addon->i18n('github_token_help') . '</p>';
+               <p class="help-block">' . $addon->i18n('github_token_help') . '</p>
+               <p class="help-block"><small><strong>' . $addon->i18n('github_token_create_info') . '</strong></small></p>';
 $formElements[] = $n;
 
 // Cache Lifetime