{"id":389429,"date":"2026-11-04T19:17:32","date_gmt":"2026-11-04T19:17:32","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/faraiand-sale-assistant\/"},"modified":"2026-11-04T19:17:22","modified_gmt":"2026-11-04T19:17:22","slug":"faraiand-sale-assistant","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/faraiand-sale-assistant\/","author":23588571,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.2","stable_tag":"1.0.2","tested":"7.1.4","requires":"6.4","requires_php":"8.2","requires_plugins":null,"header_name":"Faraiand Sale Assistant","header_author":"Faraiand","header_description":"Privacy-focused site analytics, heatmaps, sales funnels, and a built-in conversational search assistant. Works with or without WooCommerce.","assets_banners_color":"","last_updated":"2026-11-04 19:17:22","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/faraiand.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":54,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.2":{"tag":"1.0.2","author":"faraiand","date":"2026-11-04 19:17:22","revision":3784643}},"upgrade_notice":[],"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.2"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[232,169690,6207,944,2497],"plugin_category":[36],"plugin_contributors":[290742],"plugin_business_model":[],"class_list":["post-389429","plugin","type-plugin","status-publish","hentry","plugin_tags-analytics","plugin_tags-customer-journey","plugin_tags-heatmap","plugin_tags-search","plugin_tags-visitor-tracking","plugin_category-analytics","plugin_contributors-faraiand","plugin_committers-faraiand"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/faraiand-sale-assistant.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Faraiand Sale Assistant combines actionable visitor analytics and a locally powered search assistant inside WordPress.<\/p>\n\n<p><strong>Features:<\/strong><\/p>\n\n<ul>\n<li>Page views, consent-based sessions, click heatmaps and scroll-depth insights.<\/li>\n<li>Anonymous journeys, product views and WooCommerce funnel reporting when WooCommerce is available.<\/li>\n<li>Locally powered conversational search assistant, including product\/article\/page search, public custom content, and relevant navigation.<\/li>\n<li>Persistent conversation within the same browser tab, without requiring a separate analytics account.<\/li>\n<li>A responsive admin dashboard and basic CSV exports.<\/li>\n<li>A built-in consent banner, privacy settings, and data-retention controls.<\/li>\n<\/ul>\n\n<p>The Free plugin operates independently. Separately distributed add-ons may extend it through public WordPress hooks; no paid functionality is bundled or locked in this package.<\/p>\n\n<p>A single optional \u201cView Pro demo\u201d link is available on the plugin Settings page. Pro is a separately distributed add-on; Free does not require it and does not make network requests unless an administrator chooses to open that link.<\/p>\n\n<h4>External services<\/h4>\n\n<p>The Free plugin does not need an external analytics, AI, font, or license service. Its analytics data stays on the WordPress server and visitor tracking is gated by consent. Free makes no external calls and provides no automatic upgrade redirects.<\/p>\n\n<p>This Free plugin does not connect to AI services or transmit chat messages to third-party providers.<\/p>\n\n<h4>Privacy<\/h4>\n\n<p>The built-in analytics tracker is consent-gated by default. Before consent, it does not create a persistent visitor identifier or send analytics events. The plugin does not intentionally record form inputs, OTP codes, payment tokens, raw IP addresses or raw customer messages in analytics events. No third-party analytics pixels are loaded.<\/p>\n\n<p>Browser storage used by Free:<\/p>\n\n<ul>\n<li><code>farasaas_consent_v1<\/code> in localStorage records the visitor's yes\/no choice. It has no fixed browser expiry and remains until consent is changed or browser storage is cleared.<\/li>\n<li><code>farasaas_visitor_v1<\/code> in localStorage is a random visitor identifier created only after consent. It remains until consent is revoked or browser storage is cleared.<\/li>\n<li><code>farasaas_session_v1<\/code> in sessionStorage contains the analytics session ID, short-lived token and expiry for the current tab. The server token lasts about one hour.<\/li>\n<li><code>farasaas:p4:v1:&lt;site-path&gt;<\/code> in sessionStorage contains recent assistant context for the current tab and expires after about 45 minutes. Its <code>:nav<\/code> marker expires after about one minute.<\/li>\n<li><code>farasaas_allowed<\/code> is a SameSite=Lax session cookie reflecting analytics consent. Secure is added on HTTPS.<\/li>\n<li><code>farasaas_ref<\/code> is a signed, HttpOnly, SameSite=Lax session reference with an expiry of about one hour. Secure is added on HTTPS.<\/li>\n<\/ul>\n\n<p>Granting consent starts analytics. Denying or revoking consent stops new collection, clears queued events, the local visitor\/session values and the two cookies, and clears assistant tab history. A prior denial can be changed through the consent banner or a site's consent manager. Local opt-out does not claim to erase every historical server record; administrators manage retention and erasure separately in plugin settings and WordPress privacy tools.<\/p>\n\n<p>The chat assistant processes short search messages on the WordPress server to return local site results. Free does not send those messages to an AI provider or another external service. Review your local privacy and consent requirements before enabling analytics.<\/p>\n\n<h4>Performance<\/h4>\n\n<p>The tracker uses bounded event batches, and the assistant only loads its frontend assets when enabled and allowed on the current page. Traffic and performance are deployment-dependent; test on staging before activating for customers.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the Free plugin ZIP with Plugins &gt; Add New &gt; Upload Plugin, or install from WordPress.org after publication.<\/li>\n<li>Activate the plugin and visit the Sale Assistant menu.<\/li>\n<li>Review tracking consent and data-retention settings.<\/li>\n<li>Open Assistant and optionally enable the local chat interface.<\/li>\n<li>For WooCommerce metrics, install and activate WooCommerce; non-store page analytics and content search work without it.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"is%20woocommerce%20required%3F\"><h3>Is WooCommerce required?<\/h3><\/dt>\n<dd><p>No. Product metrics require WooCommerce; page analytics and content search can operate without it.<\/p><\/dd>\n<dt id=\"does%20the%20free%20edition%20require%20a%20paid%20account%3F\"><h3>Does the Free edition require a paid account?<\/h3><\/dt>\n<dd><p>No. Core analytics, heatmaps and the local assistant work without a license or external service.<\/p><\/dd>\n<dt id=\"does%20it%20automatically%20send%20messages%20to%20openai%3F\"><h3>Does it automatically send messages to OpenAI?<\/h3><\/dt>\n<dd><p>No. Free has no AI provider connection. It makes no AI requests.<\/p><\/dd>\n<dt id=\"will%20deactivating%20or%20uninstalling%20erase%20my%20analytics%3F\"><h3>Will deactivating or uninstalling erase my analytics?<\/h3><\/dt>\n<dd><p>No. The standard WordPress Deactivate action and uninstall both retain data. Separate, clearly confirmed controls on the plugin Settings page can erase Free analytics or all Free-owned data. Back up the database before erasing. Free never deletes add-on-owned data.<\/p><\/dd>\n<dt id=\"can%20i%20translate%20the%20interface%3F\"><h3>Can I translate the interface?<\/h3><\/dt>\n<dd><p>Yes. The interface follows the effective WordPress locale and uses standard WordPress gettext strings. A complete Persian catalog is bundled for fa_IR; other translations can be provided through the normal WordPress translation system.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Keep the standard WordPress Deactivate action and retain data on normal deactivation and uninstall.<\/li>\n<li>Limit Free cleanup to Free-owned tables, settings and capabilities while preserving separately installed add-on data.<\/li>\n<li>Add explicit Settings controls for Free analytics cleanup and complete Free-data reset with database error reporting.<\/li>\n<li>Move the user interface to standard WordPress gettext and include a complete Persian catalog.<\/li>\n<li>Improve consent revocation\/re-grant behavior and document all Free browser storage and cookies.<\/li>\n<li>Remove add-on-only event metadata and replace direct add-on class references with a neutral extension hook.<\/li>\n<li>Limit the optional Pro demo link to the plugin Settings page.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release with consent-based analytics, heatmaps, WooCommerce funnel reports, CSV exports and a local conversational search assistant.<\/li>\n<\/ul>","raw_excerpt":"Privacy-focused site analytics, heatmaps, sales funnels, and a built-in conversational search assistant. Works with or without WooCommerce.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/389429","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=389429"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/faraiand"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=389429"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=389429"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=389429"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=389429"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=389429"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=389429"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}