Using the Liveblog Plugin VIP platform specific

This document is for sites running on VIP.

Learn more

Overview #

↑ Top ↑

Introduction #

The Liveblog Premium Add-On helps with quick and simple blogging for following fast-paced events. It allows authors to edit the post quickly, and readers to receive realtime updates.

↑ Top ↑

Activating the Liveblog Plugin #

To activate the Liveblog Premium Add-On, please get in touch!

↑ Top ↑

Creating a Liveblog #

The liveblog lives inside of a regular WordPress post. First create a new post, complete with title, category, and maybe a short introduction. Once the liveblog plugin is installed, you will see a liveblog box on your “Edit Post” page. Simply click “Enable” to activate it, and publish the post.

If you can’t find the box, be sure that it is toggled on under “Screen Options” in the top right corner of posting page.

Screen Shot 2013-01-18 at 12.19.13 PM

↑ Top ↑

Posting to the Liveblog #

To post to the liveblog, navigate to the live post, and start typing. Click “Publish Update,” and your readers will see the post appear at the top of their screen. That’s all there is to it.

Screen Shot 2013-01-18 at 12.21.43 PM

↑ Top ↑

Adding a Photo #

To add a photo to your update, simply drag-and-drop it into the posting box from your desktop. It will upload the image and include a link. To see the image, click “Preview.”

You can also add photos from the internet by pasting in the direct URL to the image.


↑ Top ↑

Embedding Media #

To embed tweetsYouTube videos, Vimeo videosInstagram photosHulu clips, or Spotify songs, simply paste the URL while viewing the media into the posting box on its own line. More details can be found about each media type in the links above.

Screen Shot 2013-01-18 at 12.32.59 PM

↑ Top ↑

Formatting a Post #

The liveblog posting box takes standard HTML formatting. To format text, simply wrap it in HTML tags.




<a href=””> a link </a>

Links that are pasted directly the posting box will also be automatically hyperlinked.

↑ Top ↑

Manually embed a Liveblog #

Sometimes you may need to manually insert the Liveblog into your theme. For this, we provide a function which simply outputs the Liveblog HTML on a post where the Liveblog is enabled.


↑ Top ↑

Editing Previous Posts #

While a liveblog is enabled, you can edit previous posts by clicking the “Edit” button next to the update.

Screen Shot 2013-01-18 at 11.40.43 AM

↑ Top ↑

Archiving a Liveblog #

Once the event has wrapped up, you can archive your liveblog. This means that visitors will still be able to see the blog, but the editing tools will go away and the post will stop polling for updates. You can archive and re-enable a liveblog from the Edit Post page.

Screen Shot 2013-01-18 at 11.15.12 AM

When a liveblog is archived, your editors will see a notification that says the liveblog must be enabled to accept new posts.

Screen Shot 2013-01-18 at 11.19.52 AM

↑ Top ↑

“Smart” Updates #

The liveblog uses smart updates, making it easy for your readers to enjoy your liveblog without being overwhelmed with updates. If the reader’s browser is at the top of the post, new posts will automatically appear, highlighted in yellow.

Screen Shot 2013-01-18 at 11.32.38 AM

However, if your reader has scrolled down the post to catch up on previous updates, liveblog will wait to update with new posts. Instead, a notification bar will appear at the top of the screen. When the reader clicks on the bar, the new updates will resume loading at the top of the page.

Screen Shot 2013-01-18 at 11.30.51 AM

Post times are also now relative, which means it will display as “2 minutes ago,” with the time updating every minute.

↑ Top ↑

Overriding default templates #

Templates used by the plugin can be found in the /templates/ directory of the plugin.

You can edit these files in an upgrade-safe way using overrides. Copy the files you want to change into a directory named /liveblog within the root of your theme, keeping the same filename.

Eg: In order to override a single entry template copy templates/liveblog-single-entry.php to yourtheme/liveblog/liveblog-single-entry.php

The copied file will now override the Liveblog default template file.

Check out the related code on GitHub.

Custom location for Liveblog templates #

In case the /liveblog directory in the root of your theme is not what would suit your needs, you can take advantage of the `liveblog_template_path` filter and pass in a custom absolute path without trailing slash which would then be used for template look-up.

Check out the related code.

↑ Top ↑

Need more help? #

If you have further questions, please don’t hesitate to contact us.

Ready to get started?

Drop us a note.

No matter where you are in the planning process, we’re happy to help, and we’re actual humans here on the other side of the form. 👋 We’re here to discuss your challenges and plans, evaluate your existing resources or a potential partner, or even make some initial recommendations. And, of course, we’re here to help any time you’re in the market for some robust WordPress awesomeness.