Code Coverage
 
Lines
Functions and Methods
Classes and Traits
Total
38.08%
222 / 583
26.32%
5 / 19
 CRAP
n/a
0 / 0
Automattic\Jetpack\Extensions\Donations\register_block
0.00%
0 / 10
0.00%
0 / 1
 6
Automattic\Jetpack\Extensions\Donations\render_block
0.00%
0 / 190
0.00%
0 / 1
 1190
Automattic\Jetpack\Extensions\Donations\render_email
100.00%
49 / 49
100.00%
1 / 1
 17
Automattic\Jetpack\Extensions\Donations\render_email_donate_button
75.00%
12 / 16
0.00%
0 / 1
 7.77
Automattic\Jetpack\Extensions\Donations\get_email_target_width
100.00%
8 / 8
100.00%
1 / 1
 6
Automattic\Jetpack\Extensions\Donations\build_security_data_attrs
100.00%
21 / 21
100.00%
1 / 1
 5
Automattic\Jetpack\Extensions\Donations\build_custom_styles
88.24%
90 / 102
0.00%
0 / 1
 22.79
Automattic\Jetpack\Extensions\Donations\build_border_decls
0.00%
0 / 23
0.00%
0 / 1
 132
Automattic\Jetpack\Extensions\Donations\build_radius_decls
0.00%
0 / 17
0.00%
0 / 1
 56
Automattic\Jetpack\Extensions\Donations\sanitize_css_value
100.00%
8 / 8
100.00%
1 / 1
 5
Automattic\Jetpack\Extensions\Donations\get_default_texts
100.00%
18 / 18
100.00%
1 / 1
 1
Automattic\Jetpack\Extensions\Donations\get_trigger_icon_svg
0.00%
0 / 26
0.00%
0 / 1
 20
Automattic\Jetpack\Extensions\Donations\load_editor_scripts
90.00%
9 / 10
0.00%
0 / 1
 2.00
Automattic\Jetpack\Extensions\Donations\amp_skip_post
0.00%
0 / 3
0.00%
0 / 1
 20
Automattic\Jetpack\Extensions\Donations\record_block_published_event
38.89%
7 / 18
0.00%
0 / 1
 27.49
Automattic\Jetpack\Extensions\Donations\collect_donation_blocks
0.00%
0 / 7
0.00%
0 / 1
 30
Automattic\Jetpack\Extensions\Donations\build_block_published_event_props
0.00%
0 / 33
0.00%
0 / 1
 30
Automattic\Jetpack\Extensions\Donations\has_custom_styles
0.00%
0 / 11
0.00%
0 / 1
 30
Automattic\Jetpack\Extensions\Donations\record_published_event
0.00%
0 / 7
0.00%
0 / 1
 30
