Using Raysly with OpenCart

This guide is for installers who have installed the Raysly extension. If you have not, start with Install Raysly on OpenCart.

The "Get instant offer" form gives your visitors a tailored solar offer in minutes, and every enquiry lands in your Raysly lead pipeline, ready to follow up.

This connector is in beta. Raysly keeps issuing offers and invoices as it does today; invoicing pass-through stays off while the connector is in beta.

Where the offer form appears

• On product pages (the setting "Show on product pages") and on the checkout success page.
• In any layout position where you add the Raysly module (Design → Layouts).
• On a "Get instant offer" information page: installing creates an enabled information page with the SEO keyword get-instant-offer, which shows the form. It is created only if that keyword is free.
• The form shows no prices, grants or tariffs itself. All figures in offers come from Raysly.

The menu link

A "Get instant offer" menu link is off by default. When on (and the page option is on), it is added when your menu is rendered and is never written into your menu data, so switching it off removes it at once. You can set the link text (up to 40 characters; empty means "Get instant offer" in the visitor's language). Themes that do not render categories in their menu template will not show it.

Change how the form looks

Extensions → Modules → Raysly has the look settings for the form. Each value is checked when you save it and again when the page is built.

• Look of the form: match your theme (the default), use the look saved in your Raysly account, or the Raysly look.
• Raysly cookie notice: on by default. Turn it off if your shop already asks visitors for cookie consent; the form then collects no consent, so Raysly analytics stay off.
• Page layout: "bare" (the default) shows only your logo or shop name, a way back to the shop and the form on the dedicated offer page; "theme" shows the form inside your theme. Product pages and the order confirmation always keep your theme.
• The bare layout applies to information pages that hold the Raysly layout module. Product and checkout success pages always keep your theme.

Send checkout leads to Raysly (optional)

Lead sharing is off by default. On the Raysly settings page tick Lawful basis, then Send opted-in checkout customers to my Raysly account as leads. Checkout then shows an unticked box "Share my details with (your company) to receive a solar offer". Until you confirm a lawful basis for sharing, nothing is sent. The leads land in your own Raysly account, and you are the data controller: Raysly processes them on your behalf, only on your instructions, under its data processing agreement.

• What is sent: name, e-mail, phone, address, company, language, your shop address and the order number as a reference. Only customers who ticked the box are sent.
• What is never sent: payment method or card data, order lines, totals, IP address, user agent and the customer comment.
• One lead per order, so reloads and retries never create a duplicate. Checkout never waits for Raysly.

Link your products

The Sync my products to Raysly button on the Products card makes a key id and a shared secret in your shop and sends them once to Raysly. Raysly then reads your products (name, description, price, stock, images) through a read-only feed that only Raysly can open, so you do not type them again. It never reads orders, customers or addresses. Disconnecting the shop switches the feed off.

If your Raysly plan does not include another connected shop, the button says so; disconnect a shop you no longer use or upgrade your plan.

Disconnect or remove Raysly

• Disconnect on the Raysly settings page revokes the key in Raysly, deletes it from the shop and switches the product feed off.
• Uninstall the module first, then uninstall the package from Extensions → Installer.
• Leads already sent stay in your Raysly account.