Cómo integrar Koalendar en 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.