Questions' ); return $links; } public static function menu() { add_menu_page( 'Replyvane Chat Support', 'Replyvane', self::CAP, 'replyvane', array( __CLASS__, 'page_questions' ), 'dashicons-format-chat', 58 ); add_submenu_page( 'replyvane', 'Questions', 'Questions', self::CAP, 'replyvane', array( __CLASS__, 'page_questions' ) ); add_submenu_page( 'replyvane', 'Topics', 'Topics', self::CAP, 'replyvane-topics', array( __CLASS__, 'page_topics' ) ); add_submenu_page( 'replyvane', 'Import / Export', 'Import / Export', self::CAP, 'replyvane-import', array( __CLASS__, 'page_import' ) ); add_submenu_page( 'replyvane', 'Visitor activity', 'Visitor activity', self::CAP, 'replyvane-activity', array( __CLASS__, 'page_activity' ) ); add_submenu_page( 'replyvane', 'Settings', 'Settings', self::CAP, 'replyvane-settings', array( __CLASS__, 'page_settings' ) ); } private static function url( $page, array $args = array() ) { return add_query_arg( array_merge( array( 'page' => $page ), $args ), admin_url( 'admin.php' ) ); } private static function notice( $message, $type = 'success' ) { printf( '

', esc_attr( $type ), esc_html( $message ) ); } public static function settings_assets( $hook ) { if ( false === strpos( (string) $hook, 'replyvane-settings' ) ) { return; } wp_enqueue_style( 'wp-color-picker' ); wp_enqueue_script( 'wp-color-picker' ); wp_enqueue_media(); // The real chat styles, so the preview matches the website. wp_enqueue_style( 'replyvane-chat', REPLYVANE_URL . 'assets/chat.css', array(), REPLYVANE_VERSION ); wp_enqueue_script( 'replyvane-settings', REPLYVANE_URL . 'assets/admin-settings.js', array( 'jquery', 'wp-color-picker' ), REPLYVANE_VERSION, true ); $theme = Replyvane_Appearance::theme(); wp_localize_script( 'replyvane-settings', 'replyVaneSettings', array( 'option' => Replyvane_Plugin::OPTION, 'ajaxUrl' => admin_url( 'admin-ajax.php' ), 'nonce' => wp_create_nonce( 'replyvane_ai_test' ), 'theme' => array( 'accent' => $theme['accent'] ? $theme['accent'] : Replyvane_Appearance::FALLBACK, 'font' => $theme['font'] ? $theme['font'] : 'inherit', ), 'i18n' => array( 'working' => __( 'Working…', 'replyvane-chat-support' ), 'failed' => __( 'That could not run. Please try again.', 'replyvane-chat-support' ), 'imageTitle' => __( 'Chat button image', 'replyvane-chat-support' ), 'imageButton' => __( 'Use this image', 'replyvane-chat-support' ), 'keptOut' => __( 'kept out', 'replyvane-chat-support' ), 'automatic' => __( 'automatically', 'replyvane-chat-support' ), ), ) ); } /** Reminder on the plugin's screens while the chat is hidden from visitors. */ public static function preview_notice() { $screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null; if ( ! $screen || false === strpos( (string) $screen->id, 'replyvane' ) || ! Replyvane_Plugin::admins_only() ) { return; } printf( '

Preview mode: only administrators can see the chat on the site. Make it live for everyone in Settings.

', esc_url( self::url( 'replyvane-settings' ) ) ); } private static function messages() { $map = array( 'saved' => 'Question saved.', 'deleted' => 'Question deleted.', 'topics' => 'Topics saved.', 'cleared' => 'Visitor activity cleared.', 'reset' => 'Open counts reset to zero.', ); $msg = isset( $_GET['msg'] ) ? sanitize_key( $_GET['msg'] ) : ''; // phpcs:ignore WordPress.Security.NonceVerification if ( isset( $map[ $msg ] ) ) { self::notice( $map[ $msg ] ); } } /* ================================================================== */ /* Questions */ /* ================================================================== */ public static function page_questions() { $action = isset( $_GET['action'] ) ? sanitize_key( $_GET['action'] ) : ''; // phpcs:ignore WordPress.Security.NonceVerification if ( 'edit' === $action || 'new' === $action ) { self::question_form(); return; } $cats = Replyvane_Store::categories(); $cat_names = wp_list_pluck( $cats, 'title', 'id' ); $filter = isset( $_GET['topic'] ) ? sanitize_title( wp_unslash( $_GET['topic'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification $search = isset( $_GET['s'] ) ? sanitize_text_field( wp_unslash( $_GET['s'] ) ) : ''; // phpcs:ignore WordPress.Security.NonceVerification $items = array_filter( Replyvane_Store::items(), function ( $row ) use ( $filter, $search ) { if ( $filter && $row['category'] !== $filter ) { return false; } if ( $search && false === stripos( $row['question'] . ' ' . $row['answer'] . ' ' . $row['keywords'], $search ) ) { return false; } return true; } ); ?>

Questions

Add question

These are the questions visitors can click in the chat window. Questions marked Popular show as soon as the chat opens; the rest are found by topic or by typing. To add many at once, use Import / Export.

'edit', 'id' => $row['id'] ) ); $delete = wp_nonce_url( admin_url( 'admin-post.php?action=replyvane_delete_item&id=' . (int) $row['id'] ), 'replyvane_delete_item' ); ?>

