Documentation

Everything you need to integrate and customize Gossiped

Quick Start Guide

Get Gossiped running on your website in under 5 minutes.

1

Create Your Account

Sign up for a free Gossiped account and verify your email address.

Create Account
2

Add Your Website

Register your website URL and choose the appropriate category.

Add Website
3

Copy the Code

Get your unique embed code from the integration page.

<div id="gossiped-comments"></div>
<script src="https://gossiped.com/embed.js" data-site-id="YOUR_SITE_ID"></script>
4

Paste and Go Live

Add the code to your webpage where you want comments to appear.

Basic Integration

HTML Integration

The simplest way to add Gossiped to any webpage:

<!-- Place this where you want comments -->
<div id="gossiped-comments"></div>

<!-- Load Gossiped script -->
<script src="https://gossiped.com/embed.js" 
        data-site-id="your-site-id"
        data-page-url="https://yoursite.com/page"
        data-page-title="Your Page Title">
</script>

Required Parameters

data-site-id string

Your unique site identifier from the dashboard

Optional Parameters

data-page-url string

Specific URL for this page (defaults to current URL)

data-page-title string

Title for this discussion (defaults to page title)

data-theme light | dark | auto

Color theme (defaults to auto)

Configuration

JavaScript Configuration

For more control, configure Gossiped programmatically:

window.GossipedConfig = {
    siteId: 'your-site-id',
    container: '#gossiped-comments',
    theme: 'auto',
    height: 500,
    defaultSort: 'popular',
    onReady: function() {
        console.log('Gossiped loaded');
    }
};

Theme Customization

window.GossipedTheme = {
    primaryColor: '#3b82f6',
    backgroundColor: '#ffffff',
    textColor: '#374151',
    borderRadius: '8px',
    fontFamily: 'inherit'
};

WordPress Integration

Theme Integration

Add directly to your WordPress theme files:

<?php
// Add to single.php after the content
if (is_single() || is_page()) {
    echo '<div id="gossiped-comments"></div>';
    echo '<script src="https://gossiped.com/embed.js" 
               data-site-id="your-site-id"
               data-page-url="' . get_permalink() . '"
               data-page-title="' . get_the_title() . '">
          </script>';
}
?>

Shortcode Method

function gossiped_shortcode($atts) {
    $atts = shortcode_atts(array(
        'site-id' => 'your-site-id'
    ), $atts);
    
    return "<div id='gossiped-comments'></div>
            <script src='https://gossiped.com/embed.js' 
                    data-site-id='{$atts['site-id']}'></script>";
}
add_shortcode('gossiped', 'gossiped_shortcode');

// Usage: [gossiped site-id="your-site-id"]

API Reference

REST API Endpoints

Base URL: https://gossiped.com/api/v1/

GET /comments

Retrieve comments for a specific page

Parameters:

  • page_url (required) - URL of the page
  • limit - Number of comments (default: 50)
  • sort - Sort order: newest, oldest, popular
curl -X GET "https://gossiped.com/api/v1/comments?page_url=https://yoursite.com/article" \
     -H "Authorization: Bearer YOUR_API_KEY"
POST /comments

Create a new comment

curl -X POST "https://gossiped.com/api/v1/comments" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"page_url": "...", "content": "Great article!"}'

Troubleshooting

Comments Not Loading

Problem: Gossiped appears but comments don't load

Solutions:

  • Check that your site-id is correct
  • Verify the page URL matches your registered domain
  • Check browser console for JavaScript errors
  • Ensure your site is approved in the dashboard
  • Try disabling ad blockers

HTTPS Issues

Problem: Mixed content warnings

Solutions:

  • Ensure your website uses HTTPS
  • Update embed code to use https:// URLs
  • Check Content Security Policy settings

Performance Issues

Problem: Gossiped loading slowly

Solutions:

  • Load Gossiped script asynchronously
  • Implement lazy loading for below-fold comments
  • Optimize your page caching