Plugins

If your site runs on one of these, you do not have to write any code. Each download shows the wall to your signed-in users and adds their rewards for you.

WordPress · VieFaucet · ClaimBits / CryptoFaucet

What every plugin does

All three share one postback handler, a single PHP file without dependencies. If your site runs on something else, you can use that file as it is: it is in every download, with the five methods your site has to provide described at the top.

WordPress

A plugin with one shortcode. Rewards go to myCRED, GamiPress, WooCommerce Points and Rewards, or a balance the plugin keeps itself.

  1. In WordPress, open Plugins, Add New, Upload Plugin, choose the zip file and activate it.
  2. Open Settings, YetiPoll. Copy the address shown there into the postback URL of your app in the YetiPoll dashboard.
  3. Enter the four keys of your app and choose where rewards go.
  4. Put the shortcode [yetipoll] on a page.

Download yetipoll-1.0.0.zip

Version 1.0.0 · the full steps are in the readme inside · licence: GPL-2.0-or-later

VieFaucet

Two files to upload and two short methods to paste. Rewards go to the balance of your users.

  1. Copy the folder application from the download over the one of your site. It adds two files and changes none.
  2. Paste the two short methods from the paste folder into Wh.php and Offerwall.php, and add the menu link.
  3. Set the postback URL of your app to https://your-site/wh/yetipoll.

Download yetipoll-viefaucet-1.0.0.zip

Sign in first and this download comes with the keys of your app already filled in.

Version 1.0.0 · the full steps are in the README inside · licence: MIT

ClaimBits / CryptoFaucet

Two files to upload and one case to paste. Rewards go to the credits of your users.

  1. Copy the folder system from the download over the one of your site. It adds two files and changes none.
  2. Paste the case and the button from the paste folder into offers.php.
  3. Set the postback URL of your app to https://your-site/system/gateways/yetipoll.php.

Download yetipoll-claimbits-1.0.0.zip

Sign in first and this download comes with the keys of your app already filled in.

Version 1.0.0 · the full steps are in the README inside · licence: MIT

Your reward currency

A plugin adds exactly the amount we send. Set the reward currency of your app in the dashboard so that one unit is one point, coin or credit on your site. GamiPress and WooCommerce count whole points, so use a currency without decimals for them.

Checking that it works

  1. Press Send a test completion on the page of your app. The postback log shows it as delivered, with status code 200.
  2. For the whole way, switch the plugin to its test mode, open the surveys on your site as a user and finish a practice survey. The reward appears on that user's balance.
  3. Switch back to live before real users see it.

The postback log keeps the status code of every call. The plugins answer with these:

Status codeMeaning
200Handled: a reward was added or taken back, the message had been handled before, or it was a test.
400A value is missing. The postback URL of the app was changed so that it no longer carries all of them: set it back to the plain address.
403The signature does not match. The secret key in the plugin is not the one of this app, or of this mode.
404Your site has no such user, or the plugin is not at this address. The plugins pass the numeric user id of your site to the wall.
503The keys are still missing in the plugin, or the points plugin you chose is switched off.

Opening the address in your own browser shows the same in words, such as ERROR the signature does not match.

Something else

For any other site, the postback page has the rules and sample code, and the script shows the wall with one line.