Table of Contents

  1. Video Tutorials
  2. Installation (Single Site)
  3. Installation (Multisite)
  4. Create a news ticker with manually added news
  5. Create a news ticker with news from the posts
  6. Create a news ticker with news from an RSS feed
  7. Create a news ticker with news from Twitter
  8. Performance
  9. Credits
  10. FAQ

1) Video Tutorials

This video series covers the functionalities of the Live News plugin.

Please note that not all the aspects and implications are covered in this section. It’s recommended that you read the entire documentation before using this plugin in a production environment or asking for support from the plugin author.

2) Installation (Single Site)

With this procedure, you will be able to install the Live News plugin on your WordPress website.

  1. Visit the Plugins -> Add New menu
  2. Click on the Upload Plugin button and select the zip file you just downloaded
  3. Click on Install Now
  4. Click on Activate Plugin

3) Installation (Multisite)

This plugin supports both a Network Activation (the plugin will be activated on all the sites of your WordPress Network) and a Single Site Activation in a WordPress Network environment (your plugin will be activated on a single site of the network).

With this procedure, you will be able to perform a Network Activation:

  1. Visit the Plugins -> Add New menu
  2. Click on the Upload Plugin button and select the zip file you just downloaded
  3. Click on Install Now
  4. Click on Network Activate

With this procedure, you will be able to perform a Single Site Activation in a WordPress Network environment:

  1. Visit the specific site of the WordPress Network where you want to install the plugin
  2. Visit the Plugins menu
  3. Click on the Activate button (just below the name of the plugin)

4) Create a news ticker with manually added news

This procedure will guide you on the creation of a news ticker that makes use of your manually added news:

  1. Visit the Live News -> News Tickers menu
  2. Enter the name of the news ticker in the Name input field
  3. Select where the news ticker should be applied with the Target select box
  4. Enter the URL where the news ticker should be applied in the Target URL input field (this value will be considered only if “URL” is selected in the Target select box)
  5. Open the Source section and select “Manually Added” in the Source select box
  6. Click the Add News Ticker button to create the news ticker

5) Create a news ticker with news from the posts

This procedure will guide you on the creation of a news ticker that makes use of the titles, excerpts, and permalinks of your posts:

  1. Visit the Live News -> News Tickers menu
  2. Enter the name of the news ticker in the Name input field
  3. Select where the news ticker should be applied with the Target select box
  4. Enter the URL where the news ticker should be applied in the Target URL input field (this value will be considered only if “URL” is selected in the Target select box)
  5. Open the Source section and select “Posts” in the Source select box
  6. Use the Category select box to determine if the news should be retrieved from all the posts or only from the posts of a specific category
  7. Click the Add News Ticker button to create the news ticker

6) Create a news ticker with news from an RSS feed

Before using an RSS feed, please verify (by inspecting the RSS feed source code) that the following information is available:

  • The title tag (used in the featured news title and in the sliding news)
  • The description tag (used in the featured news excerpt)
  • The link tag (used to link the featured news title and the sliding news if the Enable Links option is active)

This procedure will guide you on the creation of a news ticker that makes use of the information available in an RSS feed:

  1. Visit the Live News -> News Tickers menu
  2. Enter the name of the news ticker in the Name input field
  3. Select where the news ticker should be applied with the Target select box
  4. Enter the URL where the news ticker should be applied in the Target URL input field (this value will be considered only if “URL” is selected in the Target select box)
  5. Open the Source section and select “RSS” in the Source select box
  6. Enter the URL of the RSS feed in the Source RSS input field
  7. Click the Add News Ticker button to create the news ticker

7) Create a news ticker with news from Twitter

If you plan to generate a news ticker based on the information provided by Twitter, it’s very important to note what follows:

Use Twitter as a source only with real web servers

Local development environments are usually not properly configured to retrieve the information from Twitter. For this reason, it’s recommended to use Twitter as a source only on real web servers.

A Twitter App should be created to get the proper keys

To get the proper keys from Twitter (these keys are used by Twitter to identify who is sending the requests to their API) you have to follow this procedure:

  1. Create a Twitter App from this page
  2. In the Permissions tab, keep the Access to “Read Only” (this plugin doesn’t need to write or delete data)
  3. Visit the Keys and Access Tokens tab (you will be using the information available on this page during the configuration of the news ticker)

Create the news ticker

  1. Visit the Live News -> News Tickers menu
  2. Enter the name of the news ticker in the Name input field
  3. Select where the news ticker should be applied with the Target select box
  4. Enter the URL where the news ticker should be applied with the Target URL input field (this value will be considered only if “URL” is selected in the Target select box)
  5. Open the Source section and select “Twitter” in the Source select box
  6. Enter the Twitter username for which you want to retrieve the tweets
  7. Enter the Twitter Oauth Access Token of your Twitter App
  8. Enter the Twitter Oauth Access Token Secret of your Twitter App
  9. Enter the Twitter Consumer Key of your Twitter App
  10. Enter the Twitter Consumer Secret of your Twitter App
  11. Click the Add News Ticker button to create the news ticker

In case you want to remove links from the retrieved tweets, use the Twitter Strip Links option. To remove hashtags, use the Twitter Strip Hashtags option. To remove usernames, use the Twitter Strip Usernames option.

8) Performance

The Performance section available in the Live News -> News Tickers menu allows you to avoid common problems associated with the high number of AJAX requests required to retrieve the news.

Cached Cycles

This value determines the number of cycles performed by the news ticker without updating the news. If you set “10”, then every ten cycles, the plugin will update the news with an AJAX request.

If your website is hosted on a shared hosting environment or if you have a high number of visitors, you can reduce the number of requests sent by the news ticker to your server by increasing this value.

You can also decide to update the news at every cycle by setting the value of this option to “0”, but this is not recommended in most cases.

Transient Expiration

With this option, you can set the transient expiration in seconds or set “0” if you don’t want to use a transient for the news ticker.

The plugin creates a transient when the news ticker is loaded for the first time or when the previous transient is expired. The transient of a news ticker will last for the number of seconds defined with the Transient Expiration option.

Delete a transient

When a transient is available for a news ticker, an icon will appear on the Live News -> News Tickers menu:

Delete a transient with the Live News plugin for WordPress.

Click on the icon to delete the transient. This is required if you want to see the changes applied to a news ticker (that make use of a transient) actually reflected on the news ticker generated on the front-end.

9) Credits

This plugin makes use of the following resources:

For each library, you can find the actual copy of the license inside the folder used to store the library files.

10) FAQ

How to change the time format displayed in the clock?

You can specify a custom time format using the Source -> Clock Format option of the news ticker. The supported tokens are listed in the Format Section of the Moment.js documentation.

Which versions of PHP are supported?

PHP 5.2.4 and later versions are supported.

Which versions of WordPress are supported?

WordPress 4.0 and later versions are supported.