Question	Topic	Popular	Shown	Order	Opened
No questions yet. Import a JSON file or add one.
Edit \| Delete \| id: \| created from your website (editing it makes it yours)

'', 'category' => '', 'question' => isset( $_GET['question'] ) ? sanitize_text_field( wp_unslash( $_GET['question'] ) ) : '', // phpcs:ignore WordPress.Security.NonceVerification 'answer' => '', 'keywords' => '', 'links' => '[]', 'related' => '[]', 'featured' => 0, 'sort_order' => 0, 'active' => 1, ); if ( $row ) { $item = array_merge( $item, $row ); } // Keep what was typed if saving failed. $failed = get_transient( 'replyvane_form_' . get_current_user_id() ); if ( is_array( $failed ) ) { delete_transient( 'replyvane_form_' . get_current_user_id() ); self::notice( $failed['error'], 'error' ); $item = array_merge( $item, $failed['item'] ); } $links_text = ''; foreach ( Replyvane_Store::decode_list( $item['links'] ) as $link ) { $links_text .= $link['label'] . ' | ' . $link['url'] . "\n"; } $related = Replyvane_Store::decode_list( $item['related'] ); $others = array_filter( Replyvane_Store::items(), function ( $r ) use ( $id ) { return (int) $r['id'] !== (int) $id; } ); ?>

← All questions

Question

Answer

A blank line starts a new paragraph. Start a line with - for a bullet or 1. for a numbered step. **bold** for bold. Links: [Contact us]()

Topic Manage topics

Buttons under the answer

<?php echo esc_textarea( trim( $links_text ) ); ?>

One per line: Button text | link. Up to six. Links can be web addresses, mailto: or tel:.

Search words

Comma-separated words visitors might type for this question, e.g. price, cost, how much.

Topics

Topics group questions in the chat window ("Browse by topic"). A topic only appears in the chat when it has at least one question shown.

'', 'title' => '', 'order' => '' ) ) ); foreach ( $rows as $i => $cat ) : $count = '' !== $cat['id'] ? Replyvane_Store::items_in_category( $cat['id'] ) : 0; ?>

Name shown to visitors	ID	Order	Questions	Delete

