Documentation

Documentation 2016-10-29T15:18:25+00:00

The Documentation Page provide you with all informations for about our Joomla extensions.
Please select one of the below categories to browse the right extension.

Easy GCalendar – Enable Google-Maps support via JavaScript API Settings 2017-09-09T12:44:15+00:00

With version 1.2.3 Easy Calendar has added the support to define an seperate Google JavaScript API-Key.

This will allow you to use the Google-Maps within the Event details view otherwise you will receive an error message, cause Google has deactivate the public usage of Maps without a valid API-Key.

The API-Key could be easily set within the component global settings in  the Maps Tab (see screenshot below).

Easy GCalendar – Setup: Frontend Framework 2017-09-09T12:46:19+00:00

Within the Easy GCalendar settings you could switch between different frontend Frameworks that is quite useful if you use as example a template that is based on Bootstrap 3.

The Component currently supports the following Frontend Frameworks:

  • Bootstrap 2 (Joomla 3.x builtin)
  • Bootstrap 3
  • Bootstrap 4 (soon)

 

Easy Image Rotator – Responsive mode 2017-07-22T16:25:49+00:00

With version 2.0.6 EasyImage Rotator we have added support for responsive images and bootstrap 3 layouts. The new responsive mode is enabled by default und should work with single image and Image Slider setups.

Please be aware of the responsive mode does not work together with corping images that will be disabled aoutmaticaly if the responsive mode is enabled!

Easy GCalendar – Calendar filter options (overview) 2017-09-09T12:44:41+00:00

With version 1.2.0 Easy Calendar we have added the support of a new filter option for the calendar. This filter give you the possibility to select between the selected calendars from the backend and will than only display selected calendar events.

Enable Google Calendar API via API Manager 2017-04-17T14:06:16+00:00

To enable the required Google API functionality for to the Google Calendar please follow the instruction below. First of all, it must logon in with an existing account to https://console.developers.google.com or create a new one.

After successful login, you will see the API Manager – Dashboard her you could find a quick overview of usage statistics and a list of all enabled API’s for your account.

To enabled a new API please click on “Enabled API” you could than search for Calendar API and add it to your list of enabled APIs.

After you’ve added the Google Calendar API you also need to add credentials for it. Please navigate to the Credentials Overview within the API Manager you should than find your now key there.

If you do not yet have a Credentials, you must create a new entry via “Create credantials” DropDown chose “API Key” a new Key will be automatically generated we will then continue with with Restricting the Key to prevent unauthorized use.

Within the Credentials Details you could set a Name for management purposes but much more important you could give the key a restriction. For the usage with Easy GCcalendar you could chose IP addresses cause the communication of the component with the api will be handeld in the background from server to server.

Easy GCalendar – Google calendar Free / busy privacy settings 2017-09-09T12:45:02+00:00

If you like to use a calendar that has events that should not display any details like title, description or location cause of privacy restrictions you could do this by enabling the relevant setting within the Google calendar event settings.

Google Calendar free / busy settings

 

Google Calendar free / busy sample

The displayed text could be customized within the translations.

Test Google API Access for your calendar 2016-10-22T11:39:42+00:00

Easy GCalendar use Google Calendar to display events from a public calendar.

In some cases it might be useful to double-check if you could reach the API from your System / Browser, keep also in mind that the access of the API is maybe restricted e.g. to a specific IP-Address.

Google API Manager settings enabled APIs

Check the Google API Manager settings to get an overview of all enabled APIs. Ensure that the Calendar API is enabled.

Replace [YourCalendarId] with your Calendar ID from Google Calendar and the [KEY] with your Google Developer API Key (Double-check if there are any access restrictions for this key).

Sample URL: https://www.googleapis.com/calendar/v3/calendars/[YourCalendarId]/events?key=[KEY]

Google API call JSON response

Sample Google API call JSON response for the calendar.

Easy GCalendar – Setup Google Calendar 2017-09-09T12:45:56+00:00

Easy GCalendar use Google Calendar to display events from a public calendar. Google Calendar can serve as a backend that manages and persistently stores event data.

You must first have a Google Calendar API Key

  1. Go to the Google Developer Console and create a new project.
  2. Once in the project, go to APIs & auth > APIs on the sidebar.
  3. Find “Calendar API” in the list and turn it ON.
  4. On the sidebar, click APIs & auth > Credentials.
  5. In the “Credentials” section, click  Add Credentials > API key.
  6. Choose “Server key”.
  7. If you know what domains or IP-Addresses will host your calendar, enter them into the box. Otherwise, leave it blank. You can always change it later.
  8. Your new API key will appear in the list of your API keys.

Make your Google Calendar public

  1. In the Google Calendar interface, locate the “My calendars” on the left.
  2. Hover over the calendar you would like to use and click the downward arrow.
  3. A menu will appear. Click “Share this Calendar”.
  4. Check “Make this calendar public”.
  5. Make sure “Share only my free/busy information” is unchecked.
  6. Click “Save”.

Obtain your Google Calendar’s ID

  1. In the Google Calendar interface, locate the “My calendars” area on the left.
  2. Hover over the calendar you would like to use and click the downward arrow.
  3. A menu will appear. Click “Calendar settings”.
  4. In the “Calendar Address” section of the screen, you will see your Calendar ID. It will look something like “abcd1234@group.calendar.google.com”.
Easy GCalendar – Getting started 2017-09-09T12:45:38+00:00

Install the extension

Download the latest version of the Easy GCalendar. Next, go to your Joomla backend administration area and install it via Extensions -> Install/Uninstall.
Now all required extensions of Easy GCalendar are installed.

  • Download the latest version of the Easy GCalendar
  • Go to the Joomla extension manager
  • Click on the Upload & Install button and choose the downloaded package

Set your timezone

In your Joomla Global Server settings, change the time zone to your timezone. The timezone you set is important to display the calendar items in the right timezone within the calendar.

Setup your first calendar

Before we can display results on the Site it is necessary to setup at least 1 or more Goolge Calendar entries within the Administration that could than used later on within the component & modules.

  1. Click on Components > Easy GCalendar > Calendars
  2. Click on New Button
  3. Fill out the form completely
  4. Click on Save & Close Button

Setup first calendar step 1

Setup first calendar step 2

If everything was successfully you should now see your newly created calendar listed within the list:

Setup first calendar step 3

Setup your calendar site

  1. Click on Menus > Main Menu > Components > Add New Menu Item
  2. Select “Easy GCalendar > Calendar view” from Menu Item Type selection possibilities.

Setup calendar site item 1

Setup calendar site item 2

After the item type selection you will see the following screen all the red marked tabs contains configuration possibilities to customize the Easy Calendar:

Setup calendar site item 3

The “Basic Options” Tab contains the configuration possibility to customize the the calendar view:

Setup calendar site item 4

The “Event” Tab contains all possible options to configure the event details view:

Setup calendar site item 5

Finally, you should now save the new entry by clicking on the “Save & Close” button!

Can I use a URL instead of the directory path? 2014-01-30T12:19:50+00:00

NO this is currently not possible.

What is the directory root for images ? 2016-10-22T11:39:42+00:00

The image root is your joomla website from that you can specifie every relative path your want e.g. mages/sampledata/fruitshop/* or images/banners/test.png

How can i install or Update the Extension? 2014-01-30T12:20:29+00:00

Download the latest version from this website and  go to your extension manager within your joomla administration site. Select the .zip archive an click Upload & Install (If you want to proceed a update follow the same instructions)