Personal tools

Gallery3:Modules:randimg

From Gallery Codex

Contents

External Image Block

Display a random image on a external page

Description

This tiny module just provides a small interface to be able to fetch a small block of HTML containing a random image. This forum thread may have more information: http://galleryproject.org/node/93574. Thanks to user
danneh3826 on the Gallery 3 forum thread for this module for many enhancements and improvements to code and HTML.

The downloaded file will be a tar-gzipped archive named something similar to randimg-HEAD-873eec3.tar.gz. When you extract it, the resulting directory will also be named like randimg-HEAD-873eec3. It probably makes sense to rename that to simply randimg. Drop that directory into the modules/ subdirectory of your Gallery3 installation, then activate the module: Login -> Admin -> Modules. Check the box next to the module. Click update at the bottom of the page.

To see an example of this module in action visit the following URL. Each time you reload the page a new image should appear:

Usage

You can use any language you want on the external site to fetch the contents of the URL and insert it into your page (e.g. Javascript, Python, PHP, a shell script, etc.). If you are using PHP, then something like the following works fine:

maxsize: if this parameter is set, then both width and height are ignored. You may have a mixture of portrait and landscape images in your gallery, and this setting will apply to the longest dimension. That is, if the image is portrait then this parameter will apply to the height, and for landscape images it will apply to the width. In other words, the longest dimension will not exceed this value.