<?php
/**
 * Help center: searchable articles, a setup guide and diagnostics.
 *
 * @package convohub
 */

defined( 'ABSPATH' ) || exit;

/**
 * Holds the help articles (filterable, so add-ons can contribute their own) and prints the Help tab.
 */
class ConvoHub_Help {

	/**
	 * Topics the articles are grouped under. Add-ons can add more with the `convohub_help_categories` filter.
	 *
	 * @return array[] Id => array( label, description ).
	 */
	public static function categories() {
		$categories = array(
			'getting-started' => array(
				'label'       => __( 'Getting started', 'convohub' ),
				'description' => __( 'What the plugin does and the first steps.', 'convohub' ),
			),
			'connection'      => array(
				'label'       => __( 'Connection', 'convohub' ),
				'description' => __( 'Connection key, account and disconnecting.', 'convohub' ),
			),
			'widget'          => array(
				'label'       => __( 'Chat widget', 'convohub' ),
				'description' => __( 'Inbox, allowed domains, pages and looks.', 'convohub' ),
			),
			'identity'        => array(
				'label'       => __( 'Identity validation', 'convohub' ),
				'description' => __( 'Recognizing logged-in customers.', 'convohub' ),
			),
			'leads'           => array(
				'label'       => __( 'Lead forms', 'convohub' ),
				'description' => __( 'Fields, styling and retries.', 'convohub' ),
			),
			'webhooks'        => array(
				'label'       => __( 'Webhooks and replies', 'convohub' ),
				'description' => __( 'How ConvoHub tells your site about messages.', 'convohub' ),
			),
			'privacy'         => array(
				'label'       => __( 'Privacy and data', 'convohub' ),
				'description' => __( 'What is sent, what is stored.', 'convohub' ),
			),
			'troubleshooting' => array(
				'label'       => __( 'Troubleshooting', 'convohub' ),
				'description' => __( 'Common problems and fixes.', 'convohub' ),
			),
		);

		/**
		 * Filters the help topics.
		 *
		 * @param array[] $categories Id => array( 'label' => string, 'description' => string ).
		 */
		$filtered = apply_filters( 'convohub_help_categories', $categories );
		if ( ! is_array( $filtered ) ) {
			return $categories;
		}

		$clean = array();
		foreach ( $filtered as $id => $category ) {
			$id = sanitize_key( $id );
			if ( '' === $id || ! is_array( $category ) || empty( $category['label'] ) ) {
				continue;
			}
			$clean[ $id ] = array(
				'label'       => sanitize_text_field( $category['label'] ),
				'description' => sanitize_text_field( $category['description'] ?? '' ),
			);
		}
		return $clean ? $clean : $categories;
	}

	/**
	 * The help articles, after add-ons had their say and everything was cleaned.
	 *
	 * @return array[] Each: id, category, title, keywords (text), body (limited HTML).
	 */
	public static function articles() {
		$defaults = self::default_articles();

		/**
		 * Filters the help articles. Add yours to the list.
		 *
		 * Each article is an array with: `id` (unique slug), `category` (a topic id), `title` (plain text),
		 * `keywords` (text, or a list of words, that search matches in addition to the title and body) and
		 * `body` (HTML limited to p, ul, ol, li, strong, em, code, h4, br and links; anything else is removed).
		 * Entries that are invalid, or that reuse an existing id, are dropped.
		 *
		 * @param array[] $articles Articles.
		 */
		$filtered = apply_filters( 'convohub_help_articles', $defaults );
		if ( ! is_array( $filtered ) ) {
			$filtered = $defaults;
		}

		$categories = self::categories();
		$allowed    = self::allowed_tags();
		$seen       = array();
		$articles   = array();

		foreach ( $filtered as $article ) {
			if ( ! is_array( $article ) ) {
				continue;
			}

			$id       = sanitize_key( $article['id'] ?? '' );
			$category = sanitize_key( $article['category'] ?? '' );
			$title    = sanitize_text_field( is_scalar( $article['title'] ?? null ) ? (string) $article['title'] : '' );
			$body     = trim( wp_kses( is_scalar( $article['body'] ?? null ) ? (string) $article['body'] : '', $allowed ) );
			if ( '' === $id || isset( $seen[ $id ] ) || ! isset( $categories[ $category ] ) || '' === $title || '' === trim( wp_strip_all_tags( $body ) ) ) {
				continue;
			}

			$keywords = $article['keywords'] ?? '';
			$keywords = is_array( $keywords ) ? implode( ' ', array_filter( $keywords, 'is_scalar' ) ) : ( is_scalar( $keywords ) ? (string) $keywords : '' );

			$seen[ $id ] = true;
			$articles[]  = array(
				'id'       => $id,
				'category' => $category,
				'title'    => $title,
				'keywords' => mb_substr( sanitize_text_field( $keywords ), 0, 300 ),
				'body'     => $body,
			);
		}//end foreach
		return $articles;
	}

	/**
	 * Markup that article bodies may use.
	 *
	 * @return array
	 */
	private static function allowed_tags() {
		return array(
			'p'      => array(),
			'ul'     => array(),
			'ol'     => array(),
			'li'     => array(),
			'strong' => array(),
			'em'     => array(),
			'code'   => array(),
			'h4'     => array(),
			'br'     => array(),
			'a'      => array(
				'href'   => true,
				'target' => true,
				'rel'    => true,
			),
		);
	}

	/**
	 * Address of the documentation, or an empty string when none is configured. Set it with the
	 * CONVOHUB_DOCS_URL constant or the `convohub_docs_url` filter.
	 *
	 * @return string
	 */
	public static function docs_url() {
		return self::clean_url( apply_filters( 'convohub_docs_url', defined( 'CONVOHUB_DOCS_URL' ) ? CONVOHUB_DOCS_URL : '' ) );
	}

	/**
	 * Address of the support page, or an empty string when none is configured. Set it with the
	 * CONVOHUB_SUPPORT_URL constant or the `convohub_support_url` filter.
	 *
	 * @return string
	 */
	public static function support_url() {
		return self::clean_url( apply_filters( 'convohub_support_url', defined( 'CONVOHUB_SUPPORT_URL' ) ? CONVOHUB_SUPPORT_URL : '' ) );
	}

	/**
	 * Keeps a configured web address only when it is a plain http(s) URL.
	 *
	 * @param mixed $url Value from a filter.
	 * @return string
	 */
	private static function clean_url( $url ) {
		return is_string( $url ) ? esc_url_raw( trim( $url ), array( 'http', 'https' ) ) : '';
	}

