User Login    
 + Register
Bookmark and Share
  • Main navigation


Remember me

Lost Password?

Register now!
Project: xHelp
Summary   News   Forums   Trackers   Bugs   Support  
Patches   Features   Docs   Files   CVS  

Release Name: 0.78 Beta


Module Purpose ----------------------------------------------------------------------- xhelp is designed as a user-friendly helpdesk application for the XOOPS portal system. Installation Requirements ----------------------------------------------------------------------- XOOPS 2.0.6+ Enabling Email Support Requires adds these requirements: POP3 Email account(s) Ability to create a cron job or scheduled task Installation Instructions ----------------------------------------------------------------------- Unzip archive to 'modules' directory. Install application using XOOPS module administration panel. Adjust module preferences as necessary. Add ticket departments (categories). Setup XOOPS user accounts that represent helpdesk staff members. Follow steps in "Block Styles" section of this document All Set!!! Upgrade Instructions ----------------------------------------------------------------------- Unzip archive to 'modules' directory. Update module through XOOPS module administration panel. Click on 'Check Tables' from the xhelp Main Menu, or the pop-up menu. Adjust module preferences as necessary. Follow steps in "Block Styles" section of this document. Templates in 0.75 have changed significantly. If you are running a custom template set, you will need to remove them and Generate the new templates. All Set!!! Block Styles ----------------------------------------------------------------------- xHelp 0.7 adds the ability to flag a ticket as overdue. To see this flag in the xhelp blocks (My Tickets, Recently Viewed Tickets) you will need to add the following style to your xoops theme's stylesheet: #xhelp_dept_recent li.overdue {background-color:red;} #xhelp_bOpenTickets li.overdue {background-color:red;} In addition we recommend adding these styles to your theme's stylesheet #xhelp_dept_recent li {list-style:none;} #xhelp_bOpenTickets li {list-style:none;} #xhelp_dept_recent ul, #xhelp_dept_recent li {margin:0; padding:0;} #xhelp_bOpenTickets ul, #xhelp_bOpenTickets li {margin:0; padding:0;} #xhelp_dept_recent li {margin:0;padding-left:18px; background:url('../../modules/xhelp/images/ticket-small.png') no-repeat 0 50%; line-height:16px;padding-bottom:2px;} #xhelp_bOpenTickets li {margin:0;padding-left:18px; background:url('../../modules/xhelp/images/ticket-small.png') no-repeat 0 50%; line-height:16px;padding-bottom:2px;} Email Ticket Submission ----------------------------------------------------------------------- To configure email ticket submission some additional steps are necessary. First you need to create a POP3 email account for each department that will receive email. Next, go to "Manage Departments" in the xhelp Admin Panel. Next, edit the department you wish to hold the newly created tickets. Next, Add a new mailbox to monitor: Mailbox Type - currently the only option is POP3. Server - DNS name of mail server (get from your hosting provider) Port - Mail Service Port Number. For POP3 this is usually 110. Username - Username to access mailbox (get from your hosting provider) Password - Password to access mailbox (also get from your hosting provider) Default Ticket Priority - Adjust default priority for incoming tickets. Reply-To Email Address - the email address for this account. Used for handling replies (responses) to tickets. Repeat this process for each mailbox you wish to monitor. Once all mailboxes have been added, you need to setup a scheduled task or a cron job to check these mailboxes on a regular basis. For *nix machines the following crontab line should do the trick: */2 * * * * /usr/bin/wget -q <XOOPS_URL>/modules/xhelp/checkemail.php The above line will check all the configured mailboxes, every other minute. For windows servers you can try using Task Scheduler or runat with this variant: C:\php\php.exe "<XOOPS_ROOT_PATH>\modules\xhelp\checkemail.php" If PHP was installed into a different directory from the default you will need to adjust the path to php.exe accordingly. In addition, there is a version of wget for windows: Unfortunately we cannot support you in the configuration of this scheduled task. Please contact your hosting provider with any questions. License ----------------------------------------------------------------------- GPL see LICENSE.txt Updates, Bugs or Feedback ----------------------------------------------------------------------- For up-to-date versions of this application or to give feedback for the application go to the xhelp development site: Translations ----------------------------------------------------------------------- xHelp not available in your language? Want to help by translating xhelp into your native tongue? Please come to the translators forum on the xhelp development site (url listed above) for more details. Credits and Thanks ----------------------------------------------------------------------- See the about page in xhelp Admin area
Change Log
Changes in 0.78 1. Bug Fix: Notification form broken in profile.php (ackbarr) 2. Bug Fix: Ticket edit form broken (eric_juden) 3. Bug Fix: Missing query constants in constants.php (eric_juden / ackbarr) 4. Bug Fix: Removed debug lines when adding staff member (eric_juden) 5. Bug Fix: Missing constants for email template folder permissions (eric_juden) 6. Bug Fix: Staff member search says "Log for User" (eric_juden) 7. Bug Fix: Custom fields not available to event handlers during new_ticket event (ackbarr) Changes in 0.77 1. Bug Fix: Inactive user still receives notifications (ackbarr) 2. Bug Fix: Incorrect module paths in notification emails (XOOPS 2.2) (ackbarr) 3. Bug Fix: Ticket actions block missing change department (ackbarr) 4. Bug Fix: Print ticket page - staff usernames not showing for response (ackbarr) 5. Bug Fix: Anonymous Ticket submission blocked for existing email addresses (ackbarr) 6. Bug Fix: Missing DB Indexes, timeout in upgrade procedures (ackbarr / eric_juden) 7. Bug Fix: Update Status Button is misleading (ackbarr / iconeb) 8. Bug Fix: Staff Member always has "Add Response" permissions (ackbarr) 9. Bug Fix: Fatal Error when assigning ticket to other departement (ackbarr) 10. Feature: Upload multiple files simultaneously (eric_juden) 11. Feature: User ability to submit file attachment for responses (eric_juden) 12. Feature: Staff ticket lists (eric_juden) 13. Bug Fix: View All Ticket pages showing statuses for wrong state (eric_juden) 14. Bug Fix: Numeric custom fields displaying improperly (iconeb / eric_juden) Changes in 0.75 1. Ability of staff members to merge tickets (eric_juden) 2. Add custom statuses (eric_juden) 3. XOOPS group permissions for logging tickets in specific departments (eric_juden) 4. Allow more than just the ticket submitter be notified via email of ticket changes (eric_juden) 5. Portugues Language Added (_Vlad_) 6. Ability to give reason for changing status (eric_juden) 7. Ability to activate / deactivate mailboxes (ackbarr) 8. Ability to test mail settings prior to saving (ackbarr) 9. Ability to receive notifications via private message (eric_juden) 10. Able to modify an existing department mailbox (eric_juden) 11. Ability to remove file attachments (eric_juden) 12. Ability of staff members to add a response while adding a ticket (eric_juden) 13. Bug Fix: PEAR installed but not in open_basedir path (ackbarr) 14. Administration UI Cleanup (ackbarr) 15. Bug Fix: Take/Assign Ownership Batch Action not working (eric_juden) 16. Bug Fix: Previous response sometimes displayed in Add Response page (eric_juden) 17. Bug Fix: Announcments list from all categories in News 1.2.1 (eric_juden) 18. Bug Fix: xoops_ smarty tags not filled in print ticket page (eric_juden) 19. Bug Fix: Email sent from one dept mailbox to another causes a loop (ackbarr) 20. Bug Fix: Email Attachments with spaces in filename not stored properly (ackbarr) 21. Ability to set number of characters in open tickets block (marcan) 22. Updates to notification service for removing action submitter from notification (marcan) 23. User avatar displays for ticket responses (marcan) 24. XOOPS 2.2 Compatibility (eric_juden) 25. Ability to manage uploaded files from admin side (eric_juden) 26. Bug Fix: Username not being display for staff ratings on Profile page (eric_juden) 27. Ability to display real name instead of username in module preferences (eric_juden) 28. Uploaded files now display the uploaded filename instead of having the ticketid appended to the ticket (eric_juden) 29. End user can now see ticket id on ticket page (eric_juden) 30. Updated Manage Mimetypes page with better searching (eric_juden) 31. Display users in a department on the Edit Department page (eric_juden) 32. Ability to set department visibility by XOOPS group (eric_juden) 33. Ability to save searches (eric_juden) 34. Patch for Manage staff to display grid view of departments and users (iconeb) 35. Ability to add response to ticket upon ticket creation (eric_juden) 36. Ability to search by one or multiple departments (iconeb) 37. Ability to change department from ticket page (iconeb) 38. Ability for staff to go directly to a ticket if they know the ticket id - in staff header (iconeb) 39. Added xhelp main actions block (iconeb) Changes in 0.71 1. Fixed email activation link not being sent to new users (eric_juden) 2. Fixed uploading files with undefined mimetypes bug (eric_juden) 3. Fixed bug for ticket subject length being too short in edit ticket (eric_juden) 4. Fixed bug for fatal error while in staff profiles (eric_juden) 5. Fixed bug for users being allowed to look at other user's tickets (eric_juden) Changes in 0.7 1. Auto-create user profiles during ticket submission (eric_juden / ackbarr) 2. Improved Form validation during ticket / response submission (eric_juden) 3. Display available filetypes for upload (eric_juden) 4. Customizable Permission roles for staff members (eric_juden) 5. Email template modifications (alanjuden) 6. Highlight overdue tickets (overdue time customizeable in options) (eric_juden) 7. Increased size of ticket subject to 100 characters (eric_juden) 8. Search for tickets by assignment in the staff view all tickets page (ackbarr) 9. Ticket submission via POP3 Email (Nazar Aziz / ackbarr) 10. Ability to set default department (eric_juden) 11. Mail event log to track email submission problems (eric_juden) 12. Changed all database tables to lowercase (eric_juden) 13. PHP 5 support (eric_juden / ackbarr) Changes in 0.6 1. Fixed IP logging of Response Reviews (eric_juden) 2. Javascript selectAll function not selecting pre-selected items (ackbarr) 3. Timespent not being recorded properly (ackbarr) 4. Fixed staff rating of Response Reviews (eric_juden) 5. Fixed rendering of cells in /admin/index.php (ackbarr) 6. Fixed deletion of staff (ackbarr) 7. Fixed priority and department images(eric_juden) 8. Removed pass-by-reference errors in admin/index.php (eric_juden) 9. Ability of staff members to use alternate email address (eric_juden) 10. Improved search (eric_juden) 11. Add option to make a response private (eric_juden) 12. Added more summary stats to admin/index.php - main page (eric_juden) 13. Added Batch Actions: (ackbarr) Set Status Set Department Set Owner Set Priority Delete Add Response 14. Filter By Department, Status in Staff/User View All Tickets page (ackbarr) 15. Sortable columns in Staff/User View All Tickets, Search Results Page (ackbarr) 16. Fixed display of Manage Staff page when site has large # of users. (ackbarr/eric_juden) 17. Fixed Admin menu tabs :hover event in IE (ackbarr) 18. Added Ticket Actions block, new config variable to switch between inline/block action forms (eric_juden) 19. French Language Added (Outch) 20. Brazilian Portugues Language Added (silviotech) 21. "My Submitted Tickets" section added to staff index page 22. Bug fix: fatal error when a submitted user account is deleted Changes in 0.5 Initial Release