• Home
  • Modules
    • Payment per blog post
    • Payment per video
    • Download Store
    • Accept Bitcoin Donations
    • Payment processing
  • Demo
    • Demo: Pay per Blog Post
    • Demo: Pay per Video
    • Demo: Download Store
    • Demo: Accept Bitcoin Donations
  • How to pay
  • Documentation
    • Setup
      • Download & Install BTCPayWall
      • Setup Payment Gateway
      • Setup BTCPay Store
    • BTCPayWall Modules
      • Pay-per-Post Module
      • Pay-per-View Module
      • Download Store Module
      • Tipping Module
  • Blog
  • Contact
  • English
    • German
BTCPayWall - Bitcoin PayWall to sell Content and Digital Goods on WordPressBTCPayWall - Bitcoin PayWall to sell Content and Digital Goods on WordPress
BTCPayWall - Bitcoin PayWall to sell Content and Digital Goods on WordPressBTCPayWall - Bitcoin PayWall to sell Content and Digital Goods on WordPress
  • Home
  • Modules
    • Payment per blog post
    • Payment per video
    • Download Store
    • Accept Bitcoin Donations
    • Payment processing
  • Demo
    • Demo: Pay per Blog Post
    • Demo: Pay per Video
    • Demo: Download Store
    • Demo: Accept Bitcoin Donations
  • How to pay
  • Documentation
    • Setup
      • Download & Install BTCPayWall
      • Setup Payment Gateway
      • Setup BTCPay Store
    • BTCPayWall Modules
      • Pay-per-Post Module
      • Pay-per-View Module
      • Download Store Module
      • Tipping Module
  • Blog
  • Contact
  • English
    • German

Tipping Module

December 28, 2021 Documentation No Comments

Tipping Module

How to Accept Bitcoin Donations with BTCPayWall

Tipping Module

With the Tipping Module you can receive donations and tips via your website.

There are different tipping templates, which can be customized to your individual needs.

The templates are available with the following dimensions:

  • Tipping Box – 250×300 and 300×300
  • Tipping Banner High – 200×710
  • Tipping Banner Wide – 600×280
  • Tipping Page – 520×600

The Tipping Box allows the donor to enter a freely selectable amount.

The Tipping Banner and Tipping Page can be set to different amounts in addition to the freely selectable amount.

The donation buttons can be provided with an icon from Fontawesome.

An optional check-out page can be used to request more information from the donor.

In this tutorial we describe how you can add the Tipping module to your WordPress site:

  • Add Tipping to a web page via editor
  • Insert Tipping as widget in the sidebar
  • Insert Tipping as shortcode
Accept Bitcoin Donations on your website

Add Tipping to a web page via editor

The tipping templates can be inserted into any blog post or page within WordPress.

BTCPayWall supports the most popular WordPress website editors, such as Gutenberg, WPBakery and Elementor.

There are predefined elements available, which can be found in the element search under BTCPW (as abbreviation for BTCPayWall).

The predefined elements have the names:

  • BTCPW Tipping Banner Wide
  • BTCPW Tipping Banner High
  • BTCPW Tipping Box
  • BTCPW Tipping Page

We will show how to use the tipping template using Elementor’s WordPress editor. Using it with any other editor is almost identical.

elementor BTCPW elemente
Tipping Template

In our example, we use the Wide Tipping Banner Wide to use it to end each web page with a donation appeal.

The tipping template is pre-populated with some values, which can be customized to suit individual needs.

Any changes made are immediately displayed in the preview.

The banner is divided into header and footer, as well as the main area with the donation button.

In the main area you can use Background Image to create your own background image or Background color to define a color value.

For the header and footer area a different color value can be defined.

BTCPW Tipping Banner Wide
BTCPW Tipping Banner Logo

In the header area the own logo can be deposited. The logo is left-aligned.

The BTCPayWall logo is currently stored as a placeholder. With Remove, the logo can be removed and replaced by your own logo. In order to be able to save the change to the logo, a change must also be made to another value. Only then the Save function is displayed.

It is recommended to use the following dimensions for the logo:

  • Tipping Banner High and Tipping Page 180×180
  • Tipping Banner Wide and Tipping Box 70×70

The text entered under Title is displayed next to the logo. With Title Color the color of the heading can be determined.

Below the headline, a description can be created with Description, which is displayed smaller in the header. A separate color value can also be specified for this.

With Tipping Text a text can be defined in the main area, which is displayed centered above the donation button.

If the donation was paid successfully, the donor can be redirected to a Thank You Page. The url of this Thank You Page can be inserted as a link in the Link to Thank You Page field.

Bitcoin Donation tipping text
Accept Bitcoin tips free input

Up to four donation buttons can be displayed.

