1. Erweiterungsübersicht

Name der Erweiterung: [AASHRO] Xmas
Zweck: Fügen Sie Ihrer TYPO3-Website einen individuell anpassbaren weihnachtlichen Schneefall-Effekt hinzu.

AASHRO (Xmas) funktioniert automatisch und erfordert weder ein Frontend-Plugin noch ein Inhaltselement.

Zielgruppen:

• Redakteure
• Integratoren
• Entwickler

2. Funktionen

• Automatischer weihnachtlicher Schneefall-Effekt
• Auswahl verschiedener Schneeflocken-Symbole/Stile
• Anpassbare Farbe der Schneeflocken
• Konfigurierbare Schneefallgeschwindigkeit
• Konfigurierbare Fallrichtung
• Kein Frontend-Plugin erforderlich
• Geeignet für Desktop- und mobile Websites

3. TYPO3-Kompatibilität

• TYPO3 v10
• TYPO3 v11
• TYPO3 v12
• TYPO3 v13
• TYPO3 v14

4. Installation

Composer

Für Composer-basierte Projekte:

composer require xmas/at-xmas

Für DDEV:

ddev composer require xmas/at-xmas

Nicht-Composer-Installation

1. Öffnen Sie das TYPO3-Backend.
2. Gehen Sie zum Extension Manager.
3. Suchen Sie nach AASHRO (Xmas).
4. Installieren und aktivieren Sie die Erweiterung.
5. Leeren Sie den TYPO3-Cache.

5. Einrichtung

Nach der Installation:

1. Binden Sie das TypoScript von AASHRO (Xmas) ein.
2. Öffnen Sie den Constant Editor.
3. Konfigurieren Sie die Schneefall-Einstellungen.
4. Wählen Sie die gewünschten Seiten aus.
5. Leeren Sie den TYPO3-Cache.
6. Öffnen Sie die Website im Frontend.

Es muss kein Plugin oder Inhaltselement hinzugefügt werden.

6. Konfiguration

Die verfügbaren Einstellungen können Folgendes umfassen:

• Schneefall aktivieren/deaktivieren
• Schneeflocken-Symbol/-Typ
• Farbe der Schneeflocken
• Schneefallgeschwindigkeit
• Fallrichtung
• Anzahl/Dichte der Schneeflocken

7. Fehlerbehebung

Wenn der Schneefall nicht sichtbar ist:

• Prüfen Sie, ob die Erweiterung aktiviert ist.
• Prüfen Sie, ob das TypoScript eingebunden wurde.
• Stellen Sie sicher, dass der Schneefall aktiviert ist.
• Überprüfen Sie die Seitenkonfiguration.
• Leeren Sie den TYPO3-Cache.
• Überprüfen Sie die Browser-Konsole auf JavaScript-Fehler.

8. Best Practices

• Verwenden Sie eine moderate Schneeflockendichte.
• Testen Sie den Effekt auf mobilen Geräten.
• Vermeiden Sie, dass wichtige Inhalte verdeckt werden.
• Berücksichtigen Sie Benutzer mit aktivierter Einstellung für reduzierte Animationen.
• Verwenden Sie den Schneefall hauptsächlich auf saisonalen oder weihnachtlichen Seiten.

9. Zusammenfassung

AASHRO (Xmas) bietet eine einfache und flexible Möglichkeit, Ihrer TYPO3-Website einen festlichen Schneefall-Effekt hinzuzufügen, ohne dass ein Frontend-Plugin erforderlich ist.

Unterstützte TYPO3-Versionen: v10, v11, v12, v13 und v14.