Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

unitegallery grid Plugin for django CMS

Project description

https://travis-ci.org/izimobil/djangocms-unitegallery.svg?branch=master https://img.shields.io/pypi/l/djangocms-unitegallery.svg https://img.shields.io/pypi/pyversions/djangocms-unitegallery.svg https://img.shields.io/badge/django-1.7%20or%20newer-green.svg https://img.shields.io/badge/djangocms-3%20or%20newer-green.svg https://img.shields.io/pypi/dm/djangocms-unitegallery.svg

A gallery plugin for django CMS that uses the excellent Unite Gallery jQuery plugin.

Installation

This plugin requires django CMS 3.0 or higher and sorl-thumbnail 12.0 or higher to work.

  • Run pip install djangocms-unitegallery
  • Add 'sorl.thumbnail' and 'djangocms_unitegallery' to your INSTALLED_APPS
  • Run python manage.py migrate

Note

It’s up to you to include jQuery js file in your templates, just make sure you include it before the sekizai {% render_block js %}.

Configuration

By default djangocms-unitegallery generates thumbnails for better perfomance. The default behavior is to generate thumbnails by resizing and cropping images in a square of 250x250 px.

You can disable completely the thumbnail generation and leave Unite Gallery handles images and preview, or you can change the default size of generated thumbnails and/or wether the image ratio should be preserved or not:

DJANGOCMS_UNITEGALLERY_CONFIG = {
    'THUMBNAIL_ENABLED': true,
    'THUMBNAIL_MAX_WIDTH': 250,
    'THUMBNAIL_MAX_HEIGHT': 250,
    'THUMBNAIL_PRESERVE_RATIO': False,
}

If you set THUMBNAIL_PRESERVE_RATIO to False, thumbnails will be cropped to match the configured width and height. If you set THUMBNAIL_PRESERVE_RATIO to True, thumbnails will just be resized to match the configured max width (if image is landscape) or height (if image is portrait).

Note

Due to Unite Gallery behavior, and depending on configured options, you are not guaranteed to have the thumbnail size you configured in settings.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for djangocms-unitegallery, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size djangocms_unitegallery-0.1.0-py2.py3-none-any.whl (457.1 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size djangocms-unitegallery-0.1.0.tar.gz (412.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page