WordPress Installation

Add Simple Commenter to your WordPress website. Choose the method that works best for your setup.

Method 1: Simple Commenter Plugin (Recommended)

The official plugin handles everything automatically — no code needed. It also gives you full comment management directly inside WordPress admin.

Installation

1. Search "Simple Commenter" in your WordPress plugin directory, or download from WordPress.org. Click Install, then Activate.
2. Go to the Commenter menu in your WordPress admin and connect your account. Sign in with Google or enter your email for a verification code.

3. Choose an existing project or create a new one. The widget automatically appears on your site.

Comment Management

Once connected, you can manage all feedback directly from WordPress admin:

• View, filter, and search comments
• Update status (To Do, In Progress, Done) without leaving WordPress
• Set priority levels (Low, Normal, High)
• Reply to comments with file attachments
• Track unread comments with badge notifications in your admin menu

Automatic User Sync

The plugin automatically syncs your WordPress users:

• Team members (admins, editors) sync as collaborators
• Clients with WordPress accounts sync as commenters
• Role mapping is automatic — no manual setup
• Daily sync keeps everything up to date

Role-Based Widget Visibility

Control who sees the feedback widget:

• Everyone (including guests)
• Logged-in users only
• Specific WordPress roles (Administrators, Editors, Authors, etc.)
• Conditional loading via ?simple-commenter=true URL parameter for testing

This is useful for keeping the widget visible on staging but hidden from public visitors on production.

Method 2: Code Snippet Plugins

If you prefer to embed the script manually using a code snippet plugin, this keeps your code safe when updating themes.

Using WPCode (Free)

1. Install and activate the WPCode plugin (or "Insert Headers and Footers")
2. Go to Code Snippets > Header & Footer
3. Paste this in the Footer section:

<script src="https://simplecommenter.com/js/comments.min.js?id=sc_your_public_key" defer></script>

4. Click Save Changes

Using Insert Headers and Footers

1. Install Insert Headers and Footers by WPBeginner
2. Go to Settings > Insert Headers and Footers
3. Paste the script in the Scripts in Footer box
4. Save

Method 3: Theme Editor

1. Go to Appearance > Theme File Editor
2. Select your active theme
3. Open footer.php (or your theme's footer template)
4. Add this code before </body>:

<script
  src="https://simplecommenter.com/js/comments.min.js"
  data-domain="<?php echo esc_attr($_SERVER['HTTP_HOST']); ?>"
  defer
></script>

5. Click Update File

Method 4: Child Theme

The safest method for theme modifications.

Add this to your child theme's functions.php:

function add_simplecommenter_widget() {
    ?>
    <script
        src="https://simplecommenter.com/js/comments.min.js"
        data-domain="<?php echo esc_attr($_SERVER['HTTP_HOST']); ?>"
        defer
    ></script>
    <?php
}
add_action('wp_footer', 'add_simplecommenter_widget');

Method 5: Elementor

If using Elementor Pro:

1. Go to Elementor > Custom Code
2. Click Add New
3. Set location to Body - End
4. Paste the script code
5. Set display conditions and publish

Verifying Installation

1. Clear any caching plugins (WP Super Cache, W3 Total Cache, etc.)
2. Visit your site in an incognito/private window
3. Look for the feedback widget button
4. Check browser console (F12) for any errors

Troubleshooting

Widget not appearing

• Clear your WordPress cache
• Clear any CDN cache (Cloudflare, etc.)
• Check that the script wasn't removed by a security plugin
• Verify the embed identifier matches your dashboard project (sc_... preferred)

Conflicts with other plugins

• Try disabling other JavaScript optimization plugins temporarily
• Check if a security plugin is blocking external scripts
• Ensure no duplicate scripts are loaded

WooCommerce sites

The widget works on WooCommerce pages. If you only want it on certain pages:

function add_simplecommenter_widget() {
    // Only load on non-cart/checkout pages
    if (is_cart() || is_checkout()) return;
    ?>
    <script
        src="https://simplecommenter.com/js/comments.min.js"
        data-domain="<?php echo esc_attr($_SERVER['HTTP_HOST']); ?>"
        defer
    ></script>
    <?php
}
add_action('wp_footer', 'add_simplecommenter_widget');

Need help? Contact support.