Spotter Widget

Spotter Widget loads the Spotter feedback script on your WordPress site and initializes it with the options you configure. Site administrators can enter a Spotter project key, enable or disable the widget, choose the button label and position, restrict loading to logged-in users, and include or exclude specific URL paths.

The plugin only loads the widget when it is enabled and a project key has been saved.

Once loaded, the widget gives visitors a floating Feedback button that opens a form rendered inside an isolated Shadow DOM, so it does not collide with theme or plugin styles.

What end users can do

• Open a feedback form from a floating button placed in the chosen corner.
• Use pin mode to point and click on the page and attach feedback to a specific element and coordinate.
• Pick a feedback type and priority (low, medium, high, critical).
• Attach an optional screenshot.
• Record and attach an optional screen video.
• Recover an unsent draft automatically if the form is closed before submitting.
• Submit feedback together with technical metadata (browser, OS, screen size, user agent, page URL, and viewport).

Plugin admin features

• Configure the Spotter project key from Settings > Spotter Widget.
• Enable or disable script loading without removing saved settings.
• Customize the widget button label.
• Choose the widget button position: bottom right, bottom left, top right, or top left.
• Load the script in the footer, which is recommended for most sites.
• Optionally load the widget on wp-admin pages, excluding the Spotter Widget settings screen.
• Restrict frontend loading to logged-in users.
• Include or exclude pages with one URL path rule per line.

Configuration

After activation, open Settings > Spotter Widget and enter your Spotter project key. The widget will not load until the plugin is enabled and a project key is saved.

The settings page includes:

• Project key: the Spotter project key used to initialize the widget.
• Enable widget: controls whether the script is injected on matching pages.
• Button label: changes the visible feedback button text.
• Button position: controls where the feedback button appears.
• Load in footer: enqueues the Spotter script in the page footer.
• Load on wp-admin pages: also loads the widget in admin screens, except the plugin settings page.
• Only for logged-in users: limits frontend loading to authenticated users.
• Include paths: limits loading to the listed paths.
• Exclude paths: prevents loading on the listed paths.

Path matching

Include and exclude rules are entered one per line. Rules match an exact path or a path prefix segment.

For example, /shop matches /shop and /shop/cart, but it does not match /workshop.

If include rules are configured, the widget loads only on matching frontend paths. Exclude rules are checked after include rules and prevent script injection on matching paths.

External service disclosure

This plugin relies on Spotter as an external service. When enabled on a matching page, the plugin loads the Spotter widget from Spotter’s hosted service at cdn.tryspotter.io.

The widget is initialized with:

• The project key saved in this plugin’s settings.
• The configured button label and position.

Feedback submitted through the widget is handled by Spotter’s hosted service, not by this WordPress plugin. You should review Spotter’s service terms and privacy policy before enabling the widget on a production site.

Service website: https://tryspotter.io/ Terms of Service: https://tryspotter.io/terms-of-service Privacy Policy: https://tryspotter.io/privacy-policy