Bitcoin Voting Plugin Installation Guide

With the Coinsnap Bitcoin Voting Plugin, Coinsnap offers the possibility to easily offer Bitcoin polls anywhere on your WordPress website.

You can download the plugin directly from the WordPress Marketplace or install it directly from within your WordPress installation.

Log in to your WordPress account, call up the WordPress backend and go to Plugins > Add New.

Enter “Coinsnap Bitcoin Donation” in the search bar.

When shown the Coinsnap Bitcoin Voting plugin, click on Install now, then on Activate.

The Coinsnap Bitcoin Voting plugin is now successfully installed and is listed as Bitcoin Voting in the black, left sidebar in the WordPress backend:

Bitcoin Voting Coinsnap Settings

After you have installed and activated the Coinsnap Bitcoin Voting plugin, you need to configure the Coinsnap settings. Go to Bitcoin Voting [1] -> Settings [2] in the black sidebar on the left.

Now choose your payment gateway BTCPay [1] and click save.

Now, log into your BTCPay Server. If you’ve done that, enter your BTCPay Server URL into the matching field in the Donation Settings tab [1].

Next, you’ll have to click on the Generate API Key button [2].

You’ll then be forwarded to your BTCPay Server.

Choose your Shop [1], then click on continue [2].

You’ll then be forwarded to this screen. Enter your shop’s name on the top [1], and then click on authorize app [2].

Your BTCPay Server is now successfully connected to your online store, via the Coinsnap Bitcoin Donation plugin! 

(If you click on check you will get the success notice (in green)).

How to set up a poll

Go to Bitcoin Voting -> Polls in the left sidebar. On the top left of the screen click on the button Add New Poll.

You will see the poll configuration window now. First, you need to name your poll. This is also the headline that your voters get to see in the voting box [1]. Then, of course, activate the poll by checking enable [2].

You can also limit voters to vote just once. [3]

If you like, give your voters a description so they know what they are voting for, what you intend to do with the poll, etc. – whatever comes to your mind. [4]

Then you have four options. These are the statements or choices your voters can make or choose. Fill in the possible choices as needed for your poll. [5]

Now you need to define the cost for voting. The minimum amount that is technically possible is 13 sats (or 1 €-Cent). If you are using the Bitcoin payment just to prevent bots from voting, 13 sats is a good choice. If you want to make a small income with your poll, feel free to enter any other amount in satoshis. [6]

In the next two field you set the running time of your poll. [7]

Then, you can set a thank you message that your voters see after successfully paying and voting [8].

Next to [9] you see the shortcode that you need to place on your website wherever you want to present the poll. Just copy the shortcode and paste it to the appropriate place.

And last, but not least, you can choose to collect certain information from your donors by checking the box in the Collect donor information line [10].

Collecting information from your voters

If you want to gather some intelligence on your voters, and have clicked the checkbox to do so, you will see this menu.

Now just choose which information you want to gather, and if you want it to be a mandatory information or leave it as an option for your donor to decide.

In this example the first name of the donor is a mandatory information. We do not try to collect their last name (Hidden), leave it to them to leave their Email and a message (Custom Field Name, to be filled by you). Accordingly, these fields are labelled optional.

Placing the Bitcoin poll box on your website

Now you are ready to display the Bitcoin donation box on your website. Simply copy the shortcode (here [coinsnap_bitcoin_voting id=”12″]) and paste it at any place you choose

After all settings have been made, a test transaction should be carried out.

First, cast a vote in a Coinsnap Bitcoin Voting poll box that you placed on your website (just click on your choice).

Then provide the required information.

After successful payment, within a few seconds you will see the poll box again, now showing you the results of the voting so far: