Skip to content

zetxek/jorani

 
 

Repository files navigation

Jorani is a Leave Management System developed in PHP/MySQL under an AGPL v3 licence. Jorani is designed to provide simple leave and overtime request workflows for small organizations.

Jorani Logo

Informations / getting help

Join the chat at https://gitter.im/bbalet/jorani

Status

This project is stable and ready for production. An online demo is available here : https://demo.jorani.org/ Use bbalet / bbalet for login / password.

Features

  • Comprehensive online documentation (French and English).
  • Notifications by e-mail (requested, accepted, rejected and new user).
  • Leave request approval workflow (1 validator).
  • Overtime request approval workflow (1 validator).
  • Leave balance report (filtered by department).
  • Monthly presence report.
  • Export to XLSX (Excel, LibreOffice) in a click (almost all pages of the application).
  • HR users can edit any leave or overtime request.
  • Set your own contracts and leave types.
  • Calendars of leaves (individual, team, collaborators, etc.).
  • Describe your organization in a tree structure and attach employees to entities, define a supervisor per entity.
  • Non working days (weekends and day offs) can be defined on a contract so as to automatically calculate the duration of a leave and to display them in the calendar.
  • REST API (OAuth2) fully documented and examples with PHP clients.
  • LDAP Authentication (OpenLDAP, AD, etc.).
  • OAuth2 Authentication (only Google+ at the moment).
  • Available in English, French, Spanish, Italian, German, Dutch, Russian, Ukrainian, Persian, Khmer, Vietnamese, and Turkish.

Installation

See the installation instructions for advanced configuration. In a nutshell :

  • If you use Apache, mod_rewrite must be activated and the config must allow overwriting settings with .htaccess file.
  • Download or clone Jorani.
  • Upload the content of this folder on your server (in /var/www/...).
  • Create a database with /sql/lms.sql script.
  • Create a user with SELECT, INSERT, UPDATE, DELETE, EXECUTE permissions on the database.
  • Update /application/config/database.php according to your database settings.
  • Update the end of /application/config/email.php with your e-mails settings.
  • Update the end of /application/config/config.php if you want to change the default behaviour.
  • It is recommended to change the private and public RSA keys (in assets/keys).
  • Check your installation with the requirements.php page at the root of your installation (e.g. http://localhost/lms/requirements.php).
  • The default user is bbalet and password is bbalet.

Contribute

Credits

Contributors

  • NGO Passerelles numériques, our first user http://passerellesnumeriques.org/en/
  • Github and Google groupe users for their ideas and tests.
  • Translation : Roger WOLFS (Dutch), Heng Vongkol (Khmer) Christian SONNENBERG (German), Hector NESTAR (Spanish), Dario BRIGNONE (Italian), Oleg KOPTEV, Yevhen Kyrylchenko (Russian), Ela Alptekin (Turkish), and Sayed Kabir Salehi (Farsi) and all participants of the Transifex project.

Third party libraries and components

We thank the following open source projects for the components used by Jorani:

Backend

Frontend

About

Leave and Overtime Management System

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 55.3%
  • PHP 40.1%
  • CSS 4.1%
  • Other 0.5%