mirror of
https://github.com/django-helpdesk/django-helpdesk.git
synced 2024-12-14 02:41:26 +01:00
153 lines
6.4 KiB
Python
153 lines
6.4 KiB
Python
"""
|
|
Default settings for django-helpdesk.
|
|
|
|
"""
|
|
import warnings
|
|
from django.conf import settings
|
|
from django.core.exceptions import ImproperlyConfigured
|
|
|
|
|
|
try:
|
|
DEFAULT_USER_SETTINGS = settings.HELPDESK_DEFAULT_SETTINGS
|
|
except AttributeError:
|
|
DEFAULT_USER_SETTINGS = None
|
|
|
|
if not isinstance(DEFAULT_USER_SETTINGS, dict):
|
|
DEFAULT_USER_SETTINGS = {
|
|
'use_email_as_submitter': True,
|
|
'email_on_ticket_assign': True,
|
|
'email_on_ticket_change': True,
|
|
'login_view_ticketlist': True,
|
|
'tickets_per_page': 25
|
|
}
|
|
|
|
|
|
HAS_TAG_SUPPORT = False
|
|
|
|
##########################################
|
|
# generic options - visible on all pages #
|
|
##########################################
|
|
|
|
# redirect to login page instead of the default homepage when users visits "/"?
|
|
HELPDESK_REDIRECT_TO_LOGIN_BY_DEFAULT = getattr(settings,
|
|
'HELPDESK_REDIRECT_TO_LOGIN_BY_DEFAULT',
|
|
False)
|
|
|
|
# raises a 404 to anon users. It's like it was invisible
|
|
HELPDESK_ANON_ACCESS_RAISES_404 = getattr(settings,
|
|
'HELPDESK_ANON_ACCESS_RAISES_404',
|
|
False)
|
|
|
|
# show knowledgebase links?
|
|
HELPDESK_KB_ENABLED = getattr(settings, 'HELPDESK_KB_ENABLED', True)
|
|
|
|
# show extended navigation by default, to all users, irrespective of staff status?
|
|
HELPDESK_NAVIGATION_ENABLED = getattr(settings, 'HELPDESK_NAVIGATION_ENABLED', False)
|
|
|
|
# use public CDNs to serve jquery and other javascript by default?
|
|
# otherwise, use built-in static copy
|
|
HELPDESK_USE_CDN = getattr(settings, 'HELPDESK_USE_CDN', False)
|
|
|
|
# show dropdown list of languages that ticket comments can be translated into?
|
|
HELPDESK_TRANSLATE_TICKET_COMMENTS = getattr(settings,
|
|
'HELPDESK_TRANSLATE_TICKET_COMMENTS',
|
|
False)
|
|
|
|
# list of languages to offer. if set to false,
|
|
# all default google translate languages will be shown.
|
|
HELPDESK_TRANSLATE_TICKET_COMMENTS_LANG = getattr(settings,
|
|
'HELPDESK_TRANSLATE_TICKET_COMMENTS_LANG',
|
|
["en", "de", "es", "fr", "it", "ru"])
|
|
|
|
# show link to 'change password' on 'User Settings' page?
|
|
HELPDESK_SHOW_CHANGE_PASSWORD = getattr(settings, 'HELPDESK_SHOW_CHANGE_PASSWORD', False)
|
|
|
|
# allow user to override default layout for 'followups' - work in progress.
|
|
HELPDESK_FOLLOWUP_MOD = getattr(settings, 'HELPDESK_FOLLOWUP_MOD', False)
|
|
|
|
# auto-subscribe user to ticket if (s)he responds to a ticket?
|
|
HELPDESK_AUTO_SUBSCRIBE_ON_TICKET_RESPONSE = getattr(settings,
|
|
'HELPDESK_AUTO_SUBSCRIBE_ON_TICKET_RESPONSE',
|
|
False)
|
|
|
|
|
|
############################
|
|
# options for public pages #
|
|
############################
|
|
|
|
# show 'view a ticket' section on public page?
|
|
HELPDESK_VIEW_A_TICKET_PUBLIC = getattr(settings, 'HELPDESK_VIEW_A_TICKET_PUBLIC', True)
|
|
|
|
# show 'submit a ticket' section on public page?
|
|
HELPDESK_SUBMIT_A_TICKET_PUBLIC = getattr(settings, 'HELPDESK_SUBMIT_A_TICKET_PUBLIC', True)
|
|
|
|
|
|
###################################
|
|
# options for update_ticket views #
|
|
###################################
|
|
|
|
''' options for update_ticket views '''
|
|
# allow non-staff users to interact with tickets?
|
|
# can be True/False or a callable accepting the active user and returning True if they must be considered helpdesk staff
|
|
HELPDESK_ALLOW_NON_STAFF_TICKET_UPDATE = getattr(settings, 'HELPDESK_ALLOW_NON_STAFF_TICKET_UPDATE', False)
|
|
if not (HELPDESK_ALLOW_NON_STAFF_TICKET_UPDATE in (True, False) or callable(HELPDESK_ALLOW_NON_STAFF_TICKET_UPDATE)):
|
|
warnings.warn("HELPDESK_ALLOW_NON_STAFF_TICKET_UPDATE should be set to either True/False or a callable.", RuntimeWarning)
|
|
|
|
# show edit buttons in ticket follow ups.
|
|
HELPDESK_SHOW_EDIT_BUTTON_FOLLOW_UP = getattr(settings,
|
|
'HELPDESK_SHOW_EDIT_BUTTON_FOLLOW_UP',
|
|
True)
|
|
|
|
# show delete buttons in ticket follow ups if user is 'superuser'
|
|
HELPDESK_SHOW_DELETE_BUTTON_SUPERUSER_FOLLOW_UP = getattr(
|
|
settings, 'HELPDESK_SHOW_DELETE_BUTTON_SUPERUSER_FOLLOW_UP', False)
|
|
|
|
# make all updates public by default? this will hide the 'is this update public' checkbox
|
|
HELPDESK_UPDATE_PUBLIC_DEFAULT = getattr(settings, 'HELPDESK_UPDATE_PUBLIC_DEFAULT', False)
|
|
|
|
# only show staff users in ticket owner drop-downs
|
|
HELPDESK_STAFF_ONLY_TICKET_OWNERS = getattr(settings, 'HELPDESK_STAFF_ONLY_TICKET_OWNERS', False)
|
|
|
|
# only show staff users in ticket cc drop-down
|
|
HELPDESK_STAFF_ONLY_TICKET_CC = getattr(settings, 'HELPDESK_STAFF_ONLY_TICKET_CC', False)
|
|
|
|
# allow the subject to have a configurable template.
|
|
HELPDESK_EMAIL_SUBJECT_TEMPLATE = getattr(
|
|
settings, 'HELPDESK_EMAIL_SUBJECT_TEMPLATE',
|
|
"{{ ticket.ticket }} {{ ticket.title|safe }} %(subject)s")
|
|
# since django-helpdesk may not work correctly without the ticket ID
|
|
# in the subject, let's do a check for it quick:
|
|
if HELPDESK_EMAIL_SUBJECT_TEMPLATE.find("ticket.ticket") < 0:
|
|
raise ImproperlyConfigured
|
|
|
|
# default fallback locale when queue locale not found
|
|
HELPDESK_EMAIL_FALLBACK_LOCALE = getattr(settings, 'HELPDESK_EMAIL_FALLBACK_LOCALE', 'en')
|
|
|
|
|
|
########################################
|
|
# options for staff.create_ticket view #
|
|
########################################
|
|
|
|
# hide the 'assigned to' / 'Case owner' field from the 'create_ticket' view?
|
|
HELPDESK_CREATE_TICKET_HIDE_ASSIGNED_TO = getattr(
|
|
settings, 'HELPDESK_CREATE_TICKET_HIDE_ASSIGNED_TO', False)
|
|
|
|
|
|
#################
|
|
# email options #
|
|
#################
|
|
|
|
# default Queue email submission settings
|
|
QUEUE_EMAIL_BOX_TYPE = getattr(settings, 'QUEUE_EMAIL_BOX_TYPE', None)
|
|
QUEUE_EMAIL_BOX_SSL = getattr(settings, 'QUEUE_EMAIL_BOX_SSL', None)
|
|
QUEUE_EMAIL_BOX_HOST = getattr(settings, 'QUEUE_EMAIL_BOX_HOST', None)
|
|
QUEUE_EMAIL_BOX_USER = getattr(settings, 'QUEUE_EMAIL_BOX_USER', None)
|
|
QUEUE_EMAIL_BOX_PASSWORD = getattr(settings, 'QUEUE_EMAIL_BOX_PASSWORD', None)
|
|
|
|
# only process emails with a valid tracking ID? (throws away all other mail)
|
|
QUEUE_EMAIL_BOX_UPDATE_ONLY = getattr(settings, 'QUEUE_EMAIL_BOX_UPDATE_ONLY', False)
|
|
|
|
# only allow users to access queues that they are members of?
|
|
HELPDESK_ENABLE_PER_QUEUE_STAFF_PERMISSION = getattr(
|
|
settings, 'HELPDESK_ENABLE_PER_QUEUE_STAFF_PERMISSION', False)
|