{"id":397269,"date":"2026-11-09T18:24:03","date_gmt":"2026-11-09T18:24:03","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/koci-currency\/"},"modified":"2026-11-09T18:23:37","modified_gmt":"2026-11-09T18:23:37","slug":"koci-currency","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/koci-currency\/","author":23597580,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.0","stable_tag":"1.1.0","tested":"7.1.4","requires":"6.5","requires_php":"7.4","requires_plugins":null,"header_name":"Koci Currency","header_author":"Koci M\u00e9dia\u00fcgyn\u00f6ks\u00e9g Kft.","header_description":"Multi-currency for WooCommerce with fixed prices per product (no exchange rates): per-currency price format, fixed shipping fees, a currency switcher, a default currency per language and cache-friendly behaviour.","last_updated":"2026-11-09 18:23:37","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/koci.hu","rating":0,"author_block_rating":0,"active_installs":0,"downloads":111,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.1.0":{"tag":"1.1.0","author":"kocimedia","date":"2026-11-09 18:23:37","revision":3793033}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3793033,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3793033,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3793033,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3793033,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3793033,"resolution":"1","location":"assets","locale":"","width":1102,"height":576},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3793033,"resolution":"2","location":"assets","locale":"","width":778,"height":514},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3793033,"resolution":"3","location":"assets","locale":"","width":1320,"height":588}},"screenshots":{"1":"The currency settings.","2":"Fixed prices on the product editor.","3":"The currency switcher and a price in the additional currency on the shop page."}},"plugin_section":[],"plugin_tags":[21294,291693,24514,10601,286],"plugin_category":[45],"plugin_contributors":[291694],"plugin_business_model":[],"class_list":["post-397269","plugin","type-plugin","status-publish","hentry","plugin_tags-currency-switcher","plugin_tags-fixed-prices","plugin_tags-multi-currency","plugin_tags-polylang","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-kocimedia","plugin_committers-kocimedia"],"banners":{"banner":"https:\/\/ps.w.org\/koci-currency\/assets\/banner-772x250.png?rev=3793033","banner_2x":"https:\/\/ps.w.org\/koci-currency\/assets\/banner-1544x500.png?rev=3793033","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/koci-currency\/assets\/icon-128x128.png?rev=3793033","icon_2x":"https:\/\/ps.w.org\/koci-currency\/assets\/icon-256x256.png?rev=3793033","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/koci-currency\/assets\/screenshot-1.png?rev=3793033","caption":"The currency settings."},{"src":"https:\/\/ps.w.org\/koci-currency\/assets\/screenshot-2.png?rev=3793033","caption":"Fixed prices on the product editor."},{"src":"https:\/\/ps.w.org\/koci-currency\/assets\/screenshot-3.png?rev=3793033","caption":"The currency switcher and a price in the additional currency on the shop page."}],"raw_content":"<!--section=description-->\n<p>Koci Currency lets a WooCommerce shop sell in additional currencies (for example EUR and PLN next to the base currency) with <strong>fixed prices entered per product<\/strong>. There is no exchange rate feed: customers see exactly the price you set, and products without a price in a currency simply cannot be bought in it.<\/p>\n\n<h4>Features<\/h4>\n\n<ul>\n<li><strong>Fixed prices per product and variation<\/strong> \u2013 regular and sale price fields for every additional currency, on the General tab of the product editor and in each variation.<\/li>\n<li><strong>Price format per currency<\/strong> \u2013 symbol position, decimals, decimal and thousand separators.<\/li>\n<li><strong>Fixed shipping fees per currency<\/strong> \u2013 a fee field per currency in every Flat rate shipping method (other flat-rate based methods can opt in), plus a shared fallback fee per currency.<\/li>\n<li><strong>Currency switcher<\/strong> \u2013 <code>[koci_currency_switcher]<\/code> shortcode or <code>kcur_switcher()<\/code> template function, as a list or a dropdown, showing the code, the symbol or both.<\/li>\n<li><strong>Default currency per language<\/strong> \u2013 with Polylang (or a compatible multilingual plugin) each language can start in its own currency; visitors can still switch.<\/li>\n<li><strong>Cart follows the currency<\/strong> \u2013 switching recalculates the cart with the prices of the new currency.<\/li>\n<li><strong>Cache friendly<\/strong> \u2013 the currency cookie is only set when the visitor explicitly switches, so pages in the default currency remain cacheable.<\/li>\n<li><strong>Admin overview<\/strong> \u2013 a product list column shows which products miss a price in an additional currency.<\/li>\n<li><strong>Translation-ready<\/strong> \u2013 all texts can be translated on translate.wordpress.org (Hungarian and German translations are on their way).<\/li>\n<\/ul>\n\n<h4>How the currency is chosen<\/h4>\n\n<ol>\n<li>The visitor's explicit choice (the <code>koci_cur<\/code> cookie, set by the switcher).<\/li>\n<li>Otherwise the default currency of the page language (when a multilingual plugin is active).<\/li>\n<li>Otherwise the WooCommerce base currency.<\/li>\n<\/ol>\n\n<p>In the admin, the base currency is always used.<\/p>\n\n<h4>Page cache<\/h4>\n\n<p>Pages are rendered in the currency of the visitor. If you use a page cache, configure it to bypass the cache when the <code>koci_cur<\/code> cookie is present (Koci Cache does this automatically). Visitors without the cookie see the default currency and get cached pages.<\/p>\n\n<h4>Privacy<\/h4>\n\n<p>The plugin sets one functional cookie, <code>koci_cur<\/code>, only when a visitor uses the currency switcher. It stores the chosen currency code for one year and is not sent anywhere. The plugin does not connect to any external service.<\/p>\n\n<h4>For developers<\/h4>\n\n<ul>\n<li><code>koci_currency_current<\/code> \u2013 filter the current currency code.<\/li>\n<li><code>koci_currency_language_default<\/code> \u2013 filter the default currency of a language (currency, language code).<\/li>\n<li><code>kcur_shipping_method_ids<\/code> \u2013 add flat-rate based shipping method ids that get per-currency fee fields.<\/li>\n<li><code>koci_currency_switcher_css<\/code> \u2013 return false to skip the default switcher style (assets\/switcher.css).<\/li>\n<li><code>kcur_current()<\/code>, <code>kcur_switcher( $args )<\/code>, <code>kcur_product_price_html( $product_id, $currency )<\/code> \u2013 template functions.<\/li>\n<li>Product meta keys: <code>_kcur_regular_price_&lt;CODE&gt;<\/code> and <code>_kcur_sale_price_&lt;CODE&gt;<\/code> (e.g. <code>_kcur_regular_price_PLN<\/code>).<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate WooCommerce.<\/li>\n<li>Install the plugin from the Plugins &gt; Add New screen, or upload the plugin folder to <code>\/wp-content\/plugins\/<\/code>, then activate it.<\/li>\n<li>Open Koci Currency in the admin menu. EUR and PLN are enabled by default; enable, disable or add currencies (three-letter codes) and set their format.<\/li>\n<li>Enter the prices in the additional currencies on each product (General tab) and variation.<\/li>\n<li>Add the <code>[koci_currency_switcher]<\/code> shortcode to a menu, widget or template.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20it%20convert%20prices%20with%20exchange%20rates%3F\"><h3>Does it convert prices with exchange rates?<\/h3><\/dt>\n<dd><p>No, by design. Each additional currency has its own fixed prices, so rounding and margins are always under your control.<\/p><\/dd>\n<dt id=\"what%20happens%20when%20a%20product%20has%20no%20price%20in%20a%20currency%3F\"><h3>What happens when a product has no price in a currency?<\/h3><\/dt>\n<dd><p>It shows \"Currently not available in this currency\" and cannot be added to the cart in that currency.<\/p><\/dd>\n<dt id=\"which%20currency%20are%20orders%20placed%20in%3F\"><h3>Which currency are orders placed in?<\/h3><\/dt>\n<dd><p>In the visitor's current currency. WooCommerce stores the currency on the order, and the order amounts are shown in that currency in the admin and in emails.<\/p><\/dd>\n<dt id=\"does%20it%20need%20a%20multilingual%20plugin%3F\"><h3>Does it need a multilingual plugin?<\/h3><\/dt>\n<dd><p>No. Without one, the base currency is the default and visitors switch with the switcher. With Polylang, a default currency can be set per language on the settings page.<\/p><\/dd>\n<dt id=\"which%20payment%20gateways%20work%3F\"><h3>Which payment gateways work?<\/h3><\/dt>\n<dd><p>Any gateway that supports the order currency. Check that your gateways accept all the currencies you enable.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>First public release.<\/li>\n<\/ul>","raw_excerpt":"Sell in more than one currency with fixed prices you set per product \u2013 no exchange rates, no surprises.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/397269","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=397269"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/kocimedia"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=397269"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=397269"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=397269"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=397269"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=397269"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=397269"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}