Customizing the Administrative Module

(This is an advanced area.)

The Admin Module uses a default format and appearance, but you can modify the settings. You can also change the default behavior regarding which menu items are available based on the level of password (read-write vs. read only).

---

Customizing the Menu Items

Under the File | Study Settings dialog, you specify Administrative Module Access passwords: Read-Only and Read-Modify administrative rights. These two permission levels control which menu items are available within the Admin Module.

Read Only administrative rights let the user...

·

View the Study Summary

·

View Survey Data

·

Run Marginals

·

View the Passwords Reports

·

Test Survey

Read/Write administrative rights permit all the above operations, plus...

·

Download Data

·

Delete Selected Records

·

Close a Survey

·

Reset a Survey

You can change these default settings by creating a file named STUDYNAMEconfig.cgi and by placing it in the admin folder in your server setup. If this file is present, SSI Web ignores the user name and password for the Admin Module as specified in the Study Settings dialog.

Using STUDYNAMEconfig.cgi allows you to specify multiple passwords with customized levels of access to the Admin Module.

Here is an example demonstrating the STUDYNAMEconfig.cgi file format:

STUDYNAMEconfig.cgi

{   "admin_access" =>   {   "Bob|3829" => {"read_access" => 1},   "Joe|8743" => {"study_summary" => 1, "marginals" => 1},   },   }

In the example above, the user "Bob" with password "3829" is able to access all of the settings that come with Read Access. "Joe" on the other hand with password "8743" will only see the Study Summary and Marginals menu options.

The available settings are:

·    full_access

·    read_access

·    study_summary

·    download_data

·    view_data

·    marginals

·    password_reports

·    test_survey

·    close_survey

·    reset_survey

---

Customizing the Look of the Admin Module

It is possible to customize the look of the Admin Module by creating your own CSS file and placing it within the graphics folder. Additionally, you should create a configuration file called STUDYNAMEconfig.cgi and place it in the admin folder.

STUDYNAMEconfig.cgi

{   "customized_look" =>   {   "page_title" => "Bob's <u>Awesome</u> Surveys",   "CSS_file" => "test.css",   },   }

The "page_title" setting controls the text at the top of the page. Your company name can be entered here. You can also use HTML to include graphics, etc.


To change the title of the Admin Module to a graphic place this in the config.cgi file:

STUDYNAMEconfig.cgi

{   "customized_look" =>   {   "page_title" => " ",   "CSS_file" => "test.css",   },   }

and place this in the CSS file:

.title

{

background-image: url('your_graphic.gif');

background-repeat: no-repeat;

height: 70px;

}

CSS can be used to change additional colors etc. in the Admin Module. View the HTML of the Admin Module (View Source from any browser) to see the HTML including the "class" and "id" attributes available for you to modify with your custom CSS.