Chapter 3. Usage

Overview

Configuration options

This page lists the components configuration options. The top tool bar provides the following options:

Options

Access the components options. See below for the available configuration option.

Sync Database

You can do the upload using FTP or the build in image uploader. Since this component uses the databases to store information about files it needs to be updated once you change something directly at file system level. You can add/remove files and folders. By hitting the sync button added folders and files get added to the database while removed files/folder get removed. Finally the database is in sync with the file system. If you try to upload using FTP put your images into a new folder below /images/eventgallery/.

Make sure your folder names do not include special characters like umlauts, dots or anything like this. Otherwise you will encounter sync issues.

The sync process will handle your Amazon S3 folders as well. Since the file sync is expensive the process is now split into two parts. the Sync Folders button will start the search for files which needs to be synced. While this is always true for local files, Amazon S3 files will only appear if their hash has changed or the local database does not know the hash yet. Hit the Sync Files button to start the file sync. This is necessary to update meta information about images in the database. This involves some EXIF data and most important the plain width and height of the image. If you're syncing S3 images please keep in mind that this process will temporarily download every file to read the necessary data from.

Sync Database

If you want to automate the sync process you can use the command line script cli/eventgallery-sync.php to do the sync job. You can use this script as part of a CRON job. This is useful if you just want to add images on a daily basis or you have an ongoing event. Make sure the uploads and the sync job don't collide.

Amazon S3 Thumbnails

In the top toolbar you'll find a new button Amazon S3 Thumbnail Creator. Use this button to create your thumbnails if you store your images in an Amazon S3 bucket. To create thumbnails you need select the folder you want to scan and click the Find missing thumbnails button. It will try to find missing thumbnails based on two criteria: do the thumbnails exist at all and is the thumbnail already known in the database. If the checkbox Refresh thumbnail hashes is checked and the thumbnail exists in the S3 bucket, its hash gets written into the database. This is very useful if you run two servers with one set of S3 buckets and avoids to calculate the thumbnails twice. If missing thumbnails are found they'll be shown and you can click the Create Thumbnails button to generate them. This will take a long time! The upload to S3 is kind of slow. You can open the JavaScript console of you browser to see detailed information. In case of errors please let the current process finish and click the Find missing thumbnails button and repeat the process. Since an image might take about 25-35s please make sure your servers max execution time is set to an higher value than 30s!

[Note]Note
On my server it took about 5-6 hours to create thumbnails for 2000 images. The sync process runs in the browser with four parallel workers. The CLI script uses just one.

You can speed up the process by using an external resize service. On Github (https://github.com/svenbluege/eventgallery-lambda) you can find an Amazon Lambda function which can be used with Event Gallery. Once you published this function using the Amazon API Gateway you can enter the API URL in the components options.

Amazon S3 Thumbnail Creator

Clear Cache

The component caches all calculated images, the result of requests to Flickr and Google Photos and some more stuff. If you feel you have to clear this cache just hit this button. Keep in mind that refreshing the cache might be expensive. Please note that just because you remove all the cached images your browser might still load images from the local browser cache. Don't forget to clear that too. If you remove cached responses for Google Photos and Flickr requests the next request on your site will load the latest data from those remote services. Use this if you change something directly in a Google Photos/Flickr album.

[Note]Note
You can manually clear the Event Gallery cache be deleting all eventgallery-* folders in the Joomla! cache folder /cache

Clear Cache options

Google Photos Import

In order to import all public albums from a Google Photos account you can use this import. The component will load all albums and adds them to the list of events. Please note that this is just a one way import. Once you remove an album from Google Photos, you need to remove it from the list of events as well. The import will only add elements.

Export / Import

Sometimes you want to save your database content and import it again. The export/import dialog allows you exactly this. The export will create a zip file which contains the content of all Event Gallery related tables. You can use this zip file to do an import again. To check a zip file you can run the import as a dry run. The result is a short overview of what will be changed if you run an import with the selected file.

Of course you can create your own zip file which custom import files. The zip file can contain one or multiple files. The format is simple JSON. There can be exactly one file per table in each zip file.

The import does NOT care about categories. Once you imported events into a system where the referenced categories do not exist you need to reassign those events to existing categories.

Export files are not meant to be cross version compatible.

The Import only adds and updates data.

Alle Preise inkl. Mwst. , zzgl. Versand