## Projektbeschreibung

Vollständiges Kleinanzeigen-Portal für private und gewerbliche Anzeigen. Nutzer können Artikel verkaufen, kaufen oder tauschen. Mit Kategorien, Bildern, Kontaktformular und Preisangaben.

## Hauptfunktionen

- **Anzeigen-Übersicht** - Alle Inserate auf einen Blick
- **Kategorie-Filter** - Nach Rubriken filtern
- **Detailansicht** - Vollständige Anzeigeninformationen
- **Bild-Upload** - Fotos zu Anzeigen hinzufügen
- **Kontakt-Formular** - Direkte Nachricht an Verkäufer
- **Admin-Panel** - Moderation und Verwaltung

## Technische Details

- **PHP:** 8.4+
- **Datenbank:** MySQL
- **Sicherheit:** PDO, CSRF, Bcrypt
- **Design:** Hellblaues Theme
- **Tabellen-Präfix:** Anpassbar

## Installation

1. Dateien hochladen
2. `install.php` öffnen
3. Datenbank konfigurieren
4. Admin erstellen
5. Kategorien anpassen
6. Portal ist online!

## Features

- Kategorien-System
- Bild-Upload
- Preis-Anzeige
- Kontaktformular
- Suchfunktion
- Admin-Freigabe
- Responsive Layout

## Kategorien (Standard)

- Fahrzeuge
- Immobilien
- Elektronik
- Möbel & Haushalt
- Mode & Accessoires
- Sport & Freizeit
- Bücher & Medien
- Dienstleistungen

## Einsatzgebiete

- Lokale Marktplätze
- Community-Plattformen
- Tauschbörsen
- Second-Hand-Portale
- Gebrauchtwaren-Handel
- Flohmarkt-Online

## Anzeigen-Typen

- Verkaufen
- Kaufen
- Tauschen
- Verschenken
- Dienstleistung

## Lizenz

**Einzelplatz-Lizenz** - Verwendung für private und kommerzielle Zwecke.

---

**???? Lokal Handeln | ???? Günstig Kaufen | ♻️ Nachhaltig Tauschen**

## ✅ KOMPLETT! Alle Dateien vorhanden!

### ???? Dateien (9):

1. ✅ config.php - Funktionen
2. ✅ install.php - Installation
3. ✅ login.php - Login & Registrierung ⭐
4. ✅ index.php - Übersicht
5. ✅ add.php - Fahrzeug einstellen ⭐
6. ✅ vehicle.php - Fahrzeug-Details ⭐
7. ✅ my-cars.php - Meine Fahrzeuge ⭐
8. ✅ admin.php - Admin-Panel ⭐
9. ✅ README.md

### ???? WORKFLOW:

```
1. login.php → Registrierung
2. add.php → Fahrzeug einstellen
- 23 Marken zur Auswahl
- Foto-Upload
- Alle Details
3. my-cars.php → Verwalten
4. Admin → Freigabe
```

### ???? Features:

- ✅ 23 Auto-Marken
- ✅ Foto-Upload (5MB)
- ✅ Detaillierte Specs
- ✅ Kontakt zum Verkäufer
- ✅ Admin-Freigabe
- ✅ Statistiken

KOMPLETT & FUNKTIONSFÄHIG! ????

## ???? Projektbeschreibung

Professionelles Branchenverzeichnis und Plattform für Einträge, entwickelt mit PHP 8.4 und MySQL. Funktionen: Kategoriensuche, Suchfunktion, hervorgehobene Einträge und standortbasierte Filterung in einem dunklen Rotton.

## ✨ Funktionen

### Öffentliche Funktionen
- **Firmeneinträge**: Alle aktiven Unternehmen durchsuchen
- **Kategoriefilter**: Nach Geschäftskategorie filtern
- **Stadtfilter**: Standortbasierte Suche
- **Suchfunktion**: Suche nach Firmennamen/Beschreibung
- **Hervorgehobene Einträge**: Premium-Unternehmen hervorgehoben
- **Detailseiten**: Vollständige Unternehmensinformationen mit Kontaktdaten
- **Eintrag einreichen**: Öffentliches Formular zur Einreichung (Genehmigung erforderlich)
- **Kartenintegration**: Unterstützung für Längen- und Breitengrad

