DOCSEARCHbyAlgolia
Submit Docs

Speakness Help Center

website·Indexed 31 days ago

https://help.speakness.com

Documentation for Speakness, a platform for media organizations and users to engage with content. Includes guides on Medianess for creating and managing branded media outlets, embedding comment sections and toplists via JavaScript, using the Article API, and managing user accounts, privacy controls, and community reputation.

Tokens
8.4K
Snippets
13
Records
75
Agent score
50%

What's inside Speakness

  1. Overview of Speakness Toplist types and voting

    Speakness toplists showcase engaging articles and comments based on reader votes across three dimensions: Civil/Good Journalism, Useful/Good News, and Agreement.

    Available toplist types include:

    • For News Articles: Good Journalism, Good News, and Controversial News.
    • For Opinion Articles & Comments: Useful Opinions, Controversial Opinions, Useful Comments, and Controversial Comments.

  2. Overview of Speakness platform capabilities

    Speakness is a platform for content creators, media organizations, and users to engage in discussions around news and content. It provides three primary integration paths:

    1. Medianess: Tools for creating and managing a dedicated media brand.
    2. Comment Section Embedding: Ability to embed Speakness discussion tools into existing websites or media outlets.
    3. User Engagement: Tools for readers to interact via voting, commenting, and following.

  3. Overview of Medianess media platform

    Medianess is a platform by Speakness designed for content creators to build and manage their own branded media outlets. It provides tools to launch a media presence without engineering effort, allowing users to own their audience through publishing, engagement, and moderation within a single workspace. Key capabilities include:

    • Creating a media platform with custom branding and domains.
    • Publishing articles using a rich text editor.
    • Organizing content via categorization and tagging.
    • Tracking audience engagement through built-in analytics.
    • Moderating discussions on published articles.
    • Managing team roles and access.

  4. Integrate Speakness comment sections into media platforms

    Speakness allows established media organizations to embed a modern, feature-rich commenting system into existing websites or platforms, including custom CMS setups and WordPress. Key features include social login (Google, Facebook, Twitter), vote-based content ranking, and real-time discussions.

  5. Monitor media performance using the Analytics Tab

    The Analytics Tab provides high-level performance monitoring for media properties, focusing on four key areas: Overview (audience and engagement trends), Comments (sentiment analysis and volume), Articles (individual post performance), and Visitors (traffic sources, recirculation, and user behaviors).

  6. Understand user capabilities on Speakness

    Speakness allows readers and users to engage with content on Medianess platforms and other media outlets using the Speakness comment section. Registered users can perform the following actions:

    • Read and discover articles from various creators and media outlets.
    • Comment on articles and participate in discussions.
    • Vote on articles and comments to help surface high-quality content.
    • Follow specific authors, media outlets, and other users.
    • Build a personal profile and earn a reputation within the community through thoughtful contributions.
    • Receive notifications regarding relevant content and discussions.

  7. Track media performance with Medianess Analytics

    The Analytics suite allows users to monitor the following performance metrics:

    • Article performance: Track views, read time, and engagement levels.
    • Audience insights: Analyze reader demographics and loyalty.
    • Top content: Identify trending topics and breakout articles.
    • Community health: Review sentiment, comment activity, and moderation flags.

  8. Manage content using Medianess workspaces

    Medianess provides four primary workspaces for content organization and lifecycle management:

    • Articles: Used to create, edit, schedule, or unpublish posts.
    • Drafts: Used to save work in progress and collaborate before publishing.
    • Categories: Used to group stories by theme to improve navigation.
    • Tags: Used to add granular metadata to improve searchability and content recommendations.

  9. Manage community and moderation via the Speakness Media Dashboard

    After embedding the comment section, the media dashboard allows you to perform the following administrative tasks:

    • Monitor analytics and comment health.
    • Moderate discussions and manage reviewers.
    • Define and configure community policies.
    • Manage team permissions.
    • Customize branding and the behavior of the embed.

    Before going live, it is recommended to verify moderation policies, invite the moderation team, and align notifications with newsroom workflows.

  10. Manage user accounts via the Commenters Tab

    The Commenters Tab provides tools to manage users across all articles. Key capabilities include:

    • User overview: Review comment history, total votes, and last activity.
    • Ban user: Permanently remove a user from participation.
    • Suspend user: Temporarily pause a user's ability to comment.
    • Profile view: Inspect public profile details prior to moderation.

  12. Embed Speakness comments using JavaScript

    The JavaScript embed method is suitable for custom sites, headless CMS, or static deployments. It requires that articles be registered via the Article API before the embed will load; otherwise, an error will be displayed. The embed uses a script and a specific div with a data-url attribute to identify the unique comment thread for each article.
    <!-- Add this script tag in your article template -->
<script src="https://www.speakness.com/embed-comment-section-prod.js"></script>

<!-- Add this div where you want comments to appear, replacing ARTICLE_URL_HERE with the actual URL -->
<div id="speakness-commentsection-embed" data-url="https://yoursite.com/article-slug"></div>