$panel,
'title' => __( 'Introduction to Absolute Weaver', 'absolute-weaver' ),
'description' => __( 'A concise introduction to Absolute Weaver.', 'absolute-weaver' ) .
'
(' . ABSOLUTE_WEAVER_THEMEVERSION . ')', // don't translate theme name/version
'options' => array(
'starting-intro-header' => array(
'control' => array(
'control_type' => 'Absolute_Weaver_Custom_Control',
'label' => __( 'Introduction', 'absolute-weaver' ),
// translators: HTML markup is allowed and encouraged for this translation
'description' => __(
'Absolute Weaver allows you to customize virtually every aspect of your site.
The Customizer Options are organized as top level panels based on WHAT you want to customize, and a second level of sections
based on WHERE you want to make the customizations. Remember: WHAT and WHERE.
First Level Options: WHAT to Set - Option Categories
The first level of Absolute Weaver Customizer menus is organized around different categories of options that reflect different collections of related options. For example, all the Color settings are found on a single, top-level option panel called "Colors". The other top level option panels represent similar groups of options:
- ▸ Colors - Specify all colors used on site - both text and background colors.
- ▸ Spacing, Widths, Alignment - Set margins, padding, spacing, heights, widths, and alignment.
- ▸ Style - Set borders, shadows, rounded corners, list bullet style, icons.
- ▸ Typography - Set font family, font size, bold, italic, default base font information.
- ▸ Visibility - Show or hide various elements - usually by device ( phone, tablet, desktop ).
- ▸ Layout - Specify element layout - sidebars, etc.
- ▸ Images - Set borders, placement, Featured Images, Header Images, Background Images.
- ▸ Added Content - Define added content for extra HTML insertion areas.
- ▸ Custom CSS - Advanced users can specify custom CSS for the whole site or specific areas.
- ▸ Sidebars & Widgets Content - the standard WordPress interface for widget areas and widgets.
- ▸ Custom Menu Content - the standard WordPress interface for defining custom menus.
The top level Customizer menu also has two additional menus:
- ▸ Absolute Weaver: Start Here - access to getting started help and other documentation.
- ▸ General Options & Admin - WordPress Site Identity and Static Front page options, and other theme admin options.
The basic logic behind this organization is that it is easy to remember the different kinds of things you want to customize, like color or spacing. The next level of menus specifies where you want to make those changes.
Second Level Options: WHERE to Set - Areas
Deciding what you want to customize is usually an obvious decision. Finding where to apply those settings take a bit more understanding just how a Absolute Weaver WordPress site is organized.
We\'ve tried to make this second level step as easy and consistent as possible. Almost every one of the option categories can be applied to the same set of areas. The "standard" set of areas include:
- ▸ Wrapping Areas - the major outer areas that wrap the site\'s content. The main Wrapper Area wraps the entire site, while the Container Area wraps the page or post content and the main sidebars.
- ▸ Links - Not all categories apply to links, but links are treated as a single element to style.
- ▸ Header Area - the header area is displayed at the top of the site, and includes the site title and tagline, the primary and secondary menus, the site header image, a header widget area, and an extra area for arbitrary HTML.
- ▸ Menus - The Primary Menu can be displayed at the top or bottom of the Header. There is a one line mini-menu that can be displayed in the header area.
- ▸ Info Bar - the Info Bar is displayed immediately below the Header Area, and shows navigation information, as well as other custom content.
- ▸ Content - the content area displays page and post content.
- ▸ Post Specific - the Content styling will be applied to both page and post content, but this section allows you to have specific styling for posts and blog views.
- ▸ Sidebars & Widget Areas - styling for the various Sidebars and Widget Areas.
- ▸ Individual Widgets - styling for individual widgets displayed in the Widget Areas.
- ▸ Footer Area - the footer area at the bottom of the site. This includes a widget area and an extra custom HTML insertion area.
- ▸ Global Options - some of the Option Categories can include other sections that can apply to global settings. Typography, for example, allows you to specify various global options such as base font size.
',
'absolute-weaver' ),
'type' => 'html',
),
),
),
);
/**
* Subthemes
*/
global $wp_customize;
if ( ! $wp_customize->is_theme_active() ) { // must be in theme preview mode
$starting_sections['starting-subtheme'] = array(
'panel' => $panel,
'title' => __( 'Try a Pre-defined Subtheme', 'absolute-weaver' ),
'description' => __( 'When activated, Absolute Weaver will allow you to select from many pre-defined subthemes.', 'absolute-weaver' ),
'options' => array(
'subthemes_not_available' => array(
'control' => array(
'control_type' => 'Absolute_Weaver_Custom_Control',
'description' => __( 'Sorry, selecting Subthemes not available in Theme Preview Mode. If you just activated the theme, please refresh your browser window.', 'absolute-weaver' ),
'type' => 'HTML',
),
),
),
);
} else {
$starting_sections['starting-subtheme'] = array(
'panel' => $panel,
'title' => __( 'Try a Pre-defined Subtheme', 'absolute-weaver' ),
'options' => array(
'load_subtheme' => array(
'setting' => array(
'transport' => 'postMessage',
),
'control' => array(
'control_type' => 'Absolute_Weaver_Load_WA_Subtheme',
'label' => __( 'Predefined Absolute Weaver Subthemes', 'absolute-weaver' ),
'description' => __( 'Get a quick start on your site by selecting on of these predefined subthemes.
Once you\'ve picked a subtheme, you can tweak it to look just like you want.', 'absolute-weaver' ),
),
),
),
);
}
/**
* Help links
*/
// translators: all placeholder strings are translated links. HTML markup encouraged.
$help_desc = sprintf( __(
'Support Forum
Please see our active %1$s for online help.
Theme Documentation and Guide
See the %2$s for help using the Absolute Weaver Theme.
Theme Demo
%3$s
Live demo of Absolute Weaver and Absolute Weaver Plus features.
CSS Tutorial
Click for a short %4$s.
Supported Fonts
Click for demo of %5$s.
Release Notes
%6$s
', 'absolute-weaver' ),
absolute_weaver_site_link( '', '//forum.weavertheme.com/', __( 'Absolute Weaver Support Forum', 'absolute-weaver' ), false ),
absolute_weaver_site_link( '', '//guide.weavertheme.com/', __( 'Absolute Weaver Guide', 'absolute-weaver' ), false ),
absolute_weaver_site_link( '', '//demo.weavertheme.com/', __( 'Absolute Weaver Demo Site', 'absolute-weaver' ), false ),
absolute_weaver_help_link( 'css-help.html', __( 'Weaver CSS Help', 'absolute-weaver' ), esc_html__( 'CSS Tutorial', 'absolute-weaver' ), false ),
absolute_weaver_help_link( 'font-demo.html', __( 'Examples of supported fonts', 'absolute-weaver' ), esc_html__( 'Font Examples', 'absolute-weaver' ), false ),
absolute_weaver_release_notes()
);
// ===================
$name = absolute_weaver_getopt( 'themename' );
if ( ! $name ) {
$name = esc_html__( 'Please set theme name on the Advanced Options → Admin Options tab.', 'absolute-weaver' );
}
$local_mem_lim = ini_get( 'memory_limit' );
$server_mem_lim = get_cfg_var( 'memory_limit' );
$tech_info =
// translators: %1: theme name, $2: theme version, %3: style version, %4 subtheme name, %5 - local memory limit, %6 - server memory limit
sprintf( '
Absolute Weaver Technical Info
' . esc_html__( '%1$s %2$s | Options Version: %3$s | Subtheme: %4$s | PHP Memory Limit: Local - %5$s / Server - %6$s', 'absolute-weaver' ) . '',
esc_html( ABSOLUTE_WEAVER_THEMENAME ), esc_html( ABSOLUTE_WEAVER_VERSION ), esc_html( absolute_weaver_getopt( 'style_version' ) ), esc_html( $name ),
esc_html( $local_mem_lim ), esc_html( $server_mem_lim ) );
// ============
$starting_sections['starting-help'] = array(
'panel' => $panel,
'title' => __( 'Get Help for Absolute Weaver', 'absolute-weaver' ),
'description' => __( 'Read the Absolute Weaver Documentation', 'absolute-weaver' ),
'options' => array(
'starting-help-header' => array(
'control' => array(
'control_type' => 'Absolute_Weaver_Custom_Control',
'label' => __( 'Get Help', 'absolute-weaver' ),
'description' => $help_desc . $tech_info,
'type' => 'HTML',
),
),
),
);
/* recommended plugins */
$plugins = __('RECOMMENDED PLUGINS
Some recommended plugins to use with your Absolute Weaver Theme
The following plugin is highly recommended to enhance your Absolute Weaver Theme.
- Absolute Weaver Theme Support
- this plugin adds very useful features to the theme, including Saving and Restoring your design settings; custom HTML content areas for the header, menu, and footer; and global custom styling for your individual subthemes.
The following plugins are not essential, but can be useful when creating pages.
- Weaver Show Posts
- adds the [show_posts] shortcode to selectively display posts filtered by category, tag, order, id, etc.
- Weaver Show Sliders
- good for any kind of slideshows - images, posts, [gallery] replacement
- Widget Shortcode
- Adds [widget] shortcode which enables you to display any widget in any content area, including in the Block Editor!. This independent plugin is a great enhancement to Absolute Weaver.
', 'absolute-weaver');
$starting_sections['recommended-plugins'] = array(
'panel' => $panel,
'title' => __( 'Recommended Plugins', 'absolute-weaver' ),
'description' => __( 'Try these plugins to enhance your Absolute Weaver experience.', 'absolute-weaver' ) .
'
',
'options' => array(
'recpl-header' => array(
'control' => array(
'control_type' => 'Absolute_Weaver_Custom_Control',
'label' => __( 'Introduction', 'absolute-weaver' ),
// translators: HTML markup is allowed and encouraged for this translation
'description' => $plugins,
'type' => 'html',
),
),
),
);
return $starting_sections;
}
function absolute_weaver_release_notes() {
$notes = esc_url(absolute_weaver_relative_url( '' ) . 'readme.txt' );
$msg = esc_html__( 'View most recent release notes.', 'absolute-weaver' );
return '';
}