Changeset 3548033

Timestamp:

05/25/2026 06:02:34 PM (5 months ago)

Author:

smsreminder

Message:

V1.1.0 - Marketing and education updates for optional SMS reminders. No settings changes or reconnection required.

Location:

smsreminder-appointment-booking

Files:

• tags/1.1.0 (added)
• tags/1.1.0/assets (added)
• tags/1.1.0/assets/admin-booking-settings.css (added)
• tags/1.1.0/assets/admin-booking-settings.js (added)
• tags/1.1.0/assets/appointment-booking-for-google-calendar-with-sms-reminders-hero.png (added)
• tags/1.1.0/build (added)
• tags/1.1.0/build/blocks (added)
• tags/1.1.0/build/blocks/book-button (added)
• tags/1.1.0/build/blocks/book-button/block.json (added)
• tags/1.1.0/build/blocks/book-button/index.asset.php (added)
• tags/1.1.0/build/blocks/book-button/index.js (added)
• tags/1.1.0/includes (added)
• tags/1.1.0/includes/Admin (added)
• tags/1.1.0/includes/Admin/class-connection-actions.php (added)
• tags/1.1.0/includes/Admin/class-settings-page.php (added)
• tags/1.1.0/includes/Services (added)
• tags/1.1.0/includes/Services/class-connected-app-client.php (added)
• tags/1.1.0/includes/Services/class-connection-service.php (added)
• tags/1.1.0/includes/Support (added)
• tags/1.1.0/includes/Support/class-book-button-defaults.php (added)
• tags/1.1.0/includes/Support/class-connection-store.php (added)
• tags/1.1.0/includes/Support/class-pkce.php (added)
• tags/1.1.0/includes/Support/class-reminders-promo-resolution.php (added)
• tags/1.1.0/includes/Support/class-reminders-promo-visibility.php (added)
• tags/1.1.0/includes/class-admin.php (added)
• tags/1.1.0/includes/class-blocks.php (added)
• tags/1.1.0/includes/class-database.php (added)
• tags/1.1.0/includes/class-plugin-config.php (added)
• tags/1.1.0/includes/class-plugin.php (added)
• tags/1.1.0/readme.txt (added)
• tags/1.1.0/smsreminder-appointment-booking.php (added)
• tags/1.1.0/src (added)
• tags/1.1.0/src/blocks (added)
• tags/1.1.0/src/blocks/book-button (added)
• tags/1.1.0/src/blocks/book-button/block.json (added)
• tags/1.1.0/src/blocks/book-button/edit.js (added)
• tags/1.1.0/src/blocks/book-button/index.js (added)
• tags/1.1.0/src/blocks/book-button/save.js (added)
• tags/1.1.0/uninstall.php (added)
• trunk/assets/admin-booking-settings.css (modified) (1 diff)
• trunk/assets/admin-booking-settings.js (modified) (2 diffs)
• trunk/includes/Admin/class-connection-actions.php (modified) (3 diffs)
• trunk/includes/Admin/class-settings-page.php (modified) (10 diffs)
• trunk/includes/Services/class-connection-service.php (modified) (2 diffs)
• trunk/includes/Support/class-reminders-promo-resolution.php (added)
• trunk/includes/Support/class-reminders-promo-visibility.php (added)
• trunk/includes/class-admin.php (modified) (1 diff)
• trunk/includes/class-plugin-config.php (modified) (1 diff)
• trunk/readme.txt (modified) (3 diffs)
• trunk/smsreminder-appointment-booking.php (modified) (2 diffs)
• trunk/uninstall.php (modified) (2 diffs)

smsreminder-appointment-booking/trunk/assets/admin-booking-settings.css

@@ -245 +245 @@
         }
 }
