About this plugin
Stockdio’s Economic & Market News contains a plugin and a widget that provide the means to display a list of economic and general stock market news, natively available in over 20 different languages. It also allows to display economic and business news for some specific countries (more than 40 countries are currently available).
If you’re using the standard Gutenberg editor, the easiest way to include this plugin on your page is using the Economic & Market News block, which is included in the Stockdio Financial Visualizations category of the block library.
If you’re using a different editor o prefer to use the shortcode, below is a sample to help you start. Please be aware that most of the parameters listed below are optional, and are also available through the plugin’s settings page. Any parameter you include in the shortcode will overwrite the parameter used in the settings page.
[economic-market-news language="english" width="100%"]
If you want to display economic and business news for a particular country, use the following shortcode as a reference. Please review the documentation below for additional options.
[economic-market-news language="english" country="uk" width="100%"]
If you’re looking for news of a particular company or index in the stock market, please use the Stock Market News plugin instead, available at:
- Stockdio Market News
This plugin is part of the Stockdio Financial Widgets, which also includes the following plugins:
- Stockdio Historical Chart
- Stock Market Overview
- Stock Quotes List
- Stock Market Ticker
- Stockdio Market News
The following parameters are supported in the shortcode and also available through the plugin’s settings page:
language: Specifies the native language for the news (optional, default is English). com/news_languages.
country: If country is specified (optional), business and economic news for the specific country will be displayed, using the language selected. You must be aware that some combinations of language and country will not return any news. For example, you can select language English or Spanish for the United States, but for United Kingdom only English news will be displayed.
com/news_countries.
countryUsage: Determines how to use country news when a country is specified. The values supported are: Only, Combined and Mixed. Only: displays only news for the specified country.
Combined: displays a combination of country and general market news, prioritizing country news at the top. Mixed: displays a mix of country and general market news, sorted chronologically (optional, default is Combined).
maxCountryNews: If a country is specified and Country Usage is set to Combined, which shows a combination of country and market news, you can control the maximum number of country news to display at the top of the list, before showing general market news.
width: Width of the list in either px or % (default: 100%).
height: Height of the list in pixels (default: none). If not specified, the list height will be calculated automatically.
g. News (optional).
includeImage: Allows to include/exclude the news image, if available. Use includeImage=false to hide the image (optional).
imageWidth: Specify the image width in pixels (if available). The image may be partially clipped and centered, depending on the original image dimensions and specified height, to maintain the image’s aspect ratio (optional).
imageHeight: Specify the image height in pixels (if available). The image may be partially clipped and centered, depending on the original image dimensions and specified width, to maintain the image’s aspect ratio (optional).
includeDescription: Allows to include/exclude the news description, if available. Use includeImage=false to hide the description (optional).
maxDescriptionSize: Allows to set the maximum number of characters to display in the description, if available. By default, an estimate of the number of characters to display is calculated based on the image height and display width, but this may not be totally accurate, and a manual setting might be required (optional).
maxItems: Allows to set the maximum number of news items to be displayed (optional, default: 10).
motif: Design used to display the visualization with specific aesthetics, including borders and styles, among other elements (optional). com/motifs.
palette: Includes a set of consistent colors used for the visualization (optional). com/palettes.
font: Allows to specify the font that will be used to render the chart. g. Lato,Helvetica,Arial (optional).
filterSources: Allows to filter news from a list of sources, separated by colon (;). For example, setting the value to Seeking Alpha;Yahoo Finance will only display news that come from any of these sources.
ignoreSources: Allows to ignore news coming from a list of sources, separated by colon (;). For example, setting the value to Seeking Alpha;Yahoo Finance will ignore news that come from any of these sources.
ignoreItems: Allows to ignore news items that start or contain the text specified in a list, separated by colon (;). If the text in the list starts with *, the news item will be ignored if it contains the text anywhere inside its title; otherwise, the news item will be ignored if it starts with the specified text. For example, setting the value to canada;*share price, will ignore any news whose title starts with the word Canada or contains the phrase share price.
It is not case sensitive.
loadDataWhenVisible: Allows to fetch the data and display the visualization only when it becomes visible on the page, in order to avoid using calls (requests) when they are not needed. g. ).
g. using one instance of the plugin for mobile and another one for desktop). We recommend not using this by default but only on scenarios as those described above, as it may provide the end user with a small delay to display the visualization (optional).