{"id":10137,"date":"2010-08-17T07:55:11","date_gmt":"2010-08-17T07:55:11","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/world-flags\/"},"modified":"2010-08-23T08:49:22","modified_gmt":"2010-08-23T08:49:22","slug":"world-flags","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/world-flags\/","author":6766862,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1","stable_tag":"1.1","tested":"3.0.5","requires":"2.9.2","requires_php":"","requires_plugins":"","header_name":"World Flags","header_author":"Behrooz Sangani","header_description":"","assets_banners_color":"","last_updated":"2010-08-23 08:49:22","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_s-xclick&hosted_button_id=HMNUXVMGNXDR8","header_plugin_uri":"http:\/\/bsurprised.com\/2010\/08\/world-flags-wordpress-plugin\/","header_author_uri":"http:\/\/bsurprised.com\/","rating":0,"author_block_rating":0,"active_installs":10,"downloads":5352,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"1.1":"<p>New version can show flags in comments based on comment author IP, and can be setup both automatically and manually. There&#039;s the function to include flags anywhere in your template, and many customizable options in the options page.<\/p>","1.0.1-beta":"<p>Update fixes the cache problem by implementing ajax calls in jQuery<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0-beta","1.0.1-beta","1.1"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":"1539102","resolution":"1","location":"plugin"}},"screenshots":{"1":"World Flags settings page"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[3751,3736,1493,37296,1502],"plugin_category":[43,48,49],"plugin_contributors":[89390],"plugin_business_model":[],"class_list":["post-10137","plugin","type-plugin","status-closed","hentry","plugin_tags-country","plugin_tags-flags","plugin_tags-ip","plugin_tags-ip2country","plugin_tags-visitor","plugin_category-customization","plugin_category-language-tools","plugin_category-maps-and-location","plugin_contributors-bsurprised","plugin_committers-bsurprised"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/world-flags.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/world-flags\/trunk\/screenshot-1.jpg?rev=1539102","caption":"World Flags settings page"}],"raw_content":"<!--section=description-->\n<p>Add country flags anywhere in your Wordpress blog using simple shortcodes and\/or widgets, or show visitor country flag and info based on their IP address.<\/p>\n\n<p>This is the first version of World Flags. This version uses the <a href=\"http:\/\/software77.net\/geo-ip\/\">software77.net<\/a> ip2country database and only wraps the IPV4 version. The plugin imports the csv file into a mysql table for fast queries. Fetching of the csv IP database can be scheduled weekly using the WP cron jobs, or manually via the plugin options page.<\/p>\n\n<h4>Features<\/h4>\n\n<ul>\n<li>Supports shortcodes anywhere and widgets<\/li>\n<li>Template functions and comments author flags (NEW!)<\/li>\n<li>Uses software77 IP database with more than 3 billion addresses included<\/li>\n<li>Multilingual interface<\/li>\n<li>Scheduled downloads of the IP database file<\/li>\n<li>MD5 checks to validate database before populating tables<\/li>\n<li>Uses MySQL for super fast queries<\/li>\n<li>4 image sizes for country flags - 16, 24, 32 and 48<\/li>\n<li>Different ways to insert HTML - simple, JavaScript and jQuery (with Ajax)<\/li>\n<li>Plugin uninstall support<\/li>\n<\/ul>\n\n<h4>Multilingual Support<\/h4>\n\n<p>World Flags supports multilingual interface and currently has:<\/p>\n\n<ul>\n<li>Persian (fa_IR)<\/li>\n<\/ul>\n\n<p>You can also translate the <code>data\/country-codes.txt<\/code> file for country names in your language.<\/p>\n\n<p>All translation submissions are appreciated. Thank you.<\/p>\n\n<p><strong>Warning:<\/strong> Please be aware that software77.net may ban your IP if you send many download requrests. Visit <a href=\"http:\/\/software77.net\/geo-ip\/\">software77.net<\/a> for their license, privacy policy and specially the periodic download limit for the database file.<\/p>\n\n<p>Visit <a href=\"http:\/\/bsurprised.com\/\">BSurprised Home Page<\/a> for updates, feature requests and information on future releases.<\/p>\n\n<!--section=installation-->\n<p>Installation is the same routine as most WP plugins:<\/p>\n\n<ol>\n<li>Upload 'word-flags' folder to the <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Activate the plugin through the <code>Plugins<\/code> menu in WordPress<\/li>\n<li>Find the World Flags submenu under <code>Options<\/code> menu in your Wordpress to change some settings or manually update the IP database. <\/li>\n<\/ol>\n\n<p><strong>Notice:<\/strong> You need to manually fetch the IP database the first time as the plugin does not include the files.<\/p>\n\n<h4>Using World Flags<\/h4>\n\n<ul>\n<li>Place <code>[flag code=\"your-country-code\/auto\" size=\"16\/24\/32\/48\" text=\"yes\/no\"]<\/code> in your posts.\nExample: <code>[flag code=\"auto\" size=\"48\" text=\"yes\"]<\/code><\/li>\n<li>Drag the plugin widget in your Widgets menu and customize its options to show what you want.<\/li>\n<li>If you want to show the country flag for your visitor comments, you can add the flag before or after the comment text along with your custom text or use <code>&lt;?php if (function_exists('world_flags_comment_flag')) echo world_flags_comment_flag($comment); ?&gt;<\/code> inside your comments loop in your template. <code>$comment<\/code> is the variable that holds the comment inside your loop.<\/li>\n<li>You can add <code>&lt;?php if (function_exists('world_flags_insert_flag')) world_flags_insert_flag(); ?&gt;<\/code> inside your template to add flags anywhere. Optional argument <code>$code<\/code> can be provided to override <code>auto<\/code> mode. Example: <code>world_flags_insert_flag( 'US' )<\/code><\/li>\n<\/ul>\n\n<!--section=faq-->\n<dl>\n<dt>What are the options for the World Flags shortcode?<\/dt>\n<dd><p>The shortcode supports these attributes:<\/p>\n\n<ul>\n<li><strong>code<\/strong>: Can be an <a href=\"http:\/\/en.wikipedia.org\/wiki\/ISO_3166-1_alpha-2\">ISO_3166-1_alpha-2<\/a> two-letter country code, or the keyword <code>auto<\/code> for the automatic display of the flags based on the visitor IP address.<\/li>\n<li><strong>size<\/strong>: Currently supports <code>16<\/code>, <code>24<\/code>, <code>32<\/code> and <code>48<\/code> pixel image sizes.<\/li>\n<li><strong>text<\/strong>: <code>yes<\/code> or <code>no<\/code>, whether to show the country name text beside the flag image.<\/li>\n<\/ul><\/dd>\n<dt>What are the requirements for the plugin?<\/dt>\n<dd><ul>\n<li>You need at least 15 megabytes of space on your hosting as the ip2country database file, when extracted, takes some space.<\/li>\n<li>Plugin needs to have write permissions on its <code>\/data<\/code> directory.<\/li>\n<\/ul><\/dd>\n<dt>The plugin auto mode does not show visitor flags correctly. Why?<\/dt>\n<dd><p>You probably have some sort of caching enabled like wp-supercache. You need to set the mode to jQuery for the flags to load by ajax calls.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1<\/h4>\n\n<p>2010-08-23\n* Comment flags based on comment author IP address\n* function to include flags anywhere inside template\n* Many new customizable options<\/p>\n\n<h4>1.0.1-beta<\/h4>\n\n<p>2010-08-21\n* Fixed the cache problem by implementing ajax calls in jQuery<\/p>\n\n<h4>1.0-beta<\/h4>\n\n<p>2010-08-17\n* First released version\n* Supports shortcodes and widgets\n* Uses software77 IP database\n* Only IPV4\n* Plugin uninstall support<\/p>","raw_excerpt":"Add country flags anywhere in your Wordpress blog using simple shortcodes and\/or widgets, or show visitor country flag based on their IP address.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/10137","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=10137"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/bsurprised"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=10137"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=10137"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=10137"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=10137"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=10137"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=10137"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}