### Administratorfunktionen
- **Eintragsverwaltung**: Einträge genehmigen, bearbeiten und löschen
- **Hervorgehobene Einträge**: Unternehmen als hervorgehoben markieren
- **Kategorieverwaltung**: Benutzerdefinierte Kategorien mit Emojis hinzufügen
- **Bild-Upload**: Unternehmensfotos hochladen
- **Statusverwaltung**: Einträge aktivieren/deaktivieren

### Sicherheitsfunktionen
- ✅ PDO Prepared Statements (Schutz vor SQL-Injection)
- ✅ CSRF-Schutz (Cross-Site Request Forgery)
- ✅ Schutz vor XSS (HTML-Sonderzeichen in der gesamten Ausgabe)
- ✅ Bcrypt-Passwort-Hashing
- ✅ Sichere Sitzungen (HttpOnly, Secure, SameSite)

- ✅ Eingabevalidierung
- ✅ Sicherheit beim Datei-Upload

## ???? Installation

1. **Dateien hochladen**: Laden Sie alle Dateien auf Ihren Webserver hoch.
2. **Installer ausführen**: Öffnen Sie `install.php` in Ihrem Browser.
3. **Schritt 1**: Datenbankzugangsdaten eingeben.
4. **Schritt 2**: Administratorkonto konfigurieren.
5. **Schritt 3**: Die Installation wird automatisch abgeschlossen.
6. **Fertig**: 4 Standardkategorien erstellt.

### Voraussetzungen
- PHP 8.4 oder höher
- MySQL 5.7 oder höher
- Apache/Nginx mit mod_rewrite
- GD-Bibliothek (für Bildverarbeitung)

## ???? Dateistruktur

```
Verzeichnis/
├── index.php # Hauptverzeichnis Seite
├── detail.php # Unternehmensdetailansicht
├── submit.php # Öffentliches Einreichungsformular
├── admin.php # Admin-Bereich
├── config.php # Konfiguration
├── style.css # Dunkelrotes Design
├── install.php # Auto-Installer
├── directory.sql # Datenbankschema
├── uploads/ # Unternehmensbilder
└── README.md # Diese Datei


## ???? Design

**Design**: Dunkelrot
- Primär: #dc2626
- Sekundär: #991b1b
- Akzent: #fca5a5
- Hintergrund: Dunkler Farbverlauf (#450a0a → #7f1d1d)

**Funktionen**:
- Glassmorphism-Effekte
- Kartenbasiertes Layout
- Hervorhebung von Top-Einträgen
- Responsives Rastersystem
- Für Mobilgeräte optimiertes Design

## ???? Datenbankschema

### Tabellen
1. **Einträge**: Unternehmenseinträge
2. **Kategorien**: Unternehmenskategorien
3. **Admin**: Administratorkonten

### Eintragsfelder
- Basis: Titel, Beschreibung, Kategorie, Stadt
- Kontakt: Telefon, E-Mail, Website, Adresse
- Standort: Breitengrad, Längengrad (für Karten)
- Medien: Bild-Upload
- Status: Aktiv, Top-Einträge

## ???? Konfiguration

Bearbeiten Sie nach der Installation die Datei `config.php`:

```php
define('UPLOAD_DIR','uploads/'); // Bildverzeichnis


## ???? Benutzerhandbuch

### Einträge hinzufügen (öffentlich)
1. Klicken Sie auf „Eintrag hinzufügen“.
2. Geben Sie die Unternehmensdaten ein.
3. Laden Sie ein Bild hoch (optional).
4. Senden Sie den Eintrag zur Genehmigung.
5. Der Administrator genehmigt den Eintrag.

### Einträge verwalten (Admin)
1. Melden Sie sich im Admin-Bereich an.
2. Sehen Sie sich die ausstehenden Einreichungen an.
3. Klicken Sie auf „Genehmigen“, um den Eintrag zu aktivieren.
4. Klicken Sie auf „Hervorheben“, um den Eintrag prominent zu platzieren.
5. Kategorien verwalten

### Kategorien
Standardkategorien:

- ????️ Restaurants
- ???? Bars & Clubs
- ???? Hotels
- ⚙️ Dienstleistungen

Fügen Sie benutzerdefinierte Kategorien mit Emoji-Symbolen hinzu!


## ????️ Kartenintegration

Das System unterstützt Koordinaten (Breiten-/Längengrad) für jeden Eintrag. So integrieren Sie Karten:

1. Google Maps API-Schlüssel hinzufügen
2. detail.php mit Karteneinbettung aktualisieren
3. Standort auf der Karte anzeigen

