Month Calendar macro

Since MoinMoin version 1.3.5 MonthCalendar is a built-in macro.

The Problem

MoinMoin is great for storing semantically linked stuff, but there was no easy way to access and browse calendar related data yet.

So if you want to use MoinMoinAsPim (Personal Information Manager), you need calendar access and calendar wiki integration (just calling a cgi web calendar is not enough for the Wiki way).

for documentation now look at HelpOnMacros/MonthCalendar

Support area

If you have questions, problems, bug reports, wishes, comments - put them here:

• Is there a possibility to subscribe to a whole calendar? I define a page Calendar06 with all month of 2006 and if somebody adds a new item to some date all subscribed users should get a mail.

  • You may use regular expressions in your subscription list. Just add "Calendar06/.*" to your subscription list in your user preferences.

• I've got MonthCalendar installed and it looks great. But I wonder if it's quite the right tool for what I'm trying to do. I'm running a wiki for a university course, and I wanted to include a schedule of course events and other stuff.

  • Does each page have its own calendar? Yes. At least, that is the default - see also next answer.

  • So if I want to have a centralized calendar, I use the [[MonthCalendar(CentralCalendarPage)]] notation? Yes. Or you just jump to that page and view the calendar there.

• Modified the version above to run with moin--main--1.2 and did a lot of style and logic changes and clarifications. Take a look at it on OliverGraf/MonthCalendar

• It seems that when using the MonthCalendar(PageOne*PageTwo) style, it renders the look properly, with PageOne and Two's links in different colours, but the actual links always point to PageOne.

  • This is on purpose. If you want to change the second calendar, first go to it by clicking on its name in the title area.

• It'd be incredible if this output iCalendar data. See Futures:AutomaticCalendaring. -- LionKimbro

  • the way to do this is to use the VObject module to interact with a real ical/vCalendar data structure somehow. but I don'tthink it's trivial to implement. was working this for a while but haven't been ableto think about it for some time now -- MattPrice

    • What's the problem? See ActionMarket/IcsProducer for an example. The complicated thing is about recurrences. Simple one-time events are straight-forward to implement. -- MSt 2006-02-28 13:49:33

• Great module. Is it possible to have a macro that creates a link directly to today for the calendar? Also, is it possible to have the calendar specify a template to use for new pages?
• Is it possible to have Sunday be the start of the week? (For Americans, at least, it's strange to have the week start on Mondays.)

  • Yes. All you need to do in version 2.1 of MonthCalendar (built-in to Moin 1.3.5) is change one line in the macro.

    • Could you explain how to do that?
      • Open MoinMoin/macro/MonthCalendar.py and search for SUNDAY. Read the comment.

• I'm using MMDE and have quite a few date entries already, namely in the form localhost:8080/2005-06-09. I'm almost set to use MonthCalendar and get a whole bunch more efficient, but I can't be in a date (like 2005-06-09) and call  [[MonthCalendar(,2005,06)]]  and get links to 2005-06-10, instead I get links to 2005-06-09/2005-06-10. I think I'd like to call MonthCalendar with a null BasePage, or the root document, but I can't figure out how. Does MonthCalendar support a way to have a null BasePage?

  • No. You have to put the calendar on the page you want the date pages below. You can include some dates from another calendar, though.

• What is the purpose of the r, g, b = cliprgb etc. code?

  • It is to keep the colour values in some specific range. Used when overlapping dates occur from different calendars getting mixed.

• I've created a Macro to work with OliverGraf's [OliverGraf/MonthCalendar]. It lists or includes (by option) all pages for the given month, and sorts them as Upcoming and Past dates. Right now it is being used in a MoinMoin fork, but should be easy to adapt back for use with MoinMoin. You can see it in action here. Feel free to leave a message on my user page if you have any interest in it. -- RobertPolyn

• I am missing the ability to have an automated template like in the NewPage-macro. I want to have news entries that all use the same template.

• In a standard template as mentioned just above I would perhaps put my addition to Navigation.py that I describe in GeoffGardiner/NavigationMods. This just enable links to the nearest two calendar entries and the calendar parent.

• I have made slight mods to my own copy of MonthCalendar as described in GeoffGardiner/MonthCalendarMods. These a) soften the background colour when there is an entry and b) vary the background colour dependent on the contents of the page (only to recognize the headings 'Appointment' and 'To Do').

