Files
app-hyggecraftery/KONFIGURATION.md
2026-01-03 15:24:36 +01:00

3.0 KiB

API-Konfiguration für WordPress/WooCommerce

📍 Hauptkonfiguration

1. WooCommerce API-Konfiguration

Datei: lib/services/woocommerce_service.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 AdminWooCommerceSettingsAdvancedREST 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

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:

// 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:

# 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!