Advanced Options

'); ?>

The Site <HEAD> Section

This tab allows you to define custom code and style rules to the <HEAD> Section of every page on your site.

PLEASE NOTE: Only minimal validation is made on the field values, so be careful not to use invalid code. Invalid code is usually harmless, but it can make your site display incorrectly. If your site looks broken after make changes here, please double check that what you entered uses valid HTML or CSS rules.

<HEAD> Section

This input area allows you to enter custom HTML and JavaScript code to your site. Code entered into this box is included right before the </HEAD> HTML tag on each page of your site. This often will include JavaScript code supplied by other sites (such as Google Analytics) that is required to use some feature of the outside site. Shortcodes are not supported in this option. Note: while you can add CSS bracketed in a <style> section here, the preferred way is to add CSS Rules using the "Custom CSS Rules" option below.

For even greater control of how your site looks, you can add code the the <HEAD> section on a per page basis using the per page options from the page editor.

Aspen will always load the jQuery Library.

Custom CSS Rules

Add your own custom CSS Rules to Aspen's style rules

This section allows you to add new CSS Rules to your theme to enhance or override the styling set using Aspen's Main Options. For example, Aspen's documentation includes many CSS Snippets that allow you to find tune the look of your site. You simply add whatever CSS Rules you need into the box below. Include the complete rule. You do not need to add <style> HTML tags to bracket your rules.

Rules you add here will be the last CSS Rules included by Aspen, and thus override all other Aspen generated CSS rules. It is possible that other plugins might generate CSS that comes after these rules.

<HEAD> Section (Advanced Alternative - ♦)

Same as normal <HEAD> box above, but works like other ♦ options - it survives changing the subtheme from the Aspen Subthemes tab, and is saved only on a full backup Save. This option is not commonly used, and is intended for more advanced Aspen users to add <script>l and <style> blocks to the <head> section.

HTML Insertion

The Advanced Options→HTML Insertion tab allows you to insert custom HTML code in many places on your site. These fields allow you to add HTML code, special CSS rules, or even JavaScripts. You will need at least a bit of knowledge of HTML coding to use these fields most effectively.

The values you put here are saved in the WordPress database, and will survive theme upgrades and other changes.