Beispielkoordinaten:

- Breitengrad: 51.5074 (London)

- Längengrad: -0.1278

## ???? Sicherheitsmaßnahmen

- Standard-Admin-Passwort ändern

- HTTPS für den Produktivbetrieb verwenden

- Regelmäßige Datenbank-Backups erstellen

- Einsendungen auf Spam prüfen

- Alle Benutzereingaben validieren

- Korrekte Dateiberechtigungen festlegen

- PHP/MySQL aktuell halten

## ???? Fehlerbehebung

**Bilder werden nicht hochgeladen?**
- Prüfen, ob der Ordner „uploads/“ existiert
- Ordnerberechtigungen prüfen (755)
- Dateigrößenbeschränkungen prüfen

**Einträge werden nicht angezeigt?**
- Aktivstatus im Adminbereich prüfen
- Kategoriefilter prüfen
- Datenbankverbindung prüfen

**Suche funktioniert nicht?**
- Suchanfrage-Syntax prüfen
- Datenbankkodierung prüfen (utf8mb4)

## ???? Funktionsübersicht

Zukünftige Erweiterungen:

- Benutzerkonten für Unternehmen

- Bewertungen und Rezensionen

- Öffnungszeiten

- Fotogalerien

- E-Mail-Benachrichtigungen

- Erweiterte Suchfilter

- Social-Media-Links

- Business-Analyse

## ???? Lizenz

Professionelle Verzeichnisplattform
Alle Rechte vorbehalten.

## ???? Versionsverlauf

**v1.0** – Erste Veröffentlichung

- Vollständiges Eintragssystem
- Kategorienverwaltung
- Suche & Filter
- Hervorgehobene Einträge
- Öffentliche Einträge
- Genehmigungssystem für Administratoren
- Dunkelrotes Design
- Auto-Installer
- Bild-Uploads

---

**Entwickelt mit PHP 8.4 | MySQL | Moderne Sicherheitsstandards**
**Dunkelrotes Design | Responsives Design | SEO-optimiert**

## Projektbeschreibung

Ein modernes, benutzerfreundliches Branchenverzeichnis zum Eintragen und Finden lokaler Unternehmen und Dienstleister. Mit Kategorien, Bewertungssystem, Alphabetischer Suche und Admin-Panel. Perfekt für lokale Communities, Städte oder Regionen.

## Hauptfunktionen

### Öffentlicher Bereich
- **Firmensuche** - Nach Name, Branche oder Ort suchen
- **Kategorien-Filter** - Nach Branchen filtern (Handwerk, Gastronomie, etc.)
- **Alphabet-Navigation** - Schnell nach Anfangsbuchstaben suchen
- **Detailansichten** - Vollständige Firmeninformationen
- **Bewertungssystem** - 5-Sterne-Bewertungen abgeben
- **Featured-Einträge** - Hervorgehobene Unternehmen
- **Responsive Design** - Funktioniert auf allen Geräten

### Eintrag-System
- **Kostenlose Einträge** - Unternehmen können sich selbst eintragen
- **Moderation** - Admin muss Einträge freischalten
- **Umfangreiche Daten** - Kontaktdaten, Beschreibung, Website
- **Kategorisierung** - Zuordnung zu Branchen

### Admin-Panel
- **Dashboard** - Statistiken auf einen Blick
- **Einträge-Verwaltung** - Freigeben, Bearbeiten, Löschen
- **Featured-Management** - Einträge hervorheben
- **Kategorien-Verwaltung** - Neue Branchen hinzufügen
- **Moderation** - Neue Einträge prüfen

## Technische Details

**Programmiersprache:** PHP 8.4
**Datenbank:** MySQL mit 3 Tabellen
**Sicherheit:** CSRF-Schutz, Bcrypt-Passwörter, PDO prepared statements
**Design:** Pastellfarben (Lila, Rosa, Hellblau)
**Tabellen-Präfix:** `dir_` (anpassbar bei Installation)

### Datenbankstruktur
- `dir_categories` - Kategorien/Branchen
- `dir_entries` - Firmeneinträge mit allen Daten
- `dir_admin` - Admin-Zugangsdaten

### Features im Detail
- **Rating-System** - Durchschnittsbewertung aus allen Votes
- **View-Counter** - Anzahl der Aufrufe tracken
- **Featured-System** - Hervorgehobene Einträge mit Badge
- **Slug-URLs** - SEO-freundliche Kategorie-Links

