How to Embed Koalendar in Joomla
You can easily add your Koalendar booking page to your Joomla website so visitors can book time with you without leaving your site.
There are 3 ways to embed your booking calendar:
- 💻 Inline Embed – show your calendar directly on the page
- 📍 Popup Widget – add a persistent “Book now” button to the corner of your site
- 🔗 Popup on Click – open your calendar when someone clicks a link or button
All options are fully supported when using Joomla’s custom HTML options.
📑 Menu
- 📋 Step 1 – Copy your embed code
- 📝 Step 2 – Paste it into Joomla
- 🛠️ Troubleshooting
- 🤔 Which embed style should you use?
📋 Step 1 – Copy your embed code
- In the Koalendar dashboard, click Share on the booking page you’d like to add.
- Select Add to website.
- Choose an embed style (Inline Embed, Popup Widget, Popup Text) and click Copy Code.
Embed style | What it does |
---|---|
Inline Embed 🖥️ | Displays the booking calendar directly on a page. |
Popup Widget 📍 | Adds a floating “Book now” button that opens a calendar popup. |
Popup Text 🔗 | Turns any link or button into a popup calendar. |
💡 Feel free to customise colours, text, icon, and positioning before copying the code.
📝 Step 2 – Paste it into Joomla
Option A – Custom HTML module (recommended)
- In your Joomla admin panel, go to Extensions → Modules → New → Custom (HTML).
- Choose a Position and set Show Title as needed.
- Select the Code or Tools button (<>) and paste your Koalendar code.
- Save & Publish — your calendar (or button) is live!
Option B – Directly in an article
- Content → Articles → edit or create an article.
- Click the Code (
<>
) icon in the editor toolbar. - Paste the Koalendar code where you want it to appear.
- Save & Preview.
⚠️ Embed disappeared? Go to System → Global Configuration → Text Filters and set your user group to No Filtering. This stops Joomla from stripping
<iframe>
and<script>
tags.
🛠️ Troubleshooting
Issue | Quick fix |
Embed not showing | Confirm Text Filters are disabled for your user group. |
Link shows but no popup | Make sure the Koalendar script is still present in page source. |
Widget on every page | Place the code in a module assigned only to specific pages. |
Changes not visible | Clear Joomla & browser caches after updates. |
🤔 Which embed style should you use?
Goal | Best style |
Dedicated booking section | Inline Embed 🖥️ |
Site‑wide call‑to‑action | Popup Widget 📍 |
Add scheduling to an existing CTA | Popup Text/Button 🔗 |
Simplest approach | Direct Link ↗️ |
Mix and match styles across different pages if it helps users book faster.