AvatarMaker v2.0

# 🎭 AvatarMaker v2.0
### Avatar-Generator für Foren, Communities & Webseiten

AvatarMaker ermöglicht es Besuchern, aus vorgefertigten Vorlagen eigene personalisierte Avatare
zu erstellen – mit eigenem Text, sofortigem Download und optionaler Server-Speicherung.
Kein Login, kein Abo, sofort einsatzbereit.

---

## ✨ Features

| Feature | Beschreibung |
|---|---|
| 🎨 **Vorlagen-System** | Beliebig viele Vorlagen hochladbar, 24 bereits inklusive |
| ✍️ **2 Texte pro Avatar** | Name, Titel oder Motto frei eingebbar (max. 20 Zeichen) |
| 👁 **Live-Vorschau** | Echtzeit-Vorschau während der Texteingabe per AJAX |
| 💾 **Server-Speicherung** | Erstellte Avatare optional speichern + Link anzeigen |
| ⬇️ **Direktdownload** | Avatar sofort herunterladen ohne Login |
| 🎭 **24 Beispiel-Avatare** | Farben, Gesichter, Muster, Pixel-Art, Tiere uvm. |
| ⚙️ **Admin-Bereich** | Vorlagen verwalten, bearbeiten, löschen |
| 🔍 **Auto-Scan** | scan.php trägt neue Bilder automatisch in die DB ein |

---

## 🚀 Installation

### 1. Voraussetzungen

| Anforderung | Version |
|---|---|
| PHP | 7.4 oder höher |
| GD Extension | Pflicht (für Bildverarbeitung) |
| PDO SQLite Extension | Pflicht |
| Schreibrechte | `storage/`, `avatars/templates/`, `avatars/created/` |

### 2. Dateien hochladen

Alle Dateien in ein Verzeichnis auf dem Webserver hochladen:
```
https://ihre-domain.de/avatarmaker/
```

### 3. config.php anpassen

```php
define('AM_URL', 'https://ihre-domain.de/avatarmaker'); // Ihre URL
define('SITE_URL', 'https://ihre-domain.de'); // Link zur Hauptseite
define('ADMIN_PASS', 'IhrSicheresPasswort'); // !! Bitte ändern !!
define('SAVE_ENABLED', true); // false = keine Server-Speicherung
```

### 4. Ordner-Rechte setzen

```bash
chmod 755 storage/
chmod 755 avatars/templates/
chmod 755 avatars/created/
```

### 5. Datenbank initialisieren

```
https://ihre-domain.de/avatarmaker/install.php
```

Die SQLite-Datenbank wird erstellt und alle 24 Beispiel-Vorlagen werden registriert.
**Danach `install.php` löschen!**

### 6. Fertig – aufrufen

```
https://ihre-domain.de/avatarmaker/ ← Frontend
https://ihre-domain.de/avatarmaker/admin/ ← Admin-Bereich
```

---

## 📁 Dateistruktur

```
avatarmaker/
├── config.php ← Konfiguration (URL, Passwort, Einstellungen)
├── index.php ← Frontend: Vorlage wählen & Avatar erstellen
├── install.php ← Einmalige DB-Installation (danach löschen!)
├── scan.php ← mehrere Neue Templates auto-eintragen (danach löschen!)
│
├── includes/
│ └── avatar_engine.php ← GD-Bildverarbeitung (Text, Farben, Skalierung)
│
├── admin/
│ ├── index.php ← Admin-Dashboard (Stats, Vorlagen, Avatare)
│ ├── template-upload.php ← Neue Vorlage hochladen
│ └── template-edit.php ← Vorlage bearbeiten
│
├── avatars/
│ ├── templates/ ← Vorlagen-Bilder (PNG/JPG/GIF)
│ └── created/ ← Erstellte Avatare der Besucher
│
├── storage/
│ └── avatarmaker.db ← SQLite Datenbank (auto-erstellt)
│
└── .htaccess ← Sicherheit (config.php & DB schützen)
```

---

## 🎨 Vorlagen-Übersicht (24 inklusive)

### Farb-Vorlagen (1–12)
Einfarbige Hintergründe mit geometrischen Formen und Anfangsbuchstaben.

| # | Name | Farbe |
|---|---|---|
| 1 | Ocean | Blau |
| 2 | Fire | Rot-Orange |
| 3 | Forest | Grün |
| 4 | Purple | Lila |
| 5 | Teal | Türkis |
| 6 | Gold | Gold |
| 7 | Dark | Dunkelblau |
| 8 | Red | Rot |
| 9 | Mint | Mintgrün |
| 10 | Navy | Dunkelblau |
| 11 | Amber | Orange |
| 12 | Wine | Weinrot |

### Charakter & Muster (13–24)

| # | Name | Beschreibung |
|---|---|---|
| 13 | Smiley | Klassisches Lächeln-Gesicht |
| 14 | Cool-Face | Gesicht mit Sonnenbrille |
| 15 | Pixel-Art | Retro 8-Bit Gesicht |
| 16 | Roboter | Sci-Fi Roboterkopf mit LEDs |
| 17 | Katze | Katzenkopf mit Schnurrhaaren |
| 18 | Alien | Großäugiges Alien-Gesicht |
| 19 | Hexagon | Abstraktes Lila-Muster |
| 20 | Neon-Dreiecke | Geometrisch auf schwarz |
| 21 | Mandala | Buntes Kreismuster |
| 22 | Wellen | Ozean-Muster mit Mond |
| 23 | Gaming | Controller-Design |
| 24 | Blume | Pinkes Blumenmuster |

