Magnolia - The Bread and Butter PHP Gallery

Current Version: 1.00 beta, Release Date: 12th November 2007

INTRODUCTION

Magnolia is yet another PHP gallery. Designed with the white-label developer in mind, it requires no database and focuses on simplicity, a tiny footprint (as small as 300 KB) and speed.

FEATURES

• No database
• Automatic thumbnail creation
• Caption support
• Multi-language support
• Slideshow mode
• Fully configurable
• W3C Valid HTML
• Custom META tags
• Creation of new language strings
• Multiple/bulk upload
• Supports MP3 and FLV files
• Multi-user administration with .htaccess authorisation

REQUIREMENTS

• Unix/Linux
• PHP 4+
• Magic Quotes Off
• Javascript and Flash-enabled browser

INSTALLATION

1. Download Magnolia from http://www.flashwebservices.co.uk/source.
2. Extract the contents of the zip file.
3. Create a new folder on your server, e.g., http://www.yourdomain.com/gallery.
4. Upload everything to this new folder.

All done!

USAGE

Simply visit http://www.yourdomain.com/gallery, where 'gallery' is the name of the folder you created above.

IMPORTANT!!!

You MUST set up a user as soon as possible, otherwise ANYONE can access and change your gallery's configuration.

ADMINISTRATION

To administrate your gallery, visit http://www.yourdomain.com/gallery/admin, where 'gallery' is the name of the folder you created above.

Options:

• Create New Album - Creates a new album with your chosen name
• Modify Exisitng Album - Upload and delete files, add/edit captions, rename album and generate thumbnails
• Gallery Settings - Includes many options to edit the appearance and behaviour of your gallery
• User Management - Add, edit and delete users and passwords
• Language - Change language and add, edit or delete language strings

LANGUAGES

The current version includes English, French and German language libraries. You also have the option of adding new language strings and customising existing ones - thus changing the whole 'personality' of your gallery's terminology. You can also 'lock' these strings to prevent users meddling with the core language.

To create a new language, you must create the language file itself, named 'language.en.php' where 'en' is your language code. You must also edit the language arrays in the 'language.inc.php' and 'edit_language.php' files. Comments are included where deemed necessary.

EXTRA SYNTAX

You can open an instance of a Slimbox (lightbox) using the following syntax:

<a href="images/image-1.jpg" rel="lightbox" title="my caption">image #1</a>

To open a linked group of images:

<a href="images/image-1.jpg" rel="lightbox[groupname]">image #1</a>
<a href="images/image-2.jpg" rel="lightbox[groupname]">image #2</a>
<a href="images/image-3.jpg" rel="lightbox[groupname]">image #3</a>

To open an HTML or plain text document:

<a href="mypage.html" rel="pagebox" title="my caption">My Page</a>

...and linked:

<a href="mypage_1.html" rel="pagebox[groupname]" title="my caption">My Page 1</a>
<a href="mypage_2.html" rel="pagebox[groupname]" title="my caption">My Page 2</a>
<a href="mypage_3.html" rel="pagebox[groupname]" title="my caption">My Page 3</a>

To open a pagebox window of a certain size, use the following syntax:

<a href="mypage_1.html" rel="pagebox" rel="width=345, height=135" title="my caption">My Page 1</a>

The MP3 and video features work using the above method.

More information on Slimbox can be found here: http://www.digitalia.be/software/slimbox

BUGS

There are probably a few. Please report them by emailing me on tech [at] flashwebservices [dot] co [dot] uk, including as many details as possible.

Cheers.

COPYRIGHT

Feel free to change the visible copyright, but please leave any comments and internal copyright notices intact. This benefits other authors when developing any 3rd party code. The MIT License applies for all components unless otherwise stated.

The MIT License

Copyright © 2007 Russell McVeigh

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.