Economic & Market News -- WordPress 插件

开发者	stockdio
更新时间	2024年11月19日 02:42
PHP版本:	3.1 及以上
WordPress版本:	6.7
版权:	See www.stockdio.com/wordpress for details

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:

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). For a list of available languages please visit www.stockdio.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. For a list of countries for which we currently provide news please visit www.stockdio.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. title: Allows to specify a title for the list, e.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). For a list of available motifs please visit www.stockdio.com/motifs. palette: Includes a set of consistent colors used for the visualization (optional). For a list of available palettes please visit www.stockdio.com/palettes. font: Allows to specify the font that will be used to render the chart. Multiple fonts may be specified separated by comma, e.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. This is particularly useful when the visualization is not visible on the page by default, but it becomes visible as result of a user interaction (e.g. clicking on an element, etc.). It is also useful when using the same visualization multiple times on a page for different devices (e.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).

Upload the StockdioPlugin folder to your /wp-content/plugins/ directory.
Activate the "Economic & Market News" plugin in your WordPress administration interface.
If you want to change the preset defaults, go to the Economic & Market News settings page.
If you're using the standard Gutenberg editor, add an Economic & Market News block from the Stockdio Financial Visualizations category and configure the news using the settings sidebar.
If you prefer to use the shortcode, insert the [economic-market-news] shortcode into your post content, customizing it with the appropriate parameters. You also have the option to use the Economic & Market News widget included when you install the plugin.
For ease of use, a Stockdio icon is available in the toolbar of the HTML editor for certain versions of WordPress (see screenshots for details).