Documentation: Ticker for WordPress
System Requirements
Plugin Installation
- Log in to your CMS WordPress site control panel.
- On the left side of the administrative menu, click on "Plugins".
- On the page that opens, at the top click on "Add new".
- This will open a page with the addition of plugins to the site from the official WordPress catalog. You need to click on the "Upload Plugin" button.
- After clicking on the page, a block with the download of the plugin archive will appear. Click on the "Choose file" button, select the archive with the plugin obtained by purchasing from IWS.BY and click on the "Install Now" button.
- Once the plugin is installed, the page will refresh and you will be prompted to activate the plugin. Click the "Activate plugin" button.
- After successful activation, you will be shown a window notifying you that the plugin has been successfully activated.
Plugin settings
To access the plugin settings, navigate through the admin panel menu to IWS.BY Ticker → Settings.
The plugin settings page will open with all available options.
License Key
Enter the license key you received after placing your order on IWS.BY. Without a valid license key, the plugin will not receive updates and may not function properly.
These are all the available plugin settings.
All Tickers
To access the main component section where all added tickers on the website are displayed, navigate to the IWS.BY Ticker menu.
A table containing all tickers added to the website will open. Let's review each column to understand what it displays.
- 1. "Title" – This column shows the ticker name entered on the "Add Ticker" page. Technically, this name is not used anywhere except in the table to identify the tickers.
- 2. "Type" – This column displays the current ticker type.
- 3. "Shortcode" – This column contains the shortcode that will render the ticker on the website. The shortcode is necessary for adding the ticker to pages, posts, and other text editors in the admin panel.
- 4. "PHP Function" – This column contains the PHP function that will render the ticker on the website. The PHP function is necessary for adding the ticker to website templates and PHP files.
- 5. "Date" – This column displays the date the ticker was added.
Adding a Ticker
To add a new ticker, navigate to IWS.BY Ticker → Add New.
Add Title
Enter the name of your ticker in this field. This name is used only for identification by the website administrator and is not displayed anywhere on the front end.
The following fields are divided into two groups. The first group controls the main ticker settings, and the second group controls the ticker's content.
Ticker – Settings
Ticker Type
This option determines the type of data that will be displayed in the ticker.
- "Text" – The ticker content will be a text message. Settings for this type are available in the "Ticker – Content" block, under the "Type "Text"" tab.
- "Link List" – The ticker content will be a list of various links. Settings for this type are available in the "Ticker – Content" block, under the "Type "Link List"" tab.
- "Images" – The ticker content will be a list of various images. Settings for this type are available in the "Ticker – Content" block, under the "Type "Images"" tab.
Ticker Width
This field sets the width of the ticker. Specify a value with a unit. We recommend using pixels (px) or percentages (%). The value "auto" is also acceptable.
Ticker Height
This field sets the height of the ticker. Specify a value with a unit. We recommend using pixels (px) or percentages (%). The value "auto" is also acceptable.
Margin top
This field sets the margin from the ticker block to the adjacent block above. Specify a numeric value in pixels.
Margin right
This field sets the margin from the ticker block to the adjacent block on the right. Specify a numeric value in pixels.
Margin bottom
This field sets the margin from the ticker block to the adjacent block below. Specify a numeric value in pixels.
Margin left
This field sets the margin from the ticker block to the adjacent block on the left. Specify a numeric value in pixels.
Enable Border?
When set to "Yes," a border will be applied to the ticker block using the settings below.
Border Width
This field sets the width of the ticker block border. Specify a numeric value in pixels.
Border Style
This option sets the style of the ticker block border. Available styles include solid, dashed, dotted, and double.
Border Color
This option sets the color of the ticker block border. Enter a HEX color code.
Border rounding corners
This field sets the corner radius of the ticker block border. Specify a numeric value in pixels.
Padding top
This field sets the padding from the ticker content to the top edge of the ticker block. Specify a numeric value in pixels.
Padding right
This field sets the padding from the ticker content to the right edge of the ticker block. Specify a numeric value in pixels.
Padding bottom
This field sets the padding from the ticker content to the bottom edge of the ticker block. Specify a numeric value in pixels.
Padding left
This field sets the padding from the ticker content to the left edge of the ticker block. Specify a numeric value in pixels.
Enable Background?
When set to "Yes," a background will be applied to the ticker block using the settings below.
Background Color
This option sets the background color of the ticker block. Enter a HEX color code.
Movement mode
This option determines the scrolling direction of the content in the ticker. Available options: right to left, left to right, bottom to top, or top to bottom.
Movement speed
This option determines the scrolling speed of the content in the ticker. The higher the number, the faster the scrolling.
Stop motion
When set to "Yes," the scrolling will pause when the user hovers the mouse cursor over the ticker.
Ticker – Content
The ticker content settings are organized into tabs, each with its own individual settings. The main content type option is set in the previous block, in the "Ticker Type" field.
Type "Text"
Message Text
Enter the text message that should appear in the ticker.
Text Color
This option sets the text color of the message in the ticker block. Enter a HEX color code.
Hover text color
This option sets the text color of the message in the ticker block when hovered over with the mouse cursor. Enter a HEX color code.
Text Style
This option sets the font style of the message in the ticker block. Available styles: normal, bold, italic, and bold italic.
Message Text Size
This option sets the font size of the message in the ticker block. Specify a numeric value in pixels.
Enable the link?
When set to "Yes," the message text in the ticker block will be wrapped in a link with the settings below.
Link
The URL that the user will be redirected to when clicking the message text in the ticker block.
Link opening attribute
This option controls how the link opens in the visitor's browser when the message text is clicked.
Type "Link List"
Link display
This option determines how the list of links is displayed. It can be horizontal or vertical.
Indent between links
Enter the distance that should be between the links. Depending on the link layout, this spacing is applied to the right or the bottom.
The next settings block controls the list of links to be displayed in the ticker. The options are identical for all of them, as links are created using uniform blocks. A maximum of 10 links can be added.
Enable Link?
When set to "Yes," the link will be displayed in the ticker block.
Link Name
Enter the text title of the link in this field.
Link URL
Enter the direct address (URL) of the desired page. Example: https://iws.by/
Link Path
This option controls how the link opens in the visitor's browser.
Link Color
This option sets the text color of the link in the ticker. Enter a HEX color code.
LLink color on hover
This option sets the text color of the link in the ticker when hovered over with the mouse cursor. Enter a HEX color code.
Link Size
This field sets the font size of the link text in the ticker block. Specify a numeric value in pixels.
Link Style
This option sets the font style of the link text in the ticker block. Available styles: normal, bold, italic, and bold italic.
Type "Images"
Displaying images
This option determines the layout of the image list. It can be horizontal or vertical.
Image Width
Enter the width to be applied to all images in horizontal layout mode. Specify a numeric value in pixels.
Image Height
Enter the height to be applied to all images in vertical layout mode. Specify a numeric value in pixels.
Indentation between images
Enter the distance that should be between the images. Depending on the image layout, this spacing is applied to the right or the bottom.
The next settings block controls the list of images to be displayed in the ticker. The options are identical for all of them, as images are created using uniform blocks. A maximum of 10 images can be added to the ticker.
Enable Image?
When set to "Yes," the image will be displayed in the ticker block.
Image
Select the image that should be displayed in the ticker.
Title to image
Enter the image title, which will be set as the alt and title attributes of the image.
Link to image
The URL that the user will be redirected to when clicking the image in the ticker block.
Link opening attribute of a link to an image
This option controls how the link opens in the visitor's browser when the image is clicked.
Plugin update error
If you have an error when updating a plugin in the WordPress control panel, then this section of the instructions is necessary for you. Usually the error when updating looks like this:

