Stock Ticker

Описание

Простой и легко настраиваемый плагин для 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, отображаются только в информационных и образовательных целях и не должны рассматриваться в качестве инвестиционного совета.

Автор плагина 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 and sc for 0 000,00
  • decimals — 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 and 4
  • static — (boolean) to enable static unordered list instead scroling ticker set to 1 or true
  • prefill — (boolean) to start with pre-filled instead empty ticker set to 1 or true
  • duplicate — (boolean) if there is less items than visible on the ticker, set this to 1 or true to make it continuous
  • speed — (integer) tune speed of StockTicker block rendered by shortcode
  • class — 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
  • 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
  • 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

Зал славы

Большая благодарность @flexer, @khunmax, @k2_1971 и @vijaleshk, которые тестировали альфа версии плагина, пока мы наконец не выпустили v3.0.0. Также важно упомянуть @eigood что подсказал мне AlphaVantage.co в качестве замены Google Finance.

Скриншоты

  • Global plugin settings page (version 3.2.0)
  • Настройки виджетов
  • Stock ticker в действии
  • Stock ticker in Customizer > top Widgets top
  • Stock ticker in Customizer > sidebar Widgets
  • Stock ticker through Gutenberg Шорткод block

Установка

Чтобы установить Stock Ticker и выполнить первоначальную настройку, пожалуйста, следуйте инструкциям ниже

  1. Перейдите в Плагины -> Добавить новый
  2. Найдите плагин Stock Ticker
  3. Установите и активируйте Stock Ticker
  4. Получите бесплатный API ключ с AlphaVantage.co
  5. В консоли WordPress перейдите в Настройки -> Stock Ticker
  6. Вставьте в поле AlphaVantage.co API Key Alpha Vantage API ключ, что вы получили на предыдущем шаге (сверьтесь с этим скриншотом)
  7. Вставьте в поле All Stock Symbols биржевые символы, что вы будете использовать на всём сайте в различных виджетах и шорткодах, разделяя символы запятой. Это поле используется для получения биржевых данных с AlphaVantage.co API через AJAX в фоновом режиме. Потому как AV имеет API для получения одновременно только одного биржевого символа, это может занять некоторое время. Обратите внимание, что в разделе настроек плагина есть поле для настройки используемых символов по умолчанию для шорткода.
  8. Сохраните настройки и нажмите кнопку Fetch Stock Data Now! для первоначальной выборки биржевых данных в базу данных и подождите некоторое время, пока мы не получим все символы с AlphaVantage.co в первый раз.
  9. Вставьте шорткод [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

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 of 1 Euro = ? British Pounds
Please note, since mid-2020 AlphaVantage.co does not support anymore format EURGBP=X so use syntax without =X.

Как получить необходимую стоимость акции от необходимой фондовой биржи?

Enter symbol in format EXCHANGE:SYMBOL like LON:LLOY or SYMBOL.EXCHANGE like LLOY.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 access front-end page with appended parameter ?stockticker_purge_cache=1.

If that does not help, next try to increase Fetch Timeout option on general plugin settings and then visit frontend page with appended address parameter ?stockticker_purge_cache=1.

If you still experiencing issue, please contact us through support forum and don’t forget to provide URL to your website where you have inserted Stock Ticker.

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"
  }
}

Отзывы

09.06.2021 1 ответ
Not warm Poor plugins very bad
04.06.2019
После устранения проблем с автоматическим обновлением котировок плагин стал реально самодостаточным и хорошо реализованным. Автор всегда готов помочь в решении проблем. Жаль что нет поддержки локализации, так на 5+!
03.04.2019
The plugin alpha version (released on 2017.11.08) had prepared for WP multisite. I don't know why the option is canceled. The support is not effective. But this is a good plugin.
29.03.2019
Good solid plugin that does the job. Developer is quick to fix issues and respond to inquiries.
Посмотреть все 20 отзывов

Участники и разработчики

«Stock Ticker» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:

Участники

Перевести «Stock Ticker» на ваш язык.

Заинтересованы в разработке?

Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.

Журнал изменений

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 to Auto 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 to stock-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 to Auto Refresh Timeout
  • Improve: description for Cache Timeout option
  • Improve: add advised minimal cache timeout value, based on number of symbols in All Stock Symbols and Fetch 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 message Invalid 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 and Stock 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