119 lines
3.0 KiB
Markdown
119 lines
3.0 KiB
Markdown
# 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!
|
|
|