Holiday Request
Provides XWiki users with a Holiday Request Application |
Type | XAR |
Category | |
Developed by | |
Active Installs | 11 |
Rating | |
License | GNU Lesser General Public License 2.1 |
Table of contents
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).
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.
Make a new Holiday Request
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
Accept or refuse a request
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).
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:
- 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
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