WeQuest
simple tiny
chat-like system

Version   1 • 2
( A Zeta Version )

WeQuest is an open-source simple tiny chat-like system that provides live customer support directly from your website, so you can give one-on-one help in real-time, adding the human touch to your website. WeQuest is written in the PHP programming language and uses AJAX. WeQuest uses plain flat files with no need for database services like MySQL, etc.

(WeQuest — we quest — wee quest — request)


Features:
  • Real-time Chats
    • actually you don't talk, you type
  • Multiple Chat Requests
    • operator can chat with several clients
  • Notify When Party Responds
    • operator & client get visual & sound signals
  • Leave Message If Not Live
    • allow email if operator not available
  • Email Log Of Messages
    • send a record of the conversation
  • Operator Master Log
    • keep a record of all conversations
  • Canned Responses On Operator Console
    • provide facilities for canned responses
  • Capture Visitor Data And Refer URL
    • client browser and web page viewed
  • Fuss-Free Client Naming
    • client name is appended with IP address
  • Configuration Options
    • colors, table sizes, refresh rate, etc.


Installation:
  • Get WeQuest.zip: right-click here (use Save Target As)
  • Get WeQuest.md5: right-click here (use Save Target As) and verify.
  • Make a folder at your web site (name it "WeQuest").
  • Extract files from WeQuest.zip to that folder.
  • Run WeQuest/secure/setup.php?c=abcdjklm to customize.
  • Run WeQuest.htm to confirm installation.
  • Look at the WeQuest.htm code for coding ideas for your web site.



Operation:
  • If you need operating instructions I failed the interface design.
    Everything you need to know should be on the screen.
    Nevertheless, here are some pointers:
    • Use setup.php to change password, title, email, etc.
    • Use WeQuest.php with password to be the operator.
    • Put on your pages links to WeQuest.php for client access.
      See the WeQuest.htm source for coding example.
  • Okay, there is one topic needing explanation.
    There are two links at the bottom of the operator console.
    • Save and Clear Logs
      This function will move ended conversations (where the operator had the last word) to the secure/log.txt file.
    • View Log
      This function displays the secure/log.txt file in the text box above. You could then email it to yourself.


Considerations:
  • Edit secure/canned.txt with your common responses.
    • Put a blank line between each response.
  • More sounds.zip
    • Right-click here (use Save Target As).
  • Note: Depending on your server:
    • Permanently allow write access to the secure folder.
    • While using setup, allow write access to these files:
      WeQuest.htm
      WeQuest.php
      WeQuestS.php
      WeQuestI.php
  • Note the '.htaccess' files in the 'clients' and 'secure' folders.
    These should prevent unauthorized access to *.txt files.


References:


Files in the WeQuest.zip archive file:
  • programs/pages
    index.htm - This page.
    WeQuest.htm - Sample code for implementation ideas.
    WeQuest.php - Operator and client consoles.
    WeQuestI.php - Delivers image to indicate online or offline.
    WeQuestS.php - Provides AJAX services.
    secure/setup.php - Configuration options setup console.
  • images
    away.gif CatMouse.gif offline.gif online.gif
  • flags
    secure/offline.txt secure/online.txt
  • sounds
    cellular.wav doorbell.wav receive.wav ringin.wav sparkle.wav
  • text
    secure/canned.txt secure/clients.txt secure/log.txt
  • security
    clients/.htaccess secure/.htaccess


Files in the sounds.zip archive file:
  • sounds
    button.wav buttondroop.wav buttonzip.wav cartoonphone.wav cellphone.wav dialtone.wav doorbell1.wav doorbell2.wav doorbell3.wav offhook.wav phonebz.wav phonering.wav pop.wav ring.wav ringph.wav splat.wav waterdrip.wav

Just Add Common Sense
You alone are responsible for your life.
Please use with wisdom.
All this stuff is free, as in free speech and free beer.
Consider the GNU General Public License, OSDL Linux Legal Defense Fund, etc.
If you need help, I'm available for a price.
Help me help you. Help me pay for this web site. Donate, tribute, whatever by PayPal.

This Copyleft is a license granting you the rights to use, modify, translate and disseminate the copyrighted work, or any work derived from it, including all representations of the work, permitting additional Copyleft Copyright notices and remuneration for distribution of the work and for services relating to use of the work, and MAKES NO WARRANTY, ASSURANCE NOR GUARANTEE AS TO USEFULNESS OR CORRECTNESS, as such is the duty of whoever uses or services the work. This license does not put the work into the public domain. Where this license is prohibited by law or otherwise changed, the work shall be considered Copyright © 2006 John G. Derrickson with All Rights Reserved.

PayPal is a registered trademark of PayPal, Inc. PayPal is a payment service with no partnership, joint venture, employee-employer or franchiser-franchisee relationship with this system.

Copyleft Copyright © 2006 John G. Derrickson
freeVEDA.org/copyleftJGD@freeVEDA.org
2006 0802 2006