CryptoWiz manual - Use cases

Permalink

Please note that most examples shown here are meant to dilute the counters of received coins on your buttons. Unless you define another target, all coins will be sent to your account. Then you will be able to review where everything is coming from on your buttons analytics pages.

In all cases, the building of the buttonizer URL is described. To add it to your HTML code, you’ll need to set the URL to the href attribute of an <a> tag and add a caption to be shown while the button is rendered, E.G.:

<a href="...">Tip me now</a>

Receiving tips and donations

Sitewide donations at the header or footer

These steps are here to show you how to deploy a global donations button to be shown either at the top or at the bottom of your website.

In all cases, public_key should be replaced with the Website Public Key and the button_id is the id of the button from the website you’re using.

  1. Create your website.
  2. Add the buttonizer controller code at the <head> of your website template.
  3. Create your button and set the entry identifier as “my_website_donations”.
  4. Either starting the <body> tag or just before closing it, paste the <a> as it is generated.

That’s it. The button will show the counters for the donations received from any page of your whole website no matter the page where the button is shown.

Per-page donations on your blog

If you want to get a button and account the coins received for a specific page, it is as simple as leaving the entry id empty, so the buttonizer passes the URL to the API.

If you want to set a specific string as entry_id instead of the whole page URL, you must:

  1. Set the button without an entry id.
  2. Pass the entry_id and entry_title to the link as shown below:
https://blockchainfinancial.com/crypto_wiz/buttonizer/public_key/button_id
    ?entry_id=article_slug
    &entry_title=Article+Title

Per-article per-author donations on your blog

For this case, you’ll have to define the email of the author as target_data.

Note: if you’re using a CMS, you may need to create a plugin to inject the link code programmatically.

  • To invoke it by letting the page URL and title automatically set as item data:
https://blockchainfinancial.com/crypto_wiz/buttonizer/public_key/button_id
    ?target_data=author@email.com
  • To get coins go to the author without referencing the source article:
https://blockchainfinancial.com/crypto_wiz/buttonizer/public_key/button_id
    ?entry_id=tips_for_joe
    &entry_title=Tips+for+Joe+at+My+Website
    &target_data=author@email.com

Selling goods or services

Express 1-click purchases

When you have a storefront and you can inject the button link, you end up using entry_id, entry_title and entry_data parameters after every item you have available on the page:

https://blockchainfinancial.com/crypto_wiz/buttonizer/public_key/button_id
    ?entry_id=sku_of_the_item
    &entry_title=Name+of+the+item
    &entry_data1=user_id_on_your_side
    &entry_data2=user_name
    &entry_data3=user_email

Important: the entry_data parameters may be empty when the user hasn’t logged into your store. So, you have two options:

  1. Do not render the link for the button for offline users and render it when they open a session so you can put their id on the ref parameter
  2. Render the buttons without the entry_data parameters and, when you get the notification, manually take the proper steps.

As an option on checkout

If you want to put the button as a payment option on the checkout page of your storefront, it comes easier to track the purchase with the button, since you can pass the order id as entry_id and use the ref parameter for extra info you may need:

https://blockchainfinancial.com/crypto_wiz/buttonizer/public_key/button_id
    ?entry_id=order_id
    &entry_title=User+Order+on+My+Website
    &entry_data1=user_id_on_your_side
    &entry_data2=user_name
    &entry_data3=user_email

Here again, you need to know the user details in advance. If you can’t set them through PHP, you have a last resort: JavaScript. Please revisit the JavaScript hooks for the controller information.

Further reading

Technical specifications

Go back to the manual index