Documents

    Unpublished

    Regions and body tag classes

    Regions

    The "base theme" provides a number of content regions into which scholars may move widgets within the layout settings in the control panel. A region can be enabled by the site owner, or not according to preference on a particular pages, so all themes should be flexible enough to respond to these changes.

    For instance the left column may be in use in the publications page, but not in the blog area. The right column might only be used on the site's front page, but not anywhere else.

    Unpublished

    Default layout setup

    You can of course do anything you want with the CSS of your custom theme, but it's not a bad idea to know how the base theme on which you'll be essentially overriding is constructed. The base theme's CSS is loaded before yours so many default attributes can be used if you prefer.

    Holy Grail?

    The basic default layout is based on Matthew Levine's 2006 article in A List Apart. We suggest reading and familiarizing yourself with the article and logic behind it.

    Unpublished

    Theme flavors

    Theme 'flavors' are variants of a theme &mdashl; an example might be having a different color palette but otherwise using the same layout, typography choices, etc.

    You can develop distinct 'flavors' of your theme by working up a separate style sheet (CSS) and also notating the alternative flavor in your .info file.

    Unpublished

    Testing your theme

    To test your custom theme's CSS we have a themer kit which can be downloaded (Note: remove the .txt extension and then decompress). The kit contains a dummy mini-site of files with typical markup and with links to the live base theme, as well as links to a blank css file called my-theme.css. This is where you should work. Add background images to the supplied images directory.

    Unpublished

    Theme .info file settings

    NOTE: This help article is out of date! It conatins information for Drupal 6 only. This version of OpenScholar uses Drupal 7.

    .info files have several distinct keys that are unique to scholar themes they all begin with the "scholar" keyword

    • scholar[widgets] (array)

      Widgets are what scholar calls the display blocks on any given page. For a good representation of what widgets are and where they are located take a look at the "/cp/build/layout" page.

    Unpublished

    Site Plan

    Although the features offered by OpenScholar allow users to build a site without first establishing some semblance of plan, it does help to have some ideas regarding what is needed. Below is a brief overview of the site activities we will produce.

    Site Goal: Organize and display content a member of the faculty might need.

    Site Map: The simple chart below shows the site will have seven sections. 

    Unpublished

    Section: Galleries

    Enable the Section

    1. Click on Build in the Admin Toolbar.
    2. Click on Apps.
    3. Set Media Gallery to public.
    4. Click Save Configuration.
    5. Return to the home page and observe "Galleries" has been added to your primary menu.

    Set the Widgets for the Section

    1. Hover over Build in the Admin Toolbar.
    2. Click on Layout.
    3. Select Media Gallery from the Site Section dropdown.
    4. Drag the Search widget to the top of the list.
    5. Reorder any other items you wish.
    6. Save the layout.

    Unpublished

    Section: News

    Enable the Section

    1. Click on Build in the Admin Toolbar.
    2. Click on Apps.
    3. Set News app to public.
    4. Click Save Configuration.
    5. Return to the home page and observe "News" has been added to your primary menu.

    Set the Widgets for the Section

    In order to set the next widget, you need to create a vocabulary with some terms. A vocabulary is a way to group terms (or tags) so that you can organize your content. In the next steps, you will add a vocabulary to News in preparation for organizing your news posts.

    Unpublished

    Section: Office Hours

    Enable the Section

    The basic page feature is enabled by default but there is no section for it. This is your chance to create your own section.

    *Create Content

    Instead of setting the widgets, first create the content.

Pages