{ "info": { "author": "H\u00e9ctor Alvarez (monobot)", "author_email": "monobot.soft@gmail.com", "bugtrack_url": null, "classifiers": [ "Environment :: Web Environment", "Framework :: Django", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2.7", "Topic :: Internet :: WWW/HTTP", "Topic :: Internet :: WWW/HTTP :: Dynamic Content" ], "description": "# simpletickets\n\nThis is a django plugin to manage ticketing between the users and the staff.\nIn a simple, easy and usefull way.\n\n# Installation and setup\nTo install just\n```bash\npip install simpletickets\n```\n##### Module Set Up\n\nAdd \"simpletickets\" to your installed apps:\n```python\nINSTALLED_APPS = (\n ...\n 'simpletickets',\n )\n```\n\nAdd simpletickets urls on one of your urls.py files:\n```python\nfrom simpletickets import urls as ticket_urls\n\nurlpatterns = patterns('',\n ...\n url(r'^tickets/', include(ticket_urls)),\n )\n```\n\nAfter the installation is completed and set up in your project, remember to migrate the database!\n\n```bash\npython manage.py migrate\n```\n\n---\n# Module Config\nSimpletickets runs out of the box, but you can fine tune it to satisfy your project exact needings.\n\nTo do do there are some variables that can be set up in your settings file/s:\n(The shown assigments are the default values)\n\n**ST_DELTA_CLOSE** is the timedelta between the moment the ticket is marked as solved by an staff member until it changes to closed without the owner reopening it.\n\nOnce the item is closed it can not be reopened again, the user has to create a new ticket for more support.\n\n```python\nST_DELTA_CLOSE = timedelta(hours=6)\n```\n\n**TICKET MONITOR**\nThe ticket monitor is a supervision feature, there you can see all and every change the model object has sufered since created until finaly been closed.\n\nThe next two variables config if you want the staff or the owner to be able to download this file for every ticket in their lists.\n\n```python\nST_FL_MNTR_STAFF = True\nST_FL_MNTR_OWNER = False\n```\n\n**GROUPS**\n*simpletickets* shows the list of tickets deppending on what group they belong,\nyou can configure those groups with this two variables:\n\n```python\nST_STAFF_GNAME = 'simpleticket_staff'\nST_ADMIN_GNAME = 'simpleticket_admin'\n```\nStaff is the regular ticket staff member and admin are (you guessed) administrators.\n\nYou can use this single time command to create the groups if you havent done that already.\n```bash\npython manage.py st_create_groups\n```\n\n##### MODEL\nThese are the configuration variables that modify the models in your system,\nUnderstand that ST_TCKT_TYPE, ST_TCKT_SEVERITY and ST_TCKT_STATE are modification of the database models and so in this case a migration will be needed!\n\n**ST_ATTACHMENTS** is the folder's name where the ticket's attachments will be uploaded to\n\n```python\nATTACHMENTS_DIR = 'tickets'\n```\n\nThe next 3 configuration variables are the most commonly changed in the module, i have left some digits in the tuples empty by purpose, maybe this setup can work for 80% of the sites out there, but im sure you can fill up the voids with you special needs, feel free to do that in those blank spaces.\n\nOf course you can override the whole thing with you special needs, in that case you will have to fix all the now broken logic passed to the templates and create the templates yourself.\n\nOk straigt to the variables.\n\n**ST_TCKT_TYPE** is the different kind of tickets, im sure it will vary a lot from site to site, feel free to configurate the spaces between the 1, 2 and 8, 9\n\n```python\nST_TCKT_TYPE = (\n (1, _(u'Inform about an error')),\n (2, _(u'Problem')),\n ..\n (8, _(u'Propose a sugestion')),\n (9, _(u'Others')),\n )\n```\n\n\n**ST_TCKT_SEVERITY** is as guessed the severity of the ticket from lowest priority to the higuest ones.\n\n```python\nST_TCKT_SEVERITY = (\n (1, _(u'Low')),\n (2, _(u'Normal')),\n ..\n (5, _(u'important')), # can be changed\n ..\n (8, _(u'very important')),\n (9, _(u'Critical')),\n )\n```\n\n**ST_TCKT_STATE**\n\nIn this case it is the different states the ticket can have:\nOnly the owner can create tickets, and will be marked as new (and red hued in the template).\nOnce a staff member opens the ticket its asigned (brown hued) to himself, now the staff can leave it as asigned to himself, scale asigning it to other staff member or go straight to solve the problem and marking it as in progress (blue hued).\n'in progress' is all the time between the staff member commences working on it untill its completly solved.\nOnce solved (greyed out) unless the owner reopens it, it will be finaly marked as closed until the ST_DELTA_CLOSE passes.\n\n```python\nST_TCKT_STATE = (\n (1, _(u'new')),\n (2, _(u'assigned')),\n ..\n (5, _(u'in progress')), # can be changed\n ..\n (8, _(u'solved')),\n (9, _(u'closed')),\n )\n```\n\n##### TEMPLATE\nCurrently simpletickets comes with a barebones version of twitter bootstrap, you can of course use your own templates, if so please ignore the next settings.\n\n**BASE_TEMPLATE** is the base template where the tickets will be shown\n\n```python\nBASE_TEMPLATE = 'index.html'\n```\nIn that template there __should be a template block named 'simpletickets'__ where you want the tickets to be shown.\n```html\n{% block simpletickets %}\n{% endblock simpletickets %}\n```\n\nThe next 5 variables config if you want the different boxes (main taskbar or the statistic) to be shown for staff and/or owner.\n\n```python\nST_MAIN_TASKBAR = True\n```\n\n```python\nST_SETT_TIMES_STAFF = True\nST_SETT_NUMBERS_STAFF = True\n```\n\n```python\nST_SETT_TIMES_OWNER = True\nST_SETT_NUMBERS_OWNER = True\n```", "description_content_type": null, "docs_url": null, "download_url": "https://github.com/monobot/simpletickets", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/monobot/simpletickets", "keywords": "django,tickets", "license": "BSD License", "maintainer": null, "maintainer_email": null, "name": "simpletickets", "package_url": "https://pypi.org/project/simpletickets/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/simpletickets/", "project_urls": { "Download": "https://github.com/monobot/simpletickets", "Homepage": "https://github.com/monobot/simpletickets" }, "release_url": "https://pypi.org/project/simpletickets/0.2/", "requires_dist": null, "requires_python": null, "summary": "A simple Django app to create a ticketting system between users and staff.", "version": "0.2" }, "last_serial": 2401025, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "66dc877b4f02487919033312bf40ba54", "sha256": "3e58c802dfbbd2a0b68ef6d2bf2ec8ee7adfe97c8d84b80bfee428e63b8d1fcf" }, "downloads": -1, "filename": "simpletickets-0.1.tar.gz", "has_sig": false, "md5_digest": "66dc877b4f02487919033312bf40ba54", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 37434, "upload_time": "2016-09-25T17:49:09", "url": "https://files.pythonhosted.org/packages/b0/53/3126a66df99537455836ca9e1c1f2a527c604fb50f8c69710b34c2a1a7e2/simpletickets-0.1.tar.gz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "e4bd1e47201f6cbacbd2c8bc4ed016f3", "sha256": "f065fb43d5cf38975ed2119394bdff63919467450a1835410ca06102d97de1bd" }, "downloads": -1, "filename": "simpletickets-0.2.tar.gz", "has_sig": false, "md5_digest": "e4bd1e47201f6cbacbd2c8bc4ed016f3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 28923, "upload_time": "2016-10-15T11:16:51", "url": "https://files.pythonhosted.org/packages/09/f8/9c55d9731046857956ad12f196d5ea155adb8c33bda8edaf1016d4d38113/simpletickets-0.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "e4bd1e47201f6cbacbd2c8bc4ed016f3", "sha256": "f065fb43d5cf38975ed2119394bdff63919467450a1835410ca06102d97de1bd" }, "downloads": -1, "filename": "simpletickets-0.2.tar.gz", "has_sig": false, "md5_digest": "e4bd1e47201f6cbacbd2c8bc4ed016f3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 28923, "upload_time": "2016-10-15T11:16:51", "url": "https://files.pythonhosted.org/packages/09/f8/9c55d9731046857956ad12f196d5ea155adb8c33bda8edaf1016d4d38113/simpletickets-0.2.tar.gz" } ] }