Viafoura

The Viafoura Documentation Hub

Welcome to the Viafoura documentation hub. You'll find comprehensive guides and documentation to help you start working with Viafoura as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    API Reference

Conversations

👍

Note

This version of our Conversations (version 3) tool is replacing the legacy Commenting tool

Introduction

The Conversations tool gives your audience a voice and a way to engage deeply with your content, your organization, and each other. We have designed this tool to facilitate real-time discussions. Using our industry-leading moderation system,
the tool provides a civil environment for users to interact while maintaining your brand image.

Installation

Step 1: Install the Viafoura JavaScript

The Viafoura Conversations tool requires the Viafoura base JavaScript to be installed on the page where the conversations are to appear.

<!DOCTYPE html>
<html>
<body>
...
<script type="text/javascript" async src="//cdn.viafoura.net/vf-v2.js"></script>
</body>
</html>

NOTE: it should be placed in the 'body' section.

Step 2: Install the Conversations Tool

Place the following code anywhere you would like a Conversations tool to appear on the page.

<div class="viafoura">
  <vf-conversations></vf-conversations>
</div>

NOTE: it should be placed in the 'body' section.

Step 3: Define Custom Parameters

You can customize how the Conversations tool displays and renders comments within your page using the following parameters.

Name

Type(s)

Default

Notes

vf-container-id (*required)

String

The unique ID of the current commenting tool (required). Refer to our documentation on [Container IDs](doc:container-ids) and content syndication for more detail.

limit

Number

10

Defines the number of comments that are initially loaded before paginating.

Accepts: 1-100.

pagination-limit

Number

10

Defines the number of comments that are loaded when the user clicks to load more comments.

Accepts 1-100

reply-limit

Number

2

Defines the number of replies that are initially loaded for top-level comments.

Accepts: 0-100.

pagination-reply-limit

Number

10

Defines the number of replies that are loaded when the user clicks to load more replies.

Accepts: 1-100

sort

String

newest

Defines the sort order for top-level comments (not including replies).

Accepts one of:
newest
oldest
num_likes_desc
num_replies_desc

featured-tab-active-threshold

Number

3

Defines the minimum number of "featured" comments that are needed to automatically load the "Featured Comments" tab as default.

first-promo-position

Number

2

This will define where the first ad positions can be inserted. Default is between the 2nd and 3rd comments.

promo-interval

Number

7

This will determine how much space to place between ad positions. Default is that they will appear every 7 comments.

A typical CMS Example (your meta-tag interface may be different):

<meta name="vf:container_id" content="995" />

Having embedded the Viafoura code snippets above will activate the Conversations widget on the page it is intended to appear on.

Updated about a month ago


Conversations


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.