WordPress Integration

PluginWordPress 5.0+

Plugin or custom implementation for WordPress websites.

Prerequisites
WordPress 5.0 or higher
PHP 7.4 or higher
Admin access to WordPress dashboard
A Suggesto account with at least one feedback board

Installation Methods

Choose Your Installation Method

Select the method that best fits your WordPress setup and technical requirements:

Theme Integration
Quick setup via functions.php

Best for: Simple websites, single theme

Custom Plugin
Full-featured plugin development

Best for: Advanced features, multiple sites

Must-Use Plugin
Always-active implementation

Best for: Network sites, cannot be deactivated

Theme Integration

1. Add to functions.php

Add this code to your active theme's functions.php file. This method is quick but will be lost when you update your theme:

functions.php

2. Configure Board ID

Set your board ID in WordPress admin or directly in the code. You can find your Board ID in your Suggesto dashboard.

Custom Plugin Development

Complete Plugin Code

Create a custom plugin for better management, settings page, and advanced features:

suggesto-widget.php

Admin Settings Page

The plugin includes an admin settings page where users can configure their Board ID:

Admin Settings Functions

WordPress Hooks & Filters

Customize the widget behavior using WordPress hooks and filters:

Custom Hooks and Filters

Conditional Loading

Load the widget conditionally based on user roles, page types, or other WordPress conditions:

Conditional Widget Loading

Troubleshooting

Widget not appearing?

Check these common issues:

  • Verify the board ID is correct in WordPress admin
  • Check if wp_footer() is called in your theme
  • Ensure JavaScript is enabled in the browser
  • Look for JavaScript errors in browser console
Plugin conflicts

If the widget conflicts with other plugins:

  • Deactivate other plugins temporarily to identify conflicts
  • Check for JavaScript errors in browser console
  • Ensure the widget loads after jQuery if your theme requires it
Caching issues

Clear cache after installing the widget:

  • Clear WordPress cache (if using caching plugins)
  • Clear browser cache
  • Clear CDN cache (Cloudflare, etc.)
Multisite compatibility

For WordPress multisite networks:

  • Install as network plugin or individual site plugin
  • Use different board IDs for different sites
  • Consider using must-use plugins for network-wide deployment
Finding Your Board ID
Replace xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx with your actual Board ID from the dashboard

How to get your Board ID:

  1. Go to your Suggesto dashboard
  2. Find your feedback board
  3. Click the three dots menu (⋯) on the board card
  4. Select "Copy Board ID" from the dropdown
  5. Replace the placeholder in the code with your Board ID
Opens in new tab
WordPress Installation - Suggesto.io Documentation