## Installation

1. Alle Dateien auf Webserver hochladen
2. `install.php` im Browser aufrufen
3. Datenbank-Zugangsdaten eingeben
4. Tabellen-Präfix festlegen (Empfehlung: `dir_`)
5. Admin-Account erstellen
6. Installation abschließen
7. `install.php` löschen

**Vorinstallierte Kategorien:**
- Handwerk
- Gastronomie
- Einzelhandel
- Dienstleistungen
- Gesundheit
- Auto & Verkehr

## Verwendung

### Firma eintragen
1. "Eintrag Hinzufügen" klicken
2. Kategorie auswählen
3. Firmendaten eingeben (Name, Adresse, Kontakt)
4. Optional: Beschreibung hinzufügen
5. Absenden
6. Warten auf Admin-Freigabe

### Firma suchen
1. Suchbegriff eingeben ODER
2. Kategorie wählen ODER
3. Buchstabe klicken
4. Firma in Liste finden
5. Details ansehen

### Firma bewerten
1. Detail-Seite aufrufen
2. Bewertung (1-5 Sterne) auswählen
3. Absenden
4. Bewertung wird in Durchschnitt eingerechnet

### Admin-Aufgaben
1. Admin-Panel öffnen
2. Neue Einträge freigeben
3. Bei Bedarf als "Featured" markieren
4. Spam/Fehler löschen
5. Kategorien verwalten

## Pastellfarben-Design

**Primär-Palette:**
- Lila: `#ba68c8`, `#9575cd`, `#7e57c2`
- Rosa: `#fce4ec`, `#f3e5f5`
- Hellblau: `#e1f5fe`
- Gelb (Featured): `#ffd54f`, `#ffb74d`

**Hover-Effekte:**
- Sanfte Transformationen
- Box-Shadows
- Farbverläufe

**Komponenten:**
- Abgerundete Ecken (border-radius: 12-20px)
- Sanfte Schatten
- Gradient-Buttons
- Badge-System für Status

## Einsatzgebiete

- **Lokale Portale** - Stadt- oder Gemeinde-Verzeichnisse
- **Regionen** - Landkreis-, Bezirks-Verzeichnisse
- **Branchen-Portale** - Spezifische Branchen (z.B. nur Handwerk)
- **Shopping-Meilen** - Einkaufsstraßen, Innenstädte
- **Gewerbegebiete** - Industrieparks, Business-Parks
- **Tourismus** - Hotels, Restaurants, Attraktionen
- **Communities** - Vereins-Verzeichnisse, Mitglieder-Datenbanken

## Beispiel-Kategorien

**Standard (vorinstalliert):**
- Handwerk
- Gastronomie
- Einzelhandel
- Dienstleistungen
- Gesundheit
- Auto & Verkehr

**Erweiterbar:**
- Immobilien
- Bildung & Schulung
- Beauty & Wellness
- Sport & Freizeit
- IT & Technologie
- Rechts & Finanzen
- Bau & Architektur
- Kultur & Events

## Systemanforderungen

- **Webserver** - Apache/Nginx mit PHP
- **PHP** - Version 8.0 oder höher
- **MySQL** - Version 5.7 oder höher
- **Speicherplatz** - 5 MB Webspace
- **Extensions** - PDO, session

## Dateien

- `install.php` - Installations-Wizard (nach Install löschen)
- `config.php` - Datenbank-Konfiguration (wird von install.php erstellt)
- `index.php` - Hauptseite mit Übersicht
- `detail.php` - Firmen-Detailseite mit Bewertung
- `submit.php` - Eintragsformular für Firmen
- `admin.php` - Admin-Panel
- `style.css` - Pastellfarben-Design

## Sicherheitsmerkmale

### Authentifizierung
- **Bcrypt-Hashing** - Sichere Admin-Passwörter
- **Session-Management** - HttpOnly, Secure Cookies
- **CSRF-Protection** - Token-Validierung
- **SQL-Injection-Schutz** - PDO prepared statements

### Datenvalidierung
- **XSS-Prevention** - htmlspecialchars auf Output
- **Input-Sanitization** - trim(), type casting
- **Required Fields** - Pflichtfelder-Validierung

### Admin-Bereich
- **Login-Schutz** - Nur autorisierte Zugriffe
- **Moderation** - Einträge vor Veröffentlichung prüfen
- **Lösch-Bestätigung** - Confirm-Dialog

## Best Practices

