“TCMB Converter” Documentation by “Ozibal” v1.0


“TCMB Converter”

Created: 14/2/2017
By: Ozibal
Email: ozibal@gmail.com

Banner

Thank you for purchasing my plugin. If you have any problems beyond the scope of this help file, please do not hesitate to contact me here. Thanks so much!

Table of Contents

  1. How does it work
  2. Which language support is available ?
  3. Installation
  4. Settings
  5. CSS


A) How does it work ? - top

Banner

This plugin convert 19 different currencies

  1. TRY => TURKISH LIRA
  2. USD => US DOLLAR
  3. AUD => AUSTRALIAN DOLLAR
  4. DKK => DANISH KRONE
  5. EUR => EURO
  6. GBP => POUND STERLING
  7. CHF => SWISS FRANK
  8. SEK => SWEDISH KRONA
  9. CAD => CANADIAN DOLLAR
  10. KWD => KUWAITI DINAR
  11. NOK => NORWEGIAN KRONE
  12. SAR => SAUDI RIYAL
  13. JPY => JAPENESE YEN
  14. BGN => BULGARIAN LEV
  15. RON => NEW LEU
  16. RUB => RUSSIAN ROUBLE
  17. IRR => IRANIAN RIAL
  18. CNY => CHINESE RENMINBI
  19. PKR => PAKISTANI RUPEE

Data Source
The daily exchange rate data is taken from the Central Bank of the Republic of Turkey (TCMB) website
Data source : http://www.tcmb.gov.tr/kurlar/today.xml
Data Processing :1 USD = X TRY ==> X TRY = ? EUR

Ps: This process produces minor differences

ShortCode and Widget :
The exchange rate information used for Widget and ShortCode is taken from the source site at 15-minute intervals and saved in the database. You can use the parameters specified for ShortCode. You can use it on your own pages and in your forms. With Smart ShortCode, you can create simple converted currencies and add them to places you see fit.

For example :
You can view converted currencies on the price list you create.
You can price your services or products with different currencies.

Woocommerce :
The conversion plugin used on Woocommerce pages takes data from the source site instantly. For this reason very minimal delays can be experienced.


B) Which language support is available ? - top

Full language support is available. English and Turkish language support is included in the package. If you help me, I can translate in your language with a little text.

Please mail me here for this.

            "TURKISH LIRA"
            "US DOLLAR"
            "AUSTRALIAN DOLLAR"
            "DANISH KRONE"
            "EURO"
            "POUND STERLING"
            "SWISS FRANK"
            "SWEDISH KRONA"
            "CANADIAN DOLLAR"
            "KUWAITI DINAR"
            "NORWEGIAN KRONE"
            "SAUDI RIYAL"
            "JAPENESE YEN"
            "BULGARIAN LEV"
            "NEW LEU"
            "RUSSIAN ROUBLE"
            "IRANIAN RIAL"
            "CHINESE RENMINBI"
            "PAKISTANI RUPEE"
            "Convert 19 different currencies."
            "More details and documentation page"
            "! Update Error : No Data … "
            "On the product pages, on the cart page and on the order page, the local currency converts to the 16 required currencies."
            "WooCommerce Product Pages"
            "WooCommerce Cart Page"
            "WooCommerce Order Page" 
            "Title"
            "Buying"
            "Selling"
            "Settings"
            "CONVERT CURRENCY"
        

C) Installation - top

With Ftp
  1. Unzip the compressed file. (tcmb-converter.zip)
  2. Copy the plugin folder (tcmb-converter) to the / wp-content / plugins / folder.
With Admin Panel(wp-admin)
  1. Go to Plugins / Add New menu
  2. Click ‘Install Plugin’ button
  3. Click ‘Choose File’ button
  4. Choose compressed file (tcmb-converter.zip) and click “install now’ button.

Activate the TCMB Converter plugin from menu.
You can customize the TCMB Converter plugin on the menu.

Note: If other versions of the plugin were previously installed, uninstall it first.


D) Settings - top

tcmbconverter-settings

You can adjust the plugin settings in the "TCMB Converter" section tab.

Plugin settings consist of three parts.

  1. ShortCode
  2. Widget
  3. Woocommerce

ShortCode
tcmbconvert-shortcode The ShortCode view is shown on the screen. With the first select, you can also select the local currency rate to be converted with the second select. When you save your selection, your screen will be refreshed to show the ShortCode created with the cycle end.

Parameter 1 = Simple / Flag
Parameter 2 = Multiplier
Parameter 3 = Local rate tag
Parameter 4 = Currency tag

[TCMBConverter]
This shows converted currencies with style.
[TCMBConverter Simple]
This shows converted currencies with simple.
[TCMBConverter Flag]
This shows converted currencies with flag.
[TCMBConverter Simple 33.5]
This converted currencies multiplies it by 33.5 and shows simple.
[TCMBConverter Simple 125 USD EUR ]
This USD currency converts the EUR, multiplies it by 125 and displays it as a plain number.
[TCMBConverter Flag 77.4 EUR SEK ]
TThis EUR currency converts the SEK, multiplies it by 77.4 and displays it with flag.

Widget
tcmbconvert-widget Selected currencies are transferred to the table and prepared for the widget.

