Changeset 3712213

Timestamp:

09/25/2026 01:17:17 AM (4 weeks ago)

Author:

hamzaafridi05

Message:

1.2.0

New: start questions. The chat can open with "Are you already a customer?". Customers give their order number and email, new visitors give their email, before they type. Turn it on in Settings, Appearance.
New: with WooCommerce, the order number is checked against your orders. Only the store owner sees the result, in the Inbox.
New: the Inbox search also finds emails and order numbers.
Fix: saving a visitor's email no longer moves a live chat out of the live inbox.
Fix: the privacy eraser removes every chat for an email, and export and erase find an email saved from the chat.
Fix: the privacy consent note did not show, even when it was turned on.
Fix: opening a chat from its email link stopped the chat from loading.

Location:

sellsmith

Files:

• tags/1.2.0 (added)
• tags/1.2.0/admin (added)
• tags/1.2.0/admin/class-sellsmith-admin.php (added)
• tags/1.2.0/admin/class-sellsmith-leads.php (added)
• tags/1.2.0/assets (added)
• tags/1.2.0/assets/admin.css (added)
• tags/1.2.0/assets/admin.js (added)
• tags/1.2.0/assets/widget.css (added)
• tags/1.2.0/assets/widget.js (added)
• tags/1.2.0/includes (added)
• tags/1.2.0/includes/class-sellsmith-chat.php (added)
• tags/1.2.0/includes/class-sellsmith-conversations.php (added)
• tags/1.2.0/includes/class-sellsmith-cron.php (added)
• tags/1.2.0/includes/class-sellsmith-gemini.php (added)
• tags/1.2.0/includes/class-sellsmith-install.php (added)
• tags/1.2.0/includes/class-sellsmith-privacy.php (added)
• tags/1.2.0/includes/class-sellsmith-prompt.php (added)
• tags/1.2.0/includes/class-sellsmith-rest.php (added)
• tags/1.2.0/includes/class-sellsmith-settings.php (added)
• tags/1.2.0/includes/class-sellsmith-tools.php (added)
• tags/1.2.0/includes/class-sellsmith-widget.php (added)
• tags/1.2.0/languages (added)
• tags/1.2.0/languages/index.php (added)
• tags/1.2.0/languages/sellsmith.pot (added)
• tags/1.2.0/readme.txt (added)
• tags/1.2.0/sellsmith.php (added)
• tags/1.2.0/uninstall.php (added)
• trunk/admin/class-sellsmith-admin.php (modified) (1 diff)
• trunk/admin/class-sellsmith-leads.php (modified) (5 diffs)
• trunk/assets/admin.css (modified) (1 diff)
• trunk/assets/widget.css (modified) (1 diff)
• trunk/assets/widget.js (modified) (7 diffs)
• trunk/includes/class-sellsmith-chat.php (modified) (1 diff)
• trunk/includes/class-sellsmith-conversations.php (modified) (6 diffs)
• trunk/includes/class-sellsmith-privacy.php (modified) (2 diffs)
• trunk/includes/class-sellsmith-rest.php (modified) (2 diffs)
• trunk/includes/class-sellsmith-settings.php (modified) (4 diffs)
• trunk/includes/class-sellsmith-widget.php (modified) (2 diffs)
• trunk/languages/sellsmith.pot (modified) (1 diff)
• trunk/readme.txt (modified) (3 diffs)
• trunk/sellsmith.php (modified) (2 diffs)

sellsmith/trunk/admin/class-sellsmith-admin.php

@@ -745 +745 @@
                 <?php
                 self::panel_close();
+
+                self::panel_open( __( 'When the chat opens', 'sellsmith' ) );
+                ?>
+                        <?php
+                        self::checkbox_row(
+                                'start_step',
+                                __( 'Start questions', 'sellsmith' ),
+                                __( 'Ask "Are you already a customer?" first. Customers give their order number and email, new visitors give their email. Then they type their question.', 'sellsmith' )
+                        );
+                        ?>
+                        <div class="ss-field">
+                                <span class="ss-label"><?php esc_html_e( 'Email', 'sellsmith' ); ?></span>
+                                <div class="ss-radio-group">
+                                        <label class="ss-radio"><input type="radio" name="<?php echo self::field_name( 'start_email' ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>" value="required" <?php checked( 'required', Sellsmith_Settings::get( 'start_email' ) ); ?> /> <?php esc_html_e( 'Required, so you can always reply', 'sellsmith' ); ?></label>
+                                        <label class="ss-radio"><input type="radio" name="<?php echo self::field_name( 'start_email' ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>" value="optional" <?php checked( 'optional', Sellsmith_Settings::get( 'start_email' ) ); ?> /> <?php esc_html_e( 'Optional, visitors can skip it', 'sellsmith' ); ?></label>
+                                </div>
+                        </div>
+                        <?php
+                        self::text_row( 'start_question', __( 'Question', 'sellsmith' ) );
+                        self::text_row( 'start_yes', __( 'Button for customers', 'sellsmith' ) );
+                        self::text_row( 'start_no', __( 'Button for new visitors', 'sellsmith' ) );
+                        ?>
+                        <p class="ss-hint"><?php esc_html_e( 'With WooCommerce, the order number is checked against your orders. Only you see the result, in the Inbox. The visitor is never told whether an order exists.', 'sellsmith' ); ?></p>
+                <?php
+                self::panel_close();
         }
 

sellsmith/trunk/admin/class-sellsmith-leads.php

@@ -178 +178 @@
                 echo '<form method="get" class="sellsmith-leads-search">';
                 echo '<input type="hidden" name="page" value="sellsmith-leads" />';
-                echo '<p class="search-box"><input type="search" name="s" value="' . esc_attr( $search ) . '" placeholder="' . esc_attr__( 'Search city or message…', 'sellsmith' ) . '" /> ';
+                echo '<p class="search-box"><input type="search" name="s" value="' . esc_attr( $search ) . '" placeholder="' . esc_attr__( 'Search email, order, city or message…', 'sellsmith' ) . '" /> ';
                 submit_button( __( 'Search', 'sellsmith' ), 'secondary', '', false );
                 echo '</p></form>';
@@ -285 +285 @@
                 $note        = '';
                 $contact_val = '';
+                $meta        = array();
                 if ( ! empty( $conv['visitor_meta'] ) ) {
-                        $meta = json_decode( $conv['visitor_meta'], true );
-                        if ( is_array( $meta ) ) {
+                        $decoded = json_decode( $conv['visitor_meta'], true );
+                        if ( is_array( $decoded ) ) {
+                                $meta        = $decoded;
                                 $note        = isset( $meta['note'] ) ? $meta['note'] : '';
                                 $contact_val = isset( $meta['contact'] ) ? $meta['contact'] : '';
@@ -297 +299 @@
                 self::meta_item( __( 'City', 'sellsmith' ), $conv['visitor_city'] ? $conv['visitor_city'] : '' );
                 self::meta_item( __( 'Contact', 'sellsmith' ), $contact_val ? $contact_val : '' );
+                self::meta_item( __( 'Visitor', 'sellsmith' ), Sellsmith_Conversations::visitor_line( $meta ) );
                 self::meta_item( __( 'Note', 'sellsmith' ), $note ? $note : '' );
                 self::meta_item( __( 'WhatsApp', 'sellsmith' ), $conv['wa_clicked'] ? __( 'Clicked the button', 'sellsmith' ) : '' );
                 echo '</div>';
+
+                $order_url = Sellsmith_Conversations::visitor_order_url( $meta );
+                if ( $order_url ) {
+                        echo '<p><a class="button" href="' . esc_url( $order_url ) . '">' . esc_html__( 'Open their order', 'sellsmith' ) . '</a></p>';
+                }
 
                 $products = self::product_links( $conv['product_ids'] );
@@ -361 +369 @@
                 }
                 $meta = json_decode( $row['visitor_meta'], true );
-                if ( ! is_array( $meta ) || empty( $meta['contact'] ) ) {
+                if ( ! is_array( $meta ) ) {
                         return '';
+                }
+
+                // Who they said they are in the start questions, under the contact.
+                $who = '';
+                if ( ! empty( $meta['start'] ) ) {
+                        if ( 'customer' === $meta['start'] ) {
+                                $who = __( 'Customer', 'sellsmith' );
+                                if ( ! empty( $meta['order_number'] ) ) {
+                                        $who .= ' #' . $meta['order_number'] . ( ( isset( $meta['order_match'] ) && 'found' === $meta['order_match'] ) ? ' ✓' : '' );
+                                }
+                        } else {
+                                $who = __( 'New visitor', 'sellsmith' );
+                        }
+                        $who = '<br /><small class="sellsmith-who">' . esc_html( $who ) . '</small>';
+                }
+
+                if ( empty( $meta['contact'] ) ) {
+                        return $who;
                 }
 
@@ -369 +395 @@
 
                 if ( 'email' === $type ) {
-                        return '<a href="' . esc_url( 'mailto:' . $value ) . '">' . esc_html( $value ) . '</a>';
+                        return '<a href="' . esc_url( 'mailto:' . $value ) . '">' . esc_html( $value ) . '</a>' . $who;
                 }
                 if ( 'phone' === $type ) {
-                        return '<a href="' . esc_url( 'https://wa.me/' . rawurlencode( $value ) ) . '" target="_blank" rel="noopener noreferrer">' . esc_html( $value ) . '</a>';
-                }
-                return esc_html( $value );
+                        return '<a href="' . esc_url( 'https://wa.me/' . rawurlencode( $value ) ) . '" target="_blank" rel="noopener noreferrer">' . esc_html( $value ) . '</a>' . $who;
+                }
+                return esc_html( $value ) . $who;
         }
 

sellsmith/trunk/assets/admin.css

@@ -872 +872 @@
         color: var(--ss-ink);
 }
+
+/* customer or new visitor, under the contact in the inbox list */
+.sellsmith-who { color: var(--ss-muted); }
 
 /* ---------- leads: transcript ---------- */

sellsmith/trunk/assets/widget.css

@@ -246 +246 @@
 }
 