### Für Betreiber
- Regelmäßig Spam-Einträge löschen
- Kategorien sinnvoll strukturieren
- Featured-Einträge strategisch setzen
- Datenbank-Backups erstellen
- Einträge zeitnah freischalten

### Für Unternehmen
- Vollständige Daten angeben
- Aussagekräftige Beschreibung
- Aktuelle Kontaktdaten
- Kategorie richtig wählen

### SEO-Optimierung
- Slug-URLs für Kategorien
- Sprechende Firmennamen
- Meta-Tags ergänzen
- Sitemap generieren
- Schema.org Markup

## Erweiterungsideen

### Basis-Features
- **Bilder** - Firmenlogos, Galerie
- **Öffnungszeiten** - Strukturierte Anzeige
- **Karte** - Google Maps Integration
- **Social Media** - Links zu Social Profiles
- **Tags** - Zusätzliche Verschlagwortung

### Erweiterte Features
- **Kommentare** - Textuelle Bewertungen
- **Verifizierung** - Geprüfte Unternehmen
- **Premium-Listings** - Kostenpflichtige Hervorhebung
- **Multi-Standort** - Filialen verwalten
- **Import/Export** - CSV-Massenimport
- **API** - REST-Schnittstelle

### Premium-Features
- **Buchungssystem** - Termine online buchen
- **Gutscheine** - Rabattcodes anbieten
- **Statistiken** - Für Firmeneigentümer
- **Claim-System** - Einträge beanspruchen
- **Newsletter** - E-Mail-Benachrichtigungen

### Community-Features
- **Benutzer-Registrierung** - Accounts für Bewertungen
- **Favoriten** - Firmen merken
- **Empfehlungen** - "Ähnliche Firmen"
- **Vergleich** - Unternehmen vergleichen

## Kategorien-Management

### Neue Kategorie hinzufügen
1. Admin-Panel öffnen
2. Kategoriename eingeben
3. Optional: Beschreibung
4. "Hinzufügen" klicken
5. Slug wird automatisch generiert

### Kategorie löschen
- Nur möglich wenn keine Einträge zugeordnet
- Sonst: Erst Einträge verschieben/löschen

### Kategorien organisieren
- Alphabetisch sortiert
- Max. 15-20 Hauptkategorien empfohlen
- Bei Bedarf Unterkategorien hinzufügen

## Bewertungs-System

### Funktionsweise
- 5-Sterne-System (1-5)
- Durchschnitt aus allen Bewertungen
- Vote-Counter zeigt Anzahl
- Keine Löschung einzelner Bewertungen

### Anzeige
- Sterne in Übersicht
- Detaillierte Anzeige auf Detail-Seite
- Badge in Listen
- Sortierung nach Rating möglich

### Anti-Spam
- IP-Tracking implementieren (optional)
- Nur registrierte User (optional)
- Admin-Moderation (optional)

## Featured-System

### Verwendung
- Hervorhebung besonderer Einträge
- Gelber Border + Badge
- Höhere Sichtbarkeit
- Sortierung vor normalen Einträgen

### Einsatz
- Partner-Unternehmen
- Bezahlte Platzierungen
- Besonders empfehlenswert
- Neue/beliebte Einträge

## Statistiken

### Dashboard-Übersicht
- **Gesamt** - Alle Einträge
- **Aktiv** - Freigeschaltete Einträge
- **Warten** - Pending Einträge
- **Empfohlen** - Featured Einträge

### Zusätzliche Metriken (optional)
- Aufrufe pro Eintrag
- Durchschnittliche Bewertung
- Kategorien-Verteilung
- Neue Einträge pro Monat

## Wartung

### Regelmäßig
- Spam-Einträge entfernen
- Inaktive Firmen löschen
- Kategorien aufräumen
- Datenbank optimieren

### Bei Problemen
- PHP Error Log prüfen
- Datenbank-Verbindung testen
- Rechte überprüfen (755/644)
- config.php kontrollieren

### Optimierung
- Query-Cache aktivieren
- Indizes auf häufige Suchen
- Featured-Limit setzen
- Pagination bei vielen Einträgen

## Rechtliche Hinweise

⚠️ **Wichtig:**
- Impressumspflicht beachten
- Datenschutzerklärung erforderlich
- Bei kommerzieller Nutzung: AGB
- Verantwortung für Einträge klären
- DSGVO-Konformität sicherstellen
- Cookie-Hinweis (falls Tracking)

