Шаблон:Валютный курс/doc

Настоящая документация описывает совместную работу нескольких шаблонов.

Основной шаблон — {{Валютный курс}}, отвечающий за вывод данных в конечных статьях и списках (см. раздел «Примеры использования»).

Автоматически обновляемые шаблоны:

• {{Валютный курс/Данные}} — шаблон, где собираются текущие котировки из открытых источников, которые затем использует шаблон {{Валютный курс}};
• {{Валютный курс/Данные МВФ}} — шаблон, который отвечает за сбор данных по валютам, котируемым Международным валютным фондом, и транслирует их в шаблон {{Валютный курс/Данные}};
• {{Валютный курс/Данные ЕЦБ}} — шаблон, который отвечает за сбор данных по валютам, котируемым Европейским центральным банком, и транслирует их в шаблон {{Валютный курс/Данные}};
• {{Валютный курс/Данные ЦБ РФ}} — шаблон, который отвечает за сбор данных по валютам, котируемым Центральным банком Российской Федерации, и транслирует их в шаблон {{Валютный курс/Данные}}.
• {{Валютный курс/Данные CryptoCoinCharts}} — шаблон, который отвечает за сбор данных по криптовалютам и транслирует их в шаблон {{Валютный курс/Данные}}.

Вручную обновляемые шаблоны:

• {{Валютный курс/Фиксированные курсы}} — вспомогательный шаблон, где собираются данные о фиксированных курсах, используемых затем в шаблоне {{Валютный курс/Данные}};
• {{Валютный курс/Имена валют на сайте МВФ}} — вспомогательный шаблон, необходимый для работы шаблона {{Валютный курс/Данные МВФ}}.

Все вместе они позволяют отображать в статьях, списках и других шаблонах текущий (автоматически обновляемый не реже одного раза в сутки) валютный курс практически по всем существующим валютам, имеющим код ISO 4217.

Примеры использования

Примеры простого использования

Для вывода курса нужно знать коды ISO 4217 той валютной пары, чье соотношение необходимо вывести.

Шаблон	Результат	Примечания
Шаблон:S		1 USD = RUB
Шаблон:S		1 RUB = USD
Шаблон:S		1 EUR = RUB
Шаблон:S		1 RUB = EUR
Шаблон:S		1 GBP = RUB
Шаблон:S		1 RUB = GBP
Шаблон:S		1 EUR = USD
Шаблон:S		1 USD = EUR

Примеры использования с множителем и параметром «дата»

Шаблон позволяет выводить дату, которой соответствуют данные, а также использовать множитель для сокращения числа нулей.

Шаблон	Результат	Примечания
Шаблон:S		1 RUB = GBP
Шаблон:S		1 RUB = GBP
Шаблон:S		10 RUB = GBP
Шаблон:S		100 RUB = GBP
Шаблон:S	Шаблон:S	Дата, которой соответствуют данные

Примеры, когда код валюты неизвестен шаблонам или данные о ней в шаблонах отсутствуют

Если валюта неизвестна шаблону (сведения о ней отсутствуют в шаблонах {{Валютный курс/Данные}} и {{Валютный курс/Фиксированные курсы}}), то результат будет пустым.

Шаблон	Результат	Примечания
Шаблон:S		Результат пустой
Шаблон:S		Результат пустой
Шаблон:S		Результат пустой
Шаблон:S		Результат пустой
Шаблон:S		Дата для неизвестной валюты также будет пустой
Шаблон:S		Дата для неизвестной валюты также будет пустой

См. также примеры использования в таких статьях, списках и шаблонах, как

• Список существующих валют
• Режим валютного курса
• {{Валюта}}

Техническая реализация

Порядок взаимодействия шаблонов

Курсы валютных пар рассчитываются автоматически на основе данных, собираемых и обновляемых роботом Шаблон:U из трёх источников (см. раздел «Источники данных»):

• котировки Международного валютного фонда;
• котировки Европейского центрального банка;
• котировки Центрального банка Российской Федерации.

Ручное изменение данных не требуется и не рекомендуется.

