PHPackages openskedge/openskedge - 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. openskedge/openskedge AbandonedArchivedProject[Utility & Helpers](/categories/utility) openskedge/openskedge ===================== A flexible employee scheduling application built upon Symfony2. Designed for companies and organizations with fluid shifts. v1.0.0-rc2(11y ago)129339[27 issues](https://github.com/OfficeStack/OpenSkedge/issues)GPL-3.0+PHPPHP >=5.3.10,!=5.3.16 Since Jul 1Pushed 6y agoCompare [ Source](https://github.com/OfficeStack/OpenSkedge)[ Packagist](https://packagist.org/packages/openskedge/openskedge)[ Docs](http://www.openskedge.org)[ RSS](/packages/openskedge-openskedge/feed)WikiDiscussions 1.2.x-dev Synced 1mo ago READMEChangelog (4)Dependencies (23)Versions (9)Used By (0) OpenSkedge ========== [](#openskedge) [![Build Status](https://camo.githubusercontent.com/0e3081a471ca235c3105c1580bc4ae9a5c749e95849b8dbf76760431a5ad4e69/68747470733a2f2f7472617669732d63692e6f72672f4f6666696365537461636b2f4f70656e536b656467652e706e67)](https://travis-ci.org/OfficeStack/OpenSkedge) 1.2.x-dev --------- [](#12x-dev) This is a development branch which will contain lots of refactoring of 1.0.x-dev. Deployment on a Local, VPS/Cloud, or Dedicated host =================================================== [](#deployment-on-a-local-vpscloud-or-dedicated-host) Requirements ------------ [](#requirements) 1. Nginx, Apache, or another web server on \*nix/BSD with rewrite functionality. May work on Windows and Mac, but has not been tested and is not supported. - Nginx users, see [this wiki article](https://github.com/maxfierke/OpenSkedge/wiki/Setting-up-on-Nginx-with-PHP-FPM-on-Linux) for setup. - Apache users, point your document root to web/. The .htaccess should take care of everything. 2. PHP 5.5.x+ 3. PDO-supported database. MySQL/MariaDB suggested. 4. [Composer](http://getcomposer.org) for installing dependencies 5. (optional) Memcached and PHP memcache(d) extension. Installation ------------ [](#installation) 1. Run `php app/check.php` and resolve any errors before doing ANYTHING else. 2. Run `cp app/config/parameters.yml.dist app/config/parameters.yml` - `sender_email` is the email address of the automated email account you want to use. - `secret` is used for CSRF validation. Set this to some random characters. An ideal value would be a random sha256 hash. - The rest of the settings should be pretty self-explainatory. 3. Setup permissions. This will require ACL support of some kind on your file system. Replace `www-data` with your web server user. - If under a host that supports `chmod +a`:``` $ rm -rf app/cache/* $ rm -rf app/logs/* $ sudo chmod +a "www-data allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs $ sudo chmod +a "`whoami` allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs ``` - If under a host that does not, enable ACL support on the filesystem and run the following:``` $ sudo setfacl -R -m u:www-data:rwX -m u:`whoami`:rwX app/cache app/logs $ sudo setfacl -dR -m u:www-data:rwx -m u:`whoami`:rwx app/cache app/logs ``` - If none of the above are available options, add `umask(0002);` to the beginning of app/console, web/app.php, and web/app\_dev.php 4. Run `php composer.phar install --prefer-dist` 5. Run `php app/console doctrine:database:create` if you have not already created a database for OpenSkedge. 6. Run `php app/console doctrine:schema:update --force` 7. Run `php app/console doctrine:fixtures:load` to bootstrap the application with some needed information (groups) and a default admin account with the username `admin` and the password `admin`. 8. Run `php app/console --env=prod cache:clear` to clear and warmup the application's cache. `prod` should be replaced with `dev` if you're running in a development environment. 9. Run `php app/console --env=prod assets:install` to install Assetic assets into the web root. `prod` should be replaced with `dev` if you're running in a development environment. 10. Navigate to the OpenSkedge installation in a browser, login as the bootstrapped admin and **change the password**. 11. Add employees, areas, positions, and schedule periods and get to scheduling! Upgrading --------- [](#upgrading) 1. Run `git pull` to fetch the latest changes to OpenSkedge. If you've made changes to OpenSkedge, you'll either want to stash them or commit them and use `git pull --rebase`. 2. Run `php composer.phar install` 3. Run by using `php app/console doctrine:migrations:migrate`. NOTE: **Only supports MySQL**. This should be pretty safe but if issues occur, you should be able to roll back by migrating down. That said, it's probably best to test the migration on your development server before pushing it to production. Read more about using migrations at [the Doctrine project's docs](http://docs.doctrine-project.org/projects/doctrine-migrations/en/latest/index.html). - If you're on a database other than MySQL such as PostgreSQL, you'll have to adapt the migrations yourself, or risk **potential data loss** and/or application breakage by running `php app/console doctrine:schema:update --force`. 4. Run `php app/console --env=prod cache:clear` to clear and warmup the application's cache. `prod` should be replaced with `dev` if you're running in a development environment. 5. Run `php app/console --env=prod assets:install` to install Assetic assets into the web root. `prod` should be replaced with `dev` if you're running in a development environment. Background Worker / cron jobs ----------------------------- [](#background-worker--cron-jobs) OpenSkedge depends on the use of a background worker or cron jobs to handle things like checking for late employees, archiving time clock records, and dispatching spooled emails. ### Running the background worker [](#running-the-background-worker) This is a naive background worker process using a long-running PHP-CLI process. Historically, PHP has had issues with memory leaks when running for long periods of time, so you may want to either recycle this periodically (using something like supervisord) or opt for using cron. `php app/console openskedge:worker:run` - Checks for late employees, prunes old time clock records, and dispatches spooled emails every 10 minutes ### Commands for cron [](#commands-for-cron) If you're concerned about memory usage with the background worker or need more flexibility in scheduling background tasks, you can also run a few commands on their own & schedule them as cron jobs. `php app/console openskedge:clock:check-late` - Checks for late employees `php app/console openskedge:clock:prune --no-interaction` - Prunes old time clock records (configured in OpenSkedge settings) `php app/console --no-interaction swiftmailer:spool:send` - Dispatches spooled emails. Only needed if Swiftmailer is setup to spool emails (default). FAQ --- [](#faq) ### What is OpenSkedge? [](#what-is-openskedge) OpenSkedge is a reinvention of [Employee Scheduler](http://empscheduler.sourceforge.net), a flexible employee scheduling application designed for companies and organizations (such as education institutions with student workers) which require fluid shift scheduling. ### What is OpenSkedge not? [](#what-is-openskedge-not) OpenSkedge is not a general purpose, or a one-stop everything-but-the-kitchen-sink scheduling application. It's for assigning positions to people at certain times during certain time periods that they have marked themselves available. It won't schedule your meetings. ### Who is behind OpenSkedge? [](#who-is-behind-openskedge) [Max Fierke](https://www.maxfierke.com), a developer and student at the University of Minnesota. He does [a lot of other stuff](https://github.com/maxfierke/) too. He created OpenSkedge during his freshman year. He also has [a site you can go to](https://www.maxfierke.com). License and Copyright --------------------- [](#license-and-copyright) ### License [](#license) OpenSkedge, technically a derivative work of Employee Scheduler, is available under the GNU General Public License version 3 or later. See src/OpenSkedge/AppBundle/Resources/meta/LICENSE for more details. ### Authors and Contributors [](#authors-and-contributors) - Copyright 2012-2015 Max Fierke (@maxfierke) - Copyright 2003 Brigham Young University (For the bits of Employee Scheduler present) ### Projects that OpenSkedge uses [](#projects-that-openskedge-uses) - [Twitter Bootstrap](http://twitter.github.com/bootstrap/index.html) by @twitter - [TODC Bootstrap](https://github.com/todc/todc-bootstrap) by @todc - [TODC Datepicker](https://github.com/todc/todc-datepicker) by @todc - [Colorpicker for Bootstrap](http://www.eyecon.ro/bootstrap-colorpicker/) by Stefan Petre - [TableSorter](http://tablesorter.com/) by [@lovepeacenukes](https://twitter.com/lovepeacenukes) - [Symfony 2.7](http://symfony.com/), [Doctrine](http://www.doctrine-project.org/) and dependencies specified in composer.json ### Thanks to the following Employee Scheduler developers [](#thanks-to-the-following-employee-scheduler-developers) - John Finlay (Developer of Employee Scheduler) - Carl Allen (Developed time clock functionality for the UofMN with Joe Krall) - Joe Krall (Developed time clock functionality for the UofMN with Carl Allen) Contact ------- [](#contact) **Max Fierke** Homepage: [www.maxfierke.com](http://www.maxfierke.com) Twitter: [@m4xm4n](http://twitter.com/m4xm4n) Github: [@maxfierke](https://github.com/maxfierke) ### Health Score 27 — LowBetter than 49% of packages Maintenance16 Infrequent updates — may be unmaintained Popularity21 Limited adoption so far Community14 Small or concentrated contributor base Maturity49 Maturing project, gaining track record Bus Factor1 Top contributor holds 99.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 ~198 days Total 4 Last Release 4110d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/81b49ab2cd06b5f1666439aab5d4b2e2b2120ee870eeed929258ac4aae4c26de?d=identicon)[m4xm4n](/maintainers/m4xm4n) --- Top Contributors [![maxfierke](https://avatars.githubusercontent.com/u/354236?v=4)](https://github.com/maxfierke "maxfierke (652 commits)")[![bitdeli-chef](https://avatars.githubusercontent.com/u/3092978?v=4)](https://github.com/bitdeli-chef "bitdeli-chef (1 commits)") --- Tags employee-schedulingmaintainer-wantedphpemployeeFlexiblescheduling ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/openskedge-openskedge/health.svg) ``` [![Health](https://phpackages.com/badges/openskedge-openskedge/health.svg)](https://phpackages.com/packages/openskedge-openskedge) ``` ### Alternatives [sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M651](/packages/sylius-sylius)[ec-cube/ec-cube EC-CUBE EC open platform. 78527.0k1](/packages/ec-cube-ec-cube)[anime-db/anime-db The application for making home collection anime 252.1k2](/packages/anime-db-anime-db)[claroline/core-bundle Claroline core bundle 165.5k52](/packages/claroline-core-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)