Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A livechat application based on Symfony 2, Doctrine 2 ODM

This branch is even with servergrove:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app
src
vendor
web
.gitignore
LICENSE
README.md

README.md

What is ServerGroveLiveChat?

ServerGroveLiveChat is a PHP 5.3 Symfony 2 application that allows website visitors to engage in a web-based chat with operators of a website. It allows a company to offer live chat support.

Requirements

  • PHP 5.3.2 or newer
  • PHP mongo extension
  • MongDB database server
  • jQuery in your website to integrate the livechat button/tracker

Installation

  1. Download application package or clone the repository

  2. Setup a virtual host (optional) and restart web server

    DocumentRoot /usr/local/ServerGroveLiveChat/web ServerName livechat.example.com ErrorLog "logs/livechat-error_log" CustomLog "logs/livechat-access_log" combined AllowOverride All

  3. Make sure web server can write to app/cache and app/logs, ie.:

    chmod -R 777 app/cache app/logs
    
  4. Configure MongoDB connection, by default it will connect with localhost, you can change it by editing app/config/config.yml

    doctrine_odm.mongodb:
      server: mongodb://localhost:27017
    
  5. Configure the livechat caching engine. The application uses a caching engine to store chat status information. By default it will use APC, but you can also use mongo. You can configure it like this in app/config/config.yml:

    sglivechat.config:
      cache_engine: mongo
    
  6. Add a livechat administrator

    ./app/console sglivechat:admin:add-administrator "Your Name" email@example.com password1234
    
  7. Launch launch administration interface and login with the administration information entered in step 6

    http://livechat.example.com/admin/sglivechat
    
  8. Add the livechat button and status indicator to your website:

    In <head>:

    In the location where you want the livechat button to appear:

  9. You can also test the livechat functionality by loading:

    http://livechat.example.com/test.html

Contributing

We encourage people to participate and contribute to the project. Feel free to clone the git repository and send us pull requests. Please contact us before starting a new feature to make sure there is no effort duplication.

Todo

  • Integration with Jabber for new chats alerts
  • Additional documentation
  • Bug fixes
Something went wrong with that request. Please try again.