Works with MODx Version(s): 0.9.2.1, 0.9.2
Submitted: Jun 28th 2006 | License: GPL - GNU Public | Downloads: 5928
This resource has been deprecated.

Description

Some included features:

• Included language files: English, Finnish, Deutch, Spanish, France, Italian, Dutch. Easy to make more, every output string extenalized to a language file.
• Possible to allow webusers/usergroups to manage their own or shared galleries
• Photo blogging (image commenting) with Replix, look for instructions at the extras
• Slidebox and Lightbox v2.0 enabled browsing and of embedded galleries (also option for popup and new window)
• Automatic watermarking of images (text or transparent PNG)
• Automatic imagemasking, you can use your own made grayscale masks
• Automatic dropshadow generation to images
• Possible to manage images on a separate document or call management of one gallery on another doc
• Possible to set a max images limit in a gallery
• Possible to keep original (or just bigger) images and link to them from browsing mode
• Possible to set quality percentage of each image size
• Possible to paginate gallery overviews to multiple pages
• Build liks to multiple galleries from tree hierarchy
• Support jpg/jpeg, png and gif images (gif's are converted to png). Also in zip-archives if ZZIPlib is installed.

Demos

There is some demos here (if the site is not offline). You can see the snippet calls at the bottom of the pages, what were used to create these galleries. I'm using this as a test site for myself, so if there is something weird going on when you visit there, I'm probably just testing something. ;)

ScottyDelicious has also put up a great demosite for MaxiGallery.
There is 4 sections at the site, you can see the snippet calls at the gallery pages:

• Default - basically nothing more than
• DropShadow - uses drop shadow on the images and thumbs.
• LightBox2 - uses the LightBox2 embedding feature.
• Popup/Watermark - js popup window reveals full size image with sD watermark

The TODO list for future versions

In progress:

• Templating features (by Marc)
• Code refactoring (by Marc)
• Fix issue with getAllSubDocuments function (info)
• Parameter to disable htmlentities conversion in certain fields.
• Update slidebox to newest version.
• Research if easy to implement image hiding while the page is loading if Lightbox v2 used, to prevent opening images in new windows. (done in newest slidebox)
• Use this "smart url function" for pagination url generation.
• Fix this problem. (can be fixed by not using any prefix at the first url parameter in makeUrl api call)
• Merge MaxiGallerySolo to the main snippet and enhance features:
  • Latest Additions feature, possible to set multiple galleries to get the latest image(s) from.
  • Random Images feature, possible to set multiple galleries to get the random image(s) from.
  • Gallery List feature, builds links to selected galleries and displays a random image of each gallery.
  • Parameter to the three above features where you can set also parentid's and the childgalleries will be processed.
• Research if the snippet can be used multiple times on a page and if not, make it possible.

Planned features:

• Start using phpThumb for image manipulating/creation
• Research possibility to use/modify iManager to add images to galleries
• Possibility to add allready uploaded images to galleries and reuse images without files duplicating (achieved with phpThumb)
• Possible to set all thumbnails to be cropped to a certain size squares, no matter what the original shape/size is.
• Possible to replace images at gallery management afterwards and change filter settings per image.
• Module to manage all site galleries easily from backend.
• Implement some ajax slideshow system

Credits:
You can view the extensive credit section at the top of the snippet! All authors, 3rd party classes/libraries and their licences are described there. This snippet is totally free for commercial use too.

Instructions

Installation is pretty straight forward:

• 1. Extract the contents of the zip file to your computer
• 2. FTP to your server an go to the modx installation folder
• 3. Copy all exept maxigallery.txt to assets/snippets/maxigallery/ -folder
• 4. Create a new folder assets/galleries/ and make it writable (CHMOD 0666 or 0777)
• 5. Close your FTP program and go to the MODx manager
• 6. Create a new snippet called "MaxiGallery" and paste the contents of maxigallery.txt to it
• 7. Call the snippet on some document, check the available parameters at the start of the snippet
  • There are some example snippet calls at the demo site
  • You have to call the snippet on an uncached page using "cached" snippet call i.e [[MaxiGallery]], because the automated javascript/css registration in MODx requires this for now. If you don't call it this way, sometimes when you view the lightbox enabled galleries, the images may just open in a new window instead of the lightbox.
• 8. Go to the page that has the snippet call and you should see "Manage pictures" -button in there (if you did not set it off in the snippet call ofcourse ;))
  • note that you must be logged into the manager and have rights to edit the document (unless you have defined webusers/groups who can manage the callery and you are logged in at front-end)
• 9. Upload some images to the gallery and see the results.

Extra info:

• You can create new language files for the gallery too. Create lang_en.php in the maxigallery folder and slidebox_lang_en.js in the slidebox folder, where "en" is the key for your lang file. After this, use it in the $language setting at the snippet.
• You can change the look of the lightbox by editing the maxigallery/slidebox/style.css -file. You can also change the overlay color of it and the loading images by creating new ones and defining them in your slidebox_lang_xx.js -file

IMPORTANT NOTE: It depends on your server settings that how many images you can upload at a time and how big. The image masking process for example is very slow and you might get a "Maximum execution time of NN seconds exceeded" -error message, if you are trying to upload many images at the same time with imagemasking on.. or if the images are large. Also when using big images, you may get "Memory Size Exhausted" -error as the image processing takes alot of memory too. These errors are not errors in the snippet code, they are caused by server settings. MaxiGallery script tries to use ini_set to increase the execution time and memory limit if needed, but it cannot do it if php is running in safe mode. (I have my setup on a safe_mode enabled server with 15seconds of execution time and 30sec max_input_time and 32Mb memory limit. It can handle 10 images at a time taken with 4MP camera, but with image masking on I can kill it pretty easily)

So, Check these values from php.ini:


max_execution_time, this is the maximum execution time allowed for each script, in seconds (it takes quite some time for maxigallery script to process the images if there are many of them and many imaging "filters" used).
max_input_time, this is the maximum time each script may spend parsing request data, in seconds.
memory_limit, this is the maximum amount of memory in megabytes that a script may consume (maxigallery keeps the images in memory while it makes thumbnails etc).
post_max_size this is the maximum size of POST data in megabytes that PHP will accept (the pictures travel in the post data).
upload_max_filesize this is the maximum allowed size for uploaded files in megabytes.

These settings can also be configured from Apache, so you might want to see if the following can be found from your httpd.conf:

php_admin_value upload_max_filesize Sets the corresponding php setting, see above.
php_admin_value post_max_size Sets the corresponding php setting, see above.
php_admin_value memory_limit Sets the corresponding php setting, see above.
LimitRequestBody Same as post_max_size php setting, but for apache.

Updates

-