## Performance-Tipps

### Für viele Einträge (10.000+)
- Full-Text-Index auf Suche
- Pagination implementieren
- Lazy Loading für Bilder
- CDN für statische Assets
- Query-Optimierung

### Für hohen Traffic
- OPcache aktivieren
- MySQL Query Cache
- Memcached/Redis
- Load Balancing
- CDN-Integration

## Anpassungsmöglichkeiten

### Design
- Farben in style.css ändern
- Logo einbinden
- Layout anpassen
- Fonts austauschen

### Funktionen
- Pflichtfelder anpassen
- Kategorien vordefinieren
- Bewertungssystem erweitern
- Featured-Logik ändern

### Texte
- Alle Texte in PHP-Dateien
- Einfach austauschbar
- Mehrsprachigkeit möglich

## Troubleshooting

**Problem:** Installation schlägt fehl
**Lösung:** DB-Zugangsdaten prüfen, Rechte kontrollieren

**Problem:** Einträge werden nicht angezeigt
**Lösung:** Admin muss Einträge freigeben (active=1)

**Problem:** Bewertungen funktionieren nicht
**Lösung:** CSRF-Token und Session prüfen

**Problem:** Design fehlerhaft
**Lösung:** style.css vorhanden? Cache leeren

## Lizenz

Freie Verwendung für private und kommerzielle Zwecke.

---

**Version:** 1.0
**Entwickelt:** 2025
**Sprache:** Deutsch
**PHP:** 8.4+
**Design:** Pastellfarben (Lila, Rosa, Hellblau)
**Tabellen-Präfix:** `dir_` (anpassbar)
**Kategorie:** Branchenverzeichnis / Business Directory

## Projektbeschreibung

Ein schlankes und benutzerfreundliches Download-Portal für das einfache Teilen und Verwalten von Dateien. Ideal für Software-Entwickler, Content Creator, Unternehmen oder Communities, die Dateien zum kostenlosen Download anbieten möchten.

## Hauptfunktionen

### Öffentlicher Bereich
- **Download-Übersicht** - Alle verfügbaren Dateien auf einen Blick
- **Detailinformationen** - Titel, Beschreibung, Dateigröße
- **Download-Counter** - Anzahl der Downloads wird angezeigt
- **Ein-Klick-Download** - Direkter Download ohne Umwege
- **Pagination** - Übersichtliche Darstellung bei vielen Dateien
- **Responsive Design** - Funktioniert auf allen Geräten

### Admin-Panel
- **Datei-Upload** - Einfaches Hochladen über Web-Interface
- **Metadaten** - Titel und Beschreibung für jede Datei
- **Datei-Verwaltung** - Übersicht aller Uploads
- **Status-Kontrolle** - Dateien aktivieren/deaktivieren
- **Download-Statistik** - Anzahl der Downloads einsehen
- **Lösch-Funktion** - Dateien entfernen

## Technische Details

**Programmiersprache:** PHP 8.4
**Datenbank:** MySQL mit 2 Tabellen
**Sicherheit:** CSRF-Schutz, PDO prepared statements, Bcrypt
**Design:** Modernes Blau-Design

### Datenbankstruktur
- `downloads` - Datei-Informationen, Pfade und Statistiken
- `admin` - Admin-Zugangsdaten

### Datei-Speicherung
Hochgeladene Dateien werden im `uploads/` Verzeichnis gespeichert mit:
- Eindeutigen Dateinamen (Timestamp + Original)
- Metadaten in Datenbank
- Automatische Größenberechnung
- Download-Counter-Tracking

## Installation

1. Alle Dateien auf Webserver hochladen
2. `uploads/` Verzeichnis erstellen (wird automatisch angelegt)
3. Schreibrechte für `uploads/` setzen (chmod 755)
4. `install.php` im Browser aufrufen
5. Datenbank-Zugangsdaten eingeben
6. Admin-Account erstellen

**Standard-Admin:**
Benutzername: `admin`
Passwort: *(beim Setup festgelegt)*

## Verwendung

### Dateien hochladen
1. Als Admin anmelden
2. Titel eingeben (z.B. "Software v1.2")
3. Beschreibung hinzufügen (optional)
4. Datei auswählen
5. "Hochladen" klicken
6. Datei ist sofort verfügbar

### Dateien verwalten
1. Admin-Panel öffnen
2. Übersicht aller Dateien einsehen
3. Download-Statistiken prüfen
4. Dateien aktivieren/deaktivieren
5. Bei Bedarf löschen

