Описание
Простой и легко настраиваемый плагин для WordPress, который позволяет вставлять тикер с информацией о цене акций в записи, страницы, виджеты или даже в файлы шаблона. Вывод возможен шорткодом или многоэкземплярным виджетом.
Please note, stock data has been provided by Alpha Vantage which does not support indexes since mid-2020!
Stock Ticker является расширенной версией Stock Quote plugin.
Multisite WordPress не поддерживается
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.
Ответсвенность
Все биржевые данные, используемые в Stock Ticker предоставляются Alpha Vantage, отображаются только в информационных и образовательных целях и не должны рассматриваться в качестве инвестиционного совета.
Since end of year 2023 AlphaVantage limited Free API tier to 25 requests per day.
Автор плагина Stock Ticker не несет ответственности за использование вами плагина, включая, но не ограничиваясь результатами торговли и инвестиций. Кроме того, автор плагина Stock Ticker не может гарантировать, что цены на акции всегда точны, поскольку они предоставляются сторонним сервисом бесплатно.
Возможности плагина
- Установка глобального набора символов, которые вы будете использовать на сайте
- Настройка набора биржевых символов по умолчанию, которые будут отображаться в тикере, при использовании шорткода без параметров
- Настройка присутствия по умолчанию компании в качестве названия компании или биржевого символа
- Configure colours for unchanged quote, negative and positive changes with colour picker
- Отключение прокрутки тикера, возможность сделать его статическим
- Определение пользовательских имен для компаний, которые будут использоваться вместо символов
- Определение пользовательских элементов как части видимого значения
- Опционально (БЕТА) суточные временные серии для акций. Известные проблемы из-за 15-минутного временного периода: не верны RANGE и VOLUME. Поскольку индексы не имеют VOLUME, то для индексов и валют будет использоваться TIME_SERIES_DAILY
Вы можете установить пользовательский шаблон для отображения изменённого значения. По умолчанию используется формат %company% %price% %change% %changep%
. В качестве основных переменных можно использовать:
%exch_symbol%
— Тикер с биржей, например NASDAQ:AAPL%symbol%
— Символ компании, например AAPL%company%
— Название компании после фильтрации по пользовательским именам, например Apple Inc.%price%
— Значение котировки, например 125.22%change%
— Изменённое значение, например -5.53%changep%
— Изменение в процентах, например -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.
Как пользоваться
Вы можете добавить Stock Ticker в записи, страницы или виджеты с помощью шорткода или виджета (Внешний вид -> Виджеты).
Шорткод
Используйте шорткод [stock_ticker]
без каких-либо параметров в записях или страницах, чтобы вывести тикер с настройками по умолчанию. Также Вы можете настроить определённый шорт с помощью следующих параметров:
symbols
— строка с одним или разделенным запятыми массивом биржевых символовshow
— строка, которая определяет, как компания будет в тикере; может бытьname
для названия компании, илиsymbol
для биржевого символа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 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)
Примеры
- 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″]
Поддерживаемые фондовые биржи
Alpha Vantage предоставляет биржевые котировки для следующих фондовых бирж:
- 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
Зал славы
Kudos to patchstack and Wordfence Intelligence researchers for early reporting vulnerabilities!
Большая благодарность @flexer, @khunmax, @k2_1971 и @vijaleshk, которые тестировали альфа версии плагина, пока мы наконец не выпустили v3.0.0. Также важно упомянуть @eigood что подсказал мне AlphaVantage.co в качестве замены Google Finance.
Скриншоты
Установка
Чтобы установить Stock Ticker и выполнить первоначальную настройку, пожалуйста, следуйте инструкциям ниже
- Перейдите в
Плагины
->Добавить новый
- Найдите плагин
Stock Ticker
- Установите и активируйте
Stock Ticker
- Получите бесплатный API ключ с AlphaVantage.co
- В консоли WordPress перейдите в
Настройки
->Stock Ticker
- Вставьте в поле
AlphaVantage.co API Key
Alpha Vantage API ключ, что вы получили на предыдущем шаге (сверьтесь с этим скриншотом) - Вставьте в поле
All Stock Symbols
биржевые символы, что вы будете использовать на всём сайте в различных виджетах и шорткодах, разделяя символы запятой. Это поле используется для получения биржевых данных с AlphaVantage.co API через AJAX в фоновом режиме. Потому как AV имеет API для получения одновременно только одного биржевого символа, это может занять некоторое время. Обратите внимание, что в разделе настроек плагина есть поле для настройки используемых символов по умолчанию для шорткода. - Сохраните настройки и нажмите кнопку
Fetch Stock Data Now!
для первоначальной выборки биржевых данных в базу данных и подождите некоторое время, пока мы не получим все символы с AlphaVantage.co в первый раз. - Вставьте шорткод
[stock_ticker]
на страницу или запись, илиStock Ticker
виджет в желаемую область виджета.
Часто задаваемые вопросы
-
Как узнать, какие биржевые символы использовать?
-
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.
-
Как получить курс обмена валюты?
-
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
. -
Как получить необходимую стоимость акции от необходимой фондовой биржи?
-
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. -
Как получить описательный заголовок для курсов обмена?
-
Добавьте в
Custom Names
подпись биржевому символу без=X
, например:EURGBP;Euro (€) ⇨ British Pound Sterling (£)
-
Как добавить Stock Ticker header в файл темы?
-
Добавьте это в файл шаблона (вы также можете добавить пользовательские параметры для шорткода):
<?php echo do_shortcode('[stock_ticker]'); ?>
-
Как настроить вывод котировок?
-
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>
.Шаблон по умолчанию
%company% %price% %change% %changep%
, но вы можете это настроить на своё усмотрение, например:<span style="color:#333">%company%</span> <em>%price%</em> <strong>%change%</strong> %changep%
-
Я установил `%company%`, но вместо этого отображается символ компании
-
Обратите внимание, что Alpha Vantage не предоставляет название компании в передаваемых данных. Вам нужно будет установить название компании в поле Custom Names на странице настроек плагина.
-
Как устранить ошибку `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" } }
Отзывы
Участники и разработчики
«Stock Ticker» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:
УчастникиПеревести «Stock Ticker» на ваш язык.
Заинтересованы в разработке?
Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.
Журнал изменений
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