AvatarMaker v2.0PHP-Script

Beschreibung

# ???? 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*

0 Bewertungen
5 Hits
15.02.2026
Preis: EUR 21,99
Homepage Demo Download Frage stellen Link defekt?