### Dateien herunterladen
1. Hauptseite besuchen
2. Gewünschte Datei finden
3. "Herunterladen" klicken
4. Download startet automatisch

## Features im Detail

### Download-System
- **Direkt-Download** - Keine Wartezeiten
- **Counter-Tracking** - Jeder Download wird gezählt
- **Dateigrößen** - Automatisch formatiert (KB, MB, GB)
- **Eindeutige Links** - Jede Datei hat eigene ID
- **Pagination** - 12 Dateien pro Seite (anpassbar)

### Sicherheit
- **CSRF-Schutz** - Token-Validierung für alle Formulare
- **SQL-Injection-Schutz** - PDO prepared statements
- **XSS-Prevention** - htmlspecialchars auf Output
- **Admin-Authentifizierung** - Bcrypt-Passwort-Hashing
- **Session-Sicherheit** - HttpOnly, Secure flags

### Benutzerfreundlichkeit
- **Einfaches Interface** - Klare Navigation
- **Schneller Upload** - Drag & Drop möglich (Browser-abhängig)
- **Übersichtliche Liste** - Card-Design für Dateien
- **Status-Badges** - Aktiv/Inaktiv sofort erkennbar
- **Download-Counter** - Beliebtheit auf einen Blick

## Einsatzgebiete

- **Software-Entwickler** - Programme, Updates, Tools verteilen
- **Content Creator** - E-Books, PDFs, Vorlagen teilen
- **Unternehmen** - Kataloge, Broschüren, Dokumente
- **Bildungseinrichtungen** - Lernmaterialien, Scripts
- **Communities** - Ressourcen für Mitglieder
- **Open Source** - Projekt-Releases hosten
- **Fotografen** - Hochauflösende Bilder (Achtung: Speicherplatz)

## Unterstützte Dateitypen

Das System akzeptiert standardmäßig alle Dateitypen:
- **Dokumente** - PDF, DOCX, XLSX, TXT
- **Archive** - ZIP, RAR, TAR, GZ
- **Software** - EXE, MSI, DMG, APK
- **Bilder** - JPG, PNG, GIF (besser: Bild-Gallery verwenden)
- **Videos** - MP4, AVI, MOV (Achtung: Speicherplatz)
- **Audio** - MP3, WAV, OGG
- **Code** - ZIP mit Quellcode

**Empfehlung:** Dateitypen im Admin-Panel konfigurierbar machen.

## Systemanforderungen

- **Webserver** - Apache/Nginx mit PHP
- **PHP** - Version 8.0 oder höher
- **MySQL** - Version 5.7 oder höher
- **Speicherplatz** - Je nach Dateigröße (mind. 100 MB empfohlen)
- **Upload-Limit** - In php.ini anpassen:
```ini
upload_max_filesize = 100M
post_max_size = 100M
max_execution_time = 300
```

## Dateien

- `index.php` - Öffentliche Download-Übersicht
- `download.php` - Download-Handler mit Counter
- `admin.php` - Admin-Panel für Verwaltung
- `config.php` - Datenbank-Konfiguration
- `install.php` - Installations-Wizard
- `style.css` - Design-Stylesheet
- `download.sql` - Datenbank-Schema
- `uploads/` - Verzeichnis für hochgeladene Dateien

## Konfiguration

### PHP Upload-Limits erhöhen
In `php.ini` oder `.htaccess`:
```ini
upload_max_filesize = 100M
post_max_size = 100M
max_execution_time = 300
memory_limit = 256M
```

### Dateigröße anzeigen
```php
function formatSize($bytes) {
if($bytes >= 1073741824) return number_format($bytes/1073741824, 2).' GB';
if($bytes >= 1048576) return number_format($bytes/1048576, 2).' MB';
if($bytes >= 1024) return number_format($bytes/1024, 2).' KB';
return $bytes.' B';
}
```

### Pagination anpassen
In `index.php`:
```php
$perPage = 12; // Anzahl Dateien pro Seite
```

## Best Practices

### Für Betreiber
- Regelmäßig Backups erstellen
- Speicherplatz überwachen
- Alte/ungenutzte Dateien löschen
- Virenscanner verwenden
- Download-Statistiken auswerten

### Datei-Benennung
- Sprechende Titel verwenden
- Version-Nummern angeben
- Beschreibung ausfüllen
- Dateiformat erwähnen

