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
- Checks every reward. A message that is not signed with your secret key is refused.
- Adds a reward once. The same message can arrive again after a timeout or a resend; it changes nothing the second time.
- Takes a reversed reward back, once. Exactly the amount that was added.
- Keeps tests apart. Sandbox rewards and the test buttons in your dashboard are checked and answered, and only touch a balance while you have switched the plugin to its test mode.
- Signs the wall link. You can turn on "Require signed wall links" for the app straight away.
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.
- In WordPress, open Plugins, Add New, Upload Plugin, choose the zip file and activate it.
- Open Settings, YetiPoll. Copy the address shown there into the postback URL of your app in the YetiPoll dashboard.
- Enter the four keys of your app and choose where rewards go.
- Put the shortcode
[yetipoll]on a page.
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.
- Copy the folder
applicationfrom the download over the one of your site. It adds two files and changes none. - Paste the two short methods from the
pastefolder intoWh.phpandOfferwall.php, and add the menu link. - 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.
- Copy the folder
systemfrom the download over the one of your site. It adds two files and changes none. - Paste the case and the button from the
pastefolder intooffers.php. - 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
- Press Send a test completion on the page of your app. The postback log shows it as delivered, with status code 200.
- 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.
- 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 code | Meaning |
|---|---|
200 | Handled: a reward was added or taken back, the message had been handled before, or it was a test. |
400 | A 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. |
403 | The signature does not match. The secret key in the plugin is not the one of this app, or of this mode. |
404 | Your 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. |
503 | The 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.