Note
This version of our Conversations (version 3) tool is replacing the legacy Commenting tool
The Viafoura Conversations tool gives your audience a voice and a way to engage deeply with your content, your organization, and each other. Viafoura has designed our Conversations tool to facilitate real-time discussions that are constructive and safe. The Conversations tool works to hyper-activate your community and encourage positive interactions among your users and promote a civil environment to express thoughts using our industry-leading moderation system.
The Viafoura Conversations tool requires the Viafoura base JavaScript to be installed on the page where the conversations are to appear.
<html>
<body>
...
<script type="text/javascript" async src="//cdn.viafoura.net/vf-v2.js"></script>
</body>
</html>Place the following code anywhere you would like a Conversations tool to appear on the page.
<div class="viafoura">
<vf-conversations></vf-conversations>
</div>You can customize how the Conversations tool displays and renders comments within your page using the following parameters.
vf-container-id
String
The unique ID of the current commenting tool. Refer to our documentation on 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:newestoldestnum_likes_descnum_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
If a GPT integration is enabled, this will define where the first promo can be inserted. Default is between the 2nd and 3rd comments.
promo-interval
Number
7
If a GPT integration is enabled, this will determine how much space to place between promos. Default is that they will appear every 7 comments.
Before transitioning Viafoura Commenting to Viafoura Conversations, we recommend that you experiment with Viafoura Conversations in a development sandbox environment as described above in the installation details section. You can migrate your existing Viafoura Commenting tools to Viafoura Conversations quickly and easily in 2 steps:
All Conversations tools will require a Container ID to allow syndication across domains. During the transition period, you will need to implement the unique ID system which will be translated into a Container ID by Viafoura once you switch from Viafoura Commenting to Viafoura Conversations.
Please read the Container ID documentation in detail and work with your client support representative to ensure it is correctly implemented. Note that if you are using the data-path option on a widget you will now need to add the data-unique_id in addition which must match the unique id of the page at the data-path.
Once unique IDs are in place, contact a Viafoura client support representative to assist you in migrating your existing Viafoura comments to the new Conversations system and with any other final switch-over details.
Existing user notifications in the tray will no longer function. The Conversations system uses a different mechanism for loading comments directly, that is not compatible with existing notifications. Existing notifications in the tray will not be able to deep link to new comments, however, new notifications going forward will continue to work as expected.
In an effort to provide a clearer to customize the look and feel of Viafoura’s widgets, we have been building componential styles, and separating out layout styles and “client overridable” styles. Please review the CSS Customization section of the documentation for details and a list of available CSS Variables.
Some previous data attributes are no longer supported with Conversations:
data-has-notification-bell- The Viafoura bell will always appear in the Conversations header, CSS can be used to disabled itdata-title
Updated about a month ago