	/**
	 * Adds a short help tab to the WordPress Help drawer of the ConvoHub screen.
	 */
	public static function add_screen_help() {
		$screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;
		if ( ! $screen ) {
			return;
		}

		$content  = '<p>' . esc_html__( 'ConvoHub connects this site to your ConvoHub account: the chat widget, recognized customers, lead forms and webhooks.', 'convohub' ) . '</p>';
		$content .= '<p>' . sprintf(
			/* translators: %s: link to the Help tab, with its text. */
			esc_html__( 'Search the guides, follow the setup guide and copy diagnostics for support on the %s.', 'convohub' ),
			'<a href="' . esc_url( ConvoHub_Admin_UI::tab_url( 'help' ) ) . '">' . esc_html__( 'ConvoHub Help tab', 'convohub' ) . '</a>'
		) . '</p>';

		$screen->add_help_tab(
			array(
				'id'      => 'convohub-help',
				'title'   => __( 'ConvoHub help', 'convohub' ),
				'content' => $content,
			)
		);
	}

	/**
	 * Prints the Help tab: a search field, the setup list, the articles by topic, then diagnostics.
	 *
	 * @param array $settings Plugin settings.
	 */
	public static function render( array $settings ) {
		$categories = self::categories();
		$articles   = self::articles();
		$grouped    = array();
		foreach ( $articles as $article ) {
			$grouped[ $article['category'] ][] = $article;
		}
		$steps = ConvoHub_Setup::steps( $settings );
		$rows  = ConvoHub_Diagnostics::rows( $settings, ConvoHub_Diagnostics::environment() );
		$docs  = self::docs_url();
		$help  = self::support_url();
		?>
		<div class="cvh-panel">
			<div class="cvh-help-bar">
				<div class="cvh-input-group" role="search">
					<label class="screen-reader-text" for="cvh-help-search"><?php esc_html_e( 'Search the help articles', 'convohub' ); ?></label>
					<input type="search" class="cvh-input" id="cvh-help-search" data-cvh-help-search autocomplete="off" placeholder="<?php esc_attr_e( 'Search help', 'convohub' ); ?>" aria-describedby="cvh-help-status">
					<button type="button" class="cvh-btn" data-cvh-help-clear data-cvh-help-clear-toggle hidden><?php esc_html_e( 'Clear', 'convohub' ); ?></button>
				</div>
				<?php if ( '' !== $docs || '' !== $help ) : ?>
					<ul class="cvh-help-nav" data-cvh-hide-on-search>
						<?php if ( '' !== $docs ) : ?>
							<li><a href="<?php echo esc_url( $docs ); ?>"><?php esc_html_e( 'Documentation', 'convohub' ); ?></a></li>
						<?php endif; ?>
						<?php if ( '' !== $help ) : ?>
							<li><a href="<?php echo esc_url( $help ); ?>"><?php esc_html_e( 'Contact support', 'convohub' ); ?></a></li>
						<?php endif; ?>
					</ul>
				<?php endif; ?>
				<p class="cvh-hint cvh-help-bar__status" id="cvh-help-status" role="status" aria-live="polite" data-cvh-help-status></p>
			</div>

			<div data-cvh-hide-on-search>
				<?php
				ConvoHub_Admin_UI::section_open(
					array(
						'id'          => 'help-guide',
						'title'       => __( 'Setup', 'convohub' ),
						'description' => __( 'Each step is checked from your saved settings.', 'convohub' ),
						'wide'        => true,
					)
				);
				ConvoHub_Admin_UI::checklist( $steps );
				ConvoHub_Admin_UI::section_close();
				?>
			</div>

			<?php foreach ( $categories as $id => $category ) : ?>
				<?php
				if ( empty( $grouped[ $id ] ) ) {
					continue;
				}
				?>
				<section class="cvh-cat" id="help-cat-<?php echo esc_attr( $id ); ?>" data-cvh-cat="<?php echo esc_attr( $id ); ?>" aria-labelledby="help-cat-<?php echo esc_attr( $id ); ?>-title">
					<div class="cvh-cat__head">
						<h2 id="help-cat-<?php echo esc_attr( $id ); ?>-title"><?php echo esc_html( $category['label'] ); ?></h2>
						<p><?php echo esc_html( $category['description'] ); ?></p>
					</div>
					<div class="cvh-cat__list">
						<?php foreach ( $grouped[ $id ] as $article ) : ?>
							<details class="cvh-article" id="help-<?php echo esc_attr( $article['id'] ); ?>" data-cvh-article data-cvh-keywords="<?php echo esc_attr( $article['keywords'] ); ?>">
								<summary class="cvh-summary" data-cvh-summary>
									<span data-cvh-title><?php echo esc_html( $article['title'] ); ?></span>
									<?php ConvoHub_Admin_UI::icon( 'chevron-down' ); ?>
								</summary>
								<div class="cvh-body">
									<div data-cvh-body><?php echo wp_kses( $article['body'], self::allowed_tags() ); ?></div>
									<p class="cvh-spaced">
										<button type="button" class="cvh-btn cvh-btn--ghost cvh-btn--small" data-cvh-copy-text="<?php echo esc_attr( ConvoHub_Admin_UI::tab_url( 'help', 'help-' . $article['id'] ) ); ?>">
											<span class="cvh-code__copy-label"><?php esc_html_e( 'Copy link', 'convohub' ); ?></span>
										</button>
									</p>
								</div>
							</details>
						<?php endforeach; ?>
					</div>
				</section>
			<?php endforeach; ?>

			<div class="cvh-empty" data-cvh-help-empty hidden>
				<h3 class="cvh-empty__title"><?php esc_html_e( 'No articles match', 'convohub' ); ?></h3>
				<p class="cvh-empty__text"><?php esc_html_e( 'Try fewer or different words, or clear the search. If that does not help, send the diagnostics below to support.', 'convohub' ); ?></p>
				<button type="button" class="cvh-btn" data-cvh-help-clear><?php esc_html_e( 'Clear the search', 'convohub' ); ?></button>
			</div>

			<?php
			ConvoHub_Admin_UI::section_open(
				array(
					'id'          => 'help-diagnostics',
					'title'       => __( 'Diagnostics', 'convohub' ),
					'description' => __( 'Facts about this site for support. Tokens and secrets are never included.', 'convohub' ),
					'wide'        => true,
				)
			);
			?>
			<dl class="cvh-dl" data-cvh-diagnostics>
				<?php foreach ( $rows as $row ) : ?>
					<dt><?php echo esc_html( $row['label'] ); ?></dt>
					<dd data-cvh-diag="<?php echo esc_attr( $row['key'] ); ?>">
						<span class="cvh-status cvh-status--<?php echo esc_attr( $row['status'] ); ?>" data-cvh-diag-status><span data-cvh-diag-value><?php echo esc_html( $row['value'] ); ?></span></span>
					</dd>
				<?php endforeach; ?>
			</dl>
			<?php ConvoHub_Admin_UI::section_foot(); ?>
			<button type="button" class="cvh-btn cvh-btn--primary" data-cvh-support-copy>
				<span class="cvh-code__copy-label"><?php esc_html_e( 'Copy for support', 'convohub' ); ?></span>
			</button>
			<span class="cvh-small cvh-muted"><?php esc_html_e( 'Anything that looks like a token or secret is removed.', 'convohub' ); ?></span>
			<?php ConvoHub_Admin_UI::section_close( true ); ?>
		</div>
		<?php
	}

