Free Use Edition Documentation
Home | Documentation & Support | Free Use Edition
1.0 Introduction


2.0 System Administration

  2.1 Installation
    2.1.1 Requirements
    2.1.2 Installing and First Run
    2.1.3 Potential Problems

  2.2 User Control

  2.3 Set Security


3.0 User Guide

  3.1 Creating a Set/Questionnaire

  3.2 Managing a Set
    3.2.1 Questions and Options
    3.2.2 Status and Trial Runs
    3.2.3 Publishing Your Set
    3.2.4 Data Integrity Warning

  3.3 Results
    3.3.1 Brief Results Summary
    3.3.2 Simple Results
      3.3.2.1 Simple Text View
      3.3.2.2 Simple Graph View
    3.3.3 Data View Snapshots
      3.3.3.1 Creating a Snapshot
      3.3.3.2 Viewing a Snapshot
      3.3.3.3 Exporting a Snapshot
        3.3.3.3.1 Example Output
    3.3.4 Integrity Warning (Again)
    3.3.5 Saving Your Results

  3.4 User Licence


4.0 Licence


5.0 Contact Developers
<< 2.1.1 Requirements2.1.3 Potential Problems >>

2.1.2 Installing and First Run

Download ViQ from the project homepage (http://viq.purplepixie.org) and unzip the archive into a web-accessible directory.

Edit the file conf/data.inc.php and set the MySQL server, username, password and database to your settings. You may have to create a MySQL database or get access to one. Your ISP will be able to help with this.

Rename the file admin/firstrun-.php to admin/firstrun.php (removing the - sign).

Navigate to http://YOUR_VIQ_URL/admin/firstrun.php and follow the instructions on this page. You will see database tests which indicate if the configuration in conf/data.inc.php is correct and ViQ can connect to the MySQL database. If these fail go no further and check conf/data.inc.php and/or your MySQL database setup.

The firstrun script will allow you to setup the database either with no sets and a single admin user or with an example set and the admin user. The example set is by default only visible to admin and is very small so nothing is lost by including it.

When you click to import the SQL you should see no errors (other than the occasional 0: Query was empty warnings). Errors here mean the underlying database has not been setup correctly (your version of MySQL may be incompatible for example). You should correct the SQL or setup as required and re-run the firstrun script.

Once you have finished with firstrun it is imperative you rename the file to something different again. Unless you do this anyone could run the firstrun script and blank out your databases. Once renamed a safety feature will stop the firstrun script from executing and display an error. This means you don't have to totally remove it from the site, just rename it.



<< 2.1.1 Requirements2.1.3 Potential Problems >>







http://www.purplepixie.org/viq© Copyright 2007 PurplePixie Systems