Chapter 1. Introduction

This manual covers the features of Event Gallery 3.10.24.

It's time to introduce a new gallery component for Joomla. I guess you're already waiting for something like this since there is a real lack of such kind of components ;-)

Initially I build this component to show photos of different events to the audience. To where other components have folders this component calls them events. Because of that this component is called Event Gallery. But don't be tricked by that. It's a full fledged gallery component. So install it and give it a try.

Features

Let's list some features Event Gallery provides:

  • Works with Joomla 3 and PHP 7

  • Displays images from local folders, Amazon S3 folders, Flickr and Google Photos

  • Cart & Checkout to allow collecting orders.

  • Modules and plugins as part of Event Gallery Extended.

  • Four different layouts for a list of events

    • Tile List

      A Pinterest like tile layout where the name and description of an event are easily visible and can use much more space than using the Grid layout.

    • Grid List

      Shows your events with a preview image in a grid layout.

    • Image List

      Shows your events with a masonry layout.

    • Simple List

      This kind of layout show your events as a simple list of text links.

  • Five different layouts for a list of images:

    • Image List

      This list type presents all images of an event as a simple long list. You can zoom into images using a lightbox.

    • Pageable Image List

      While nearly identical to the Image List view this view provides a dedicated page for every image. This page allows you to step from image to image.

    • Ajax Image List

      If there is limited space the Ajax Image List is for you. It provides a spitted interface where you have a full image on one side and a pageable list of thumbs on the other side.

    • Tile List

      Displays your images in a Pinterest like layout. This view allows to display the image title and description below each image.

    • Grid List

      The grid list is showing your images in a very simple way. It's a kind of a table but it supports responsive layouts.

  • Lightbox with integrated paging and support for *swipe gestures* on touch enabled devices

  • Deep links - you can link from a menu directly to a specific event

  • Tags - you can assign tags to events and use them filter your events in the front end.

  • Categories - build your own hierarchy using native Joomla categories

  • Responsive & Adaptive - resizes automatically to the available space and uses the optimal image size to reduce bandwith usage.

  • Browser Support: IE10, IE11, Chrome & Firefox latest versions

Layouts

List of Events

Layout options for lists of events

Event

Layout options for events

Things you should know

There are several very important things you should understand before you use Event Gallery.

Google Photos, Flickr, Thumbs & Cache

Google Photos & Flickr

If you create an event where the images are located on the Google Photos/Flickr server this event is called a remote event. If information about this event have to be displayed Event Gallery will make a request to the Google Photos/Flickr Servers to get a list of available images. The result of this request is cached for 24 hours in order to achieve a good performance. But this also means that changes you do at the Google Photos/Flickr side are not reflected on your Joomla site until the next request. You can clear the server cache to make Event Gallery reloads the Google Photos/Flickr album.

Local

If you upload your images to your server directly you use a local event. For every file you upload a new entry in the database is created. If you use the internal upload tool everything is fine. If you upload images another way you need to synchronize the database using the "Sync Database" button Event Gallery provides. That's also the case if you do any other modification directly in the file system.

Once those information are available in the database you can display the images in the front end. Since you just need to upload the large images Event Gallery will take care of creating all the different thumbnails. For performance reasons those thumbnails are cached. If you change an image, add watermarks or things like this you need to invalidate the cache. This will delete all the cached thumbnails and the server will recreate them if necessary. Don't forget to clear the browser cache as well to see changes. Even if the images are cached very well, each request is a PHP request. Make sure your server can handle this. But don't worry too much. For most of them this is no issue.

Caching

To improve performance the Joomla cache is supported. The events and the event view are cacheable. Please keep in mind that you need to use progressive caching if you want to use user groups to restrict access to your events. Password protected events can be cached conventionally. Please do not use the Joomla! cache plugin if you want to use the checkout. This plugin caches pages based on their URL only which is not a good idea if the view if based on session data like a cart.

Modules are cachable too. The are cached globally for the site.

Event Gallery & JavaScript

Event Gallery makes heavy use of JavaScript to calculate the right thumb sizes in order to load optimized images only. This means that JavaScript has to work on your site without any issues. The most common issues are causes by templates, plugins or modules which do not care enough about the way Joomla works. Right now Joomla provides the MooTools JavaScript library. So if jQuery is used on the page make sure it does not interfere with MooTools. Please check the FAQ section for details. Starting with Event Gallery 3.3 MooTools is not longer necessary. But still you should care about all the different jQuery implementations your site loads. Event Gallery will use the build in jQuery library of Joomla 3.

Amazon S3

If Google Photos and Flickr are too unreliable but you don't have much space/traffic on your webserver you can move your images to Amazon S3. Amazon S3 is a simple storage provider. You can upload your original files and let Event Gallery create the necessary thumbnails. Just keep in mind that you pay for both the amount of space and the bandwidth you use. The amount of space you need for the generated thumbnails is relatively high. Currently Event Gallery uses 13 different sizes from 48px to 1440px. While those thumbnails get generated dynamically if images are stored locally, they need to exist if you're using Amazon S3. Please read more in the Amazon S3 section of the manual.

Requirements

  • Images! Large Images. At least as wide as the space where you want to show them. Bigger is better :) But watch the memory limit of your server.

  • Your images need to have an extension like JPG or jpg. png and gif will do too.

  • Latest Joomla Version

  • PHP 7.0 or later

  • Server upload limit > 3.5MB

  • MySQL

  • GD library for PHP

  • fileinfo for PHP

  • Set the PHP memory limit high enough (128MB is recommended)

  • Your template should not produce any JavaScript errors before you install the component

  • If you use Flickr, your images need to be uploaded after 2012 to provide the necessary thumbnail sizes.

Install and Update

Install

[Warning]Warning
Do never install an older version than the current one you're using! This will cause multiple issues and might prevent that you can install the latest version again or even render your site useless. I recommend to use a tool like Akeeba Backup for Joomla to create a backup of your site before updating anything including this package.

The installation of the component is quite easy:

  1. Make sure your server meets the necessary requirements.

  2. Download the component zip file

  3. Open your Joomla Back End and log in

  4. Open the Extension Manager and install the component by selecting the downloaded zip file in the file dialog

Update

If you want to update from Event Gallery to Event Gallery Extended you can follow the same process as with a normal update.

  1. Make sure your server meets the necessary requirements.

  2. Download the component zip file

  3. Open your Joomla Back End and log in

  4. Open the Extension Manager and install the component by selecting the downloaded zip file in the file dialog

Yes, those are the same steps as for the installation process. Usually it is not necessary to uninstall the component for an update.

[Warning]Warning
If you uninstall the component you'll loose your configuration and data.

[Note]Note
Make sure you uninstall the whole PACKAGE. If you uninstall the component only you can't reinstall. Just uninstall the package and it'll work again.

Possible Issues

Since the install package is pretty large you might encounter problems during the upload. In this case you can use one of the two other options the Joomla Extension Manager provides:

  • Upload the package to your server using FTP and install from directory.

  • Install using a link. Instead of downloading the package you can copy the link. Use this link to install Event Gallery.

If you see some warnings during the update process don't worry. Just install the package again and it'll work.

Alle Preise inkl. Mwst. , zzgl. Versand