Mocca Calendar Application
A Calendar Application supporting several Calendars |
Type | XAR |
Category | |
Developed by | xwiki:XWiki.edgo, Clemens Robbenhaar |
Rating | |
License | GNU Lesser General Public License 2.1 |
Table of contents
Description
Combines the Calendar Application application with the FullCalendar Application to provide an "out of the box" usable calendar within XWiki with the slick UI from the "FullCalendar" jQuery plugin.
Usage
After installing the extension you should have a "Calendar" in the applications panel; alternatively you can reach the application at http://<server>/xwiki/bin/view/MoccaCalendar/
The application maintains several calendars. One default calender is preinstalled.
The start page displays all events of all calendars in the current month.
Users can either add new events (which end up in the default calendar, unless specified differently) or new calendars.
Overview page
Calendars have a description and color. All events of a given calendar are displayed in the color of it's calendar.
Events, beside of being colored like their corresponding calendar, also have a short name, a description, a start and an end date. Events can be "all day" events or have a defined start and end time, too.
Display of various events on the main calendar page
Creating events
Clicking on the "Create an Event" link opens a modal dialog which allows you to give the new event a title, start and end date and time and a description. (The description only shows up in the details view). "All day" events are supported, too (currently you have to give even "all day" a dummy time for start and end date, too, which will be ignored however.)
Recurring events are not yet supported.
Dialog to create a new event
Editing events
Clicking on an event in the calendar opens the detail view of the event. In this dialog you can edit the event or delete the event (you have to confirm the delete in the dialog.)
Detail view of an existing event
Editing an existing event
Alternatively you can view the Event as a wiki page by clicking on the "View" button in the dialog; on that page you can add attachments, look at the history, etc.
You can go back to the calendar you came from via the link at the bottom, or to the main calendar overview via the link in the breadcrumbs.
An event viewed as wiki page
Managing Calendars
At the bottom of the overview page you can find a table of all existing calendars, with options to view edit or delete them, and a link to add new calendars on top of it:
List of all existing calendars
If you click on the "Create a calendar" link you will be first led to the normal "add page" dialog, which then will create a new calendar and show it to you in edit mode. You can set up the title, color (via the convenient color picker) and description. The latter is shown in the detail view of the calendar.
Editing a calendar
Issues
If you find a bug or have a suggestion for improvement, please report it in the Issue Tracker. Please check if the issue has been reported there already.
Prerequisites & Installation Instructions
We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.
You can also use the following manual method, which is useful if this extension cannot be installed with the Extension Manager or if you're using an old version of XWiki that doesn't have the Extension Manager:
- Log in the wiki with a user having Administration rights
- Go to the Administration page and select the Import category
- Follow the on-screen instructions to upload the downloaded XAR
- Click on the uploaded XAR and follow the instructions
- You'll also need to install all dependent Extensions that are not already installed in your wiki
Release Notes
v2.3.1
v2.3
v2.2.2
v2.2.1
v2.2
v2.1.9
v2.1.8
Dependencies
Dependencies for this extension (org.xwiki.contrib:application-mocca-calendar-ui 2.3.1):
- org.xwiki.platform:xwiki-platform-rendering-wikimacro-store 5.4
- org.xwiki.rendering:xwiki-rendering-macro-html 5.4
- org.xwiki.platform:xwiki-platform-rendering-macro-code 5.4
- org.xwiki.platform:xwiki-platform-rendering-macro-groovy 5.4
- org.xwiki.platform:xwiki-platform-rendering-macro-include 5.4
- org.xwiki.platform:xwiki-platform-rendering-macro-velocity 5.4
- org.xwiki.platform:xwiki-platform-livetable-ui 5.4
- org.xwiki.platform:xwiki-platform-appwithinminutes-ui 5.4
- org.xwiki.platform:xwiki-platform-jodatime 5.4
- org.xwiki.contrib:macro-fullcalendar 2.0