The Edit tab of the Home Folder serves as a control dashboard for many crucial functions within Callimachus. 

Access

To access the Home Folder Edit tab simply navigate to the Home Folder via the Main Menu and click the "Edit" tab.

Components

Realm Settings

Realm settings determine are applied across an entire Callimachus instance and control some of the fundamental access and presentation aspects.

Layout

Layout is the extra markup that is applied to every xhtml template within a Callimachus instance. This is the easiest way to apply common layout and styling across your Callimachus pages and applications. To creating a custom Layout follow the steps below.

Step Action Example
1 Click the widget below Layout
2 Replace the layout name with a new one Customized Layout
3 Choose the Add new layout option
4 Choose a folder to save the new layout
5 Modify the layout as desired
6 Click the layout dialogue Save button to store the new layout
7 Click the realm Save button to apply the layout

The layout file is a XQuery file that utilizes most of the Callimachus layout functions. Callimachus utilizes the Bootstrap framework which makes both formatting and styling much easier for everyday developers. Check out Bootswatch for free Bootstrap themes that will integrate with Callimachus seamlessly. The theme can be either downloaded locally or referenced via a <link> tag. In your Callimachus Layout file simply paste the link underneath {calli:styles-href(<link rel="stylesheet" />)} in this manner:

{calli:styles-href(<link rel="stylesheet" />)}
<link rel="stylesheet" type="text/css" href="http://bootswatch.com/flatly/bootstrap.min.css" />

Allowed Origins

Allowed origins are origins from which scripts can make requests to a Callimachus instance. For example, if Callimachus was installed at http://host.example.com and had an Allowed Origin of http://allowed.example.com, scripts located on allowed.example.com could make requests to host.example.com. If you do not want your Callimachus instance to be made available to other origins then the only Allowed Origin should be the origin at which your instance is installed. 

This origin configuration is in line with the CORS specification. 

Authentication

Different authentication options can be managed from this tab. A list of the authentication mechanisms currently applied to the Callimachus instance are rendered by default. 

Authentication options can be added via the icon next to "Authentication." They can be removed by clicking the small "x" next to the authentication option. Be aware that by clicking this "x" you are only removing the authentication mechanism as an option for logging in, but not deleting the authentication configuration itself.

Credentials

Credentials are managed via the Home Folder Edit tab. A list of the credentials currently applied to the Callimachus instance are rendered by default. 

Credentials can be added via the icon next to "Credentials." They can be removed by clicking the small "x" next to the credential listing. Be aware that by clicking this "x" you are only removing the credential from use in the current instance, but not deleting the credential configuration itself.

Directory Index

Directory index settings determine how requests directly to the Home Folder should be handled.

Type

The type is the response code that is sent. For more information on exactly what these types represent read the PURL documentation.

Content Location

Content location is the resource that should be returned to the browser when the Home Folder is requested. This is the best way you can set the home page for your Callimachus instance. Generally this is some sort of landing or index page for your application or system.

Cache Control

Cache control is used to control how often the content will be refreshed for users of a Callimachus instance. The value entered will determine exactly how the system responds to multiple requests for the same resource over a given period of time. For a list of the available values for this field please see the specification section "cache-response-directive". An example value would be "max-age=3600".