Descripción
A simple and easy configurable plugin for WordPress that allows you to insert stock ticker with stock price information to posts, pages, widgets or even to template files. Insertion is enabled by shortcode or multi instance widget.
Please note, stock data has been provided by Alpha Vantage which does not support indexes since mid-2020!
Stock Ticker is advanced variation of Stock Quote plugin.
Multisite WordPress is not supported yet
IMPORTANT Stock Ticker does not have own Gutenberg Block, so you can use Shortcode Block or Common Block to insert Stock Ticker within the post/page content.
Disclaimer
All stock data used in Stock Ticker is provided by Alpha Vantage, displayed for informational and educational purposes only and should not be considered as investment advise.
Since end of year 2023 AlphaVantage limited Free API tier to 25 requests per day.
Author of the Stock Ticker 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 Ticker plugin can not guarantee that stock prices are always accurate as they are provided by 3rd party service for free.
Características
- Set global set of symbols you’ll use site-wide
- Configure default set of stock symbols that will be displayed in ticker inserted by empty shortcode
- Configure default presence of company as Company Name or as Stock Symbol
- Configure colours for unchanged quote, negative and positive changes with colour picker
- Disable scrolling ticker and make it static
- Define custom names for companies to be used instead of the symbols
- Define custom elements as a part of visible value
- Optional (BETA) Intraday time series for equity. Known issues because of 15min timeframe: RANGE and VOLUME are wrong. Because indexes does not have VOLUME, so for indexes and currencies TIME_SERIES_DAILY will be used
You can set custom template for visible change value. Default format is %company% %price% %change% %changep%
. As a macro keywords you can use:
%exch_symbol%
– Symbol with exchange, like NASDAQ:AAPL%symbol%
– Company symbol, like AAPL%company%
– Company name after filtered by custom names, like Apple Inc.%price%
– Price value, like 125.22%change%
– Change value, like -5.53%changep%
– Change percentage, like -4.23%%ltrade%
– 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
For feature requests or help send feedback or use official WordPress support forum.
How To Use
You can add Stock Ticker to posts, pages or widgets by shortcode or widget (Appearance -> Widgets).
Shortcode
Use simple shortcode [stock_ticker]
without any parameter in post or page, to display ticker with default settings. You can tweak single shortcode with parameters:
symbols
– string with single or comma separated array of stock symbolsshow
– string that define how will company be represent on ticker; can bename
for Company Name, orsymbol
for Stock Symbolnumber_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 andsc
for 0 000,00decimals
– override default number of decimal places for values (default from this settings page used if no custom set by shortcode). Valid values are:1
,2
,3
and4
static
– (boolean) to enable static unordered list instead scroling ticker set to1
ortrue
prefill
– (boolean) to start with pre-filled instead empty ticker set to1
ortrue
duplicate
– (boolean) if there is less items than visible on the ticker, set this to1
ortrue
to make it continuousspeed
– (integer) tune speed of StockTicker block rendered by shortcodeclass
– customize block look and feel set custom CSS class (optional)
Examples
- Scrolling ticker
[stock_ticker symbols=”BABA,EURGBP,LLOY.LON” show=”symbol”] - Static unordered list
[stock_ticker symbols=”BABA,EURGBP,LLOY.LON” show=”symbol” static=”1″]
Supported Stock Exchange Markets
Alpha Vantage provide stock data for following stock exchange markets:
- BOM – Bombay 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
- 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.
C29.SI
- NSE – National Stock Exchange of India (since July 2020) – eg.
NSE:VB
- STO – NASDAQ OMX Stockholm (since October 2021) – eg.
STO:ATCO-A
- BIT – Borsa Italiana Milan Stock Exchange (since December 2023) – eg.
BIT:OLI
Hall of Fame
Kudos to patchstack and Wordfence Intelligence researchers for early reporting vulnerabilities!
A big thank you goes to @flexer, @khunmax, @k2_1971 and @vijaleshk who do tests with alpha versions of plugin until we finally released v3.0.0. And also important to mention @eigood who pointed me to AlphaVantage.co as a replacement for Google Finance.
Capturas
Instalación
To install Stock Ticker and make initial setting to work, please follow instructions below
- Go to
Plugins
->Add New
- Search for
Stock Ticker
plugin - Install and activate
Stock Ticker
- Get a free API Key from AlphaVantage.co
- In WordPress Dashboard go to
Settings
->Stock Ticker
- Enter to field
AlphaVantage.co API Key
Alpha Vantage API Key you received in previous step (check this screenshot) - Enter to field
All Stock Symbols
all stock symbols you’ll use on whole website in various widgets and shortcodes, separated by comma. This field is used to fetch stock data from AlphaVantage.co API by AJAX in background. Because AV have only API to get data for single symbol, that can take a while to get. Please note, for default shortcode symbols there is still have field in Default Settings section of plugin. - Save settings and click button
Fetch Stock Data Now!
to initially fetch stock data to database and wait for a while until we get all symbols from AlphaVantage.co for the very first time. - Insert shortcode
[stock_ticker]
to page or post, orStock Ticker
Widget to preferred Widget Area.
Preguntas frecuentes
-
How to know which stock symbols to use?
-
You can use standard symbols from stock exchanges supported by AlphaVantage.co.
For example, you can try with AAPL, MSFT, IBM, CSCO, GOOG, YHOO, AMZN (Apple Inc; Microsoft Corporation; International Business Machines Corporation; Cisco Systems, Inc.; Google Inc; Yahoo! Inc; Amazon.com, Inc.)
To check if AlphaVantage.co support your preferred symbol(s), you can use Symbol Search & Test tool on plugin settings page to search for keysords and symbols on AlphaVantage.co directly from your WordPress dashboard. -
Stock Exchange or Symbol I need does not work!
-
Try to find correct symbol on AlphaVantage.co by looing for it in Symbol Search & Test tool. Even try alternatives or company name. If that does not help, search Alpha Vantage community forum www.alpha-vantage.community or contact Alpha Vantage support.
-
How to get Dow Jones Industrial Average or other Indexes?
-
Unfortunately, AlphaVantage.co no longer supports indexes (mid-2020). That is why Stock Ticker no longer provide quotes for them.
-
How to get Crude Oil, Gold and other commodities?
-
Unfortunately, AlphaVantage.co does not support commodities (metals, energies, grains, meats, softs). That is why Stock Ticker can’t provide quotes for them.
-
How to get currency exchange rate?
-
Use Currency exchange symbols like
EURGBP
to get rate of1 Euro
=? British Pounds
Please note, since mid-2020 AlphaVantage.co does not support anymore formatEURGBP=X
so use syntax without=X
. -
How to get proper stock price from proper stock exchange?
-
Enter symbol in format
EXCHANGE:SYMBOL
likeLON:LLOY
orSYMBOL.EXCHANGE
likeLLOY.LON
for Lloyds Banking Group Plc from London Stock Exchange market.
Please note that AlphaVantage.co does not provide stock data always for all existing stocks. -
How to get descriptive title for currency exchange rates?
-
Add to
Custom Names
legend currency exchange symbol w/o=X
part, like:EURGBP;Euro (€) ⇨ British Pound Sterling (£)
-
How to add Stock Ticker to header theme file?
-
Add this to your template file (you also can add custom parameters for shortcode):
<?php echo do_shortcode('[stock_ticker]'); ?>
-
How to customize quote output?
-
On Settings page for plugin you can set custom Value template. You can use macro keywords
%exch_symbol%
,%symbol%
,%company%
,%price%
,%volume%
,%change%
,%changep%
and%ltrade%
mixed with HTML tags<span>
,<em>
and/or<strong>
.Default template is
%company% %price% %change% %changep%
but you can format it like:<span style="color:#333">%company%</span> <em>%price%</em> <strong>%change%</strong> %changep%
-
I set to show `%company%` but symbol is displayed instead
-
Please note that Alpha Vantage does not provide company name in retrieved feeds. You’ll need to set company name in Custom Names field on plugin settings page.
-
How to resolve error `Unfortunately, we could not get stock quotes this time`?
-
This can be temporary issue. First try to run
Fetch Stock Data Now!
on plugin settings page.If that does not help, next try to increase Fetch Timeout option on general plugin settings and then run
Fetch Stock Data Now!
.If you still experiencing issue, please contact us through support forum.
-
Can I get stock data for my custom code?
-
Since version 3.1 of Stock Ticker you can get stock data in custom functions. Fore example:
<?php if ( class_exists( 'Wpau_Stock_Ticker' ) ) { $stock_data = Wpau_Stock_Ticker::get_stock_from_db( 'AAPL,MSFT' ); var_dump( $stock_data ); } ?>
That will return associated array for requested symbols:
array(2) { ["AAPL"]=> array(11) { ["symbol"]=> string(4) "AAPL" ["tz"]=> string(10) "US/Eastern" ["last_refreshed"]=> string(19) "2018-09-14 00:00:00" ["last_open"]=> string(8) "225.7500" ["last_high"]=> string(8) "226.8400" ["last_low"]=> string(8) "222.5220" ["last_close"]=> string(8) "223.8400" ["last_volume"]=> string(8) "31999289" ["change"]=> string(7) "-2.5700" ["changep"]=> string(7) "-1.1351" ["range"]=> string(19) "222.5220 - 226.8400" } ["MSFT"]=> array(11) { ["symbol"]=> string(4) "MSFT" ["tz"]=> string(10) "US/Eastern" ["last_refreshed"]=> string(19) "2018-09-14 00:00:00" ["last_open"]=> string(8) "113.3600" ["last_high"]=> string(8) "113.7300" ["last_low"]=> string(8) "112.4400" ["last_close"]=> string(8) "113.3700" ["last_volume"]=> string(8) "19122349" ["change"]=> string(6) "0.4600" ["changep"]=> string(6) "0.4074" ["range"]=> string(19) "112.4400 - 113.7300" } }
Reseñas
Colaboradores y desarrolladores
Este software es de código abierto. Las siguientes personas han contribuido a este plugin.
ColaboradoresTraduce “Stock Ticker” a tu idioma.
¿Interesado en el desarrollo?
Revisa el código, echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
3.24.6 (20240628)
- Fix: Stored Cross-Site Scripting discovered by Dale Mavers via Wordfence
- Change: Code simplification
- Tested: WordPress 6.5.5 with Twenty Twenty-Four 1.1 and PHP 8.3.7
3.24.4 (20240420)
- Fix: API Key Tier always show as Free in plugin settings
- Tested: WordPress 6.5.2 with Twenty Twenty-Three 1.4 and PHP 8.3.6
3.23.5 (20231216)
- Security: Fix XSS in shortvode() method (reported by resecured.io via patchstack)
- Tested: WordPress 6.4.2 with Twenty Twenty-Three 1.3 and PHP 8.2.13
- Change: Discard symbols that contains carret and equals sign
- Change: AlphaVantage introduced 25 requests per day for Free tier
- Change: Deprecated Premium tiers 15, 60, 120, 360, added new Premium tiers 30, 75, 150 and 1200 requests per minute
- Simplify: Plugin Settings page sidebar
- Readme: Removed BIT Italian Stock Exchange from supported by AlphaVantage
3.23.4 (20230810)
- Security: Fix CSS of stockticker_load
- Tested: WordPress 6.3 with Twenty Twenty-Three 1.2 and PHP 8.2.8
3.23.3 (20230717)
- Security: Fix XSS of Symbol Search & Test
3.23.2 (20230622)
- Fix: webTicker jQuery library punch CPU to 100% on window resize
- Tested: WordPress 6.2.2 with Twenty Twenty-Three 1.1 and PHP 8.2.7
3.23.1 (20230223)
- Security: Patch Broken Access Control
- Security: Remove URL parameter
stockticker_purge_cache
which allow unauthorised user to purge stock cache (from now purge stock cache by updatingAll Stock Symbols
or runningFetch Stock Data Now
on plugin settings page)
3.23.0 (20230223)
- Security: Fix CSRF vulnerability, thanks to Mika/Patchstack
- Tested: WordPress 6.2-beta3 with theme Twenty Twenty-Three and PHP 8.2.1
3.2.2 (20220102)
- Fix: Fix bug introduced with release 3.2.1 which prevent stocks to be updated
- Tested: WordPress 5.9 and PHP 8.0.11
3.2.1 (20211113)
- Fix: custom
number_format
has no effect - Tested: WordPress 5.8.2 and PHP 7.4.24
3.2.0 (20201107)
- Update: FAQ
- Improve: Help section on plugin settings page
- Improve: spelling and grammar
- Change: rename option
Auto Refresh
toAuto Reload
to be clear what it is for - Tested: WordPress 5.5.3 and PHP 7.4.10
- (20201002) Improve: translatable strings and update Text Domain to from
wpaust
tostock-ticker
- Add: Symbol Search & Test to help users find correct symbol notation on AlphaVantage.co
- (20200825) Add: new template keyword
%ltrade%
with customizable date format like%ltrade|l, jS \of F Y%
3.1.0.1 (20200810)
- Tested: WordPress 5.5-RC2-48768 and PHP 7.4.1
- (20190328) Fix: infinite Bad API response introduced in release 3.1
3.1 (20190328)
- Bump supported WordPress version
- Remove MCX from supported exchanges because AlphaVantage does not provide data for Moscow Stock Exchange
- Fix/Improve: Infinite loop for bad API responses
- Improve: Update disclaimer and readme
- (20181122) Fix: Infinite fetch loop
- Improve: Tier pause between symbol fetches
- Improve: Allow dash in stock symbol
- (20180916) Improve: Make Force Fetch to wait between each symbol fetch regarding to the API Tier
- Improve: Remove duplicate symbols on settings update
- Simplify: Merge 3 settings sections to single register_settings
- Improve: Move routine to extract symbol to fetch to self method
get_symbol_to_fetch()
- Improve: Move stock data to DB to self method
data_to_db()
- Change: Make method
get_stock_from_db()
public so user can access Stock data in DB from custom functions - Change: Move method
sanitize_symbols()
to main class and make it public static so user can access it from custom functions - (20180824) Add Alpha Vantage Tier option for better fetch timeout control
- Switch to GLOBAL_QUOTE API mode and eliminate requirement to calculate change amount from TIME_SERIES_DAILY and TIME_SERIES_INTRADAY
- Remove Intraday option from settings
3.0.5.4 (20180823)
- Fix: Better sanitization for AllSymbols
- (20180403) Fix: Undefined index: message in wp-content/plugins/stock-ticker/stock-ticker.php on line 483
- (20180321) Fix: Division by zero in stock-ticker\stock-ticker.php on line 1259 for not fully supported indices like
^DJBWR
3.0.5.3 (20180228)
- Fix: Safer fix for Checkbox options
3.0.5.2 (20180228)
- Fix: Checkbox options can not be disabled (
Intraday
,Auto Refresh
,Load assets on all pages
). Thanks to @cmyee for reporting bug. - Fix:
Cache Timeout
can not be saved and always reset to zero on settings update.
3.0.5.1 (20180204)
- Fix: JavaScript error
Uncaught ReferenceError: stock_tickers_load is not defined
reported by @wparold
3.0.5 (20180204)
- Fix: stock price was by mistake taken from last_open instead of last_close, reported by @cartmen123
- Fix: INTRADAY option set as
BETA
- Fix: undefined variable $symbol and $method
- Improve: description for
Intraday
- Improve: description for
Refresh Timeout
option and rename toAuto Refresh Timeout
- Improve: description for
Cache Timeout
option - Improve: add advised minimal cache timeout value, based on number of symbols in
All Stock Symbols
andFetch Timeout
value. - (20180118) Add: support for TIME_SERIES_INTRADAY as optional method for refular symbols (excluding currencies and indexes)
3.0.4 (20171212)
- Add: Button to
Stop Fetch
of forced fetching stock data on settings page - Improve: Description for
Fetch Stock Data
on settings page - Improve: Response info for
Fetch Stock Data
on settings page with link to test symbol in case of error messageInvalid API call
3.0.3 (20171211)
- Fix: Users of 0.2.99-alpha could have uncreated stock ticker table in database because of broken upgrade script in alpha versions
- Add: Admin notification for AlphaVantage.co API Key and All Stock Symbols
- (20171207) Add: Routine to stripe unsupported stock exchanges from all symbols when doing fetch from AlphaVantage.co to prevent API errors
- Add: Routine to strip symbols from unsupported stock markets from
All Stock Symbols
andStock Symbols
and display message about removed symbols on settings update - Improve: sanitization for stock symbols on settings update
- Change: API Key input type set to password
3.0.2 (20171205)
- Readme: add required PHP version and link profiles in Hall of Fame
- Add: Notice about not supported multisite
- Add: Activation routine to check and deactivate plugin on multisite as not supported at the moment
3.0.1 (20171204)
- Fix: Plugin table has not created for fresh installations
- Fix: Stuck fetching data from AlphaVantage.co after first symbol fetch fail
- Add: Force fetching data from settings page
- Add: Fill stockticker.log only if WP_DEBUG is enabled
- Change: Log and AJAX messages wording
3.0.0 (20171203)
- Release working version of plugin