WordPress.com VIP Platform
This document is for sites running on our WordPress.com VIP platform.
- Activating the Liveblog Plugin
- Creating a Liveblog
- Posting to the Liveblog
- Adding a Photo
- Embedding Media
- Formatting a Post
- Manually embed a Liveblog
- Editing Previous Posts
- Archiving a Liveblog
- “Smart” Updates
- Overriding default templates
- Need more help?
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.
Activating the Liveblog Plugin #
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.
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.
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.
Embedding Media #
To embed tweets, YouTube videos, Vimeo videos, Instagram photos, Hulu 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.
Formatting a Post #
The liveblog posting box takes standard HTML formatting. To format text, simply wrap it in HTML tags.
Links that are pasted directly the posting box will also be automatically hyperlinked.
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.
Editing Previous Posts #
While a liveblog is enabled, you can edit previous posts by clicking the “Edit” button next to the update.
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.
When a liveblog is archived, your editors will see a notification that says the liveblog must be enabled to accept new posts.
“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.
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.
Post times are also now relative, which means it will display as “2 minutes ago,” with the time updating every minute.
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.
Need more help? #
If you have further questions, please don’t hesitate to contact us.