More in this section
Blogs RSS feed

Sitefinity Ecommerce Donation Widget

by User Not Found

I thought it would be exciting to demonstrate how you can use the Sitefinity Ecommerce API to create a custom donation widget for accepting online donations.    Donations are usually difficult for many ecommerce systems.  Below I have listed a few reasons ecommerce applications struggle with online donations.

  • The donation amount is usually constrained to a specific dollar amount, meaning you can only have donations like $5, $10, $15 dollars shown in a drop-down.   
  • Donations are usually separate products or options for a product priced at $0.  
  • Some ecommerce systems do not allow you to have a $0 price for your product and instead show you a  popup a window stating “Price must be greater than $0”.
  • Even the popular PayPal Donation button is limited to use a fixed donation amount, OR the visitor can enter their own donation amount; but not both.

These are just a few problems you can experience in typical ecommerce systems and applications, all of which are not ideal if you want to maximize your donation potential.    

In this post, I have included the source code for this project along with a video demonstrating how to add this project into a Sitefinity 5.x solution.  The video also demonstrates how to add the donation widget into Sitefinity along with making a sample donation and checking out.   I am using the Sitefinity 5.0 Starter Kit called “Corporate Starter” as this starter kit has Sitefinity Ecommerce enabled.   Because we are using the Sitefinity Ecommerce API, you will need the Sitefinity Ecommerce Add-On enabled in Sitefinity.   To see if your web site has the Ecommerce add-on enabled, login to the Sitefinity backend and look at the top main navigation for a button labeled “Ecommerce”.    If you see this button/selection, you have the Sitefinity Ecommerce Add-on enabled.   If you do not see the button labeled “Ecommerce” in the main navigation, you will need to purchase this Sitefinity Add-on in order to use this donation widget.

Below are the steps for adding the donation widget to your solution.

  1. Unzip the donation project into a new folder
  2. Open your Sitefinity solution file in Visual Studio
  3. Add an existing project to your solution and select the project file named “Telerik.Sitefinity.Samples.Ecommerce.Donations.csproj” located in the folder you created in step 1
  4. Right click on SitefinityWebApp and select “Add Reference”,  which will add a reference to the new donation project.
  5. Copy the file donation.css from the root of the project, into the following folder:
    SitefinityWebApp > App_Data > Sitefinity > WebsiteTemplates > Quantum > App_Themes > Quantum > Global
  6. Run your Sitefinity project and login to the Sitefinity dashboard (backend)
  7. Go to the following:    Administration > Settings > Advanced Settings > Toolboxes > Toolboxes > PageControls > Sections > Ecommerce > Tools.  This is where you will add-in the donation widget into Sitefinity so that is show up as a available widget to drag and drop onto a page. 
  8. Create a new toolbox and use the following information below
    1. Control CLR Type or Virtual Path = Telerik.Sitefinity.Samples.Ecommerce.Donations.DonationsWidget, Telerik.Sitefinity.Samples.Ecommerce.Donations
    2. Name = DonationsWidget
    3. Title = Donation Widget
    4. Description =  Online donation widget
    5. Click the save button at the bottom.  You have now added the donation widget into Sitefinity.   The donation widget can now be dragged and dropped onto a page.
  9. Click on Ecommerce and follow the steps below
    1. Click on Types of products
      1. Create a new product type called Donation
      2. Finish by clicking on the Create this product type and go define its fields.
      3. You can add in some custom product fields if you want to, and use them in the donation widget. Click on Save and proceed to next step
    2. Add a new product and following using the new product type of “Donation”, and follow the steps below
      1. Call the name of the product Donation
      2. Add some text in the description
      3. Keep the price at $0 and click save.
      4. Set the sku number to Online Donation
    3. Create a new page called Donate
      1. On the new page, drag and drop the Donation Widget, found in the Ecommerce section of the widgets.
      2. Edit the properties of donation widget and search for a product called donation.
      3. Select the donation product and click save.   This is how the donation widget is linked to a product.
      4. Publish the page and test your donation widget.  Select an amount shown in the drop-down, or select “other” and enter a user specific amount, like 1.99.
      5. Click add to cart.
      6. Done

        Click HERE to download the source code for the sample donation widget.

NOTE:  this functionality was disconnected in Sitefinity 6.3 because of the multiple prices changes made in this version. 


