From abdc856a111265fc9c99be8658ae211071312c47 Mon Sep 17 00:00:00 2001 From: Jonnyauk Date: Fri, 20 Mar 2015 11:57:44 +0000 Subject: [PATCH] New footer widget areas and code refactoring Add 2 new widget areas and tidy functions.php --- README.md | 2 +- footer-content.php | 22 ++++++++++++--- functions.php | 68 ++++++++++++++++++++++++++++++---------------- 3 files changed, 63 insertions(+), 29 deletions(-) diff --git a/README.md b/README.md index a149ab0..3d5289b 100644 --- a/README.md +++ b/README.md @@ -43,7 +43,7 @@ Theme features * Responsive layout * Automatic responsive menu for primary navigation * 2 editable menus (that auto-hide if not set in WordPress admin) -* 3 editable widget areas +* 5 editable widget areas Installation ================= diff --git a/footer-content.php b/footer-content.php index f2657a1..2e81dff 100644 --- a/footer-content.php +++ b/footer-content.php @@ -30,8 +30,15 @@
-

Footer primary left

-

I could contain any content you like - or why not put in a WordPress widget area?

+ + Footer primary 1'; + echo '

I can contain any WordPress widgets instead of this text, which will disappear if you use the Footer primary 1 widget area

'; + endif; + ?> +
@@ -39,8 +46,15 @@
-

Footer primary middle

-

I could contain any content you like - or why not put in a WordPress widget area?

+ + Footer primary 2'; + echo '

I can contain any WordPress widgets instead of this text, which will disappear if you use the Footer primary 2 widget area

'; + endif; + ?> +
diff --git a/functions.php b/functions.php index 885ace3..6264c78 100644 --- a/functions.php +++ b/functions.php @@ -32,7 +32,7 @@ */ -/* +/** * * Setup some Wonderflux layout options * @@ -58,11 +58,10 @@ function my_wfx_layout() { add_action('get_header', 'my_wfx_layout', 1); -/* - * Defines and inserts widget area using the Wonderflux display hook system - * Set "location" parameter to 'my_custom_theme_code' to stop auto-insertion - * IMPORTANT - if you use 'my_custom_theme_code' location, you must insert this - * using standard WordPress theme code for your widgets to show in your theme! +/** + * + * Defines and automatically inserts widget areas using the Wonderflux display hook system. + * If no 'location' set, you insert widget area as normal in theme file. * */ function my_wfx_widgets() { @@ -70,7 +69,7 @@ function my_wfx_widgets() { wfx_widgets( array ( - /* All parameters */ + /* All parameters - hooked into wfsidebar_before_all, so no template code */ array ( "name" => __( 'Above sidebar', 'wfxgider' ), "description" => __( 'Drag widgets here to be shown above the sidebar on all pages.', 'wfxgider' ), @@ -83,7 +82,7 @@ function my_wfx_widgets() { "after" => "" ), - /* Simpler example */ + /* Special - hooked into wfsidebar_after_home, so no template code */ array ( "name" => __( 'Below homepage sidebar', 'wfxgider' ), "description" => __( 'Drag widgets here to be shown below the sidebar, ONLY on the homepage.', 'wfxgider' ), @@ -93,13 +92,31 @@ function my_wfx_widgets() { "titlestyle" => "h4" ), - /* Special - just after homepage main content */ + /* Special - hooked into wfloop_after_found_posts_home, so no template code */ array ( "name" => __( 'Below content', 'wfxgider' ), "location" => "wfloop_after_found_posts_home", "description" => __( 'Drag widgets here to be shown below the main content, ONLY on the homepage.', 'wfxgider' ), "containerclass" => "box-1-1 widget-box widget-box-below-content", "titlestyle" => "h2" + ), + + /* Simple example - no auto insertion (no $location param) so have to put standard WP code in footer to appear */ + array ( + "name" => __( 'Footer primary 1', 'wfxgider' ), + "description" => __( 'Drag widgets here to be shown in the footer area (small left area)', 'wfxgider' ), + "titleclass" => "sidebar-title", + "containerclass" => "widget-box", + "titlestyle" => "h4" + ), + + /* Simple example - no auto insertion (no $location param) so have to put standard WP code in footer to appear */ + array ( + "name" => __( 'Footer primary 2', 'wfxgider' ), + "description" => __( 'Drag widgets here to be shown in the footer area (small right area)', 'wfxgider' ), + "titleclass" => "sidebar-title", + "containerclass" => "widget-box", + "titlestyle" => "h4" ) ) @@ -123,7 +140,8 @@ function my_wfx_widgets() { */ -/* +/** + * * EXAMPLE 1 - ADDING A FILTER * Core Wonderflux functionality can be filtered from child theme * @@ -136,6 +154,7 @@ function my_wfx_filter_my_wf_functions() { /** + * * EXAMPLE 2 - ADDING A FILTER * Adds additional responsive CSS classes via Wonderflux filters to sidebar and main content * @param [string] [$input] Core Wonderflux CSS classes @@ -149,7 +168,8 @@ function my_wfx_filter_layout_responsive( $input ){ add_filter( 'wflux_content_1_with_sidebar_1', 'my_wfx_filter_layout_responsive' ); -/* +/** + * * EXAMPLE 3 - UNHOOKING A CORE WONDERFLUX FUNCTION * Displays sizing configuration as comment in of document output * TODO: Core functionality needs updating for Wonderflux v2 @@ -161,17 +181,15 @@ function my_wfx_unhook_core_functions() { add_action('init','my_wfx_unhook_core_functions'); -/** - * EXAMPLE 4 - REPLACING A CORE WONDERFLUX FUNCTION (Remove comment to activate) - * By using the same function name as used in the Wonderflux functions.php file, - * we can override the existing core Wonderflux function. Often filters will be - * your best choice for tasks like this rather than replacing the whole function. - * - * Wonderflux also is fully OOP structured for more advanced modification, - * please see Wonderflux source files for more information (wf-includes directory) - * - */ -/* + /** + * EXAMPLE 4 - REPLACING A CORE WONDERFLUX FUNCTION (Remove comment to activate) + * By using the same function name as used in the Wonderflux functions.php file, + * we can override the existing core Wonderflux function. Often filters will be + * your best choice for tasks like this rather than replacing the whole function. + * + * Wonderflux also is fully OOP structured for more advanced modification, + * please see Wonderflux source files for more information (wf-includes directory) + */ function wfx_display_head_title() { $this_title = esc_attr( get_bloginfo( 'title', 'display' ) ); @@ -184,7 +202,6 @@ function wfx_display_head_title() { echo $output; } -*/ /** @@ -193,7 +210,6 @@ function wfx_display_head_title() { * * Un-comment the code below to override the options set in admin > Wonderflux > Stylelab * NOTE THAT FILTERS ALWAYS TAKE PRIORITY over saved admin options - * */ // function my_wfx_size_sidebar() { return 'quarter'; } // function my_wfx_size_content() { return 'three_quarter'; } @@ -225,7 +241,9 @@ function wfx_display_head_title() { /** + * * Setup menus + * */ function my_wfx_register_nav(){ register_nav_menus( array( @@ -237,6 +255,7 @@ function my_wfx_register_nav(){ /** + * * Insert primary navigation in a fancy way by hooking into layout * outside of main container (for full screen width) * NOTE: Won't render a menu if not set (or menu is empty) @@ -270,6 +289,7 @@ function my_wfx_insert_primary_nav() { /** + * * Insert footer navigation by using a Wonderflux hook * Could be removed and just inserted straight into template file as normal * NOTE: Won't render a menu if not set (or menu is empty)