Курсы для валют, имеющих жёсткую привязку к другим валютам, автоматически вычисляются как кросс-курсы на основе вручную прописанных статических данных шаблона {{Валютный курс/Фиксированные курсы}} и динамических данных из шаблона {{Валютный курс/Данные}}. В случае изменения курсового режима или значения фиксированного курса, необходимо внести соответствующие изменения в шаблон {{Валютный курс/Фиксированные курсы}}.

Параметры выводимых курсов и отказ от ответственности

Выводимые настоящими шаблонами курсы основаны на открытых источниках и транслируются с округлением до четырёх значимых цифр. Они могут отличаться от официальных котировок, установленных центральными банками, они могут отличаться от курсов, транслируемых другими источниками информации. Не используйте их в случаях, когда ошибка может причинить вред или нанести ущерб.

Вопросы и предложения

В разработке шаблонов принимали участие несколько человек, поэтому для вопросов и предложений рекомендуется использовать страницу обсуждения шаблона «Валютный курс».

Не рекомендуется поднимать вопросы, обсуждавшиеся на страницах «Шаблон:Ф» и «Обсуждение шаблона:Валютный курс», без достаточных на то оснований и появления новых весомых аргументов, которые не были рассмотрены участниками.

Источники данных

Шаблон «Валютный курс/Данные»

Источниками данных для работы шаблонов, отвечающих за вывод валютных курсов являются:

• Международный валютный фонд — [1];
• Европейский центральный банк — [2];
• Центральный банк Российской Федерации — [3].

К сожалению, используемые источники на дают полного набора валютных пар. Мы будем благодарны, если вы предложите источник с лучшими характеристиками.

Требования к источнику информации следующие — он должен:

1. Предоставлять информацию об актуальных курсах по соизмеримому (не менее 100 валют) или большему числу валют с частотой обновления не реже одного раза в неделю.
2. Предоставлять данные по лицензиям, используемым в Википедии (Creative Commons Attribution/Share-Alike 3.0 и GFDL).
3. В полной мере соответствовать требованиям, предъявляемым к источникам, которые принято использовать для подготовки статей «Википедии».
4. Предоставлять удобный интерфейс для автоматического забора данных.

Шаблон «Валютный курс/Фиксированные курсы»

Данные шаблона {{Валютный курс/Фиксированные курсы}} (фиксированные курсы, а также курсы с очень узким коридором) приведены со ссылкой на сайты эмитентов или другие языковые разделы «Википедии», прежде всего английский. Данные источники не вполне удобны для автоматического отслеживания, поэтому мы будем признательны, если вы предложите более удачный источник.

Текущие фиксированные курсы

