There is an updated version available of this tutorial

Joomla! Module for SuperSaaS Appointment Scheduling

SuperSaaS is a flexible online appointment scheduling system that works with many different businesses. This page explains how to integrate it into a Joomla based website. To be able to use it you will first need to sign up for a (free) SuperSaaS account.

Using Joomla login names for your SuperSaaS schedule

The SuperSaaS Joomla module displays a “Book now” button that automatically logs the user into a SuperSaaS schedule using his Joomla user name. If you are not using the Joomla user registration system then you should instead follow the general instructions to integrate a schedule on your site.

The button generated by the module passes the Joomla user database information along to SuperSaaS, creating the user in the SuperSaaS database or updating his information as needed. This saves users from having to create a separate login for the booking system and avoids the need to log in twice.

Installation and setup of the module in Joomla

  1. Install the module. On the Joomla administrator page go to “Extensions” → “Extension Manager” and under the heading “Install from URL” enter the web address:
    • For Joomla 3.2+ you can use the option “Install from Web” and search for “SuperSaaS”
    • For Joomla 1.6, 1.7, 2.5 or 3.0 enter "http://cdn.supersaas.net/plugins/mod_supersaas_25.zip"
    • For Joomla 1.5 enter "http://cdn.supersaas.net/plugins/mod_supersaas_old.zip"
    (You can also download the module to your computer first and use “Upload File & Install”)
  2. Set up the module. Go to the “Extensions” → “Module Manager” screen and click the module name (“SuperSaaS login”) to go to the "Module:[Edit]" screen:
    • For Joomla 3+ set the status to “Published”, Select a position, set the “Access Level” to “Registered”, and on the “Menu Assignment” tab select the page(s) where to display the module.
    • For Joomla 1.5+ set the “Enabled” button to “Yes”, set the “Access Level” to “Registered”, and in the “Menu Assignment” section select the page(s) where to display the module.
    Next fill out the “Parameters” section:
    • SuperSaaS account name. This is name of your account (not your email address)
    • SuperSaaS password. This is the password that the administrator uses to log in to SuperSaaS
    • Schedule name or URL. You can either put the name of a schedule or you can provide a full URL if you want to add specific parameters to direct the user to a specific view
    • Button image. If you leave this blank a standard button will be used, alternatively you can enter a URL like this one “http://cdn.supersaas.net/en/but/booknow_red.png”
    • Custom domain. If you created a custom domain name to point to your schedule then you can enter it here to correctly point your users to it

If you are using more than one schedule with SuperSaaS you can create multiple buttons by making copies of the module on the “Module Manager” screen. You can then set up each copy to point to a different SuperSaaS schedule.

Joomla! SuperSaaS Module

Install Joomla! Extension

For Joomla! 3.2+ it is easy to implement the SuperSaaS module using the “Install from Web” option.
  • Choose the tab “Install from Web”
  • Search for “SuperSaaS” using the search field
  • Click on the “SuperSaaS” result in the listing
  • Click the green “Install” button
  • Next, follow the instructions at point 2 above

Change SuperSaaS account settings to work with Joomla

Your Joomla user database is leading, which means that changes in user information on your Joomla site propagate to SuperSaaS but not the other way around. Therefore we recommend that you do not let your users change their user information on SuperSaaS because that could easily confuse them. For example, if a user were allowed to change his password on SuperSaaS he would probably not realize that his Joomla password is still the same. Make the following changes to your SuperSaaS account to avoid such inconsistencies:

Secondly, you need to ensure that the database fields in Joomla match those in your SuperSaaS user database. Make the following changes on the “Access Control” page:

You can now try out the button on your site. As the administrator, you will still need to log in through the main SuperSaaS login page so you would want to try this out pretending to be a regular user. If you want to define “superusers” in SuperSaaS make sure they have logged in at least once using the button before changing their role on the “User Management” page.

SuperSaaS Administration Panel

Configure SuperSaaS

The image to the left depicts the “Access Control” page in your SuperSaaS account after making the settings described above.

Troubleshooting tips


Back to Tutorial index