minishowcase version 0.9 beta
the super-easy gallery


Installing and usage
for version 0.9 beta


Requirements ^

This is what you need to run this software:


Server Check: If you don't know if you have PHP installed in your host, try the following:

Installing ^

Once you have checked that your server meets the prerequisites as listed above you are ready to begin the installation.

That should be all!

Tips & Tricks ^

Customisation ^

minishowcase is supplied with a generic set of default values that can be customised to work better within your own site. Most of the variables for the working of the gallery are contained in the /config/settings.php file. This means that you can change many of the features by editing just one file.

At this stage, customisation is still at a minimum level. Expect improved and more thorough customisation in the (near) future.

There are /*comments*/ throughout to assist with site redesigns.

Themes ^

Note: themes are now working again. Be aware that old themes are not compatible with the latest release of minishowcase Luckily, they're easily upgradeable. Just duplicate a new theme, copy the values of your old theme and add the missing ones accordingly. Please check afterwards since some values might have change their appearance.

Themes are preconfigured visual styles and they include overall color scheme and images. They're a good way to adapt (for now, colors and images) minishowcase to resemble more your website's appearance.

Themes are contained within the /themes/ folder. To make your own theme, just copy one of the provided ones, modify the images and the colors in the /themes/data.php file. Then rename the theme's folder (it acts as the theme's name)

Themes included in the minishowcase download:

Other themes available for download:

If you make a new theme, and want to share it with the rest of us, send a .zip compressed copy to and it may be showcased in the themes section. Please include all relevant information, including:

  1. Your name
  2. Name of the theme
  3. Your e-mail [optional]
  4. A site you want the theme to be linked to [optional]


Encoding issues (Characters looking strange or wrong)

If the gallery names are looking funny or weird, and/or some characters look erroneous, or the galleries just don't load at all and you're using non-ASCII characters in the gallery names:

Open /config/settings.php and set $settings['set_double_encoding'] to true (default is false, if yours is false, then set it to true).

Cached Thumbnails Automated Creation

Open the /galleries/index.php file and set $thumbnail_creation to true. Then go to http://your-gallery/galleries/?thumbnails and voilĂ ! you can create thumbnails for every gallery.

Thumbnails will be created with the size set in /config/settings.php under $settings['cached_thumbs_size']. Change this value if you want better (or less) quality/size images. Default is 128px as max size, so for square thumbs is 128x128px, and for real aspect ratio (no square) is 128px max for the larger side.

If you decide to change the way your images show (by changing $settings['square_thumbnails']) then you might have to rebuild the cached thumbs for them to keep the selected aspect ratio (square vs. real aspect ratio).

NOTE: In some cases, you might have to delete the thumbnails manually through FTP since the script might not be able to delete the thumbnails due to PHP strict file handling permissions.

Please remember to set $thumbnail_creation back to false in order to avoid other people recreating all your thumbnails!

Images not showing in IIS Windows server

Open the /config/settings.php file and change in line 243:

$settings['gallery_sorting'] = 4; //2 <-- CHANGE TO "4" $settings['thumbnail_sorting'] = 0; //6 <-- CHANGE TO "0"

This seems to be the solution if you're getting an error on line 822 as discussed in this thread

That should help and make thumbnails show. If that does not solve your problem, or if you want more information, read and post on this thread

Advanced settings

(Not supported AT ALL, use at your own risk)

On the first lines of the /libraries/ajax.init.js file, you'll find some advance settings:

If you need help and your issue is not described here, please post your issue in the community forums

Contact ^

Any doubt, information or request might be discussed in the community. I am oftentimes very busy, a freelancer that travels from time to time, and it may happen that I don't check the threads immediately, but do not doubt that your suggestions and requests will be taken into consideration and a prompt answer is likely to be delivered.

IMPORTANT: Please read this INSTRUCTIONS thoroughly before sending any complaint/bug/feature request. If you don't receive an answer to your post or email, chances are the answer has already been covered here and I just cannot be bothered to rewrite it.

Disclaimer ^

This program is freeware, you may use it at your own discretion, If you want, you can write to me and tell me where are you using it, just to check it out.

This program is in a very alpha version, I am only distributing it because it is such a simple gallery, it might be useful to others. The web is full of full-fledged, perfectly-functional php image galleries, this one is for those that want an extremely simple, easy yet powerful and configurable gallery. If you're learning php, this is a very nice place where to start. And, after all, it is offered at no cost.

Legal stuff ^

This software is provided 'As Is', and no implied warranties are to be considered in any way watsoever, not even the implied warranty of FITNESS OF MERCHANTABILITY OR FOR A PARTICULAR PURPOSE. It is free, you can do whatever you want with it, it is safe, it is just server scripting code, that should be enough. By downloading this software you are deemed to this agreement.


minishowcase | community |