+
+.srb-reminders-column-header {
+        display: inline-flex;
+        align-items: center;
+        gap: 4px;
+}
+
+.srb-help-tip-wrap {
+        position: relative;
+        display: inline-flex;
+        vertical-align: middle;
+}
+
+.srb-help-tip {
+        border: none;
+        background: transparent;
+        padding: 0;
+        margin: 0;
+        width: 20px;
+        height: 20px;
+        line-height: 20px;
+        font-size: 20px;
+        color: #646970;
+        cursor: help;
+        vertical-align: middle;
+}
+
+.srb-help-tip:hover,
+.srb-help-tip:focus {
+        color: #2271b1;
+}
+
+.srb-help-tip:focus {
+        outline: 2px solid #2271b1;
+        outline-offset: 1px;
+        box-shadow: none;
+}
+
+.srb-card table.widefat {
+        overflow: visible;
+}
+
+.srb-card table.widefat thead th {
+        overflow: visible;
+        position: relative;
+}
+
+.srb-help-tip-popover {
+        position: absolute;
+        z-index: 100;
+        top: calc(100% + 6px);
+        left: 50%;
+        transform: translateX(-50%);
+        min-width: 220px;
+        max-width: min(280px, calc(100vw - 32px));
+        padding: 12px 14px;
+        background: #fff;
+        border: 1px solid #c3c4c7;
+        border-radius: 4px;
+        box-shadow: 0 2px 8px rgba(0, 0, 0, 0.12);
+        text-align: left;
+        font-weight: 400;
+        font-size: 13px;
+        line-height: 1.45;
+        color: #1d2327;
+        white-space: normal;
+}
+
+.srb-help-tip-popover[hidden] {
+        display: none;
+}
+
+.srb-help-tip-popover__title {
+        margin: 0 0 6px;
+}
+
+.srb-help-tip-popover__body {
+        margin: 0 0 8px;
+}
+
+.srb-help-tip-popover__action {
+        margin: 0;
+}
+
+@media (max-width: 782px) {
+        .srb-help-tip-popover {
+                left: auto;
+                right: 0;
+                transform: none;
+        }
+}
+
+.srb-reminders-promo {
+        background: #fff8e5;
+        border-color: #f0e6c8;
+        color: #1d2327;
+}
+
+.srb-reminders-promo__header {
+        display: flex;
+        justify-content: space-between;
+        align-items: flex-start;
+        gap: 16px;
+}
+
+.srb-reminders-promo__header h2 {
+        flex: 1 1 auto;
+        margin-bottom: 0;
+}
+
+.srb-reminders-promo__dismiss-form {
+        flex: 0 0 auto;
+        margin: 0;
+}
+
+.srb-reminders-promo__dismiss {
+        color: #50575e;
+        text-decoration: none;
+}
+
+.srb-reminders-promo__dismiss:hover,
+.srb-reminders-promo__dismiss:focus {
+        color: #1d2327;
+        text-decoration: underline;
+}
+
+.srb-reminders-promo__dismiss:focus {
+        box-shadow: 0 0 0 1px #2271b1;
+        outline: 1px solid transparent;
+}
+
+.srb-reminders-promo__body {
+        margin-top: 10px;
+}
+
+.srb-reminders-promo__actions {
+        margin-top: 14px;
+        margin-bottom: 0;
+}

smsreminder-appointment-booking/trunk/assets/admin-booking-settings.js

@@ -233 +233 @@
         }
 
