Output Preferences

This section of the Control Panel allows you to define how your site is output from the server to the user.

Main Screen

The main Output Preferences screen shows a table of the preferences. All the output preferences are set via this screen.

All preferences in this area of the Control Panel are required fields.

Output Preferences main screen

Generate HTTP Page Headers?

This setting determines whether or not the server should automatically send HTTP page headers when it serves the pages to a user. Setting this preference to "Yes" causes headers to be explicitly sent by the server. Sending explicit headers is generally considered to be a good practice.

Enable GZIP Output?

Setting this preference to "Yes" will cause the web server to send out your pages in the compressed gzip format. Browsers will automatically decompress the pages and display them as normal; there will be no visible difference to your users apart from a decreased loading time.

Your server must support serving in the gzip format in order to be able to use this option. Additionally, the browser or user agent being used to view your site must also support pages served in the gzip format. Most modern browser support this, but not every browser or user agent will.

Force URL query strings?

By default, this preference is set to "No". Setting this to "Yes" will force the system to use a standard query string in the URL so that it might look something like http://www.example.com/index.php?/blog/joe/. When set to "No", the system uses a friendly format similar to http://www.example.com/index.php/blog/joe/.

The majority of servers will be able to use the default ("No") method, which is almost universally preferred by users. Occasionally, though, a server will not support this feature and will have to be set to "Yes". This is the case if the server does not support the PATH_INFO variable.

In addition, some people will need to use this variable in conjunction with editing the $qtype variable in your main site index.php file.

Redirection Method

This setting determines what method is used for page redirections. These redirections are used relatively frequently throughout the system, especially with things like logging in/out and other membership related functions. There are two options:

  1. Location (faster): This is the preferred method, which uses PHP's "location" functionality.
  2. Refresh (Windows servers): The "refresh" method is often necessary for windows-based servers due to the poor way they handle PHP's "location" functionality. This method is usually slightly slower than the other method.