How to Setup the CMS Agenda Theme on an Existing Drupal WebsiteHow to Setup the CMS Agenda Theme on an Existing Drupal Website

Assumptions: It's assumed that you have knowledge of using Drupal. If you need help setting up and customizing your site please use our contact form to request paid support.

Files Required

All required theme and module files are included in the theme package zip file which you'll have access to download after your purchase. A Views import file is listed below for download.

Themes

• CMS Base
• CMS Agenda
• CMS Agenda Custom

Modules

• Nice Menu (required for the navigation menu)
• CCK - Content, Fieldgroup, Option Widgets, Text
• Views – Views, Views UI Block theme for the block styles
• PNG Fix (for transparency issues in IE)

Other

• views_front_featured.txt - download here
   

Upload and Enable Theme and Module Files

1. Upload files to your server:
   
   1. upload theme files into sites/all/themes folder
   2. upload module files to sites/all/modules folder
2. Go to Site building > themes and enable CMS Agenda Custom as your default theme
3. Go to Site building > modules and enable all required modules

Note: It's a best practice to backup your site and switch to offline mode when making these updates on an existing site.
 

Setting up the Home Page of CMS Agenda

1. Search Block
2. Primary Links Menu
3. Featured Image Block
4. Block with 3 Headlines

1. Search block

• Go to Site building > blocks and assign the Search form block to the Header 3 region

2. Primary links menu

• Go to Site building > blocks and click the configure link beside of the Nice Menus 1 block
• Under Page specific visibility settings select Show on every page except the listed pages and save the block
• Assign the Nice Menu 1 block to the Navigation bar region and save

3. Featured image

• Go to Site building > blocks > add block
• Embed a 596 x 254 pixel image into the block body field. Our quick start installation profiles provide a WYSIWYG editor and image upload button to do this easily. If your existing site doesn't have this setup then you can add html code that links to an image on your server.
• Set the page visibility settings to Show on only the listed pages and in the Pages: field put <front> and save the block.

4. Block with 3 Headlines

• This block was designed to utilize the Views module to display the latest 3 titles from the story content type.
  
  

Configure the Story content type

1. Add a New group

• Go to Content management > Content types > Edit story > Manage fields
• New group - Label: Featured content settings
• Group name : featured_content_settings
• Click save

2. Add a New field

• Label: Check to feature this content. The latest 3 will show on the home page.
• Field name: is_home_featured
• Type of data to store: Text
• Form element to edit the data: Single on/off checkbox
• Click save
• On the following page under Allowed values and in “allowed values list” text box put 0 in the first line and on the second line put: 1| Check to feature this content. The latest 3 will show on the home page.
• Leave all other values unchanged and click on “Save field settings”.

3. Add a New field

• Label: Title to display
• Field name: teaser_title
• Type of data to store: Text
• Form element to edit the data. : Text Field
• Click save
• On the following page leave all values unchanged and click on “Save field settings”

4. Add new field

• Label: Summary to display
• Field name: teaser_description
• Type of data to store: Text
• Form element to edit the data: Text area(multiple rows)
• Click save
• On the following page:
  • Text processing: Filtered text (user selects input format)
  • Leave all values unchanged and click on “Save field settings”

5. Organize the new fields and group

• Drag and drop all of the new fields under the “Featured content settings” group
• Drag and drop the group above the body field
• Click save

6. Configure the display fields

• Click on the “display fields” tab and the Basic tab will appear by default. Configure the settings as shown in the image below.
• Click the RSS tab (from secondary tabs under Display fields)
• Select <hidden> for all fields and click save. 

Configuring the Front Featured View Block

1. Import the View Go to admin > site building > Views > Import Leave the View name blank Paste view code here: Copy all the text written in “Views_front_featured.txt” file and paste into the text box entitled “Paste view code here:” Click import and on the following page click the save button.

2. Configure block settings

• Go to admin > site building > blocks and click the configure link beside of “front_featured: Block”
• Configure the settings as shown in the image below and click save block.

• On the following page assign this block to the “content top 3” region and click save.
• You can now create content using the story content type and feature it on the home page.
  
  

Setting Up the Block Theme Styles

The CMS Agenda Theme comes with 4 block theme styles that are designed to work in the left and right sidebar regions. Below is an image that shows their appearance.

To setup the CMS Agenda block theme styles on an existing site please follow these steps:

1. Install and enable the Block theme module - http://drupal.org/project/blocktheme
2. Go to Admin > Site configuration > Block theme
3. Copy the text below and paste into the Custom Block Templates text box and save.

title-with-arrow|Title with arrow
dropped-shadow|Dropped shadow block
rounded-box|Rounded box block
dark-rounded-box|Dark rounded box block

Using the CMS Agenda Block Theme Styles

The CMS Agenda block theme options are designed to work for blocks assigned to the sidebar regions. To apply the block theme styles simply click the configure link beside of any block and you'll see the following block theme options as shown in the image below. Select an option and save the block and the new style will be applied.