---

## ⚙️ Admin-Bereich

### Login
```
https://ihre-domain.de/avatarmaker/admin/
Passwort: wie in config.php → ADMIN_PASS eingestellt
```

### Funktionen

**Dashboard (`admin/index.php`)**
- Statistiken: Anzahl Vorlagen, erstellte Avatare gesamt, heute
- Vorlagen-Übersicht mit Thumbnail, Bearbeiten- und Löschen-Button
- Tabelle aller erstellten Avatare mit Vorschau, Texten, IP und Datum

**Neue Vorlage hochladen (`admin/template-upload.php`)**
- PNG, JPG oder GIF hochladen (max. 2 MB)
- Wird automatisch auf 120×120 Pixel skaliert
- Text-Positionen für Text 1 und Text 2 einstellen (X/Y-Koordinaten)
- Ausrichtung: Links, Mitte oder Rechts
- Schriftgröße (8–24 px), Schriftfarbe, Konturfarbe
- Sortierungsreihenfolge

**Vorlage bearbeiten (`admin/template-edit.php`)**
- Alle Einstellungen nachträglich ändern
- Neues Bild hochladen (ersetzt das alte)
- Vorlage aktiv/inaktiv schalten (inaktive sind im Frontend nicht sichtbar)

---

## 🔍 Neue Vorlagen per scan.php einbinden

Wenn du mehrere Bilder auf einmal in `avatars/templates/` hochlädst, kannst du sie
mit `scan.php` automatisch registrieren lassen – statt jede einzeln im Admin einzutragen.

**Ablauf:**
1. Bilder in `avatars/templates/` hochladen
2. `https://ihre-domain.de/avatarmaker/scan.php` aufrufen
3. Bereits registrierte Dateien werden übersprungen, neue eingetragen
4. **`scan.php` danach löschen!**

Namen und Einstellungen kannst du anschließend im Admin unter **✏️ Bearbeiten** anpassen.

---

## 🔧 Konfigurationsreferenz

```php
// config.php – alle Optionen

define('AM_URL', 'https://ihre-domain.de/avatarmaker'); // Basis-URL (kein /)
define('SITE_URL', 'https://ihre-domain.de'); // Link "← Zur Webseite"
define('SAVE_ENABLED', true); // true = Avatare auf Server speichern
define('MAX_FILE_SIZE', 2097152); // Max. Upload-Größe in Bytes (Standard: 2 MB)
define('AVATAR_SIZE', 120); // Ausgabegröße in Pixel (quadratisch)
define('ADMIN_PASS', 'admin123'); // Admin-Passwort – bitte ändern!
```

---

## 🔒 Sicherheitshinweise

- Admin-Passwort in `config.php` sofort nach Installation ändern
- `install.php` nach der Installation löschen
- `scan.php` nach Nutzung löschen
- `storage/` Ordner ist per `.htaccess` vor Direktzugriff geschützt
- `config.php` ist per `.htaccess` vor Direktzugriff geschützt

**Empfohlene Ordner-Rechte:**
```
storage/ → 755
avatars/created/ → 755
avatars/templates/→ 755
```

---

## ❓ Häufige Fragen

**Warum erscheint kein Avatar nach dem Erstellen?**
Prüfe ob `avatars/created/` Schreibrechte hat (`chmod 755`).
Prüfe ob die GD-Extension in PHP aktiv ist.

**Kann ich die Avatar-Größe ändern?**
Ja – `AVATAR_SIZE` in `config.php` anpassen. Standard ist 120×120 Pixel.
Vorlagen-Bilder werden automatisch auf diese Größe skaliert.

**Kann ich eigene Schriftarten einbinden?**
Ja – TTF-Dateien in den `fonts/` Ordner legen und in `config.php` unter `FONTS`
eintragen. Im Admin kann dann pro Vorlage eine Schriftart gewählt werden.

**Wie deaktiviere ich die Server-Speicherung?**
`define('SAVE_ENABLED', false)` in `config.php` – Avatare werden dann nur
angezeigt aber nicht gespeichert, kein Download-Link wird generiert.

**Wie setze ich den erstellten Avatar in ein Forum ein?**
Den angezeigten Link kopieren und im Forum als Avatar-URL eintragen –
die meisten Foren unterstützen externe Bild-URLs.

---

## 🗺 Geplante Erweiterungen (Roadmap)

> Diese Features sind noch nicht implementiert und können in einer späteren Version hinzugefügt werden.

- **Benutzer-Login** – eigene Avatar-Sammlung pro Account
- **Farbfilter** – Helligkeit, Kontrast, Sättigung per Schieberegler anpassen
- **Sticker/Overlays** – zusätzliche Grafik-Elemente auf den Avatar legen
- **Rahmen-System** – verschiedene Rahmen um den Avatar wählbar
- **Galerie** – öffentliche Übersicht aller erstellten Avatare
- **API-Endpunkt** – Avatar per GET-Parameter programmatisch generieren
- **Wasserzeichen** – automatisches Logo auf alle erstellten Avatare

---

## 📄 Lizenz

MIT License – frei verwendbar, anpassbar und weitervertreibbar.
Bei Weitergabe bitte diese README beilegen.

---

*AvatarMaker v2.0 · PHP 7.4+ · GD · SQLite · Kein Login erforderlich*