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

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

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

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

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

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

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

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

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

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

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

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

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

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

В настоящее время курсы большинства валютных пар рассчитываются автоматически на основе данных из шаблона {{Валютный курс/Данные}}, которые периодически обновляются роботом KrBot из одобренного участниками источника. Ручное изменение данных не требуется и не рекомендуется.

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

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

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

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

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

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

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

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

— About the Open Exchange Rates API

Выбор источника информации был произведён по результатам обсуждения — Форум/Вниманию участников#Шаблон Валюта. Участники не пришли к согласованной позиции по его авторитетности, однако признали допустимость его использования на данном этапе по причине отсутствия адекватной замены. Поэтому мы будем благодарны, если вы предложите источник с лучшими характеристиками.

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

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

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

См. также

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

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