Slide 1

Slide 1 text

Using the WordPress Customizer to Build Beautiful Plugin Settings Pages Patrick Rauland @BFTrick

Slide 2

Slide 2 text

No content

Slide 3

Slide 3 text

Reading Can Be Difficult

Slide 4

Slide 4 text

No matter how clearly you write people will misinterpret your words.

Slide 5

Slide 5 text

No content

Slide 6

Slide 6 text

No content

Slide 7

Slide 7 text

No content

Slide 8

Slide 8 text

No content

Slide 9

Slide 9 text

No content

Slide 10

Slide 10 text

No content

Slide 11

Slide 11 text

7 Steps to Hijack the Customizer

Slide 12

Slide 12 text

1. Create a Button That Loads the Customizer

Slide 13

Slide 13 text

// get customizer url $url = admin_url( 'customize.php' );

Slide 14

Slide 14 text

array( 'title' => __( 'Customize!', 'woocommerce' ), 'desc' => __( 'Customize your product archive pages with the WordPress Customizer.', 'woocommerce' ), 'type' => 'wc_button', 'link' => $url ) WooCommerce Settings API: http://docs.woothemes.com/ document/settings-api/

Slide 15

Slide 15 text

No content

Slide 16

Slide 16 text

2. Load a Specific Page

Slide 17

Slide 17 text

// get special page $shop_page_url = get_permalink( wc_get_page_id( 'shop' ) ); // if we have a shop page go straight to it // the default will load the home page if ( $shop_page_url ) { $url = add_query_arg( 'url', urlencode( $shop_page_url ), $url ); }

Slide 18

Slide 18 text

No content

Slide 19

Slide 19 text

3. Add a Return URL

Slide 20

Slide 20 text

// get the return page $url = add_query_arg( 'return', urlencode( add_query_arg( array( 'page' => 'wc-settings', 'tab' => 'email' ), admin_url( 'admin.php' ) ) ), $url );

Slide 21

Slide 21 text

No content

Slide 22

Slide 22 text

4. Add a Flag in Customizer URL

Slide 23

Slide 23 text

$url = add_query_arg( 'wc-email-customizer', 'true', $url );

Slide 24

Slide 24 text

5. Hide Default Controls

Slide 25

Slide 25 text

add_filter( 'customize_control_active', 'control_filter', 10, 2 ); function control_filter( $active, $control ) { if ( in_array( $control->section, array( 'wc_email_header', 'wc_email_body', 'wc_email_footer', 'wc_email_send' ) ) ) { return true; } return false; }

Slide 26

Slide 26 text

global $wp_customize; $wp_customize->remove_section( 'themes' );

Slide 27

Slide 27 text

No content

Slide 28

Slide 28 text

6. Add New controls

Slide 29

Slide 29 text

$wp_customize->add_control( new WP_Customize_Image_Control( $wp_customize, 'wc_email_header_image_control', array( 'label' => __( 'Upload a Header', 'woocommerce' ), 'priority' => 10, 'section' => 'wc_email_header', 'settings' => 'woocommerce_email_header_image', ) ) );

Slide 30

Slide 30 text

// autofocus a section $url = add_query_arg( 'autofocus[section]', '{name of your section}', $url );

Slide 31

Slide 31 text

No content

Slide 32

Slide 32 text

7. Save Settings as Plugin Options

Slide 33

Slide 33 text

$wp_customize->add_setting( 'wc_email_background_color', array( 'type' => 'option', 'default' => '#f5f5f5', 'transport' => 'postMessage', ) );

Slide 34

Slide 34 text

No content

Slide 35

Slide 35 text

No matter how clearly you write people will misinterpret your words

Slide 36

Slide 36 text

Using the Customizer allows you to show users what a setting does

Slide 37

Slide 37 text

Patrick Rauland @BFTrick WooCommerce Product Manager WooThemes