Buying and selling figures transferred to the table are for the exchange rate in the selected parent (the first choice in the ShortCode field).

The main exchange you chose is "Turkish Lira", the short code "TRY" is displayed in the green box at the beginning of the table. Buying and selling figures are brought to the lines according to this main rule.

Woocommerce
The ShortCode view is shown on the screen. With the first select, you can also select the local currency rate to be converted with the second select. When you save your selection, your screen will be refreshed to show the ShortCode created with the cycle end.

If you are using the Woocommerce online sales plugin, you can keep your products instantly converted to 19 different currencies.

This conversion is instantaneous and woocommerce does not change product or basket prices. It is designed to allow visitors to see their product or basket totals for the desired currency.

Setup information is instantly drawn from the source site and displayed on the screen. Product price on the product page, total amount on the basket and payment page. It also shows how many 1 currency corresponds to the currency to be converted for each cycle.

Note: Price seperator and decimal settings are taken from woocommerce settings. The requested changes are available in the woocommerce settings section.


E) CSS - top

The plugin uses the following CSS classes.

            .tcmbconverter_shortcode { //
                font-size: 18px;
                padding: 5px;
            }
            .tcmbconverter_from{
                vertical-align: super;
                font-size: 60%;
                font-weight: lighter;
                background-color: gray;
                color: white;
                border-radius: 10%;
                -webkit-box-shadow: inset 1px 1px 2px 0px rgba(204,204,204,1);
                -moz-box-shadow: inset 1px 1px 2px 0px rgba(204,204,204,1);
                box-shadow: inset 1px 1px 2px 0px rgba(204,204,204,1);
            }
            .tcmbconverter_to {
                font-weight: bold;
                font-size: 80%;
                vertical-align:sub;
                background-color: green;
                color: white;
                padding: 5px;
                border: solid 1px #000;
                border-radius: 10%;
                -webkit-box-shadow: 1px 1px 5px 0px rgba(204,204,204,0.75);
                -moz-box-shadow: 1px 1px 5px 0px rgba(204,204,204,0.75);
                box-shadow: 1px 1px 5px 0px rgba(204,204,204,0.75);
            }
            .tcmbconverter {    
                font-weight: bold;
                font-size: 150%;
                vertical-align: bottom;
            }
            .tcmbconverter_update {
                font-weight: bold;
                color: red;
                vertical-align: super;
            }
            .tcmbconverter_widget {
                margin: 0 auto;
                background: #fff;
                color: #000;
                padding: 0 3px;
            }
            .tc_labels {
                clear: both;
                height: 30px;
            }
            .tc_label{
                min-width: 50px;
                float: right;
                text-align: center;
                font-weight: bold;
                padding: 0px;
            }
            .tc_widgetrows{
                min-width: 150px;
                padding: 0px;
            }
            .tc_widgetrow{
                height: 17px;
                padding: 0;
                clear: both;
                overflow: hidden;
            }
            .tc_buytag {
                font-weight: bold;
                font-size: 80%;
                background-color: green;
                color: white;
                padding: 5px;
                border: solid 1px #000;
                border-radius: 10%;
                -webkit-box-shadow: 1px 1px 5px 0px rgba(204,204,204,0.75);
                -moz-box-shadow: 1px 1px 5px 0px rgba(204,204,204,0.75);
                box-shadow: 1px 1px 5px 0px rgba(204,204,204,0.75);
            }
            .tc_symbol{
                float: left;
                padding-left: 20px;
                background: transparent no-repeat scroll 0 6px;
            }
            .TRY{ background-image: url(images/TRY.png); }
            .USD{ background-image: url(images/USD.gif); }
            .AUD{ background-image: url(images/AUD.gif); }
            .DKK{ background-image: url(images/DKK.gif); }
            .EUR{ background-image: url(images/EUR.gif); }
            .GBP{ background-image: url(images/GBP.gif); }
            .CHF{ background-image: url(images/CHF.gif); }
            .SEK{ background-image: url(images/SEK.gif); }
            .CAD{ background-image: url(images/CAD.gif); }
            .KWD{ background-image: url(images/KWD.gif); }
            .NOK{ background-image: url(images/NOK.gif); }
            .SAR{ background-image: url(images/SAR.gif); }
            .JPY{ background-image: url(images/JPY.gif); }
            .BGN{ background-image: url(images/BGN.gif); }
            .RON{ background-image: url(images/RON.gif); }
            .RUB{ background-image: url(images/RUB.gif); }
            .IRR{ background-image: url(images/IRR.gif); }
            .CNY{ background-image: url(images/CNY.gif); }
            .PKR{ background-image: url(images/PKR.gif); }
            .tc_buy, .tc_sell {
                float: right;
                overflow: hidden;
                padding: 0 4px 0 0;
                text-align: right;
                width: 60px;
            }
            .tcmbconverter {
                padding-bottom: 10px;
            }
            .tcmbconverter select{
                height: 30px;
                font-weight: bold;
            }
		

Once again, thank you so much for purchasing this plugin. As I said at the beginning, I'd be glad to help you if you have any questions relating to this plugin. No guarantees, but I'll do my best to assist. If you have a more general question relating to the plugins on ThemeForest, you might consider visiting the forums and asking your question in the "Item Discussion" section.

Ozibal

Go To Table of Contents