osFaq v1.0.RC2 Install Guide


INDEX:
Requirements
Install
Setup SEO Friendly URLs (optional)


Requirements

You must have osTicket v1.6.RC5 or newer installed.


v1.0 RC2 – Install

  1. Download

    the osFaq files here: osFaq Download

  2. Extract

    the compressed download and upload the contents of the upload/ folder to your osTicket directory. EG: the same directory you installed osTicket in.

  3. Offline mode

    Its recommended to set your osTicket site to offline mode before continuing.

  4. Integrate osFaq into the osTicket staff area.

    The osFaq installer can also guide you through this process.

    Edit: [your-osTicket-installation]/include/staff/header.inc.php

    and paste the following text between the ‹head› and ‹/head› tags, preferably below the other stylesheet imports:

    Edit [your-osTicket-installation]/include/class.nav.php

    and paste the following below the “My Account” tab in the function StaffNav (after line 42 approx.):

    ie:

  5. Integrate osFaq into the osTicket client area.

    The osFaq installer can also guide you through this process.

    Edit [your-osTicket-installation]/include/client/header.inc.php

    and paste the following text between the ‹head› and ‹/head› tags, preferably below the other stylesheet imports:

    Edit [your-osTicket-installation]/include/client/header.inc.php

    and paste the following text between the ‹ul id="nav"› and ‹/ul› tags, preferably directly under the opening ‹ul id="nav"› tag

    (the link will appear as the far right header link):

    ie:

  6. Run the osFaq Installer:

    In a new browser window, goto: http://[your-osTicket-directory]/faq/setup/

    • Choose from Install.
    • The installer will install the osFaq RC2 database tables in your existing osTicket database. Your current osTicket table prefix will be used.
    • Following the database setup the installer will guide you through any incomplete integration steps (listed above).
    • Once finished your new osFaq installation is ready to use.
  7. Online mode

    You can turn your osTicket site back online now.


Setup SEO Friendly URLs (optional)

In the upload/ folder you received in the osFAQ download there was an OPTIONAL file included called OPTIONAL.htaccess

It contains some optional apache code and allows the FAQ system to use Search Engine Friendly URLs in client pages.

Check your server to see if it already has a [your-osTicket-directory]/.htaccess file. If it does, copy the contents of OPTIONAL.htaccess and paste it below the existing content in your .htaccess file.

If there is no [your-osTicket-directory]/.htaccess file, rename OPTIONAL.htaccess to .htaccess

IMPORTANT: Make sure you change the RewriteBase to match your installation of osTicket EG: the place you installed osTicket to where your .htaccess file is located (mentioned above).

Where /support/ is the RewriteBase of your osTicket installation.