[ ExoCrew Home ]     [ Forums ]     [ PHP Scripts ]     [ Contact Us ]


Congratulations on getting ExoPHPDesk!,

The setup is really very simple, with all automated steps.

Current Version : 1.2.1

REQUIREMENTS:


Operating Systems Tested : Linux And Windows®

- PHP 4.2.2+
- mySQL 3 or 4 (Tested with 3.23.* and 4.0.*!! Not tested with MySQL 5.0)
- Apache 1.3.x+
- PHP compiled with IMAP support if you want to use mail fetching feature.
- Linux if you want to use the mail piping feature.

- If on Windows with IIS:
  º IIS 5 or Higher with PHP SAPI module.
  º All Verbs enabled for PHP extension.

INSTALLATION:

Note: You don't need to chmod on Windows ®.

Upload all files using your FTP. Chmod the main directory in which ExoPHPDesk exists, the Chat Logs directory( default "logs") to 0777.

Go to yourdomain.com/directory/install.php where yourdomain.com is your domain and directory is the directory in which ExoPHPDesk exists in.

If you are installing the ExoPHPDesk in the main directory of your site, then you may not be able to Chmod the main directory, in that case the automated script wont be able to make the required files. The workout for it is to move the db_conf.php from the extras directory to the main directory and change the mySQL configurations in it.

Delete the install.php file after installation is completed.

Configuring Email Piping With Sendmail :

------------------------------------------------
Linux RedHat (Default) :
------------------------------------------------

- Open /etc/aliases
- Move to bottom of the file and add a line :

support: "|/path/to/exophpdesk/pipe.php"

Replace support with the mail you want piped, for example you want any mail sent to support@yourdomain.com to be converted into a ticket, then use support.

- Run a command :

#newaliases

Completed.

------------------------------------------------
Linux RedHat  ( ENSIM Installed ) :
------------------------------------------------

- Type in the following commands:

cd /home/virtual/yoursite.com/etc/smrsh/

ln -s /usr/bin/php php

ln -s /var/www/html/exophpdesk/pipe.php pipe.php

- Open /home/virtual/yoursite.com/etc/aliases
- Move to bottom of the file and add a line :

support: "|/etc/smrsh/php /var/www/html/exophpdesk/pipe.php"

Replace support with the mail you want piped, for example you want any mail sent to support@yourdomain.com to be converted into a ticket, then use support.

- Run a command :

#newaliases

Completed.
------------------------------------------------
Linux Redhat ( cPanel Installed ):
------------------------------------------------

- Login to cPanel.
- Go to Mail Settings.
- Create a mail forwarder with forwarding path as :
| /home/USERNAME/public_html/exophpdesk/pipe.php
- Chmod the file pipe.php to 0777.

Completed.

Now test the email piping feature by sending an email to the address you setup mail piping for.
----------------------

Running the Server Status Script:

------------------------------------------------
Linux RedHat:
------------------------------------------------

You should create a cronjob to run the script every 5 mins ( or as you desire to check the server status, keep it high on low end servers ). You must define the full path to file 'server.php' to run it and in some case it may require chmoding the file server.php to 0777.

------------------------------------------------
Windows:
------------------------------------------------

Under windows environment you must create a scheduled task to run the script.

Follow the instructions below:
1. Start -> Programs -> Accessories -> System Tools -> Scheduled Tasks -> Add Scheduled Task.
2. Next -> Browse -> Select php.exe ( php executable binary ) -> Daily -> Next -> Next -> Enter your account password -> Check "Open Advanced Properties for this task when I click Finish" -> Finish.
3. Replace
C:\php\php.exe ( path to php.exe file )
With
C:\php\php.exe C:\WEB_FOLDER\exophpdesk\server.php
You must edit the paths to suit your environment.
4. Schedule ( TAB ) -> Advanced -> Check "Repeat Task" -> Every : ( select 5 or as you desire ) -> Check "If the task is still running, stop it at this time" -> OK -> Apply -> OK.

--------------------------------------------

Just go through all the steps and it will be installed. Look at bottom for contact information, incase you run into a problem.

UPGRADING


v1.2 Final -> 1.2.1 Upgrade
Sorry but a lot of files have been edited, so you will have to upload/replace all files. For templates, tpl/*/tickets.tpl, tpl/*/configs.tpl, tpl/*/style.css, tpl/*/header.tpl, tpl/*/admin_head.tpl were edited.

Move the file upgrade10.php in the main directory and run it from the browser.

v1.2* -> 1.2 Final Upgrade
Upload/Replace the following files:
conf.php, common.php, admin.php, pipe.php, libs/ticket.php, tpl/*/login.tpl, class/imap.php, class/class.php, class/kb.php

Move the file upgrade9.php in the main directory and run it from the browser.

