Changeset 5603

Timestamp:

06/29/2017 07:13:33 PM (8 years ago)

Author:

coreymckrill

Message:

WordCamp Coming Soon: Add Customizer field for custom intro message

This adds a new setting and control to the Coming Soon Page section
in the Customizer. Content added to the Custom Message textarea will
replace the default message shown on the Coming Soon page beneath the
header. This allows organizers a bit more flexibility in what they
communicate to site visitors before the site is officially launched.

Fixes #2901
Props Kau-Boy

Location:

sites/trunk/wordcamp.org/public_html/wp-content/plugins/wordcamp-coming-soon-page

Files:

• classes/wccsp-customizer.php (modified) (1 diff)
• classes/wccsp-settings.php (modified) (1 diff)
• classes/wordcamp-coming-soon-page.php (modified) (2 diffs)
• views/template-coming-soon.php (modified) (1 diff)

sites/trunk/wordcamp.org/public_html/wp-content/plugins/wordcamp-coming-soon-page/classes/wccsp-customizer.php

@@ -128 +128 @@
             )
         );
+
+        $wp_customize->add_setting(
+            'wccsp_settings[introduction]',
+            array(
+                'default'           => '',
+                'type'              => 'option',
+                'capability'        => $GLOBALS['WCCSP_Settings']::REQUIRED_CAPABILITY,
+                'sanitize_callback' => array( $this, 'sanitize_introduction' ),
+            )
+        );
+
+        $wp_customize->add_control(
+            'wccsp_settings[introduction]',
+            array(
+                'label'       => __( 'Custom Message', 'wordcamporg' ),
+                'description' => __( 'This will replace the default message shown beneath the header.', 'wordcamporg' ),
+                'section'     => 'wccsp_live_preview',
+                'type'        => 'textarea',
+            )
+        );
+    }
+
+    /**
+     * Sanitize the contents of the Custom Message textarea before storing in the database.
+     *
+     * This uses the same sanitization strategy as menu item descriptions and post content in wp_insert_post.
+     *
+     * @param string $value The unsanitized introduction string.
+     *
+     * @return string The sanitized introduction string.
+     */
+    public function sanitize_introduction( $value ) {
+        return wp_unslash( apply_filters( 'content_save_pre', wp_slash( $value ) ) );
     }
 

sites/trunk/wordcamp.org/public_html/wp-content/plugins/wordcamp-coming-soon-page/classes/wccsp-settings.php

@@ -40 +40 @@
             'container_background_color' => '#FFFFFF', // deprecated
             'text_color'                 => '#000000', // deprecated
+            'introduction'               => '',
         );
 

sites/trunk/wordcamp.org/public_html/wp-content/plugins/wordcamp-coming-soon-page/classes/wordcamp-coming-soon-page.php

@@ -119 +119 @@
             'contact_form_shortcode' => $this->get_contact_form_shortcode(),
             'colors'                 => $this->get_colors(),
+            'introduction'           => $this->get_introduction(),
         );
 
@@ -272 +273 @@
         return $contact_form_shortcode;
     }
+
+    /**
+     * Retrieve the optional introduction overwriting the default string.
+     *
+     * @return string
+     */
+    public function get_introduction() {
+        $settings     = $GLOBALS['WCCSP_Settings']->get_settings();
+
+        return $settings['introduction'];
+    }
 } // end WordCamp_Coming_Soon_Page

sites/trunk/wordcamp.org/public_html/wp-content/plugins/wordcamp-coming-soon-page/views/template-coming-soon.php

@@ -42 +42 @@
             <div class="wccsp-introduction">
                 <p id="wccsp-introduction">
-                    <?php printf(
-                        // translators: %s is the name of the blog
-                        __(
-                            '%s is in the early planning stages. In the meantime, you can subscribe to updates above, or contact the organizers below to get involved.',
-                            'wordcamporg'
-                        ),
-                        esc_html( get_bloginfo( 'name' ) )
-                    ); ?>
+                    <?php if ( ! empty( $introduction ) ) : ?>
+                        <?php echo wp_kses_post( $introduction ); ?>
+                    <?php else : ?>
+                        <?php printf(
+                            /* translators: %s is the name of the blog. */
+                            __(
+                                '%s is in the early planning stages. In the meantime, you can subscribe to updates above, or contact the organizers below to get involved.',
+                                'wordcamporg'
+                            ),
+                            esc_html( get_bloginfo( 'name' ) )
+                        ); ?>
+                    <?php endif; ?>
                 </p>
             </div><!-- .wccsp-introduction -->