⚠ In case you have a WIX website, check our WIX implementation guide.
Our widgets generally consist of 2 components.
You can find both in the
The first part is a script and an rtr-checkout element.
The script establishes the connection to your Rentware Account and provides the functionality for the HTML elements. The checkout is responsible for rendering the cart and the booking steps in the checkout.
You can define those booking steps and what appears in them in the
The first part will look like this:
<script
type="module"
src="https://cdn.rtr-io.com/widgets.js"
></script>
<script>
window.RTR_ACCESS_TOKEN = 'YOUR_ACCESS_TOKEN';
</script>
<rtr-checkout></rtr-checkout>
It is recommended to simply paste it into a global header or footer (if your entire website should have rentware functionality), or somewhere in the body of specific subpages (if only certain subpages are about your rental business, while others for example are about sales, which happen outside of Rentware).
It is also important to note, that a checkout should only exist once per page.
If you by accident render the rtr-checkout twice, you will run into issues with online payment providers.
The second part is just an HTML element with your specific booking widget.
If we take a search widget as an example it will look like this:
<rtr-search></rtr-search>
It can contain further parameters to specify the behaviour of the search widget.
This part you can simply put into the specific place, where the widget should appear as an HTML element.
Important Note:
Even though it is technically possible, you should never integrate the widgets via an iFrame. An iFrame isolates the widgets within a container and will break layouts (especially on mobile) and can break online payment functionality.
Multiple languages:
If you have multiple languages enabled, the widgets will try to detect the language of your website as defined in the <html> object.
For example if your website says
<html lang="de-DE">
the widget will try to load your german translations. If your Rentware account is not set to include german, it will default to your default language.
If you should run into problems with the automatic language detection, you can also overwrite it by adding the parameter
window.RTR_LOCALE = 'de-DE';
to your script.