1.3. Configuring Tapestry

If you have successfully installed and enabled the Theme Settings API module (or if you're running Drupal version 6), you can easily configure many aspects of the Tapestry theme from the Drupal administration menus.

Drupal 5 Users: You can use the tapestry theme without installing the Theme Settings API module. However, you will not be able to control the theme features as described below without this module installed and enabled.

Point your browser to /yoursite/admin/build/themes/settings/tapestry. At the bottom of this form is a series of options specific to the Tapestry theme. Each of the available options is described below. Modify the options to your liking and click the Save Configuration button at the bottom of the page. Your changes will take effect immediately.

Style: This option allows you to select one of the 20 built-in styles that tapestry provides.

Fixed Width Size: This option allows you to specify the width of the Tapestry content window. The default value is 850, which represents a page that is 850 pixels wide.

Outside Sidebar Location: This option determines which side of the page the Outside Sidebar will be displayed on.

Outside Sidebar Width: This option is used to specify the width, in pixels, of the outside sidebar.

Inside Sidebar Mode: This option allows you to select which side of the page the sidebars are displayed. You can choose to display the content between sidebars, to display both sidebars to the left of the content, or to display both sidebars to the right of the content.

Left Sidebar Width: This option is used to specify the width, in pixels, of the left sidebar.

Right Sidebar Width: This option is used to specify the width, in pixels, of the right sidebar.

Font Family: This option allows you to select the default font family for your site. You can select one of the provided options, or you can select Custom and specify your own font selector below.

Custom Font-Family Setting: If you selected Custom from the Font Family drop-down menu, you can specify a custom font-family string here. The string should be valid in the context of a CSS definition. Font family names that includes spaces should be enclosed in quotes, and multiple font names should be separated by commas.

Include Local Content File: If this option is enabled, Drupal will load a CSS file with the name specified beolow during the page-load sequence. This allows you to create a custom CSS file with site-specific CSS customizations. Isolating theme modifications and site-specific CSS in this manner prevents future theme updates from overwriting your changes.

Local Content File Name: If the Include Local Content File option is enabled, this option is used to specify the file name of the local content file. Note that the path is relative to the tapestry theme root folder.

Suckerfish Menu Alignment: Using this option, you can select to place the Suckerfish menu on the left side of the page, on the right side of the page, or centered in the page.

Enable Suckerfish Javascript for IE6: Internet Explorer 6 has a bug related to the CSS hover attribute that prevents pure CSS suckerfish menus from working correctly. Tapestry provides a javascript file that will work around this problem and allow suckerfish menus to work correctly in IE. If you want to use this feature, you must enable this checkbox. If you do not enable this option, suckerfish menus will not work in IE6.

Use Themed Logo: You may choose to display the default theme logo by checking the Logo checkbox near the top of this page. By default, Drupal looks for a file named logo.png in the theme's root folder. If you additionally enable the Use Styled Logo checkbox, Drupal will look for a file named logo.png in the tapestry/images/selected-style folder. This allows you to create a different logo file to match the colors of each available Tapestry style.

Show Breadcrumbs: If this option is enabled, Drupal will display breadcrumbs in the upper-left corner of each page.

Use Icons: If this option is enabled, Tapestry will decorate primary links menu items and various Drupal elements with icons from the Tango Project Icon Library.

Alternate Icons for IE5/6: When enabled, Tapestry will use a different set of icons for IE6 than it will for other browsers. This option is only used if the Use Icons checkbox is enabled.

Use IE PNG Fix: When this feature is enabled, Tapestry will load a javascript program that allows IE6 to display transparent PNG images.