1<?php
2/**
3 * Donations Block.
4 *
5 * @since 8.x
6 *
7 * @package automattic/jetpack
8 */
9
10namespace Automattic\Jetpack\Extensions\Donations;
11
12use Automattic\Jetpack\Blocks;
13use Automattic\Jetpack\Status\Host;
14use Automattic\Jetpack\Status\Request;
15use Automattic\Jetpack\Tracking;
16use Jetpack;
17use Jetpack_Gutenberg;
18use WP_Post;
19
20if ( ! defined( 'ABSPATH' ) ) {
21    exit( 0 );
22}
23
24/**
25 * Registers the block for use in Gutenberg
26 * This is done via an action so that we can disable
27 * registration if we need to.
28 */
29function register_block() {
30
31    require_once JETPACK__PLUGIN_DIR . '/modules/memberships/class-jetpack-memberships.php';
32    if ( \Jetpack_Memberships::should_enable_monetize_blocks_in_editor() ) {
33        Blocks::jetpack_register_block(
34            __DIR__,
35            array(
36                'render_callback'       => __NAMESPACE__ . '\render_block',
37                'render_email_callback' => __NAMESPACE__ . '\render_email',
38                'plan_check'            => true,
39            )
40        );
41    }
42}
43add_action( 'init', __NAMESPACE__ . '\register_block' );
44
45/**
46 * Donations block dynamic rendering.
47 *
48 * @param array  $attr    Array containing the Donations block attributes.
49 * @param string $content String containing the Donations block content.
50 *
51 * @return string
52 */
53function render_block( $attr, $content ) {
54    // Keep content as-is if rendered in other contexts than frontend (i.e. feed, emails, API, etc.).
55    if ( ! Request::is_frontend() ) {
56        $parsed = parse_blocks( $content );
57        if ( ! empty( $parsed[0] ) ) {
58            // Inject the link of the current post from the server side as the fallback link to make sure the donations block
59            // points to the correct post when it's inserted from the synced pattern (aka “My Pattern”).
60            $post_link                             = get_permalink();
61            $parsed[0]['attrs']['fallbackLinkUrl'] = $post_link;
62            $content                               = \render_block( $parsed[0] );
63            if ( preg_match( '/<a\s+class="jetpack-donations-fallback-link"\s+href="([^"]*)"/', $content, $matches ) ) {
64                $content = str_replace( $matches[1], $post_link, $content );
65            }
66        }
67
68        return $content;
69    }
70
71    require_once JETPACK__PLUGIN_DIR . 'modules/memberships/class-jetpack-memberships.php';
72
73    // If stripe isn't connected don't show anything to potential donors - they can't actually make a donation.
74    if ( ! \Jetpack_Memberships::has_connected_account() ) {
75        return '';
76    }
77
78    Jetpack_Gutenberg::load_assets_as_required( __DIR__ );
79
80    require_once JETPACK__PLUGIN_DIR . '/_inc/lib/class-jetpack-currencies.php';
81
82    $default_texts = get_default_texts();
83
84    // `array_merge` lets the user-supplied attributes override only the keys
85    // they actually set. Undefined keys (new blocks that have never been
86    // edited) fall back to the defaults in the first array. User-cleared
87    // keys (empty strings explicitly saved) win over defaults, so
88    // "blank stays blank" and "never set" gets the default.
89    // Treat `show !== false` as on, so legacy blocks (where `show` was never
90    // set on oneTimeDonation) still render the one-time interval by default.
91    $donations = array();
92    if ( false !== ( $attr['oneTimeDonation']['show'] ?? true ) ) {
93        $donations['one-time'] = array_merge(
94            array(
95                'planId'     => null,
96                'title'      => __( 'One-Time', 'jetpack' ),
97                'class'      => 'donations__one-time-item',
98                'heading'    => $default_texts['oneTimeDonation']['heading'],
99                'buttonText' => $default_texts['oneTimeDonation']['buttonText'],
100            ),
101            $attr['oneTimeDonation']
102        );
103    }
104    if ( $attr['monthlyDonation']['show'] ) {
105        $donations['1 month'] = array_merge(
106            array(
107                'planId'     => null,
108                'title'      => __( 'Monthly', 'jetpack' ),
109                'class'      => 'donations__monthly-item',
110                'heading'    => $default_texts['monthlyDonation']['heading'],
111                'buttonText' => $default_texts['monthlyDonation']['buttonText'],
112            ),
113            $attr['monthlyDonation']
114        );
115    }
116    if ( $attr['annualDonation']['show'] ) {
117        $donations['1 year'] = array_merge(
118            array(
119                'planId'     => null,
120                'title'      => __( 'Yearly', 'jetpack' ),
121                'class'      => 'donations__annual-item',
122                'heading'    => $default_texts['annualDonation']['heading'],
123                'buttonText' => $default_texts['annualDonation']['buttonText'],
124            ),
125            $attr['annualDonation']
126        );
127    }
128
129    $choose_amount_text = $attr['chooseAmountText'] ?? $default_texts['chooseAmountText'];
130    $custom_amount_text = $attr['customAmountText'] ?? $default_texts['customAmountText'];
131    $currency           = $attr['currency'];
132
133    // Drop intervals whose plan no longer resolves so we can compute the active tab
134    // against the actually-rendered set, not the configured set.
135    $valid_donations = array();
136    foreach ( $donations as $interval => $donation ) {
137        $plan = get_post( (int) $donation['planId'] );
138        if ( $plan && ! is_wp_error( $plan ) ) {
139            $valid_donations[ $interval ] = $donation;
140        }
141    }
142    $donations          = $valid_donations;
143    $rendered_intervals = array_keys( $donations );
144
145    // Effective default = configured defaultInterval if it survived plan validation,
146    // otherwise the first rendered interval (one-time → monthly → annual).
147    $default_interval = $attr['defaultInterval'] ?? null;
148    if ( ! in_array( $default_interval, $rendered_intervals, true ) ) {
149        $default_interval = $rendered_intervals[0] ?? null;
150    }
151    $tab_content_class_map = array(
152        'one-time' => 'is-one-time',
153        '1 month'  => 'is-monthly',
154        '1 year'   => 'is-annual',
155    );
156    $tab_content_class     = $default_interval ? $tab_content_class_map[ $default_interval ] : '';
157
158    $nav        = '';
159    $headings   = '';
160    $amounts    = '';
161    $extra_text = '';
162    $buttons    = '';
163    foreach ( $donations as $interval => $donation ) {
164        $plan_id = (int) $donation['planId'];
165
166        if ( count( $donations ) > 1 ) {
167            if ( ! $nav ) {
168                $nav .= '<div class="donations__nav">';
169            }
170            $is_active_class = $interval === $default_interval ? ' is-active' : '';
171            $nav            .= sprintf(
172                '<div role="button" tabindex="0" class="donations__nav-item%3$s" data-interval="%1$s">%2$s</div>',
173                esc_attr( $interval ),
174                esc_html( $donation['title'] ),
175                esc_attr( $is_active_class )
176            );
177        }
178        $heading_text = wp_kses_post( $donation['heading'] ?? '' );
179        if ( '' !== trim( $heading_text ) ) {
180            $headings .= sprintf(
181                '<h4 class="%1$s">%2$s</h4>',
182                esc_attr( $donation['class'] ),
183                $heading_text
184            );
185        }
186        $default_index_attr = '';
187        if ( isset( $donation['defaultAmountIndex'] ) && is_numeric( $donation['defaultAmountIndex'] ) ) {
188            $default_index_attr = sprintf( ' data-default-index="%d"', (int) $donation['defaultAmountIndex'] );
189        }
190        $amounts .= sprintf(
191            '<div class="donations__amounts %s"%s>',
192            esc_attr( $donation['class'] ),
193            $default_index_attr
194        );
195        foreach ( $donation['amounts'] as $amount ) {
196            $amounts .= sprintf(
197                '<div class="donations__amount" data-amount="%1$s">%2$s</div>',
198                esc_attr( $amount ),
199                esc_html( \Jetpack_Currencies::format_price( $amount, $currency ) )
200            );
201        }
202        $amounts        .= '</div>';
203        $extra_text_html = wp_kses_post( $donation['extraText'] ?? $default_texts['extraText'] );
204        if ( '' !== trim( $extra_text_html ) ) {
205            $extra_text .= sprintf(
206                '<p class="%1$s">%2$s</p>',
207                esc_attr( $donation['class'] ),
208                $extra_text_html
209            );
210        }
211        $buttons .= sprintf(
212            '<div class="wp-block-button donations__donate-button-wrapper %1$s"><a class="wp-block-button__link wp-element-button donations__donate-button %1$s" href="%2$s">%3$s</a></div>',
213            esc_attr( $donation['class'] ),
214            esc_url( \Jetpack_Memberships::get_instance()->get_subscription_url( $plan_id ) ),
215            wp_kses_post( $donation['buttonText'] )
216        );
217    }
218    if ( $nav ) {
219        $nav .= '</div>';
220    }
221
222    $custom_amount = '';
223    if ( $attr['showCustomAmount'] ) {
224        $custom_amount_html = wp_kses_post( $custom_amount_text );
225        if ( '' !== trim( $custom_amount_html ) ) {
226            $custom_amount .= sprintf( '<p>%s</p>', $custom_amount_html );
227        }
228        $default_custom_amount = $attr['customAmountPlaceholder']
229            ?? ( \Jetpack_Memberships::SUPPORTED_CURRENCIES[ $currency ] ?? 1 ) * 100;
230        $custom_amount        .= sprintf(
231            '<div class="donations__amount donations__custom-amount">
232                %1$s
233                <div class="donations__amount-value" data-currency="%2$s" data-empty-text="%3$s"></div>
234            </div>',
235            esc_html( \Jetpack_Currencies::CURRENCIES[ $currency ]['symbol'] ?? '¤' ),
236            esc_attr( $currency ),
237            esc_attr( \Jetpack_Currencies::format_price( $default_custom_amount, $currency, false ) )
238        );
239    }
240
241    $display_mode     = $attr['displayMode'] ?? 'inline';
242    $instance_id      = wp_unique_id( 'jp-donations-' );
243    $instance_classes = $instance_id;
244    if ( isset( $attr['tabsAppearance'] ) && 'buttons' === $attr['tabsAppearance'] ) {
245        $instance_classes .= ' is-style-buttons';
246    }
247    if ( 'modal' === $display_mode ) {
248        $instance_classes .= ' is-display-modal';
249        if ( ! empty( $attr['triggerSticky'] ) ) {
250            $instance_classes .= ' is-sticky';
251        }
252    }
253    $wrapper_attr_array = array( 'class' => $instance_classes );
254    if ( $default_interval ) {
255        $wrapper_attr_array['data-default-interval'] = $default_interval;
256    }
257    $wrapper_attr_array = array_merge( $wrapper_attr_array, build_security_data_attrs( $attr, $currency ) );
258    $wrapper_attrs      = get_block_wrapper_attributes( $wrapper_attr_array );
259    $custom_styles      = build_custom_styles( $attr, '.' . $instance_id );
260
261    $choose_amount_html  = wp_kses_post( $choose_amount_text );
262    $choose_amount_block = '' !== trim( $choose_amount_html ) ? '<p>' . $choose_amount_html . '</p>' : '';
263
264    if ( 'modal' === $display_mode ) {
265        $trigger_text     = $attr['triggerButtonText'] ?? $default_texts['triggerButtonText'];
266        $trigger_icon_key = $attr['triggerIcon'] ?? 'heart';
267        $trigger_svg      = get_trigger_icon_svg( $trigger_icon_key );
268        $modal_id         = $instance_id . '-modal';
269
270        return sprintf(
271            '
272<div %1$s>%9$s
273    <button
274        class="donations__trigger-button wp-block-button__link wp-element-button"
275        aria-haspopup="dialog"
276        aria-controls="%11$s"
277    >%12$s%10$s</button>
278    <div
279        id="%11$s"
280        class="donations__modal-overlay"
281        role="dialog"
282        aria-modal="true"
283        aria-label="%10$s"
284        hidden
285    >
286        <div class="donations__modal-dialog">
287            <button class="donations__modal-close" aria-label="%13$s">&#x2715;</button>
288            <div class="donations__modal-content">
289                <div class="donations__container">
290                    %2$s
291                    <div class="donations__content">
292                        <div class="donations__tab %14$s">
293                            %3$s
294                            %4$s
295                            %5$s
296                            %6$s
297                            <div class="donations__range-error"></div>
298                            <hr class="donations__separator">
299                            %7$s
300                            %8$s
301                        </div>
302                    </div>
303                </div>
304            </div>
305        </div>
306    </div>
307</div>
308',
309            $wrapper_attrs,
310            $nav,
311            $headings,
312            $choose_amount_block,
313            $amounts,
314            $custom_amount,
315            $extra_text,
316            $buttons,
317            $custom_styles ? '<style>' . $custom_styles . '</style>' : '',
318            esc_html( $trigger_text ),
319            esc_attr( $modal_id ),
320            $trigger_svg,
321            esc_attr__( 'Close', 'jetpack' ),
322            esc_attr( $tab_content_class )
323        );
324    }
325
326    return sprintf(
327        '
328<div %1$s>%9$s
329    <div class="donations__container">
330        %2$s
331        <div class="donations__content">
332            <div class="donations__tab %10$s">
333                %3$s
334                %4$s
335                %5$s
336                %6$s
337                <div class="donations__range-error"></div>
338                <hr class="donations__separator">
339                %7$s
340                %8$s
341            </div>
342        </div>
343    </div>
344</div>
345',
346        $wrapper_attrs,
347        $nav,
348        $headings,
349        $choose_amount_block,
350        $amounts,
351        $custom_amount,
352        $extra_text,
353        $buttons,
354        $custom_styles ? '<style>' . $custom_styles . '</style>' : '',
355        esc_attr( $tab_content_class )
356    );
357}
358
359/**
360 * WooCommerce Email Editor render callback for the Donations block.
361 *
362 * Builds a dedicated email version of the block from its attributes (rather than
363 * post-processing the interactive frontend markup) so customizations — per
364 * interval heading, supporting text and button label — are preserved. Each
365 * interval is rendered as an email-safe table section with a CTA button drawn by
366 * the Button block's own email renderer.
367 *
368 * @param string $block_content     The rendered block content (unused; we rebuild from attributes).
369 * @param array  $parsed_block      The parsed block data.
370 * @param object $rendering_context The email rendering context.
371 *
372 * @return string
373 */
374function render_email( $block_content, array $parsed_block, $rendering_context ) {
375    if ( ! isset( $parsed_block['attrs'] ) || ! is_array( $parsed_block['attrs'] )
376        || ! function_exists( '\Automattic\Jetpack\Extensions\Button\render_email' )
377        || ! class_exists( '\Automattic\WooCommerce\EmailEditor\Integrations\Utils\Table_Wrapper_Helper' ) ) {
378        return '';
379    }
380
381    $attr          = $parsed_block['attrs'];
382    $default_texts = get_default_texts();
383
384    $url = get_permalink();
385    if ( ! is_string( $url ) || '' === $url ) {
386        $url = is_string( $attr['fallbackLinkUrl'] ?? null ) && '' !== $attr['fallbackLinkUrl'] ? $attr['fallbackLinkUrl'] : '#';
387    }
388
389    $alignment   = in_array( $attr['contentAlignment'] ?? '', array( 'left', 'center', 'right' ), true ) ? $attr['contentAlignment'] : 'left';
390    $table_style = sprintf( 'width:100%%;max-width:%dpx;border-collapse:collapse;', get_email_target_width( $rendering_context ) );
391
392    $sections = '';
393    foreach ( array(
394        'oneTimeDonation' => true,
395        'monthlyDonation' => false,
396        'annualDonation'  => false,
397    ) as $key => $default_show ) {
398        $interval = is_array( $attr[ $key ] ?? null ) ? $attr[ $key ] : array();
399        if ( false === ( $interval['show'] ?? $default_show ) ) {
400            continue;
401        }
402
403        $heading = wp_kses_post( $interval['heading'] ?? $default_texts[ $key ]['heading'] );
404        $extra   = wp_kses_post( $interval['extraText'] ?? $default_texts['extraText'] );
405
406        $content = '';
407        if ( '' !== trim( wp_strip_all_tags( $heading ) ) ) {
408            $content .= sprintf(
409                '<p style="margin:0 0 4px;font-size:18px;font-weight:700;line-height:1.3;text-align:%s;">%s</p>',
410                esc_attr( $alignment ),
411                $heading
412            );
413        }
414        if ( '' !== trim( wp_strip_all_tags( $extra ) ) ) {
415            $content .= sprintf(
416                '<p style="margin:0 0 14px;font-size:15px;line-height:1.5;text-align:%s;">%s</p>',
417                esc_attr( $alignment ),
418                $extra
419            );
420        }
421        $content .= render_email_donate_button( $interval['buttonText'] ?? $default_texts[ $key ]['buttonText'], $url, $attr, $rendering_context );
422
423        $is_first   = '' === $sections;
424        $cell_style = sprintf(
425            'text-align:%1$s;padding:%2$s;%3$s',
426            esc_attr( $alignment ),
427            $is_first ? '0 0 24px' : '24px 0',
428            $is_first ? '' : 'border-top:1px solid #e0e0e0;'
429        );
430        $sections  .= \Automattic\WooCommerce\EmailEditor\Integrations\Utils\Table_Wrapper_Helper::render_table_wrapper(
431            $content,
432            array( 'style' => $table_style ),
433            array( 'style' => $cell_style )
434        );
435    }
436
437    return $sections;
438}
439
440/**
441 * Render a single donation CTA as an email-safe button via the Button block's
442 * email renderer, carrying over the donation block's button styling.
443 *
444 * @param string $text              Button label.
445 * @param string $url               Button destination.
446 * @param array  $attr              Donations block attributes.
447 * @param object $rendering_context The email rendering context.
448 * @return string
449 */
450function render_email_donate_button( $text, $url, $attr, $rendering_context ) {
451    $text = trim( wp_strip_all_tags( (string) $text ) );
452
453    $button_attrs = array(
454        'text' => '' !== $text ? $text : __( 'Donate', 'jetpack' ),
455        'url'  => $url,
456    );
457
458    if ( ! empty( $attr['buttonFontSize'] ) && is_string( $attr['buttonFontSize'] ) ) {
459        $button_attrs['customFontSize'] = $attr['buttonFontSize'];
460    }
461    if ( isset( $attr['buttonBorderRadius'] ) && is_string( $attr['buttonBorderRadius'] ) ) {
462        $radius = (int) $attr['buttonBorderRadius'];
463        if ( $radius > 0 ) {
464            $button_attrs['borderRadius'] = $radius;
465        }
466    }
467
468    return \Automattic\Jetpack\Extensions\Button\render_email(
469        '',
470        array( 'attrs' => $button_attrs ),
471        $rendering_context
472    );
473}
474
475/**
476 * Resolve the target content width (in px) from the email rendering context,
477 * falling back to a sensible default.
478 *
479 * @param object $rendering_context The email rendering context.
480 * @return int Width in pixels.
481 */
482function get_email_target_width( $rendering_context ) {
483    $target_width = 600;
484    if ( is_object( $rendering_context ) && method_exists( $rendering_context, 'get_layout_width_without_padding' ) ) {
485        $width = $rendering_context->get_layout_width_without_padding();
486        if ( is_string( $width ) && preg_match( '/(\d+)px/', $width, $matches ) ) {
487            $parsed = (int) $matches[1];
488            if ( $parsed > 0 ) {
489                $target_width = $parsed;
490            }
491        }
492    }
493    return $target_width;
494}
495
496/**
497 * Build data-attributes array for security (min/max amount) constraints.
498 *
499 * Extracted so it can be tested independently of the full render pipeline.
500 *
501 * @since 15.9
502 *
503 * @param array  $attr     Block attributes.
504 * @param string $currency Currency code (e.g. 'USD').
505 * @return array Associative array of data-attribute name => value.
506 */
507function build_security_data_attrs( $attr, $currency ) {
508    $attrs      = array();
509    $min_amount = isset( $attr['minimumAmount'] ) ? (float) $attr['minimumAmount'] : null;
510    $max_amount = isset( $attr['maximumAmount'] ) ? (float) $attr['maximumAmount'] : null;
511    if ( null !== $min_amount ) {
512        $attrs['data-min-amount'] = $min_amount;
513        $attrs['data-min-error']  = sprintf(
514            /* translators: %s: minimum donation amount formatted with currency symbol */
515            __( 'The minimum donation amount is %s.', 'jetpack' ),
516            \Jetpack_Currencies::format_price( (string) $min_amount, $currency )
517        );
518    }
519    if ( null !== $max_amount ) {
520        $attrs['data-max-amount'] = $max_amount;
521        $attrs['data-max-error']  = sprintf(
522            /* translators: %s: maximum donation amount formatted with currency symbol */
523            __( 'The maximum donation amount is %s.', 'jetpack' ),
524            \Jetpack_Currencies::format_price( (string) $max_amount, $currency )
525        );
526    }
527    $stripe_min                     = \Jetpack_Memberships::SUPPORTED_CURRENCIES[ $currency ] ?? 1;
528    $attrs['data-stripe-min-error'] = sprintf(
529        /* translators: %s: payment processor minimum donation amount formatted with currency symbol */
530        _x( 'The minimum donation amount is %s.', 'payment processor minimum', 'jetpack' ),
531        \Jetpack_Currencies::format_price( (string) $stripe_min, $currency )
532    );
533    return $attrs;
534}
535
536/**
537 * Build a CSS string scoping per-state and tab-level style rules to a single
538 * block instance.
539 *
540 * @param array  $attr  Block attributes.
541 * @param string $scope CSS class selector (with leading dot) unique to this instance.
542 * @return string CSS rules joined into one string, or '' when no overrides are set.
543 */
544function build_custom_styles( $attr, $scope ) {
545    $tab_padding    = isset( $attr['tabPadding'] ) && is_array( $attr['tabPadding'] ) ? $attr['tabPadding'] : array();
546    $button_padding = isset( $attr['buttonPadding'] ) && is_array( $attr['buttonPadding'] ) ? $attr['buttonPadding'] : array();
547
548    $groups = array(
549        array(
550            'selector'   => $scope . ' .donations__nav-item',
551            'properties' => array(
552                'font-size'      => $attr['tabFontSize'] ?? '',
553                'padding-top'    => $tab_padding['top'] ?? '',
554                'padding-right'  => $tab_padding['right'] ?? '',
555                'padding-bottom' => $tab_padding['bottom'] ?? '',
556                'padding-left'   => $tab_padding['left'] ?? '',
557            ),
558        ),
559        array(
560            'selector'   => $scope . ' .donations__nav-item.is-active',
561            'properties' => array(
562                'background' => $attr['activeTabBackgroundColor'] ?? '',
563                'color'      => $attr['activeTabTextColor'] ?? '',
564            ),
565        ),
566        array(
567            'selector'   => $scope . ' .donations__nav-item:not(.is-active)',
568            'properties' => array(
569                'background' => $attr['inactiveTabBackgroundColor'] ?? '',
570                'color'      => $attr['inactiveTabTextColor'] ?? '',
571            ),
572        ),
573        array(
574            'selector'   => $scope . ' .donations__amount.is-selected',
575            'properties' => array(
576                'background-color' => $attr['selectedAmountBackgroundColor'] ?? '',
577                'color'            => $attr['selectedAmountTextColor'] ?? '',
578            ),
579        ),
580        array(
581            'selector'   => $scope . ' .donations__amount.is-selected',
582            'properties' => array(
583                // Override only the outer ring color; the inner 1px white separator stays put.
584                'box-shadow' => isset( $attr['selectedAmountOutlineColor'] ) && '' !== $attr['selectedAmountOutlineColor']
585                    ? '0 0 0 1px #fff,0 0 0 3px ' . $attr['selectedAmountOutlineColor']
586                    : '',
587            ),
588        ),
589        array(
590            'selector'   => $scope . ' .donations__donate-button',
591            'properties' => array(
592                'font-size'      => $attr['buttonFontSize'] ?? '',
593                'padding-top'    => $button_padding['top'] ?? '',
594                'padding-right'  => $button_padding['right'] ?? '',
595                'padding-bottom' => $button_padding['bottom'] ?? '',
596                'padding-left'   => $button_padding['left'] ?? '',
597            ),
598        ),
599    );
600
601    $rules = array();
602
603    $content_alignment = $attr['contentAlignment'] ?? '';
604    if ( in_array( $content_alignment, array( 'left', 'center', 'right' ), true ) ) {
605        $rules[]     = $scope . ' .donations__content{text-align:' . $content_alignment . '}';
606        $justify_map = array(
607            'left'   => 'flex-start',
608            'center' => 'center',
609            'right'  => 'flex-end',
610        );
611        $rules[]     = $scope . ' .donations__amounts{justify-content:' . $justify_map[ $content_alignment ] . '}';
612    }
613
614    foreach ( $groups as $group ) {
615        $decls = array();
616        foreach ( $group['properties'] as $property => $value ) {
617            $safe = sanitize_css_value( $value );
618            if ( '' !== $safe ) {
619                $decls[] = $property . ':' . $safe;
620            }
621        }
622        if ( $decls ) {
623            $rules[] = $group['selector'] . '{' . implode( ';', $decls ) . '}';
624        }
625    }
626
627    // User-set tab border color: applies to the default-style nav bottom
628    // divider, the per-tab dividers, and the buttons-style pill borders.
629    $tab_border_safe = sanitize_css_value( $attr['tabBorderColor'] ?? '' );
630    if ( '' !== $tab_border_safe ) {
631        $rules[] = $scope . ' .donations__nav,' . $scope . ' .donations__nav-item,' . $scope . ' .donations__nav-item.is-active{border-color:' . $tab_border_safe . '}';
632    }
633
634    $button_radius_decls = build_radius_decls( $attr['buttonBorderRadius'] ?? null );
635    if ( $button_radius_decls ) {
636        $rules[] = $scope . ' .donations__donate-button{' . implode( ';', $button_radius_decls ) . '}';
637    }
638
639    // User-set amount tile font size, border (BorderBoxControl shape) and
640    // border radius (BorderRadiusControl shape). Applies to all amount tiles
641    // (preset + custom); selected-state colors above only kick in when an
642    // amount has the is-selected class.
643    $amount_decls = array();
644    $amount_font  = sanitize_css_value( $attr['amountFontSize'] ?? '' );
645    if ( '' !== $amount_font ) {
646        $amount_decls[] = 'font-size:' . $amount_font;
647    }
648    $amount_decls = array_merge( $amount_decls, build_border_decls( $attr['amountBorder'] ?? null ) );
649    $amount_decls = array_merge( $amount_decls, build_radius_decls( $attr['amountBorderRadius'] ?? null ) );
650    if ( $amount_decls ) {
651        $rules[] = $scope . ' .donations__amount{' . implode( ';', $amount_decls ) . '}';
652    }
653
654    $button_alignment = $attr['buttonAlignment'] ?? '';
655    if ( in_array( $button_alignment, array( 'left', 'center', 'right' ), true ) ) {
656        $rules[] = $scope . ' .donations__donate-button-wrapper{text-align:' . $button_alignment . '}';
657    } elseif ( 'full' === $button_alignment ) {
658        $rules[] = $scope . ' .donations__donate-button-wrapper{display:block;width:100%}'
659            . $scope . ' .donations__donate-button{display:block;width:100%;box-sizing:border-box;text-align:center}';
660    }
661
662    // Pop-up display mode: wire up trigger-button alignment via text-align on
663    // the wrapper so the inline-flex button responds to the alignment toolbar.
664    if ( 'modal' === ( $attr['displayMode'] ?? 'inline' ) ) {
665        if ( in_array( $content_alignment, array( 'left', 'center', 'right' ), true ) ) {
666            $rules[] = $scope . '{text-align:' . $content_alignment . '}';
667        }
668    }
669
670    // Wrapper border (In-page mode only). Compound selector (.wp-block-jetpack-donations.jp-donations-N)
671    // has specificity 0,2,0 and wins over the default single-class rule (0,1,0) in common.scss.
672    if ( 'modal' !== ( $attr['displayMode'] ?? 'inline' ) ) {
673        $wrapper_border_decls = array_merge(
674            build_border_decls( $attr['blockBorder'] ?? null ),
675            build_radius_decls( $attr['blockBorderRadius'] ?? null )
676        );
677        if ( $wrapper_border_decls ) {
678            $rules[] = '.wp-block-jetpack-donations' . $scope . '{' . implode( ';', $wrapper_border_decls ) . '}';
679        }
680    }
681
682    return implode( '', $rules );
683}
684
685/**
686 * Convert a uniform-or-split BorderBoxControl value into individual CSS declarations.
687 * Uniform shape: { color, style, width }. Split shape: { top: {...}, right: ..., etc. }.
688 *
689 * @param mixed $border BorderBoxControl value (or null).
690 * @return array List of CSS declaration strings (e.g. "border-color:#abc"), already sanitized.
691 */
692function build_border_decls( $border ) {
693    if ( ! is_array( $border ) ) {
694        return array();
695    }
696    $decls    = array();
697    $sides    = array( 'top', 'right', 'bottom', 'left' );
698    $is_split = false;
699    foreach ( $sides as $side ) {
700        if ( isset( $border[ $side ] ) ) {
701            $is_split = true;
702            break;
703        }
704    }
705    if ( $is_split ) {
706        foreach ( $sides as $side ) {
707            $sb = $border[ $side ] ?? null;
708            if ( ! is_array( $sb ) ) {
709                continue;
710            }
711            foreach ( array( 'color', 'style', 'width' ) as $prop ) {
712                $safe = sanitize_css_value( $sb[ $prop ] ?? '' );
713                if ( '' !== $safe ) {
714                    $decls[] = 'border-' . $side . '-' . $prop . ':' . $safe;
715                }
716            }
717        }
718    } else {
719        foreach ( array( 'color', 'style', 'width' ) as $prop ) {
720            $safe = sanitize_css_value( $border[ $prop ] ?? '' );
721            if ( '' !== $safe ) {
722                $decls[] = 'border-' . $prop . ':' . $safe;
723            }
724        }
725    }
726    return $decls;
727}
728
729/**
730 * Convert a uniform-or-per-corner BorderRadiusControl value into CSS declarations.
731 * Uniform shape: a string like "8px". Per-corner shape:
732 * { topLeft, topRight, bottomRight, bottomLeft } each with string values.
733 *
734 * @param mixed $radius BorderRadiusControl value (or null).
735 * @return array List of CSS declaration strings.
736 */
737function build_radius_decls( $radius ) {
738    if ( is_string( $radius ) && '' !== $radius ) {
739        $safe = sanitize_css_value( $radius );
740        return '' !== $safe ? array( 'border-radius:' . $safe ) : array();
741    }
742    if ( ! is_array( $radius ) ) {
743        return array();
744    }
745    $corners = array(
746        'topLeft'     => 'border-top-left-radius',
747        'topRight'    => 'border-top-right-radius',
748        'bottomRight' => 'border-bottom-right-radius',
749        'bottomLeft'  => 'border-bottom-left-radius',
750    );
751    $decls   = array();
752    foreach ( $corners as $key => $css_prop ) {
753        $safe = sanitize_css_value( $radius[ $key ] ?? '' );
754        if ( '' !== $safe ) {
755            $decls[] = $css_prop . ':' . $safe;
756        }
757    }
758    return $decls;
759}
760
761/**
762 * Sanitize a user-supplied CSS value (color, length, etc.) for safe inclusion
763 * in a <style> element. Strips characters that could break out of the style
764 * context (<, >, {, }, ;, quotes, backslash) and caps length, while leaving
765 * valid hex / rgb() / hsl() / var() / named-color / px / rem / em values intact.
766 *
767 * @param mixed $value Raw attribute value.
768 * @return string Sanitized value, or '' if rejected.
769 */
770function sanitize_css_value( $value ) {
771    if ( ! is_string( $value ) || '' === $value ) {
772        return '';
773    }
774    $value = trim( $value );
775    if ( strlen( $value ) > 100 ) {
776        return '';
777    }
778    if ( preg_match( '/[<>{};\\\\\'"]/', $value ) ) {
779        return '';
780    }
781    return $value;
782}
783
784/**
785 * Get the default texts for the block.
786 *
787 * @return array
788 */
789function get_default_texts() {
790    return array(
791        'chooseAmountText'  => __( 'Choose an amount', 'jetpack' ),
792        'customAmountText'  => __( 'Or enter a custom amount', 'jetpack' ),
793        'extraText'         => __( 'Your contribution is appreciated.', 'jetpack' ),
794        'triggerButtonText' => __( 'Donate', 'jetpack' ),
795        'oneTimeDonation'   => array(
796            'heading'    => __( 'Make a one-time donation', 'jetpack' ),
797            'buttonText' => __( 'Donate', 'jetpack' ),
798        ),
799        'monthlyDonation'   => array(
800            'heading'    => __( 'Make a monthly donation', 'jetpack' ),
801            'buttonText' => __( 'Donate monthly', 'jetpack' ),
802        ),
803        'annualDonation'    => array(
804            'heading'    => __( 'Make a yearly donation', 'jetpack' ),
805            'buttonText' => __( 'Donate yearly', 'jetpack' ),
806        ),
807    );
808}
809
810/**
811 * Return inline SVG markup for a trigger button icon.
812 *
813 * Path data sourced from icons.js ICON_SVG_PATHS — keep in sync.
814 *
815 * @param string $icon_key Icon key (e.g. 'coffee', 'heart', 'gift').
816 * @return string SVG HTML string, or '' when key is 'none' or unknown.
817 */
818function get_trigger_icon_svg( $icon_key ) {
819    $paths = array(
820        'heart'      => array( 'd' => 'M16.5 4.5c2.206 0 4 1.794 4 4 0 4.67-5.543 8.94-8.5 11.023C9.043 17.44 3.5 13.17 3.5 8.5c0-2.206 1.794-4 4-4 1.298 0 2.522.638 3.273 1.706L12 7.953l1.227-1.746c.75-1.07 1.975-1.707 3.273-1.707m0-1.5c-1.862 0-3.505.928-4.5 2.344C11.005 3.928 9.362 3 7.5 3 4.462 3 2 5.462 2 8.5c0 5.72 6.5 10.438 10 12.85 3.5-2.412 10-7.13 10-12.85C22 5.462 19.538 3 16.5 3z' ),
821        'gift'       => array( 'd' => 'M15.333 4C16.6677 4 17.75 5.0823 17.75 6.41699V6.75C17.75 7.20058 17.6394 7.62468 17.4473 8H18.5C19.2767 8 19.9154 8.59028 19.9922 9.34668L20 9.5V18.5C20 19.3284 19.3284 20 18.5 20H5.5C4.72334 20 4.08461 19.4097 4.00781 18.6533L4 18.5V9.5L4.00781 9.34668C4.07949 8.64069 4.64069 8.07949 5.34668 8.00781L5.5 8H6.55273C6.36065 7.62468 6.25 7.20058 6.25 6.75V6.41699C6.25 5.0823 7.3323 4 8.66699 4C10.0436 4.00011 11.2604 4.68183 12 5.72559C12.7396 4.68183 13.9564 4.00011 15.333 4ZM5.5 18.5H11.25V9.5H5.5V18.5ZM12.75 18.5H18.5V9.5H12.75V18.5ZM8.66699 5.5C8.16073 5.5 7.75 5.91073 7.75 6.41699V6.75C7.75 7.44036 8.30964 8 9 8H11.2461C11.2021 6.61198 10.0657 5.50017 8.66699 5.5ZM15.333 5.5C13.9343 5.50017 12.7979 6.61198 12.7539 8H15C15.6904 8 16.25 7.44036 16.25 6.75V6.41699C16.25 5.91073 15.8393 5.5 15.333 5.5Z' ),
822        'star'       => array( 'd' => 'M11.776 4.454a.25.25 0 01.448 0l2.069 4.192a.25.25 0 00.188.137l4.626.672a.25.25 0 01.139.426l-3.348 3.263a.25.25 0 00-.072.222l.79 4.607a.25.25 0 01-.362.263l-4.138-2.175a.25.25 0 00-.232 0l-4.138 2.175a.25.25 0 01-.363-.263l.79-4.607a.25.25 0 00-.071-.222L4.754 9.881a.25.25 0 01.139-.426l4.626-.672a.25.25 0 00.188-.137l2.069-4.192z' ),
823        'thumbs-up'  => array( 'd' => 'm3 12 1 8h1.5l-1-8H3Zm15.8-2h-4.4l.8-3.6c.3-1.3-.7-2.4-1.9-2.4h-.2c-.6 0-1.2.3-1.6.8l-5 6.6c-.3.4-.4.8-.4 1.2v.2l.7 5.4v.2c.2.9 1 1.5 1.9 1.5h8.2c.9 0 1.7-.6 1.9-1.4l1.8-6c.4-1.3-.6-2.6-1.9-2.6Zm.5 2.1-1.8 6c0 .2-.3.4-.5.4H8.8c-.3 0-.5-.2-.5-.4l-.7-5.4v-.4l5-6.6c0-.1.2-.2.4-.2h.2c.3 0 .6.3.5.6l-.8 3.6c-.1.4 0 .9.3 1.3s.7.6 1.2.6h4.4c.3 0 .6.3.5.6Z' ),
824        'smiley'     => array( 'd' => 'M11.99 2C6.47 2 2 6.48 2 12s4.47 10 9.99 10C17.52 22 22 17.52 22 12S17.52 2 11.99 2zM12 20c-4.42 0-8-3.58-8-8s3.58-8 8-8 8 3.58 8 8-3.58 8-8 8zm3.5-9c.83 0 1.5-.67 1.5-1.5S16.33 8 15.5 8 14 8.67 14 9.5 14.67 11 15.5 11zm-7 0c.83 0 1.5-.67 1.5-1.5S9.33 8 8.5 8 7 8.67 7 9.5 7.67 11 8.5 11zm3.5 6.5c2.33 0 4.31-1.46 5.11-3.5H6.89c.8 2.04 2.78 3.5 5.11 3.5z' ),
825        'coffee'     => array(
826            'd'         => 'M6.5 5h11v3.25h1a2 2 0 010 4H17.5v1.25a3 3 0 01-3 3H9.5a3 3 0 01-3-3V5zm1.5 1.5v7.25a1.5 1.5 0 001.5 1.5h5a1.5 1.5 0 001.5-1.5V6.5h-8zm10 2.5H17.5v2h.5a1 1 0 000-2zM5 20h14V18.5H5z',
827            'fill-rule' => 'evenodd',
828        ),
829        'tip-jar'    => array( 'd' => 'M9 3h6c0-1.1-.9-2-2-2H11C9.9 1 9 1.9 9 3zm7 0H8c-.55 0-1 .45-1 1v1.5c0 .55.45 1 1 1h8c.55 0 1-.45 1-1V4c0-.55-.45-1-1-1zm-1 3.5H9V19c0 1.1.9 2 2 2h2c1.1 0 2-.9 2-2V6.5zm-3 1.5h2v1.5l-1 1.5-1-1.5V8z' ),
830        'hand-heart' => array( 'd' => 'M15.5 2.1c-1.1 0-2 .6-2.5 1.4-.5-.9-1.4-1.4-2.5-1.4C8.8 2.1 7.5 3.4 7.5 5c0 2.5 4.5 5.9 5.5 6.6 1-.7 5.5-4.1 5.5-6.6 0-1.6-1.3-2.9-3-2.9zM9 14H7l-2 7h14l-2-7h-2l-1 3H10l-1-3z' ),
831        'people'     => array(
832            'd'         => 'M15.5 9.5a1 1 0 100-2 1 1 0 000 2zm0 1.5a2.5 2.5 0 100-5 2.5 2.5 0 000 5zm-2.25 6v-2a2.75 2.75 0 00-2.75-2.75h-4A2.75 2.75 0 003.75 15v2h1.5v-2c0-.69.56-1.25 1.25-1.25h4c.69 0 1.25.56 1.25 1.25v2h1.5zm7-2v2h-1.5v-2c0-.69-.56-1.25-1.25-1.25H15v-1.5h2.5A2.75 2.75 0 0120.25 15zM9.5 8.5a1 1 0 11-2 0 1 1 0 012 0zm1.5 0a2.5 2.5 0 11-5 0 2.5 2.5 0 015 0z',
833            'fill-rule' => 'evenodd',
834        ),
835    );
836
837    if ( ! isset( $paths[ $icon_key ] ) || 'none' === $icon_key ) {
838        return '';
839    }
840
841    $icon        = $paths[ $icon_key ];
842    $extra_attrs = isset( $icon['fill-rule'] ) ? ' fill-rule="' . esc_attr( $icon['fill-rule'] ) . '"' : '';
843
844    return sprintf(
845        '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="20" height="20" aria-hidden="true" focusable="false" class="donations__trigger-icon"><path d="%s"%s/></svg>',
846        esc_attr( $icon['d'] ),
847        $extra_attrs
848    );
849}
850
851/**
852 * Make default texts available to the editor.
853 */
854function load_editor_scripts() {
855    // Only relevant to the editor right now.
856    if ( ! is_admin() ) {
857        return;
858    }
859
860    $data = array(
861        'defaultTexts' => get_default_texts(),
862    );
863
864    wp_add_inline_script(
865        'jetpack-blocks-editor',
866        'var Jetpack_DonationsBlock = ' . wp_json_encode( $data, JSON_UNESCAPED_SLASHES | JSON_HEX_TAG | JSON_HEX_AMP ) . ';',
867        'before'
868    );
869}
870add_action( 'enqueue_block_assets', __NAMESPACE__ . '\load_editor_scripts', 11 );
871
872/**
873 * Determine if AMP should be disabled on posts having Donations blocks.
874 *
875 * @param bool    $skip Skipped.
876 * @param int     $post_id Post ID.
877 * @param WP_Post $post Post.
878 *
879 * @return bool Whether to skip the post from AMP.
880 */
881function amp_skip_post( $skip, $post_id, $post ) {
882    // When AMP is on standard mode, there are no non-AMP posts to link to where the donation can be completed, so let's
883    // prevent the post from being available in AMP.
884    if ( function_exists( 'amp_is_canonical' ) && \amp_is_canonical() && has_block( Blocks::get_block_name( __DIR__ ), $post->post_content ) ) {
885        return true;
886    }
887    return $skip;
888}
889add_filter( 'amp_skip_post', __NAMESPACE__ . '\amp_skip_post', 10, 3 );
890
891/**
892 * Record a Tracks event when a post containing the Donations block transitions
893 * to "publish" status. Fires once per donations block in the post, with the
894 * block's configuration snapshot as event properties.
895 *
896 * Admin-driven event only (no donor data). Does not fire on regular updates of
897 * an already-published post, on autosaves, or on revisions.
898 *
899 * @since 15.9
900 *
901 * @param string  $new_status New post status.
902 * @param string  $old_status Previous post status.
903 * @param WP_Post $post       Post being transitioned.
904 * @return void
905 */
906function record_block_published_event( $new_status, $old_status, $post ) {
907    if ( 'publish' !== $new_status || 'publish' === $old_status ) {
908        return;
909    }
910    if ( ! $post instanceof WP_Post ) {
911        return;
912    }
913    if ( wp_is_post_revision( $post ) || wp_is_post_autosave( $post ) ) {
914        return;
915    }
916    $block_name = Blocks::get_block_name( __DIR__ );
917    if ( ! has_block( $block_name, $post ) ) {
918        return;
919    }
920
921    $donation_blocks = collect_donation_blocks( parse_blocks( $post->post_content ), $block_name );
922    if ( empty( $donation_blocks ) ) {
923        return;
924    }
925
926    require_once JETPACK__PLUGIN_DIR . 'modules/memberships/class-jetpack-memberships.php';
927    $stripe_connected = \Jetpack_Memberships::has_connected_account();
928    $block_count      = count( $donation_blocks );
929
930    foreach ( $donation_blocks as $index => $block ) {
931        $props = build_block_published_event_props( $block, $post, $index, $block_count, $stripe_connected );
932        record_published_event( 'donations_block_published', $props );
933    }
934}
935add_action( 'transition_post_status', __NAMESPACE__ . '\record_block_published_event', 10, 3 );
936
937/**
938 * Walk a parsed block tree and return a flat list of Donations blocks (including
939 * nested ones inside columns / groups / patterns).
940 *
941 * @since 15.9
942 *
943 * @param array  $blocks     Parsed blocks from parse_blocks().
944 * @param string $block_name Donations block name (e.g. 'jetpack/donations').
945 * @return array List of parsed blocks matching $block_name.
946 */
947function collect_donation_blocks( $blocks, $block_name ) {
948    $matches = array();
949    foreach ( $blocks as $block ) {
950        if ( isset( $block['blockName'] ) && $block_name === $block['blockName'] ) {
951            $matches[] = $block;
952        }
953        if ( ! empty( $block['innerBlocks'] ) ) {
954            $matches = array_merge( $matches, collect_donation_blocks( $block['innerBlocks'], $block_name ) );
955        }
956    }
957    return $matches;
958}
959
960/**
961 * Build the property bag for a jetpack_donations_block_published Tracks event.
962 *
963 * Extracted so it can be tested independently of the WordPress hook plumbing.
964 *
965 * @since 15.9
966 *
967 * @param array   $block            Parsed block (with 'attrs' key).
968 * @param WP_Post $post             Post being published.
969 * @param int     $index            0-based position of this block within the post's donation blocks.
970 * @param int     $block_count      Total count of donations blocks in the post.
971 * @param bool    $stripe_connected Whether the site currently has a connected Stripe account.
972 * @return array Tracks event properties.
973 */
974function build_block_published_event_props( $block, $post, $index, $block_count, $stripe_connected ) {
975    $attrs = isset( $block['attrs'] ) && is_array( $block['attrs'] ) ? $block['attrs'] : array();
976
977    $one_time_show = ! isset( $attrs['oneTimeDonation']['show'] ) || false !== $attrs['oneTimeDonation']['show'];
978    $monthly_show  = ! empty( $attrs['monthlyDonation']['show'] );
979    $yearly_show   = ! empty( $attrs['annualDonation']['show'] );
980
981    $default_interval  = $attrs['defaultInterval'] ?? 'one-time';
982    $interval_to_freq  = array(
983        'one-time' => 'one_time',
984        '1 month'  => 'monthly',
985        '1 year'   => 'yearly',
986    );
987    $default_frequency = $interval_to_freq[ $default_interval ] ?? $default_interval;
988    $enabled_count     = (int) $one_time_show + (int) $monthly_show + (int) $yearly_show;
989    $tabs_appearance   = $attrs['tabsAppearance'] ?? 'tabs';
990
991    return array(
992        'feature'                   => 'donations',
993        'surface'                   => 'server',
994        'stripe_connected'          => (bool) $stripe_connected,
995        'post_id'                   => (int) $post->ID,
996        'post_type'                 => (string) $post->post_type,
997        'block_index_in_post'       => (int) $index,
998        'block_count_in_post'       => (int) $block_count,
999        'currency'                  => isset( $attrs['currency'] ) ? (string) $attrs['currency'] : null,
1000        'default_frequency'         => $default_frequency,
1001        'enabled_frequencies_count' => $enabled_count,
1002        'show_one_time'             => $one_time_show,
1003        'show_monthly'              => $monthly_show,
1004        'show_yearly'               => $yearly_show,
1005        'show_custom_amount'        => ! empty( $attrs['showCustomAmount'] ),
1006        'has_min_amount'            => isset( $attrs['minimumAmount'] ),
1007        'has_max_amount'            => isset( $attrs['maximumAmount'] ),
1008        'has_custom_styles'         => has_custom_styles( $attrs ),
1009        'tabs_appearance'           => (string) $tabs_appearance,
1010    );
1011}
1012
1013/**
1014 * Detect whether the block carries any of the customizable style attributes
1015 * we ship for the RSM project (so we can measure adoption of the new options).
1016 *
1017 * @since 15.9
1018 *
1019 * @param array $attrs Block attributes.
1020 * @return bool Whether any style override is set.
1021 */
1022function has_custom_styles( $attrs ) {
1023    $style_keys = array(
1024        'tabFontSize',
1025        'tabPadding',
1026        'activeTabBackgroundColor',
1027        'activeTabTextColor',
1028        'buttonPadding',
1029    );
1030    foreach ( $style_keys as $key ) {
1031        if ( isset( $attrs[ $key ] ) && '' !== $attrs[ $key ] && array() !== $attrs[ $key ] ) {
1032            return true;
1033        }
1034    }
1035    return false;
1036}
1037
1038/**
1039 * Send a Donations Tracks event using whichever pipeline is available for the
1040 * current environment (WPCOM Simple sites vs. WoA / connected Jetpack sites).
1041 *
1042 * Mirrors the dual-path pattern used by the Map block. No-op on environments
1043 * that have neither path available, so this stays safe on unconnected sites.
1044 *
1045 * @since 15.9
1046 *
1047 * @param string $event_name Event name WITHOUT the `jetpack_` prefix (the Tracking class adds it).
1048 * @param array  $props      Tracks event properties.
1049 * @return void
1050 */
1051function record_published_event( $event_name, $props ) {
1052    if ( defined( 'IS_WPCOM' ) && IS_WPCOM ) {
1053        require_lib( 'tracks/client' );
1054        tracks_record_event( wp_get_current_user(), 'jetpack_' . $event_name, $props );
1055        return;
1056    }
1057    if ( ( new Host() )->is_woa_site() && Jetpack::is_connection_ready() ) {
1058        $tracking = new Tracking();
1059        $tracking->record_user_event( $event_name, $props );
1060    }
1061}