Settings

Sample settings can be found in configs/app.conf.sample.py. There is not only viewer settings but django framework too.

Viewer configuration

VIEWER_CACHE_PATH

Required

Path where cache will be stored. Check that this folder can be seen from nginx. Path split for 2 sub folders: reised images and links and zip archives. Under this folders each user have his own sub folder. About cache clearing read Application cache.

VIEWER_STORAGE_PATH

Required

Start path where full images are located. Each user can have his own home, in profile.storage.

VIEWER_IMAGE_SIZE

Default:

{
    'tiny': {
        'WIDTH': 150,
        'HEIGHT': 150,
        'CROP': True,
        'QUALITY': 85,
    },
    'small': {
        'WIDTH': 300,
        'HEIGHT': 300,
        'CROP': True,
    },
    'big': {
        'WIDTH': 1920,
        'HEIGHT': 1080,
    },
    'full': {
        'WIDTH': 10 ** 6,
        'HEIGHT': 10 ** 6,
    },
}
Sizes to resize images. Is it a map of maps. Example - 'small': {'WIDTH': 300, 'HEIGHT': 300, 'CROP': True, 'QUALITY': 95,}. By default crop is False, on True edges cut off, quality equal 95%. If image smaller than size it will be linked.
Tiny size used in admin to minimize cache size. Small size used in image thumbnails. Big size used for js album. Full size used to download real image.

VIEWER_DOWNLOAD_RESPONSE

Default:

{
    'BACKEND': 'bviewer.core.files.response.nginx',
    'INTERNAL_URL': '/protected',
    'CACHE': False,
}
X-Accel-Redirect for web server to improve file serving, highly recommended! Have two values bviewer.core.files.response.nginx and bviewer.core.files.response.django. Set cache true to activate redirect response caching, it save 2 queries per image. Be careful, cache can’t work with django! because it return hole file.

EXTRA_HTML

Default: empty string

A string that fit before the closing body tag. For example some analytics HTML/JS code.

Django configuration

ALLOWED_HOSTS

Default: []

A list of domains for working app. For example dev.com. It is a security measure. More details look here.