Start a conversation

How to embed your campaign widget into your website

Ok, so you have just signed-up for Generous, added and verified your bank account(s) and have created a Campaign for donors to give towards. Well done!

Now, you are ready to view your campaign donor widget on your charity website. There are 2 major steps to undertake. 

  1. Embed a one-time JavaScript block of code into the global footer section of your website.
  2. Embed the short <div> widget code of your specific campaign into the content section of any page on your website where you want donors to give.

You may need help from your web admin or web developer, however, if you are comfortable with HTML, WordPress or your content management system (CMS) you could give it a go yourself.


Ok, where do we find these bits of code?

  1. To find the JavaScript code login to your Generous Admin Console under the menu item > Settings > Organisation > Website [TAB]  > Generous Widget Code.
<script>!(function(d,x,f,i){
x=d.querySelectorAll('[data-generous-widget]');
for(i in x)if(x.hasOwnProperty(i)){
f=d.createElement('iframe');f.style.width='100%';
f.style.border='none';f.async=!0;
f.src='https://app.getgenerous.com/DonationComponent/DonationWidget...
...
...
</script>
  1. To find the unique Campaign <div> widget code login to your Generous Admin Console under the menu item > Campaigns > Select your Campaign > Click EDIT > Embed [TAB] > Click the Copy code to clipboard button. 
<div data-generous-widget='xxxxxxxx-xxxx-xxxx-xxx-xxxxxxxxx'></div>

Where do we embed the code?

  1. To embed the (long) JavaScript code    
    • Insert the code immediately above the closing </body> tag of your website’s footer template file (so that it is loaded on all pages of your website).          
      • All content management systems handle this a little differently. Just do a web search on "how to embed Javascript into the footer of mycms" or "how to apply global javascript/code/script using mycms". "Mycms" being your website content management system or website theme.
      • See this example we have done for a basic WordPress site.  
      • Remember, this is a "once-only" block of code needing to be inserted into your website
  2. To embed the (short) <div> widget code   
    • Log on to your website, create a new or use an existing web page, and paste the campaign widget code into a content area. For example:


    • When you want to insert a new giving campaign widget in your website simply follow step 2 again.

A few things to remember - troubleshooting

  • Make sure your Campaign is set to "Active" in the admin console so it renders "visible" on your website
  • You don't have to embed the (long) JavaScript code every time - once only
  • Be careful that you don't drop a part of the code, e.g., "script>" instead of "<script>"

Choose files or drag and drop files
Was this article helpful?
Yes
No
  1. Cam Butler

  2. Posted
  3. Updated

Comments