### Sicherheit
- Starkes Admin-Passwort
- SSL/HTTPS verwenden
- Regelmäßige Updates
- Zugriffslogs prüfen
- Backups extern speichern

## Erweiterungsideen

### Basis-Features
- **Kategorien** - Dateien gruppieren
- **Suchfunktion** - Dateien finden
- **Sortierung** - Nach Name, Größe, Downloads
- **Thumbnails** - Vorschaubilder für Bilder/PDFs
- **Mehrfach-Upload** - Mehrere Dateien gleichzeitig

### Erweiterte Features
- **Benutzer-Registrierung** - User können selbst hochladen
- **Kommentare** - Feedback zu Downloads
- **Bewertungen** - 5-Sterne-System
- **Tags** - Flexible Verschlagwortung
- **Versionierung** - Mehrere Versionen einer Datei
- **Changelog** - Was ist neu?

### Premium-Features
- **Download-Limit** - X Downloads pro IP/Tag
- **Passwort-Schutz** - Geschützte Downloads
- **Ablaufdatum** - Zeitlich begrenzte Links
- **Direktlinks** - Für externe Einbindung
- **API** - Programmatischer Zugriff
- **CDN-Integration** - Schnellere Downloads
- **E-Mail-Benachrichtigung** - Bei neuen Dateien

### Analytics
- **Download-Statistiken** - Detaillierte Auswertung
- **IP-Tracking** - Woher kommen Downloads?
- **Zeitanalyse** - Peak-Zeiten erkennen
- **Referrer** - Von welchen Seiten kommen User?
- **Beliebteste Dateien** - Top 10 Downloads

## Wartung

### Regelmäßig
- Alte Dateien archivieren
- Datenbank optimieren
- Logs prüfen
- Backups testen

### Bei Problemen
- PHP-Error-Log prüfen
- Dateirechte überprüfen (uploads/ Verzeichnis)
- Speicherplatz checken
- MySQL-Verbindung testen

### Optimierung
- Große Dateien komprimieren
- CDN für beliebte Downloads
- Caching aktivieren
- Gzip-Kompression nutzen

## Rechtliche Hinweise

⚠️ **Wichtig:**
- Nur eigene oder lizenzierte Dateien hochladen
- Urheberrechte beachten
- Impressumspflicht (Deutschland)
- Datenschutzerklärung bereitstellen
- Bei geschäftlicher Nutzung: AGB erstellen
- Haftungsausschluss empfohlen

## Performance-Tipps

### Für viele Downloads
- MySQL Query-Cache aktivieren
- PHP OPcache nutzen
- Nginx statt Apache (optional)
- Separate Storage-Server für Dateien
- Load-Balancing bei sehr hohem Traffic

### Für große Dateien
- Streaming statt vollständigem Laden
- Chunked Transfer nutzen
- Resume-Funktion implementieren
- Externe Storage (S3, Spaces)

## Troubleshooting

**Problem:** Upload schlägt fehl
**Lösung:** PHP upload_max_filesize erhöhen

**Problem:** Download zählt nicht
**Lösung:** Cookies/Session prüfen

**Problem:** Datei nicht gefunden
**Lösung:** uploads/ Verzeichnis und Rechte prüfen

**Problem:** Zu langsam
**Lösung:** Caching aktivieren, Dateien extern hosten

## Support

- Datenbank-Backups vor Änderungen
- PHP-Error-Reporting aktivieren während Entwicklung
- Logs regelmäßig prüfen
- Bei Problemen: config.php und .htaccess checken

## Lizenz

Freie Verwendung für private und kommerzielle Zwecke.

---

**Version:** 1.0
**Entwickelt:** 2025
**Sprache:** Deutsch
**PHP:** 8.4+
**Kategorie:** File Sharing / Downloads

## Features
✅ Event erstellen mit Bild
✅ Kategorien (Konzert, Sport, Party, etc.)
✅ Teilnehmer-System (Going/Maybe/Cancel)
✅ Kommentare
✅ Ratings (1-5 Sterne)
✅ Suche & Filter
✅ Admin-Freigabe
✅ E-Mail-Benachrichtigung

## Farben
- Blau: #1e3a8a, #3b82f6
- Orange: #fb923c

## Dateien (8)
1. install.php
2. login.php
3. index.php - Event-Liste
4. event.php - Event-Detail
5. my-events.php - Eigene Events
6. admin.php
7. README.md
8. create.php

Viel Spaß! ????