• How about an option to create a "schedule calendar" that would show info from the subpage on the main calendar page instead of simply as a mouseover? This would make it a great for public calendar pages. This style of calendar would probably need to grow to cover the entire width of the page.

• Mixing Anniversary Calendars and normal calendars using MonthCalendar(DailyCalendar*YearlyCalendar)]] won't work, since currently the daily calendar searches only for yyyy-mm-dd subpages and so the mm-dd subpages of the yearly calendar are not shown. I think it should be possible to mix these calendar sort.

• How about making appointments for more than one day. For example a conference week. Since I use the calendar entries also to pin down a small resumee about some appointments, it would be great, if multiple day appointments would be possible. Calendar format could be something like yyyy-mm-d1-yyyy-mm-d2
• How about to add week number in front of every week ? --- Yes please, and have separate references for week notes and month nodes in addition to the day notes.

• Ever considered the possibilty of "moving" a calendar page from one date to another by renaming it? This would be of some use to me. -- CraigJohnson 2006-01-09 14:26:40

• It would be fine to be able to call a page template. -- ReimarBauer 2006-01-16 09:27:46

• I don't like very much the fact, that all calendar subpages are considered as OrphanedPages by the system (unless I link to them from outside) -- KrzysztofNosek 2006-02-28 16:10:28

• What is a convenient way of adding Next Day / Previous Day links into the daily pages?

• I add a [[MonthCalendar(ABCEvent*TechnicalSeminar)]], but the calendar only shows events in ABCEvent, and show green marks to the calendar about events of Technical Seminar. But when mouse over, no any texts about Technical Seminar. How to solve this problem? -- wanghaic 2006-03-20 16:10:28

  • Just click on the name of the other calendar in the calendar's first line to view THAT calendar.
    • I want such a style when a mouse moving on. Is it possible?

      • ABCEvent/2006-03-21

        Somebody's visit

        TechnicalSeminar/2006-03-21

        Somebody's speaking

      • There is no code in MonthCalendar doing this yet. Feel free to submit a patch.

      • I have added a hack to MacroMarket. It doesn't do the nice color formatting yet, and if you are interested in doing that feel free to modify my code.

• Is there a way to change the tips in the MonthCalendar to reflect that date's contents? I've been trying to change it from displaying the pagename --AnonymousCoward

  • use = important stuff to display =

  • you can use my MonthCalendar hack to include date's content and to allow clicking on it

• If feel the need to have MacroCalendar supports titles in the form '''title''' and not only = title = (i think it's better for pages where you use the TableOfContents macro - see FeatureRequests/ExcludeHeadingsFromTableOfContent) so I have created a hack here

• the 'tooltip' that appears when passing the mouse on a day shows all the titles if they are several ones H1 titles in the page, is it normal?

  • -- EricVeirasGalisson 2007-09-14 13:40:50

• I use moinmoin among other things because of its ability to render reStructredText instead of some sort of wiki text. So it would be nice if MacroCalendar is capable of extracting reStructredText titles too.

• I added a macro for calendar sub-pages which allows the display of the calendar day and an offset day. See MacroMarket/CalDate.

• MonthCalendar should not use hardcoded colours. It does not play well with themes. cal-usedday cannot be used to override background colour f.ex PrebenR 2008-11-08 01:55:05

  • So your suggestion is what exactly?

• It would be nice if the MonthCalendar also can visualize somehow a category given on the page. e.g. if you have something like an approved day for a meeting then you want this be shown in a different color.

TODO

• maybe get a more recent version of tooltip javascript)

see also AdventCalendar