By continuing to use this site, you agree to the storing of first- and third-party cookies on your device to enhance site navigation; analyze site, product, and service usage; and assist in our marketing and promotional efforts. Cookie Policy

 
Skip to Content

Directory Variables

Directory variables modify the content inside a folder to change the behavior or display of files within a section. For example, set a directory variable to choose varying color schemes for different sections of your site that use the same template, like departments.

Set directory variables for your site and folder(s) by assigning a variable name and a variable value.

An example of directory variables.

Set directory variables for your site, as follows:

  1. Navigate to Setup > Sites.
  2. Click the More Actions menu More Actions menu for your site.
  3. Click Edit > Site Access.
  4. In the "Site Access Settings" box, locate "Directory Variables" and click +Add.
  5. Click the "Create New Variable" dropdown to select a system variable or enter text to name a custom variable.
    • To complete a custom variable, declare the variable in the folder's TMPL or XSL file.
  6. In the "Value" field, enter the appropriate input.
  7. Click Save.

Set directory variables for a folder, as follows:

  1. Navigate to Content > Pages and find the folder to associate with a directory variable.
  2. Click More Actions.
  3. Click Edit > Access.
  4. In the "Access Settings" box, locate "Directory Variables" and click +Add.
  5. Click the "Create New Variable" dropdown to select a system variable or enter text to name a custom variable.
    • To complete a custom variable, declare the variable in the TMPL or XSL for the folder.
  6. In the "Value" field, enter the appropriate input.
  7. Click Save.

Directory variables are applied recursively, so editing a directory variable for /academics, for example, applies that variable to any subfolders of /academics

A folder inherits directory variables from its parent folder(s). Inherited variables can't be edited, but they can be overwritten. To overwrite an inherited variable, from the "Access Settings" box add the same variable name and enter a different value.

Typically, directory variables are custom-made for each institution and their functionality may differ by implementation. Three directory variables are included with every installation of OU Campus, as follows:

NameValueEffect
Default Image Folder (formerly ox_ftp_image_root)Root- or page-relative path to the image folder, no trailing slash (e.g. /images/campus-life)When users are inserting an image, they start in that folder by default when choosing the image.
Default Media Folder (formerly ox_ftp_media_root)Root- or page-relative path to the media folder, no trailing slash (e.g. /videos/promotional)When users are inserting a video or other media, they start in that folder by default when choosing the media.
PublishAdd skip: and make a comma-separated list of file extensions (e.g. skip:xml,xsl,tcf,tmpl)Excludes any files with the the defined file extensions from being published when the folder containing them is published.

Adjust these directory variables from the "Access Settings" box, no source code editing required.