|
@@ -0,0 +1,84 @@
|
|
|
+# Design Template
|
|
|
+
|
|
|
+A module for the admin panel implemented as a Django application.
|
|
|
+
|
|
|
+## Installation
|
|
|
+
|
|
|
+
|
|
|
+1) Download or clone repository
|
|
|
+
|
|
|
+```bash
|
|
|
+git clone https://git.sharix-app.org/ShariX_Open/sharix-open-webapp-design-template.git
|
|
|
+```
|
|
|
+
|
|
|
+2) Install required dependencies to the very top and create variable in project settings
|
|
|
+
|
|
|
+```python
|
|
|
+INSTALLED_APPS = [
|
|
|
+
|
|
|
+ 'design_template',
|
|
|
+ ...
|
|
|
+]
|
|
|
+
|
|
|
+NAME_SYSTEM = 'Sharix'
|
|
|
+```
|
|
|
+
|
|
|
+3) Connects application routes to the project
|
|
|
+
|
|
|
+```python
|
|
|
+ urlpatterns = (
|
|
|
+ [
|
|
|
+ ...
|
|
|
+ path('design/', include("design_template.urls"), name='design'),
|
|
|
+ ...
|
|
|
+ ] ...)
|
|
|
+```
|
|
|
+
|
|
|
+4) Delete the migration files in the **migrations** folder (everything except __init__.py)
|
|
|
+
|
|
|
+Start test the server:
|
|
|
+
|
|
|
+```bash
|
|
|
+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:
|
|
|
+
|
|
|
+```python
|
|
|
+# 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
|
|
|
+```
|