Skip to main content

Documentation

Help & FAQ
Troubleshooting
# 54
Last editetd on 15 June 2026

Solutions for common problems during installation and operation of JoomBook.

Installation Errors

"Error installing the package"

  1. Check that PHP 8.3 or higher is installed
  2. Check that the /tmp directory is writable
  3. Temporarily increase upload_max_filesize and post_max_size in php.ini to at least 32 MB

Plugins not activated after installation

Navigate to System → Plugins, search for "joombook" and manually enable all plugins found.

Frontend Issues

Booking wizard does not appear

  1. Check that mod_joombook_wizard is enabled and assigned to the correct page
  2. Check under System → Plugins that the "JoomBook AJAX Handler" plugin is enabled
  3. Open the browser console (F12) for error messages

JavaScript errors in the console

Make sure no other plugin or template is loading Alpine.js in an incompatible version. JoomBook includes its own copy of Alpine.js.

Backend Issues

No appointments visible in the calendar

Check that FullCalendar is loaded correctly: look for fullcalendar files in the Network tab of browser developer tools. If not loaded: clear the cache and reload.

License key is not accepted

  1. Make sure your server allows outgoing HTTPS connections to license.joombook.com
  2. Check that the PHP extension curl is enabled
  3. Try again after 60 seconds (rate limiting)

Joomla! Logo
JoomBook is not affiliated with or endorsed by The Joomla! Project™ or Open Source Matters, Inc. The Joomla!® name and logo are registered trademarks of Open Source Matters, Inc. in the United States and other countries.

Copyright © · JoomBook