0 ) { $kept[] = $title ? $title : $id; } else { continue; } } $keep[] = array( 'id' => $id, 'title' => $title, 'order' => isset( $topic['order'] ) && '' !== $topic['order'] ? (int) $topic['order'] : count( $keep ) + 1, ); } Replyvane_Store::save_categories( $keep ); if ( $kept ) { set_transient( 'replyvane_topics_kept_' . get_current_user_id(), $kept, 300 ); } wp_safe_redirect( self::url( 'replyvane-topics', array( 'msg' => 'topics' ) ) ); exit; } /* ================================================================== */ /* Import / Export */ /* ================================================================== */ public static function page_import() { $report = get_transient( 'replyvane_import_' . get_current_user_id() ); if ( $report ) { delete_transient( 'replyvane_import_' . get_current_user_id() ); } $count = count( Replyvane_Store::items() ); ?>

Import / Export

Import finished:

Problems:

Notes:

Import questions from JSON

Download

Download current questions () Download blank template

The easiest way to make changes in bulk: download the current questions, edit the file, and import it with "Add and update".

Questions from your website

To create starter questions from this website's own pages, or refresh them, go to Website knowledge.

JSON format

Field	What it is
`categories`	List of topics: `{ "id": "scans", "title": "Scans and prices", "order": 1 }`
`faqs`	List of questions, each with the fields below.
`id`	Unique id using lowercase letters, numbers and hyphens, e.g. `scan-prices`. Importing the same id again updates that question. Optional: made from the question if left out.
`category`	The id of its topic.
`question`	Required. What visitors click.
`answer`	Required. Use `\n` for a new line and `\n\n` for a new paragraph; lines starting `-` become bullets; `bold`; `[text](https://…)` for links.
`keywords`	Optional list of words visitors might type: `["price", "cost"]`
`links`	Optional buttons under the answer: `[{ "label": "Book a scan", "url": "https://…" }]`
`related`	Optional list of other question ids to suggest next.
`featured`	`true` to show it as soon as the chat opens.
`order`	Number; lower shows first.
`active`	`false` to hide it without deleting. Default `true`.

5 * MB_IN_BYTES ) { $report = array( 'added' => 0, 'updated' => 0, 'skipped' => 0, 'errors' => array( 'The file is larger than 5 MB.' ), 'warnings' => array() ); } else { $json = (string) file_get_contents( $_FILES['json_file']['tmp_name'] ); // phpcs:ignore WordPress.WP.AlternativeFunctions,WordPress.Security.ValidatedSanitizedInput } } if ( '' === $json && ! empty( $_POST['json_text'] ) ) { $json = (string) wp_unslash( $_POST['json_text'] ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Raw JSON: every field is sanitized after decoding, in Replyvane_Store::clean_item(). } if ( ! isset( $report ) ) { $report = '' === trim( $json ) ? array( 'added' => 0, 'updated' => 0, 'skipped' => 0, 'errors' => array( 'Choose a JSON file or paste JSON first.' ), 'warnings' => array() ) : Replyvane_Store::import( $json, isset( $_POST['mode'] ) && 'replace' === $_POST['mode'] ? 'replace' : 'merge' ); } set_transient( 'replyvane_import_' . get_current_user_id(), $report, 300 ); wp_safe_redirect( self::url( 'replyvane-import' ) ); exit; } public static function handle_export() { if ( ! current_user_can( self::CAP ) ) { wp_die( esc_html__( 'You are not allowed to do this.', 'replyvane-chat-support' ) ); } check_admin_referer( 'replyvane_export' ); nocache_headers(); header( 'Content-Type: application/json; charset=utf-8' ); header( 'Content-Disposition: attachment; filename=replyvane-questions-' . gmdate( 'Y-m-d' ) . '.json' ); echo wp_json_encode( Replyvane_Store::export(), JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE ); exit; } /* ================================================================== */ /* Visitor activity */ /* ================================================================== */ public static function page_activity() { global $wpdb; $log = Replyvane_Plugin::log_table(); $since = gmdate( 'Y-m-d H:i:s', time() - 30 * DAY_IN_SECONDS ); $clicks = (int) $wpdb->get_var( $wpdb->prepare( "SELECT COUNT(*) FROM %i WHERE event = 'click' AND created_at >= %s", $log, $since ) ); $searches = (int) $wpdb->get_var( $wpdb->prepare( "SELECT COUNT(*) FROM %i WHERE event = 'search' AND created_at >= %s", $log, $since ) ); $unmatched = $wpdb->get_results( $wpdb->prepare( "SELECT query, COUNT(*) AS n, MAX(created_at) AS last FROM %i WHERE event = 'search' AND matched = 0 AND created_at >= %s GROUP BY query ORDER BY n DESC, last DESC LIMIT 40", $log, $since ), ARRAY_A ); $recent = $wpdb->get_results( $wpdb->prepare( "SELECT * FROM %i ORDER BY id DESC LIMIT 100", $log ), ARRAY_A ); $top = Replyvane_Store::items(); usort( $top, function ( $a, $b ) { return (int) $b['clicks'] <=> (int) $a['clicks']; } ); $top = array_slice( array_filter( $top, function ( $r ) { return $r['clicks'] > 0; } ), 0, 15 ); $titles = wp_list_pluck( Replyvane_Store::items(), 'question', 'slug' ); ?>

Visitor activity

Recording is switched off in Settings, so new activity isn't being saved. Open counts still update.

No names, emails, IP addresses or accounts are recorded, only what was clicked or typed, when, and on which page.

Questions opened (last 30 days)
Typed searches (last 30 days)

Typed questions with no answer

What visitors asked that your list didn't cover. Click one to write an answer for it.

Typed	Times
Nothing yet.

Most opened questions

All time. Reset counts

Question	Opened
Nothing yet.

Latest activity

Download all activity as CSV

When	What	Question	Page
Nothing yet.
		“”

get_results( $wpdb->prepare( "SELECT * FROM %i ORDER BY id DESC LIMIT 1000 OFFSET %d", $table, $offset ), ARRAY_A ); foreach ( (array) $rows as $r ) { fputcsv( $out, array_map( $safe, array( get_date_from_gmt( $r['created_at'], 'Y-m-d H:i' ), $r['session_id'], $r['event'], $r['query'], $r['faq_slug'] && isset( $titles[ $r['faq_slug'] ] ) ? $titles[ $r['faq_slug'] ] : $r['faq_slug'], $r['matched'] ? 'yes' : 'no', $r['page_url'], ) ) ); } $offset += 1000; } while ( ! empty( $rows ) && 1000 === count( $rows ) ); fclose( $out ); // phpcs:ignore WordPress.WP.AlternativeFunctions exit; } public static function handle_clear_log() { if ( ! current_user_can( self::CAP ) ) { wp_die( esc_html__( 'You are not allowed to do this.', 'replyvane-chat-support' ) ); } check_admin_referer( 'replyvane_clear_log' ); global $wpdb; $wpdb->query( $wpdb->prepare( 'TRUNCATE TABLE %i', Replyvane_Plugin::log_table() ) ); wp_safe_redirect( self::url( 'replyvane-activity', array( 'msg' => 'cleared' ) ) ); exit; } public static function handle_reset_clicks() { if ( ! current_user_can( self::CAP ) ) { wp_die( esc_html__( 'You are not allowed to do this.', 'replyvane-chat-support' ) ); } check_admin_referer( 'replyvane_reset_clicks' ); global $wpdb; $wpdb->query( $wpdb->prepare( 'UPDATE %i SET clicks = 0', Replyvane_Plugin::items_table() ) ); wp_safe_redirect( self::url( 'replyvane-activity', array( 'msg' => 'reset' ) ) ); exit; } /* ================================================================== */ /* Settings */ /* ================================================================== */ public static function register_settings() { register_setting( 'replyvane', Replyvane_Plugin::OPTION, array( 'type' => 'array', 'sanitize_callback' => array( __CLASS__, 'sanitize_settings' ), ) ); } public static function sanitize_settings( $in ) { $d = Replyvane_Plugin::defaults(); $in = is_array( $in ) ? $in : array(); $text = function ( $key ) use ( $in, $d ) { $v = isset( $in[ $key ] ) ? trim( sanitize_text_field( $in[ $key ] ) ) : ''; return '' !== $v ? $v : $d[ $key ]; }; $area = function ( $key ) use ( $in, $d ) { $v = isset( $in[ $key ] ) ? trim( sanitize_textarea_field( $in[ $key ] ) ) : ''; return '' !== $v ? $v : $d[ $key ]; }; $color = sanitize_hex_color( isset( $in['color'] ) ? $in['color'] : '' ); return array( 'bot_name' => $text( 'bot_name' ), 'welcome' => $area( 'welcome' ), 'popular_title' => $text( 'popular_title' ), 'no_match' => $area( 'no_match' ), 'contact_url' => esc_url_raw( isset( $in['contact_url'] ) ? $in['contact_url'] : '' ), 'color' => $color ? $color : $d['color'], 'color_mode' => isset( $in['color_mode'] ) && 'custom' === $in['color_mode'] ? 'custom' : 'theme', 'font_mode' => isset( $in['font_mode'] ) && 'custom' === $in['font_mode'] ? 'custom' : 'theme', 'font_custom' => isset( $in['font_custom'] ) ? mb_substr( preg_replace( '/[^\w\s,"\'\-]/u', '', wp_unslash( $in['font_custom'] ) ), 0, 120 ) : '', 'question_bg' => (string) sanitize_hex_color( isset( $in['question_bg'] ) ? $in['question_bg'] : '' ), 'question_text' => (string) sanitize_hex_color( isset( $in['question_text'] ) ? $in['question_text'] : '' ), 'answer_bg' => (string) sanitize_hex_color( isset( $in['answer_bg'] ) ? $in['answer_bg'] : '' ), 'icon' => isset( $in['icon'] ) && ( 'custom' === $in['icon'] || isset( Replyvane_Appearance::icons()[ $in['icon'] ] ) ) ? $in['icon'] : 'chat', 'icon_url' => esc_url_raw( isset( $in['icon_url'] ) ? $in['icon_url'] : '' ), 'icon_fill' => empty( $in['icon_fill'] ) ? 0 : 1, 'notify_enabled' => empty( $in['notify_enabled'] ) ? 0 : 1, 'notify_sound' => empty( $in['notify_sound'] ) ? 0 : 1, 'agent_avatars' => empty( $in['agent_avatars'] ) ? 0 : 1, 'message_avatars' => empty( $in['message_avatars'] ) ? 0 : 1, 'engine' => isset( $in['engine'] ) && 'wp_ai' === $in['engine'] ? 'wp_ai' : 'builtin', 'ai_label' => empty( $in['ai_label'] ) ? 0 : 1, 'ai_model' => isset( $in['ai_model'] ) ? substr( preg_replace( '#[^a-zA-Z0-9._:/-]#', '', (string) $in['ai_model'] ), 0, 100 ) : '', 'position' => isset( $in['position'] ) && 'left' === $in['position'] ? 'left' : 'right', 'visibility' => isset( $in['visibility'] ) && 'admins' === $in['visibility'] ? 'admins' : 'everyone', 'show_search' => empty( $in['show_search'] ) ? 0 : 1, 'show_logged_in' => empty( $in['show_logged_in'] ) ? 0 : 1, 'log_enabled' => empty( $in['log_enabled'] ) ? 0 : 1, 'log_days' => absint( isset( $in['log_days'] ) ? $in['log_days'] : $d['log_days'] ), 'answer_from_site' => empty( $in['answer_from_site'] ) ? 0 : 1, 'exclude_ids' => array_values( array_unique( array_filter( array_map( 'absint', isset( $in['exclude_ids'] ) ? (array) $in['exclude_ids'] : array() ) ) ) ), 'sslverify' => empty( $in['sslverify'] ) ? 0 : 1, 'reply_from' => isset( $in['reply_from'] ) && 'agent' === $in['reply_from'] ? 'agent' : 'site', 'from_email' => is_email( isset( $in['from_email'] ) ? sanitize_email( $in['from_email'] ) : '' ) ? sanitize_email( $in['from_email'] ) : $d['from_email'], // Live chat. 'live_enabled' => empty( $in['live_enabled'] ) ? 0 : 1, 'live_label' => $text( 'live_label' ), 'team_email' => implode( ', ', array_filter( array_map( 'sanitize_email', array_map( 'trim', explode( ',', isset( $in['team_email'] ) ? (string) $in['team_email'] : '' ) ) ), 'is_email' ) ), 'email_new_chat' => empty( $in['email_new_chat'] ) ? 0 : 1, 'escalate_minutes' => min( 120, absint( isset( $in['escalate_minutes'] ) ? $in['escalate_minutes'] : $d['escalate_minutes'] ) ), 'alert_include_text' => empty( $in['alert_include_text'] ) ? 0 : 1, 'require_email' => empty( $in['require_email'] ) ? 0 : 1, 'live_consent' => isset( $in['live_consent'] ) ? trim( sanitize_textarea_field( $in['live_consent'] ) ) : $d['live_consent'], 'hours_enabled' => empty( $in['hours_enabled'] ) ? 0 : 1, 'hours_days' => array_values( array_intersect( array( 1, 2, 3, 4, 5, 6, 7 ), array_map( 'intval', isset( $in['hours_days'] ) ? (array) $in['hours_days'] : array() ) ) ), 'hours_start' => isset( $in['hours_start'] ) && preg_match( '/^([01]\d|2[0-3]):[0-5]\d$/', $in['hours_start'] ) ? $in['hours_start'] : $d['hours_start'], 'hours_end' => isset( $in['hours_end'] ) && preg_match( '/^([01]\d|2[0-3]):[0-5]\d$/', $in['hours_end'] ) ? $in['hours_end'] : $d['hours_end'], 'live_days' => absint( isset( $in['live_days'] ) ? $in['live_days'] : $d['live_days'] ), ); } public static function page_settings() { $s = Replyvane_Plugin::settings(); $o = Replyvane_Plugin::OPTION; $f = function ( $key ) use ( $o ) { return $o . '[' . $key . ']'; }; ?>

