mirror of
https://github.com/jazzband/django-categories.git
synced 2026-03-16 22:30:24 +00:00
70 lines
No EOL
2 KiB
ReStructuredText
70 lines
No EOL
2 KiB
ReStructuredText
.. _reference_settings:
|
|
|
|
========
|
|
Settings
|
|
========
|
|
|
|
The ``CATEGORIES_SETTINGS`` dictionary is where you can override the default settings. You don't have to include all the settings; only the ones which you want to override.
|
|
|
|
The default settings are:
|
|
|
|
.. code-block:: python
|
|
|
|
CATEGORIES_SETTINGS = {
|
|
'ALLOW_SLUG_CHANGE': False,
|
|
'CACHE_VIEW_LENGTH': 0,
|
|
'RELATION_MODELS': [],
|
|
'M2M_REGISTRY': {},
|
|
'FK_REGISTRY': {},
|
|
'THUMBNAIL_UPLOAD_PATH': 'uploads/categories/thumbnails',
|
|
'THUMBNAIL_STORAGE': settings.DEFAULT_FILE_STORAGE,
|
|
}
|
|
|
|
ALLOW_SLUG_CHANGE
|
|
=================
|
|
|
|
**Default:** ``False``
|
|
|
|
**Description:** Changing the slug for a category can have serious consequences if it is used as part of a URL. Setting this to ``True`` will allow users to change the slug of a category.
|
|
|
|
CACHE_VIEW_LENGTH
|
|
=================
|
|
|
|
**Default:** ``0``
|
|
|
|
**Description:** This setting will be deprecated soon, but in the mean time, it allows you to specify the amount of time each view result is cached.
|
|
|
|
RELATION_MODELS
|
|
===============
|
|
|
|
**Default:** ``[]``
|
|
|
|
**Description:** Relation models is a set of models that a user can associate with this category. You specify models using ``'app_name.modelname'`` syntax.
|
|
|
|
M2M_REGISTRY
|
|
============
|
|
|
|
**Default:** {}
|
|
|
|
**Description:** A dictionary where the keys are in ``'app_name.model_name'`` syntax, and the values are a string, dict, or tuple of dicts. See :ref:`registering_models`\ .
|
|
|
|
FK_REGISTRY
|
|
============
|
|
|
|
**Default:** {}
|
|
|
|
**Description:** A dictionary where the keys are in ``'app_name.model_name'`` syntax, and the values are a string, dict, or tuple of dicts. See :ref:`registering_models`\ .
|
|
|
|
THUMBNAIL_UPLOAD_PATH
|
|
=====================
|
|
|
|
**Default:** ``'uploads/categories/thumbnails'``
|
|
|
|
**Description:** Where thumbnails for the categories will be saved.
|
|
|
|
THUMBNAIL_STORAGE
|
|
=================
|
|
|
|
**Default:** ``settings.DEFAULT_FILE_STORAGE``
|
|
|
|
**Description:** How to store the thumbnails. Allows for external storage engines like S3. |