Currency Field
Enables you to have a currency field in your publish screen.
The template tag of the fields using this plugin currently outputs a simple numeric value with the associated currency.
licence: commercial
price: $4,99
version: 2.1.0
author: Selimcan Sakar
qc: Can Berkol
last updated: 10.01.2011
NOTICE
This field type makes use of Google Calculator. & Yahoo Financed Currency Converter
Installation
For the field type to work flawlessly, you need to follow all the steps carefully.
Download The Field Type You can download this field type from the BUY & DOWNLOAD section of this document.
Unpack Unpack the compressed file that you have downloaded.
Upload Files to Your Server
Once you have unpacked your compressed file, you will see a folder named bbr_currencyfield.Upload the folder into your Expression Engine 2.x\‘s system/expressionengine/third_party folder.
Install Field Type Login to your Expression Engine 2.x. control panel and go to Add-ons > Fieldtypes.
You will see Currency Field in the fieldtypes list. Click on Install link.
Setup Your Field Currently there is no global settings for this field type. However; you need to setup the individual settings when you create a new field using this field type.
Currently there are only one custom setting.
Select Currency:
You have to select the currencies in which the users will input the amount.
Available Currencies:
- AED: United Arab Emirates Dirham
- ANG: Netherlands Antilles Guildes
- ARS: Argentine Pesos
- AUD: Australian Dollars
- AWG: Aruba Florine
- BBD: Barbados Dollar
- BGN: Bulgarian Levs
- BHD: Bahrain Dinars
- BMD: Bermuda Dollar
- BND: Brunei Dollars
- BOB: Bolvian Bolivianos
- BRL: Brazil Reails
- BSD: Bahamian Dollar
- BWP: Botswana Pula
- CAD: Canadian Dollars
- CHF: Swiss Francs
- CLP: Chilean Pesos
- CNY: Chinese Yuan
- COP: Colombian Pesos
- CRC: Costa Rican Colones
- CZK: Czech Koruny
- DKK: Danish Kroner
- DOP: Dominican Pesos
- DZD: Algerian Dinars
- EEK: Estonian Kroons
- EGP: Egyptian Pounds
- EUR: Euro
- FJD: Fiji Dollars
- GBP: British Pounds
- KRW: Gibraltar Pound
- HKD: Hong Kong Dollars
- HNL: Honduran Lenpiras
- HRK: Croatian Kune
- HUF: Hungarian Forints
- IDR: Indonesian Ruphias
- INR: Indian Rupees
- ILS: Israeli Shekels
- ISK: Iceland Kronur
- JMD: Jamaican Dollars
- JOD: Jordanian Dinars
- JPY: Japanese Yen
- KES: Kenyan Shillings
- KHR: Cambodian Riel
- KRW: South Korean Won
- KYD: Cayman Islands Dollars
- KWD: Kuwaiti Dinars
- KZT: Kazakh Tenge
- LAK: Lao Kip
- LBP: Lebanese Ponds
- LKR: Sri Lankan Rupees
- LTL: Lithuanian Litai
- LVL: Latvian Lat
- MAD: Moraccon Denari
- MDV: Moldovan Lei
- MKD: Macedonian Dirham
- MMK: Myanmar Kyat
- MNT: Mongolian Tugrik
- MUR: Marutian Rupees
- MXN: Mexican Pesos
- MYR: Malaysian Riggits
- NAD: Namibian Dollars
- NGN: Nigerian Naira
- NIO: Nicaraguan Cordubas
- NOK: Norwegian Kroner
- NPR: Nepalese Rupees
- NZD: New Zealand Dollars
- OMR: Omani Riyals
- PEN: Peruvian Nuevos Soles
- PGK: Papua New Guinean Kina
- PHP: Philippine Pesos
- PKR: Pakistan Rupees
- PLN: Polish Zloty
- PYG: Paraguayan Guaranies
- QAR: Quatar Riyals
- RON: Romanian Leu
- RSD: Serbian Dinars
- RUB: Russian Rubles
- SAR: Saudi Riyals
- SBD: Solomon Islands Dollar
- SCG: Seychelles Rupees
- SEK: Swedish Kronor
- SGD: Singapore Dollars
- SLL: Sierra Leonean Leones
- SVC: Salvadoran Colones
- THB: Thai Baht
- TND: Tunisian Dinar
- TOP: Tonga Paang
- TRY: Turkish Lira
- TTD: Trinidad Dollars
- TWD: Taiwan Dollars
- TZS: Tanzanian Shillings
- UAH: Ukrainian Grivnas
- UGX: Ugandan Shillings
- USD: U.S. Dollars
- UYU: Uruguayan Pesos
- UZS: Uzbekistani Sum
- VEB: Venezuelan Bolivars
- VND: Vietnamese Dong
- VUV: Vanuatu Vatu
- WST: Samoa Tala
- XPF: Pacific Franc
- YER: Yemeni Rials
- ZAR: South African Rands
- ZMK: Zambia Kwacha
Uninstallation
In order uninstall the field type login to your Expression Engine 2.x. control panel and go to Add-ons > Fieldtypes. Clieck on Uninstall link for Currency Field.
After you uninstall the software from EE 2.x control panel, you can safely delete the bbr_currencyfield folder located in your EE\‘s third_party folder.
Usage
Basic usage: {fieldname} returns the amount, nicely formatted: 1,502 Turkish Liras {fieldname format=“off” show_currency=“false”} returns simply the amount: 1502
Converting: {fieldname to=“USD”} returns the amount in target currency: 1,000 U.S. Dollars {fieldname to=“USD” show=“original”} returns the amount in target currency with the amount in the original currency: 1,000 U.S. Dollars (1,502 Turkish Liras)
Rounding: {fieldname to=“USD” round=“2”} returns the amount in target currency with the amount in the original currency, rounded by 2: 1,000 U.S. Dollars (1,502.30 Turkish Liras)
Using substitute currency names: {fieldname to=“USD” round=“2” substitute=“TRY:TL,USD:$”} returns the amount in target currency with the amount in the original currency, rounded by 2, and it replaces the currency tag USD with $, TRY with TL: 1,000 $ (1,502.30 TL)
Positioning: {fieldname to=“USD” position=“before”} returns the currency and the amount, the currency being placed before the amount: U.S Dollars 1,000.
Currency tags: {fieldname to=“USD” in=“currency_tags”} returns the amount and the currency tag: 1,000 USD.
Support
Our clients are our priority. Nevertheless, you may contact us at support@biberltd.com.
BUY & DOWNLOAD
- You may not copy / distribute / redistribute / sell / resell / reproduce / transfer the Software to any third party.
- You may not sell or rent the Software or portions thereof.
- You may not use the Software in violation of laws of the Republic of Turkiye, United Stats or other international law or regulations.
- Each purchase is valid for one installation of Expression Engine 2.x. You need only one license for MSM module
- The software will be sent to you within 8 hours of your purchase. The software will be send as an attachment within a .zip file from support@biberltd.com
- All copyright and proprietary notices and logos in the Control Panel and within the Software files must remain intact.
- You may make copies of the Software for back-up purposes, provided that you reproduce the Software in its original form and with all proprietary notices on the back-up copy.
- You may alter, modify, or extend the Software for your own use, or commission a third-party to perform modifications for you, but you may not resell, redistribute or transfer the modified or derivative version without prior written consent from Biber Bilişim Teknolojileri ve Dış Ticaret Ltd. Şti.
- Technical support is available only through support@biberltd.com. No representations or guarantees are made regarding the response time in which support questions are answered.
- You may test the Software for 10 days risk-free. If you do not like the Software you may apply for a refund. In case of refund you need to irrevesible destroy the software and never use it in any of your projects. All transaction fees will be applied to deducted from your refund.
- You agree to indemnify and hold harmless Biber Bilişim Teknolojileri ve Dış Tic. Ltd. Şti. for any third-party claims, actions or suits, as well as any related expenses, liabilities, damages, settlements or fees arising from your use or misuse of the Software, or a violation of any terms of this license.
- THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, WARRANTIES OF QUALITY, PERFORMANCE, NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. FURTHER, ELLISLAB INC. DOES NOT WARRANT THAT THE SOFTWARE OR ANY RELATED SERVICE WILL ALWAYS BE AVAILABLE.
- YOU ASSUME ALL RISK ASSOCIATED WITH THE INSTALLATION AND USE OF THE SOFTWARE. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS OF THE SOFTWARE BE LIABLE FOR CLAIMS, DAMAGES OR OTHER LIABILITY ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE. LICENSE HOLDERS ARE SOLELY RESPONSIBLE FOR DETERMINING THE APPROPRIATENESS OF USE AND ASSUME ALL RISKS ASSOCIATED WITH ITS USE, INCLUDING BUT NOT LIMITED TO THE RISKS OF PROGRAM ERRORS, DAMAGE TO EQUIPMENT, LOSS OF DATA OR SOFTWARE PROGRAMS, OR UNAVAILABILITY OR INTERRUPTION OF OPERATIONS.
Change Log
v.2.1.0
- Added Yahoo Finance API support for some currencies.
- Cambodian Riel, Lao Kip, Mongolian Tugrik, Myanmar Kyat, Solomon Island Dollars, Vanuatu Vatu, Tonga Paang, Latvian Lat, Aruba Florine, Bahamian Dollar, Barbados Dollar, Bermuda Dollar, Gibraltar Pound, Pacific Franc added.
v.2.0.0
- Using substitute currency names or currency tags, rounding and the positioning of the currency names.
v.1.0.0
- Initial release.
Index | ExpressionEngine | Field Types