Валюта	Код ISO 4217	Значение фиксированного курса	Источник
По отношению к доллару США (USD)
Панамский бальбоа	PAB	1 USD = PAB	en:Panamanian balboa
Сальвадорский колон	SVC	1 USD = SVC	Сайт эмитента
Восточно-карибский доллар	XCD	1 USD = XCD	Сайт эмитента
Гонконгский доллар	HKD	1 USD = HKD	Сайт эмитента
Франк Джибути	DJF	1 USD = DJF	Сайт эмитента
Арубанский флорин	AWG	1 USD = AWG	en:Aruban florin
Багамский доллар	BSD	1 USD = BSD	Сайт эмитента
Бахрейнский динар	BHD	1 USD = BHD	Сайт эмитента
Барбадосский доллар	BBD	1 USD = BBD	Сайт эмитента
Белизский доллар	BZD	1 USD = BZD	Сайт эмитента
Эритрейская накфа	ERN	1 USD = ERN	en:Eritrean nakfa
Доллар Тринидада и Тобаго	TTD	1 USD = TTD	en:Trinidad and Tobago dollar
Дирхам ОАЭ	AED	1 USD = AED	en:United Arab Emirates dirham
Иорданский динар	JOD	1 USD = JOD	en:Jordanian dinar
Ливанский фунт	LBP	1 USD = LBP	en:Lebanese pound
Нидерландский антильский гульден	ANG	1 USD = ANG	Сайт эмитента
Оманский риал	OMR	USD = 1 OMR	en:Omani rial
Катарский риал	QAR	1 USD = QAR	en:Qatari riyal
Саудовский риял	SAR	1 USD = SAR	en:Saudi riyal
Боливар фуэрте	VEF	1 USD = VEF	CIA Factbook
Доллар Каймановых островов	KYD	USD = 1 KYD	en:Cayman Islands dollar
Бермудский доллар	BMD	1 USD = BMD	en:Bermudian dollar
Кубинское конвертируемое песо	CUC	1 USD = CUC	Сайт эмитента
Доллар того же дня	USS	1 USD = USS
Доллар следующего дня	USN	1 USD = USN
По отношению к евро (EUR)
Боснийская конвертируемая марка	BAM	1 EUR = BAM	en:Bosnia and Herzegovina convertible mark
Болгарский лев	BGN	1 EUR = BGN	Сайт эмитента
Литовский лит	LTL	1 EUR = LTL	Сайт эмитента
Латвийский лат	LVL	1 EUR = LVL	en:Latvian lats
Датская крона	DKK	1 EUR = DKK	en:Danish krone
Эскудо Кабо-Верде	CVE	1 EUR = CVE	en:Cape Verdean escudo
Франк Комор	KMF	1 EUR = KMF	en:Comorian franc
Франк КФА BEAC	XAF	1 EUR = XAF	en:Central African CFA franc
Франк КФА BCEAO	XOF	1 EUR = XOF	en:West African CFA franc
Французский тихоокеанский франк	XPF	1 EUR = XPF	Сайт эмитента
По отношению к фунту стерлингов (GBP)
Фунт Фолклендских островов	FKP	1 GBP = FKP	en:Falkland Islands pound
Фунт Острова Мэн	(IMP)	1 GBP = IMP	en:Manx pound
Гернсийский фунт	(GGP)	1 GBP = GGP	en:Guernsey pound
Гибралтарский фунт	GIP	1 GBP = GIP	en:Gibraltar pound
Джерсийский фунт	(JEP)	1 GBP = JEP	en:Jersey pound
Фунт Святой Елены	SHP	1 GBP = SHP	en:Saint Helena pound
По отношению к южноафриканскому рэнду (ZAR)
Лоти Лесото	LSL	1 ZAR = LSL	en:Lesotho loti
Намибийский доллар	NAD	1 ZAR = NAD	en:Namibian dollar
Свазилендский лилангени	SZL	1 ZAR = SZL	en:Swazi lilangeni
По отношению к индийской рупии (INR)
Бутанский нгултрум	BTN	1 INR = BTN	en:Bhutanese ngultrum
Непальская рупия	NPR	1 INR = NPR	Сайт эмитента
По отношению к другим валютам
Южносуданский фунт	SSP	1 SDG = SSP
Брунейский доллар	BND	1 SGD = BND	Сайт эмитента
Патака Макао	MOP	1 HKD = MOP	Сайт эмитента
Расчётная единица ADB	XUA	1 XDR = XUA	Учредительный договор ADB. — ч. II, ст. 5, п. 1b
Доллар Тувалу	(TVD)	1 AUD = TVD

Курсы, зафиксированные при переходе на евро

Валюта	Код ISO 4217	Значение фиксированного курса	Источник
Австрийский шиллинг	ATS	1 EUR = ATS
Бельгийский франк	BEF	1 EUR = BEF
Немецкая марка	DEM	1 EUR = DEM
Ирландский фунт	IEP	1 EUR = IEP
Испанская песета	ESP	1 EUR = ESP
Итальянская лира	ITL	1 EUR = ITL
Люксембургский франк	LUF	1 EUR = LUF
Нидерландский гульден	NLG	1 EUR = NLG
Португальский эскудо	PTE	1 EUR = PTE
Финляндская марка	FIM	1 EUR = FIM
Французский франк	FRF	1 EUR = FRF
Греческая драхма	GRD	1 EUR = GRD
Словенский толар	SIT	1 EUR = SIT
Кипрский фунт	CYP	1 EUR = CYP
Мальтийская лира	MTL	1 EUR = MTL
Словацкая крона	SKK	1 EUR = SKK
Эстонская крона	EEK	1 EUR = EEK
Ватиканская лира	VAL	1 ITL = VAL (1 EUR = VAL)
Монегасский франк	MCF	1 FRF = MCF (1 EUR = MCF)
Санмаринская лира	SML	1 ITL = SML (1 EUR = SML)

