{"id":22265,"date":"2013-03-08T14:03:55","date_gmt":"2013-03-08T14:03:55","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/localmoney\/"},"modified":"2013-10-15T16:28:02","modified_gmt":"2013-10-15T16:28:02","slug":"localmoney","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/localmoney\/","author":11694793,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.6","stable_tag":"1.0.6","tested":"3.6.1","requires":"2.7","requires_php":"","requires_plugins":"","header_name":"LocalMoney","header_author":"Steve Mulligan","header_description":"","assets_banners_color":"32283e","last_updated":"2013-10-15 16:28:02","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_donations&business=steve@machinesthatgobing.com","header_plugin_uri":"","header_author_uri":"http:\/\/www.stephenmulligan.co.uk","rating":0,"author_block_rating":0,"active_installs":0,"downloads":2059,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"1.0.5 2013-10-14":"<p>Bug fixes and performance improvements.<\/p>","1.0.4 2013-09-12":"<p>Compatibility with WordPress 3.6.1.<\/p>","1.0.3 2013-06-21":"<p>Backward compatibility bug fix.<\/p>","1.0.2 2013-05-26":"<p>If your WordPress installation isn&#039;t in root you need this bug fix!<\/p>","1.0.1 2013-04-28":"<p>Miscellaneous bug fix release.<\/p>","1.0.0 2013-03-17":"<p>Now converts from any currency to any other!<\/p>","0.0 2013-03-06":"<p>First development version.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":{"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":"678444","resolution":"772x250","location":"assets"}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.0.2","1.0.3","1.0.4","1.0.5","1.0.6"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":"678088","resolution":"1","location":"assets"},"screenshot-2.gif":{"filename":"screenshot-2.gif","revision":"678088","resolution":"2","location":"assets"}},"screenshots":{"1":"The LocalMoney settings page.","2":"LocalMoney in action -- exciting isn't it!"}},"plugin_section":[],"plugin_tags":[146,5520,8504,27996,4393],"plugin_category":[45,52,59],"plugin_contributors":[129868],"plugin_business_model":[],"class_list":["post-22265","plugin","type-plugin","status-closed","hentry","plugin_tags-cache","plugin_tags-converter","plugin_tags-currency","plugin_tags-currency-rates","plugin_tags-prices","plugin_category-ecommerce","plugin_category-performance","plugin_category-utilities-and-tools","plugin_contributors-stevemulligan","plugin_committers-stevemulligan"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/localmoney_32283e.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/localmoney\/assets\/screenshot-1.jpg?rev=678088","caption":"The LocalMoney settings page."},{"src":"https:\/\/ps.w.org\/localmoney\/assets\/screenshot-2.gif?rev=678088","caption":"LocalMoney in action -- exciting isn't it!"}],"raw_content":"<!--section=description-->\n<p>A cache-compatible WordPress plugin which converts all prices of the currency of\nyour choice in a post or page in the viewer's local currency. LocalMoney relies\non the WP-cron system to fetch and cache the rates from \n<a href=\"http:\/\/openexchangerates.org\" title=\"The openexchangerates.org site\">Open Exchange Rates<\/a> \non an hourly basis and then uses javascript to lookup the visitor's location and \nfetch the appropriate rate data. This means that, unlike some plugins I could mention, \nLocalMoney is compatible with caching plugins.<\/p>\n\n<p>LocalMoney, once configured, immediately (or as soon as your cache updates) acts\non all your posts and pages without you having to mark up the prices in your text.<\/p>\n\n<h4>Features<\/h4>\n\n<ol>\n<li>Determines the reader's country via IP address, using IP2C<\/li>\n<li>Resolves proxies with the 'forwarded-for' header so AOL-compatible<\/li>\n<li>If IP2C fails uses the language settings and timezone offset to guess location<\/li>\n<li>Obtains exchange rates from openexchangerates.org<\/li>\n<li>Uses AJAX so that converting currency values doesn't delay page load times<\/li>\n<li>Caches exchange rates locally to minimize calls to openexchangerates.org<\/li>\n<li>Output prices matched to format of input prices (i.e. with or without cents)<\/li>\n<\/ol>\n\n<h4>How to Use<\/h4>\n\n<p>Once LocalMoney is installed it will take any page on which US dollar prices are\ndisplayed and convert them to the visitors local currency. If your posts are written\nwith another currency you can change the base currency in the Settings &gt; LocalMoney\npage.<\/p>\n\n<h3>Internationalization (i18n)<\/h3>\n\n<p>Currently LocalMoney has not been translated to any languages other than English.<\/p>\n\n<p>If you wish, feel free to create a translation. Here are the basic steps:<\/p>\n\n<ol>\n<li>Copy \"localmoney-en.po\" to \"localmoney-LANG_COUNTRY.po\" - fill in LANG and COUNTRY with whatever you use for WPLANG in wp-config.php.<\/li>\n<li>Grab a transalation editor. <a href=\"http:\/\/www.poedit.net\/\">POedit<\/a> works for us.<\/li>\n<li>Translate each line.<\/li>\n<li>Send your new localmoney-LANG_COUNTRY.po file to steve@machinesthatgobing.com.<\/li>\n<li>Your translation will be incorporated in the next release.<\/li>\n<\/ol>\n\n<!--section=installation-->\n<ol>\n<li>Upload <code>plugin-name.php<\/code> to the <code>\/wp-content\/plugins\/<\/code> directory.<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n<li>Go to openexchangerates.org and sign up for a free account.<\/li>\n<li>Copy your API key (should be a string of 32 alphanumeric characters).<\/li>\n<li>Go to Settings &gt; LocalMoney and paste the API key into the field.<\/li>\n<li>On the same page if your own currency is not the US Dollar select it.<\/li>\n<li>If you are using a caching system you may want to empty your cache in order to benefit from the plugin immediately.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt>What do I have to do to tell LocalMoney where the prices are on my page?<\/dt>\n<dd><p>Nothing!<\/p><\/dd>\n<dt>How does LocalMoney decide which currency to convert to?<\/dt>\n<dd><p>In order to make the lookup process more robust the LocalMoney plugin uses a main\nand a fallback mechanism to lookup a visitor's location.<\/p>\n\n<p>The main system is the IP2C (IP to country) lookup service which is included with\nthe plugin. If the user is accessing your site via a proxy the 'Forwarded-for' header\nwill be used, allowing users from AOL to benefit from this plugin.<\/p>\n\n<p>The fallback system looks at the visitor's language preference. If it is in the form 'en-GB' it will\nuse the appropriate currency for GB which is Pound Sterling. If the language preference\nis in the form 'en' it will check the timezone offset of the user and guess the \nappropriate country from that, i.e. in the case of 'en' the following data will be\nused:<\/p>\n\n<p>0 - 24-&gt;<\/p>\n\n<p>gb gb gb gb gb in in ch au au au au nz nz us us us us us us gb gb gb gb<\/p>\n\n<p>Under the fallback system, because the currency is determined by the settings on \nthe user's machine, a visitor who happens to be in a foreign country still gets \ntheir own currency not the local one (unless they have changed their timezone settings).<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.5 2013-10-14<\/h4>\n\n<ul>\n<li>Fixed a bug that prevented currency updates in some circumstances.<\/li>\n<li>Removed rounding in initial content parse to increase overall accuracy of conversion.<\/li>\n<li>Converter now removes any blocks of three digits prefixed by a '.' or ',' to remove all thousands separators.<\/li>\n<li>Added facility for converter to handle currencies where a decimal comma is used.<\/li>\n<\/ul>\n\n<h4>1.0.4 2013-09-12<\/h4>\n\n<ul>\n<li>Ensured compatibility with WordPress 3.6.1 and updated documentation accordingly.<\/li>\n<\/ul>\n\n<h4>1.0.3 2013-06-21<\/h4>\n\n<ul>\n<li>Changed all occurrences of '<strong>DIR<\/strong>' with 'dirname(<strong>FILE<\/strong>)' in order to be backward-compatible \nwith PHP installations prior to 5.3.<\/li>\n<\/ul>\n\n<h4>1.0.2 2013-05-26<\/h4>\n\n<ul>\n<li>Fixed a bug that prevented the javascript conversion from working if the WordPress \ninstallation was not in the domain root.<\/li>\n<\/ul>\n\n<h4>1.0.1 2013-04-28<\/h4>\n\n<ul>\n<li>Corrected miscellaneous bugs<\/li>\n<\/ul>\n\n<h4>1.0.0 2013-03-17<\/h4>\n\n<ul>\n<li>Base currency selector added to admin page.<\/li>\n<li>Code added to handle non-US Dollar currencies as base.<\/li>\n<li>New fancy banner designed for WordPress hosting page.<\/li>\n<li>GPL_V2 now included as part of plugin<\/li>\n<li>Various miscellaneous revisions to the readme.txt<\/li>\n<\/ul>\n\n<h4>0.0 2013-03-06<\/h4>\n\n<p>Development version!<\/p>","raw_excerpt":"A cache-compatible plugin which converts all prices in a post or page into the viewer&#039;s local currency.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/22265","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=22265"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/stevemulligan"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=22265"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=22265"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=22265"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=22265"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=22265"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=22265"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}