README

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

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

Description

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.

Documentation

• Installation
• Utilities
• Updating
• Docker

Quick Start using Docker

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

• Prerequisites:
  • a copy of the ClientCal source (i.e...)

  git clone git@github.com:katmore/clientcal.git

  • a recent version of docker
  • a recent version of docker-compose
• Start containers and configure ClientCal

  $ cd docker/compose/clientcal
  $ docker-compose build
  $ docker-compose start
  $ docker-compose exec php-fpm /var/www/clientcal/bin/web-user.php add

• That's it! Ready to view in browser at: http://localhost:8080

Quick Start without Docker

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

• Prerequisites:
  • a copy of the ClientCal source (i.e...)

  git clone git@github.com:katmore/clientcal.git

  • PHP 7.2
  • a recent version of composer
  • a web server provisioned with a "Document Root" pointing to the ClientCal web root (clientcal/web)
  • a recent version of MySQL provisioned an empty database and a user with access to that database
• Configure ClientCal

  composer update

  php bin/config-update.php

  php bin/db-update.php

  php bin/web-user.php add my_user

• All done! Ready to view in a browser using your web server's URL.

Screenshots

See the Screenshots section of the ClientCal homepage.

Related Resources

• 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
• Support/Bugs: https://github.com/katmore/clientcal/issues

Legal

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-2023, Paul Douglas Bird II. All rights reserved.