More in this section
Blogs RSS feed

Sitefinity Ecommerce Donation Widget

by Steve Miller

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. Arnold Jan 18, 2018
    I can`t aggree with you. I think other way than you. But it`s nice to read how someone else is thinking. Like it! neet 2018 form
  7. chris Jan 20, 2018
    Very good written article. It will be supportive to anyone who utilizes it, including me. Keep doing what you are doing – can’r wait to read more posts. health benefits of coleus forskohlii
  8. ronijames Jan 21, 2018
    I ran across your site last week and started to follow your posts consistently. I haven’t commented on any kind of blog site just yet but I was considering to start soon. It’s truly exciting to actually contribute to an article even if it’s only a blog. I really don’t know exactly what to write other than I really loved reading through a couple of of your articles. Great articles for sure. I will keep visiting your blog regularly. I learned a lot from you. Thanks! Jacob
  9. chris Jan 23, 2018
    Your web journal furnished us with important data to work with. Each and every tips of your post are wonderful. Much obliged for sharing. Continue blogging,  Foreign Exchange Trading
  10. chris Jan 30, 2018
    Awesome article Lot's of data to Read...Great Man Keep Posting and upgrade to People..Thanks  tree care Kingwood Texas
  11. chris Jan 31, 2018
    Phenomenal website you have here. You'll find me taking a gander at your stuff regularly. Spared!
  12. pills breast enhancement Feb 01, 2018

    You completed several good points there. I did specific searches on the issue and found many people go in conjunction with along with your blog. pills breast enhancement

  13. roni Feb 02, 2018
  14. roni Feb 02, 2018
    Thanks for the info. And a response from you. car dealers hips san jose dog training commands list
  15. roni Feb 03, 2018
    Hello super schöner Webblog den ihr da habt. Bin gerade über die Google Suche darüber gestolpert.  Gefällt mir echt super gut. macht weiter so. MFG Martina dog training basics
  16. roni Feb 03, 2018
    For anyone one of the lucky people’s, referring purchase certain products, and in addition you charm all of the envy of all the the many any other people around you that tend to have effort as such make a difference. motor movers dog training basics
  17. roni Feb 03, 2018
    Paper rolls… very great read you know alot about this subject i see!… how to use udimi
  18. roni Feb 03, 2018
    When I originally commented I clicked the -Notify me when new surveys are added- checkbox and today if a comment is added I am four emails with the exact same comment. Is there any way you can eliminate me from that service? Thanks! custom website
  19. roni Feb 03, 2018
    Hiya! awesome blog! I happen to be a daily visitor to your site (somewhat more like addict   ) of this website. Just wanted to say I appreciate your blogs and am looking forward for more to come! click here
  20. roni Feb 04, 2018
    Hi there,  You have done a great job. I will definitely digg it and personally recommend to my friends. I’m confident they’ll be benefited from this website. Numerology
  21. marketing1on2 Feb 05, 2018
    omg! can’t imagine how fast time pass, after August, ber months  time already and Setempber is the first Christmas season in my place, I really love it! marketing1on1
  22. roni Feb 05, 2018
    I’m impressed, I must say. Really rarely do I encounter a blog that’s both educative and entertaining, and let me tell you, you have hit the nail on the head. Your idea is outstanding; the issue is something that not enough people are speaking intelligently about. I am very happy that I stumbled across this in my search for something relating to this. starting a security guard company
  23. roni Feb 05, 2018
    Really interesting and special post. I like things such as making more homework, developing writing skills, and also related things. These kinds of secrets help in being a qualified person on this topic. This page is very helpful to myself because people like you committed time to learning. Regularity is the key. But it is not too easy, as has been designed to be. I am not an expert like you and plenty of times I feel really giving it up. financial visualizations
  24. roni Feb 05, 2018
    obviously like your web site however you need to take a look at the spelling on quite a few of your posts. Many of them are rife with spelling problems and I to find it very bothersome to inform the reality nevertheless I’ll definitely come again again. cryptocurrency for newbies
  25. bad credit car dealers in Chicago Feb 08, 2018
    I needed to thank you for this awesome read!! I certainly getting a charge out of each and every piece of it I have you bookmarked to look at new stuff you post.  bad credit car dealers in Chicago
  26. wedding video singapore Feb 08, 2018
    The primary frequent slip-up is combing that tresses directly back. This may covers bald spots, nonetheless it only reveals the particular forehead and draws attention for the receding hairline. wedding video singapore
  27. roni Feb 12, 2018
    Hey, I simply hopped over for your website by means of StumbleUpon. Now not one thing I’d in most cases read, but I appreciated your emotions none the less. Thanks for making one thing price reading. agen domino
  28. roni Feb 12, 2018
    Hiya, I am really glad I’ve found this information. Nowadays bloggers publish just about gossips and net and this is actually annoying. A good web site with interesting content, this is what I need. Thanks for keeping this site, I’ll be visiting it. Do you do newsletters? Can’t find it. gdpr training london
  29. roni Feb 12, 2018
    In my opinion ,, truth be told, the achievements work with respect to basically the% good results is% response to these letdown. How To Make 20 Dollars Fast
  30. red tea detox progam Feb 15, 2018
    How do I know if a Wordpress theme supports a subscribe option? red tea detox progam
  31. mobilee demo Feb 17, 2018
    Nice information, many thanks to the author. It is incomprehensible to me now, but in general, the usefulness and significance is overwhelming. Thanks again and good luck! mobilee demo
  32. ignition training Feb 19, 2018
    Nice information, many thanks to the author. It is incomprehensible to me now, but in general, the usefulness and significance is overwhelming. Thanks again and good luck! ignition training

    Leave a comment