Logo images

The plugin contains logo images for some public US companies, however coverage is not full. If you like to add a logo image for a particular asset (or change the existing) you need to upload the image file to assets/images/logo folder (inside the plugin folder). The image should be named <SYMBOL>.png (example: AAPL.png). Recommended image size is 64x64px. The image file can be uploaded via cPanel or any WordPress file manager plugin (such as this).

Auto asset recognition

When a website contains many similarly structured pages (where each page provides information about a particular asset), it can be useful that asset symbol is automatically obtained from the page URL rather than each individual widget shortcode. This way you can have exactly the same shortcodes across all such pages, but the plugin will automatically recognize asset symbol specified in the URL and display corresponding market data. To set this up you need to fill in the Asset recognition regexp setting, which should be a valid regular expression with a group to capture asset symbol.

Let's consider an example. Suppose, you have 3 pages with the following URLs: https://yourwebsite.com/stock-page-aapl, https://yourwebsite.com/stock-page-goog, https://yourwebsite.com/stock-page-fb. In this case you can specify the following regular expression in the Asset recognition regexp setting: 

^stock-page-([a-zA-Z0-9-\.=\^\$]+)/?$
After that when one of these pages is accessed the plugin will capture the asset symbol from the URL and display corresponding market data, irrespective of what symbol is specified in the assets parameter of the widget shortcode.

Please note, that on such pages all multi-asset widgets (such as accordion, table, portfolio widgets etc) will also be overridden and use the asset symbol provided in the URL.

Virtual asset pages

When you want to have a dedicated page for every asset (e.g. stock) from a specific market it can be cumbersome to manually create a lot of pages. Don't worry, you can have the plugin auto generate and display such pages automatically on demand. You need to specify a regular expression in the Virtual asset page regexp setting. When a visitor requests a page, which URL matches this expression, a virtual asset page will be automatically created and displayed to the visitor. The content of such pages will be generated based on the Virtual asset page content setting. There you can insert any number of stock widgets (as well as some static content - text, images etc), but the plugin will automatically capture the necessary asset symbol from the URL and display the corresponding market data.

Suppose, that you want the plugin to auto generate a virtual asset page when the following URLs are requested: https://yourwebsite.com/nasdaq/aapl, https://yourwebsite.com/nasdaq/msft, https://yourwebsite.com/nasdaq/goog etc. In this case you can specify the following regular expression in the Virtual asset page regexp setting: 

^nasdaq/([a-zA-Z0-9-\.=\^\$]+)/?$
You can add this widget to the Virtual asset page content setting: 
[stock_market_widget type="card" template="basic3" color="blue" assets="AAPL" api="yf"]
After that, when user opens this page, for instance: https://yourwebsite.com/nasdaq/aapl, the plugin will display an auto-generated page with Apple Inc. widget on it (in this case it doesn't matter which asset is specified in the widget shortcode). Of course, you can have as many widgets on the auto generated pages as you like.

Please note, that on virtual asset pages all multi-coin widgets (such as accordion, table, portfolio widgets etc) will NOT inherit the asset symbol(s) from the URL, but will use that (those) from the shortcode.

The main difference between Auto coin recognition and Virtual coin pages features is that the former is suitable for existing pages or posts and the latter is used to handle requests to non-existing (virtual) pages.