v1.1* -> 1.2 Beta 1 Upgrade
Upload/Replace the following files:
admin.php, common.php, conf.php, footer.php, index.php, member.php, pipe.php, staff.php
tpl/*/add.tpl, tpl/*/admin_head.tpl, tpl/*/configs.tpl, tpl/*/footer.tpl, tpl/*/kb.tpl, tpl/*/list.tpl, tpl/*/lost_pass.tpl, tpl/*/mail.tpl, tpl/*/member_head.tpl, tpl/*/search.tpl, tpl/*/staff_head.tpl, tpl/*/view.tpl, tpl/*/style.css
libs/search.php, libs/ticket.php, libs/troubles.php, libs/calender.php, lang/lang_en.php
class/class.php, class/imap.php, class/kb.php

Move the file upgrade8.php to the main directory an run it from your browser.

v1.0 -> 1.1 Beta 1 Upgrade
Upload/Replace all system files. Upload following template files ( tpl/* ):
add.tpl, search.tpl, member_head.tpl, staff_head.tpl, admin_head.tpl, profile.tpl, tickets.tpl, login.tpl, login_admin.tpl, view.tpl, statistics.tpl
Move the file upgrade7.php to the main directory an run it from your browser.

v1.0* -> 1.0 Beta 2 Upgrade
Replace following files:
class/kb.php, class/class.php, conf.php

Run the following SQL query to fix a bug existing in the v1.0 beta.
ALTER TABLE `phpdesk_staff` ADD `rating` VARCHAR(255) NOT NULL

v0.6* -> 1.0 Beta 1 Upgrade
Delete all the old files/directories except the logs directory and the db_conf.php file. Upload all the extracted files, move the file upgrades/upgrade6.php to main directory and run the file using browser.

Login to administration area and edit the configs.

v0.6* -> 0.6 Beta 2 Upgrade
Execute this query:
ALTER TABLE `phpdesk_staff` ADD `rating` VARCHAR(255) NOT NULL


Replace Files :
tpl/****/search_results.tpl

v0.5* -> 0.6 Beta 1 Upgrade
Upload / Replace all the files.
Move the upgrade5.php file from upgrades directory to main directory and run the script upgrade5.php to upgrade.
Changed Skin Files: admin_head.tpl, member_head.tpl, staff_head.tpl, login.tpl, add.tpl, list.tpl, kb.tpl, kb_view.tpl, login.tpl, view_ticket.tpl, style.css

v0.5* -> 0.5 Beta 2 Upgrade
Replace Files:
'conf.php', 'common.php'

v0.4* -> 0.5 Beta 1 Upgrade
Upload/Replace all files.
Move the upgrade5.php file from upgrades directory to main directory and run the script upgrade4.php to upgrade to version 0.5 Beta1.

v0.4* -> 0.4 Final Upgrade
Replace files:
'index.php' , 'admin.php' , 'staff.php', 'class/imap.php', 'conf.php'

v0.3* -> 0.4 Beta 1 Upgrade
Upload/Replace all the files.
Move the upgrade5.php file from upgrades directory to main directory and run the script upgrade3.php to upgrade to version 0.4 beta1.

v0.2* -> 0.3 Final Upgrade
Upload/Replace all the files.
Move the upgrade5.php file from upgrades directory to main directory and run the script upgrade2.php to upgrade to version 0.3 Final.

v0.1* -> 0.2 Final Upgrade
Upload/Replace all the files.
Move the upgrade5.php file from upgrades directory to main directory and run the script upgrade1.php to upgrade to version 0.2 Final.

FEATURES:

- Easy customization, by editing the templates to suit your site
- Easy Installation through Automated steps
- Administrator, Staff, Member Area
- Fast And Easy Live Chat
- Specify the viewable Tickets / Page
- Fetch mail through IMAP/POP3 and convert to tickets (For Windows)
- Knowledge Base
- Live Server Status
- Unlimited Trouble Shooters
- Mail Piping ( For Linux Users )
- Built-in Calender

Admin Area
- View/Add/Edit/Delete/Email/Suspend Members
- View/Add/Edit/Delete/Email Staff
- View/Add/Edit/Delete/Email Administrators
- Change Configurations
- Edit Own Profile
- Add/Edit/Delete Groups (a.k.a. Departments)
- View tickets statistics
- Send/View Private Messages
- Open Close Registrations
- Open/Close/Edit Tickets
- Edit/Add/Delete Responses
- Live Chat Responder
- Add/Edit Custom Fields for Tickets
- Add/Edit/Delete F.A.Q. in knowledge base
- Add/Edit/Delete Staff Notes
- Add/Edit/Delete Servers
- Add/Edit/Delete TroubleShooters
- Add/Edit/Delete KB Groups
- Add/Edit/Use Saved Responses
- Add/Edit/Delete Announcements
- Assign Tickets To Staff
- Add/Edit Text in Personal Diary.
- Add/Edit/Delete Calender Events.
- Backup Database.

Staff Area
- Edit/Open/Close Tickets
- Create New Tickets
- Add/Edit Responses
- Take Ownership of Tickets
- Send/View Private Messages
- Live Chat Responder
- Edit Own Profile
- Add/Edit F.A.Q.
- Delete Own F.A.Q.
- Add/Edit/Delete Own Notes.
- View Server Status
- Use Troubleshooters
- Add/Edit Saved Responses
- Use Saved Responses ( Where Allowed )
- Add/Edit/Delete Announcements ( If Allowed )
- Add/Edit Text in Personal Diary.
- Add/Edit/Delete Calender Events.

Member Area
- Edit/Open/Close Own Tickets
- Create New Tickets
- Add/Edit Responses
- Send/View Private Messages
- Live Chat with Staff/Admin
- Edit Own Profile
- Search Tickets
- View Server Status (If Allowed)
- Use Troubleshooters
- Rate Staff and F.A.Q.( 0 - 5 )
- View Announcements ( Where Allowed )
- Attach Files with Tickets ( If Allowed )
- Add/Edit/Delete Calender Events.

If you think a feature required is missing, please post at the wish list at our Community Forums.

Credits

Lead Developer: Asad Niazi

Contact Us

The preferred way to contact us is through our Community Forums. Contact through email only if you want to discuss something like partnership, hosting etc.

Forums: http://forums.exocrew.com
E-Mail : exocrew@gmail.com