Replyvane Chat Support settings

Who can see the chat

Show the chat to

> Everyone: the chat is live for all visitors
> Administrators only: preview it on the site while logged in as an admin; visitors and members don't see it

Use "Administrators only" while you review and edit the questions, then switch to "Everyone" to go live. If you use a caching plugin, clear its cache after switching.

Logged-in members

> When live, show the chat to logged-in members too

Everyone sees the same public questions. The chat never reads account details.

Chat window

Name

Welcome message

Heading above popular questions

Typing questions

> Let visitors type a question. It is matched against your questions and search words in their browser.

When nothing matches

Contact page

Shown as a "Contact us" button after answers. Leave empty to hide it.

Position

> Bottom right > Bottom left

Look and feel

' . esc_html( $hex ) . ''; }; ?>

Main colour

> Match my theme
> Choose a colour

Used for the chat button, header and your visitors' messages. Text on it switches between white and dark automatically, so it's always readable.

Question buttons

Background

Text

Leave empty to follow the main colour (now with text).

Answer bubbles

Background

Leave empty to follow the main colour (now ).

Font

> Match my theme ' . esc_html( $theme['font'] ) . '' : 'Uses the same font as the page text.' ); ?>
> Use this font:

The font must already be loaded by your theme or a font plugin.

Chat button icon