+
+
+        function trackEvent( eventName ) {
+                if (
+                        typeof srbAdminConfig === 'undefined' ||
+                        ! srbAdminConfig.bearerToken ||
+                        ! srbAdminConfig.apiBase ||
+                        ! srbAdminConfig.analyticsTrackPath ||
+                        ! eventName
+                ) {
+                        return;
+                }
+
+                var base = String( srbAdminConfig.apiBase ).replace( /\/$/, '' );
+                var trackPath = String( srbAdminConfig.analyticsTrackPath ).replace( /^\//, '' );
+                var url = base + '/' + trackPath;
+
+                try {
+                        fetch( url, {
+                                method: 'POST',
+                                headers: {
+                                        'Content-Type': 'application/json',
+                                        Authorization: 'Bearer ' + srbAdminConfig.bearerToken,
+                                },
+                                body: JSON.stringify( { event: eventName } ),
+                                keepalive: true,
+                        } ).catch( function () {
+                                // Analytics failures are silent; admin UX must not be blocked.
+                        } );
+                } catch ( error ) {
+                        // Analytics failures are silent; admin UX must not be blocked.
+                }
+        }
+
+        function initRemindersPromoAnalytics() {
+                var promoBlock = document.querySelector( '[data-srb-reminders-promo]' );
+                if ( promoBlock ) {
+                        trackEvent( 'wordpress_settings_reminders_promo_block_viewed' );
+
+                        var enableLink = promoBlock.querySelector( '[data-srb-reminders-promo-enable]' );
+                        if ( enableLink ) {
+                                enableLink.addEventListener( 'click', function () {
+                                        trackEvent( 'wordpress_settings_reminders_promo_block_enable_click' );
+                                } );
+                        }
+
+                        var learnMoreLink = promoBlock.querySelector( '[data-srb-reminders-promo-learn-more]' );
+                        if ( learnMoreLink ) {
+                                learnMoreLink.addEventListener( 'click', function () {
+                                        trackEvent( 'wordpress_settings_reminders_promo_block_learn_more_click' );
+                                } );
+                        }
+                }
+
+                var tooltipLearnMore = document.querySelector( '[data-srb-reminders-column-tooltip-learn-more]' );
+                if ( tooltipLearnMore ) {
+                        tooltipLearnMore.addEventListener( 'click', function () {
+                                trackEvent( 'wordpress_settings_reminders_column_tooltip_learn_more_click' );
+                        } );
+                }
+        }
+
+        function closeHelpTip( wrap ) {
+                var button = wrap.querySelector( '.srb-help-tip' );
+                var popover = wrap.querySelector( '.srb-help-tip-popover' );
+                if ( ! button || ! popover ) {
+                        return;
+                }
+
+                popover.hidden = true;
+                button.setAttribute( 'aria-expanded', 'false' );
+                button.removeAttribute( 'aria-describedby' );
+        }
+
+        function closeAllHelpTips( exceptWrap ) {
+                var wraps = document.querySelectorAll( '.srb-help-tip-wrap' );
+                wraps.forEach( function ( wrap ) {
+                        if ( exceptWrap && wrap === exceptWrap ) {
+                                return;
+                        }
+                        closeHelpTip( wrap );
+                } );
+        }
+
+        function toggleHelpTip( wrap ) {
+                var button = wrap.querySelector( '.srb-help-tip' );
+                var popover = wrap.querySelector( '.srb-help-tip-popover' );
+                if ( ! button || ! popover ) {
+                        return;
+                }
+
+                if ( popover.hidden ) {
+                        closeAllHelpTips( wrap );
+                        popover.hidden = false;
+                        button.setAttribute( 'aria-expanded', 'true' );
+                        if ( popover.id ) {
+                                button.setAttribute( 'aria-describedby', popover.id );
+                        }
+                        return;
+                }
+
+                closeHelpTip( wrap );
+        }
+
+        function initHelpTips() {
+                var wraps = document.querySelectorAll( '.srb-help-tip-wrap' );
+                if ( ! wraps.length ) {
+                        return;
+                }
+
+                wraps.forEach( function ( wrap ) {
+                        var button = wrap.querySelector( '.srb-help-tip' );
+                        if ( ! button ) {
+                                return;
+                        }
+
+                        button.addEventListener( 'click', function ( event ) {
+                                event.preventDefault();
+                                event.stopPropagation();
+                                toggleHelpTip( wrap );
+                        } );
+                } );
+
+                document.addEventListener( 'click', function ( event ) {
+                        var target = event.target;
+                        if ( target instanceof Element && target.closest( '.srb-help-tip-wrap' ) ) {
+                                return;
+                        }
+                        closeAllHelpTips();
+                } );
+
+                document.addEventListener( 'keydown', function ( event ) {
+                        if ( event.key === 'Escape' ) {
+                                closeAllHelpTips();
+                        }
+                } );
+        }
+
         function initCopyBookingLinkButton() {
                 var button = document.querySelector( '[data-srb-copy-booking-link]' );
@@ -263 +401 @@
         initColorValueSync();
         initButtonPreview();
+        initHelpTips();
         initCopyBookingLinkButton();
+        initRemindersPromoAnalytics();
 }() );

smsreminder-appointment-booking/trunk/includes/Admin/class-connection-actions.php

@@ -9 +9 @@
 
 use SmsReminderBooking\Services\Connection_Service;
+use SmsReminderBooking\Support\Reminders_Promo_Visibility;
 
 defined( 'ABSPATH' ) || exit;
@@ -27 +28 @@
                 add_action( 'admin_post_sms_reminder_booking_connect', array( $this, 'handle_connect' ) );
                 add_action( 'admin_post_sms_reminder_booking_disconnect', array( $this, 'handle_disconnect' ) );
+                add_action( 'admin_post_sms_reminder_booking_dismiss_promo', array( $this, 'handle_dismiss_promo' ) );
                 add_action( 'admin_post_sms_reminder_booking_callback', array( $this, 'handle_callback' ) );
         }
@@ -75 +77 @@
         }
 
+        public function handle_dismiss_promo(): void {
+                if ( ! current_user_can( Reminders_Promo_Visibility::DISMISS_REQUIRED_CAPABILITY ) ) {
+                        wp_die( esc_html__( 'You do not have permission to dismiss this notice.', 'smsreminder-appointment-booking' ), '', array( 'response' => 403 ) );
+                }
+                check_admin_referer( Reminders_Promo_Visibility::DISMISS_NONCE_ACTION );
+
+                $payload = Reminders_Promo_Visibility::dismiss_persist_payload( get_current_user_id() );
+                if ( $payload !== null ) {
+                        update_user_meta( $payload['user_id'], $payload['meta_key'], $payload['meta_value'] );
+                        $this->service->track_analytics_event( $payload['analytics_event'] );
+                }
+
+                wp_safe_redirect( self::settings_url_with_query( array() ) );
+                exit;
+        }
+
         public function handle_callback(): void {
                 if ( ! current_user_can( 'manage_options' ) ) {

smsreminder-appointment-booking/trunk/includes/Admin/class-settings-page.php

@@ -10 +10 @@
 use SmsReminderBooking\Services\Connection_Service;
 use SmsReminderBooking\Support\Book_Button_Defaults;
+use SmsReminderBooking\Support\Reminders_Promo_Resolution;
+use SmsReminderBooking\Support\Reminders_Promo_Visibility;
 
 defined( 'ABSPATH' ) || exit;
 
 require_once SMS_REMINDER_BOOKING_PLUGIN_DIR . 'includes/Support/class-book-button-defaults.php';
+require_once SMS_REMINDER_BOOKING_PLUGIN_DIR . 'includes/Support/class-reminders-promo-visibility.php';
+require_once SMS_REMINDER_BOOKING_PLUGIN_DIR . 'includes/Support/class-reminders-promo-resolution.php';
 
 final class Settings_Page {
@@ -22 +26 @@
         private Connection_Service $service;
 
+        private bool $has_paid_subscription = false;
+
+        private bool $promo_visible = false;
+
         public function __construct( Connection_Service $service ) {
                 $this->service = $service;
+        }
+
+        public function get_has_paid_subscription(): bool {
+                return $this->has_paid_subscription;
+        }
+
+        public function get_should_show_reminders_promo(): bool {
+                return $this->promo_visible;
         }
 
@@ -47 +63 @@
                                         <?php
                                 else :
+                                        $profile = Reminders_Promo_Visibility::needs_profile_for_promo(
+                                                $booking_settings,
+                                                $this->is_promo_dismissed()
+                                        )
+                                                ? $this->service->fetch_profile()
+                                                : null;
+
+                                        if ( is_wp_error( $profile ) ) {
+                                                // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
+                                                error_log(
+                                                        sprintf(
+                                                                'SMS Reminder Booking: profile fetch failed (%s); hiding reminders promo.',
+                                                                $profile->get_error_message()
+                                                        )
+                                                );
+                                        }
+
+                                        $resolution = Reminders_Promo_Resolution::resolve(
+                                                $booking_settings,
+                                                $profile ?? array(),
+                                                $this->is_promo_dismissed()
+                                        );
+                                        $this->promo_visible         = $resolution['promo_visible'];
+                                        $this->has_paid_subscription = $resolution['has_paid_subscription'];
+
                                         $this->render_booking_sections( $booking_settings );
+                                        if ( $this->promo_visible ) {
+                                                $this->render_reminders_promo_block();
+                                        }
                                 endif;
                                 ?>
@@ -60 +104 @@
 
                                 <div class="srb-card">
-                                        <p><?php esc_html_e( 'Connect your WordPress site to SMS Reminder to enable booking features.', 'smsreminder-appointment-booking' ); ?></p>
+                                        <h2><?php esc_html_e( 'Enable bookings and reduce no-shows', 'smsreminder-appointment-booking' ); ?></h2>
+                                        <p><?php esc_html_e( 'Connect your WordPress site to SMS Reminder to enable instant client self-booking.', 'smsreminder-appointment-booking' ); ?></p>
 
                                         <?php $this->render_connect_external_services_disclosure(); ?>
@@ -75 +120 @@
                                                 </a>
                                         </p>
+                                        <p class="description"><?php esc_html_e( 'Send automated SMS reminders to clients (optional).', 'smsreminder-appointment-booking' ); ?></p>
                                 </div>
                         <?php endif; ?>
@@ -99 +145 @@
                 $dashboard_url = $this->service->get_plugin_config()->get_frontend_dashboard_settings_url();
                 $setup_booking_page_url = rtrim( $this->service->get_plugin_config()->get_frontend_site_url(), '/' ) . '/dashboard/settings?tab=6';
-                $onboarding_completed = $this->booking_onboarding_completed( $booking_settings );
+                $onboarding_completed = Reminders_Promo_Visibility::booking_onboarding_completed( $booking_settings );
                 if ( ! $onboarding_completed ) {
                         $this->render_finish_setup_section( $setup_booking_page_url );
@@ -189 +235 @@
                                         <th scope="col"><?php esc_html_e( 'Buffer after', 'smsreminder-appointment-booking' ); ?></th>
                                         <th scope="col"><?php esc_html_e( 'Minimum notice', 'smsreminder-appointment-booking' ); ?></th>
-                                        <th scope="col"><?php esc_html_e( 'Reminders', 'smsreminder-appointment-booking' ); ?></th>
+                                        <th scope="col"><?php $this->render_reminders_column_header(); ?></th>
                                         <th scope="col"><?php esc_html_e( 'Rescheduling', 'smsreminder-appointment-booking' ); ?></th>
                                 </tr>
@@ -284 +330 @@
                         </tbody>
                         </table>
+                </div>
+                <?php
+        }
+
+        private function render_reminders_promo_block(): void {
+                $enable_url     = $this->service->get_plugin_config()->get_enable_reminders_url();
+                $learn_more_url = $this->service->get_plugin_config()->get_marketing_learn_more_url();
+                ?>
+                <div class="srb-card srb-reminders-promo" data-srb-reminders-promo>
+                        <div class="srb-reminders-promo__header">
+                                <h2><?php esc_html_e( 'Reduce no-shows with SMS reminders', 'smsreminder-appointment-booking' ); ?></h2>
+                                <form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>" class="srb-reminders-promo__dismiss-form">
+                                        <input type="hidden" name="action" value="sms_reminder_booking_dismiss_promo" />
+                                        <?php wp_nonce_field( Reminders_Promo_Visibility::DISMISS_NONCE_ACTION ); ?>
+                                        <button
+                                                type="submit"
+                                                class="button-link srb-reminders-promo__dismiss"
+                                                data-srb-reminders-promo-dismiss
+                                        >
+                                                <?php esc_html_e( 'Dismiss', 'smsreminder-appointment-booking' ); ?>
+                                        </button>
+                                </form>
+                        </div>
+                        <p class="srb-reminders-promo__body">
+                                <?php esc_html_e( 'Send automatic reminders before appointments so clients actually show up.', 'smsreminder-appointment-booking' ); ?>
+                        </p>
+                        <p class="srb-reminders-promo__actions srb-inline-actions">
+                                <a
+                                        class="button button-primary"
+                                        href="<?php echo esc_url( $enable_url ); ?>"
+                                        target="_blank"
+                                        rel="noopener noreferrer"
+                                        data-srb-reminders-promo-enable
+                                >
+                                        <?php esc_html_e( 'Enable SMS reminders', 'smsreminder-appointment-booking' ); ?>
+                                </a>
+                                <a
+                                        href="<?php echo esc_url( $learn_more_url ); ?>"
+                                        target="_blank"
+                                        rel="noopener noreferrer"
+                                        data-srb-reminders-promo-learn-more
+                                >
+                                        <?php esc_html_e( 'Learn more', 'smsreminder-appointment-booking' ); ?>
+                                </a>
+                        </p>
                 </div>
                 <?php
@@ -663 +754 @@
 
         /**
-         * @param array{booking_onboarding:array<string,mixed>|null} $booking_settings
-         */
-        private function booking_onboarding_completed( array $booking_settings ): bool {
-                $onboarding = $this->get_value( $booking_settings, 'booking_onboarding' );
-                if ( ! is_array( $onboarding ) ) {
+         * @param array|\WP_Error $profile
+         */
+        private function is_promo_dismissed(): bool {
+                $user_id = get_current_user_id();
+                if ( $user_id <= 0 ) {
                         return false;
                 }
 
-                return true === $this->get_value( $onboarding, 'onboarding_completed' );
+                return get_user_meta( $user_id, Reminders_Promo_Visibility::DISMISS_USER_META_KEY, true ) === '1';
         }
 
@@ -739 +830 @@
         }
 
+        private function render_reminders_column_header(): void {
+                $learn_more_url = $this->service->get_plugin_config()->get_marketing_learn_more_url();
+                ?>
+                <span class="srb-reminders-column-header">
+                        <?php esc_html_e( 'Reminders', 'smsreminder-appointment-booking' ); ?>
+                        <span class="srb-help-tip-wrap">
+                                <button
+                                        type="button"
+                                        class="srb-help-tip dashicons dashicons-info"
+                                        aria-expanded="false"
+                                        aria-controls="srb-reminders-column-tooltip"
+                                >
+                                        <span class="screen-reader-text">
+                                                <?php esc_html_e( 'More information about optional SMS reminders', 'smsreminder-appointment-booking' ); ?>
+                                        </span>
+                                </button>
+                                <div
+                                        id="srb-reminders-column-tooltip"
+                                        class="srb-help-tip-popover"
+                                        role="tooltip"
+                                        hidden
+                                >
+                                        <p class="srb-help-tip-popover__title">
+                                                <strong><?php esc_html_e( 'Optional SMS reminders', 'smsreminder-appointment-booking' ); ?></strong>
+                                        </p>
+                                        <p class="srb-help-tip-popover__body">
+                                                <?php esc_html_e( 'Automatically send appointment reminders to clients by SMS before their booking.', 'smsreminder-appointment-booking' ); ?>
+                                        </p>
+                                        <p class="srb-help-tip-popover__action">
+                                                <a
+                                                        href="<?php echo esc_url( $learn_more_url ); ?>"
+                                                        target="_blank"
+                                                        rel="noopener noreferrer"
+                                                        data-srb-reminders-column-tooltip-learn-more
+                                                >
+                                                        <?php esc_html_e( 'Learn more', 'smsreminder-appointment-booking' ); ?>
+                                                </a>
+                                        </p>
+                                </div>
+                        </span>
+                </span>
+                <?php
+        }
+
         private static function format_connected_at( string $iso ): string {
                 if ( $iso === '' ) {

smsreminder-appointment-booking/trunk/includes/Services/class-connection-service.php

@@ -349 +349 @@
 
                 $result = $this->client->get_json( 'connected-apps/booking/settings', (string) $conn['token'] );
+                return $this->parse_booking_settings_result( $result );
+        }
+
+        /**
+         * Fetches connected user profile (subscription signals for promo visibility).
+         *
+         * @return array{user:array{id:string,email:string,billing_subscription_id:int|null,has_paid_subscription:bool,has_reminder_setup_history:bool}}|\WP_Error
+         */
+        public function fetch_profile() {
+                $conn = $this->store->get_connection();
+                if ( $conn === null || empty( $conn['token'] ) ) {
+                        return new \WP_Error( 'srb_no_token', __( 'There is no saved connection token.', 'smsreminder-appointment-booking' ) );
+                }
+
+                $result = $this->client->get_json( 'connected-apps/profile', (string) $conn['token'] );
+                return $this->parse_profile_result( $result );
+        }
+
+        public function track_analytics_event( string $event ): void {
+                $conn = $this->store->get_connection();
+                if ( $conn === null || empty( $conn['token'] ) || $event === '' ) {
+                        return;
+                }
+
+                $result = $this->client->post_json(
+                        'connected-apps/analytics/track',
+                        array( 'event' => $event ),
+                        (string) $conn['token']
+                );
+
+                if ( ! $result['ok'] ) {
+                        // phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
+                        error_log(
+                                sprintf(
+                                        'SMS Reminder Booking: analytics track failed for %s (%s).',
+                                        $event,
+                                        $result['error_message'] ?? 'unknown error'
+                                )
+                        );
+                }
+        }
+
+        /**
+         * @param array{ok:bool, status:int, data?:mixed, error_message?:string} $result
+         * @return array{booking_url:string, booking_onboarding:array<string,mixed>|null, availability:array<string,mixed>, appointment_types:array<int,mixed>, upcoming_bookings:array<int,mixed>}|\WP_Error
+         */
+        private function parse_booking_settings_result( array $result ) {
                 if ( ! $result['ok'] ) {
                         return new \WP_Error(
@@ -371 +418 @@
 
                 return array(
-                        'booking_url'       => isset( $data['booking_url'] ) ? (string) $data['booking_url'] : '',
+                        'booking_url'        => isset( $data['booking_url'] ) ? (string) $data['booking_url'] : '',
                         'booking_onboarding' => ( isset( $data['booking_onboarding'] ) && is_array( $data['booking_onboarding'] ) ) ? $data['booking_onboarding'] : null,
-                        'availability'      => $data['availability'],
-                        'appointment_types' => $data['appointment_types'],
-                        'upcoming_bookings' => $data['upcoming_bookings'],
+                        'availability'       => $data['availability'],
+                        'appointment_types'    => $data['appointment_types'],
+                        'upcoming_bookings'  => $data['upcoming_bookings'],
+                );
+        }
+
+        /**
+         * @param array{ok:bool, status:int, data?:mixed, error_message?:string} $result
+         * @return array{user:array{id:string,email:string,billing_subscription_id:int|null,has_paid_subscription:bool,has_reminder_setup_history:bool}}|\WP_Error
+         */
+        private function parse_profile_result( array $result ) {
+                if ( ! $result['ok'] ) {
+                        return new \WP_Error(
+                                'srb_profile',
+                                $result['error_message'] ?? __( 'Could not load profile from SMS Reminder.', 'smsreminder-appointment-booking' )
+                        );
+                }
+
+                $data = $result['data'] ?? null;
+                if ( ! is_array( $data ) || ! isset( $data['user'] ) || ! is_array( $data['user'] ) ) {
+                        return new \WP_Error( 'srb_profile_shape', __( 'Unexpected profile response.', 'smsreminder-appointment-booking' ) );
+                }
+
+                $user = $data['user'];
+
+                return array(
+                        'user' => array(
+                                'id'                      => isset( $user['id'] ) ? (string) $user['id'] : '',
+                                'email'                   => isset( $user['email'] ) ? (string) $user['email'] : '',
+                                'billing_subscription_id' => isset( $user['billing_subscription_id'] ) && is_numeric( $user['billing_subscription_id'] )
+                                        ? (int) $user['billing_subscription_id']
+                                        : null,
+                                'has_paid_subscription'   => true === ( $user['has_paid_subscription'] ?? false ),
+                                'has_reminder_setup_history' => true === ( $user['has_reminder_setup_history'] ?? false ),
+                        ),
                 );
         }

smsreminder-appointment-booking/trunk/includes/class-admin.php

@@ -91 +91 @@
                         'smsreminder-appointment-booking-admin-settings',
                         SMS_REMINDER_BOOKING_PLUGIN_URL . 'assets/admin-booking-settings.css',
-                        array(),
+                        array( 'dashicons' ),
                         $style_ver
+                );
+
+                if ( ! current_user_can( 'manage_options' ) ) {
+                        return;
+                }
+
+                $connection  = $this->connection_service->get_store()->get_connection();
+                $bearer_token = is_array( $connection ) && ! empty( $connection['token'] )
+                        ? (string) $connection['token']
+                        : '';
+
+                wp_localize_script(
+                        'smsreminder-appointment-booking-admin-settings',
+                        'srbAdminConfig',
+                        array(
+                                'apiBase'            => $this->plugin_config->get_api_base(),
+                                'analyticsTrackPath' => 'connected-apps/analytics/track',
+                                'bearerToken'        => $bearer_token,
+                        )
                 );
         }

smsreminder-appointment-booking/trunk/includes/class-plugin-config.php

@@ -93 +93 @@
         }
 
+        public function get_enable_reminders_url(): string {
+                return add_query_arg(
+                        array(
+                                'source'       => 'wordpress',
+                                'utm_source'   => 'wordpress-plugin',
+                                'utm_medium'   => 'admin',
+                                'utm_campaign' => 'enable_reminders',
+                        ),
+                        $this->get_frontend_dashboard_settings_url()
+                );
+        }
+
+        public function get_marketing_learn_more_url(): string {
+                return add_query_arg(
+                        array(
+                                'utm_source'   => 'wordpress-plugin',
+                                'utm_medium'   => 'admin',
+                                'utm_campaign' => 'learn_more',
+                        ),
+                        'https://www.smsreminder.app/'
+                );
+        }
+
         public function get_http_timeout(): int {
                 if ( $this->http_timeout_cache !== null ) {

smsreminder-appointment-booking/trunk/readme.txt

@@ -5 +5 @@
 Tested up to: 6.9
 Requires PHP: 8.2
-Stable tag: 1.0.1
+Stable tag: 1.1.0
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -137 +137 @@
 == Changelog ==
 
+= 1.1.0 =
+* Connection screen: updated copy to highlight free booking and optional SMS reminders before sign-up.
+* Connected dashboard: added a dismissible SMS reminders promo block with a direct link to enable reminders in the SMS Reminder dashboard.
+* Appointment types table: added an informational tooltip on the Reminders column explaining optional SMS reminders.
+* Admin analytics: track promo block and tooltip impressions and CTA clicks for product funnel measurement.
+
 = 1.0.1 =
 * Connection flow: the redirect to the SMS Reminder web app now includes a `source` query parameter (`wordpress`) so new signups started from this plugin can be attributed correctly in product analytics. No change to stored tokens, callbacks, or booking behavior.
@@ -148 +154 @@
 == Upgrade Notice ==
 
+= 1.1.0 =
+Marketing and education updates for optional SMS reminders. No settings changes or reconnection required.
+
 = 1.0.1 =
 Maintenance release. Improves how the SMS Reminder service attributes new signups that start from this plugin. No settings changes or reconnection required.

smsreminder-appointment-booking/trunk/smsreminder-appointment-booking.php

@@ -4 +4 @@
  * Plugin URI:        https://www.smsreminder.app/
  * Description:       Let clients book appointments through Google Calendar and reduce no-shows with simple scheduling and SMS reminders.
- * Version:           1.0.1
+ * Version:           1.1.0
  * Requires at least: 6.9
  * Requires PHP:      8.2
@@ -17 +17 @@
 defined( 'ABSPATH' ) || exit;
 
-define( 'SMS_REMINDER_BOOKING_VERSION', '1.0.1' );
+define( 'SMS_REMINDER_BOOKING_VERSION', '1.1.0' );
 /** Increment when the custom DB schema changes (tables/columns); not the same as plugin semver. */
 define( 'SMS_REMINDER_BOOKING_DB_VERSION', 1 );

smsreminder-appointment-booking/trunk/uninstall.php

@@ -8 +8 @@
 defined( 'WP_UNINSTALL_PLUGIN' ) || exit;
 
+require_once plugin_dir_path( __FILE__ ) . 'includes/Support/class-reminders-promo-visibility.php';
+
+use SmsReminderBooking\Support\Reminders_Promo_Visibility;
+
 delete_option( 'sms_reminder_booking_button_defaults' );
 delete_option( 'sms_reminder_booking_connection' );
@@ -13 +17 @@
 delete_transient( 'sms_reminder_booking_pending_auth' );
 foreach ( get_users( array( 'fields' => 'ID' ) ) as $sms_reminder_booking_user_id ) {
-        delete_transient( 'sms_reminder_booking_pending_auth_' . (int) $sms_reminder_booking_user_id );
+        $user_id = (int) $sms_reminder_booking_user_id;
+        delete_transient( 'sms_reminder_booking_pending_auth_' . $user_id );
+        delete_user_meta( $user_id, Reminders_Promo_Visibility::DISMISS_USER_META_KEY );
 }
 delete_option( 'sms_reminder_booking_db_version' );