Icarus User Guide - Donation Buttons

This article covers donation button configurations supported by Icarus. If you need to display multiple donation buttons at once, add individual button configuration to the donates array like the following:

_config.icarus.yml

donates:
    -
        type: ... # Button 1
        ...
    -
        type: ... # Button 2
        ...

Each button has required settings, such as url, qrcode, or business and currency_code. If one of them is missing or empty, a red notice asking you to set it is shown in place of the button.

This article is also available in 简体中文.

The following donation buttons are provided by ppoffice/hexo-component-inferno. Please refer to it for a complete list of supported buttons and their configuration details.

Afdian.net

Installation Guide

1. Register for Afdian.net and copy the URL to your personal page.

2. Add the following configuration to your theme configurations:

   _config.icarus.yml

   donates:
       -
           type: afdian
           # URL to your afdian.net personal page
           url: https://afdian.net/a/your-username

Alipay

Installation Guide

1. Log into Alipay and export payment QR code.

2. Save the QR code picture to the asset directory of your Hexo website, or upload it to an image sharing service.

3. Add the following configuration to your theme configurations:

   _config.icarus.yml

   donates:
       -
           type: alipay
           # Path to your QR code image in your site, such as /images/alipay.png for source/images/alipay.png, or its full URL
           qrcode: /path/to/alipay/qrcode.png

Buy me a Coffee

Installation Guide

1. Register for Buy me a Coffee and copy the URL to your personal page.

2. Add the following configuration to your theme configurations:

   _config.icarus.yml

   donates:
       -
           type: buymeacoffee
           # URL to your Buy me a Coffee personal page
           url: https://www.buymeacoffee.com/your-username

Paypal

Installation Guide

1. Log into Paypal, click here to create a Paypal donation button.

2. Select “Country/Region” and “Language” in the “Choose button style” page and click “Continue” to advance to the next page.

   
   

3. Select “Use account ID” or “Use email address” as the unique identifier of your account in the “Add organization details” page. Then, click “Continue” to go to the next page.

   
   

4. Choose the “Currency you’ll receive donations in” and set “Amount donors can give” to “Any amount” in the “Set donation amounts” page. We currently do not support the option of donating in “An exact amount”. Click “Finish and Get Code” to go to the next page.

   
   

5. Copy business and currency_code from the “Button HTML” on the page. Put them to the business and currency_code settings in your theme configurations.

   
   

   For example, the following Paypal donation button code:

   Paypal HTML code

   <form action="https://www.paypal.com/cgi-bin/webscr" ...>
   <input type="hidden" name="cmd" value="_donations" />
   <input type="hidden" name="business" value="XXXXXXXXXXXXX" />
   <input type="hidden" name="currency_code" value="USD" />
   ...
   </form>

   maps to the following configuration:

   _config.icarus.yml

   donates:
       -
           type: paypal
           business: XXXXXXXXXXXXX
           currency_code: USD

Patreon

Installation Guide

1. Register for Patreon and copy the URL to your personal page.

2. Add the following configuration to your theme configurations:

   _config.icarus.yml

   donates:
       -
           type: patreon
           # URL to your Patreon personal page
           url: https://www.patreon.com/your-username

WeChat

Installation Guide

1. Log into WeChat and export payment QR code.

2. Save the QR code picture to the asset directory of your Hexo website, or upload it to an image sharing service.

3. Add the following configuration to your theme configurations:

   _config.icarus.yml

   donates:
       -
           type: wechat
           # Path to your QR code image in your site, such as /images/wechat.png for source/images/wechat.png, or its full URL
           qrcode: /path/to/wechat/qrcode.png

Something wrong with this article? Click here to submit your revision.