This error appears in several cases, they are all related to the plugin's license key.
1) You do not have the license key filled in in the plugin settings.
Go to the plugin settings and check if the field "License key" is filled in. Without a license key update is not possible to download. There are times when you add a license key, but CMS WordPress did not save it correctly, for this plugin settings after entering the license key, click "Save".
2) Your plugin version cannot be updated automatically.
There are versions of plugins that cannot update automatically. To do this, go to the IWS.BY website at the link https://iws.by/en/my-account/downloads/. In the list of available downloads, find your plugin and download by clicking on the button on the right. Go to the administrative part of your site, to the plugin section, and download the new version using the WordPress plugin installer. Due to security updates to the update server, some plugin versions need to be updated manually. To check the list of such plugins for your version of the plugin, go to the following link: List of versions of WordPress plugins that can be updated manually.
3) Your license key has expired.
To check the expiration date of your license key, follow this link https://iws.by/en/my-account/view-license-keys/. In the list of license keys, find your plug-in key and in the column "Valid until" check its relevance. If the license key has expired, it is not possible to get updates. To solve this issue: make a new order and get the current license key.
3) The license key is not valid on your current site.
Our update system is designed so that the first time you access the update server, the license key is assigned to the requesting site. If you try to use a license key on more than one site, updates will only be available for one site. If you need updates for multiple sites, make a purchase of multiple license keys on the site. Sites without license keys will not be able to receive updates.
Attention! If you have changed the address of the site and can not download updates, write to us at support@iws.by with the new address of the site, we will update the data on our update server and within 24 hours you will be able to receive updates.
Support
IWS.BY support service for questions regarding our products is available via email: support@iws.by.
All available support options are available on the Support page: Go to.