	/**
	 * The built-in articles.
	 *
	 * @return array[]
	 */
	private static function default_articles() {
		$article = static function ( $id, $category, $title, $keywords, $body ) {
			return array(
				'id'       => $id,
				'category' => $category,
				'title'    => $title,
				'keywords' => $keywords,
				'body'     => $body,
			);
		};

		return array(
			// Getting started.
			$article(
				'setup-overview',
				'getting-started',
				__( 'Set up ConvoHub in five steps', 'convohub' ),
				'setup start first steps begin checklist install quick',
				'<p>' . __( 'Work through the tabs from left to right. The setup list on the Connection tab checks each step from your saved settings.', 'convohub' ) . '</p>'
				. '<ol>'
				. '<li>' . __( '<strong>Connect.</strong> In ConvoHub open Settings > Integrations > WordPress and generate a key. On the Connection tab paste it and press Connect.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>Choose the chat widget inbox.</strong> On the Widget tab pick a website inbox, or create one for this site.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>Turn the widget on.</strong> Switch on "Show the chat widget on this site" and save.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>Decide on identity validation.</strong> Switch on "Recognize logged-in customers in the chat" if visitors have accounts on your site. It is optional.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>Register the webhook.</strong> On the Connection tab, so ConvoHub can tell your site about new customer messages.', 'convohub' ) . '</li>'
				. '</ol>'
				. '<p>' . __( 'To collect leads with a form, also choose an API inbox on the Leads tab and add the form to a page.', 'convohub' ) . '</p>'
			),
			$article(
				'what-it-does',
				'getting-started',
				__( 'What this plugin does', 'convohub' ),
				'overview features about widget identity leads webhook commerce woocommerce',
				'<p>' . __( 'ConvoHub for WordPress connects your site to your ConvoHub account.', 'convohub' ) . '</p>'
				. '<ul>'
				. '<li>' . __( '<strong>Chat widget.</strong> Adds the ConvoHub chat to your pages, with rules for where it shows.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>Identity validation.</strong> Tells ConvoHub who your logged-in customers are, with a signature it can trust.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>Lead forms.</strong> A form (block or shortcode) whose submissions become contacts and conversations in ConvoHub.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>Webhook.</strong> Receives signed events from ConvoHub and hands them to other code on your site.', 'convohub' ) . '</li>'
				. '</ul>'
				. '<p>' . __( 'The ConvoHub Commerce add-on builds on this plugin for WooCommerce cart recovery and order-aware support. It needs this plugin to be connected first.', 'convohub' ) . '</p>'
			),
			$article(
				'tabs-tour',
				'getting-started',
				__( 'Where to find things', 'convohub' ),
				'tabs menu navigation connection widget leads logs help where',
				'<ul>'
				. '<li>' . __( '<strong>Connection:</strong> the connection key, the account this site uses, the setup list and the webhook.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>Widget:</strong> the website inbox, which pages show the chat, identity validation and appearance.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>Leads:</strong> the destination inbox, form options, fields, appearance and how to add the form.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>Logs:</strong> undelivered leads, with Resend and Discard.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>Help:</strong> this page.', 'convohub' ) . '</li>'
				. '</ul>'
				. '<p>' . __( 'Use the arrow keys to move between the tabs when one has focus.', 'convohub' ) . '</p>'
			),
			$article(
				'requirements',
				'getting-started',
				__( 'What you need before you start', 'convohub' ),
				'requirements account api access administrator https php wordpress version prerequisites signup trial create',
				'<ul>'
				/* translators: %s: URL of the ConvoHub signup page. */
				. '<li>' . sprintf( __( 'A ConvoHub account with API access turned on. No account yet? <a href="%s" target="_blank" rel="noopener noreferrer">Create one</a>; new accounts include a 7-day trial.', 'convohub' ), esc_url( ConvoHub_Settings::signup_url() ) ) . '</li>'
				. '<li>' . __( 'A ConvoHub administrator to generate the connection key. Keys made by an administrator can also read the inbox identity secret that identity validation needs.', 'convohub' ) . '</li>'
				. '<li>' . __( 'WordPress 6.5 or newer and PHP 7.4 or newer.', 'convohub' ) . '</li>'
				. '<li>' . __( 'For the webhook: a public address that uses HTTPS. A local or staging address that ConvoHub cannot reach cannot receive events.', 'convohub' ) . '</li>'
				. '</ul>'
			),

			// Connection.
			$article(
				'connection-key',
				'connection',
				__( 'Where to find your connection key', 'convohub' ),
				'key connection key generate settings integrations wordpress administrator secret credentials paste',
				'<p>' . __( 'In ConvoHub open Settings > Integrations > WordPress and generate a key. Copy the whole key and paste it into "Connection key" on the Connection tab.', 'convohub' ) . '</p>'
				. '<ul>'
				. '<li>' . __( 'A key works once. It is exchanged for the access this site uses, and after that it is no longer needed. The plugin does not save it.', 'convohub' ) . '</li>'
				. '<li>' . __( 'Only a ConvoHub administrator can generate a key. This site then acts as that administrator, so it can do what that user can do in ConvoHub.', 'convohub' ) . '</li>'
				. '<li>' . __( 'This plugin always connects to https://app.convohub.io. There is no address to type.', 'convohub' ) . '</li>'
				. '<li>' . __( 'Treat a key like a password until you have used it. If you pasted it somewhere by mistake, use it or revoke it in ConvoHub.', 'convohub' ) . '</li>'
				. '</ul>'
			),
			$article(
				'connect-site',
				'connection',
				__( 'Connect this site', 'convohub' ),
				'connect connection key paste account save test connection signup trial create',
				/* translators: %s: URL of the ConvoHub signup page. */
				'<p>' . sprintf( __( 'No ConvoHub account yet? <a href="%s" target="_blank" rel="noopener noreferrer">Create one</a> first. New accounts include a 7-day trial.', 'convohub' ), esc_url( ConvoHub_Settings::signup_url() ) ) . '</p>'
				. '<ol>'
				. '<li>' . __( 'In ConvoHub open Settings > Integrations > WordPress and generate a key.', 'convohub' ) . '</li>'
				. '<li>' . __( 'Paste it into "Connection key" on the Connection tab.', 'convohub' ) . '</li>'
				. '<li>' . __( 'Press "Connect".', 'convohub' ) . '</li>'
				. '</ol>'
				. '<p>' . __( 'The account is the one the key was made for. There is nothing to choose and nothing else to save. "Test connection" checks later that the connection still works.', 'convohub' ) . '</p>'
				. '<p>' . __( 'To use another account, disconnect this site and connect again with a key from that account. Connecting to a different account clears the inbox, identity validation and webhook settings, because they belong to the old account. Connecting again to the same account keeps them.', 'convohub' ) . '</p>'
			),
			$article(
				'key-address',
				'connection',
				__( 'This plugin connects to app.convohub.io', 'convohub' ),
				'key address url https app.convohub.io invalid',
				'<p>' . __( 'This plugin always connects to <code>https://app.convohub.io</code>. There is no address to type, and a saved address is not used.', 'convohub' ) . '</p>'
				. '<p>' . __( 'If you see "This plugin only connects to app.convohub.io. Generate a new key there and paste it again.", the key was made for a different address. Generate a new key at https://app.convohub.io.', 'convohub' ) . '</p>'
			),
			$article(
				'replace-token',
				'connection',
				__( 'Replace an access token with a connection key', 'convohub' ),
				'token legacy replace access token upgrade older version reconnect migrate',
				'<p>' . __( 'Versions before 0.4.0 asked for an access token. A site connected that way keeps working, and the Connection tab shows a notice until you replace the token. The plugin always connects to app.convohub.io: there is no address to enter.', 'convohub' ) . '</p>'
				. '<ol>'
				. '<li>' . __( 'In ConvoHub open Settings > Integrations > WordPress and generate a key.', 'convohub' ) . '</li>'
				. '<li>' . __( 'Paste it into "Connection key" on the Connection tab and press Connect.', 'convohub' ) . '</li>'
				. '</ol>'
				. '<p>' . __( 'If the key belongs to the same account, the inbox, identity validation and webhook settings stay as they are.', 'convohub' ) . '</p>'
			),
			$article(
				'disconnect-site',
				'connection',
				__( 'What Disconnect does', 'convohub' ),
				'disconnect remove connection forget revoke leave account',
				'<p>' . __( 'Disconnect, at the bottom of the Connection tab, makes this site forget the connection: the access it was given, the account, the chosen inboxes and the webhook settings. The chat widget, lead forms and webhook stop working until you connect again.', 'convohub' ) . '</p>'
				. '<p>' . __( 'Nothing is deleted in ConvoHub and ConvoHub is not contacted. The webhook stays registered there, so press "Remove" on the webhook first if you want it gone, and remove the access in ConvoHub if you want it revoked.', 'convohub' ) . '</p>'
			),
			$article(
				'api-access',
				'connection',
				__( 'API access is not enabled for this account', 'convohub' ),
				'403 api access enabled account error forbidden permission',
				'<p>' . __( 'This message means ConvoHub accepted the connection but the account does not have API access turned on. The plugin cannot work around that.', 'convohub' ) . '</p>'
				. '<p>' . __( 'Ask the person who runs your ConvoHub account to enable API access for it, then test the connection again.', 'convohub' ) . '</p>'
			),

			// Chat widget.
			$article(
				'choose-inbox',
				'widget',
				__( 'Choose or create the website inbox', 'convohub' ),
				'inbox website create choose widget select',
				'<p>' . __( 'The chat widget belongs to a website inbox in your ConvoHub account. On the Widget tab, pick an existing one and press "Use this inbox", or press "Create an inbox for this site" to make one named after your site.', 'convohub' ) . '</p>'
				. '<p>' . __( 'The widget cannot be switched on until an inbox is chosen. Colors and the welcome text are edited on the inbox in ConvoHub, not here.', 'convohub' ) . '</p>'
			),
			$article(
				'allowed-domains',
				'widget',
				__( 'Allowed domains: why the chat may not show', 'convohub' ),
				'allowed domains blocked cors origin browser inbox domain add this site not showing',
				'<p>' . __( 'A website inbox can be limited to certain websites. If your site is not on its list, the browser refuses to load the chat and nothing appears.', 'convohub' ) . '</p>'
				. '<p>' . __( 'The Widget tab checks this for you. When your site is not allowed it shows a warning with the button "Add this site to the inbox", which adds your site\'s address to the inbox in ConvoHub.', 'convohub' ) . '</p>'
				. '<ul>'
				. '<li>' . __( 'An empty list in ConvoHub means every website is allowed.', 'convohub' ) . '</li>'
				. '<li>' . __( 'An entry can be an address such as <code>https://shop.example.com</code>, a host such as <code>shop.example.com</code>, a wildcard such as <code>*.example.com</code>, or <code>*</code> for everything.', 'convohub' ) . '</li>'
				. '<li>' . __( '<code>*.example.com</code> matches subdomains such as shop.example.com, but not example.com itself.', 'convohub' ) . '</li>'
				. '<li>' . __( 'If an entry names https or http, it must match the site\'s. A site reachable with and without www needs both addresses.', 'convohub' ) . '</li>'
				. '</ul>'
			),
			$article(
				'display-rules',
				'widget',
				__( 'Show or hide the chat on certain pages', 'convohub' ),
				'display rules pages paths show hide checkout logged in exclude include pattern wildcard',
				'<p>' . __( 'Under Display on the Widget tab, "Show on" chooses between all pages, only the pages you list, or all pages except the ones you list.', 'convohub' ) . '</p>'
				. '<ul>'
				. '<li>' . __( 'Write one path per line, for example <code>/pricing</code> or <code>/shop/*</code>. The * matches anything, and the home page is <code>/</code>.', 'convohub' ) . '</li>'
				. '<li>' . __( '"Hide for" can also hide the chat from logged-in users, or on the WooCommerce checkout page.', 'convohub' ) . '</li>'
				. '<li>' . __( 'Developers can change the decision with the <code>convohub_widget_should_display</code> filter.', 'convohub' ) . '</li>'
				. '</ul>'
			),
			$article(
				'appearance',
				'widget',
				__( 'Position, launcher and other appearance options', 'convohub' ),
				'appearance position left right launcher bubble style dark mode color scheme language file upload emoji',
				'<p>' . __( 'Each option can be left on "ConvoHub default", which uses whatever the inbox is set to in ConvoHub, or set here for this site only.', 'convohub' ) . '</p>'
				. '<p>' . __( 'You can choose the side the chat sits on, the launcher style, a label for the expanded launcher, the color scheme, and whether visitors can upload files, use the emoji picker, end the conversation, or get the chat in their browser\'s language. Brand colors and the welcome message are set on the inbox in ConvoHub.', 'convohub' ) . '</p>'
			),

			// Identity validation.
			$article(
				'identity-validation',
				'identity',
				__( 'How identity validation works', 'convohub' ),
				'identity validation verify hmac secret logged in customers recognize signature security',
				'<p>' . __( 'When a logged-in customer opens a page with the chat, your site signs the customer\'s ID on the server with the inbox identity secret and gives the chat the ID, name, email address and signature. ConvoHub checks the signature, so it can link the chat to that customer and show their conversation history on any device.', 'convohub' ) . '</p>'
				. '<ul>'
				. '<li>' . __( 'The secret never leaves your server. Visitors and their browsers only see the signature.', 'convohub' ) . '</li>'
				. '<li>' . __( 'Guests are not affected: they chat anonymously as before.', 'convohub' ) . '</li>'
				. '<li>' . __( 'The chat starts fresh when someone logs out, or when a different person logs in on the same browser.', 'convohub' ) . '</li>'
				. '<li>' . __( 'The connection key must have been made by a ConvoHub administrator, because only administrators can see the inbox identity secret. Choose the inbox again after connecting with a new key.', 'convohub' ) . '</li>'
				. '</ul>'
				. '<p>' . __( 'Switch it on with "Recognize logged-in customers in the chat" on the Widget tab.', 'convohub' ) . '</p>'
			),
			$article(
				'identity-mandatory',
				'identity',
				__( 'Why mandatory identity validation matters', 'convohub' ),
				'mandatory enforce identity validation impersonate spoof security hmac inbox settings required',
				'<p>' . __( 'Signing customers on your site is only half of the protection. The other half is telling ConvoHub to insist on it.', 'convohub' ) . '</p>'
				. '<p>' . __( 'If identity validation is not required for the inbox, a curious visitor can open their browser tools, claim another customer\'s ID or email address, and be shown that person\'s conversation history. Turning validation on for the inbox in ConvoHub makes it reject any identity not signed with your secret.', 'convohub' ) . '</p>'
				. '<ul>'
				. '<li>' . __( 'The Widget tab warns you when the plugin signs customers but the inbox does not require it.', 'convohub' ) . '</li>'
				. '<li>' . __( 'It also warns when ConvoHub requires signed identities but the switch here is off: logged-in customers would not be recognized.', 'convohub' ) . '</li>'
				. '</ul>'
			),
			$article(
				'identity-cookie',
				'identity',
				__( 'The convohub_logged_in cookie and page caching', 'convohub' ),
				'cookie cache caching logged in marker convohub_logged_in login logout browser storage',
				'<p>' . __( 'The plugin sets a small cookie named <code>convohub_logged_in</code> when someone logs in and removes it when they log out. The chat uses it to know when to ask your site who is signed in, so full-page caching cannot show one person\'s identity to another.', 'convohub' ) . '</p>'
				. '<p>' . __( 'The reply to that question is never cached. If a cache plugin or CDN caches it anyway, exclude the WordPress <code>admin-ajax.php</code> action <code>convohub_identity</code> from caching.', 'convohub' ) . '</p>'
			),

			// Lead forms.
			$article(
				'lead-form-add',
				'leads',
				__( 'Add the lead form to a page', 'convohub' ),
				'form shortcode block add page insert convohub_form heading button editor',
				'<p>' . __( 'In the block editor, add the "ConvoHub Lead Form" block. In the classic editor or any text area that supports shortcodes, paste:', 'convohub' ) . '</p>'
				. '<p><code>[convohub_form heading="Contact us" button="Send"]</code></p>'
				. '<p>' . __( 'Both attributes are optional: <code>heading</code> is the title above the form and <code>button</code> is the text on the send button. Which fields appear is chosen on the Leads tab under Form fields.', 'convohub' ) . '</p>'
			),
			$article(
				'lead-inbox',
				'leads',
				__( 'Where leads go', 'convohub' ),
				'inbox leads api create destination contact conversation',
				'<p>' . __( 'Each submission creates a contact and a conversation in an API inbox of your ConvoHub account. On the Leads tab choose an existing API inbox, or press "Create an inbox for leads".', 'convohub' ) . '</p>'
				. '<p>' . __( 'Until an inbox is chosen, submitted leads cannot be delivered and wait in the Logs tab.', 'convohub' ) . '</p>'
			),
			$article(
				'lead-fields',
				'leads',
				__( 'Choose and add form fields', 'convohub' ),
				'fields editor custom field company budget required dropdown checkbox type name label order',
				'<p>' . __( 'Under Form fields on the Leads tab you can show or hide each field, rename it, mark it required and change the order. Name, Email, Phone and Message always exist; you can hide them but not delete them.', 'convohub' ) . '</p>'
				. '<ul>'
				. '<li>' . __( 'A lead needs an email address or a phone number, so at least one of them stays on.', 'convohub' ) . '</li>'
				. '<li>' . __( 'Add your own fields (short text, long text, email, phone, number, dropdown or checkbox), up to 20 fields in total. A dropdown needs its options, separated by commas.', 'convohub' ) . '</li>'
				. '<li>' . __( 'A custom field\'s name uses lowercase letters, digits and underscores, and starts with a letter. Its value is added to the first message of the conversation and saved on the contact in ConvoHub under that name. Changing the name later starts a new attribute, so choose it once.', 'convohub' ) . '</li>'
				. '</ul>'
			),
			$article(
				'default-country-code',
				'leads',
				__( 'Default country code and phone numbers', 'convohub' ),
				'phone country code default number international e164 plus prefix 91',
				'<p>' . __( 'ConvoHub needs phone numbers in international format, which starts with + and the country code. The form converts what visitors type.', 'convohub' ) . '</p>'
				. '<p>' . __( 'Numbers typed without a + use the default country code from the Leads tab. Enter only the digits of the calling code, for example <code>91</code> for India or <code>1</code> for the United States. If it is empty, visitors must type the + and their country code themselves.', 'convohub' ) . '</p>'
			),
			$article(
				'form-appearance',
				'leads',
				__( 'Change how the form looks', 'convohub' ),
				'appearance style design colors button color corners radius spacing width css additional class form look',
				'<p>' . __( 'The Appearance section on the Leads tab sets the button colour, the corners, the space between fields and the maximum width. What you leave on "Follow the theme" keeps the look of your theme. It is only loaded on pages that show the form.', 'convohub' ) . '</p>'
				. '<p>' . __( 'For anything else, use WordPress\'s own Additional CSS: Appearance > Customize > Additional CSS, or Styles in the Site Editor. The form has these class names:', 'convohub' ) . '</p>'
				. '<ul>'
				. '<li><code>.convohub-lead-form</code>, <code>.convohub-lead-form__heading</code></li>'
				. '<li><code>.convohub-lead-form__field</code>, <code>.convohub-lead-form__field--email</code> ' . __( '(or any field name)', 'convohub' ) . '</li>'
				. '<li><code>.convohub-lead-form__required</code>, <code>.convohub-lead-form__error</code>, <code>.convohub-lead-form__success</code></li>'
				. '<li><code>.convohub-lead-form button</code></li>'
				. '</ul>'
			),
			$article(
				'retry-queue',
				'leads',
				__( 'Undelivered leads, retries and the Logs tab', 'convohub' ),
				'retry queue logs undelivered failed resend discard attempts backoff cron lost',
				'<p>' . __( 'If ConvoHub cannot be reached when a visitor sends the form, the lead is not lost. It is kept on your site and sent again automatically.', 'convohub' ) . '</p>'
				. '<ul>'
				. '<li>' . __( '<strong>Retrying:</strong> a temporary problem (ConvoHub unreachable, a server error, rate limiting or a billing limit). The plugin tries up to five times, waiting 5 minutes, 15 minutes, 1 hour and 4 hours between attempts.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>Failed:</strong> a problem that trying again cannot fix, such as a rejected token or an inbox that no longer exists, or all attempts used up.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>Resend</strong> tries again right away. <strong>Discard</strong> deletes the lead for good and asks you to press it twice.', 'convohub' ) . '</li>'
				. '</ul>'
				. '<p>' . __( 'The Logs tab only lists leads that are not delivered. Delivered leads are removed from your site, and anything left is deleted after 30 days.', 'convohub' ) . '</p>'
			),
			$article(
				'spam-protection',
				'leads',
				__( 'Spam protection and the submission limit', 'convohub' ),
				'spam honeypot rate limit too many submissions proxy cdn ip captcha bot',
				'<p>' . __( 'The form has a hidden field that people never see but simple bots fill in; those submissions are ignored. Each visitor address may send 5 submissions every 10 minutes, and each submission may be at most 32 KB.', 'convohub' ) . '</p>'
				. '<p>' . __( 'The limit uses the visitor\'s IP address. Behind a proxy or CDN every visitor can look the same, so real visitors may see "too many submissions". Developers can return the real address with the <code>convohub_client_ip</code> filter.', 'convohub' ) . '</p>'
			),

			// Webhooks and replies.
			$article(
				'webhook-overview',
				'webhooks',
				__( 'What the webhook does', 'convohub' ),
				'webhook events receiver message_incoming conversation_status_changed overview register',
				'<p>' . __( 'A webhook lets ConvoHub call your site when something happens. This plugin registers one that ConvoHub uses to report new customer messages (<code>message_incoming</code>) and changes in a conversation\'s status (<code>conversation_status_changed</code>).', 'convohub' ) . '</p>'
				. '<p>' . __( 'On its own the core plugin only checks each event and passes it on to other code on your site through the <code>convohub_webhook_event</code> action. Add-ons such as ConvoHub Commerce use it. Without an add-on, nothing visible happens on your site; your conversations still live in ConvoHub.', 'convohub' ) . '</p>'
			),
			$article(
				'webhook-signing',
				'webhooks',
				__( 'How events are signed and checked', 'convohub' ),
				'signature signing hmac sha256 timestamp replay security verify secret 401 rejected duplicate',
				'<p>' . __( 'Anyone can send a request to a public address, so every event carries a signature that only ConvoHub and your site can produce. The plugin accepts an event only when:', 'convohub' ) . '</p>'
				. '<ul>'
				. '<li>' . __( 'The signature (<code>X-Chatwoot-Signature</code>, an HMAC-SHA256 of the timestamp and the body, made with the webhook secret) matches.', 'convohub' ) . '</li>'
				. '<li>' . __( 'The timestamp is no more than five minutes old or in the future, which stops old requests from being replayed. Keep your server clock correct.', 'convohub' ) . '</li>'
				. '<li>' . __( 'It has not been seen in the last 24 hours, so each delivery is processed once.', 'convohub' ) . '</li>'
				. '</ul>'
				. '<p>' . __( 'Anything else is answered with a plain "Rejected" (HTTP 401) and no reason, so a caller cannot probe the check. The secret is created when you register the webhook and stays on your server.', 'convohub' ) . '</p>'
			),
			$article(
				'webhook-register',
				'webhooks',
				__( 'Register, update or remove the webhook', 'convohub' ),
				'register webhook update remove check connection tab receiver address public https',
				'<p>' . __( 'On the Connection tab, under Webhook, "Register webhook" creates the webhook in ConvoHub for this site and saves its secret.', 'convohub' ) . '</p>'
				. '<ul>'
				. '<li>' . __( '"Check and update" makes sure ConvoHub still has the right address and events, and fixes them if they changed, for example after a site address change.', 'convohub' ) . '</li>'
				. '<li>' . __( '"Remove" deletes the webhook from ConvoHub. Register it again at any time.', 'convohub' ) . '</li>'
				. '<li>' . __( 'ConvoHub must be able to reach the receiver address over the internet with HTTPS. Local and staging addresses behind a login or firewall cannot receive events.', 'convohub' ) . '</li>'
				. '</ul>'
			),
			$article(
				'stop-replies',
				'webhooks',
				__( 'What STOP and customer replies mean for this plugin', 'convohub' ),
				'stop opt out unsubscribe reply replies incoming message whatsapp sms keyword',
				'<p>' . __( 'The core plugin does not read or act on message text. A customer\'s reply, including a word such as STOP, is delivered to ConvoHub, shown in your inbox, and reported to your site as a <code>message_incoming</code> event.', 'convohub' ) . '</p>'
				. '<p>' . __( 'What that event means is up to the code that listens to it. Add-ons, such as ConvoHub Commerce, can decide that a STOP reply means "send this person no more messages". Check that add-on\'s own help for what it does. If nothing listens, the event is simply received and ignored.', 'convohub' ) . '</p>'
				. '<p>' . __( 'Opt-out rules for WhatsApp and SMS are also enforced by ConvoHub and the messaging provider, not by this plugin.', 'convohub' ) . '</p>'
			),

			// Privacy and data.
			$article(
				'data-sent',
				'privacy',
				__( 'What data is sent to ConvoHub', 'convohub' ),
				'data sent privacy gdpr personal information external service token email phone',
				'<ul>'
				. '<li>' . __( 'When you connect, the key you paste is sent once to https://app.convohub.io, with this site\'s address and name and the WordPress and plugin versions. ConvoHub answers with the access this site uses.', 'convohub' ) . '</li>'
				. '<li>' . __( 'When you test the connection and use the Widget, Leads or Webhook settings, that access is sent to ConvoHub to read and change your account, inboxes and webhooks.', 'convohub' ) . '</li>'
				. '<li>' . __( 'When a visitor loads a page with the chat, their browser loads the widget from https://app.convohub.io and exchanges chat data with it. With identity validation on, a logged-in customer\'s ID, name, email address and a signature are given to the chat.', 'convohub' ) . '</li>'
				. '<li>' . __( 'When a visitor sends the lead form, your server sends the name, email, phone, message, custom fields, the page address and title, and campaign (UTM) details to ConvoHub.', 'convohub' ) . '</li>'
				. '<li>' . __( 'When the webhook is registered, ConvoHub sends event data, such as new messages, to your site.', 'convohub' ) . '</li>'
				. '<li>' . __( 'The Connection tab links to ConvoHub\'s signup page. Opening that link sends nothing from this site. Account details are entered on ConvoHub.', 'convohub' ) . '</li>'
				. '</ul>'
			),
			$article(
				'data-stored',
				'privacy',
				__( 'What this plugin stores on your site', 'convohub' ),
				'stored database options table cookie local storage transient cron data',
				'<ul>'
				. '<li>' . __( '<strong>Settings,</strong> including the access ConvoHub gave this site and secrets, in one option named <code>convohub_settings</code>. They are never printed on any page. The connection key itself is not stored; only its first 12 characters are kept, to show which key was used.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>Undelivered leads</strong> in a table, only until they are delivered or 30 days pass.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>Short-lived data</strong> such as submission limits, webhook de-duplication and the count of connection attempts.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>Scheduled jobs</strong> in WP-Cron for retries and cleanup.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>In the browser:</strong> the <code>convohub_logged_in</code> cookie, and local and session storage entries that let the chat notice a change of user and remember campaign details.', 'convohub' ) . '</li>'
				. '</ul>'
			),
			$article(
				'privacy-tools',
				'privacy',
				__( 'Privacy policy text, data export and erasure', 'convohub' ),
				'privacy policy export erase personal data request gdpr tools delete',
				'<p>' . __( 'The plugin adds suggested text to Settings, Privacy, Policy Guide, which you can edit and use in your privacy policy.', 'convohub' ) . '</p>'
				. '<p>' . __( 'WordPress\'s Export Personal Data and Erase Personal Data tools include leads that are still waiting to be delivered, matched by email address. Leads that already reached ConvoHub live in your ConvoHub account, so export or erase those there.', 'convohub' ) . '</p>'
			),
			$article(
				'uninstall',
				'privacy',
				__( 'What happens when you uninstall', 'convohub' ),
				'uninstall delete remove deactivate data cleanup',
				'<p>' . __( 'Deactivating the plugin keeps everything. Deleting it from the Plugins screen removes its settings (including the token and secrets), undelivered leads, scheduled jobs and temporary data from your database.', 'convohub' ) . '</p>'
				. '<ul>'
				. '<li>' . __( 'Data already sent to ConvoHub stays in your ConvoHub account.', 'convohub' ) . '</li>'
				. '<li>' . __( 'The webhook registered in ConvoHub is not removed automatically. Press "Remove" under Webhook on the Connection tab first, or delete it in ConvoHub.', 'convohub' ) . '</li>'
				. '</ul>'
			),

			// Troubleshooting.
			$article(
				'widget-not-showing',
				'troubleshooting',
				__( 'The chat widget does not appear', 'convohub' ),
				'widget not showing missing hidden chat bubble blank invisible',
				'<p>' . __( 'Check these in order:', 'convohub' ) . '</p>'
				. '<ol>'
				. '<li>' . __( 'On the Widget tab, an inbox is chosen and "Show the chat widget on this site" is on.', 'convohub' ) . '</li>'
				. '<li>' . __( 'The page is not excluded by "Show on", and you are not hiding the chat for logged-in users while testing as one.', 'convohub' ) . '</li>'
				. '<li>' . __( 'Your site is in the inbox\'s allowed domains. The Widget tab warns you if it is not.', 'convohub' ) . '</li>'
				. '<li>' . __( 'You are not previewing in the Customizer, where the chat is never loaded.', 'convohub' ) . '</li>'
				. '<li>' . __( 'A caching or optimization plugin is not delaying or blocking the script. Clear the cache and try a private window.', 'convohub' ) . '</li>'
				. '</ol>'
			),
			$article(
				'key-not-valid',
				'troubleshooting',
				__( 'This key is not valid', 'convohub' ),
				'key not valid invalid used already revoked expired connect failed paste wrong generate new',
				'<p>' . __( '"This key is not valid. It may have been used already, revoked or expired." ConvoHub gives the same answer in every one of these cases, so it cannot say which one it was.', 'convohub' ) . '</p>'
				. '<ul>'
				. '<li>' . __( 'A key works once. If you connected with it, or pressed Connect twice and the first try went through, it is used up. Look at the Connection tab before generating another.', 'convohub' ) . '</li>'
				. '<li>' . __( 'Keys expire and can be revoked in ConvoHub. Generate a new one in Settings > Integrations > WordPress.', 'convohub' ) . '</li>'
				. '<li>' . __( 'A key stops working when the administrator who made it is no longer an administrator.', 'convohub' ) . '</li>'
				. '<li>' . __( 'Copy the whole key. Part of it, or a key with extra text, is refused before anything is sent: "This does not look like a ConvoHub connection key".', 'convohub' ) . '</li>'
				. '</ul>'
				. '<p>' . __( 'Other messages: "Too many attempts" is this site limiting tries (10 every 10 minutes); "ConvoHub received too many connection attempts" comes from ConvoHub; "read-only because of its billing status" means the ConvoHub account needs its billing fixed; "did not accept this site\'s address" means the WordPress Address and Site Address in Settings > General are not a public address; "newer way of signing in" means this plugin should be updated.', 'convohub' ) . '</p>'
			),
			$article(
				'connection-errors',
				'troubleshooting',
				__( 'Connection test errors and what they mean', 'convohub' ),
				'error test connection rejected access 401 402 404 429 500 unreachable timeout billing rate limit message',
				'<ul>'
				. '<li>' . __( '<strong>"ConvoHub no longer accepts this site\'s access."</strong> The access was revoked, or the user it belongs to lost access to the account. Disconnect, then connect again with a new key.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>"Could not reach ConvoHub."</strong> The address is wrong, ConvoHub is down, or your server cannot make outgoing HTTPS requests.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>"API access is not enabled for this ConvoHub account."</strong> See the article about API access.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>"read-only billing mode or has hit a plan limit."</strong> Fix the account\'s billing in ConvoHub.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>"ConvoHub could not find that resource."</strong> The address or account no longer exists, for example a deleted inbox.', 'convohub' ) . '</li>'
				. '<li>' . __( '<strong>"ConvoHub is rate limiting requests."</strong> Wait a minute and try again.', 'convohub' ) . '</li>'
				. '</ul>'
			),
			$article(
				'webhook-not-arriving',
				'troubleshooting',
				__( 'Events from ConvoHub are not arriving', 'convohub' ),
				'webhook not working events missing not arriving firewall security plugin clock stale rest api blocked',
				'<p>' . __( 'Check these in order:', 'convohub' ) . '</p>'
				. '<ol>'
				. '<li>' . __( 'The Connection tab says the webhook is registered. If not, register it. If the receiver address looks wrong, press "Check and update".', 'convohub' ) . '</li>'
				. '<li>' . __( 'The site is reachable from the internet over HTTPS. Staging sites behind a password, an IP allow-list or a maintenance page block ConvoHub.', 'convohub' ) . '</li>'
				. '<li>' . __( 'A firewall or security plugin is not blocking POST requests to <code>/wp-json/convohub/v1/webhook</code>, and the REST API is not disabled for visitors.', 'convohub' ) . '</li>'
				. '<li>' . __( 'Your server\'s clock is right. Events whose timestamp differs by more than five minutes are rejected.', 'convohub' ) . '</li>'
				. '</ol>'
			),
			$article(
				'lead-not-delivered',
				'troubleshooting',
				__( 'A lead did not reach ConvoHub', 'convohub' ),
				'lead missing not delivered form submission error failed logs inbox access',
				'<p>' . __( 'Open the Logs tab. A lead that could not be delivered is listed with its last error.', 'convohub' ) . '</p>'
				. '<ul>'
				. '<li>' . __( 'Make sure an API inbox is chosen on the Leads tab.', 'convohub' ) . '</li>'
				. '<li>' . __( 'If the error is about access or the account, test the connection on the Connection tab.', 'convohub' ) . '</li>'
				. '<li>' . __( 'After fixing the cause, press "Resend".', 'convohub' ) . '</li>'
				. '<li>' . __( 'If the Logs tab is empty and the lead is still missing, the form may have been refused: a lead needs an email address or a phone number with a country code, or the visitor hit the submission limit.', 'convohub' ) . '</li>'
				. '</ul>'
			),
			$article(
				'cron-not-running',
				'troubleshooting',
				__( 'Retries do not happen (WP-Cron)', 'convohub' ),
				'cron wp-cron retries scheduled not running disable_wp_cron action scheduler low traffic',
				'<p>' . __( 'Automatic retries run on WP-Cron, which WordPress triggers when someone visits your site. On a very quiet site retries can be late.', 'convohub' ) . '</p>'
				. '<p>' . __( 'If your site sets <code>DISABLE_WP_CRON</code> to true, WordPress no longer triggers it by itself and a real cron job must run <code>wp-cron.php</code>, otherwise retries never happen. The Diagnostics panel shows which case you are in. Resend on the Logs tab works either way.', 'convohub' ) . '</p>'
			),
			$article(
				'identity-not-recognized',
				'troubleshooting',
				__( 'Logged-in customers are not recognized in the chat', 'convohub' ),
				'identity not recognized logged in customer anonymous history missing secret switch greyed disabled',
				'<ol>'
				. '<li>' . __( '"Recognize logged-in customers in the chat" on the Widget tab is on. If the switch is greyed out, the inbox identity secret is missing: connect with a key made by a ConvoHub administrator and choose the inbox again.', 'convohub' ) . '</li>'
				. '<li>' . __( 'You are testing as a logged-in user, not a guest or an administrator on a "hide for logged-in users" setup.', 'convohub' ) . '</li>'
				. '<li>' . __( 'ConvoHub enforces identity validation for the inbox, and the secret in your inbox settings has not been regenerated since you chose it. If it was, choose the inbox again.', 'convohub' ) . '</li>'
				. '<li>' . __( 'A cache or CDN is not caching the reply to the <code>convohub_identity</code> request.', 'convohub' ) . '</li>'
				. '</ol>'
			),
			$article(
				'too-many-submissions',
				'troubleshooting',
				__( 'Visitors see "too many submissions"', 'convohub' ),
				'too many submissions rate limit blocked proxy cdn cloudflare ip shared',
				'<p>' . __( 'The form allows 5 submissions per visitor address every 10 minutes. If your site sits behind a proxy or CDN, every visitor can share one address and hit the limit together.', 'convohub' ) . '</p>'
				. '<p>' . __( 'Ask your developer to return the real visitor address with the <code>convohub_client_ip</code> filter, using the header your proxy sets.', 'convohub' ) . '</p>'
			),
			$article(
				'contact-support',
				'troubleshooting',
				__( 'How to ask for help', 'convohub' ),
				'support contact help diagnostics copy report problem ticket',
				'<ol>'
				. '<li>' . __( 'Press "Copy for support" in the Diagnostics panel on this page. It copies facts about your site and settings, never your connection key, access token or secrets.', 'convohub' ) . '</li>'
				. '<li>' . __( 'Paste it into your message.', 'convohub' ) . '</li>'
				. '<li>' . __( 'Say what you did, what you expected and what happened instead. For a lead problem, add the "Last error" text from the Logs tab.', 'convohub' ) . '</li>'
				. '</ol>'
			),
		);
	}
}