Piwigo RANDOM

Piwigo-random is a simple solution to incorporate random images from a Piwigo galery in any website.

It uses Piwigo's remote API, so it does not need anything installed on the Piwigo server. It consists in 2 parts:

• A small PHP script, piwigo-random-backend.php that should be placed on any webserver able to execute PHP.

• An HTML snippet, to be inserted in any webpage where you wish to include images.

Technically, the HTML snippet loads piwigo-random-backend.php as JavaScript code, which generates the images element.

How to use it

• Download piwigo-random-backend.php and put it on a webserver able to execute PHP. Edit the file and change $site to your piwigo URL.

• On the site where you want to incorporate images, add the following code snippet (change the src= field to point to your own piwigo-random-backend.php):

<span id="random_image">
  <script type="text/javascript"
	  src="//www-verimag.imag.fr/~moy/piwigo-random-backend.php"
	  async>
  </script>
</span>

• Optionally: send me an email, I'd like to know if anyone uses my code :-).

The script will look for an HTML element with id="random_image", and add the images to this element. Note the async attribute to allow asynchronous loading of the script: if your piwigo gallery is slow or even down, it won't slow down your website.

Alternate method, without JavaScript

The previous method has several advantages:

• It allows asynchronous load, i.e. it won't slow down your site even if the piwigo gallery experiences troubles.

• It works regardless of the technology your website uses, even in plain static HTML.

still, it won't work if the client disabled JavaScript. An alternate method is to include the HTML elements for the random image server-side. This can be done by passing mode=html to piwigo-random-backend.php. For example, in PHP (replace with your URL of course):

<p>This
  <?php $base_url = "http://www-verimag.imag.fr/~moy/piwigo-random/piwigo-random-backend.php";
	     echo file_get_contents($base_url . "?mode=html&cat_id=13"); ?>
is a random image</p>

More information

See the demo for examples of more advanced uses:

• HTML source
• Browsable demo

Don't hesitate to read the source code of piwigo-random-backend.php, it's actually a very small piece of code!

Alternatives

• PiwigoPress: Same idea, with more features but limited to wordpress.