home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 April / CMCD0404.ISO / Software / Freeware / Programare / dotproject / modules / ticketsmith / README < prev    next >
Encoding:
Text File  |  2003-07-16  |  6.0 KB  |  148 lines
  1. --------------------------------
  2.  dotProject enhanced Ticketsmith
  3. --------------------------------
  4.  
  5. Ticketsmith was originally developed by Justin Miller at Voxel.Net to
  6. be a standalone trouble ticket management system.  It was originally
  7. incorporated into dotProject although it wasn't well integrated.
  8.  
  9. Work has since been done to incorporate it more seamlessly into
  10. dotProject.  This includes not having separate configuration files,
  11. changing the gateway code to work with the PHP config files, etc.
  12.  
  13. Check the document INSTALL to see how to install the email gateway
  14. for dotproject.
  15.  
  16. The original README from ticketsmith is included here for completeness:
  17.  
  18.  
  19. --------------------
  20.  Ticketsmith v0.6.3
  21. --------------------
  22.  
  23. URL:            http://www.voxel.net/projects/ticketsmith/
  24. Mailing list:   ticketsmith@solidlinux.com
  25. Author:         Justin R. Miller <justin@voxel.net>
  26. License:        Voxel Public License (see LICENSE)
  27.  
  28. ----------
  29.  Overview 
  30. ----------
  31.  
  32. Ticketsmith is an all-in-one email/web-based ticket support system.  Messages  
  33. to your support list will be inserted into a database and cataloged for easy
  34. viewing on the web.  Multiple staff users can answer tickets via the system and
  35. their answers and resulting responses (and so on) will all be recorded.   The
  36. system is multi-user capable, fast, and full-featured.  Say goodbye to lost
  37. support mail!
  38.  
  39. Ticketsmith is the open-source support component of Voxel Dot Net's web hosting 
  40. automation system, â–„bersmith.  
  41.  
  42. -------------- 
  43.  Requirements 
  44. --------------
  45.  
  46. Ticketsmith needs a server with PHP4 enabled.  There are a few features  (such
  47. as auto-wordwrapping) that will require a very recent version of  PHP4 (greater
  48. than 4.0.2) but these features can be disabled.  You'll also need access to a
  49. MySQL server on which you can create a separate database.  You'll need Perl  as
  50. well as the MySQL DBI module for it.  Lastly, you'll need some kind of  MDA
  51. (Mail Delivery Agent) such as procmail that is capable of piping mail  to a
  52. program or be able to set up your MTA (such as sendmail or qmail) to  send mail
  53. for an address to a program.
  54.  
  55. On the client side, 4.x browsers give the best appearance, since stylesheets 
  56. and JavaScript are used.  Also, with the introduction of PHP4 session 
  57. management, a browser which accepts cookies is required.  
  58.  
  59. -------------- 
  60.  Installation 
  61. --------------
  62.  
  63. 1.  Uncompress and un-tar the download file.  I'm assuming that since you're 
  64.     reading this, you've already done this.  Put the scripts someplace 
  65.     accessible from the web.
  66.  
  67. 2.  Be sure to protect the gateway.pl file.  You basically need to do one 
  68.     of two things, either move it out of a web-accessible place or somehow 
  69.     protect it from being accessed over the web:
  70.     
  71.             <Files "gateway.pl">
  72.                 order deny,allow
  73.                 deny from all
  74.             </Files>
  75.     
  76.     If you don't protect it, one of two things will happen,  either users will be
  77.     able to see the source and thus grab your Ticketsmith MySQL password, or
  78.     something unpredictable will happen when Apache tries  to run it as a CGI
  79.     script.  I don't think this could be harmful, but hey,  you never know.
  80.  
  81. 3.  Create the database on your MySQL server.  A good name is 'ticketsmith' with
  82.     access as user 'ticketsmith' and a password of your choosing.
  83.  
  84. 4.  Edit the bottom of the table.schema file to reflect the administrative password 
  85.     you would like.  
  86.  
  87. 5.  Create the necessary tables.  You can use the provided database schema file:
  88.  
  89.             mysql -uticketsmith -p ticketsmith < table.schema
  90.             
  91.     and entering the password you set up in Step 3 when it prompts you.  
  92.             
  93. 6.  Move or delete the table.schema file.  If you don't, it will be accessible from 
  94.     the web and users will be able to gain your admin password.              
  95.  
  96. 7.  Edit config.inc.php and the top of gateway.pl to fit your setup.
  97.  
  98. 8.  Create user accounts for your staff.  You can do this by logging in as 'admin' 
  99.     with the password created in Step 4 after pointing your browser at the 
  100.     Ticketsmith main login page.  It should be pretty self-explanatory.  Name,
  101.     email,  and signature are as you'd want them on outgoing mail.  If you include 
  102.     a signature, when that user goes to followup, their signature will automatically  
  103.     be included in the composition area.  
  104.     
  105. 9.  Configure your MDA or MTA to pipe mail for your support list to gateway.pl.  For
  106.     example,  here is a sample procmail recipe:
  107.  
  108.             :0
  109.             * (^To:|^CC:|^Cc:) .*support@foo.bar
  110.             |/path/to/gateway.pl
  111.  
  112.     You can also set Ticketsmith up directly with sendmail in /etc/aliases: 
  113.  
  114.             support: "|/path/to/gateway.pl"
  115.  
  116.     Keep in mind that with sendmail you need to either put gateway.pl in 
  117.     /etc/smrsh or at least symlink to it from that directory so that 
  118.     sendmail will execute it.  If you do this, you'll have to point 
  119.     the /etc/aliases entry to the copy in /etc/smrsh.
  120.  
  121. 10. Start using Ticketsmith!  Mail sent to your support list should start 
  122.     showing up on the main page.
  123.  
  124. ------- 
  125.  Usage 
  126. -------
  127.  
  128. As mail accumulates, you will see it on the main page.  When you examine a
  129. ticket,  you will some basic info.  Here you can assign the ticket to one 
  130. of your staff, change its status, or read its followups.  Followups come in 
  131. two varieties, either ones made by your staff or ones emailed in by clients.  
  132. Followups made by your staff can either be email responses to the client 
  133. (known as 'followups') or internal comments which don't get sent but can 
  134. be viewed by your staff (known as 'comments').  
  135.  
  136. Ticketsmith should handle the subject lines properly so that followups are 
  137. kept with their parent ticket.  You might want to let your clients know 
  138. to keep the standard subject that is in the email.  Most mail clients will 
  139. do this automatically when you hit 'reply'.  
  140.  
  141. --------------
  142.  Mailing List
  143. --------------
  144.  
  145. To subscribe to the Ticketsmith mailing list, send an email to 
  146. minimalist@solidlinux.com with the words "subscribe ticketsmith" 
  147. in the subject.  Follow the instructions that you receive from there.  
  148.