You are here

README.txt in Case Tracker 7.2

Same filename and directory in other branches
  1. 8 README.txt
  2. 5 README.txt
  3. 6 README.txt
  4. 7 README.txt
CONTENTS OF THIS FILE
---------------------

 * Introduction
 * Features
 * Installation
 * Case Tracker URLs
 * Case Tracker Caveats!


INTRODUCTION
------------

Current Maintainer: pedrorocha <http://drupal.org/user/218937>

Previous Maintainer: jmiccolis <http://drupal.org/user/31731>
Original Sponsor: Digital202
Original Developers: India-based team
Oversight: DaveNotik (http://drupal.org/user/18129/contact), killes, zero2one

This module enables a person, team or company to track projects and related 
cases.

This module started from a rewrite of the project.module, but now he varies in 
important ways. The project.module is specific to software development, and the
need for a more generic issue tracker had been expressed.
As such, the casetracker.module focus is to provide a generic approach to case
management, where you have any kind of projects, with any kind of case types
inside.
It also uses regular Drupal structure and integrates cleanly with Views, Organic
Groups, Mailhander, Fields and more.


/************** THE ABOVE TEXT NEEDS TO BE UPDATED TO D7 VERSION **************/


FEATURES
------------

Case Tracker enables teams to track outstanding cases. A case could be a bug
report, a feature request, or a general task. You can also define new case
types. Using Case Tracker, you can set the status of cases and their priority.

Case Tracker lets you have multiple projects and each case is tied to a project. 
The module includes default Project and Case node types. However, you can also
define existing node types to act as Project and Case node types in the
administrative interface. 

Case Tracker includes three modules:
 * Case Tracker: Enables the handling of projects and their cases
 * Case Tracker Basic: Enables a basic project node type for use with Case Tracker
 * Case Tracker Actions: Provides actions for Case Tracker

Case Tracker comes with a default interface that is powered by the Views module,
which can be customized and extended.

Using the administrative interface, you can use Case Tracker to:
 * Assign a user to all new cases by default
 * Assign a default case priority, status, and type to all cases
 * Define existing node types to act as Project and Case node types
 * Define new case states. Case state realms include priority, status, and type

Users can be assigned the following permissions at admin/user/permissions:
 * "administer case tracker"
 * "assign cases"
 * "create projects"
 * "create cases"
 * "edit own projects"
 * "edit own cases"

INSTALLATION
------------

1. Copy the files to your sites/all/modules/ directory.

2. Enable the casetracker module at admin/modules.

3. Assign the project and case node type and other relevant case options at
   admin/settings/casetracker. Case Tracker ships with simplistic "Project"
   and "Case" types in its casetracker_basic.module; although you can use
   these, you will get stronger flexibility by assigning it to a
   content type of your own creation, or an Organic Group.

4. Customize case types, priorities, and states at admin/casetracker.

5. Enable permissions in admin/access.

Note: for more project.module-like functionality, try installing the
comment_upload.module and enabling comment attachments for case nodes.


CASE TRACKER URLS
-----------------

The project based URLs we provide are briefly described below. These displays
are completely powered by the Views module and can be completely disabled or
reworked for completely different displays.

  /casetracker/
    Displays a list of all cases.

  /casetracker/my
    Displays a list of cases assigned to the current user.

  /casetracker/projects/
    Displays a list of all projects.


CASE TRACKER CAVEATS!
---------------------

Some common gotchas which are, at the moment, "by design":

 * The "Last modified" value of Case Tracker cases is determined by the
   timestamp of the last comment attached to them (or, in the absence of
   a single comment, the node creation time). This requires that the
   comment.module (and node_comment_statistics table) are enabled and
   created. We CAN think of some use cases for not requiring comments on
   a case, but we think them edge cases and not enough to cater to. If
   you feel otherwise, don't hesitate to voice your opinion.

 * Case Tracker does not provide any access control to nodes or fields.
   There are other fine modules which provide varying kinds of access control
   which can be used with Case Tracker.

File

README.txt
View source
  1. CONTENTS OF THIS FILE
  2. ---------------------
  3. * Introduction
  4. * Features
  5. * Installation
  6. * Case Tracker URLs
  7. * Case Tracker Caveats!
  8. INTRODUCTION
  9. ------------
  10. Current Maintainer: pedrorocha
  11. Previous Maintainer: jmiccolis
  12. Original Sponsor: Digital202
  13. Original Developers: India-based team
  14. Oversight: DaveNotik (http://drupal.org/user/18129/contact), killes, zero2one
  15. This module enables a person, team or company to track projects and related
  16. cases.
  17. This module started from a rewrite of the project.module, but now he varies in
  18. important ways. The project.module is specific to software development, and the
  19. need for a more generic issue tracker had been expressed.
  20. As such, the casetracker.module focus is to provide a generic approach to case
  21. management, where you have any kind of projects, with any kind of case types
  22. inside.
  23. It also uses regular Drupal structure and integrates cleanly with Views, Organic
  24. Groups, Mailhander, Fields and more.
  25. /************** THE ABOVE TEXT NEEDS TO BE UPDATED TO D7 VERSION **************/
  26. FEATURES
  27. ------------
  28. Case Tracker enables teams to track outstanding cases. A case could be a bug
  29. report, a feature request, or a general task. You can also define new case
  30. types. Using Case Tracker, you can set the status of cases and their priority.
  31. Case Tracker lets you have multiple projects and each case is tied to a project.
  32. The module includes default Project and Case node types. However, you can also
  33. define existing node types to act as Project and Case node types in the
  34. administrative interface.
  35. Case Tracker includes three modules:
  36. * Case Tracker: Enables the handling of projects and their cases
  37. * Case Tracker Basic: Enables a basic project node type for use with Case Tracker
  38. * Case Tracker Actions: Provides actions for Case Tracker
  39. Case Tracker comes with a default interface that is powered by the Views module,
  40. which can be customized and extended.
  41. Using the administrative interface, you can use Case Tracker to:
  42. * Assign a user to all new cases by default
  43. * Assign a default case priority, status, and type to all cases
  44. * Define existing node types to act as Project and Case node types
  45. * Define new case states. Case state realms include priority, status, and type
  46. Users can be assigned the following permissions at admin/user/permissions:
  47. * "administer case tracker"
  48. * "assign cases"
  49. * "create projects"
  50. * "create cases"
  51. * "edit own projects"
  52. * "edit own cases"
  53. INSTALLATION
  54. ------------
  55. 1. Copy the files to your sites/all/modules/ directory.
  56. 2. Enable the casetracker module at admin/modules.
  57. 3. Assign the project and case node type and other relevant case options at
  58. admin/settings/casetracker. Case Tracker ships with simplistic "Project"
  59. and "Case" types in its casetracker_basic.module; although you can use
  60. these, you will get stronger flexibility by assigning it to a
  61. content type of your own creation, or an Organic Group.
  62. 4. Customize case types, priorities, and states at admin/casetracker.
  63. 5. Enable permissions in admin/access.
  64. Note: for more project.module-like functionality, try installing the
  65. comment_upload.module and enabling comment attachments for case nodes.
  66. CASE TRACKER URLS
  67. -----------------
  68. The project based URLs we provide are briefly described below. These displays
  69. are completely powered by the Views module and can be completely disabled or
  70. reworked for completely different displays.
  71. /casetracker/
  72. Displays a list of all cases.
  73. /casetracker/my
  74. Displays a list of cases assigned to the current user.
  75. /casetracker/projects/
  76. Displays a list of all projects.
  77. CASE TRACKER CAVEATS!
  78. ---------------------
  79. Some common gotchas which are, at the moment, "by design":
  80. * The "Last modified" value of Case Tracker cases is determined by the
  81. timestamp of the last comment attached to them (or, in the absence of
  82. a single comment, the node creation time). This requires that the
  83. comment.module (and node_comment_statistics table) are enabled and
  84. created. We CAN think of some use cases for not requiring comments on
  85. a case, but we think them edge cases and not enough to cater to. If
  86. you feel otherwise, don't hesitate to voice your opinion.
  87. * Case Tracker does not provide any access control to nodes or fields.
  88. There are other fine modules which provide varying kinds of access control
  89. which can be used with Case Tracker.