Donation Box Setup | Hope - Documentation | JoomShaper

Hope

Updated Last: 17 July 2020

Donation Box Setup

Admin Label

Admin label helps you identify better that you did with this addon. This will guide you while doing the further customization. You should name the admin label by keeping the relevance to the purpose of the addon you have added. This will surely save you from a lot of hassles.

Title

This option will allow you to add a text to the title. The purpose of the title is to express the naming of the section you just added with the addon. If you want to add the title, you just have to add it in the title textbox, it will be automatically added to the addon section.

Description

Add the description regarding the donation. It will be added under the title.

Paypal ID

Insert the PayPal id where you want to receive donations. You have to add the ID credential that you used to sign up to PayPal. Your PayPal ID = confirmed email address you have on the PP account. 

Currency

Add the currency in which you want to receive the payment. Right now you can select the following currency from the drop-down list.

  • United States dollar($)
  • British pound(£)
  • Russian Ruble(?)
  • Brazilian Real(R$)
  • Canadian Dollar($)
  • Czech Koruna(K?)
  • Danish Krone(kr.)
  • Euro(€)
  • Hong Kong Dollar(HK$)
  • Hungarian Forint(Ft)
  • Israeli New Sheqel(?)
  • Japanese Yen(¥)
  • Malaysian Ringgit(RM)
  • Mexican Peso(Mex$)
  • Norwegian Krone(kr)
  • New Zealand Dollar($)
  • Philippine Peso(?)
  • Polish Zloty(z?)
  • Singapore Dollar($)
  • Swedish Krona(kr)
  • Swiss Franc(CHF)
  • Taiwan New Dollar(?)
  • Thai Baht(?)
  • Turkish Lira(TRY)

More
You can set a field for the visitor to add a custom amount. Set the option to Yes to show custom donation amount insert option.

The target attribute for link
Set target attribute for link open option to the new window or on the same window.

CSS Class

This option will allow you to style a particular element in your added addon. Customize and style the particular content and then use this field to add the CSS class name you just used to style the content element. Also, don’t forget to refer it in your CSS file.

Buttons

You can add several amount button. Add your items using this option. 

Add New

Click to add a new donation amount button.

Item 1
Title Text
The text of the amount select box (only for admin show).

Amount
Add the amount of donation using this option.

Donate Addon Translation

You can translate addon by this file: language\en-GB\en-GB.tpl_shaper_hope.ini where all main phrases are stored:

;Donation Addon;
COM_SPPAGEBUILDER_ADDON_DONATION="Donation"
COM_SPPAGEBUILDER_ADDON_DONATION_DESC="Donation addon with paypal intrigration"

COM_SPPAGEBUILDER_ADDON_DESC="Description"
COM_SPPAGEBUILDER_ADDON_DESC_DESC="Addon description will show after title"

COM_SPPAGEBUILDER_ADDON_DONATION_PAYPAL_ID="Paypal ID"
COM_SPPAGEBUILDER_ADDON_DONATION_PAYPAL_ID_DESC="Insert the paypal id where you want to receive donation."

COM_SPPAGEBUILDER_ADDON_DONATION_MORE="More"
COM_SPPAGEBUILDER_ADDON_DONATION_MORE_DESC="Yes to show custom donation amount insert option"

COM_SPPAGEBUILDER_ADDON_DONATION_NO="No"
COM_SPPAGEBUILDER_ADDON_DONATION_YES="Yes"

COM_SPPAGEBUILDER_ADDON_DONATION_AMT_TITLE_TEXT="Title Text"
COM_SPPAGEBUILDER_ADDON_DONATION_AMT_TITLE_TEXT_DESC="Text of the amout select box (only for admin show)"

COM_SPPAGEBUILDER_ADDON_DONATION_AMT="Amount"
COM_SPPAGEBUILDER_ADDON_DONATION_AMT_DESC="Amout of donation"

COM_SPPAGEBUILDER_ADDON_DN_MORE="More"

COM_SPPAGEBUILDER_ADDON_DONATION_CURRENCY="Currency"
COM_SPPAGEBUILDER_ADDON_DONATION_CURRENCY_DESC="Select a currenct from the list (your paypal currency)"

COM_SPPAGEBUILDER_ADDON_DONATE_NOW="Donate Now"

Where to edit Donate Addon

To edit donate addon code check this file: templates\shaper_hope\sppagebuilder\addons\donation\site.php

Problem with other currency

Please edit file: templates/shaper_hope/js/main.js
Line: 202 with buggy code:


 amt = this_val.split('$'); 

fix code:


amt = this_val.split(crncy_code[1] || '$');