Produkt im Theme korrekt anlegen

In dieser Lektion trägst du die Stripe-Keys ins Theme ein, lädst deine Download-Datei in den geschützten Ordner und legst das Produkt an, das der Buy-Button später abruft. Am Ende steht ein funktionierender Shortcode, den du in jeden Blog-Post einbauen kannst.

Die Stripe-Keys ins Theme eintragen

Geh im WordPress-Backend auf Design → Downloads. Du landest im Tab Einrichtung.

Im Schritt „API-Keys eintragen" findest du zwei Felder: Secret Key und Publishable Key. Trag die Werte aus Lektion 02 ein, beide im Testmodus (also sk_test_... und pk_test_...). Klick Keys speichern. Der Secret Key wird serverseitig verschlüsselt abgelegt und danach nur noch maskiert angezeigt.

Direkt darunter ein Button Verbindung testen. Klick ihn einmal. Antwort „Stripe ist verbunden!" → alles gut. Fehler „Invalid API Key" → du hast dich beim Kopieren verklickt (Leerzeichen am Ende, Publishable im Secret-Feld).

Das dritte Feld Webhook Secret (whsec_...) lässt du leer — dazu kommen wir in Lektion 04.

Warum deine PDF in den geschützten Ordner muss

In der normalen WordPress-Mediathek landen Dateien unter wp-content/uploads/JAHR/MONAT/. Jede bekommt eine öffentlich erreichbare URL. Für ein Rezeptbild ist das perfekt, für ein bezahltes PDF das Ende des Geschäftsmodells, sobald die erste Käuferin den Link in einer WhatsApp-Gruppe teilt.

Das Theme legt deshalb einen eigenen Ordner an, sobald du es aktivierst: wp-content/uploads/bap-downloads/. Der ist per .htaccess abgeriegelt, Aufrufe von außen laufen ins Leere.

Du hast zwei Wege, deine Datei dort abzulegen:

Weg A — direkt im Produktformular hochladen. Das Theme bringt im Formular ein Upload-Feld mit, das die Datei selbst in den geschützten Ordner schiebt und automatisch einen Mediathek-Eintrag mit gültiger Attachment ID erzeugt. Pragmatisch für alle Dateien unterhalb des PHP-Upload-Limits (meist 32–128 MB). Für ein normales PDF-Bundle mit 6–20 MB reicht das locker.

Weg B — per SFTP in den Ordner legen. Wenn dein E-Book 200 MB hat oder dein Hoster den PHP-Upload auf 8 MB drosselt, lädst du die Datei per SFTP (FileZilla, Cyberduck, WinSCP) direkt in wp-content/uploads/bap-downloads/ und registrierst sie danach einmal in der Mediathek (Plugin Add From Server oder wp media import), damit du eine Attachment ID bekommst.

Wenn dir SFTP unangenehm ist, nimm Weg A und melde dich bei uns, falls deine Datei das Limit sprengt — wir übernehmen das bei Bedarf am Telefon mit Bildschirmfreigabe.

Das Produktformular ausfüllen

Zurück ins Theme-Feature unter Design → Downloads, jetzt in den Tab Produkte. Beim ersten Öffnen ist die Liste leer, darunter der Block „Neues Produkt" mit genau fünf Feldern.

Name. Der Klartext-Name deines Produkts, z. B. Feierabendrezepte — 30 schnelle Alltags-Gerichte. Dieser Text taucht später in der Kauf-E-Mail als Produktname auf.

Slug. Der URL-freundliche Kurzname — nur Kleinbuchstaben, Zahlen, Bindestriche, keine Umlaute. In unserem Beispiel feierabendrezepte-30. Einmal vergeben, solltest du ihn nicht mehr ändern, sonst verlinken bestehende Posts ins Leere.

Preis-Anzeige. Achtung, hier ist ein häufiges Missverständnis: Das ist reiner Anzeigetext am Button, nicht der abgerechnete Betrag. Der tatsächlich abgebuchte Betrag kommt ausschließlich aus der Price ID in Stripe. Beide Werte solltest du synchron halten — sonst zahlen Käuferinnen einen anderen Betrag, als am Button stand.

Stripe Price ID. Die price_...-ID aus Lektion 02. Kein Leerzeichen davor, kein Leerzeichen danach. Mit prod_... anstelle von price_... bricht der Checkout stumm ab.

Attachment ID. Bei Weg A füllt das Formular sie automatisch, sobald du die Datei hochlädst. Bei Weg B kopierst du sie aus der Mediathek (in der Browser-URL steht upload.php?item=4218 — die Zahl hinter item= ist deine Attachment ID).

Speichern — und was das Theme prüft

Klick Produkt speichern. Das Theme holt über die Attachment ID den Dateipfad, vergleicht ihn gegen wp-content/uploads/bap-downloads/ und prüft, ob die Datei lesbar ist. Nur wenn beides stimmt, landet das Produkt in der Liste.

Liegt die Datei noch im normalen Mediathek-Pfad, bricht das Speichern mit einer roten Fehlermeldung ab: „Datei liegt unter … — erwartet wird ein Pfad unterhalb von … Bitte in das geschützte Verzeichnis verschieben und eine neue Attachment-ID eintragen." Das ist kein Schönheitsfehler, sondern eine absichtliche Schranke — das Theme lässt dich kein Produkt anlegen, dessen Datei öffentlich erreichbar wäre.

In dem Fall lädst du die Datei per Weg A neu hoch (das überschreibt die alte Referenz) und klickst erneut auf Speichern.

Sobald das Produkt in der Liste steht, zeigt das Theme neben dem Eintrag den fertigen Shortcode — z. B. [bap_buy product="feierabendrezepte-30"].

Den Buy-Button einbauen

Der Shortcode ist das einzige Stück Code, das du je anfassen musst, um den Kauf-Button irgendwo auftauchen zu lassen. Format immer gleich: [bap_buy product="DEIN-SLUG"].

Drei typische Orte:

• Am Ende eines thematisch passenden Blog-Posts — Artikel über Meal Prep, darunter der Button zum Feierabendrezepte-PDF.
• Auf einer eigenen Verkaufsseite — Landingpage mit Bildern, Beschreibung, FAQs, am Ende der Shortcode.
• In einer Sidebar-Box — solange der Button nicht mit Werbebannern verschmilzt.

Das Theme macht aus dem Shortcode einen echten Button mit dem Text aus deinem Namen-Feld und der Preis-Anzeige. Ein Klick darauf löst serverseitig die Stripe-Checkout-Session aus.

Technisch kannst du mehrere [bap_buy]-Shortcodes auf einer Seite setzen. Didaktisch ist das meistens ein Fehler — ein Post, ein Produkt, ein Call-to-Action wirkt deutlich besser als drei Buttons nebeneinander.

Checkliste und Brücke zu Lektion 04

Was jetzt steht: Stripe-Keys eingetragen, Verbindungstest grün, PDF im geschützten Ordner mit gültiger Attachment ID, Produkt mit allen fünf Feldern gespeichert, Shortcode im Blog-Post eingebaut.

Was noch fehlt, bevor ein echter Kauf vollständig durchläuft: die Rückmeldung von Stripe an dein Blog. Ohne sie klickt die Käuferin auf Kaufen, bezahlt, landet auf der Danke-Seite — und danach passiert nichts. Keine Kauf-E-Mail, kein Eintrag im Käufe-Tab. Genau diese Brücke schließt Lektion 04 mit dem Stripe-Webhook.