ddswidget.html file - Purpose and Integration

This article describes how to place the ddswidget.html file on your server.

If you are integrating a LEMA or RaiseNow Free widget, which was created after March 15th, you will not need to serve this file from your domain anymore.

In this case, we are hosting the file so there is no reason to serve it from your domain.

If your LEMA was created before March 15th 2018, you can either ask us to switch to the new method or use the following guide:

The dds.widget.html file is an important part of the integration of our widgets.

While the Script Tag is responsible for loading and displaying the widget correctly, the ddswidget.html file allows us to redirect the customer after the final part of the checkout process back to your site and ensures that donations are successfully transacted over your server.

More precisely it is responsible for displaying the following window at the end of the payment process. 

If the ddswidget.html file is not integrated correctly into your side, the donor receives an error message after the checkout process. This can be quite confusing, since the donor might assume that the donation didn't go through. In reality though, the donation process was successful, the donation can be tracked in the RaiseNow Manager, but only the 'Thank you' page is not displayed. 

Hence, it is extremely important that the ddswidget.html file is integrated into your website. How the integration works is explained step by step below.

By default, we defined the path onto /widgets/lema/ddswidget.html. For example https://YOUR-DOMAIN.ch/widgets/lema/ddswidget.html

You can download the data file here:

https://widget.raisenow.com/widgets/lema/ddswidget.html

1. To do this, you go to said URL in your web browser (Note: don't use Microsoft Edge!). You will get an error message 'Missing stored_rnw_widget_instance_id parameter in response'. You can ignore and click away this error message.

2. Now click 'Save as...' and call the file 'ddswidget.html'. Choose to save this file in the format 'html only'. Copy or save this file in your Lema widget file folder on your webserver.

3. If you receive the error message 'Missing stored_rnw_widget_instance_id parameter in response' again when clicking on this new link, it means you have installed everything correctly.

! ATTENTION ! If you can't change the URL of the dds.widget.html file after you uploaded it to your server (often the case with Wordpress), please let us know the URL where the dds.widget.html file is saved. We can manually adjust this URL in our configuration and ensure that the checkout process will still work. It is only important that the ddswidget.html file is served from same domain as the widget. 

If you have any further questions or problems with ddswidget.html file, please do not hesitate to contact us under support@raisenow.com