If you want to allow the donor to specify an amount to be donated, then the Free Input field must be activated.

The Currency field is used to specify which currency should be displayed to the donor. Sats, BTC, EUR and USD are available as options.

The respective conversion rate is displayed to the donor with a mouse-over effect.

The color of the donation button is displayed with Input Background Color.

In addition to the free amount input, three further donation buttons with predefined amounts can be created. With Show Icon, icons can be displayed in front of the amount.

These icons are defined under Value Icon. The icons are used by Fontawesome version v5.12. At Fontawesome you can choose the appropriate icon and set the corresponding icon name (for example for a coffee cup fas fa-coffee).

fontawesome icon
donation button

The label of the call-to-action button can be defined in the Button Text field.

Also the color of the button (Button Color) and the text color (Button Text color).

If the donor is offered the possibility to leave further information, the corresponding fields can be activated. If certain fields are not only voluntary, but mandatory, they can be marked as Mandatory.

If this additional information is requested, a checkout page is displayed between the tipping banner and the payment page. In this case, the text Continue is displayed in the call-to-action banner and the text specified under Button Text is displayed on the checkout page.

Donor information

Insert Tipping as widget in the sidebar

Some of the tipping templates are also available as widgets. Thus, a tipping banner can be integrated into the sidebar or the footer of the website and is thus displayed on every web page in which the sidebar or the footer is displayed.

In the WordPress menu under Appearance is the submenu Widget.

Under BTCPW you will find the BTCPayWall widgets listed.

BTCPayWall widget
BTCPayWall add widget

The desired BTCPayWall widget can thus be assigned to the place where it should be displayed.

The BTCPayWall Tipping Box is recommended for integration into the page footer. Likewise, BTCPW Tipping Banner Wide can be integrated into the footer as a page terminator.

The BTCPW Tipping Banner High is more suitable for integration in the sidebar.

On the BTCPayWall page, the BTCPW Tipping Box can be found as a widget in the footer and as a BTCPW Tipping Banner High in the sidebar.

The individual setting options of the BTCPayWall widget is analogous to the customization via editor described above.

edit BTCPayWall widget

Insert Tipping as shortcode

If you don’t edit your website with a special website editor for WordPress, you can also insert the tipping banners into your website via shortcode. BTCPayWall has created a BTCPayWall Tipping Shortcode Editor for this purpose.

You can find the BTCPayWall Tipping Shortcode Editor in the backend under BTCPayWall => Settings => Modules => Tipping

There you will find the menu item to create a new shortcode (Create a new shortcode) or under All Shortcode forms all already created shortcodes.

If you click on Create a new Shortcode and then on Select design, you get a selection of the available templates.

create btcpaywall shortcode
create BTCPayWall Tipping Shortcode

In our example we have selected the High Banner template and are shown the template.

If we also click on Select, we get to the area to customize the template according to our preferences.

Under Template Name we have the option to give the template its own individual name.

We can make the appropriate changes, as already described above.

Once we have made the changes and saved them with Save, the template is listed under All shortcode forms.

edit BTCPayWall Tipping Shortcode
BTCPayWall tipping shortcode

The Shortcode column contains the name of the corresponding shortcode.

This shortcode can be inserted at the desired place on the web page and the corresponding tipping banner will be displayed for the visitor of the web page.

No Comments
Share
0

You also might be interested in

Download Store Module

Jan 1, 2022

Download Store Module With the Download Store module, digital goods[...]

Pay-per-View Module

Dec 27, 2021

Pay-per-View ModuleThis is how you install the pay-per-view module on[...]

pay now lightning paywall
pay now lightning paywall

How to pay the Bitcoin Paywall?

Feb 6, 2021

How to pay the Bitcoin Paywall? After you have read[...]

Leave a Reply

Your email is safe with us.
Cancel Reply

Contact Us

We're not around right now. But you can send us an email and we'll get back to you, asap.

Send Message
BTCPayWall Integration - Professional integration of BTCPayWall on your Website. >>further information >>

Contact Info

  • BTCPayWall by internetactive GmbH
  • Willemerstrasse 4, 63067 Offenbach, Germany
  • +49 69-34869328
  • support@btcpaywall.com
  • https://btcpaywall.com

PARTNERSHIP

  • Coinpages - Bitcoin Directory
  • Coincharge - Accept Bitcoin payment
  • Bitcoin-Kaufen.org
  • Onlineshop24.com - Onlineshop creation

Tipping Box

Tipping logo

Support the work of BTCPayWall

Enter Tipping Amount

Powered by BTCPayWall

BTCPayWall – ABOUT US

  • Imprint
  • FAQ
  • Contact

© 2023 — BTCPayWall - The Bitcoin Paywall for Wordpress powered by Coincharge

  • Home
Prev Next