$icon ) : ?> > >

> style="color:;font-size:11px">Image

> Fill the whole button (for photos)

Use a square PNG or SVG with a transparent background for logos, or a photo with "Fill the whole button".

Avatars

> Show small avatars next to messages: the chat button icon beside the chatbot's answers, a person icon beside the visitor's messages, and the team member's photo in live chat

Notifications

> When a reply arrives while the chat is closed, show a counter on the chat button and a short preview of the reply
> Also play a soft sound (only after the visitor has interacted with the page)

Answer engine

How typed questions are answered

> Built-in (no AI)Answers are taken word for word from your FAQ and website. Free, instant, no outside services. > WordPress AIThe AI provider you set up for your whole site (for example Anthropic, Google or OpenAI) writes a natural answer from your website's content. This plugin never stores API keys.

Choose and set up your AI provider once under Settings → Connectors. Usage is billed to your account with that provider.

WordPress AI needs WordPress 7.0 or later (or AI is switched off on this site). Until then, the built-in engine answers.

Whichever you choose, clicked FAQ questions always show your own answers, and only public website content is used. With WordPress AI, the visitor's typed question and the most relevant public passages of your site (plus matching FAQ answers) are sent to your site's AI provider. The AI is told to answer only from that content and never to invent prices, policies or links. If no answer comes back, the built-in engine answers instead, so the chat never breaks.

