Skip to content

ancchaimongkon/timegrid

 
 

Repository files navigation

timegrid.io logo

timegrid

Online reservation of services for business. Made easy.

Build Status Code Climate Test Coverage Version Stage ES User Manual License

The problem

Small and medium scale businesses wish to provide online service booking for their customers, but the tools out there are either too expensive or too complex for their needs.

The Solution

Timegrid is a single platform holding all businesses and customers while letting them an affordable and easy to use way to interact. Useful, Simple, Fast.

It is made under the Laravel 5.1 (LTS) framework for PHP.

Screenshots

Screenshot

Wanna see more?

Live Demo

Want action? Try the beta live demo

Hint: To know which commit is installed in demo you can hover the cursor on the leftmost timegrid.io label in the footer of the app.

Now... Hold on tight! It's a bumpy ride for all of us!

Features

Implemented

  • User regular and oAuth2 SignUp
  • Business management
    • Contact addressbook
    • Services management
    • Availability management
  • Service Reservation
  • Local Search

Future

  • Add SMS alerts
  • Add automatic vacancy handling
  • Support for Themes
  • Support for more industry sectors reservation strategies
  • Users reputation
  • ...and more

Official Documentation

  • English Documentation Status English
  • Spanish Documentation Status Español

You are welcome to contribute.


How to install:

Step 1: Get the code - Clone the repository

git clone https://github.com/alariva/timegrid.git

If you want to stand on the latest beta-stable version:

cd timegrid

git checkout tags/v3.5.0-15120502-beta

Step 2: Use Composer to install dependencies

composer install

Step 3: Create database

If you finished first three steps, now you can create database on your database server(MySQL). You must create database with utf-8 collation(uft8_general_ci), to install and application work perfectly. After that, copy .env.example and rename it as .env and put connection and change default database connection name, only database connection, put name database, database username and password.


Step 4: Configure environment

Copy the .env.example file to .env

cp .env.example .env

Set the application key

php artisan key:generate

Edit all the Primary section parameters (for local/test/development environment)

Change the storage path in .env file to a writeable location

STORAGE_PATH=/home/username/timegrid/storage

For local environment you will need to comment out APP_DOMAIN, to keep it null

#APP_DOMAIN=

Back to your console, migrate database schema

php artisan migrate

Populate database:

php artisan db:seed

Update geoip database:

php artisan geoip:update

You should be ready to go, now run the server:

php artisan serve

Type on web browser:

http://localhost:8000/

Step 5: Start Page

Congrats! You can now register as new user and log-in.

timegrid Login Screen

Demo Sandbox Fixture

If you want to try the application with a Lorem Ipsum database fixture.

php artisan db:seed --class=TestingDatabaseSeeder

Now you have two demo credentials to log in and play around.

USER: demo@timegrid.io
PASS: demomanager

USER: guest@example.org
PASS: demoguest

Troubleshooting

I'd like to hear your feedback.

Let me know if you are facing any inconvenients to install, as I'm working on bringing a more comprehensive installation guide assessing common problems.

Contributing

Thank you for considering contributing to Timegrid.

Is it your first time ? Are you new to Laravel or PHP or Github ?

If you are willing to do your first time contribution, don't worry, you are welcome here.

While there is no strict guideline right now, you are welcome to bring your ideas to enhance the code as well as the process.

As a rule of the thumb, keep PSR-2 and tests in mind.

Anyway, contact me and we will figure out your first steps into contributing :)

Trello board for development roadmap

Dev Newsletter

Join the chat at https://gitter.im/alariva/timegridDevelopment

Special Thanks

  • PeGa! for infra support

License

Timegrid is open-sourced software licensed under the AGPL

About

Free, open-source, self-hosted online reservation platform based on the Laravel PHP Framework.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 99.8%
  • Other 0.2%