Code Coverage
 
Lines
Functions and Methods
Classes and Traits
Total
34.72%
25 / 72
0.00%
0 / 4
 CRAP
0.00%
0 / 1
jetpack_mailchimp_subscriber_popup
0.00%
0 / 15
0.00%
0 / 1
 6
MailChimp_Subscriber_Popup
48.08%
25 / 52
0.00%
0 / 3
 120.63
0.00%
0 / 1
 reversal
0.00%
0 / 16
0.00%
0 / 1
 90
 build_shortcode_from_reversal_attrs
0.00%
0 / 8
0.00%
0 / 1
 20
 shortcode
89.29%
25 / 28
0.00%
0 / 1
 13.21
1<?php //phpcs:ignore WordPress.Files.FileName.InvalidClassFileName
2/**
3 * MailChimp Subscriber Popup Form shortcode
4 *
5 * Example:
6 * [mailchimp_subscriber_popup baseUrl="mc.us11.list-manage.com" uuid="1ca7856462585a934b8674c71" lid="2d24f1898b"]
7 *
8 * Embed code example:
9 * <script type="text/javascript" src="//downloads.mailchimp.com/js/signup-forms/popup/unique-methods/embed.js" data-dojo-config="usePlainJson: true, isDebug: false"></script><script type="text/javascript">window.dojoRequire(["mojo/signup-forms/Loader"], function(L) { L.start({"baseUrl":"mc.us11.list-manage.com","uuid":"1ca7856462585a934b8674c71","lid":"2d24f1898b","uniqueMethods":true}) })</script>
10 */
11
12if ( ! defined( 'ABSPATH' ) ) {
13    exit( 0 );
14}
15
16// phpcs:disable Universal.Files.SeparateFunctionsFromOO.Mixed -- TODO: Move classes to appropriately-named class files.
17
18/**
19 * Register [mailchimp_subscriber_popup] shortcode and add a filter to 'pre_kses' queue to reverse MailChimp embed to shortcode.
20 *
21 * @since 4.5.0
22 */
23function jetpack_mailchimp_subscriber_popup() {
24    add_shortcode(
25        'mailchimp_subscriber_popup',
26        array(
27            'MailChimp_Subscriber_Popup',
28            'shortcode',
29        )
30    );
31
32    if ( jetpack_shortcodes_should_hook_pre_kses() ) {
33        add_filter(
34            'pre_kses',
35            array(
36                'MailChimp_Subscriber_Popup',
37                'reversal',
38            )
39        );
40    }
41}
42
43if ( defined( 'IS_WPCOM' ) && IS_WPCOM ) {
44    add_action( 'init', 'jetpack_mailchimp_subscriber_popup' );
45} else {
46    jetpack_mailchimp_subscriber_popup();
47}
48
49/**
50 * Class MailChimp_Subscriber_Popup
51 *
52 * @since 4.5.0
53 */
54class MailChimp_Subscriber_Popup {
55
56    /**
57     * Regular expressions to reverse script tags to shortcodes.
58     *
59     * @var array
60     */
61    private static $reversal_regexes = array(
62        /* raw examplejs */
63        '/<script type="text\/javascript" src="(https?:)?\/\/downloads\.mailchimp\.com\/js\/signup-forms\/popup\/unique-methods\/embed\.js" data-dojo-config="([^"]*?)"><\/script><script type="text\/javascript">window.dojoRequire\(\["mojo\/signup-forms\/Loader"\]\, function\(L\) { L\.start\({([^}]*?)}\) }\)<\/script>/s', //phpcs:ignore
64        /* visual editor */
65        '/&lt;script type="text\/javascript" src="(https?:)?\/\/downloads\.mailchimp\.com\/js\/signup-forms\/popup\/unique-methods\/embed\.js" data-dojo-config="([^"]*?)"&gt;&lt;\/script&gt;&lt;script type="text\/javascript"&gt;window.dojoRequire\(\["mojo\/signup-forms\/Loader"]\, function\(L\) { L\.start\({([^}]*?)}\) }\)&lt;\/script&gt;/s',
66    );
67
68    /**
69     * Allowed configuration attributes. Used in reversal when checking allowed attributes.
70     *
71     * @var array
72     */
73    private static $allowed_config = array(
74        'usePlainJson' => 'true',
75        'isDebug'      => 'false',
76    );
77
78    /**
79     * Allowed JS variables. Used in reversal to whitelist variables.
80     *
81     * @var array
82     */
83    private static $allowed_js_vars = array(
84        'baseUrl',
85        'uuid',
86        'lid',
87    );
88
89    /**
90     * Runs the whole reversal.
91     *
92     * @since 4.5.0
93     *
94     * @param string $content Post Content.
95     *
96     * @return string Content with embeds replaced
97     */
98    public static function reversal( $content ) {
99        // Bail without the js src.
100        if ( ! is_string( $content ) || false === stripos( $content, 'downloads.mailchimp.com/js/signup-forms/popup/unique-methods/embed.js' ) ) {
101            return $content;
102        }
103
104        // loop through our rules and find valid embeds.
105        foreach ( self::$reversal_regexes as $regex ) {
106
107            if ( ! preg_match_all( $regex, $content, $matches ) ) {
108                continue;
109            }
110
111            foreach ( $matches[3] as $index => $js_vars ) {
112                // the regex rule for a specific embed.
113                $replace_regex = sprintf( '#\s*%s\s*#', preg_quote( $matches[0][ $index ], '#' ) );
114
115                $attrs = json_decode( '{' . $js_vars . '}' );
116
117                if ( $matches[2][ $index ] ) {
118                    $config_attrs = json_decode( '{' . $matches[2][ $index ] . '}' );
119                    foreach ( $config_attrs as $key => $value ) {
120                        $attrs->$key = ( 1 === $value ) ? 'true' : 'false';
121                    }
122                }
123
124                $shortcode = self::build_shortcode_from_reversal_attrs( $attrs );
125
126                $content = preg_replace( $replace_regex, "\n\n$shortcode\n\n", $content );
127
128                /** This action is documented in modules/widgets/social-media-icons.php */
129                do_action( 'jetpack_bump_stats_extras', 'html_to_shortcode', 'mailchimp_subscriber_popup' );
130            }
131        }
132
133        return $content;
134    }
135
136    /**
137     * Builds the actual shortcode based on passed in attributes.
138     *
139     * @since 4.5.0
140     *
141     * @param array $attrs A valid list of attributes (gets matched against self::$allowed_config and self::$allowed_js_vars).
142     *
143     * @return string
144     */
145    private static function build_shortcode_from_reversal_attrs( $attrs ) {
146        $shortcode = '[mailchimp_subscriber_popup ';
147
148        foreach ( $attrs as $key => $value ) {
149            // skip unsupported keys.
150            if (
151                ! array_key_exists( $key, self::$allowed_config )
152                && ! in_array( $key, self::$allowed_js_vars, true )
153            ) {
154                continue;
155            }
156
157            $value      = esc_attr( $value );
158            $shortcode .= "$key='$value' ";
159        }
160        return trim( $shortcode ) . ']';
161    }
162
163    /**
164     * Parses the shortcode back out to embedded information.
165     *
166     * @since 4.5.0
167     *
168     * @param array $lcase_attrs Lowercase shortcode attributes.
169     *
170     * @return string
171     */
172    public static function shortcode( $lcase_attrs ) {
173        static $displayed_once = false;
174
175        // Limit to one form per page load.
176        if ( $displayed_once ) {
177            return '';
178        }
179
180        if ( empty( $lcase_attrs ) ) {
181            return '<!-- Missing MailChimp baseUrl, uuid or lid -->';
182        }
183
184        $defaults = array_fill_keys( self::$allowed_js_vars, '' );
185        $defaults = array_merge( $defaults, self::$allowed_config );
186
187        // Convert $attrs back to proper casing since they come through in all lowercase.
188        $attrs = array();
189        foreach ( $defaults as $key => $value ) {
190            if ( array_key_exists( strtolower( $key ), $lcase_attrs ) ) {
191                $attrs[ $key ] = $lcase_attrs[ strtolower( $key ) ];
192            }
193        }
194        $attrs = array_map( 'esc_js', array_filter( shortcode_atts( $defaults, $attrs ) ) );
195
196        // Split config & js vars.
197        $js_vars     = array();
198        $config_vars = array();
199        foreach ( $attrs as $key => $value ) {
200            if (
201                'baseUrl' === $key
202                && (
203                    ! preg_match( '#mc\.us\d+\.list-manage\d?\.com#', $value, $matches )
204                    || $value !== $matches[0]
205                )
206            ) {
207                return '<!-- Invalid MailChimp baseUrl -->';
208            }
209
210            if ( in_array( $key, self::$allowed_js_vars, true ) ) {
211                $js_vars[ $key ] = $value;
212            } else {
213                $config_vars[] = "$key: $value";
214            }
215        }
216
217        // If one of these parameters is missing we can't render the form so exist.
218        if ( empty( $js_vars['baseUrl'] ) || empty( $js_vars['uuid'] ) || empty( $js_vars['lid'] ) ) {
219            return '<!-- Missing MailChimp baseUrl, uuid or lid -->';
220        }
221
222        // Add a uniqueMethods parameter if it is missing from the data we got from the embed code.
223        $js_vars['uniqueMethods'] = true;
224
225        /** This action is already documented in modules/widgets/gravatar-profile.php */
226        do_action( 'jetpack_stats_extra', 'mailchimp_subscriber_popup', 'view' );
227
228        $displayed_once = true;
229
230        return "\n\n" . '<script type="text/javascript" data-dojo-config="' . esc_attr( implode( ', ', $config_vars ) ) . '">jQuery.getScript( "//downloads.mailchimp.com/js/signup-forms/popup/unique-methods/embed.js", function( data, textStatus, jqxhr ) { window.dojoRequire(["mojo/signup-forms/Loader"], function(L) { L.start(' . wp_json_encode( $js_vars, JSON_UNESCAPED_SLASHES | JSON_HEX_TAG | JSON_HEX_AMP ) . ') });} );</script>' . "\n\n";
231    }
232}