'Site Header Insert Code', 'id'=>'header', 'info'=> "This HTML code will be inserted into the #branding div header area right above where the standard site header image goes. You can use it for logos, better site name text - whatever. When used in combination with hiding the site title, header image, and the menu, you can design a completely custom header. If you hide the title, image, and header, no other code is generated in the #branding div, so this code can be a complete header replacement. You can also use WP shortcodes to embed plugins, including rotating image slideshows such as Meteor Slides.", 'help' => ''), array ('name'=>'Footer Code', 'id'=>'footer', 'info' => 'This code will be inserted into the site footer area, just before the before the copyright and "Powered by" credits, but after any Footer widgets (check option below to move to before widgets). This could include extra information, visit counters, etc.', 'help' => ''), array('name'=>'', 'id'=>'submit', 'info' => '', 'help' => ''), array ('name'=>'Pre-Wrapper Code', 'id'=>'prewrapper', 'info' => 'This code will be inserted just before the #wrapper and #branding divs, before any other site content.', 'help' => ''), array ('name'=>'Pre-Header Code', 'id'=>'preheader', 'info' => 'This code will be inserted just before the header area (between the "#wrapper" and the "#branding" divs), above the menus and site image.', 'help' => ''), array ('name'=>'Post-Footer', 'id'=>'postfooter', 'info' => 'This code will be inserted just after the footer #colophon div, outside the #wrapper div.', 'help' => '') ); aspen_sapi_submit('', "

\n"); foreach ($areas as $area => $def) { aspen_add_html_field($def['name'],$def['id'],$def['info'],$def['help']); } do_action('aspen_plus','html_insertion'); } function aspen_add_html_field($title, $name, $info, $help='') { if ($name=='submit') { aspen_sapi_submit('', "

\n"); return; } $pro = aspen_fix_type($name); if ($name[0] == '+') $name = substr($name,1); // fix locally $area_name = '' . $name . '_insert'; $hide_front = 'hide_front_' . $name; $hide_rest = 'hide_rest_' . $name; $style_id = 'inject_' . $name; if ( $pro == 'inactive' ) { if ($title[0] == '#') $title = substr($title,4); ?>

- (Pro Version)

' . $info. "

\n"; aspen_adv_hidden($area_name); // keep it working for Pro settings, even on free version aspen_adv_hidden($hide_front); aspen_adv_hidden($hide_rest); if ($info) echo ''; return; } ?>

class .$style_id.)"); else echo (" (Style with #$style_id.)"); ?>

Hide on front page: /> If you check this box, then the code from this area will not be displayed on the front (home) page.
Hide on non-front pages: /> If you check this box, then the code from this area will not be displayed on non-front pages.
Move to before widget areas: /> If you check this box, then the code from this area will be inserted before the footer widgets instead of after.

Custom Page Templates

Aspen includes several page templates - which is the WordPress tool for giving different look and functionality do individual static pages. Many of the properties of any given page, independent of the page template, can be set using the "Aspen Options For This Page" box on the regular WordPress Page Editor admin page.

One of the most requested features included in the Per Page box is the ability to set the sidebar layout for each page. If this is not set, the page will use the global options for the page type. The other popular option includes the ability to replace any of the sidebar widget areas, as well as the ability to add an additional top widget area. To use a new widget area you must first tell Aspen to create a new one. These Per Page Widget Areas are defined on the Main Options:Widget Areas tab.

Overview of Page Templates

The 2 Col Content template splits content into two columns. You manually set the column split using the standard WP '<--more-->' convention. (Note - since WordPress only used the '<--more-->' to show the "Continue reading..." for posts, it can serve this purpose for this template on pages. Columns will split first horizontally, then vertically (you can have more than one <--more--> tag).
The Blank page template will wrap the content of an associated page with an HTML div with class .content-blank which you can add CSS rules to style using the standard Aspen options. The standard page <article> wrapping is not used. The page title is not displayed. Use Per Page Options on Page edit menu to control Menu, Site Title, and Header Image visibility.
Page with Posts serves as an alternative way to display posts. After you select the Page with Posts template, a new set of options will be added to the Per Page menu. There is additional help in the help documentation.
The Raw template allows total custom HTML styling with no predefined div's. It useful for Pop Up pages.
The Sitemap provides a page with a basic sitemap.
The iframe template is designed for full width display of html iframes. You can control sidebars and titles using standard Per Page options.

Site Options

These options are available to fine tune various aspects of your site. Technically, these features are not part of the theme styling, but cover other aspects of site functionality.

FavIcon

You can add a FavIcon to your site with this option. The preferred FavIcon is in the .ico format which has the most universal browser compatibility. However, .png, .gif, and .jpg will work for most modern browsers. The standard sizes are 16x16, 32x32, or 48x48 px. You can alternatively load a favicon.ico file to the root directory of your site. ♦

'; } ?> FavIcon URL: <?php echo(esc_textarea(aspen_getopt('_favicon_url'))); ?> Full path to FavIcon

SEO - Search Engine Optimization

The Aspen Theme has been designed to follow the latest SEO guidelines. Each non-home page will use the recommended "Page Title | Site Title" format, and the site is formatted using the appropriate HTML5 tags for optimal SEO performance. Unless you have special needs, you probably don't need an SEO plugin. But if you are concerned about SEO then an SEO plugin will have options to help optimize your site for SEO. See the Help tab for recommended SEO plugins.

Home Page

WordPress allows you to specify what page is used for your home page - either the standard WordPress blog, or a static page (which can be a Aspen "Page with Posts" page). How to set the Front page displays options is not totally obvious - please see the Aspen Help topic for a more complete explanation.

You can set the front page on the Dashboard Settings→Reading panel: Set Front Page Displays

Author Avatars

For the best look, your site should support Avatars - a small image associated with a contributors e-mail address. '); ?>Gravatar.com is probably the most popular Avatar support, and is closely associated with WordPress. You should set up a Gravatar for the main authors of your blog. For contributors without any avatar, you can select an automatically generated avatar from several options found on the Settings→Discussion panel.

'submit'), array('name' => 'Mobile Options', 'type' => 'header', 'info'=> 'Settings for mobile device display', 'help' => 'help.html#MobileHelp'), array('name' => '#070Mobile Support Mode', 'id' => '_mode_mobile', 'type' => 'select_id', 'info' => 'Select how Aspen generates mobile views. (Default: Responsive, hide sidebars) Important: see the help file!. ♦', 'value' => array( array('val' => 'aspen-mobile-resp-nostack', 'desc' => 'Responsive, hide sidebars'), array('val' => 'aspen-mobile-responsive', 'desc' => 'Responsive, stacked sidebars') )), array('name' => '#070Show Footer Widgets', 'id' => 'mobile_show_footerwidgets', 'type' => 'checkbox', 'info' => 'Will show footer widget area on non-stacked Mobile Modes for mobile devices. (Footer widget is always displayed on stacked Mobile Modes.)'), array('name' => '#070Hide Top/Bottom Widget Areas', 'id' => 'mobile_hide_topbottom_widgets', 'type' => 'checkbox', 'info' => 'Hide Top and Bottom Widget Areas in addition to Sidebars.'), array('name' => '#070No Auto-Underline Links', 'id' => 'mobile_nounderline', 'type' => 'checkbox', 'info' => 'Underlined links are easier to use on most mobile devices. This will disable auto-underlined links.'), array('name' => '#070Mobile Site Title Color', 'id' => 'mobile_title_color', 'type' => 'color', 'info' => 'Alternate Color for Mobile Site Title (includes Responsive Modes).'), array('name'=>'More Mobile Options:','type'=>'note', 'info'=>'More mobile options are available for specific areas: Header, Menus, Post Specifics, Shortcodes.') ); ?>

These are the main options that control how Aspen displays your site on Mobile devices. Please note that there are other options that affect the mobile view located on other tabs (e.g., the Main Options : Header tab). Options that affect the mobile view are displayed with a Green Label.