+/* start questions ("Are you already a customer?") */
+#sellsmith-root .ss-start-choices {
+        display: flex;
+        flex-wrap: wrap;
+        justify-content: flex-end;
+        gap: 7px;
+        align-self: stretch;
+        animation: ss-pop .26s cubic-bezier(.22, 1, .36, 1);
+}
+#sellsmith-root .ss-start-choice {
+        min-height: 42px;
+        padding: 0 15px;
+        border: 1.5px solid var(--ss-brand);
+        border-radius: 999px;
+        background: #fff;
+        color: var(--ss-brand);
+        font-size: 14px;
+        font-weight: 600;
+        transition: background .15s, color .15s;
+}
+#sellsmith-root .ss-start-choice:hover { background: var(--ss-brand); color: var(--ss-on-brand); }
+#sellsmith-root .ss-start-form {
+        background: var(--ss-sand);
+        border-radius: 13px;
+        border-bottom-left-radius: 5px;
+        padding: 11px 12px;
+        align-self: stretch;
+        display: flex;
+        flex-direction: column;
+        gap: 8px;
+        animation: ss-pop .26s cubic-bezier(.22, 1, .36, 1);
+}
+#sellsmith-root .ss-start-form .ss-input { flex: none; width: 100%; min-height: 42px; }
+#sellsmith-root .ss-start-err { font-size: 13px; color: #b42318; }
+#sellsmith-root .ss-start-err[hidden] { display: none; }
+#sellsmith-root .ss-start-go {
+        min-height: 42px;
+        border-radius: 10px;
+        background: var(--ss-brand);
+        color: var(--ss-on-brand);
+        font-weight: 600;
+}
+#sellsmith-root .ss-start-go:disabled { opacity: .55; cursor: default; }
+#sellsmith-root .ss-input:disabled { background: #f4f5f7; cursor: not-allowed; }
+/* 16px stops iPhones from zooming the page when a field is tapped */
+@media (max-width: 480px) {
+        #sellsmith-root .ss-start-form .ss-input { font-size: 16px; }
+}
+
 /* input bar */
 #sellsmith-root .ss-bar {

sellsmith/trunk/assets/widget.js

@@ -6 +6 @@
         var cfg = sellsmithWidget;
         var t = cfg.i18n;
+        // wp_localize_script turns top-level true/1 into "1" and false/0 into "" or "0",
+        // and "0" is truthy in JS, so on/off settings are read through this.
+        function on(v) { return v === true || v === 1 || v === "1"; }
         var resumeToken = cfg.resumeToken || "";
 
@@ -11 +14 @@
         // so strip it from the address bar right away: that keeps it out of browser
         // history, out of Referer headers, and out of any link the visitor copies.
-        if (resumeToken && window.history && history.replaceState) {
+        // Always window.history here: the chat keeps its own "var history" further down,
+        // which hides the browser's one inside this function and crashed every reply link.
+        if (resumeToken && window.history && window.history.replaceState) {
                 try {
                         var _u = new URL(window.location.href);
                         if (_u.searchParams.has("sellsmith_chat")) {
                                 _u.searchParams.delete("sellsmith_chat");
-                                history.replaceState(null, "", _u.toString());
+                                window.history.replaceState(null, "", _u.toString());
                         }
                 } catch (e) { /* older browser: leave the URL as-is */ }
@@ -39 +44 @@
         var CONSENT_KEY = "sellsmith_consent";
         var EMAIL_ASKED_KEY = "sellsmith_email_asked";
+        var START_KEY = "sellsmith_start_done";
 
         function store(key, val) {
@@ -258 +264 @@
         /* ---------- consent gate ---------- */
         function needsConsent() {
-                return cfg.consent === 1 && read(CONSENT_KEY) !== "1";
+                return on(cfg.consent) && read(CONSENT_KEY) !== "1";
         }
 
@@ -272 +278 @@
                 box.appendChild(ok);
                 log.appendChild(box);
+        }
+
+        /* ---------- start questions ---------- */
+        /* "Are you already a customer?" before the first message. Customers give their
+           order number and email, new visitors their email, so the owner can always
+           reply, even after the visitor has left. Turned on in Settings > Appearance. */
+        function historyHasUser() {
+                for (var i = 0; i < history.length; i++) {
+                        if (history[i].r === "user") return true;
+                }
+                return false;
+        }
+
+        function needsStart() {
+                return on(cfg.startStep) && !!cfg.startUrl && !resumeToken && read(START_KEY) !== session && !historyHasUser();
+        }
+
+        function lockBar(on) {
+                input.disabled = on;
+                sendBtn.disabled = on;
+                input.placeholder = on ? (t.startLocked || t.placeholder) : t.placeholder;
+        }
+
+        function validEmail(v) {
+                return /^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/.test(v);
+        }
+
+        function showStart() {
+                lockBar(true);
+                addBubble("ai", t.startQuestion, true);
+
+                var row = el("div", "ss-start-choices");
+                var yes = el("button", "ss-start-choice", t.startYes);
+                var no = el("button", "ss-start-choice", t.startNo);
+                yes.type = "button";
+                no.type = "button";
+                row.appendChild(yes);
+                row.appendChild(no);
+                log.appendChild(row);
+                log.scrollTop = log.scrollHeight;
+
+                yes.addEventListener("click", function () { row.remove(); startForm("customer"); });
+                no.addEventListener("click", function () { row.remove(); startForm("new"); });
+                yes.focus();
+        }
+
+        function startForm(type) {
+                var customer = type === "customer";
+                var choice = customer ? t.startYes : t.startNo;
+                addBubble("user", choice, true);
+                addBubble("ai", customer ? t.startCustomer : t.startNew, true);
+
+                var form = el("form", "ss-start-form");
+                form.noValidate = true;
+
+                var orderInp = null;
+                if (customer) {
+                        orderInp = el("input", "ss-input");
+                        orderInp.type = "text";
+                        orderInp.maxLength = 40;
+                        orderInp.autocomplete = "off";
+                        orderInp.placeholder = t.startOrder;
+                        orderInp.setAttribute("aria-label", t.startOrder);
+                        form.appendChild(orderInp);
+                }
+
+                var emailInp = el("input", "ss-input");
+                emailInp.type = "email";
+                emailInp.maxLength = 120;
+                emailInp.autocomplete = "email";
+                emailInp.placeholder = customer ? t.startEmailBuy : t.startEmailNew;
+                emailInp.setAttribute("aria-label", emailInp.placeholder);
+                if (cfg.userEmail) emailInp.value = cfg.userEmail;
+                form.appendChild(emailInp);
+
+                var err = el("p", "ss-start-err");
+                err.setAttribute("role", "alert");
+                err.hidden = true;
+                form.appendChild(err);
+
+                var go = el("button", "ss-start-go", t.startGo);
+                go.type = "submit";
+                form.appendChild(go);
+
+                if (cfg.startEmail === "optional") {
+                        var skip = el("button", "ss-email-skip", t.startSkip);
+                        skip.type = "button";
+                        skip.addEventListener("click", function () {
+                                submitStart(type, choice, "", orderInp ? orderInp.value.trim() : "", form, go, err);
+                        });
+                        form.appendChild(skip);
+                }
+
+                form.addEventListener("submit", function (e) {
+                        e.preventDefault();
+                        var email = emailInp.value.trim();
+                        var bad = email ? !validEmail(email) : cfg.startEmail !== "optional";
+                        if (bad) {
+                                err.textContent = t.startBadEmail;
+                                err.hidden = false;
+                                emailInp.setAttribute("aria-invalid", "true");
+                                emailInp.focus();
+                                return;
+                        }
+                        emailInp.removeAttribute("aria-invalid");
+                        submitStart(type, choice, email, orderInp ? orderInp.value.trim() : "", form, go, err);
+                });
+
+                log.appendChild(form);
+                log.scrollTop = log.scrollHeight;
+                (orderInp || (emailInp.value ? go : emailInp)).focus();
+        }
+
+        function submitStart(type, choice, email, order, form, go, err) {
+                var skipBtn = form.querySelector(".ss-email-skip");
+                function busyForm(onOff) {
+                        go.disabled = onOff;
+                        if (skipBtn) skipBtn.disabled = onOff;
+                }
+                busyForm(true);
+                fetch(cfg.startUrl, {
+                        method: "POST",
+                        headers: { "Content-Type": "application/json", "X-WP-Nonce": cfg.nonce },
+                        body: JSON.stringify({ session_id: session, type: type, email: email, order: order, nonce: cfg.nonce })
+                })
+                        .then(function (r) { return r.json().then(function (d) { return { ok: r.ok, d: d }; }); })
+                        .then(function (res) {
+                                if (res.ok && res.d && res.d.ok) {
+                                        finishStart(type, choice, email, order, form);
+                                        return;
+                                }
+                                busyForm(false);
+                                err.textContent = (res.d && res.d.message) ? res.d.message : t.error;
+                                err.hidden = false;
+                        })
+                        .catch(function () {
+                                busyForm(false);
+                                err.textContent = t.error;
+                                err.hidden = false;
+                        });
+        }
+
+        function finishStart(type, choice, email, order, form) {
+                form.remove();
+                // Keep the answers in the saved on-screen chat, so a reload reads the same.
+                history.push({ r: "ai", c: t.startQuestion });
+                history.push({ r: "user", c: choice });
+                var parts = [];
+                if (order) parts.push(t.startOrderShort + " " + order);
+                if (email) parts.push(email);
+                if (parts.length) addBubble("user", parts.join(" · "));
+                addBubble("ai", email ? t.startThanks : t.startThanksShort);
+                store(START_KEY, session);
+                // Pro's soft email ask has nothing left to ask for.
+                if (email) store(EMAIL_ASKED_KEY, session);
+                lockBar(false);
+                input.focus();
+                emit("startdone", { type: type, email: !!email });
         }
 
@@ -406 +570 @@
                         addBubble("ai", cfg.welcome);
                 }
+                if (needsStart()) { showStart(); return; }
                 input.focus();
         }
@@ -504 +669 @@
                 }
                 emit("newchat", { session: session });