Leave a comment
  1. Matt Dec 20, 2012
    This is a really nice feature and I'd like to make use of it, but is there any chance you could update it so that it works easily with 5.3.  A bunch of the assembly references are no longer valid.  I have added <dependentAssembly> references to the web.config with not luck.
  2. Matt Dec 20, 2012
    Forget about my last comment.  Once I updated all the Telerik references in the Donations project everything worked fine.
  3. Justin Nov 18, 2013
    I'm using sitefinity 6.2 and I'm having a bit of a problem. I updated all the references and got the widget working, but after adding an item to the cart I get this error:

    "We apologize that product TEST PRODUCT is no longer available.   Please continue shopping."

    And the item is removed from my cart.
  4. David Lamb Feb 05, 2014
    I'm trying to use this with sitefinity 6.3, and I get the same problem as Justin.
  5. David May 09, 2014
    Is there anyway to get this kind of functionality in SF 7? I fount that i could get this working in 6.3 with the OptionDetails.TotalDeltaPrice property but neither method works in SF 7.
  6. jual kostum badut maskot Apr 04, 2018
    Wow Da weiss man, wo es hingehen muss Viele Grüsse  Mirta jual kostum badut maskot
  7. karnataka puc results 2018 Apr 05, 2018
    I am constantly looking online for articles that can facilitate me. Thx! karnataka puc results 2018
  8. Apr 06, 2018
    Hey! Nice stuff, do tell us when you post something like that!
  9. the commission machine  Apr 06, 2018
    There are some fascinating points in time in this article however I don know if I see all of them middle to heart. There may be some validity but I will take hold opinion until I look into it further. Good article , thanks and we want extra! Added to FeedBurner as well the commission machine 
  10. best company to buy gifts Apr 07, 2018
    Perfectly   written    subject material , thanks  for  selective information . best company to buy gifts
  11. diamond jewellery Apr 07, 2018
    *There is noticeably a bundle to know about this. I assume you made certain nice points in features also. diamond jewellery
  12. Qonubrey Wenria Domination Apr 07, 2018
    Flexibility means your space ought to get incremented with the improve in number of weblog users. Qonubrey Wenria Domination
  13. tìm bạn gái Apr 10, 2018
    Hi, ich habe Ihre Webseite bei der Suche nach Fernbus Hamburg im Internet gefunden. Schauen Sie doch mal auf meiner Seite vorbei, ich habe dort viele Testberichte zu den aktuellen Windeleimern geschrieben. tìm bạn gái
  14. Camping Apr 10, 2018
    Very interesting  details  you have mentioned , thanks  for posting . Camping
  15. stealth commissions demo Apr 10, 2018
    Hello there! Do you know if they make any plugins to protect against hackers? I’m kinda paranoid about losing everything I’ve worked hard on. Any suggestions? stealth commissions demo
  16. Lucht/water warmtepomp Apr 12, 2018
    I  believe  this  web site  has  some  rattling  wonderful info   for everyone : D. Lucht/water warmtepomp
  17. geometric bikini set Apr 12, 2018
    To know wisdom and instruction, to perceive the words of understanding geometric bikini set
  18. forex trendy review Apr 12, 2018
    Checking out the their site really does receptive the most up-to-date hold in Federal drug administration round the nutritional also with nutritious supplements. It is proper knowing the five most suitable usual supplements which can help appearing your presence. Health forex trendy review
  19. wsm piston kit Apr 15, 2018
    Thank you for the sensible critique. Me & my neighbor were just preparing to do a little research about this. We got a book from our local library but I think I learned better from this post. I’m very glad to see such excellent info being shared freely out there. wsm piston kit
  20. emagrecer Rodrigo Apr 15, 2018
    Certainly completely with your conclusions and think that you’ve made some excellent points. Also, I like design of your respective site plus the easier navigation. I’ve bookmarked your website and may return often! emagrecer Rodrigo
  21. Apr 15, 2018
    i have a very busy lifestyle too, and i would always frequently eat on Fastfoods“
  22. in home senior care Apr 16, 2018
    inkheart has great graphics but the story is not that very impressive; in home senior care
  23. sleeping disorders baltimore Apr 17, 2018
    LCD TVs can really save you from high electricity bills and office space. sleeping disorders baltimore
  24. SSLC Apr 27, 2018

    Karnataka SSLC Result 2018

    yeah i have heard of it before but only you made it possible . well Thanks anyway i am grateful that i learned something today


  25. Lucky Patcher May 07, 2018
    An impressive share, I just now with all this onto a colleague who was conducting a small analysis within this. And hubby in truth bought me breakfast simply because I uncovered it for him.. smile. So let me reword that: Thnx with the treat! But yeah Thnkx for spending plenty of time to debate this, I’m strongly regarding this and really like reading on this topic. If possible, as you become expertise, do you mind updating your site with a lot more details? It is highly of great help for me. Big thumb up just for this text! Lucky Patcher
  26. online audio May 07, 2018
    One thing I would really like to discuss is that weightloss program fast can be achieved by the appropriate diet and exercise. Ones size not simply affects the look, but also the overall quality of life. Self-esteem, depressive disorder, health risks, along with physical skills are damaged in excess weight. It is possible to make everything right whilst still having a gain. In such a circumstance, a medical problem may be the culprit. While an excessive amount of food and never enough exercising are usually responsible, common health conditions and traditionally used prescriptions can greatly help to increase size. Many thanks for your post here. online audio
  27. seo company May 09, 2018
    (well, almost…HaHa!) Fantastic job. I really enjoyed what you had to say, and more than that, how you presented it. Too cool! seo company
  28. macy brown Jun 20, 2018
    Everyone has their own affordable need and here you find the many ways to shop with F-Secure promo codes to save your money. You get many Saving Discount Deals on online shopping products in one store.

    Leave a comment