weather_sunProvides XWiki users with a Holiday Request Application
TypeXAR
Developed by

Thomas Delafosse, Andreea Popescu, Yann Flory

Active Installs12
Rating
Rate!
3 Votes
LicenseGNU Lesser General Public License 2.1
Installable with the Extension Manager

Description

This application allows any user of the wiki to make a holiday request, and enables then his manager to accept or refuse it.

Holiday Request Home

This application allows any user of the wiki to make a holiday request, precising its start and end dates, the number of days off it represents and the manager who should handle this request.
All of the requests thus made are visible on the application WebHome along with their status (pending, cancelled, accepted or refused). 

HolidayRequestHome.png
Holiday Request Home: List of all the holiday requests

Making a new request

When an user clicks on "Make a new holiday request" on the WebHome page, he gets the following page, where he can fill in the different fields available. Then, when he validates his request by clicking on the "Save this request and send a notification to the manager" a notification e-mail with a link to the request page is sent to the manager the user specified.

HolidayRequestSubmit.png
Make a new Holiday Request

If the manager didn't specify his e-mail adress, the request is nonetheless saved, and the user gets a message telling him that no e-mail was sent.

Validation / Refusal

Once a request has been posted, the manager can accept or refuse it by going on the request page. Here again an e-mail is sent to the user having made this request to notify him of the decision of the manager 

HolidayRequestValidate.png
Accept or refuse a request

On top of the manager, all the member of the group "HolidayRequestAdminGroup" can accept, refuse or modify the request. The user having made the request can also modify it or cancel it (in which case a notification e-mail is also sent to his manager).

Overview

From the Holiday Request WebHome you can access the "Overview" page by clicking on the button under the LiveTable. On this page you can see the number of holidays that each employee has taken (i.e this is the sum of all the days of his/her accepted requests) since the begining. If the employee start date is provided, an estimated number of left holiday days is given (based on 25 holiday days a year).

HolidayRequestSummary.png
Overview of all holiday requests

Tested on

This extension has been tested with the following configurations.

Extension VersionXWiki FlavorNotes
1.3XWiki Enterprise 4.3, 4.5, 4.4.1, 5.4.3
1.3.1XWiki Enterprise 6.0.1, 6.2.4, 6.4.1
1.3.2XWiki Enterprise 7.1.2, 7.2
1.3.2XWiki Enterprise 9.1.2

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:

  1. Log in the wiki with a user having Administration rights
  2. Go to the Administration page and select the Import category
  3. Follow the on-screen instructions to upload the downloaded XAR
  4. Click on the uploaded XAR and follow the instructions
  5. You'll also need to install all dependent Extensions that are not already installed in your wiki

Set the language ressource

If you are using XWiki 4.2 or a version below, you will have to set the right language resource:

  • Click on the "Administration" link at the top right corner
  • In the administration menu, click on "Localization"
  • Scroll down until you see "Internationalization Document Bundles"
  • In that field, copy-paste the following text: "HolidayRequest.Translation"
  • Save the page.

Configure SMTP server

If you want the application to send notification e-mails you first need to configure your wiki SMTP server.
Check this tutorial for more details.

Configure the XWikiUsers Class

If you want to display the office of the employees on the WebHome page of the application and get the holiday days left for each employee, you should add the fields 'office' (a static list with the different offices possible) and 'startDate' (a date which would correspond to the date the employee started working in your enterprise) in the 'XWikiUsers' Class. To access it, go to the administration space, in the user profile section and click on the XWikiUsers link. Then click on "Add or modify the class properties" and add the two fields: 'office' and 'startDate'. To add the specific offices location, you should expand the Office field and at Cache->expand Values you should add the names (e.g. Iasi|Paris|London )

Release Notes

v1.3.2

  • Closed HOLIDAYREQ-29 Create a Action column
  • Closed HOLIDAYREQ-27 Remove tabbed information (comments, attachments, etc) from the home page
  • Closed HOLIDAYREQ-23 A "dollar" sign appears in front of the "Manager" word in the page where you want to make a holiday request
  • Closed HOLIDAYREQ-9 Add a Request column
  • Closed HOLIDAYREQ-7 Add an empty state for 'Overview'

v1.3.1

  • Closed HOLIDAYREQ-22 Add a configuration page to improve mails
  • Closed HOLIDAYREQ-21 Manage LDAP and XWiki to automatically fill the 'manager' field

v1.3

  • Closed HOLIDAYREQ-20 Overview doesn't work when 'numberDays' property is empty in a request
  • Closed HOLIDAYREQ-19 Add a 'Calendar' page
  • Closed HOLIDAYREQ-18 Change 'Days' field type to float
  • Closed HOLIDAYREQ-17 Improve the display of pages and mails
  • Closed HOLIDAYREQ-16 Overview doesn't work when the employee account is deleted
  • Closed HOLIDAYREQ-15 Create new 'Comment' and 'Type of holidays' fields
  • Closed HOLIDAYREQ-14 Hide the HolidayRequest.Summary page
  • Closed HOLIDAYREQ-13 The documents are located inside the resources folder on GitHub
  • Closed HOLIDAYREQ-12 HolidayRequest.WebHome's parent should be Main.WebHome and not AppWithinMinutes.WebHome
  • Closed HOLIDAYREQ-11 Rename "Number of Days" with Days
  • Closed HOLIDAYREQ-5 The user avatars are not displayed well when the user is not logged in

v1.2

Fixed translation and HTML issues in livetable.

Dependencies

Dependencies for this extension (org.xwiki.contrib:xwiki-application-holidayrequest 1.3.2):

Tags:
Created by Thomas Delafosse on 2013/10/23 16:35
    

Get Connected