Skip to content

A simple django app to load random images from a directory

Notifications You must be signed in to change notification settings

toshism/django-random-image

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 

Repository files navigation

Django Random Image

Django Random Image is a simple app to load a random image from a specified directory.

It's trivially simple but I've needed it a few times so I thought maybe others have too.

Installation

Add 'random_image' to INSTALLED_APPS.

Settings

All settings are optional

RANDOM_IMAGE_DIR

Default: Not defined

A path to the directory from which to load the random images. Relative to MEDIA_ROOT.

Note: Passing a path to the template tag will always override the RANDOM_IMAGE_DIR setting.

RANDOM_IMAGE_EXTENSIONS

Default: ['.jpg','.jpeg','.png','.gif']

A list containing extensions to be considered when choosing a random image.

Usage

Pass in a path to the image directory:

{% load random_image %}
<img src="{{ MEDIA_URL}}{% random_image "path/to/image/dir" %}">

The path to the image directory should be relative to MEDIA_ROOT.

or if you have added RANDOM_IMAGE_DIR to your settings file:

{% load random_image  %}
<img src="{{ MEDIA_URL }}{% random_image %}">

That's it! Simple as it gets.

About

A simple django app to load random images from a directory

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages