Settings¶
FILER_ENABLE_PERMISSIONS
¶
Activate the or not the Permission check on the files and folders before
displaying them in the admin. When set to False
it gives all the authorization
to staff members based on standard Django model permissions.
Defaults to False
FILER_IS_PUBLIC_DEFAULT
¶
Should newly uploaded files have permission checking disabled (be public) by default.
Defaults to True
(new files have permission checking disable, are public)
FILER_STORAGES
¶
A dictionary to configure storage backends used for file storage.
e.g:
FILER_STORAGES = {
'public': {
'main': {
'ENGINE': 'filer.storage.PublicFileSystemStorage',
'OPTIONS': {
'location': '/path/to/media/filer',
'base_url': '/media/filer/',
},
'UPLOAD_TO': 'filer.utils.generate_filename.randomized',
'UPLOAD_TO_PREFIX': 'filer_public',
},
'thumbnails': {
'ENGINE': 'filer.storage.PublicFileSystemStorage',
'OPTIONS': {
'location': '/path/to/media/filer_thumbnails',
'base_url': '/media/filer_thumbnails/',
},
},
},
'private': {
'main': {
'ENGINE': 'filer.storage.PrivateFileSystemStorage',
'OPTIONS': {
'location': '/path/to/smedia/filer',
'base_url': '/smedia/filer/',
},
'UPLOAD_TO': 'filer.utils.generate_filename.randomized',
'UPLOAD_TO_PREFIX': 'filer_public',
},
'thumbnails': {
'ENGINE': 'filer.storage.PrivateFileSystemStorage',
'OPTIONS': {
'location': '/path/to/smedia/filer_thumbnails',
'base_url': '/smedia/filer_thumbnails/',
},
},
},
}
Defaults to FileSystemStorage in <MEDIA_ROOT>/filer_public/
and <MEDIA_ROOT>/filer_public_thumbnails/
for public files and
<MEDIA_ROOT>/../smedia/filer_private/
and <MEDIA_ROOT>/../smedia/filer_private_thumbnails/
for private files.
Public storage uses DEFAULT_FILE_STORAGE
as default storage backend.
UPLOAD_TO
is the function to generate the path relative to the storage root. The
default generates a random path like 1d/a5/1da50fee-5003-46a1-a191-b547125053a8/filename.jpg
. This
will be applied whenever a file is uploaded or moved between public (without permission checks) and
private (with permission checks) storages. Defaults to 'filer.utils.generate_filename.randomized'
.
FILER_SERVERS
¶
Warning
Server Backends are experimental and the API may change at any time.
A dictionary to configure server backends to serve files with permissions.
e.g:
DEFAULT_FILER_SERVERS = {
'private': {
'main': {
'ENGINE': 'filer.server.backends.default.DefaultServer',
},
'thumbnails': {
'ENGINE': 'filer.server.backends.default.DefaultServer',
}
}
}
Defaults to using the DefaultServer (doh)! This will serve the files with the django app.
FILER_PAGINATE_BY
¶
The number of items (Folders, Files) that should be displayed per page in admin.
Defaults to 20
FILER_SUBJECT_LOCATION_IMAGE_DEBUG
¶
Draws a red circle around to point in the image that was used to do the subject location aware image cropping.
Defaults to False
FILER_ALLOW_REGULAR_USERS_TO_ADD_ROOT_FOLDERS
¶
Regular users are not allowed to create new folders at the root level, only
subfolders of already existing folders, unless this setting is set to True
.
Defaults to False
FILER_IMAGE_MODEL
¶
Defines the dotted path to a custom Image model; please include the model name. Example: ‘my.app.models.CustomImage’
Defaults to False
FILER_CANONICAL_URL
¶
Defines the path element common to all canonical file URLs.
Defaults to 'canonical/'
FILER_UPLOADER_CONNECTIONS
¶
Number of simultaneous AJAX uploads. Defaults to 3.
If your database backend is SQLite it would be set to 1 by default. This allows
to avoid database is locked
errors on SQLite during multiple simultaneous
file uploads.