Swift Box (WP)

Documentation for v2.5 and later


Before going through documentation chapters, thanks for purchasing Swift Box (WP) and trusting LCweb!

Need further help?

Open a ticket

Need a customization?

Ask for a quotation


Once installed and activated you will be moved to the LCweb Dashboard.
It contains the summary of all LCweb projects with useful links and prompting you to validate them.

LC WP Dashboard

In fact you must link your domain with your license. The procedure is very quick:

  1. Go to the LCweb License Hub and register
  2. Login and navigate to the related product section
  3. Add a new license specifying the purchase code and the domain you will use it onto
  4. The system will give you an activation token

    LC Licenses Hub

  5. Use it in the LCweb Dashboard, on your website

Main Options

Minimum news width / height

This option controls news minimum sizes and has direct effect on how many news are shown per time.
Being adaptive, you have to be sure everything is always perfectly readable

Minimum horizontal Swift Box width

Swift Box has got a double layout and automatically switches to vertical one on small screens, to allow a better navigation and contents display.
Under this minimum width, vertical layout will be forced.

Box Creation

From January 2019 you must get an rss2json token to use RSS and Pinterest sources.
Please fill the related field into settings

From February 2021 you must get an Youtube API key to fetch Youtube data (video guide).
Please fill the related field into settings

What to use for every source:

RSS feed

Simply copy the feed URL (example for CNBC and Envato Notes).
The feed must have a standard structure and contain texts as well as news dates


Use the profile or channel ID, contained in the profile/channel URL.
For example, to fetch videos from the Envato's profile (http://www.youtube.com/user/envato) use: envato

You can also display elements from a specific playlist: in this case use the playlist ID.
Assuming you are playing a video belonging to a playlist, like this one: https://www.youtube.com/watch?v=8NZXG3kU94Q&list=PLXWu0OP8--WQJb01DUSFvGqINdezZra0u&index=1, the playlist ID is PLXWu0OP8--WQJb01DUSFvGqINdezZra0u


Use the URL of a specific user's board.
For example, to fetch contents from the "Company Life" board of the Envato's profile use: envato


Use the Tumblr blog URL (note: only photo/text/link posts can be fetched). Example for "Yacht Cats" blog:

Zapier Feed

Zapier is a great (free) service allowing you to create RSS feed starting from various actions.
In this video you can see how to create a feed starting from your Facebook page contents

Once you configured the Feed composition, simply copy and use its URL as "Rss feed" source

Custom post types

Swift Box can handle any public custom post type associated with a taxonomy.
If you have custom post types in your Wordpress installation, new options will appear in NB settings. Just enable the taxonomy you want to use to fetch posts.

Box settings

News Offset

Number of post to displace or pass over (only for WP-based sources)

News per time

Remember that this value is dynamically altered by global min-width / min-height options

Horizontal image mode

Special layout using full-height image and no description. Usable only if there's an image and for horizontal layout.

The Shortcode

Swift Box is also natively integrated with Elementor, Visual Composer and Divi Builder.
Using them you can skip the standard shortcode wizard and use the related Swift Box tool.

Here's a demo shortcode:

[swiftbox id="5"]

NOTE: After plugin's name change, the official shortcode is [swiftbox], however the old one still works.

Using Quick News

Swift Box comes also with a special post type called Quick News.
It is slightly different from standard wordpress posts:

  • News cannot be searched in wordpress
  • News don't have a public wordpress page, nor a direct permalink

As name suggests, it's meant to be used for quick or temporary news.
Plus you can attach to each news a youtube/vimeo video link as well as a soundcloud embed url.

Custom Skin Builder

Styles are globally applied in the website, however using javascript (check related documentation chapter) you can force other themes

Tips and Tricks

Some special usage examples:

Continuous sliding effect

To create a continuous sliding effect youjst have to set an high animation_time value and a slideshow_time equal to zero.
The plugin is coded to recognize this settings and change its behavior, creating a "breaking news bar" result.

Colored subject box

Author field can contain also special characters and HTML code. Here's a special usage to have colored subjects in a box having two breaking news sources.
This is the code to insert in author fields:

<span class="lcnb_author_1">Top News</span>
<span class="lcnb_author_2">Economy</span>

Then the CSS part (should be placed in settings Custom CSS field)

.lcnb_author_1 {
	background-color: #930000; 
	color: #fff; 
	border-radius: 3px; 
	font-size: 80%; 
	padding: 2px 5px;
.lcnb_author_2 {
	background-color: #016942; 
	color: #fff; 
	border-radius: 3px; 
	font-size: 80%; 
	padding: 2px 5px;

This is the result:

Custom date rapresentation

You can use also symbols and codes to compose the date format.
In fact you can customize it also with HTML, taking care to not use wrongly one of the placeholders.

This is a little example of what you can achieve using this format:

<span style="position: relative; top: 7px; font-size: 22px; color: #666;">d/</span>
<span style="text-transform: uppercase; vertical-align: top; margin: 0px 0px 0px 6px;">mmm</span><br/>
<span style="float: right; margin: -2px -1px 0px 0px;">yyyy</span>

This is the result:


The plugin is 100% multilanguage for both front and back ends. If a translation of your language has been created, WordPress will automatically switch between languages.
Plus it is compatible with WPML and Polylang!

How to create a translation

If you have WPML + String Translation add-on or Polylang, you can simply scan the plugin and translate strings via its UI.

Otherwise: go in the plugin folder, then open the one named "languages".
Inside you'll find the default.pot file. It contains english strings to be translated.

If you want to create or customize one your language translation, follow these steps:

  1. Open the default.pot file with POedit
  2. Edit the catalog by inserting your data and setting translation's language
  3. Save the file with your language's i18n identifier and "nb_ml-" prefix (the italian example is nb_ml-it_IT)
  4. Go to plugin's folder ".. wp-content/plugins/news-box-wp/languages" and paste resulting .PO and .MO files

If you create new translations, please contact me at [email protected] sending your .PO and .MO files.
Otherwise they will be lost in next updates. Thanks!

Javascript Usage

This is the WordPress implementation of a jQuery plugin.
Then you can initialize and place boxes wherever in your website using jQuery.

Javascript Documentation

Obviously website installation is already done, you just have only to initialize plugin's code.