Model

Leave empty to choose automatically: a fast, low-cost current model from your provider is used, and retired models are skipped.

Check the connection

Label

> Show "AI answer based on our website" under answers written by AI

Answers from your website

Typed questions

> When a typed question doesn't match an FAQ, answer it from the website's pages

The answer is taken word for word from the most relevant part of your public pages, with a link to the page. No AI is used. If nothing matches well enough, visitors see the closest FAQ questions instead. Website knowledge shows what was read and lets you try questions.

Pages to keep out

$type, 'post_status' => 'publish', 'posts_per_page' => 500, 'orderby' => 'title', 'order' => 'ASC', 'fields' => 'ids', 'has_password' => false, ) ); if ( ! $ids ) { continue; } update_postmeta_cache( $ids ); $items = array(); foreach ( $ids as $pid ) { $reason = Replyvane_Knowledge::auto_reason( $pid ); if ( '' === $reason && ! in_array( (int) $pid, $picked, true ) && array_intersect( array_map( 'intval', get_post_ancestors( $pid ) ), $picked ) ) { $reason = 'Inside a kept-out page'; } if ( '' !== $reason ) { $auto++; } $items[] = array( $pid, $reason ); } $obj = get_post_type_object( $type ); $rows[ $type ] = array( $obj ? $obj->labels->name : $type, $items ); } ?>

Tick any page the chatbot must never read or quote. Ticked pages are removed from the chatbot's knowledge as soon as you save, and their sub-pages are kept out too.

