Stock Quote

A simple and easy configurable plugin for WordPress which allows you to insert inline stock quotes with stock price information to posts, pages, widgets or even to template files. Insertion is mainly available by shortcode.

Please note, stock data has been provided by Alpha Vantage

Stock Quote is simplified, static inline variation of Stock Ticker plugin.

Multisite WordPress is not supported yet

IMPORTANT Stock Quote does not have own Gutenberg Block, so you can add [stock_quote] shortcode inline to Paragraph Block or Common Block to insert Stock Quote within the post/page content.

Disclaimer

All stock data used in Stock Quote is provided by Alpha Vantage, displayed for informational and educational purposes only and should not be considered as investment advise.

Author of the Stock Quote plugin does not accept liability or responsibility for your use of plugin, including but not limited to trading and investment results. Along to that, author of Stock Quote plugin can not guarantee that stock prices are always accurate as they are provided by 3rd party service for free.

Features

• Configure default stock symbol that will be displayed by shortcode if no symbol provided

• Configure default presence of company as Company Name or as Stock Symbol

• Configure global colours for unchanged quote, negative and positive changes

• Tooltip for quote item display company name, exchange market and last trade date/time (if available)

• Define custom names for companies to be used instead symbols

• Plugin uses native WordPress function to get and cache data from AlphaVantage.co API for predefined duration of time

For feature requests or help send feedback or use support forum on WordPress.

How It Works?

• When front-end is loaded in browser, plugin will render quote placeholder in place where you have inserted shortcode.

• Right after page is loaded, AJAX call will request quote content and inject it inside quote placeholder. That quote is retrieved as a cached value in database.

• Couple seconds latter, second AJAX request will initiate background quote update from WordPress.

• If Cache Timeout period has expired, plugin will pick first symbol from All Stock Symbols field. Each time it will pick next symbol.

• Without disturbing page rendering and speed to get quote from database, plugin in background retrieve data from AlphaVantage.co for picked symbol.

• If quote is successfully retrieved, plugin will save value for that symbol in database.

• New fetched quote for symbol will be displayed on front-end only after page reload but not right after updated quote get fetched from AlphaVantage.co!

How To Use

You can add Stock Quote to posts, pages or widgets by shortcode.

Shortcode

Use simple shortcode [stock_quote] without any parameter in post or page, to display quote with default (global) settings.

IMPORTANT All shortcode parameters and values should be lowercase, except symbols which must be uppercase!

You can tune single shortcode with parameters:

• symbol – represent single stock symbol (if not provided then use default from settings page)

• show – can be name to represent company with Company Name (default), or symbol to represent company with Stock Symbol. You must add preferred symbol to Custom Names textarea on Settings page because Google Finance does not provide nice company names in feeds

• decimals – override default number of decimal places for values (default from settings page used if no custom set by shortcode). Valud values are: 1, 2, 3 and 4

• number_format – override default number format for values (default from this settings page used if no custom set by shortcode). Valid options are: cd for 0.000,00; dc for 0,000.00; sd for 0 000.00 and sc for 0 000,00

• template – override default template string (default is: %company% %price% %change% %changep% ). You can use following template keywords: %company%, %company_name%, %exch_symbol%, %symbol%, %price%, %change%, %changep%, %volume%, %raw_price%, %raw_change%, %raw_changep%, %raw_volume% and %ltrade% which stand for the last trade day (like 2020-09-25 ), which can be followed by the PHP date format to customize date output, separate by pipe character, eg. |l, jS \of F Y

• raw – enable printing quote content without wrapping to SPAN with classes. Default is disabled. Can be 1 or true for enabled, OR 0 or false for disabled.

• class – (optional) custom class name for quote item, if you wish some special styling

Example

[stock_quote symbol="^DJI" show="symbol"]

or

[stock_quote symbol="MSFT" decimals=3 number_format=cd template="%symbol% %price% %change% %changep%"]<h3>Supported Stock Exchange Markets</h3>

Alpha Vantage provide stock data for following stock exchange markets:

• BOM – Bombay Stock Exchange

• BIT – Borsa Italiana Milan Stock Exchange

• TSE – Canadian/Toronto Securities Exchange

• FRA – Deutsche Boerse Frankfurt Stock Exchange

• ETR – Deutsche Boerse Frankfurt Stock Exchange

• AMS – Euronext Amsterdam

• EBR – Euronext Brussels

• ELI – Euronext Lisbon

• EPA – Euronext Paris

• LON – London Stock Exchange

• NASDAQ – NASDAQ Exchange

• CPH – NASDAQ OMX Copenhagen

• HEL – NASDAQ OMX Helsinki

• ICE – NASDAQ OMX Iceland

• STO – NASDAQ OMX Stockholm

• NYSE – New York Stock Exchange

• SHA – Shanghai Stock Exchange

• SHE – Shenzhen Stock Exchange

• TPE – Taiwan Stock Exchange

• TYO – Tokyo Stock Exchange

Not supported:

* MCX – Moscow Exchange (since December 2018) – eg. MCX:GAZP

* ASX – Australian Securities Exchange ( since since May 2020 ) – eg. ASX:MSB

* SGX – Singapore Exchange ( since July 13th 2020 ) – eg. SI

* NSE – National Stock Exchange of India ( since July 2020 ) – eg. NSE:VB