Forgot your password?
New user?
Document Actions
Poi
Category: Project management
—
Other products by this author
Current release: Poi 1.1
Released Dec 27, 2007 — tested with Plone 3.0, Plone 2.5
This release targets functionality improvements beyond what's necessary for a 1.0 release, but without any major refactoring.
Experimental releases
Upcoming and alpha/beta/candidate releases
- Alpha releases should only be used for testing and development.
- Beta releases and Release Candidates are normally released for production testing, but should not be used on mission-critical sites.
- Always install on a separate test server first, and make sure you have proper backups before installing.
Project Description
- Project resources
Releases
Roadmap
Issue tracker
Code repositoryA friendly issue tracker*
Released under the GNU General Public License, version 2
Poi is an issue tracker product for Plone. It has three overarching aims:
- Work with, not against Plone, and use Plone 2.1 features.
- Be simple and attractive whilst providing the most commonly needed issue tracking functionality.
- Optionally integrate with the PloneSoftwareCenter to allow individual products to have their own issue trackers
Poi is not and will not be a track-anything-and-everything tracker, a help desk product or anything else. If Poi is too simple for your needs, you may want to look at something like PloneCollectorNG.
Feedback is very welcome.
Please submit any bugs or feature requests to at:
"http://plone.org/products/poi/issues":http://plone.org/products/poi
(Yes, this is a Poi tracker). Please do search the tracker first, so we can avoid unnecessary duplicates.
See http://plone.org/products/poi for the latest release and the development roadmap.
Installation and dependencies
Poi requires:
- Plone 2.1.2+
- DataGridField (*)
- AddRemoveWidget
- intelligenttext
- For migration from versions before 1.0b2, contentmigration is required.
- For PloneSoftwareCenter integration, PloneSoftwareCenter 1.0beta7 (currently from the plone2.1-integration branch) is required.
(*) NOTE: Before version 1.0 beta 2, ArchAddOn was required instead of DataGridField.
Upgrading
If you had a version prior to 1.0 beta 2 installed, you must run migrations
to avoid losing your old grids (available areas, available issue types). This
is automatic, but you need to install the contentmigration product. This can
be found at:
"https://svn.plone.org/svn/collective/contentmigration/trunk":https://svn.plone.org/svn/collective/contentmigration/trunk
It is also bundled with the release tarball. Simply drop the contentmigration
product into your Products/ folder and re-install Poi from the Add/Remove
Products control panel or portal_quickinstaller in the ZMI.
After any upgrade (and after you have run migrations!), run an Archetypes schema
update, by going to archetype_tool in the ZMI, selecting the Update Schema
tab, selecting all the Poi.* types, and clicking Update schema. It's
probably a good idea to choose All objects from the drop-down as well,
although this will take slightly longer.
If you do not have any old Poi trackers around, you do not need to run migrations.
For new installations, install using Add/Remove Products as normal. If you want PloneSoftwareCenter configuration to be automatically configured, install PSC first.
Usage
Add a Tracker, and use the "state" menu to open it for submissions.
The tracker front pages allows you to browse for issues by release, state or area, as well as search for issues. Note that if you are not tracking software releases, you can leave the list of "releases" empty, and organisation by release will be turned off. The fields for areas and issue types come pre-configured with simple values that presume you are tracking software bugs. You can change these to whatever you want.
Once you have set up the tracker, add Issues inside, and Responses inside Issues. Anyone can add responses to issues with the default workflow. Responses from tracker managers (as configured on the root tracker object) and the original submitter are colour coded to make them easier to pick out. When adding a response as a tracker manager, you can change the state, importance or assignment of an issue.
If email notification is enabled in the root tracker object, managers will get an email when there are new issues and responses, optionally via a mailing list. Issue submittes will also get emails upon issue responses. Additionally, when an issue is marked as "resolved" by a tracker manager, the submitter will receive an email asking him or her to mark the issue as confirmed closed.
To use with the PloneSoftwareCenter, install PSC and then install Poi. This will ensure PoiPscTracker is added to the list of allowed content types in portal_types/PSCProject. You can then add Trackers inside a project in the software center. The trackers will function in the same way as regular trackers, but will use releases from the software center project instead of a manually defined list.
Contributing
Poi is maintained using ArchGenXML (current svn or at least version 1.4), with a Poseidon model found in the model/ directory. Let's keep it that way.
If you have contributed to Poi in some fashion, be sure to add yourself to the Credits section!
Credits
- Design and development by Martin Aspeli
- Bug fixes and general critiquing by Rocky Burt
- Icons by Vidar Andersen, Black Tar, originally created for CMFCollector.
