metaservice/tickets

ShariX Open Tickets

Ticketing system implemented as a Django application.

Installation

1) Download or clone repository

git clone -b tickets_module http://git.sharix-app.org/ShariX_Open/sharix-open-tickets.git tickets

2) Install required dependencies in project settings

INSTALLED_APPS = [
    ...
    'tickets.apps.ticketsConfig',
    'django.contrib.sites',
    ...
]

3) Delete the migration files in the migrations folder (everything except init.py)

4) Install required libraries (don't forget to install and activate virtual space)

pip install -r tickets/requirements.txt

Start test the server:

python manage.py runserver 8000

If the port has not been selected, it is 8000 by default. If selected port is busy, use another one (for example, try increasing port number by 1 until the server starts). A link to the website should appear in the terminal.

Settings

Optional configuration params, which can be added to your project settings:

# Restrict access to ALL tickets lists/views to `is_staff` users.
# If False or unset, all users can see all views (but more granular permissions are still enforced
# within views, such as requiring staff for adding and deleting lists).
TICKETS_STAFF_ONLY = True

# If you use the "public" ticket filing option, to whom should these tickets be assigned?
# Must be a valid username in your system. If unset, unassigned tickets go to "Anyone."
TICKETS_DEFAULT_ASSIGNEE = 'johndoe'

# If you use the "public" ticket filing option, to which list should these tickets be saved?
# Defaults to first list found, which is probably not what you want!
TICKETS_DEFAULT_LIST_SLUG = 'tickets'

# If you use the "public" ticket filing option, to which *named URL* should the user be
# redirected after submitting? (since they can't see the rest of the ticket system).
# Defaults to "/"
TICKETS_PUBLIC_SUBMIT_REDIRECT = 'dashboard'

# Enable or disable file attachments on Tasks
# Optionally limit list of allowed filetypes
TICKETS_ALLOW_FILE_ATTACHMENTS = True
TICKETS_ALLOWED_FILE_ATTACHMENTS = [".jpg", ".gif", ".csv", ".pdf", ".zip"]
TICKETS_MAXIMUM_ATTACHMENT_SIZE = 5000000  # In bytes

# Additional classes the comment body should hold.
# Adding "text-monospace" makes comment monospace
TICKETS_COMMENT_CLASSES = []

# The following two settings are relevant only if you want TICKETS to track a support mailbox -
# see Mail Tracking below.
TICKETS_MAIL_BACKENDS
TICKETS_MAIL_TRACKERS