Pages that are already hidden automatically are shown ticked and locked, with the reason next to them. You don't need to do anything for those.

Show ticked only

()

%s %s /%s', esc_html( $title ), esc_html( $reason ), esc_html( $uri ) ); } else { printf( ' %s /%s', esc_attr( $f( 'exclude_ids' ) ), (int) $pid, checked( in_array( (int) $pid, $picked, true ), true, false ), esc_html( $title ), esc_html( $uri ) ); } } ?>

What is kept out automatically, and why

The chatbot reads your site exactly as a logged-out visitor sees it. These are never read, and appear above as locked:

Login or account page: pages at addresses such as /login/, /my-account/, /account/, /dashboard/, /register/ and /lost-password/.
WooCommerce cart, checkout and account pages, and products hidden from the shop.
Hidden from search engines: pages marked noindex in Yoast SEO or Rank Math.
Members only: pages restricted by WooCommerce Memberships, Paid Memberships Pro, MemberPress or Restrict Content Pro.
Needs a login to view: pages that sent a logged-out visitor to a login page, or gave an error, when the site was last read.
Inside a kept-out page: sub-pages of a page you ticked.

These are also never read and aren't listed: private, draft, scheduled and password-protected content; your site's header, footer, menus, forms and pop-ups; and anything about users, orders, bookings or form entries.

Tick other public pages you don't want quoted, such as internal notes, staff pages, ad landing pages, or pages with outdated prices.

After saving, ticked pages are removed from the chatbot straight away, and the site is re-read in the background. You can follow it under Website knowledge, which also lists every page the chatbot can use.

Secure reading

> Verify the site's SSL certificate when reading pages

Turn off only on a staging site with a self-signed certificate.

Live chat with your team

Live chat

> Turn on live chat

Adds a "" button to the chat window and a Live Chat inbox to the dashboard. When a team member is online, visitors chat with them directly; otherwise visitors leave a message that is emailed to your team. Turning this off hides the button and the inbox, and keeps past chats.

Open the Live Chat inbox

Who answers chats

Administrators can always answer chats. For other staff, add them under Users → Add New with the role Live Chat Agent. That role can answer chats but can't change the website.

Team member photos

> Show the team member's profile picture next to their messages

Uses the picture from the team member's WordPress profile (Gravatar, or a profile-picture plugin). Without one, a person icon is shown.

Button text

Team email

Where alerts and offline messages go. Separate several addresses with commas.

Email alerts

> Email the team when a new chat starts
If nobody takes a chat within minutes, email the team a reminder (0 = never)

Messages left while nobody is online are always emailed. For reliable delivery, use an email-sending plugin such as WP Mail SMTP.

Privacy

> Include what the visitor wrote in emails and desktop pop-ups

Off by default: alerts then say only who is waiting, and the message stays inside the dashboard. Visitors may describe health concerns, so leave this off unless your team needs it.

> Ask visitors for their email address (required)

Recommended, so your team can reply if the visitor leaves.

Note under the chat form

Tells visitors what you store. Mention live chat in your privacy policy too.

Business hours

> Only offer live chat during these hours

'Mon', 2 => 'Tue', 3 => 'Wed', 4 => 'Thu', 5 => 'Fri', 6 => 'Sat', 7 => 'Sun' ); foreach ( $names as $num => $label ) { printf( ' %s', esc_attr( $f( 'hours_days' ) ), (int) $num, checked( in_array( $num, array_map( 'intval', (array) $s['hours_days'] ), true ), true, false ), esc_html( $label ) ); } ?>

From to

Uses the site's time zone (), set under Settings → General. Outside these hours, or when nobody is online, visitors see "Leave us a message".

Email replies

When a team member answers a message with Send mail, the email is sent from:

> The website's address (recommended). The visitor's reply goes to the team member who wrote.
> The team member's own email address

Website address:

Email sent "from" a Gmail or Outlook address by your website is often marked as spam, so the website's address is safer. Use an address on your own domain, with an email-sending plugin such as WP Mail SMTP.

Keep chats for

days after they finish (0 keeps them forever)

Visitor activity

Record activity

> Save which questions are clicked and what visitors type

No name, email, IP address or account is saved. Visitors may still type personal details into the search box, so mention the chat in your privacy policy.

Keep activity for

days (0 keeps it forever)