Title: @1 Helpdesk XP: Script installation
Steps of installing the script.
==============================================================
VERSION 3.0 (PHP +MySQL)
==============================================================
INSTALLATION
============
1. Create a folder called "helpdesk" under the root directory. Copy all folders/files
in "root/helpdesk" of the ZIP file to this folder.
2. Chmod the folder "upload" to 777.
3. Create a folder called "db" outside the root, chmod to 777.
4. Upload the file "master.db" to the "db" folder and chmod to 777.
5. Copy "quotes.txt" to "db" folder. Leave it at default chmod value.
5. Configure the variables in /helpdesk/lib/lib.php
6. For New Installation:
Upload and execute "setupmysql.php" (must be in the "helpdesk" folder). This will
setup the required mySQL tables. If the table creation is successful, you will get
the message "Helpdesk tables created in database". Once the tables are setup,
delete the file "setupmysql.php". After that, delete "setupmysql.php".
Four tables will be created:
- helpdesk_admins
- helpdesk_categories
- helpdesk_tickets
- helpdesk_ticketsWhole
For Update from Version 2.02:
Do not execute "setupmysql.php". Execute "update.php" instead. Then delete it.
Once updated, the old tickets are compatible with the new systems. You can continue
viewing/editing/deleting those old tickets. The only feature not supported is
"ticket re-categorizing" (resulted in broken links of old attachments).
EXECUTION
=========
1. Execute /helpdesk/hd.users.php for Master Admin Interface:
- Default login: "master/password"
- Please change password after login
2. Execute /helpdesk/hd.admin.php for General Admin Interface. Remember to create
sub-admin accounts from the Master Admin Interface (Step 1 above) before you
login at General Admin Interface.
3. Execute /helpdesk/hd.client.php for Client Interface
4. Execute /helpdesk/hd.client.php?action=view.ticket for Visitor Login Form
Fine-tuning:
============
1) You may setup your own web themes by editing any of the *.tmpl files under the "tmpl" folder.
2) We urge you not to remove the UPOINT link as we need more fund to further improve this script. After all we have put it in the smallest font and it does not look unsightly.
Others:
=======
1) No backslash is required before the "@" for the variable:
$config["notification.email"] = "admin@yourdomain.com";
... and not:
$config["notification.email"] = "admin/@yourdomain.com";
Tips:
=====
- <?php $dirr=$config["tmpl.path"]."/header.tmpl.inc"; include ($dirr);?>
- <?php $dirr=$config["tmpl.path"]."/footer.tmpl.inc"; include ($dirr);?>
In the template files, the header and footer are grabbed at the lines above.
(a) It would be good to remove these lines from the templates of the admin interface
if your web theme has left or right colums. This way, the templates would not be
used and you can have a broader view under the admin interface.
(b) You can also maintain two themes for the Helpdesk - one for the user interface
and one for admin interface. Simply change "header.tmpl.inc" to "header2.tmpl.inc"
in the lines above (same for footer) and duplicate the template files and modify.
==============================================================
VERSION 1.2 (Perl)
==============================================================
Installation:
1) If necessary, change the path to Perl (#!/usr/bin/perl) pointing to Perl's path in your environment ('which perl' from the command-line will tell you what to use here). The most commonly used for Unix/Linux/BSD are:
#!/usr/bin/perl
#!/usr/local/bin/perl
2) The only configuration: Please set the variables in the file "lib.inc". This file can be found in the "lib" folder under "cgi-bin".
3) Remember to create the folder "WPLab" and upload the file inside it accordingly.
4) Create folders with the same names and structure as in the ZIP file. Upload all files accordingly. Make sure that the "db" folder is **outside** the root directory (for security sake). If you are using Unix/Linux/BSD, upload all the ".htaccess" files too (the ".htaccess" files are not needed under Windows). These files tell the server to redirect the visitors to certain pages if they are pointing to a folder. This way, the files in the folder will not be revealed.
The default folders are:
www.yourdomain.com/cgi-bin/helpdesk (chmod: default)
www.yourdomain.com/cgi-bin/helpdesk/lib (chmod: default)
www.yourdomain.com/cgi-bin/helpdesk/lib/WPLab (chmod: default)
www.yourdomain.com/helpdesk (chmod: 777)
www.yourdomain.com/helpdesk/css (chmod: default)
www.yourdomain.com/helpdesk/gfx (chmod: default)
www.yourdomain.com/helpdesk/upload (chmod: 777)
www.yourdomain.com/helpdesk/tmpl (chmod: default)
www.yourdomain.com/helpdesk/tmpl/admin (chmod: default)
www.yourdomain.com/helpdesk/tmpl/client (chmod: default)
www.yourdomain.com/helpdesk/tmpl/users (chmod: default)
lastly, the "db" folder outside your root (chmod: 777)
5) Chmod the following files and folders leave the rest at their default values:
Folders:
- See above for the chmod values
Files:
- master.db (777)
- hd.admin.cgi (755)
- hd.client.cgi (755)
- hd.users.cgi (755)
Running the scripts:
1) To enter the Master User interface, point to the file "hd.users.cgi". The default username and password are "master" and "password" respectively. You may change the password once you are inside.
From here, you may create multiple accounts for your administrators. For example: james/JM13823/James Anderson , mary/MM9483/Mary Raffles
2) To enter the Admin interface, point to the file "hd.admin.cgi". Then login using the login info you created in step 1) above. For example, james/JM13823/James Anderson
3) To go to the contact form, point to the file "hd.client.cgi".
4) To go to the visitor login form, point to "hd.client.cgi?action=view.ticket".
Fine-tuning:
You may setup your own web themes by editing any of the *.tmpl files under the "tmpl" folder.
Powered by Document Publisher |
