Changes between Version 2 and Version 3 of IcalViewPlugin
- Timestamp:
- Jul 24, 2009, 5:15:22 PM (15 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
IcalViewPlugin
v2 v3 5 5 Provide iCalendar feeds for ticket queries as standard [http://trac.edgewall.org/roadmap roadmap module]. It use 2 custom fields for event date and duration. 6 6 7 == Description==7 == Usage == 8 8 9 == Limitations==9 === Setup custom fields for date and duration === 10 10 11 * date for date_creation custom field use dd.mm.yyyy format. Working to provide setup options. 12 * only support duration in days number. 11 To transform a ticket to an event, we need at least a date. Trac only provide a creation date or an update date. So we need a planned date by adding a custom field. The default name is 'dtstart' (mathing [http://tools.ietf.org/html/rfc2445 RFC/2445]). 13 12 14 After installation, you need had 2 custom fields to tickets : 13 trac.ini 14 {{{ 15 [ticket-custom] 16 dtstart = text 17 dtstart.label = Planned Date 18 }}} 19 20 To use another field name, you can set it in a new configuration section named 'icalendar' : 15 21 16 22 {{{ 23 [ticket-custom] 24 my_custom_dtstart = text 25 dtstart.label = Planned Date 17 26 27 [icalendar] 28 dtstart = my_custom_dtstart 29 }}} 30 31 We also need a duration fields : 32 {{{ 18 33 [ticket-custom] 19 34 dtstart = text 20 dtstart.label = Date 35 dtstart.label = Planned Date 36 21 37 duration = text 22 38 duration.label = Duration in days 23 39 }}} 24 40 25 Other custom fields name may be used, but need a special setup : 26 41 To use another field name : 27 42 28 43 {{{ 29 44 [icalendar] 30 dtstart = my_custom_dtstart 31 duration = my_custom_duration 45 duration = my_custom_duration_field_name 32 46 }}} 33 47 48 49 === Date and duration input format === 50 51 Default input date format are : "'%m/%d/%Y" (month/day/year) for strict date and and "%m/%d/%Y %H:%M" for date and time. 52 53 To customize this format, use the "short_date_format" and "date_time_format" configuration options : 54 55 {{{ 56 [icalendar] 57 short_date_format = %d/%m/%Y 58 date_time_format = %d/%m/%Y %H:%M 59 }}} 60 61 to support multiple format, use a ';' to separate them: 62 63 {{{ 64 [icalendar] 65 short_date_format = %d/%m/%Y;%Y-%m-%d 66 date_time_format = %d/%m/%Y %H:%M;%Y-%m-%d %H:%M 67 }}} 68 69 70 Duration fied support 4 syntax : 71 * Standard hours:minutes format : H:MM ( "8:45" "12:30" ...) 72 * a number of days ending by a 'd' : 15d 73 * the standard [http://tools.ietf.org/html/rfc2445 RFC/2445] duration begining with a "P" : "P1W" "P1D" ... 74 75 Some tips : 76 * Tickets with a planned date and no duration are planned as a day event 77 * Tickets without a planned date are transfomed as TODO. 78 79 == Limitations == 80 81 The calendar is read only. 34 82 35 83 == Bugs/Feature Requests ==