Admin Control Panel
All the main functions of control such as connecting to a Flickr account and storing information on the photo thumbnails, can be achieved through the “Flickr Control” GUI in the WordPress admin panel.
Any changes in current Flickr photo information/status can be immediately updated by clicking on the “Update Photos” button.
Users can choose to randomise the display of photos.
Running the relevant Flickr API function calls can sometimes take between 2 & 3 minutes to fully execute. All information is stored in a cache data held locally, so that it minimises the chance of performance loss on web pages.
The cache data is stored in the WordPress database and can store up to 500 images at a time. See below for further details.
If users wish to have regular/automatic updates of their photo information and status, then that is achievable through creating a crontab entry, or similar automation mechanism, to execute the supplied “runScript.php” file.
Specific styling using CSS
A CSS file is supplied to provide a starting point for displaying the thumbnails, but changes can be made to suit individual preference.
If you are upgrading from version 1.0 or 1.0.1 to version 1.1 then you will need to de-activate and re-activate the plugin. This is to ensure that some of the new features will be fully initialised.
All files, both PHP and CSS, can be found within the main extracted plugin folder.
Within the folder “flickr-thumbnails-photostream” you should find the following 7 files:-
- flickrScript.php – the file that will interface with the Flickr API (required)
- flickrPlugin.php – the display file that WordPress will interface with (required)
- flickrInclude.php – used for commonly used PHP variables and functions (required)
- runScript.php – used for cron or other photo data update automation control (optional usage)
- style.css – used for styling the presentation of the thumbnails (required, but can be modified)
- readme.txt – this information file
- COPYING – a copy of the license terms for this release
XSS Security Function
If Flickr change their URL content and/or structure you may see this error on your site “One or more photos have been disabled for XSS security reasons”. If this happens then please de-activate the XSS security function by unticking the checkbox in the admin panel. The issue should then be fixed in the next release of the plugin. Please do NOT disable this function unless you experience this error message.
For further support or information please visit: http://community.plus.net/opensource/
- How does the plugin connect to Flickr?
It uses the PHP cURL library to connect to Flickr’s API.
- Can the supplied plugin be re-styled?
Yes, as mentioned previously, a CSS style sheet is provided to give a basic layout for the plugin. Please feel free to modify this to your heart’s content to get the presentation you are after. However, this may require you to have some prior knowledge of HTML and CSS.
- Is it possible to automate the photo updates?
Yes, we have provided a PHP file called “runScript.php” that is the file that should be run if you want to run an automated/scheduled update of your photo info. Essentially it performs the same task as clicking the “Update Photos” button but automatically.
- Will I experience any permission issues with the data cache storage/usage?
No, the plugin has been re-designed to automatically save the data cache to the WordPress database, this should prevent any file/folder permission issues.
- Can I choose not to use the randomise image feature?
Yes, there is an option in the admin panel to disable this feature. If it is disabled the latest images will be used instead.