IdoSell has a built-in tool, HTML/JS add-ons, that puts outside scripts on every page of your shop without editing the template, and that is all the Yaplet widget needs. You copy one block of code from Yaplet, paste it into an add-on, and the chat button appears on your shop.
This guide follows the Polish IdoSell panel, as IdoSell's own help shows it. Menu and field names are written exactly as IdoSell shows them, with an English translation in brackets.
1. Copy your Yaplet code
In the Yaplet dashboard's left menu, go to Brand → (your brand) → Chat widget → Install. If the tab asks where your website runs, choose Other website and switch off Include the <script> and </script> lines. Copy the code with the copy button on the code block.
The code must be plain JavaScript that starts with !function (Yaplet, with no <script> tags around it. If what you copied starts with a <script> line, leave out that first line and the last </script> line. In step 3 you choose the add-on type that adds those tags on its own.
2. Create a campaign
- In your IdoSell panel, go to Sklep → Dodatki HTML/JS (Shop → HTML/JS add-ons).
- Add a campaign. Give it a name in Nazwa w panelu (Name in the panel), set Aktywna (Active) to yes, and under Strony (Sites) tick the shops where the chat should appear.
- Save, and go back to the list of campaigns. Your campaign may still show as inactive: that is normal until it has a saved add-on.
3. Add the Yaplet code as an add-on
- For your campaign, choose Edytuj dodatki (Edit add-ons), then click Nowy dodatek (New add-on).
- Give the add-on a title, for example Yaplet chat, and set Aktywny (Active) to yes.
- Set the add-on type to JS. This type is for plain JavaScript and adds the
<script>tags itself. - In Pokazuj na urządzeniach (Show on devices), tick every device the chat should appear on. At least one must be ticked.
- For loading, choose Ładowanie razem z treścią strony (Load together with the page content). IdoSell recommends this for plain JavaScript, and the Yaplet code already loads the chat in the background.
- If your shop has more than one language, use Powiel we wszystkich językach (Copy to all languages), so the chat appears in every language version.
- Paste the code you copied into the add-on's content field.
- In Wyświetlaj w (Show in), choose koniec sekcji body (end of the body section).
- In Wyświetlaj na podstronach (Show on subpages), choose the whole shop.
- Leave the target group as it is: by default, the add-on is shown to all visitors. Then save the add-on.
4. Check your shop
IdoSell publishes add-ons on a schedule, so the chat can take up to about 60 minutes to appear. Then open your shop in a new browser tab and reload the page. The Yaplet chat button appears in the bottom-right corner. Click it to check that the chat opens.
For a full checklist, see Verify your installation.
Cookie consent (optional)
IdoSell reminds you that you must tell visitors about the cookies the scripts in your add-ons use, and let them say no. If you want the chat to load only after a visitor accepts a cookie category, choose Ładowanie przez AJAX, po załadowaniu strony (Load by AJAX, after the page has loaded) instead. Then edit the add-on again, add a cookie with Zdefiniuj nowy plik (Define a new file) and pick its category. This option appears only when you edit an existing add-on. Visitors who don't accept that category won't see the chat.
If the chat doesn't appear
- Less than an hour has passed. IdoSell can take up to about 60 minutes to publish an add-on.
- The add-on type is wrong. With the type set to JS, the code must have no
<script>tags. If you used the HTML type instead, the code must start with a<script>line and end with a</script>line. If it starts with!function (Yapletinstead, type<script>on a new line before it and</script>on a new line after it. - The campaign stays inactive. In the add-on, make sure at least one device is ticked in Pokazuj na urządzeniach, and save.
- The chat works only in one language version. Add-ons are kept per language. Paste the code into the other languages too, or use Powiel we wszystkich językach.
- IdoSell told you the add-on was switched off automatically. That happens when Automatyczna kontrola i wyłączanie (Automatic check and switch-off) is on and an outside script answers slowly. Set Aktywny back to yes, tick at least one device and save.
- Your browser shows an old copy of the page. Reload the page, or open your shop in a private window.
What's next
To see what the code does and where your widget ID is, read Install Yaplet.