The settings must be stored in your Django project's settings
module, as a dictionary name ACTRACK
. This dictionary may contain the following items:
- USER_MODEL
The user model that should be used for the owners of the tracker instances. Defaults to Django's
AUTH_USER_MODEL
- ACTIONS_ATTR
The name of the accessor for actions, that can be changed in case it clashes with one of your models' fields. Defaults to
'actions'
- TRACKERS_ATTR
The name of the accessor for trackers, that can be changed in case it clashes with one of your models' fields. Defaults to
'trackers'
- DEFAULT_HANDLER
The path to the default action handler class (used when a matching action handler is not found). Defaults to
'actrack.ActionHandler'
- TRACK_UNREAD
Should unread actions be tracked? Defaults to
True
.- AUTO_READ
Should actions be automatically marked as read when rendered? Defaults to
True
.- GROUPING_DELAY
The time in seconds after which an action cannot be merged with a more recent one. When set to
-1
, grouping is disabled. When set to0
, grouping occurs only on unsaved actions. Defaults to0
- PK_MAXLENGTH
The maximum length of the primary keys of the objects that will be linked to action (as targets or related). Defaults to
16
.- LEVELS
A dictionary of logging levels. Defaults to:
{ 'NULL': 0, 'DEBUG': 10, 'HIDDEN': 20, 'INFO': 30, 'WARNING': 40, 'ERROR': 50, }
Note
The logging levels should have upper case names and their values must be small positive integers from 0 to 32767
The defined logging levels can, after initialization, be accessed under the actrack.level
module. E.g. actrack.level.INFO
.
- DEFAULT_LEVEL
The default level to use for logging. Defaults to
LEVELS['INFO']
- READABLE_LEVEL
Below that logging level (strictly), an action cannot appear as unread and cannot be marked as read. Defaults to
LEVELS['INFO']