Uplink7 Skeleton Loader Standalone PHP Dokumentation

Der Uplink7 Skeleton Loader ist eine moderne, leichtgewichtige Standalone-PHP-Lösung zur Anzeige von eleganten Shimmer-Ladebildschirmen (Skeleton Screens), während der eigentliche Webseiten-Inhalt im Hintergrund lädt.

Die Lösung verfügt über einen passwortgeschützten Administrationsbereich, anpassbare Farbschemata, verschiedene Layout-Varianten, automatische Dark-Mode-Erkennung und flexible URL-Ausschlussregeln.

⚙️ Hauptfunktionen

Keine Abhängigkeiten: Läuft nativ auf jedem Server ab PHP 7.0+, ohne Datenbank oder WordPress.

JSON-Speicherung: Alle Konfigurationen werden übersichtlich in der Datei ul7_settings.json gespeichert.

Passwortgeschütztes Admin-Panel: Einstellungen können über den Parameter ?ul7_admin=1 in einer grafischen Oberflache verwaltet werden.

Interaktive Hilfe-Buttons: Integrierte ?-Symbole zum Ein- und Ausblenden von Hilfetexten per Klick/Tipp.

4 Layout-Stile: Classic (Blog), Ecommerce (Grid), Minimalist (Text) und Hero (Großes Bild).

Auto-Dark-Mode: Erkennt automatisch die Systemeinstellungen des Besuchers (prefers-color-scheme: dark).

Seiten-Ausschluss (Page Exclude): Flexible URL/Pfad-Prüfung zum Deaktivieren des Loaders auf spezifischen Seiten (z. B. Checkout oder Login).

Ausblend-Animationen: Wahlweise Fade Out (Sanftes Ausblenden) oder Slide Up (Hochschieben wie ein Vorhang).

🛠️ Installation & Einbindung

1. Dateistruktur auf dem Server

Lade die Datei uplink7-skeleton-loader-premium.php in das Wurzelverzeichnis (Root) oder den gewünschten Ordner deines Webservers:

/dein-webseiten-ordner/
│── uplink7-skeleton-loader-premium.php
└── ul7_settings.json <-- (Wird beim ersten Aufruf automatisch erstellt) 2. Einbindung in PHP-Seiten Füge ganz oben in der PHP-Datei deiner Webseite (z. B. in der index.php oder im globalen Header) die Zeile im readme.txt date ein. 🔐 Admin-Bereich & Dashboard Zugriff auf das Dashboard Der Admin-Bereich wird über den URL-Parameter ?ul7_admin=1 aufgerufen: Direkter Dateiaufruf: https://deinedomain.de/uplink7-skeleton-loader-premium.php?ul7_admin=1 Aufruf über eine eingebundene Seite: https://deinedomain.de/index.php?ul7_admin=1 Standard-Zugangsdaten Standard-Passwort: admin123 ⚠️ Wichtig: Bitte ändere das Standard-Passwort direkt nach dem ersten Login im Dashboard unter dem Punkt Sicherheit. 📋 Einstellungen im Überblick Option Typ Beschreibung Loader Aktivieren Checkbox Hauptschalter zum globalen Ein- oder Ausschalten des Skeleton Loaders. Layout Stil Dropdown Wählt das optische Erscheinungsbild: Classic, Ecommerce, Minimalist oder Hero. Logo URL Textfeld Link zu einem Logo (PNG/SVG/WebP), das zentriert während des Ladens pulsiert. Hintergrundfarbe Farbwähler Legt die Haupt-Hintergrundfarbe des Ladebildschirms fest (Standard: #ffffff). Shimmer-Farbe Farbwähler Grundfarbe der animierten Ladebalken/Platzhalter. Auto-Dark Mode Checkbox Aktiviert ein dunkles Farbschema, wenn beim Nutzer Dark Mode aktiv ist. Ausblend-Animation Dropdown Steuert den Effekt beim Ladenende (Fade Out oder Slide Up). Pfade ausschließen Textarea Kommagetrennte Liste von URL-Pfaden, auf denen kein Loader erscheinen soll. Neues Passwort Passwortfeld Feld zum Ändern des Administrations-Passworts. 🚫 Konfiguration der Ausschluss-Regeln (Page Exclude) Im Feld Seiten/Pfade ausschließen kannst du Begriffe, Pfade oder Dateinamen kommagetrennt eingeben. Beispiele für Ausschluss-Muster: Startseite ausschließen: index.php oder / Spezifische Verzeichnisse/Seiten ausschließen: /checkout, /warenkorb, login.php Kombinierter Ausschluss: index.php, /shop/checkout, kontakt.php 📁 JSON-Datenstruktur (ul7_settings.json) Die Einstellungen werden beim Speichern im selben Verzeichnis in der Datei ul7_settings.json abgelegt: “admin_password”: “$2y$10$YourHashedPasswordHere…”,
“ul7_style”: “classic”,
“ul7_logo_url”: “https://deinedomain.de/logo.png”,
“ul7_bg_col”: “#ffffff”,
“ul7_shm_col”: “#f0f0f0”,
“ul7_dark_mode”: 1,
“ul7_anim_type”: “fade”,
“ul7_enabled”: 1,
“ul7_ex_urls”: “/checkout, /warenkorb”

❓ Fehlerbehebung (Troubleshooting)

Die ul7_settings.json wird nicht gespeichert:

Stelle sicher, dass der Ordner auf dem Server ausreichende Schreibrechte besitzt (z. B. CHMOD 755 oder 775).

Der Admin-Bereich lässt sich nicht öffnen:

Überprüfe, ob der Parameter ?ul7_admin=1 exakt so in der URL steht.

Stelle sicher, dass PHP in Version 7.0 oder höher installiert ist.

Der Loader verschwindet nicht:

Der Loader wartet auf das window.onload-Event der Webseite oder bricht nach maximal 4,5 Sekunden automatisch ab. Überprüfe die Entwickler-Konsole des Browsers auf eventuelle JavaScript-Fehler auf deiner Hauptseite.