| | 1 | [[PageOutline(2-5,Contents,pullout)]] |
| | 2 | |
| | 3 | = Resource Reservation plugin for Trac = |
| | 4 | |
| | 5 | == Description == |
| | 6 | |
| | 7 | A Trac plugin and macro to allow for visually planning and reserving the use of resources in your environment, e.g. test machines, consumable test data, etc..., with just one click. |
| | 8 | |
| | 9 | Installation of the plugin adds a new tab named "Resource Reservation" that leads to a pre-filled Wiki page with the macro already in place. |
| | 10 | |
| | 11 | By default, the macro displays an empty calendar spanning three months in the future, including the current month. |
| | 12 | You can then: |
| | 13 | * Add a new resource, by entering the resource name in the edit box and click "Add a Resource" |
| | 14 | * See who owns a resource in any particular date: |
| | 15 | * A white cell indicates the resource is free at a certain date |
| | 16 | * A blue cell indicates the resource is reserved by the current user at a certain date |
| | 17 | * A red cell indicates some other user has reserved the resource at a certain date. The name of the user can be seen by hovering with the mouse on the cell. |
| | 18 | * Reserve the resource for any days in the calendar, by simply clicking on the corresponding table cell => the information is saved in the database on the fly, no need to save the page. The cell will become blue |
| | 19 | * Cancel a resource reservation, when it is reserved by you (blue cell), by simply clicking on it again => The cell becomes white again |
| | 20 | * Take on a resource reserved by something else (red cell), by simply clicking on the corresponding cell => The cell becomes blue and the resource is immediately assigned to the current user |
| | 21 | |
| | 22 | You can edit the default page, changing the macro default parameters: |
| | 23 | * type: you can define any number of resource types by simply providing a different value for this parameter to any instance of the macro. This way, you can plan the use of different types of resources at the same time, with no conflict between them |
| | 24 | * period: the number of months, including the current one, to display in the calendar |
| | 25 | * title: the title, i.e. descriptive name of the resource type, to be used in the calendar as the header of the resource names column |
| | 26 | |
| | 27 | |
| | 28 | Or you can add the following snippet in any of your Wiki pages, for example to keep track of multiple resource types in different places: |
| | 29 | |
| | 30 | [[ResourceReservationList(type=resource,period=3,title=Resource)]] |
| | 31 | |
| | 32 | |
| | 33 | == Bugs/Feature Requests == |
| | 34 | |
| | 35 | Existing bugs and feature requests for ResourceReservationPlugin are |
| | 36 | [report:9?COMPONENT=ResourceReservationPlugin here]. |
| | 37 | |
| | 38 | If you have any issues, create a |
| | 39 | [http://trac-hacks.org/newticket?component=ResourceReservationPlugin&owner=seccanj new ticket]. |
| | 40 | |
| | 41 | == Download == |
| | 42 | |
| | 43 | Download the zipped source from [download:resourcereservationplugin here]. |
| | 44 | |
| | 45 | == Source == |
| | 46 | |
| | 47 | You can check out ResourceReservationPlugin from [http://trac-hacks.org/svn/resourcereservationplugin here] using Subversion, or [source:resourcereservationplugin browse the source] with Trac. |
| | 48 | |
| | 49 | == Example == |
| | 50 | |
| | 51 | The plugin can be installed as usual, from the Trac administration panel, and requires a database upgrade. |
| | 52 | |
| | 53 | At the moment it has been tested only on Trac 0.11 with Python 2.5. |
| | 54 | |
| | 55 | |
| | 56 | == Recent Changes == |
| | 57 | |
| | 58 | [[ChangeLog(resourcereservationplugin, 3)]] |
| | 59 | |
| | 60 | == Author/Contributors == |
| | 61 | |
| | 62 | '''Author:''' [wiki:seccanj] [[BR]] |
| | 63 | '''Maintainer:''' [wiki:seccanj] [[BR]] |
| | 64 | '''Contributors:''' |
