Hinzufügen von BTCPayWall per Shortcode
In dieser Anleitung erklären wir, wie Du per Shortcode die verschiedenen Anwendungen in Deine WordPress Seite einbindest.
Wenn Du keinen WordPress Editor wie Gutenberg, WPBakery oder Elementor verwendest, dann empfiehlt sich die Integration per Shortcode. Somit kannst Du auch die WordPress Lightning Paywall nutzen, wenn Du einen anderen WordPress Editor verwendest, um Deine WordPress Seiten zu gestalten.
Der hinter der Paywall geschützte Bereich wird eingebettet zwischen einem Start und einem End Befehl.
Die einzelnen Befehle werden jeweils mit einer eckigen Klammer eröffnet beziehungsweise geschlossen.
Innerhalb der eckigen Klammer stehen die Anweisungen, wie die WP Lightning Paywall zu agieren hat.
Im Folgenden beschreiben wir die unterschiedlichen Befehle, abhängig von der Art des Contents.
Pay-per-post / Zahlung für einen einzelnen Blog Post
Für den Inhalt, der hinter der Paywall angezeigt werden soll, wird der Befehl btcpw-start_content verwendet. Die Abkürzung btcpw steht für BTCPayWall.
Zusätzlich wird die Paywall aktiviert, indem man den pay_block mit den Zusatz true aktiviert beziehungsweise per false deaktiviert.
Am Ende des Blogbeitrags wird der geschützte Bereich mit dem Befehl btcpw_end_content abgeschlossen.
Jeder Text, der danach kommt, wird wieder normal angezeigt.
Die einzelnen Befehle inklusive der eckigen Klammern sind rechts zu sehen.
Alle Attribute sind optional. Werden Attribute weggelassen, dann werden Standardwerte verwendet. Attribute
, welche die Paywall steuern, befinden sich im pay_block.
Um die Inhalte mit einer Paywall zu schützen, muss der pay_block auf true gesetzt werden. Währung (Currency) und Laufzeit (Duration) werden validiert.
.
Das bedeutet, dass Du Dir keine Sorgen machen musst, ob Du den richtigen Wert eingestellt hast.
Solltest Du nicht unterstützte Währung oder Laufzeiten eingeben, werden die hinterlegten Standardwerte für diese Felder beibehalten.
Standardwerte (aus den General Settings) für die Attribute (Pay-per-Post):
- pay_block = false
- price = der Betrag, welcher in den General Settings festgelegt wurde
- currency = die Währung, welche in den General Settings festgelegt wurde
- duration = der Zeitraum, der in den General Settings festgelegt wurde
- duration_type = Die Art des Zeitraums, die in den General Settings festgelegt wurde
[btcpw_start_content pay_block=(‚true’|’false‘) price=(’number‘) currency=(‚BTC’|’SATS’|’EUR’|’USD‘) duration=(’number‘) duration_type=(‚minute’|’hour’|’day’|’week’|’month’|’year’|’onetime’|’unlimited‘)]
Das Bild auf der linken Seite zeigt, wie ein Blogeintrag oder eine Seite aussehen sollte, wenn der Shortcode in den Text eingebettet ist.
Wenn Du sehen möchtest, wie die fertige Seite aus der Sicht eines Nutzers aussieht und es einmal ausprobieren willst, dann gehe auf die Seite:
Pay-per-Post Demo Page
Pay-per-view / Zahlung für ein einzelnes Video
Mit Pay-per-View kannst Du Videos durch die WP Lightning Paywall verkaufen.
Der Nutzer sieht für jedes Video eine Vorschau, bestehend aus einer Überschrift, einem Beschreibungstext und aus einem Bild. Zusätzlich werden die Angaben zum Preis des Videos angezeigt.
Nach erfolgreicher Zahlung wird das Video auf der Webseite angezeigt und abgespielt.
Das Video, welches nach erfolgreicher Zahlung abgespielt wird, kann auf Deinem eigenen Server liegen, aber auch auf einem externen Server.
Du kannst zum Beispiel Videos zeigen, welche bei YouTube oder Vimeo abgelegt sind.
Um diese Videos nicht der Allgemeinheit kostenfrei anzubieten, kann man das Video auf Privat setzen. Dann wird das Video in der Suche nicht mehr angezeigt.
Nur wer die genaue Internet-Adresse kennt, kann dieses Video aufrufen.
Möchtest Du ein Vimeo oder YouTube Video kostenpflichtig anbieten, so setze es auf Privat und hinterlege diese geheime Internet-Adresse als Paywall Url.
Wenn Sie ein Video mit einer Paywall schützen wollen, wird der Beginn des Paywall-Bereichs mit dem Befehl aktiviert: btcpw_start_video pay_view_block=“true“.
Innerhalb des Start Befehls können weitere Felder definiert werden, welche dem Nutzer als Vorschau angezeigt werden.
Dafür stehen die folgenden Befehle zur Verfügung:
– title – eine Überschrift als Text
– description – eine Video Beschreibung als Text
– preview – ein Vorschaubild.
Bei Title und Description kann ein Text geschrieben werden. Bei dem Vorschaubild muss das Verzeichnis angegeben werden, wo das Bild abgelegt ist.
Dann erfolgt die Angabe der Internet-Adresse, bei welcher das Video abgelegt ist und von wo aus es abgespielt werden soll.
Der Paywall-Bereich mit dem Befehl btcpw_end_video wieder abgeschlossen.
Im nebenstehenden Bild siehst Du ein Beispiel, wie das Video dancing-queen.mp4 auf dem eigenen Server abgelegt und durch die Paywall geschützt ist.
Alle Attribute sind optional. Werden Attribute weggelassen, dann werden Standardwerte verwendet.
Die Attribute, welche die Paywall steuern, befinden sich im pay_view_block.
Um das Video mit der Paywall zu schützen, muss pay_view_block auf true gesetzt werden.
Der Typ für Währung (Currency) und Zeitraum (Duration) wird automatisch validiert. Das bedeutet, dass Du Dir keine Sorgen machen musst, ob Du den richtigen Wert eingestellt hast.
Solltest Du nicht unterstützte Währung oder Laufzeiten eingeben, werden die hinterlegten Standardwerte für diese Felder beibehalten.
Title, description und preview sind Attribute, welche sich auf das geschützte Video beziehen.
Die hinterlegten Standard-Werte für pay-per-view lauten:
- pay_view_block = false
- title = ‚Untitled‘, kein Wert wird angezeigt
- description = ‚No description‘ kein Wert wird angezeigt
- preview = Standardbild als Platzhalter wird angezeigt
- price = der Betrag, welcher in den General Settings festgelegt wurde
- currency = die Währung, welche in den General Settings festgelegt wurde
- duration = der Zeitraum, der in den General Settings festgelegt wurde
- duration_type = Die Art des Zeitraums, die in den General Settings festgelegt wurde
[btcpw_start_video pay_view_block=(‚true’|’false‘) title=(‚Title for video‘) description=(‚Video description‘) preview=(‚Link to a preview image for video‘) price=(’number‘) currency=(‚BTC’|’SATS’|’EUR’|’USD‘) duration=(’number‘) duration_type=
(‚minute’|’hour’|’day’|’week’|’month’|’year’|’onetime’|’unlimited‘)]
Video Catalog
Für jedes Video muss jeweils eine eigenständige Seite erstellt werden. Diese Seite beinhaltet dann die Vorschau und die Bezahlfunktionen. Nach der erfolgreichen Zahlung wird auf dieser Seite dann ebenfalls das Video abgespielt.
Um eine Übersichtsseite für alle angebotenen Videos zu erstellen, gibt es die Video Katalog Funktion.
Man erstellt eine Übersichtsseite, auf der mit dem Befehl btcpw_video_catalog die Vorschaubilder der angebotenen Videos aufgelistet werden.
Für jede Video-Vorschau muss jeweils der Befehl eingesetzt werden.
In unserem nebenstehenden Beispiel haben wir es für drei Videos erstellt.
Wenn Du sehen möchtest, wie die fertige Seite aus der Sicht eines Nutzers aussieht und es einmal ausprobieren willst, dann gehe auf die Seite:
Pay-per-View Video Beispiel Seite
Pay-per-file / Bezahlung für eine einzelnen Datei oder pro Download.
Mit der Pay-per-File Funktion können einzelne Dateien als Download verkauft werden.
– Du hast eine eigene Software geschrieben, die Du Deinen Kunden zum Download anbieten möchtest?
– Du hast eine Anleitung, ein Handbuch oder ein eBook geschrieben und möchtest es als PDF-Datei verkaufen?
– Als Fotograf möchtest Du Deine Bilder selbst vermarkten?
– Du hast ein eigenes Musikstück komponiert oder ein Video produziert, welches Du als mp4-Datei zum Downloaden Deinen Fans anbieten willst.
Die Pay-per-File Funktion ist wie ein digitaler Content Store. Du kannst jedes Datei-Format im Internet verkaufen und Deinen Kunden zum Download anbieten.
Wenn Du die eine Datei mit einer Paywall schützen willst, wird der Beginn des Paywall-Bereichs mit dem Befehl aktiviert: btcpw_file pay_file_block=‘true’
Innerhalb des Start Befehls können weitere Felder definiert werden, welche dem Nutzer als Vorschau angezeigt werden.
Dafür stehen die folgenden Befehle zur Verfügung:
- currency=’SATS‘
- btc_format=’BTC‘
- file=’https://btcpaywall.com/wp-content/uploads/2021/05/SEPA-Lastschrift.pdf‘
- title=’SEPA direct debit for Internet commerce (german version)‘
- description=‘A german Language guide for SEPA direct debit’
- price=’125′
- duration=’2′
- duration_type=’hour‘
Bei Title und Description kann ein Text geschrieben werden. Bei dem Vorschaubild muss das Verzeichnis angegeben werden, wo das Bild abgelegt ist.
Anschließend wird die Internetadresse angegeben, unter der die Datei gespeichert ist und runtergeladen werden soll.
Im nebenstehenden Bild sehen Sie ein Beispiel, wie die Datei SEPA-Lastschrift.pdf auf dem eigenen Server gespeichert und durch die Paywall geschützt ist.
Das Dateiattribut ist für die Paywall obligatorisch. Wird dieses Attribut weggelassen,
wird die Paywall nicht aktiviert.
Die anderen Attribute sind optional, und wenn sie nicht gesetzt sind,
werden die Werte aus den General Settings übernommen.
Es wird empfohlen, eine Datei in die Medienbibliothek hochzuladen und diesen Link für eine Datei zu verwenden. Um die Inhalte mit der Paywall zu schützen,
muss pay_file_block auf true gesetzt werden.
Btc_format wird verwendet, um das Preisformat innerhalb der Paywall zu steuern. Dieses Attribut wird nur angewendet, wenn SATS als Währung ausgewählt ist.
Wenn zum Beispiel die Währung auf SATS, der Preis auf 10 und das btc_format auf SATS eingestellt ist, erscheint der folgende Text im Bezahlfenster: ‚Für 10 SATS…‘. Wenn hingegen der btc_format auf BTC eingestellt ist, würde der Text lauten: ‚Für 0,0000001 BTC…‘. Der Typ für Währung (Currency) und Zeitraum (Duration) wird automatisch validiert.
Das bedeutet, dass Du Dir keine Sorgen machen musst, ob Du den richtigen Wert eingestellt hast. Wenn Du nicht unterstützte Währungen oder fehlerhafte duration_type eingibst, dann werden diese Felder mit den Standardwerte aus general Settings überschrieben.
Standard-Attribute für pay-per-file Download
- pay_file_block = false
- title = ‚Untitled‘, kein Wert wird angezeigt
- description = ‚No description‘ kein Wert wird angezeigt
- preview = Standardbild als Platzhalter wird angezeigt
- file = “
- price = der Betrag, welcher in den General Settings festgelegt wurde
- currency = die Währung, welche in den General Settings festgelegt wurde
- btc_format = btc_format defined in general settings
- duration = der Zeitraum, der in den General Settings festgelegt wurde
- duration_type = Die Art des Zeitraums, die in den General Settings festgelegt wurde
[btcpw_file pay_file_block=(‚true’|’false‘) file=(‚file url‘) title=(‚Title for file‘) description=(‚File description‘) preview=(‚Link to a preview image for file‘) price= (’number‘) currency=(‚SATS’|’EUR’|’USD‘) btc_format=(‚BTC’|’SATS‘) duration=(’number‘) duration_type=(‚minute’|’hour’|’day’|’week’|’month’|’year’|’onetime’|’unlimited‘)]
Wenn Du sehen möchtest, wie die fertige Seite aus der Sicht eines Nutzers aussieht und es einmal ausprobieren willst, dann gehe auf die Seite:
Leave a Reply
Your email is safe with us.