Scheduling, job, crew, and customer management web application for construction companies.

• Homepage: https://katmore.github.io/clientcal
• Download: .zip file, .tar.gz

ClientCal is a PHP+MySQL based project initially released in 2006 to facilitate the management of customer info, job scheduling, job site info, and work crew scheduling for small to medium sized construction operations (SMBs). As a traditional HTML form based application it has proved to be very stable over the years. I have released this project in preparation for improvements to the UI (to make it mobile friendly) and implementing a RESTful API backend.

• Github: https://github.com/katmore/clientcal
• Packagist: https://packagist.org/packages/katmore/clientcal
• Latest release: https://github.com/katmore/clientcal/releases/latest
• Documentation: https://github.com/katmore/clientcal/wiki

• Installation
• Utilities
• Updating
• Docker

Consult the Docker page of the ClientCal wiki for more information regarding usage with Docker.

• Prerequisites: a recent version of Docker and Docker-compose
• Copy, start, and configure ClientCal

  $ git clone https://github.com/katmore/clientcal.git 
  $ cd clientcal/docker/compose/clientcal
  $ docker-compose build
  $ docker-compose start
  $ docker-compose exec php-fpm /var/www/clientcal/bin/web-user.php add

• Ready to view in browser at: http://localhost:8080

Consult the Installation page of the ClientCal wiki for more detailed instructions.

• Prerequisites: a web server with PHP 7.2, and a running MySQL server

• Prepare a database for "clientcal":

  $ echo 'CREATE DATABASE clientcal' | mysql
  $ MYPASS=$(date +%s | sha256sum | base64 | head -c 32 ; echo)
  $ echo "GRANT ALL ON clientcal.* TO 'clientcal'@'localhost' IDENTIFIED BY '$MYPASS'" | mysql
  $ echo "clientcal mysql password: $MYPASS"

  be sure to take note of the "clientcal mysql password" for the next step

• Copy and configure ClientCal

  $ git clone https://github.com/katmore/clientcal.git 
  $ cd clientcal
  $ composer update
  $ php bin/config-update.php
  $ php bin/db-update.php
  $ php bin/web-user.php add my_user
  $ CLIENTCAL_WEB_ROOT=$(pwd)/web
  $ echo "clientcal web root: $CLIENTCAL_WEB_ROOT"

  be sure to take note of the "clientcal web root" for the next step

• Edit your HTTP server's "Document Root" to be the clientcal web root

  --OR--

• Create a symlink to the clientcal web root on the exiting "Document Root"

  $ ln -s $CLIENTCAL_WEB_ROOT /var/www

See the Screenshots section of the ClientCal homepage.

ClientCal is distributed under the terms and conditions of the MIT license (see LICENSE), or the terms and conditions of the GPLv3 license (see GPLv3).

Copyright (c) 2006-2018, Paul Douglas Bird II. All rights reserved.