HTML; } /** * Function to fill array with all pictures and remove unwanted names */ function getImagesFromDir($path, $exclude) { $images = array(); if ( $img_dir = @opendir($path) ) { while ( false !== ($img_file = readdir($img_dir)) ) { // checks for gif, jpg, png if ( preg_match("/(\.gif|\.jpg|\.png)$/", $img_file) ) { $images[] = $img_file; } } closedir($img_dir); } $images = array_filter($images, function ($item) use ($exclude) { return strpos($item, "$exclude") !== 0; }); return $images; } /** * Function to randomly pick 1 image from array */ function getRandomFromArray($ar) { mt_srand( (double)microtime() * 1000000 ); // php 4.2+ not needed $num = array_rand($ar); return $ar[$num]; } /** * Help text */ function smarty_cms_help_function_random_image() { ?>

What does this do?

This plugin displays a random image from a directory on a page where you use the {random_image} tag.

Dependencies

CMS Made Simple release 1.11
At least that is what I am using, although it should work with older versions

How do I use it?

You could insert it into your template or page like this:

{random_image image_path="uploads/images/Gallery/somegallery/" exclude="thumb" image_height="400" image_width="300"}

What parameters does it take?

image_path="" (Required)

Path to the directory containing the pictures you want to possibly show. This is relative to your cmsms install.

image_height="" (Optional)

image_width="" (Optional)

exclude="" (Optional)

Give (a part of) a file name you do not want to include in the possible image being displayed.

Other things

The image returned is displayed in a div class="display_image". You can style this if needed in your stylesheet.

Plugin author: King

>Big thanks to Rolf Tjassens (http://www.rolftjassens.com) for his many examples and howtos

Also thanks to the author of the php randomize function example found here : http://www.dyn-web.com/code/basics/random_image/random_img_php.php

Version: 1.1

Change History:

04-07-2013 - King - Added functions and styling (v1.1)

Added functions for path, width, height and exclude
Added additional scripting to exclude pre-defined image names. For me because the gallery module I use creates thumbnales, where the name starts with "thumb", which I want to avoid.
Added div to contain image so styling is possible in stylesheet
Updated help and about functions

02-07-2013 - King - Initial release (v1.0)

Initial release