Initialer Commit: Projekt Start
This commit is contained in:
118
KONFIGURATION.md
Normal file
118
KONFIGURATION.md
Normal file
@@ -0,0 +1,118 @@
|
||||
# API-Konfiguration für WordPress/WooCommerce
|
||||
|
||||
## 📍 Hauptkonfiguration
|
||||
|
||||
### 1. WooCommerce API-Konfiguration
|
||||
**Datei:** `lib/services/woocommerce_service.dart`
|
||||
|
||||
```dart
|
||||
class WooCommerceService {
|
||||
// 👇 HIER deine Shop-URL eintragen
|
||||
static const String baseUrl = 'https://hyggecraftery.com';
|
||||
|
||||
// 👇 HIER deine WooCommerce API Keys eintragen
|
||||
static const String consumerKey = 'ck_your_consumer_key';
|
||||
static const String consumerSecret = 'cs_your_consumer_secret';
|
||||
}
|
||||
```
|
||||
|
||||
**Was musst du ändern:**
|
||||
- `baseUrl`: Deine WordPress/WooCommerce Shop-URL (z.B. `https://hyggecraftery.com`)
|
||||
- `consumerKey`: Dein WooCommerce Consumer Key (beginnt mit `ck_`)
|
||||
- `consumerSecret`: Dein WooCommerce Consumer Secret (beginnt mit `cs_`)
|
||||
|
||||
---
|
||||
|
||||
## 🔑 WooCommerce API Keys erstellen
|
||||
|
||||
1. **WordPress Admin** → **WooCommerce** → **Settings** → **Advanced** → **REST API**
|
||||
2. Klicke auf **"Add Key"**
|
||||
3. Gib eine Beschreibung ein (z.B. "Flutter App")
|
||||
4. Wähle **Berechtigungen**:
|
||||
- **Read** (für Produkte, Kategorien, etc.)
|
||||
- **Write** (für Bestellungen, falls du native Checkout willst)
|
||||
5. Klicke auf **"Generate API Key"**
|
||||
6. Kopiere **Consumer Key** und **Consumer Secret**
|
||||
|
||||
---
|
||||
|
||||
## 📝 Weitere Konfigurationen
|
||||
|
||||
### 2. Analytics (Umami) - Optional
|
||||
**Datei:** `lib/services/analytics_service.dart`
|
||||
|
||||
```dart
|
||||
class AnalyticsService {
|
||||
static const String umamiUrl = 'https://analytics.hyggecraftery.com';
|
||||
static const String websiteId = 'c43cd023-ff64-43c8-a42a-ac23d32366f6';
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚙️ Welche API-Endpunkte werden verwendet?
|
||||
|
||||
### WordPress REST API
|
||||
- `/wp-json/wp/v2/users/me` - Benutzerdaten
|
||||
- `/wp-json/wp/v2/users` - Benutzer-Registrierung
|
||||
- `/wp-json/jwt-auth/v1/token` - JWT Login (falls Plugin installiert)
|
||||
|
||||
### WooCommerce REST API
|
||||
- `/wp-json/wc/v3/products` - Produkte
|
||||
- `/wp-json/wc/v3/products/categories` - Kategorien
|
||||
- `/wp-json/wc/v3/products/reviews` - Bewertungen
|
||||
- `/wp-json/wc/v3/orders` - Bestellungen
|
||||
- `/wp-json/wc/v3/coupons` - Gutscheine
|
||||
- `/wp-json/wc/v3/customers` - Kunden
|
||||
|
||||
### WooCommerce Web-Seiten
|
||||
- `/checkout/` - Checkout-Seite (WebView)
|
||||
- `/cart/` - Warenkorb-Seite
|
||||
|
||||
---
|
||||
|
||||
## 🔒 Sicherheit
|
||||
|
||||
**Wichtig:**
|
||||
- **NICHT** die API Keys in Git committen!
|
||||
- Verwende Umgebungsvariablen für Production
|
||||
- Oder nutze `.env` Dateien (nicht im Repository)
|
||||
|
||||
### Für Production (später):
|
||||
Du kannst `env.dart` erweitern:
|
||||
|
||||
```dart
|
||||
// lib/env.dart
|
||||
const String wooCommerceUrl = String.fromEnvironment(
|
||||
'WOOCOMMERCE_URL',
|
||||
defaultValue: 'https://hyggecraftery.com',
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Checkliste
|
||||
|
||||
- [ ] `baseUrl` in `woocommerce_service.dart` gesetzt
|
||||
- [ ] `consumerKey` in `woocommerce_service.dart` gesetzt
|
||||
- [ ] `consumerSecret` in `woocommerce_service.dart` gesetzt
|
||||
- [ ] WooCommerce REST API aktiviert
|
||||
- [ ] API Keys mit richtigen Berechtigungen erstellt
|
||||
- [ ] (Optional) JWT Auth Plugin installiert für besseres Login
|
||||
|
||||
---
|
||||
|
||||
## 🧪 Testen
|
||||
|
||||
Nach der Konfiguration kannst du testen:
|
||||
|
||||
```bash
|
||||
# Lokal testen
|
||||
flutter run -d chrome
|
||||
|
||||
# Oder Web-Build testen
|
||||
flutter build web --release
|
||||
```
|
||||
|
||||
Die App sollte jetzt auf deine WooCommerce-API zugreifen können!
|
||||
|
||||
Reference in New Issue
Block a user