This plugin adds IDN support to Wordpress, making it an IDNA application. An IDN is a domain name that contains non-ascii characters.\nThis plugin enables one to set the WordPress address (URL) to an IDN. (instead of the Punycode Representation)<\/p>\n\n
Examples of an IDN:<\/p>\n\n
\n\"An IDNA-enabled application is able to convert between the internationalised\n and ASCII representations of a domain name. It uses the ASCII form for DNS\n lookups but can present the internationalised form to users who presumably\n prefer to read and write domain names in non-ASCII scripts such as Arabic or\n Hiragana. Applications that do not support IDNA will not be able to handle\n domain names with non-ASCII characters, but will still be able to access such\n domains if given the (usually rather cryptic) ASCII equivalent.\" -\n IDN entry at Wikipedia<\/a><\/p>\n<\/blockquote>\n\n
In simple terms, this plugin allows one to set their blog url to an IDN.<\/p>\n\n
If you are interested in seeing what the PUNYCODE version of your IDN is, here is an online conversion tool<\/a><\/p>\n\n
As an example:<\/p>\n\n
\nFrau M\u00fcller has a blog and wants to use the IDN, http:\/\/www.m\u00fcller.de\n Currently, she would have to set the WP blog url, (General Settings menu) to \n the Punycode version: xn--mller-kva.de<\/em>, (which is the ascii representation\n of m\u00fcller.de) this would allow users using a IDN aware web browser to access \n the site using the desired url: http:\/\/www.m\u00fcller.de\n (and also of course, xn--mller-kva.de).<\/p>\n \n
It is more convenient for Frau M\u00fcller to use the actual IDN\n http:\/\/www.m\u00fcller.de as the WP blog url setting (General Settings menu), \n this plugin enables that functionality.<\/p>\n<\/blockquote>\n\n
There are a few caveats with using this plugin, depending on what Browser, Operating\nSystem and versions used, one can get unexpected results.<\/p>\n\n
Firefox >= 3.*<\/p>\n\n
Firefox supports IDN's but maintains a 'whitelist' of 'safe' domains.\n.com, .net, .eu are not white listed for safety reasons, so IDN's on these\ndomains will display as Punycode. see bug: <\/a><\/p>\n\n
There is an new ('experimental') Firefox add-on, \nIDN Navbar<\/a>, which\nwill enable all (whitelisted - Punycode) domains to display as IDN's. \nSo, if using Firefox and this plugin you (and your visitors) may want to install that addon.<\/p>\n\n
Internet Explorer >= 7.*<\/p>\n\n
Depending on your language set up, site's that contain non 'native language'\ncharacters will display as Punycode and not the IDN. More info\nmsdn blogs<\/a>\nmsdn libs1<\/a>\nmsdn libs2<\/a><\/p>\n\n
Safari\/Opera 10.* seem to display IDN's for all domain's fine. (untested)<\/p>\n\n
Arbitrary section<\/h3>\n\n
WP plugins have a 'stable tag' requirement for distribution, however, at this\ntime, I consider this plugin to be Beta<\/strong> quality at best.<\/p>\n\n
It is possible to lock your self out of the administrative section of your blog<\/strong><\/p>\n\n
NOTE<\/strong> make sure you are using an IDN capable web browser when enabling this plugin.\nMore<\/a><\/p>\n\n
NOTE<\/strong> Unfortunely, Current Firefox versions display the Punycode version and \nNOT the IDN. For more details, (and work around) see the 'Other Notes' Link \n(Arbitrary section - readme.txt)<\/p>\n\n
IE7\/8, Safari, Opera10 all display the actual IDN, Firefox (and Chrome)\nnavigation bar's display the IDN as Punycode. (i.e. www.xn--)<\/p>\n\n
There are some security issues with multi-byte chars and phishing, so this is\nMozilla's current approach, this may change in the future, as some folks are not\nhappy about it.<\/p>\n\n
https:\/\/bugzilla.mozilla.org\/show_bug.cgi?id=542562\nanother related, one: https:\/\/bugzilla.mozilla.org\/show_bug.cgi?id=354592<\/p>\n\n
Because this plugin effects how you access your site, installation is slightly more \ninvolved than most plugins.<\/p>\n\n
If you installing this plugin, I would recommend, if possible, that it is the \nfirst thing you do on your blog, before you add any content, just in case \nsomething goes wrong, this will minimize downtime.<\/p>\n\n
NOTE<\/strong> If something goes wrong and you cant access the WP admin area after\nchanging your url, here are some instructions for \nresetting your url<\/a><\/p>\n\n
Please report any bugs you find to the author of this plugin<\/em><\/p>\n\n\n
NOTE: This plugin requires PHP5<\/p>\n\n
See The Notes in: 'Other Notes' below before installing<\/strong><\/p>\n\n
\n
Point a web browser to WP plugins<\/a><\/p><\/li>\n
Search for idna<\/strong>, download and upload to your web host.<\/p><\/li>\n
Copy the whole idna<\/strong> directory to the \/wp-content\/plugins\/<\/em> directory of your WP blog<\/p><\/li>\n
Access the administrative section of your WP blog. \n(In a typical default installation, WP determines your hostname and sets the WP blog url field\nto the Punycode verion of your url, so you should be able to access the administrative section \nof your WP blog using the Punycode version of the IDN) if that is not the case, you will first \nhave to set the blog Url to use the Punycode version of your IDN, so you\ncan access the administrative section to activate the plugin.<\/p><\/li>\n
To get the PUNYCODE version of your IDN, here is an online conversion tool<\/a><\/p><\/li>\n
Activate the plugin IDNA<\/strong> through the Plugins<\/em> menu in WordPress<\/p><\/li>\n
Change your WP Url to now use your IDN<\/p>\n\n
\n
- Navigate to General Settings menu<\/li>\n
- set the WordPress address (URL) field to your IDN name (*)<\/li>\n
- set the Blog address (URL) field to your IDN name<\/li>\n
- Save Changes<\/li>\n<\/ul><\/li>\n
If something does go wrong and you get locked out of the admin section, see\nthe notes in 'Other Notes' (Arbitrary section), to regain access.<\/p><\/li>\n<\/ol>\n\n
\n
- Unfortunely, for security reasons, current Firefox versions will display the Punycode\nversion and NOT the IDN. For more details,(and work around) \nsee the 'Other Notes' Link (Arbitrary section - readme.txt).<\/li>\n<\/ul>\n\n\n
\n
- Q: What is an IDN? Do I need this plugin?<\/dt>\n
A: If you don't know, you don't need it.<\/p>\n\n
In a nutshell:\nIDN is an abbrevation for \"Internationalized Domain Name\"<\/p>\n\n
Internationalizing Domain Names in Applications (IDNA) is a mechanism defined\nin 2003 for handling internationalised domain names containing non-ASCII\ncharacters.<\/p>\n\n
These names are typically written in languages or scripts which do not use the\nLatin alphabet: Arabic, Hangul, Hiragana and Kanji for instance.<\/p>\n\n
Read more, \nIDN info at Wikipedia<\/a><\/p><\/dd>\n
- Q: Do you use a IDN library in this plugin?<\/dt>\n
A: Yes, this one, Php_Net_idna<\/a>.\nMany thanks to the author for their fine work on this great library!<\/p>\n\n