Configuring sites

This document describes the configuration file format used by Composite.

Each site has a configuration file located at <Composite Root>\Configuration\<Site name>.config. The elements in the configuration file is described below.

apptitle

Title of the sites administrative module. This value is displayed at the top of all tree views, in the window title and on the start up screen.

documenturlpattern

String. Template for document URLs. Default value is “/content/composite_developer/3x_technologies/configuration/website_configuration_files”. This value is used by the administrative module when you create internal links in the content area of a page, and when the Broken Links Preventer searches for links before a page is deleted.

If you change this value, you should review the URL transformations rules defined in HKLM\Software\CompositeNetsystems\UrlTransformer\Rules and ensure that your new pattern maps to composite-{id}.chtm

mediaurlpattern

String. Template for media URLs. Default value is “media($$MEDIAID;,$$LCID;)/$$TITLE;.$$EXTENSION;”. This value is used by the administrative module when media is included into the content area of a page.

If you change this value, you should review the URL transformations rules defined in HKLM\Software\CompositeNetsystems\UrlTransformer\Rules and ensure that your new pattern maps to /showMedium.chtm\?mediaid={id}&lcid={lcid}

mediatitlesasalternatetext

Boolean. Default value is “true”. When true, media titles will be applied as ALT text on images included in the content area of a page.

proposenewpages

Boolean. Default value is “true”. When true pages will have status "Proposed" when added or edited. If the site is primarily used by persons that approve their own changes, this can speed up the editing process.

sendnotificationtoapprovers

Boolean. Default value is “false”. When true, e-mail notifications will be generated when editors without approval rights propose a page. All editors that can approve the page, and who have their e-mail address specified in their profile, will receive a notification.

If you set this value to true, consider setting the proposenewpages value to false.

language

String. Specified at site creation. The language of the administrative module. Legal values are “English”, "Swedish", “Danish” and “Norwegian”.

htmlcontenttransform

String. Default is “XHTML”. Controls the transformation of content HTML when it is saved. Legal values are "None" and "XHTML".

fullpagecachestrategy

String. Default value is “Page”. Controls which kinds of requests the full page caching mechanism should cache. Legal values are "Page" or "ByParams". This field is ignored, if the fullpagecachetimeout value is zero.

Specifying “Page” as strategy will only cache pages called without parameters (GET and POST), while the “ByParams” strategy will cache all pages, regardless of parameters. Please note that the “ByParams” strategy can potentially consume a great deal of memory.

fullpagecachetimeout

Integer. Default value is “0”. Number of minutes a page in the full page cache should live. Specifying a positive integer will turn on full page caching. Please note that you should not use this feature on sites that feature personalized content, like extranets etc. unless you specify "Private" in the fullpagecacheability element (see below).

fullpagecacheability

String. Default value is "ServerAndPrivate". Controls how complete pages are cached. Page caching can occur on the client, on public proxies or on the server. Legal values are "NoCache", "Private", "Public", "Server", "ServerAndNoCache" and "ServerAndPrivate". Please refere to System.Web.HttpCacheability enumeration for more information.

datacachetimeout

Integer. Default value is “1”. Number of minutes Composite data read from the database should live in the cache. The elements cached are templates, page content and media information.

databaseserver

String. Specified at site creation. The name or IP of the SQL Server hosting the Composite database.

databasename

String. Specified at site creation. Name of the Composite database used by the site.

databaseguestname

String. Default is “<sitename>Guest”. The login name that the (public) front end uses to contact the SQL Server.

databaseguestpassword

String. The password that the (public) front end uses to contact the SQL Server.

databaseadminname

String. Default is “<sitename>Admin”. The login name that the (admin) back end uses to contact the SQL Server.

databaseadminpassword

String. The password that the (admin) back end uses to contact the SQL Server.

aspcompatibility

Boolean. Default is “true”. When true the front end will support "old style" ASP compatibility in COM objects.

pagenotfoundid

Integer. Default is “0”. The id of the page to show when users requests non-existing resource. Specifying “0” will show a simple HTTP 404 message.

websiteroots\websiteroot

String. Path to the website root - multiple paths may exist on load balanced systems.

mediafolders\mediafolder

String. Path to the media folder - multiple paths may exist on load balanced systems.

showpublicerrors

Boolean. Default is “false”. When true a detailed ASP.NET error screen will be shown when the rendering of public pages fail with a critical error.

showpreviewerrors

Boolean. Default is “true”. When true a detailed ASP.NET error screen will be shown when the rendering of previewed pages fail with a critical error.