+                if (needsStart()) { showStart(); return; }
+                lockBar(false);
                 input.focus();
         }

sellsmith/trunk/includes/class-sellsmith-chat.php

@@ -253 +253 @@
                 $user_count  = Sellsmith_Conversations::count_user_messages( $conversation_id );
 
-                if ( $has_contact && ! $had_contact ) {
-                        // They just left their contact: confirm once, then go quiet.
+                if ( ( $has_contact && ! $had_contact ) || ( $had_contact && 1 === $user_count && '' !== $message ) ) {
+                        // They just left their contact, or gave it in the start questions and this
+                        // is their first message: confirm once, then go quiet.
                         $reply = __( 'Got it! 🙏 We will reply to you here soon. You can add more details if you like.', 'sellsmith' );
                 } elseif ( $has_contact ) {

sellsmith/trunk/includes/class-sellsmith-conversations.php

@@ -305 +305 @@
                 $meta['contact']      = $value;
                 $meta['contact_type'] = $type;
-                $meta['mode']         = 'message';
+                // Only tag a conversation that has no mode yet. A live chat must stay live,
+                // or it drops out of the owner's live inbox the moment the visitor saves an email.
+                if ( empty( $meta['mode'] ) ) {
+                        $meta['mode'] = 'message';
+                }
 
                 $wpdb->update(
@@ -318 +322 @@
 
                 return $type;
+        }
+
+        /**
+         * Save the answers from the start questions ("Are you already a customer?").
+         * Never changes the conversation mode, and never replaces a contact that is
+         * already saved on it.
+         *
+         * @param int   $conversation_id Conversation id.
+         * @param array $data            start ('customer'|'new'), email, order_number,
+         *                               plus the order check fields for customers.
+         */
+        public static function save_start( $conversation_id, $data ) {
+                $conversation_id = (int) $conversation_id;
+                $meta            = self::get_meta( $conversation_id );
+
+                $changes = array(
+                        'start'    => ( isset( $data['start'] ) && 'customer' === $data['start'] ) ? 'customer' : 'new',
+                        'start_at' => time(),
+                );
+
+                $email = isset( $data['email'] ) ? sanitize_email( (string) $data['email'] ) : '';
+                if ( '' !== $email && is_email( $email ) && empty( $meta['contact'] ) ) {
+                        $changes['contact']      = $email;
+                        $changes['contact_type'] = 'email';
+                }
+
+                foreach ( array( 'order_number', 'order_match' ) as $key ) {
+                        $changes[ $key ] = isset( $data[ $key ] ) ? (string) $data[ $key ] : '';
+                }
+                foreach ( array( 'order_id', 'orders_by_email', 'last_order_id' ) as $key ) {
+                        $changes[ $key ] = isset( $data[ $key ] ) ? absint( $data[ $key ] ) : 0;
+                }
+
+                self::merge_meta( $conversation_id, $changes );
+
+                do_action( 'sellsmith_lead_updated', $conversation_id );
+        }
+
+        /**
+         * One plain line for the owner saying who the visitor is, from the start
+         * questions. Admin, owner alerts and the live console only: it names orders,
+         * so it is never sent to the visitor.
+         *
+         * @param array $meta    Decoded visitor_meta.
+         * @param bool  $details Add the order's products, date and status (loads the order).
+         * @return string Empty when the visitor never answered the start questions.
+         */
+        public static function visitor_line( $meta, $details = true ) {
+                if ( ! is_array( $meta ) || empty( $meta['start'] ) ) {
+                        return '';
+                }
+                if ( 'customer' !== $meta['start'] ) {
+                        return __( 'New visitor', 'sellsmith' );
+                }
+
+                $number = isset( $meta['order_number'] ) ? (string) $meta['order_number'] : '';
+                $match  = isset( $meta['order_match'] ) ? (string) $meta['order_match'] : '';
+                $id     = isset( $meta['order_id'] ) ? (int) $meta['order_id'] : 0;
+
+                if ( '' === $number ) {
+                        $count = isset( $meta['orders_by_email'] ) ? (int) $meta['orders_by_email'] : 0;
+                        $last  = isset( $meta['last_order_id'] ) ? (int) $meta['last_order_id'] : 0;
+                        if ( ! $count ) {
+                                return __( 'Customer, no order number given', 'sellsmith' ) . ( function_exists( 'wc_get_order' ) ? ', ' . __( 'no orders under this email', 'sellsmith' ) : '' );
+                        }
+                        /* translators: 1: number of orders ("5+" at most), 2: newest order number. */
+                        return sprintf( __( 'Customer, no order number given, %1$s orders under this email (newest #%2$d)', 'sellsmith' ), $count >= 5 ? '5+' : (string) $count, $last );
+                }
+
+                switch ( $match ) {
+                        case 'found':
+                                $line = sprintf(
+                                        /* translators: %s: order number. */
+                                        __( 'Customer, order #%s checked', 'sellsmith' ),
+                                        $number
+                                );
+                                $more = $details ? self::order_details( $id ) : '';
+                                return '' !== $more ? $line . ': ' . $more : $line;
+                        case 'email_mismatch':
+                                /* translators: %s: order number. */
+                                return sprintf( __( 'Customer, order #%s exists but under a different email', 'sellsmith' ), $number );
+                        case 'not_found':
+                                /* translators: %s: order number. */
+                                return sprintf( __( 'Customer, order #%s not found in this shop', 'sellsmith' ), $number );
+                        default:
+                                /* translators: %s: order number. */
+                                return sprintf( __( 'Customer, order #%s', 'sellsmith' ), $number );
+                }
+        }
+
+        /**
+         * Products, date and status of an order, for the owner.
+         *
+         * @param int $order_id Order id.
+         * @return string
+         */
+        private static function order_details( $order_id ) {
+                if ( ! $order_id || ! function_exists( 'wc_get_order' ) ) {
+                        return '';
+                }
+                $order = wc_get_order( $order_id );
+                if ( ! $order || ! is_a( $order, 'WC_Order' ) ) {
+                        return '';
+                }
+
+                $names = array();
+                foreach ( $order->get_items() as $item ) {
+                        $names[] = $item->get_name();
+                }
+
+                $parts = array();
+                if ( $names ) {
+                        $parts[] = implode( ', ', array_slice( $names, 0, 3 ) ) . ( count( $names ) > 3 ? ' +' . ( count( $names ) - 3 ) : '' );
+                }
+                $created = $order->get_date_created();
+                if ( $created ) {
+                        $parts[] = $created->date_i18n( get_option( 'date_format' ) );
+                }
+                $parts[] = wc_get_order_status_name( $order->get_status() );
+
+                return implode( ', ', $parts );
+        }
+
+        /**
+         * Admin link to the order a customer named, when it exists in this shop.
+         *
+         * @param array $meta Decoded visitor_meta.
+         * @return string URL or ''.
+         */
+        public static function visitor_order_url( $meta ) {
+                $id = ( is_array( $meta ) && ! empty( $meta['order_id'] ) ) ? (int) $meta['order_id'] : 0;
+                if ( ! $id && is_array( $meta ) && empty( $meta['order_number'] ) && ! empty( $meta['last_order_id'] ) ) {
+                        $id = (int) $meta['last_order_id'];
+                }
+                if ( ! $id || ! function_exists( 'wc_get_order' ) || ! current_user_can( 'edit_shop_orders' ) ) {
+                        return '';
+                }
+                $order = wc_get_order( $id );
+                return ( $order && is_a( $order, 'WC_Order' ) ) ? $order->get_edit_order_url() : '';
         }
 
@@ -621 +764 @@
                 if ( ! empty( $args['search'] ) ) {
                         $like   = '%' . $wpdb->esc_like( $args['search'] ) . '%';
-                        $where .= " AND (c.visitor_city LIKE %s OR c.session_id LIKE %s OR EXISTS (SELECT 1 FROM {$msg} m2 WHERE m2.conversation_id = c.id AND m2.content LIKE %s))";
-                        $params = array( $like, $like, $like );
+                        // visitor_meta holds the saved email and any order number from the start questions.
+                        $where .= " AND (c.visitor_city LIKE %s OR c.session_id LIKE %s OR c.visitor_meta LIKE %s OR EXISTS (SELECT 1 FROM {$msg} m2 WHERE m2.conversation_id = c.id AND m2.content LIKE %s))";
+                        $params = array( $like, $like, $like, $like );
                 }
 
@@ -712 +856 @@
 
         /**
-         * Conversation ids whose messages contain a given email (privacy tools).
+         * Conversation ids that hold a given email, in a message or as the saved
+         * contact (privacy tools).
          *
          * @param string $email Email address.
@@ -719 +864 @@
         public static function ids_by_email( $email, $page = 1 ) {
                 global $wpdb;
-                $msg = $wpdb->prefix . 'sw_messages';
+                $conv = $wpdb->prefix . 'sw_conversations';
+                $msg  = $wpdb->prefix . 'sw_messages';
 
                 $like   = '%' . $wpdb->esc_like( $email ) . '%';
@@ -726 +872 @@
                 $ids = $wpdb->get_col(
                         $wpdb->prepare(
-                                "SELECT DISTINCT conversation_id FROM {$msg} WHERE content LIKE %s ORDER BY conversation_id ASC LIMIT 10 OFFSET %d", // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared
+                                "SELECT c.id FROM {$conv} c WHERE c.visitor_meta LIKE %s OR EXISTS (SELECT 1 FROM {$msg} m WHERE m.conversation_id = c.id AND m.content LIKE %s) ORDER BY c.id ASC LIMIT 10 OFFSET %d", // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared
+                                $like,
                                 $like,
                                 $offset

sellsmith/trunk/includes/class-sellsmith-privacy.php

@@ -69 +69 @@
                         }
 
+                        $meta  = Sellsmith_Conversations::meta( $id );
+                        $items = array(
+                                array(
+                                        'name'  => __( 'Started', 'sellsmith' ),
+                                        'value' => $conv['started_at'],
+                                ),
+                                array(
+                                        'name'  => __( 'City', 'sellsmith' ),
+                                        'value' => $conv['visitor_city'],
+                                ),
+                        );
+                        if ( ! empty( $meta['contact'] ) ) {
+                                $items[] = array(
+                                        'name'  => __( 'Contact', 'sellsmith' ),
+                                        'value' => $meta['contact'],
+                                );
+                        }
+                        if ( ! empty( $meta['order_number'] ) ) {
+                                $items[] = array(
+                                        'name'  => __( 'Order number', 'sellsmith' ),
+                                        'value' => $meta['order_number'],
+                                );
+                        }
+                        $items[] = array(
+                                'name'  => __( 'Transcript', 'sellsmith' ),
+                                'value' => $transcript,
+                        );
+
                         $data[] = array(
                                 'group_id'    => 'sellsmith_conversations',
                                 'group_label' => __( 'Chat conversations', 'sellsmith' ),
                                 'item_id'     => 'sellsmith-conversation-' . $id,
-                                'data'        => array(
-                                        array(
-                                                'name'  => __( 'Started', 'sellsmith' ),
-                                                'value' => $conv['started_at'],
-                                        ),
-                                        array(
-                                                'name'  => __( 'City', 'sellsmith' ),
-                                                'value' => $conv['visitor_city'],
-                                        ),
-                                        array(
-                                                'name'  => __( 'Transcript', 'sellsmith' ),
-                                                'value' => $transcript,
-                                        ),
-                                ),
+                                'data'        => $items,
                         );
                 }
@@ -103 +118 @@
          */
         public static function erase( $email, $page = 1 ) {
-                $ids = Sellsmith_Conversations::ids_by_email( $email, $page );
+                // Always page 1: each pass deletes what it found, so an offset would skip rows.
+                $ids = Sellsmith_Conversations::ids_by_email( $email, 1 );
 
                 if ( $ids ) {

sellsmith/trunk/includes/class-sellsmith-rest.php

@@ -93 +93 @@
                                         ),
                                         'nonce' => array(
+                                                'type'              => 'string',
+                                                'required'          => false,
+                                                'sanitize_callback' => 'sanitize_text_field',
+                                        ),
+                                ),
+                        )
+                );
+
+                register_rest_route(
+                        self::NS,
+                        '/start',
+                        array(
+                                'methods'             => WP_REST_Server::CREATABLE,
+                                'callback'            => array( __CLASS__, 'start' ),
+                                'permission_callback' => array( __CLASS__, 'verify_widget_nonce' ),
+                                'args'                => array(
+                                        'session_id' => array(
+                                                'type'              => 'string',
+                                                'required'          => true,
+                                                'sanitize_callback' => 'sanitize_text_field',
+                                        ),
+                                        'type'       => array(
+                                                'type'              => 'string',
+                                                'required'          => true,
+                                                'sanitize_callback' => 'sanitize_key',
+                                        ),
+                                        'email'      => array(
+                                                'type'              => 'string',
+                                                'required'          => false,
+                                                'sanitize_callback' => 'sanitize_text_field',
+                                        ),
+                                        'order'      => array(
+                                                'type'              => 'string',
+                                                'required'          => false,
+                                                'sanitize_callback' => 'sanitize_text_field',
+                                        ),
+                                        'nonce'      => array(
                                                 'type'              => 'string',
                                                 'required'          => false,
@@ -191 +228 @@
 
                 return rest_ensure_response( $payload );
+        }
+
+        /**
+         * Save the answers to the start questions: customer or not, their email, and
+         * for customers the order number, checked against this shop's orders. The
+         * answer never says whether an order exists; only the owner sees that.
+         *
+         * @param WP_REST_Request $request Request.
+         */
+        public static function start( WP_REST_Request $request ) {
+
+                if ( ! Sellsmith_Settings::get( 'widget_enabled' ) || ! Sellsmith_Settings::get( 'start_step' ) ) {
+                        return new WP_Error( 'sellsmith_off', __( 'Chat is not available right now.', 'sellsmith' ), array( 'status' => 403 ) );
+                }
+
+                // Per-IP rate limit, so the form cannot be used to flood the inbox with rows.
+                $ip   = isset( $_SERVER['REMOTE_ADDR'] ) ? sanitize_text_field( wp_unslash( $_SERVER['REMOTE_ADDR'] ) ) : '';
+                $key  = 'sellsmith_start_' . md5( $ip );
+                $hits = (int) get_transient( $key );
+                if ( $hits >= 30 ) {
+                        return new WP_Error( 'sellsmith_rate', __( 'Too many requests. Please wait a moment.', 'sellsmith' ), array( 'status' => 429 ) );
+                }
+                set_transient( $key, $hits + 1, HOUR_IN_SECONDS );
+
+                $session_id = (string) $request->get_param( 'session_id' );
+                if ( ! preg_match( '/^[A-Za-z0-9\-]{8,64}$/', $session_id ) ) {
+                        return new WP_Error( 'sellsmith_session', __( 'Please refresh the page and try again.', 'sellsmith' ), array( 'status' => 400 ) );
+                }
+
+                $type = (string) $request->get_param( 'type' );
+                if ( ! in_array( $type, array( 'customer', 'new' ), true ) ) {
+                        return new WP_Error( 'sellsmith_type', __( 'Please pick an answer.', 'sellsmith' ), array( 'status' => 400 ) );
+                }
+
+                $email = trim( (string) $request->get_param( 'email' ) );
+                if ( '' !== $email ) {
+                        $email = sanitize_email( $email );
+                        if ( ! $email || ! is_email( $email ) ) {
+                                return new WP_Error( 'sellsmith_email', __( 'Please enter a valid email.', 'sellsmith' ), array( 'status' => 400 ) );
+                        }
+                } elseif ( 'optional' !== Sellsmith_Settings::get( 'start_email' ) ) {
+                        return new WP_Error( 'sellsmith_email', __( 'Please enter your email.', 'sellsmith' ), array( 'status' => 400 ) );
+                }
+
+                $order = '';
+                if ( 'customer' === $type ) {
+                        $order = preg_replace( '/[^A-Za-z0-9\-_\/]/', '', ltrim( trim( (string) $request->get_param( 'order' ) ), '#' ) );
+                        $order = substr( (string) $order, 0, 40 );
+                }
+
+                $conversation_id = Sellsmith_Conversations::get_or_create( $session_id );
+                if ( ! $conversation_id ) {
+                        return new WP_Error( 'sellsmith_conv', __( 'Something went wrong. Please try again.', 'sellsmith' ), array( 'status' => 500 ) );
+                }
+
+                $data = array(
+                        'start'        => $type,
+                        'email'        => $email,
+                        'order_number' => $order,
+                );
+                if ( 'customer' === $type ) {
+                        $data = array_merge( $data, self::match_order( $order, $email ) );
+                }
+
+                Sellsmith_Conversations::save_start( $conversation_id, $data );
+
+                return rest_ensure_response( array( 'ok' => true ) );
+        }
+
+        /**
+         * Look a customer's order up in WooCommerce. An order only counts as found
+         * when its billing email is the email they typed.
+         *
+         * @param string $number Order number as typed (cleaned), or ''.
+         * @param string $email  Email as typed (valid), or ''.
+         * @return array order_match ('found'|'email_mismatch'|'not_found'|''), order_id,
+         *               orders_by_email, last_order_id.
+         */
+        private static function match_order( $number, $email ) {
+                $out = array(
+                        'order_match'     => '',
+                        'order_id'        => 0,
+                        'orders_by_email' => 0,
+                        'last_order_id'   => 0,
+                );
+
+                if ( ! sellsmith_has_wc() || ! function_exists( 'wc_get_order' ) ) {
+                        return $out;
+                }
+
+                if ( '' !== $email && function_exists( 'wc_get_orders' ) ) {
+                        $ids = wc_get_orders(
+                                array(
+                                        'billing_email' => $email,
+                                        'limit'         => 5,
+                                        'orderby'       => 'date',
+                                        'order'         => 'DESC',
+                                        'return'        => 'ids',
+                                )
+                        );
+                        $ids                    = is_array( $ids ) ? array_values( $ids ) : array();
+                        $out['orders_by_email'] = count( $ids );
+                        $out['last_order_id']   = $ids ? (int) $ids[0] : 0;
+                }
+
+                if ( '' === $number ) {
+                        return $out;
+                }
+
+                // Same filter as WooCommerce's own order tracking form, so shops that use
+                // custom order numbers (sequential number plugins) map them to the real id.
+                $id    = (string) apply_filters( 'woocommerce_shortcode_order_tracking_order_id', $number );
+                $order = ctype_digit( $id ) ? wc_get_order( (int) $id ) : false;
+
+                if ( ! $order || ! is_a( $order, 'WC_Order' ) ) {
+                        $out['order_match'] = 'not_found';
+                        return $out;
+                }
+
+                $out['order_id']    = $order->get_id();
+                $out['order_match'] = ( '' !== $email && strtolower( $order->get_billing_email() ) === strtolower( $email ) ) ? 'found' : 'email_mismatch';
+
+                return $out;
         }
 

sellsmith/trunk/includes/class-sellsmith-settings.php

@@ -48 +48 @@
                         'teaser_text'     => __( 'Need help finding something?', 'sellsmith' ),
                         'show_credit'     => 0,
+                        // Start questions (asked when the chat opens).
+                        'start_step'      => 0,
+                        'start_email'     => 'required',
+                        'start_question'  => __( 'Are you already a customer?', 'sellsmith' ),
+                        'start_yes'       => __( 'Yes, I have an order', 'sellsmith' ),
+                        'start_no'        => __( 'No, not yet', 'sellsmith' ),
                         // WhatsApp.
                         'wa_number'       => '',
@@ -69 +75 @@
                         'connection' => array( 'api_key', 'model', 'custom_model' ),
                         'profile'    => array( 'store_about', 'delivery_info', 'delivery_areas', 'cod_enabled', 'open_parcel', 'return_policy', 'discount_info', 'payment_methods', 'extra_info' ),
-                        'appearance' => array( 'widget_position', 'widget_color', 'widget_title', 'welcome_message', 'teaser_text', 'show_credit' ),
+                        'appearance' => array( 'widget_position', 'widget_color', 'widget_title', 'welcome_message', 'teaser_text', 'show_credit', 'start_step', 'start_email', 'start_question', 'start_yes', 'start_no' ),
                         'whatsapp'   => array( 'wa_number', 'wa_enabled' ),
                         'advanced'   => array( 'rate_limit', 'max_messages', 'retention_days', 'consent_required', 'keep_data' ),
@@ -79 +85 @@
          */
         public static function checkbox_keys() {
-                return array( 'cod_enabled', 'widget_enabled', 'wa_enabled', 'consent_required', 'keep_data', 'show_credit' );
+                return array( 'cod_enabled', 'widget_enabled', 'wa_enabled', 'consent_required', 'keep_data', 'show_credit', 'start_step' );
         }
 
@@ -169 +175 @@
                                 case 'chat_mode':
                                         $existing[ $key ] = in_array( $raw, array( 'ai', 'message' ), true ) ? $raw : 'ai';
+                                        break;
+
+                                case 'start_email':
+                                        $existing[ $key ] = in_array( $raw, array( 'required', 'optional' ), true ) ? $raw : 'required';
+                                        break;
+
+                                case 'start_question':
+                                case 'start_yes':
+                                case 'start_no':
+                                        // A cleared field falls back to the default wording, never an empty button.
+                                        $raw              = sanitize_text_field( $raw );
+                                        $existing[ $key ] = '' !== $raw ? $raw : self::defaults()[ $key ];
                                         break;
 

sellsmith/trunk/includes/class-sellsmith-widget.php

@@ -73 +73 @@
                         'context'  => self::page_context(),
                         'showCredit' => ! empty( $s['show_credit'] ),
+                        // Start questions ("Are you already a customer?"), asked when the chat opens.
+                        'startStep'  => ! empty( $s['start_step'] ) ? 1 : 0,
+                        'startEmail' => ( 'optional' === $s['start_email'] ) ? 'optional' : 'required',
+                        'startUrl'   => esc_url_raw( rest_url( 'sellsmith/v1/start' ) ),
+                        // A logged-in visitor's own email, to fill the field in for them.
+                        'userEmail'  => ( ! empty( $s['start_step'] ) && is_user_logged_in() ) ? wp_get_current_user()->user_email : '',
                         'i18n'     => array(
                                 'placeholder' => __( 'Type a message', 'sellsmith' ),
@@ -90 +96 @@
                                 'sent'         => __( 'Sent', 'sellsmith' ),
                                 'seen'         => __( 'Seen', 'sellsmith' ),
+                                // Start questions.
+                                'startQuestion'   => '' !== trim( (string) $s['start_question'] ) ? $s['start_question'] : Sellsmith_Settings::defaults()['start_question'],
+                                'startYes'        => '' !== trim( (string) $s['start_yes'] ) ? $s['start_yes'] : Sellsmith_Settings::defaults()['start_yes'],
+                                'startNo'         => '' !== trim( (string) $s['start_no'] ) ? $s['start_no'] : Sellsmith_Settings::defaults()['start_no'],
+                                'startCustomer'   => __( 'Great! What is your order number, and the email you ordered with?', 'sellsmith' ),
+                                'startNew'        => __( 'What is your email? If we cannot reply right away, we will answer you there.', 'sellsmith' ),
+                                'startOrder'      => __( 'Order number (if you have it)', 'sellsmith' ),
+                                'startEmailBuy'   => __( 'Email you ordered with', 'sellsmith' ),
+                                'startEmailNew'   => __( 'Your email', 'sellsmith' ),
+                                'startGo'         => __( 'Continue', 'sellsmith' ),
+                                'startSkip'       => __( 'Skip', 'sellsmith' ),
+                                'startBadEmail'   => __( 'Please enter a valid email.', 'sellsmith' ),
+                                'startOrderShort' => __( 'Order', 'sellsmith' ),
+                                'startThanks'     => ( 'message' === $s['chat_mode'] )
+                                        ? __( 'Thanks! Now type your question below. If we are not here right away, we will reply to you by email.', 'sellsmith' )
+                                        : __( 'Thanks! Now type your question below.', 'sellsmith' ),
+                                'startThanksShort' => __( 'Thanks! Now type your question below.', 'sellsmith' ),
+                                'startLocked'     => __( 'Pick an answer above first', 'sellsmith' ),
                         ),
                 );

sellsmith/trunk/languages/sellsmith.pot

@@ +1 @@
+# Copyright (C) 2026 DevTonic Studios
+# This file is distributed under the GPLv2 or later.
 msgid ""
 msgstr ""
-"Project-Id-Version: Sellsmith 1.1.0\n"
+"Project-Id-Version: Sellsmith – AI Chatbot, Lead Capture & Sales Chat 1.2.0\n"
+"Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/sellsmith\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"POT-Creation-Date: 2026-06-12 23:16+0000\n"
+"POT-Creation-Date: 2026-09-25T00:52:32+00:00\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"X-Generator: WP-CLI 2.12.0\n"
 "X-Domain: sellsmith\n"
 
+#. Plugin Name of the plugin
+#: sellsmith.php
+msgid "Sellsmith – AI Chatbot, Lead Capture & Sales Chat"
+msgstr ""
+
+#. Plugin URI of the plugin
+#: sellsmith.php
+msgid "https://devtonicstudios.com/sellsmith"
+msgstr ""
+
+#. Description of the plugin
+#: sellsmith.php
+msgid "An AI sales agent for your store. Answers buyers from your real product data, captures leads, and hands hot buyers to your WhatsApp. Runs on your own free Gemini API key."
+msgstr ""
+
+#. Author of the plugin
+#: sellsmith.php
+msgid "DevTonic Studios"
+msgstr ""
+
+#. Author URI of the plugin
+#: sellsmith.php
+msgid "https://devtonicstudios.com"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:33
+#: admin/class-sellsmith-admin.php:34
+msgid "Sellsmith"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:71
+msgid "WooCommerce is not active. Sellsmith will still chat and capture leads, and product answers will switch on automatically when WooCommerce is installed."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:100
+msgid "Testing…"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:118
+msgid "AI key"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:119
+msgid "Business profile"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:120
+msgid "Appearance"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:121
+#: admin/class-sellsmith-leads.php:197
+#: admin/class-sellsmith-leads.php:303
+msgid "WhatsApp"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:122
+msgid "Advanced"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:123
+#: admin/class-sellsmith-admin.php:872
+msgid "Sellsmith Pro"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:219
+#: admin/class-sellsmith-admin.php:318
+msgid "Chat on my store"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:221
+msgid "Buyers can see and use the chat."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:221
+msgid "Paused. Buyers do not see the chat right now."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:228
+msgid "How it answers buyers"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:234
+msgid "AI answers"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:236
+msgid "The AI replies about products, price and delivery."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:237
+msgid "Needs your Gemini key. Add it in the AI key settings."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:242
+msgid "Just collect messages"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:243
+msgid "No AI. Save each question and contact as a lead."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:250
+msgid "Also let buyers reach a person"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:266
+msgid "Open settings"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:267
+msgid "Open inbox"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:284
+msgid "Right now your chat is OFF. Buyers do not see a chat on your store. Turn it on below."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:288
+msgid "Your chat is ON. It saves each buyer's question and contact as a lead."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:292
+msgid "Your chat is ON. The AI answers buyers about products, price and delivery."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:296
+msgid "Your chat is ON, but the AI needs your Gemini key to answer. Add it in the AI key settings."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:357
+#: admin/class-sellsmith-admin.php:852
+msgid "Live chat"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:357
+msgid "Pro"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:358
+msgid "Reply to buyers yourself in real time, with no page refresh. In Sellsmith Pro."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:379
+msgid "Home"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:415
+msgid "Save settings"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:446
+msgid "Setup complete. Your chat is live."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:452
+msgid "1. Connect your free Gemini key"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:453
+msgid "2. Tell the AI about your store"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:454
+msgid "3. Turn the chat on"
+msgstr ""
+
+#. translators: %d: completed steps out of 3
+#: admin/class-sellsmith-admin.php:461
+#, php-format
+msgid "Setup: %d of 3 steps done"
+msgstr ""
+
+#. translators: %s: link to Google AI Studio
+#: admin/class-sellsmith-admin.php:548
+#, php-format
+msgid "Get a free Gemini API key from %s (takes 1 minute, no card needed)."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:553
+msgid "Connect to Gemini"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:557
+msgid "Gemini API key"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:559
+msgid "A key is saved. Leave blank to keep it, or paste a new key to replace it."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:560
+msgid "Paste your key, then press Test connection."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:566
+msgid "AI model"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:574
+msgid "Gemma gives the most free chats per day; the Gemini models give more polished replies. All five support product lookups."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:577
+msgid "Free-tier limits by model"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:581
+msgid "Model"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:582
+msgid "Free chats / day*"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:583
+msgid "Per minute"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:584
+msgid "Product lookups"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:588
+#: admin/class-sellsmith-admin.php:589
+#: admin/class-sellsmith-admin.php:590
+#: admin/class-sellsmith-admin.php:591
+#: admin/class-sellsmith-admin.php:592
+msgid "Yes"
+msgstr ""
+
+#. translators: %s: link to Google AI Studio
+#: admin/class-sellsmith-admin.php:599
+#, php-format
+msgid "*Free limits depend on your Google account and region. These are typical values. Gemma gives the most free chats but slightly rougher replies. Paid use is cheapest on the Flash-Lite models. %s."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:600
+msgid "Check your live limits"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:608
+msgid "Custom model id (optional)"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:609
+msgid "For advanced users. If filled, this overrides the dropdown. Useful when Google releases new models."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:613
+msgid "Test your key"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:616
+msgid "Test connection"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:625
+msgid "Important: keep the free tier free."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:626
+msgid "Do not enable billing on the Google Cloud project of this key. If billing is on, Google charges every request instead of using the free daily limit. A key from a fresh AI Studio project is perfect."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:635
+msgid "The AI answers from this page plus your live product data. These are the questions real buyers ask on WhatsApp. Write your answers in any language, the AI adapts."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:638
+msgid "About your store"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:642
+msgid "Store overview"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:644
+msgid "Example: Stride sells men and women sports shoes. Based in Lahore, shipping all Pakistan since 2021."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:649
+msgid "Delivery"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:653
+msgid "Delivery charges and time"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:654
+msgid "Buyers ask: \"What are delivery charges?\" and \"When will I receive it?\""
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:655
+msgid "Example: Rs 200 flat, free over Rs 5,000. Lahore 1-2 days, rest of Pakistan 2-4 days."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:659
+msgid "Delivery areas"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:660
+msgid "Buyers ask: \"Do you deliver to my area?\""
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:661
+msgid "Example: All Pakistan via Leopards and TCS. No international shipping."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:665
+msgid "Cash on delivery"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:666
+msgid "We accept cash on delivery"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:671
+msgid "Policies & payment"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:675
+msgid "Open parcel policy"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:676
+msgid "Buyers ask: \"Can I open and check the parcel before paying?\" Very common in COD markets."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:677
+msgid "Example: Yes, you can open and check the parcel in front of the rider before paying."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:681
+msgid "Faults, returns and warranty"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:682
+msgid "Buyers ask: \"What if the product has a fault?\""
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:683
+msgid "Example: 7-day free replacement for any fault. Exchange only, no cash refund."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:687
+msgid "Discounts and bulk deals"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:688
+msgid "Buyers ask: \"Any discount?\" and \"What if I buy 2?\""
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:689
+msgid "Example: 10% off on 2 or more pairs. No other discounts right now."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:693
+msgid "Payment methods"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:695
+msgid "Example: COD, JazzCash, Easypaisa, bank transfer."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:700
+msgid "Anything else"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:704
+msgid "Notes for the AI"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:705
+msgid "Size guides, store timings, special instructions. Optional."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:713
+msgid "Look and feel"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:716
+msgid "Position"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:718
+msgid "Bottom right"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:719
+msgid "Bottom left (good for RTL sites)"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:723
+msgid "Brand color"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:726
+msgid "Pick a color"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:733
+msgid "This one color is used across the whole chat: the button, the header, and your reply bubbles. Click the swatch to pick, or type a hex code like #a0561b."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:736
+msgid "Chat title"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:737
+msgid "Welcome message"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:738
+msgid "Pop-up greeting"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:741
+msgid "Credit link"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:742
+msgid "Show a small \"AI agent by Sellsmith\" link at the bottom of the chat"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:748
+msgid "When the chat opens"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:753
+msgid "Start questions"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:754
+msgid "Ask \"Are you already a customer?\" first. Customers give their order number and email, new visitors give their email. Then they type their question."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:758
+msgid "Email"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:760
+msgid "Required, so you can always reply"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:761
+msgid "Optional, visitors can skip it"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:765
+msgid "Question"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:766
+msgid "Button for customers"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:767
+msgid "Button for new visitors"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:769
+msgid "With WooCommerce, the order number is checked against your orders. Only you see the result, in the Inbox. The visitor is never told whether an order exists."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:775
+#: admin/class-sellsmith-admin.php:787
+msgid "WhatsApp handoff"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:780
+msgid "WhatsApp number"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:781
+msgid "International format, digits only, no + and no spaces. Example for Pakistan: 923001234567"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:788
+msgid "Let the AI offer a WhatsApp button to serious buyers, with their order details pre-written"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:795
+msgid "No WhatsApp Business API and no Meta approval needed. The button uses an official wa.me link that opens your normal WhatsApp."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:801
+msgid "Limits & privacy"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:806
+msgid "Message limit per chat, then WhatsApp"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:807
+msgid "After this many buyer messages in one chat, the assistant stops and offers the WhatsApp button instead. Keeps each chat cheap and sends hot buyers straight to you. Default 10."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:812
+msgid "Message limit per visitor per hour"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:813
+msgid "Protects your free daily AI limit from abuse. Default 20."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:818
+msgid "Auto-delete old conversations after (days)"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:819
+msgid "Leave 0 to keep every conversation forever. Set a number (for example 90) and conversations older than that are removed automatically each day, to save space and respect privacy."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:824
+msgid "Privacy consent"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:825
+msgid "Ask visitors to accept a short privacy note before the first message (recommended for EU stores)"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:829
+msgid "On uninstall"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:830
+msgid "Keep my settings and saved conversations if I delete the plugin"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:837
+msgid "Privacy note: visitor chat messages are sent to Google Gemini for processing using your API key. Mention this in your privacy policy."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:852
+msgid "Reply to buyers yourself in real time."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:853
+msgid "Lead scoring"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:853
+msgid "See Hot, Warm, and Cold buyers at a glance."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:854
+msgid "Hot-lead alerts"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:854
+msgid "Get an email the moment a serious buyer chats."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:855
+msgid "Reply by email"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:855
+msgid "Answer a saved chat straight from your inbox."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:856
+msgid "Agent branding"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:856
+msgid "Show your photo or logo as the chat avatar."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:862
+msgid "Sellsmith Pro is active. Here is everything it adds and where to set each one up."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:864
+msgid "Sellsmith Pro is installed. Activate your license to switch these on."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:866
+msgid "These features are part of Sellsmith Pro."
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:873
+msgid "Active"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:884
+#: admin/class-sellsmith-leads.php:44
+#: admin/class-sellsmith-leads.php:45
+#: sellsmith.php:103
 msgid "Settings"
 msgstr ""
 
-msgid "Sellsmith"
-msgstr ""
-
-msgid "WooCommerce is not active. Sellsmith will still chat and capture leads, and product answers will switch on automatically when WooCommerce is installed."
-msgstr ""
-
-msgid "Testing…"
-msgstr ""
-
-msgid "Connection"
-msgstr ""
-
-msgid "Business Profile"
-msgstr ""
-
-msgid "Chat Widget"
-msgstr ""
-
-msgid "WhatsApp"
-msgstr ""
-
-msgid "Advanced"
-msgstr ""
-
-msgid "Save settings"
-msgstr ""
-
-msgid "1. Connect your free Gemini key"
-msgstr ""
-
-msgid "2. Fill your business profile"
-msgstr ""
-
-msgid "3. Add your WhatsApp number"
-msgstr ""
-
-msgid "Setup complete. Turn on the widget in the Chat Widget tab and your assistant is live."
-msgstr ""
-
-msgid "Setup: %d of 3 steps done"
-msgstr ""
-
-msgid "Get a free Gemini API key from %s (takes 1 minute, no card needed)."
-msgstr ""
-
-msgid "Gemini API key"
-msgstr ""
-
-msgid "A key is saved. Leave blank to keep it, or paste a new key to replace it."
-msgstr ""
-
-msgid "Paste your key, then press Test connection."
-msgstr ""
-
-msgid "AI model"
-msgstr ""
-
-msgid "Flash Lite gives the biggest free daily limit and is fast enough for sales chat."
-msgstr ""
-
-msgid "Custom model id (optional)"
-msgstr ""
-
-msgid "For advanced users. If filled, this overrides the dropdown. Useful when Google releases new models."
-msgstr ""
-
-msgid "Test"
-msgstr ""
-
-msgid "Test connection"
-msgstr ""
-
-msgid "Important: keep the free tier free."
-msgstr ""
-
-msgid "Do not enable billing on the Google Cloud project of this key. If billing is on, Google charges every request instead of using the free daily limit. A key from a fresh AI Studio project is perfect."
-msgstr ""
-
-msgid "The AI answers from this page plus your live product data. These are the questions real buyers ask on WhatsApp. Write your answers in any language, the AI adapts."
-msgstr ""
-
-msgid "About your store"
-msgstr ""
-
-msgid "Example: Stride sells men and women sports shoes. Based in Lahore, shipping all Pakistan since 2021."
-msgstr ""
-
-msgid "Delivery charges and time"
-msgstr ""
-
-msgid "Buyers ask: \"What are delivery charges?\" and \"When will I receive it?\""
-msgstr ""
-
-msgid "Example: Rs 200 flat, free over Rs 5,000. Lahore 1-2 days, rest of Pakistan 2-4 days."
-msgstr ""
-
-msgid "Delivery areas"
-msgstr ""
-
-msgid "Buyers ask: \"Do you deliver to my area?\""
-msgstr ""
-
-msgid "Example: All Pakistan via Leopards and TCS. No international shipping."
-msgstr ""
-
-msgid "Cash on delivery"
-msgstr ""
-
-msgid "We accept cash on delivery"
-msgstr ""
-
-msgid "Open parcel policy"
-msgstr ""
-
-msgid "Buyers ask: \"Can I open and check the parcel before paying?\" Very common in COD markets."
-msgstr ""
-
-msgid "Example: Yes, you can open and check the parcel in front of the rider before paying."
-msgstr ""
-
-msgid "Faults, returns and warranty"
-msgstr ""
-
-msgid "Buyers ask: \"What if the product has a fault?\""
-msgstr ""
-
-msgid "Example: 7-day free replacement for any fault. Exchange only, no cash refund."
-msgstr ""
-
-msgid "Discounts and bulk deals"
-msgstr ""
-
-msgid "Buyers ask: \"Any discount?\" and \"What if I buy 2?\""
-msgstr ""
-
-msgid "Example: 10% off on 2 or more pairs. No other discounts right now."
-msgstr ""
-
-msgid "Payment methods"
-msgstr ""
-
-msgid "Example: COD, JazzCash, Easypaisa, bank transfer."
-msgstr ""
-
-msgid "Anything else the AI should know"
-msgstr ""
-
-msgid "Size guides, store timings, special instructions. Optional."
-msgstr ""
-
-msgid "Show widget"
-msgstr ""
-
-msgid "Show the chat widget on my store"
-msgstr ""
-
-msgid "Position"
-msgstr ""
-
-msgid "Bottom right"
-msgstr ""
-
-msgid "Bottom left (good for RTL sites)"
-msgstr ""
-
-msgid "Brand color"
-msgstr ""
-
-msgid "Widget title"
-msgstr ""
-
-msgid "Welcome message"
-msgstr ""
-
-msgid "Teaser bubble text"
-msgstr ""
-
-msgid "WhatsApp number"
-msgstr ""
-
-msgid "International format, digits only, no + and no spaces. Example for Pakistan: 923001234567"
-msgstr ""
-
-msgid "WhatsApp handoff"
-msgstr ""
-
-msgid "Let the AI offer a WhatsApp button to serious buyers, with their order details pre-written"
-msgstr ""
-
-msgid "No WhatsApp Business API and no Meta approval needed. The button uses an official wa.me link that opens your normal WhatsApp."
-msgstr ""
-
-msgid "Messages per visitor per hour"
-msgstr ""
-
-msgid "Protects your free daily AI limit from abuse. Default 20."
-msgstr ""
-
-msgid "Privacy consent"
-msgstr ""
-
-msgid "Ask visitors to accept a short privacy note before the first message (recommended for EU stores)"
-msgstr ""
-
-msgid "On uninstall"
-msgstr ""
-
-msgid "Keep my settings and saved conversations if I delete the plugin"
-msgstr ""
-
-msgid "Privacy note: visitor chat messages are sent to Google Gemini for processing using your API key. Mention this in your privacy policy."
-msgstr ""
-
-msgid "Leads"
-msgstr ""
-
+#: admin/class-sellsmith-admin.php:892
+msgid "Activate your license"
+msgstr ""
+
+#: admin/class-sellsmith-admin.php:898
+msgid "Get Sellsmith Pro"
+msgstr ""
+
+#: admin/class-sellsmith-leads.php:26
+#: admin/class-sellsmith-leads.php:27
+msgid "Dashboard"
+msgstr ""
+
+#: admin/class-sellsmith-leads.php:34
+#: admin/class-sellsmith-leads.php:35
+#: admin/class-sellsmith-leads.php:107
+msgid "Inbox"
+msgstr ""
+
+#: admin/class-sellsmith-leads.php:101
+msgid "All chats"
+msgstr ""
+
+#: admin/class-sellsmith-leads.php:156
 msgid "Deleted."
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:161
 msgid "Chats today"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:162
 msgid "Chats, last 7 days"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:163
 msgid "WhatsApp clicks, last 7 days"
 msgstr ""
 
-msgid "Free version keeps the last 30 days of conversations."
-msgstr ""
-
-msgid "Search city or message…"
-msgstr ""
-
+#. translators: %d: number of days.
+#: admin/class-sellsmith-leads.php:170
+#, php-format
+msgid "Conversations older than %d days are deleted automatically. Change this in Settings → Advanced."
+msgstr ""
+
+#: admin/class-sellsmith-leads.php:174
+msgid "All conversations are kept. Set an auto-delete period in Settings → Advanced if you prefer."
+msgstr ""
+
+#: admin/class-sellsmith-leads.php:180
+msgid "Search email, order, city or message…"
+msgstr ""
+
+#: admin/class-sellsmith-leads.php:181
 msgid "Search"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:191
+#: admin/class-sellsmith-leads.php:298
+#: includes/class-sellsmith-privacy.php:74
 msgid "Started"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:192
 msgid "First message"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:193
+#: admin/class-sellsmith-leads.php:299
+#: includes/class-sellsmith-privacy.php:78
 msgid "City"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:194
+#: admin/class-sellsmith-leads.php:300
+#: includes/class-sellsmith-privacy.php:84
+msgid "Contact"
+msgstr ""
+
+#: admin/class-sellsmith-leads.php:195
 msgid "Products"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:196
 msgid "Messages"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:204
 msgid "No conversations yet. They will appear here as soon as visitors start chatting."
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:214
 msgid "(no message)"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:223
 msgid "View"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:224
+#: admin/class-sellsmith-leads.php:347
 msgid "Delete this conversation?"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:224
 msgid "Delete"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:229
 msgid "clicked"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:243
 msgid "Delete selected conversations?"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:243
 msgid "Delete selected"
 msgstr ""
 
-msgid "Back to leads"
-msgstr ""
-
+#: admin/class-sellsmith-leads.php:272
+msgid "Back to inbox"
+msgstr ""
+
+#: admin/class-sellsmith-leads.php:275
 msgid "Conversation not found"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:282
 msgid "Conversation"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:301
+msgid "Visitor"
+msgstr ""
+
+#: admin/class-sellsmith-leads.php:302
 msgid "Note"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:303
 msgid "Clicked the button"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:308
+msgid "Open their order"
+msgstr ""
+
+#: admin/class-sellsmith-leads.php:313
 msgid "Products discussed:"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:322
 msgid "Buyer"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:324
+msgid "You"
+msgstr ""
+
+#: admin/class-sellsmith-leads.php:326
 msgid "AI"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:347
 msgid "Delete conversation"
 msgstr ""
 
+#: admin/class-sellsmith-leads.php:379
+msgid "Customer"
+msgstr ""
+
+#: admin/class-sellsmith-leads.php:384
+#: includes/class-sellsmith-conversations.php:376
+msgid "New visitor"
+msgstr ""
+
+#: includes/class-sellsmith-chat.php:28
+#: includes/class-sellsmith-chat.php:90
+#: includes/class-sellsmith-rest.php:242
+msgid "Chat is not available right now."
+msgstr ""
+
+#: includes/class-sellsmith-chat.php:36
+#: includes/class-sellsmith-rest.php:256
+msgid "Please refresh the page and try again."
+msgstr ""
+
+#: includes/class-sellsmith-chat.php:49
+msgid "You are sending messages very fast. Please wait a minute and try again."
+msgstr ""
+
+#: includes/class-sellsmith-chat.php:94
+msgid "Please type a message first."
+msgstr ""
+
+#: includes/class-sellsmith-chat.php:99
+#: includes/class-sellsmith-chat.php:154
+msgid "Our assistant is taking a short break. Message us directly and we will reply fast."
+msgstr ""
+
+#: includes/class-sellsmith-chat.php:105
+#: includes/class-sellsmith-chat.php:222
+#: includes/class-sellsmith-rest.php:282
+msgid "Something went wrong. Please try again."
+msgstr ""
+
+#: includes/class-sellsmith-chat.php:112
+msgid "Thanks for chatting! To get full details and place your order, please message us on WhatsApp. Our team will help you finish up there."
+msgstr ""
+
+#: includes/class-sellsmith-chat.php:217
+msgid "This chat link is no longer valid. Please start a new chat."
+msgstr ""
+
+#: includes/class-sellsmith-chat.php:234
+msgid "Thanks! We have your messages and will reply to you soon."
+msgstr ""
+
+#: includes/class-sellsmith-chat.php:258
+msgid "Got it! 🙏 We will reply to you here soon. You can add more details if you like."
+msgstr ""
+
+#: includes/class-sellsmith-chat.php:264
+msgid "Thanks for your message! What is the best email or WhatsApp number to reach you?"
+msgstr ""
+
+#: includes/class-sellsmith-chat.php:267
+msgid "Please also leave your email or WhatsApp number so we can reply."
+msgstr ""
+
+#: includes/class-sellsmith-conversations.php:387
+msgid "Customer, no order number given"
+msgstr ""
+
+#: includes/class-sellsmith-conversations.php:387
+msgid "no orders under this email"
+msgstr ""
+
+#. translators: 1: number of orders ("5+" at most), 2: newest order number.
+#: includes/class-sellsmith-conversations.php:390
+#, php-format
+msgid "Customer, no order number given, %1$s orders under this email (newest #%2$d)"
+msgstr ""
+
+#. translators: %s: order number.
+#: includes/class-sellsmith-conversations.php:397
+#, php-format
+msgid "Customer, order #%s checked"
+msgstr ""
+
+#. translators: %s: order number.
+#: includes/class-sellsmith-conversations.php:404
+#, php-format
+msgid "Customer, order #%s exists but under a different email"
+msgstr ""
+
+#. translators: %s: order number.
+#: includes/class-sellsmith-conversations.php:407
+#, php-format
+msgid "Customer, order #%s not found in this shop"
+msgstr ""
+
+#. translators: %s: order number.
+#: includes/class-sellsmith-conversations.php:410
+#, php-format
+msgid "Customer, order #%s"
+msgstr ""
+
+#: includes/class-sellsmith-gemini.php:27
+msgid "Please enter an API key first."
+msgstr ""
+
+#. translators: %s: error message
+#: includes/class-sellsmith-gemini.php:45
+#, php-format
+msgid "Could not reach Google: %s"
+msgstr ""
+
+#: includes/class-sellsmith-gemini.php:53
+msgid "Unknown error."
+msgstr ""
+
+#. translators: 1: HTTP status code, 2: API error message
+#: includes/class-sellsmith-gemini.php:57
+#, php-format
+msgid "Key rejected (HTTP %1$d): %2$s"
+msgstr ""
+
+#. translators: %d: number of models available
+#: includes/class-sellsmith-gemini.php:76
+#, php-format
+msgid "Key is valid. Connection working. %d models available to this key."
+msgstr ""
+
+#. translators: %s: model id
+#: includes/class-sellsmith-gemini.php:83
+#, php-format
+msgid "Note: the selected model \"%s\" was not in the list. It may still work, or pick another model."
+msgstr ""
+
+#: includes/class-sellsmith-install.php:19
 msgid "Sellsmith requires PHP 7.4 or newer. Please ask your host to upgrade PHP."
 msgstr ""
 
+#: includes/class-sellsmith-install.php:20
 msgid "Plugin activation error"
 msgstr ""
 
+#: includes/class-sellsmith-privacy.php:31
+#: includes/class-sellsmith-privacy.php:44
+msgid "Sellsmith chat conversations"
+msgstr ""
+
+#: includes/class-sellsmith-privacy.php:90
+msgid "Order number"
+msgstr ""
+
+#: includes/class-sellsmith-privacy.php:95
+msgid "Transcript"
+msgstr ""
+
+#: includes/class-sellsmith-privacy.php:101
+msgid "Chat conversations"
+msgstr ""
+
+#: includes/class-sellsmith-privacy.php:146
+msgid "This site uses an AI chat assistant (Sellsmith). Messages you type in the chat are sent to Google Gemini for processing in order to generate replies. Conversations, including any city or contact details you share, are stored on this site so the store can follow up on your questions, and may be deleted after a retention period the store has set."
+msgstr ""
+
+#: includes/class-sellsmith-rest.php:184
+msgid "Your session expired. Please refresh the page and try again."
+msgstr ""
+
+#: includes/class-sellsmith-rest.php:201
+#: includes/class-sellsmith-rest.php:250
+#: includes/class-sellsmith-rest.php:368
+msgid "Too many requests. Please wait a moment."
+msgstr ""
+
+#: includes/class-sellsmith-rest.php:261
+msgid "Please pick an answer."
+msgstr ""
+
+#: includes/class-sellsmith-rest.php:268
+#: includes/class-sellsmith-widget.php:109
+msgid "Please enter a valid email."
+msgstr ""
+
+#: includes/class-sellsmith-rest.php:271
+msgid "Please enter your email."
+msgstr ""
+
+#: includes/class-sellsmith-rest.php:374
+msgid "This chat is no longer available."
+msgstr ""
+
+#: includes/class-sellsmith-settings.php:46
+msgid "Store Assistant"
+msgstr ""
+
+#: includes/class-sellsmith-settings.php:47
+msgid "Salam! Ask me about any product, price, or delivery."
+msgstr ""
+
+#: includes/class-sellsmith-settings.php:48
+msgid "Need help finding something?"
+msgstr ""
+
+#: includes/class-sellsmith-settings.php:53
+msgid "Are you already a customer?"
+msgstr ""
+
+#: includes/class-sellsmith-settings.php:54
+msgid "Yes, I have an order"
+msgstr ""
+
+#: includes/class-sellsmith-settings.php:55
+msgid "No, not yet"
+msgstr ""
+
+#: includes/class-sellsmith-settings.php:95
+msgid "Gemma 4 31B: most free chats/day (~1,500), basic replies"
+msgstr ""
+
+#: includes/class-sellsmith-settings.php:96
+msgid "Gemini 3.1 Flash-Lite: recommended (~500/day, smart + free)"
+msgstr ""
+
+#: includes/class-sellsmith-settings.php:97
+msgid "Gemini 3.5 Flash: smartest replies, low free limit"
+msgstr ""
+
+#: includes/class-sellsmith-settings.php:98
+msgid "Gemini 2.5 Flash-Lite: cheapest for paid use"
+msgstr ""
+
+#: includes/class-sellsmith-settings.php:99
+msgid "Gemini 2.5 Flash: stable all-rounder"
+msgstr ""
+
+#: includes/class-sellsmith-widget.php:82
 msgid "Type a message"
 msgstr ""
 
+#: includes/class-sellsmith-widget.php:83
 msgid "Send message"
 msgstr ""
 
+#: includes/class-sellsmith-widget.php:84
 msgid "Open chat"
 msgstr ""
 
+#: includes/class-sellsmith-widget.php:85
 msgid "Close chat"
 msgstr ""
 
+#: includes/class-sellsmith-widget.php:86
+msgid "Start new chat"
+msgstr ""
+
+#: includes/class-sellsmith-widget.php:87
 msgid "Online · replies in seconds"
 msgstr ""
 
+#: includes/class-sellsmith-widget.php:88
 msgid "Chat on WhatsApp"
 msgstr ""
 
+#: includes/class-sellsmith-widget.php:89
 msgid "Continue on WhatsApp"
 msgstr ""
 
+#: includes/class-sellsmith-widget.php:90
 msgid "This chat uses AI (Google Gemini) to answer. Your messages are processed by Google."
 msgstr ""
 
+#: includes/class-sellsmith-widget.php:91
 msgid "Okay, start chat"
 msgstr ""
 
+#: includes/class-sellsmith-widget.php:92
 msgid "Could not send. Please try again."
 msgstr ""
 
+#: includes/class-sellsmith-widget.php:93
 msgid "AI agent by"
 msgstr ""
 
-msgid "Sellsmith chat conversations"
-msgstr ""
-
-msgid "Chat conversations"
-msgstr ""
-
-msgid "Transcript"
-msgstr ""
-
-msgid "This site uses an AI chat assistant (Sellsmith). Messages you type in the chat are sent to Google Gemini for processing in order to generate replies. Conversations, including any city or contact details you share, are stored on this site for up to 30 days so the store can follow up on your questions."
-msgstr ""
-
-msgid "Store Assistant"
-msgstr ""
-
-msgid "Salam! Ask me about any product, price, or delivery."
-msgstr ""
-
-msgid "Need help finding something?"
-msgstr ""
-
-msgid "Gemini Flash Lite (recommended, highest free limit)"
-msgstr ""
-
-msgid "Gemini Flash (smarter, lower free limit)"
-msgstr ""
-
-msgid "Chat is not available right now."
-msgstr ""
-
-msgid "Please refresh the page and try again."
-msgstr ""
-
-msgid "Please type a message first."
-msgstr ""
-
-msgid "You are sending messages very fast. Please wait a minute and try again."
-msgstr ""
-
-msgid "Our assistant is taking a short break. Message us directly and we will reply fast."
-msgstr ""
-
-msgid "Something went wrong. Please try again."
-msgstr ""
-
-msgid "Please enter an API key first."
-msgstr ""
-
-msgid "Could not reach Google: %s"
-msgstr ""
-
-msgid "Unknown error."
-msgstr ""
-
-msgid "Key rejected (HTTP %1$d): %2$s"
-msgstr ""
-
-msgid "Key is valid. Connection working. %d models available to this key."
-msgstr ""
-
-msgid "Note: the selected model \"%s\" was not in the list. It may still work, or pick another model."
-msgstr ""
+#: includes/class-sellsmith-widget.php:94
+msgid "Your email or WhatsApp number"
+msgstr ""
+
+#: includes/class-sellsmith-widget.php:95
+msgid "Hi! 👋 Ask your question here and we will get back to you."
+msgstr ""
+
+#: includes/class-sellsmith-widget.php:96
+msgid "Sent"
+msgstr ""
+
+#: includes/class-sellsmith-widget.php:97
+msgid "Seen"
+msgstr ""
+
+#: includes/class-sellsmith-widget.php:102
+msgid "Great! What is your order number, and the email you ordered with?"
+msgstr ""
+
+#: includes/class-sellsmith-widget.php:103
+msgid "What is your email? If we cannot reply right away, we will answer you there."
+msgstr ""
+
+#: includes/class-sellsmith-widget.php:104
+msgid "Order number (if you have it)"
+msgstr ""
+
+#: includes/class-sellsmith-widget.php:105
+msgid "Email you ordered with"
+msgstr ""
+
+#: includes/class-sellsmith-widget.php:106
+msgid "Your email"
+msgstr ""
+
+#: includes/class-sellsmith-widget.php:107
+msgid "Continue"
+msgstr ""
+
+#: includes/class-sellsmith-widget.php:108
+msgid "Skip"
+msgstr ""
+
+#: includes/class-sellsmith-widget.php:110
+msgid "Order"
+msgstr ""
+
+#: includes/class-sellsmith-widget.php:112
+msgid "Thanks! Now type your question below. If we are not here right away, we will reply to you by email."
+msgstr ""
+
+#: includes/class-sellsmith-widget.php:113
+#: includes/class-sellsmith-widget.php:114
+msgid "Thanks! Now type your question below."
+msgstr ""
+
+#: includes/class-sellsmith-widget.php:115
+msgid "Pick an answer above first"
+msgstr ""

sellsmith/trunk/readme.txt

@@ -5 +5 @@
 Tested up to: 7.0
 Requires PHP: 7.4
-Stable tag: 1.1.0
+Stable tag: 1.2.0
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -50 +50 @@
 * Chat widget with your color, position, and welcome message
 * Two modes: AI mode (answers from your products) or Message mode (no API key, just collect each visitor's question and contact as a lead)
+* Start questions: the chat can open with "Are you already a customer?". Customers give their order number and email, new visitors give their email, so you can always reply, even after they leave
 * 5-minute setup wizard with a 3-step checklist
 * Business profile built from the 9 real buyer questions, including cash on delivery and open parcel policy
@@ -138 +139 @@
 == Changelog ==
 
+= 1.2.0 =
+* New: Start questions. The chat can open with "Are you already a customer?". Customers give their order number and the email they ordered with, new visitors give their email, before they type. Turn it on in Settings, Appearance. The email can be required or optional.
+* New: With WooCommerce, the order number is checked against your orders. The result shows only in your Inbox, never to the visitor.
+* New: The Inbox search also finds emails and order numbers.
+* Fix: Saving a visitor's email no longer moves a live chat (Sellsmith Pro) out of the live inbox.
+* Fix: The privacy eraser removes every chat for an email, not only the first ten, and the export and eraser also find an email saved from the chat.
+* Fix: The privacy consent note did not show, even when it was turned on.
+* Fix: Opening a chat from its email link ("Open my chat") stopped the chat from loading.
+
 = 1.1.0 =
 * New: Message mode runs the widget with no API key. Visitors leave their question and their email or WhatsApp number, and it is saved as a lead in your inbox for you to follow up. Great for going live in seconds while you set up Gemini.

sellsmith/trunk/sellsmith.php

@@ -4 +4 @@
  * Plugin URI:        https://devtonicstudios.com/sellsmith
  * Description:       An AI sales agent for your store. Answers buyers from your real product data, captures leads, and hands hot buyers to your WhatsApp. Runs on your own free Gemini API key.
- * Version:           1.1.0
+ * Version:           1.2.0
  * Requires at least: 6.0
  * Requires PHP:      7.4
@@ -17 +17 @@
 defined( 'ABSPATH' ) || exit;
 
-define( 'SELLSMITH_VERSION', '1.1.0' );
+define( 'SELLSMITH_VERSION', '1.2.0' );
 define( 'SELLSMITH_DB_VERSION', '1' );
 define( 'SELLSMITH_FILE', __FILE__ );