Changeset 38986 for trunk/src/wp-content/themes/twentyseventeen/inc/template-tags.php

Timestamp:

10/27/2016 10:08:33 PM (9 years ago)

Author:

davidakennedy

Message:

Twenty Seventeen: Improve user and developer experience with the customizer integration

• Rename customizer JS files to customize-preview.js and customize-controls.js to align with the core file naming and make it clearer where each file runs.
• Only show the colorscheme_hue control when there's a custom color scheme.
• Update preview JS handling for revised front page section handling, see below.
• Remove all references to "Theme Customizer" in code comments. It hasn't been called that since before 4.0.
• Clarify the purpose of the JS files by updated the code comments in the file headers.
• Improve code readability.
• Make the arbitrary number of front page sections filterable, for UI registration and output.
• Rename twentyseventeen_sanitize_layout to twentyseventeen_sanitize_page_layout to be clearer about what it sanitizes in case child themes or plugins consider reusing it.
• Rename page_options setting/control to page_layout as that's more reflective of what that option does; and again, helps for potential extensions.
• Make the page layout option contextual to pages and the sidebar being inactive, as the option only applies when there is no sidebar (per its description).
• Condense options into a single section.
• Add selective refresh for front page sections.
• Locate active_callback functions within customizer.php so that they're easier to find when editing customizer registrations, similarly to sanitize callbacks.
• Adjust the styling for placeholders for panels that aren't active.
• Ensure that the new visible edit shortcuts don't have any issues.

Props celloexpressions.

Fixes #38426.

File:

• trunk/src/wp-content/themes/twentyseventeen/inc/template-tags.php (modified) (1 diff)

trunk/src/wp-content/themes/twentyseventeen/inc/template-tags.php

@@ -126 +126 @@
 endif;
 
+/**
+ * Display a front page section.
+ *
+ * @param $partial WP_Customize_Partial Partial associated with a selective refresh request.
+ * @param $id integer Front page section to display.
+ */
+function twentyseventeen_front_page_section( $partial = null, $id = 0 ) {
+    if ( is_a( $partial, 'WP_Customize_Partial' ) ) {
+        // Find out the id and set it up during a selective refresh.
+        global $twentyseventeencounter;
+        $id = str_replace( 'panel_', '', $partial->id );
+        $twentyseventeencounter = $id;
+    }
+
+    global $post; // Modify the global post object before setting up post data.
+    if ( get_theme_mod( 'panel_' . $id ) ) {
+        global $post;
+        $post = get_post( get_theme_mod( 'panel_' . $id ) );
+        setup_postdata( $post );
+        set_query_var( 'panel', $id );
+
+        get_template_part( 'template-parts/page/content', 'front-page-panels' );
+
+        wp_reset_postdata();
+    } else {
+        // The output placeholder anchor.
+        echo '<article class="panel-placeholder panel twentyseventeen-panel twentyseventeen-panel' . $id . '" id="panel' . $id . '"><span class="twentyseventeen-panel-title">' . sprintf( __( 'Panel %1$s Placeholder', 'twentyseventeen' ), $id ) . '</span></article>';
+    }
+}
 
 /**