About this plugin
Easily display a list of company and stock news, for any given stock exchange and symbol. Over 65 different stock exchanges and a large number of market indices, currencies and commodities are supported.
If you’re using the standard Gutenberg editor, the easiest way to include this plugin on your page is using the Company & Stock News block, which is included in the Stockdio Financial Visualizations category.
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.
[stock-market-news symbol="AAPL" stockExchange="USA" width="100%"]
If you’re looking for economic and general markets news, please use the Economic & Market News plugin instead, available at:
- Economic & 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
- Economic & Market News
The following parameters are supported in the shortcode and also available through the plugin’s settings page:
stockExchange: The exchange market the symbol belongs to (optional). If not specified, USA Equities will be used by default. com/exchanges.
symbol: The company’s stock symbol (ex. AAPL ) or market index ticker (ex. ^SPX ).
com/indices.
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).
g. Spanish-Spain (optional). com/cultures.
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).
includeRelated: Allows to include general market news in the list, not including the symbol’s company, if available.
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).