- Check the Requirements
- Follow the Installation instructions
- Go further with Tips & Tricks
- Learn about Customisation
- Check out the Themes
- Know how to Troubleshoot
- Have any questions? Discuss them
- Read the Disclaimer
IMPORTANT: Please read this Instructions and the Disclaimer before installing or sending any feedback, suggestion, complaint, bug or feature request.
This is what you need to run this software:
- PHP scripting language: your server must have at least php v4.2.0 (I’m not 100% sure) installed. if you are unsure see below
- GD/GD2 extension: either the GD or GD2 extension is required by PHP for manipulating images, hence you’ll need it if you want the gallery to generate its own thumbnails on-the-fly. GD/GD2 are image manipulation extensions, are usually bundled with PHP for linux/unix/(windows?) and may just need to be enabled (by your Host, probably). if you are unsure see below
- If you don’t have GD/GD2 installed, you can turn the
$create_thumbnailsvariable to false in the
/config/settings.phpfile. This way, the thumbnails will show as a scaled version of the main picture.
- An FTP account and client.
Server Check: If you don’t know if you have PHP installed in your host, try the following:
- Copy and paste the following into a text file:
<?php phpinfo(); ?>
- Save the file as
test.phpand upload it via ftp to your webspace.
Now fire up your favourite web browser and go to
http://yourdomain/path/to/file/test.php. Scrolling down you will find the current version of PHP and whether or not GD/GD2 is installed.
Once you have checked that your server meets the prerequisites as listed above you are ready to begin the installation.
- Open the file
/config/settings.phpin a text editor (not Word! Notepad/TextEdit will do, saving as plain text) and make the changes you wish. Save and close the file.
- Put all the images for a gallery inside a folder, name it as you want the gallery to be named, but without special characters (use underscores for spaces), and then put this folder inside the
/galleries/folder, then set its permissions to 0777.
- Upload the entire minishowcase folder to the location you have chosen in your webserver. Rename it if you want.
Note: be careful to upload images in data (binary) format, and text files in text (ascii) format.
Tips & Tricks:
Linking to galleries
If you want to have an internal link to a gallery, add this code to your link:
gallery_namewith the name of the gallery you want to load.
If you want to have your galleries to appear in a specific order in the menu, just prepend a number and a dash
NN-to the folder name in the order you want. These numbers won’t appear in the gallery title. In my opinion, a good practice is to append every gallery with the date formatted as
YYMMDD-if you want to order them by date. Note: this setting might not work in some OSes/Hosts. If this is your case, let me know in the community
If you want your images to appear in a specific order, prepend a number and a dash
NN-to the image name. If you set
falsethose numbers won’t show as part of the image caption.
Hide a gallery/image
If you want a gallery temporarily not to show in the menu, just prepend an underscore (
_) to the gallery folder name (eg.
/galleries/_yourgallery/). The same applies to images you want temporarily not to appear in a gallery.
Show a description of a gallery
If you want a description for the gallery, put it on a text file, name it
_info.txt(the default name) and save it inside the gallery images folder. Note: you can change this file’s default name in the
Show a caption of an image
If you want to show a description of the image, just name the image with the text you want to appear as a caption. Note: Underscores (
_) will be parsed and shown as spaces (
), and Dashes (
-) will be parsed and shown like this (
my_image-comment.jpgwill look like
my image - comment.
Change text in the gallery
If you want to change any text on the gallery, look for it in the language files, inside
Integrating your gallery with your site
If you want to add html code to let your gallery look like your site, you can add it in the Header/Footer files. Open the
/header.phpand add al the Header code (the code that goes on top of the gallery), and do the same with the
/footer.phpfor the Footer code (the code that goes below the gallery). Follow the instructions on the files for adding the code. Then add the CSS definitions for the Header/Footer html in the
/styles/includes.csscss file. Note: When adding css definitions to the
/styles/includes.css, be careful with the CSS id/class naming, as if some conflict with the minishowcase css definitions, your gallery’s look might suffer some problems.
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:
false, if yours is
false, then set it to
Cached Thumbnails Automated Creation
/galleries/index.phpfile and set
true. Then go to
http://your-gallery/galleries/?thumbnailsand voilá! you can create thumbnails for every gallery.
Thumbnails will be created with the size set in
$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
falsein 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
(Not supported AT ALL, use at your own risk)
On the first lines of the
/libraries/ajax.init.jsfile, you’ll find some advance settings:
If you don’t want to jump to the next gallery block when you are at the last image and click the arrow, set this to
// jump from last block image to next block first image var continuous_nav = true;
If you set to
trueall images will be load simultaneously. It’ll slightly accelerate thumbnail loading but it might crash or block the browser on galleries with many thumbnails.
// load thumbnails one by one var use_load_interval = true;
If you don’t want to show the AJAX loader bar, set this to
// show ajax loader var show_loading_bar = true;
trueif you want the minishowcase Preview pane to animate (fade in/out) when showing an image
// animate preview pane show/hide var animate_preview = false;
trueif you want to go right directly to the permalink URL when you click on the ‘permalink’ link (Does not work right, use at your own risk)
// clicking on permalink loads it directly var active_permalink = false;
This one is just for debugging purposes. Do not change it.
// resize the thumbnail container var set_thumbnail_container_height = false;
trueif you want visited galleries to change color
// set visited galleries to 'visited' color var show_visited_galleries = false;
If you need help and your issue is not described here, please post your issue in the community forums
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.
/*comments*/ throughout to assist with site redesigns.
Note: themes are now working again. Be aware that old themes are not completely compatible with the latest release of minishowcase Luckily, they’re easily upgradeable. Just duplicate a new theme, and copy the values of your old theme. Please check afterwards since some values might have change their appearance.
Themes are preconfigured visual styles, and they include overall color scheme and image framing. They’re a neat way to adapt (for now, colors and images) for minishowcase to resemble more your website 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:
- none yet
if you make a new theme, and want to share it with the rest of us, post a .zip compressed copy in the Community (under the category Themes and Templates), and it might be showcased in the themes section. please include all relevant information, including:
- Your name
- Name of the theme
- Your e-mail [optional]
- A site you want the theme to be linked to [optional]
Any doubt, information or request might be discussed in the forum. 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 Read Me 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.
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.
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. By downloading this software you are deemed to this agreement and bound by the commercial licence that accompanies it.