Прочие валюты, чей курс близок к фиксированному

• GYD: 1 USD = GYD
• VND: 1 USD = VND
• HNL: 1 USD = HNL
• TMT: 1 USD = TMT
• STD: 1 USD = STD
• KHR: 1 USD = KHR
• IQD: 1 USD = IQD
• JMD: 1 USD = JMD
• LAK: 1 USD = LAK
• MWK: 1 USD = MWK
• SRD: 1 USD = SRD
• NIO: 1 USD = NIO
• LYD: 1 XDR = LYD
• MKD: 1 EUR = MKD

Копирование шаблона в другой вики-проект

Для того, чтобы шаблон и механизм обновления заработали в другом проекте нужно выполнить следующие действия:

1. Скопируйте в проект следующие шаблоны:
   • {{Валютный курс}}
   • {{Валютный курс/Данные}}
   • {{Валютный курс/Фиксированные курсы}}
   • минимум один из {{Валютный курс/Данные МВФ}}, {{Валютный курс/Данные ЕЦБ}}, {{Валютный курс/Данные ЦБ РФ}}, {{Валютний курс/Дані НБУ}}, {{Валютный курс/Данные CryptoCoinCharts}}
2. В копии шаблона {{Валютный курс/Данные}} скорректируйте набор источников и их порядок. Например, для ukwiki вместо данных ЦБ РФ используются данные НБУ.
3. Укажите копии шаблонов с данными в элементах d:Q18955972, d:Q19361272, d:Q18646447, d:Q28940816, d:Q28955530. Робот Шаблон:U пытается обновить все шаблоны указанные в этих элементах.
4. Получите для робота Шаблон:U флаг бота в соответствующем проекте.

После этого нужно подождать, когда робот Шаблон:U обновит шаблоны в ruwiki. Если одновременно с этим робот не обновил шаблоны в вашем проекте, то что-то пошло не так. Проверьте, всё ли в порядке с элементами на Викиданных. Убедитесь, что у робота есть флаг бота. Если всё в порядке, но шаблоны так и не обновляются, то обратитесь к участнику Шаблон:U.

Если нужно использовать ещё какие-либо источники по валютам, то пожалуйста найдите открытый источник актуальных данных. Крайне желательно, чтобы данные были в машиночитаемом формате (JSON, XML, CSV и т. п.) и были предназначены для использования внешними потребителями данных. Иначе механизм будет работать нестабильно. Пример источника: http://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml После нахождения такого источника обратитесь к участнику Шаблон:U.

How to copy the template to another wiki-project

Data update procedure supports multiple projects. Please make next steps to enable it in another project:

1. Copy templates:
   • {{Валютный курс}}
   • {{Валютный курс/Данные}}
   • {{Валютный курс/Фиксированные курсы}}
   • at least one of {{Валютный курс/Данные МВФ}}, {{Валютный курс/Данные ЕЦБ}}, {{Валютный курс/Данные ЦБ РФ}}, {{Валютний курс/Дані НБУ}}, {{Валютный курс/Данные CryptoCoinCharts}}
2. Configure data sources and order in {{Валютный курс/Данные}} template copy.
3. Add links to new templates to elements d:Q18955972, d:Q19361272, d:Q18646447, d:Q28940816, d:Q28955530. Bot Шаблон:U is trying to update all templates in these elements.
4. Request bot flag for user Шаблон:U in your project.

After this please wait for data update in ruwiki. Bot Шаблон:U must update the templates in your project too. Check Wikidata elements and KrBot rights in case some troubles. Request assistance of Шаблон:U if needed.

Additional open datasources can be added too. The source must have some public API or machine-readable data format (JSON, XML, CSV and etc.) The data request protocol must be adopted for external usage. Source example: http://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml Please contact to Шаблон:U for implementing data copy algorithm.

См. также

• {{Обменный курс}}