Uploading zip with custom configuration files...

Step 1. Interface

The first step is to customize the interface that survey participants will see. Use this form to upload a custom logo and change the look of the header, footer, map, and questions sections if you want. All options currently shown are the defaults.

Header

Do you want to include a header?

Add custom CSS?

Write your custom CSS attributes in the format of a single-level JSON object below.

Do you want to include a title in your header?

Footer

Do you want to include a footer?

Do you want to include text or HTML content in your footer?

Map Section

Do you want to add custom CSS to the map section?

Write your custom CSS attributes in the format of a single-level JSON object below.

Questions Section

Do you want to add custom CSS to the questions section?

Write your custom CSS attributes in the format of a single-level JSON object below.

Step 2. Pages

Pages are the most important components of your survey application. Each page will include its own map (or no map) and text or questions that accompany that map (or stand alone). For each page you create, if you choose to include a map, the first section of each page form will help you build the map you want to test on that page. The second part of the form will guide you through creating questions.

Step 3. Conditions

Conditions determine the order in which pages appear to different groups of study participants. The condition configuration options give you the flexibility to create randomized and factorial study designs. If you do not create any conditions, all participants will see every page in the order in which they are listed in map.json and questions.json.

Weight conditions?

Condition weights allow you to choose the relative frequency with which each condition is assigned. All condition weights must sum to 1. If not weighted, each condition will be assigned at random with equal frequency.

Step 4. Server Configuration

Unlike the prior configuration parameters, these will be placed in a php file (param.php) so they are only readable by the host server and remain secure. You may include the e-mail parameters, database parameters, both, or neither; by default, a data, interactions, and story table for each participant will be added to a participants folder in the application directory. If you don't include email or database configuration, you must still include the param.php (even if blank) file to receive any data from the application!

E-mail participant tables?

If these parameters are included, a data table, interactions table, and, if included, a story table for each participant will be e-mailed to the provided address in CSV format when submitted by the participant. To configure email, two accounts are necessary. The first is an email account with an active SMTP server. For this, we recommend using a dummy email account created specifically for your Mapstudy project. If you're not sure how to setup an SMTP server, here's a good tutorial for how to do so using a gmail account (you'll need the 16-character password Google generates). You'll also need an account to recieve the sent emails; this can be a personal account.
SMTP host address: (if using gmail: 'smtp.gmail.com')
SMTP port: (usually this is either 25 or 587. 587 is used for gmail.)
Outgoing e-mail address for the account: (we recommend a dummy email)
Account SMTP password: (if using gmail, the 16-character password generated when setting up an SMTP server)
E-mail address to send files to:
E-mail subject line:
E-mail message: (the CSV files will be attached automatically)

Create database tables?

Make sure you know these values in advance and your database server and firewall are configured to allow incoming traffic from your web server. Otherwise, the connection won't work! Your user must have create, read, and update privileges for the database.
Database type:
Hostname:
Port:
Database name:
Username:
Password: (double-check this one after you download the config files)

All Done!

Next, unzip the file that just downloaded, and replace the files in the MapStudy "config" directory with its contents. Then your app should be ready to rock!