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

Live Blog

1. Introduction to Live Blogs

Viafoura’s Live Blogging tool allows you to quickly and easily publish and curate content in real-time on your site. By combining original content, existing content from your own sites, and content from social media pertaining to an event or unfolding story, you can provide a deep and highly engaging experience for your audience.

Features of Viafoura’s live blogging tool

  • Updates in real time for everyone watching the blog
  • Rich text formatting
  • Embed previews of links to social media and other sources
  • Automatically pull in content from social media based on rules you define
  • Pre-moderate automatic social media content
  • Pin posts to the top of the live blog
  • Allow any number of staff members to contribute to a live blog in real time from any device or location
  • Use your existing account on your own site, no need to remember yet another username and password.
  • Put a new live blog up very quickly to easily start covering breaking news events before your competition.

2. How to create a new live blog

The Viafoura Live Blogging tool allows you to place a live blog into your existing CMS using your existing article templates. The steps provided here assume a typical publishing CMS workflow, and may be different depending on our CMS configuration and publishing workflows.

  1. In your CMS create a new article as you would normally. Give it a title, image, introductory text and any other content you want to appear on your live blogging page. Or create a new live blog if they have been pre-configured in your CMS
  2. If you used a standard story article template in your CMS or are adding a live blog to an existing article, paste the following tag in the body of the article, where you want the top of the live blog to appear:
<vf-livestory class="viafoura" ></vf-livestory>

Note:

​Each live blog needs a unique ID. Depending on your integration, this ID should be automatically assigned by your publishing system (Viafoura can assist with setting this up). If your publishing system is not configured to assign a unique ID to your live blog, you will need to use this code and manually include a unique identifier, this can be any set of letters and numbers that have not been used on your site before for a live blog. The ID can be any unique string, so using the ID of the article, or Including the date and name of the live blog can help ensure that it is unique:

<vf-livestory class="viafoura" vf-container-id="ENTER A UNIQUE ID HERE"></vf-livestory>

  1. Save your article in draft mode or any mode that allows you to access the page on the front end of your site.
  2. Go to the page that your live blog has been published to and log in using your admin or moderator level site credentials.

​You must have either administrator or moderator level permissions on your site in order to be able to set up or post content to a live blog.

  1. You should see something like the following on your article page:

If you do not see the live blog settings and post entry field on the page, verify that you are logged in with an account that has admin or moderator level access.

  1. You are now able to manage the settings for your blog and start posting content using the steps in the next section of this guide.
  2. Once the settings and content are to your liking, you can publish your article to live from your CMS.

3. Define your Blog settings

1. Live Blog Display Name:​ By default, your live blog will be automatically given a name based on the page title and the current date, however you can change this to whatever you want. This name is not displayed to users and is used to identify live blogs within your admin system and reporting tools only.

2. Premoderate social feed:​ If you are using the automated social feed feature of the live blog, this setting will ensure that all content that is loaded from social media automatically is loaded into a disabled state by default. This allows you to manually preview the posts and enable only the ones you want visible to the audience. Note that switching pre-moderation on or off does not change the moderation state of content that has already been ingested into the live blog, it only effects any new content that comes in.

3. Social ingestion rules: ​Here you can define rules that will automatically pull posts from social media into your live blog based on the rules you define.
a. Enter either a Twitter handle (@username) or a combination of a Twitter handle and a hashtag (@username #hashtag) separated with a space.
Example 1: @twitter
Example 2: @twitter #worldcup
b. If there are no errors in your rule, you can click the ‘+’ symbol or hit “return” on your keyboard to add the rule to your list. Only add one handle or handle +hashtag combination per rule. You can enter up to 20 rules per live blog at this time.
c. To remove a rule you have already defined click the red ‘X’ beside the rule you want to remove.

4. Live blog start time:​ Choose the date and time that you intend your live blog to start being active. Automatic social ingestion will start pulling content from social media as of this date and time. The date and time does not impact the visibility of the blog and you can still publish to the blog and manually post content before this date and time. Clicking “Start now” will set the start time to the current date and time.

5. Live blog end time:​ Choose the date and time that you intend your live blog to stop being active. The automatic social ingestion will stop pulling content from social media when this date and time is reached. The end date and time does not change the visibility of the blog and you can continue to post content manually to the live blog. Clicking “End now” will set the end time to the current date and time and halt social ingestion.

4. How to write and publish a post

  1. Click on “Type your post” to being creating your first blog post:
  1. Once you have entered text you can highlight it and apply styles including:
    • Link
    • Bold
    • Italics
    • Block quote
    • Header 1
    • Header 2
    • Numbered and unordered lists
    • Or clear already applied styles
  1. Upload images from your hard drive using the image upload icon. Once placed, images can be deleted by placing the cursor after the images and pressing the delete key on your keyboard.

  2. Placing a URL into the post will usually render an embed preview of the URL. This is useful for embedding social media and other sources into a live blog.

If you do not want the embed to be displayed in your blog post, you can remove it by placing the cursor after the embed and clicking “delete” on your keyboard.

If you want to show ​only​ the embed and not the URL that generated it, you can simply highlight and delete the URL from the post and the embed will remain in place.

  1. Once your post is ready, you can click the “Post” button to publish it in real time to the live blog.

  2. To pin a post to the top of the blog click the “•••” icon on the right side of the post and chose “Pin post”. This will keep that post at the top of the blog for all users as new content comes in. You can unpin the same way, and the post will return to it’s original position in the blog. Note: although you can pin as many posts as you want, we highly recommend limiting the number of pinned posts to one or two in order to not impact the user experience of the live blog.

  3. If you want to remove or edit a post after it has been published simply click the “•••”icon on the right side of the post and choose one of the following options:
    a. Edit​ - allows you to edit the blog post
    b. Remove Post​ - Deletes the post entirely and removes it from the live blog for all users currently on the live blog
    c. Disable Post​ - Hides the blog post from readers but keeps the post visible to users with moderator or admin level access

Live Blog


Suggested Edits are limited on API Reference Pages

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