PHPackages                             bizley/timeclock - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. bizley/timeclock

ActiveProject[Utility & Helpers](/categories/utility)

bizley/timeclock
================

Simple Work Time Clock Project

2.4.1(5y ago)3632511[2 issues](https://github.com/bizley/timeclock/issues)[4 PRs](https://github.com/bizley/timeclock/pulls)MITPHPPHP >=7.1CI passing

Since Dec 19Pushed 5mo ago2 watchersCompare

[ Source](https://github.com/bizley/timeclock)[ Packagist](https://packagist.org/packages/bizley/timeclock)[ GitHub Sponsors](https://github.com/bizley)[ RSS](/packages/bizley-timeclock/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (10)Dependencies (8)Versions (25)Used By (0)

TimeClock
=========

[](#timeclock)

[![Latest Stable Version](https://camo.githubusercontent.com/4b14fc968c5ab6cc2ba64d41c0ee1dd969123107f4affaaebe424962e0dac6a3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f62697a6c65792f74696d65636c6f636b2e737667)](https://camo.githubusercontent.com/4b14fc968c5ab6cc2ba64d41c0ee1dd969123107f4affaaebe424962e0dac6a3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f62697a6c65792f74696d65636c6f636b2e737667)[![Total Downloads](https://camo.githubusercontent.com/0c85332ba51edd91a04ee3d30c65e947d213d514b458e952fd14eccd85a2ccaf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f62697a6c65792f74696d65636c6f636b2e737667)](https://packagist.org/packages/bizley/timeclock)[![Yii2](https://camo.githubusercontent.com/d6b0929173e28cc627430d2519ca1853466a70f37395877eaf4820cb3e1e1909/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f506f77657265645f62792d5969695f4672616d65776f726b2d677265656e2e7376673f7374796c653d666c6174)](https://www.yiiframework.com/)

Simple work time clocking service built on [Yii 2 framework](https://www.yiiframework.com).

[![screen](https://camo.githubusercontent.com/5c9a1c4ee142177b9bc54d9cb59604cc40403052b066d2ec8aac79f8e097522d/68747470733a2f2f62697a6c65792e6769746875622e696f2f74696d65636c6f636b2f74632d6461726b2e706e67)](https://camo.githubusercontent.com/5c9a1c4ee142177b9bc54d9cb59604cc40403052b066d2ec8aac79f8e097522d/68747470733a2f2f62697a6c65792e6769746875622e696f2f74696d65636c6f636b2f74632d6461726b2e706e67)

Installation
------------

[](#installation)

1. Install TimeClock using Composer:

    `composer create-project --prefer-dist bizley/timeclock timeclock`
2. Prepare virtual host pointing to `/public` directory.
3. Prepare configuration for DB of your choice. Place it in `/src/config/db.php`.
4. Modify the `/src/config/web.php` file to change:

    - `timeZone` (default `UTC`),
    - `language` (default `en-US`; `pl` and `de` translations are provided in `/src/messages/` folder),
    - `components > mailer` configuration to actually send emails (needed for password reset),
    - `components > formatter` configuration of date and time formats,
    - `params > company` (default `Company Name`; displayed in footer and other layout places),
    - `params > email` (default `email@company.com`; used as the email sender address for emails),
    - `params > allowedDomains` (default `['@company.com']`; array with email domains allowed for registration).
5. Change `/public/index.php` file to set `YII_DEBUG` mode to `false` and `YII_ENV` environment to `prod`.
6. Apply migrations by running in console `php yii migrate`.
7. Start webserver and register first account.
8. If you want to make an account to be admin run in console `php yii admin/set ID` where `ID` is DB identifier of account to be set (usually first one is `1`).

Ground rules
------------

[](#ground-rules)

- Registering account requires its email address to be in one of the provided domains. If you want to change this behavior you must prepare your own code. Current implementation is at `/src/models/RegisterForm.php` and `/src/views/site/register.php`.
- Session can be started at any time but it must be ended not overlapping any other ended session.
- There can be many sessions in one day.
- Session can not be longer than midnight.
- Not ended sessions not count for work hours.
- Off-time must not overlap any other off-time period.
- Holidays are automatically fetched from `https://www.kalendarzswiat.pl` which is Polish holiday list. If you want to use something different you must prepare your own code for this. Current implementation is at `/src/models/Holiday.php`.

Features
--------

[](#features)

- account registration
- password reset
- profile update
- themes
- signing in with login or PIN
- session time with note
- off-time with note
- session and off-time history
- calendar
- holidays
- admin section
- REST API
- Bootstrap 4 layout

New in 2.3.0
------------

[](#new-in-230)

- vacations requests
- projects
- sessions time CSV download for admins
- deactivating accounts for admins

Upgrading from 2.2.1 to 2.3.0
-----------------------------

[](#upgrading-from-221-to-230)

1. Update all the project files to match the repository.
2. Apply migrations by running in console `php yii migrate`.

General help
------------

[](#general-help)

Read [TimeClock Wiki](https://github.com/bizley/timeclock/wiki) first.

For anything related to Yii go to the [Yii 2 Guide](https://www.yiiframework.com/doc/guide/2.0/en).
I really don't want to point obvious links with solutions from there.

Usage of this project
---------------------

[](#usage-of-this-project)

You can use this project in whatever way you like as long as you mention where did you get it from.

Screenshots
-----------

[](#screenshots)

[![screen2](https://camo.githubusercontent.com/2411fd550d8b24c945d659e3fbeccab6b043bb35990568e230307445516a444d/68747470733a2f2f62697a6c65792e6769746875622e696f2f74696d65636c6f636b2f74632d6c696768742e706e67)](https://camo.githubusercontent.com/2411fd550d8b24c945d659e3fbeccab6b043bb35990568e230307445516a444d/68747470733a2f2f62697a6c65792e6769746875622e696f2f74696d65636c6f636b2f74632d6c696768742e706e67)

[![screen3](https://camo.githubusercontent.com/7f326bbe759da6aa931af8fcbac1bbbe4e0ae9074a99c98a2c0b3783a23faf68/68747470733a2f2f62697a6c65792e6769746875622e696f2f74696d65636c6f636b2f74632d73756e6c696768742e706e67)](https://camo.githubusercontent.com/7f326bbe759da6aa931af8fcbac1bbbe4e0ae9074a99c98a2c0b3783a23faf68/68747470733a2f2f62697a6c65792e6769746875622e696f2f74696d65636c6f636b2f74632d73756e6c696768742e706e67)

[![screen4](https://camo.githubusercontent.com/ab17f9e3f7d2e749e76517bfbba3bbfaf2354b222b6e35ea8cb0660e8efbbd87/68747470733a2f2f62697a6c65792e6769746875622e696f2f74696d65636c6f636b2f74632d686973746f72792e706e67)](https://camo.githubusercontent.com/ab17f9e3f7d2e749e76517bfbba3bbfaf2354b222b6e35ea8cb0660e8efbbd87/68747470733a2f2f62697a6c65792e6769746875622e696f2f74696d65636c6f636b2f74632d686973746f72792e706e67)

[![screen5](https://camo.githubusercontent.com/15375ed10aca07deed3988f8f0992bd421e4a48030feddbe95149d48a2c48f5c/68747470733a2f2f62697a6c65792e6769746875622e696f2f74696d65636c6f636b2f74632d63616c656e6461722e706e67)](https://camo.githubusercontent.com/15375ed10aca07deed3988f8f0992bd421e4a48030feddbe95149d48a2c48f5c/68747470733a2f2f62697a6c65792e6769746875622e696f2f74696d65636c6f636b2f74632d63616c656e6461722e706e67)

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance48

Moderate activity, may be stable

Popularity25

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 71.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~36 days

Recently: every ~163 days

Total

21

Last Release

1981d ago

Major Versions

1.7.2 → 2.0.02019-02-04

PHP version history (3 changes)1.0PHP >=7.1.0

2.4.0PHP ^7.1

2.4.1PHP >=7.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/b33b799410f9cb8d69a27bce7ae65d5c0a0aa8e097b2624c2f5315400d653b38?d=identicon)[bizley](/maintainers/bizley)

---

Top Contributors

[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (51 commits)")[![bizley](https://avatars.githubusercontent.com/u/8577314?v=4)](https://github.com/bizley "bizley (15 commits)")[![hunwalk](https://avatars.githubusercontent.com/u/32835435?v=4)](https://github.com/hunwalk "hunwalk (3 commits)")[![rNiedzwiecki](https://avatars.githubusercontent.com/u/7619981?v=4)](https://github.com/rNiedzwiecki "rNiedzwiecki (2 commits)")

---

Tags

clockhacktoberfestholidaysregistertimeclockworkyii

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bizley-timeclock/health.svg)

```
[![Health](https://phpackages.com/badges/bizley-timeclock/health.svg)](https://phpackages.com/packages/bizley-timeclock)
```

###  Alternatives

[hail812/yii2-adminlte-widgets

yii2 adminlte widgets

10246.8k4](/packages/hail812-yii2-adminlte-widgets)[abhi1693/yii2-sms

Send Free Sms for Yii2

171.9k](/packages/abhi1693-yii2-sms)[simialbi/yii2-kanban

Kanban board module for yii2

111.1k1](/packages/simialbi-yii2-kanban)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)