Open Currency Converter
🚀 Если у вас есть желание конвертировать валюту «на лету» в тексте сообщения или страницы, то этот плагин для вас! Его можно бесплатно загрузить, бесплатно использовать и бесплатно от рекламы - если вы думаете, что за что-то нужно платить, вы делаете это неправильно! Итак, допустим, у вас есть британский сайт, и вы будете ссылаться на валюты в фунтах стерлингов. Тем не менее, большинство посетителей из США, поэтому вы, возможно, захотите также показать долларовый эквивалент. Используя этот плагин, вы можете сделать это, не выполняя преобразование, а затем повторно посещать его в будущем, чтобы учесть изменения преобразования. Ключевые особенности:… Нет необходимости самостоятельно обновлять курсы валют - данные извлекаются из API с открытым исходным кодом. Поддерживается более 170 валют. Простой в использовании шорткод для встраивания непосредственно в ваши сообщения и страницы. Функция PHP для тех людей, которые хотят добавить функции в свои тема Результаты можно кэшировать, сокращая ресурсы и улучшая шаблон ответа, позволяющий контролировать вывод результатов. Экран администрирования, позволяющий определять значения по умолчанию и просматривать текущие обменные курсы. И многое, многое другое! Иконография любезно предоставлена очень талантливым Янки Ратодом ♥ ️ 👉 Пожалуйста, посетите страницу Github, чтобы узнать о последних разработках кода, запланированных улучшениях и известных проблемах 👈 Начало работы 🔑 Получение ключа приложения Открытый конвертер валюты получает свои данные с веб-сайта Open Exchange Rates (который является не связан ни с этим плагином, ни с разработчиком). Для работы этого сайта необходимо указать ключ приложения. Это сделано для предотвращения чрезмерного использования системы обмена и предоставления дополнительных функций пользователям, которые хотят за них платить. Наличие премиум-плана не добавляет никаких дополнительных функций к этому плагину и не является обязательным требованием. Чтобы получить ключ приложения… Зарегистрируйтесь на сайте Open Exchange Rates - эта ссылка приведет вас к бесплатному варианту, но для этого сайта требуется личная информация. Теперь вы должны быть на экране своей учетной записи. Нажмите на опцию «App IDs» в боковом меню. Идентификатор приложения должен быть указан справа - скопируйте этот идентификатор. Вернитесь к администратору вашего сайта и выберите меню «Настройки» -> «Открыть валюту». Вставьте идентификатор приложения в эквивалентное поле вверху экрана настроек. Нажмите кнопку «Сохранить изменения». Использование шорткода Для добавления на ваш сайт просто используйте шорткод [convert]. Например… [convert number = 49,99 from = "gbp" to = "usd"] Это приведет к преобразованию 49,99 фунтов стерлингов в доллары США. ⚠️ Отказ от ответственности Данные обменного курса предоставляются бесплатно через проект Open Source Exchange Rates. Его точность и доступность никогда не гарантируются, и нет никаких гарантий. 🖥 Экран параметров. После активации подключаемого модуля появятся два новых экрана администрирования. Открытая валюта - отображается в разделе «Настройки» и позволяет указать настройки по умолчанию для любых курсов обмена валют. Обменные курсы. В меню «Инструменты» отображаются текущие курсы обмена и список всех действующих кодов обмена. plugin настоятельно рекомендуется просмотреть экран Параметры и при необходимости изменить любые значения. Вам также необходимо будет зарегистрироваться и ввести ключ приложения, прежде чем конверсии начнут работать. 🗜 Использование шорткода Шорткод '[convert]' имеет следующие параметры, которые вы можете указать… number - число, которое вы хотите конвертировать из одной валюты в другую. Это требуется от - кода валюты, из которой вы хотите выполнить конвертацию (список допустимых кодов см. В параметрах администратора). Если вы не укажете это значение, будет использоваться значение по умолчанию, указанное на экране параметров: - Код валюты, в которую вы хотите преобразовать (см. Параметры администратора для получения списка допустимых кодов). Если вы не укажете это значение, будет использоваться значение по умолчанию из экрана параметров. dp - Сколько десятичных знаков должно быть в выводе. Это должно быть число или слово «совпадение». Последнее является значением по умолчанию и будет означать, что вывод будет соответствовать количеству десятичных знаков, которое было в числе. шаблон - см. более поздний раздел «Использование шаблонов» для получения дополнительной информации. Пример использования: [convert number = 49.99 from = "gbp" to = "usd"] Это позволит преобразовать 49,99 фунтов стерлингов из Великобритании в доллары США и вывести результат до 2 знаков после запятой. [convert number = 50 from = "usd" to = "gbp"] Это приведет к преобразованию 50 долларов США в фунты Великобритании и выдаче результата без десятичных знаков. Если преобразование не может быть выполнено, вместо этого будет выведено соответствующее сообщение об ошибке. Если вы хотите подавить эти сообщения, вам нужно использовать шаблон (см. Следующий раздел об этом) - в этом случае в случае ошибки вывод не будет. 🧩 Использование шаблонов Параметр шаблона позволяет указать другую информацию, которая будет выводиться вместе с результатом преобразования. Ни один из шаблонов не будет выводиться при возникновении какой-либо ошибки, включая сообщения об ошибках, что позволяет подавить любой текст преобразования в случае возникновения проблемы. Текст шаблона должен включать% result% там, где вы хотите, чтобы вывод отображался. Вот пример ... Розничная цена составляет $ 49,99 [преобразовать число = 50 из = «использовать» в = «пробел» шаблон = «(прибл.% Результат%) фунт стерлингов»]. Обычно это выводит такой результат, как… Розничная цена цена составляет 49,99 долларов США (приблизительно 79,11 фунтов стерлингов). Однако, если произойдет ошибка, она будет напечатана как… Розничная цена составляет 49,99 доллара США. Вы также можете включить шаблон между открывающими и закрывающими тегами шорткода. Например… Розничная цена составляет 49,99 доллара США [ convert number = 50 from = «use» to = «gap»] (прибл.% result% GBP) [/ convert].
Использование вызова функции
Если вы хотите выполнить конвертацию валюты в своей теме , а не в сообщении или на странице, вы можете использовать вызов функции PHP. Имя функции - get_conversion, и она вернет результат обратно. Все параметры шорткода действительны, за исключением шаблона, который не является обязательным. указаны в любом порядке и разделены амперсандом. Вам не следует добавлять кавычки вокруг каждого значения параметра, как это делается с коротким кодом. Например…🌍 Глобальные переменные преобразования
Для использования разработчиками были добавлены 2 глобальные переменные, которые, если они назначены в коде вашего сайта, переопределят коды преобразования. Переменные global_convert_from и global_convert_to. Это полезно, если, скажем, у вас есть несколько версий сайта на разных языках - затем вы можете назначить эти глобальные переменные в зависимости от того, какой сайт просматривается, и вся валюта будет конвертирована на основе этих настроек. Они будут переопределять только экран параметров, а не конкретные параметры, указанные с помощью шорткода или вызова функции.Автор: David Artiss
Версия: 1.4.5
Последнее обновление: 2021-07-15 2:38pm GMT