Holiday Request

Last modified by Guillaume Delhumeau on 2022/02/28 00:09

weather_sunProvides XWiki users with a Holiday Request Application
TypeXAR
Category
Developed by

Thomas Delafosse, Andreea Popescu, Yann Flory

Active Installs11
Rating
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

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

v1.3.1

v1.3

v1.2

Fixed translation and HTML issues in livetable.

Dependencies

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

  • org.xwiki.contrib:macro-fullcalendar 1.1.8
Tags:
    

Get Connected