{"id":16346,"date":"2012-01-08T02:18:33","date_gmt":"2012-01-08T02:18:33","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/mapnavigator\/"},"modified":"2012-01-23T18:45:56","modified_gmt":"2012-01-23T18:45:56","slug":"mapnavigator","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/mapnavigator\/","author":8796909,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.1.0","stable_tag":"1.1.1","tested":"3.2.1","requires":"2.0.2","requires_php":"","requires_plugins":"","header_name":"MapNavigator","header_author":"David Rothman","header_description":"","assets_banners_color":"","last_updated":"2012-01-23 18:45:56","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_donations&business=54AZYA26EA848&lc=US&item_name=Support%20Map%20Navigator%20development&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted","header_plugin_uri":"","header_author_uri":"","rating":1,"author_block_rating":0,"active_installs":10,"downloads":13987,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"1.1.0":"<ul>\n<li>Add new Functionality<\/li>\n<li>\n<ul>\n<li>MapPress Map Tables cleanup to remove orphan maps<\/li>\n<\/ul><\/li>\n<li>\n<ul>\n<li>Link all maps in MapPress database into the MapNavigator Hierarchy<\/li>\n<\/ul><\/li>\n<li>\n<ul>\n<li>Option to update all posts with MappRess Maps to set Maps Taxonomy and tags<\/li>\n<\/ul><\/li>\n<li>\n<ul>\n<li>MapNavigator Admin Tool user interface updates for new functionality<\/li>\n<\/ul><\/li>\n<\/ul>","1.0.1":"<p>Provide MapPress Icon to be inserted into Map Markers and specified on Tool Dialog<\/p>"},"ratings":{"1":"1","2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.2","1.0.3","1.0.4","1.1.0","1.1.1"],"block_files":[],"assets_screenshots":{"screenshot-9.png":{"filename":"screenshot-9.png","revision":"1566888","resolution":"9","location":"plugin"},"screenshot-5.png":{"filename":"screenshot-5.png","revision":"1566888","resolution":"5","location":"plugin"},"screenshot-7.png":{"filename":"screenshot-7.png","revision":"1566888","resolution":"7","location":"plugin"},"screenshot-6.png":{"filename":"screenshot-6.png","revision":"1566888","resolution":"6","location":"plugin"},"screenshot-4.png":{"filename":"screenshot-4.png","revision":"1566888","resolution":"4","location":"plugin"},"screenshot-8.png":{"filename":"screenshot-8.png","revision":"1566888","resolution":"8","location":"plugin"},"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1566888","resolution":"1","location":"plugin"}},"screenshots":{"1":"Plugin's interface under Tools","2":"Top Level of the USA Taxonomy Customized for a Fire Department Association","3":"Marker for Pacific Region on Top Level","4":"Second level of the Hierarchy - Mountain Region States","5":"Marker for State of Montana - USA Mountain Region","6":"Third level of the Hierarchy - State of Montana Map","7":"Fourth level of the Hierarchy - City of Helena, Montana Map","8":"WP-Affiliate-Platform Custom Registration Screen","9":"Affiliate  Registration Creats a Map for Boulder Colorado"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[11137,567,6590,87,9471],"plugin_category":[57,59],"plugin_contributors":[],"plugin_business_model":[],"class_list":["post-16346","plugin","type-plugin","status-publish","hentry","plugin_tags-batch","plugin_tags-csv","plugin_tags-excel","plugin_tags-import","plugin_tags-spreadsheet","plugin_category-taxonomy","plugin_category-utilities-and-tools","plugin_committers-rothmaniac"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/mapnavigator.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/mapnavigator\/trunk\/screenshot-1.png?rev=1566888","caption":"Plugin's interface under Tools"},{"src":"https:\/\/ps.w.org\/mapnavigator\/trunk\/screenshot-4.png?rev=1566888","caption":"Second level of the Hierarchy - Mountain Region States"},{"src":"https:\/\/ps.w.org\/mapnavigator\/trunk\/screenshot-5.png?rev=1566888","caption":"Marker for State of Montana - USA Mountain Region"},{"src":"https:\/\/ps.w.org\/mapnavigator\/trunk\/screenshot-6.png?rev=1566888","caption":"Third level of the Hierarchy - State of Montana Map"},{"src":"https:\/\/ps.w.org\/mapnavigator\/trunk\/screenshot-7.png?rev=1566888","caption":"Fourth level of the Hierarchy - City of Helena, Montana Map"},{"src":"https:\/\/ps.w.org\/mapnavigator\/trunk\/screenshot-8.png?rev=1566888","caption":"WP-Affiliate-Platform Custom Registration Screen"},{"src":"https:\/\/ps.w.org\/mapnavigator\/trunk\/screenshot-9.png?rev=1566888","caption":"Affiliate  Registration Creats a Map for Boulder Colorado"}],"raw_content":"<!--section=description-->\n<p>This plugin imports a Map Navigation file into your WordPress blog. \nThe Map Navigation file defines one or more Continents, Countries, Regions, States and Cities.\nThe plugin creates Posts that each contain a MapPress map or mashup that provide a linked\nnavigation of the geography using your organization's name, image file and icon in the Post's\nPost, Excerpt and on the Map markers. The Map Navigation hierarchy can then be added to your \nthemes header or provided as a link so that your organization can locate its members Posts\nor Pages by Geographical area. The plugin also provides an affiliate Register script that adds\nan Affiliate to your Map Navigation hierarchy along with their link and image when they join \nyour organization. Any post can be added to the Map Navigation hierarchy using the Map Taxonomy\ntags and a Custom field used by the MapPress plugin. Exisitng MapPress maps can be linked into \nthe Map Navigation Hierarchy from the MapNavigator Admin Tool Interface.<\/p>\n\n<p>This plugin is built on top of the CSV Importer plugin so it contains all of the features of \nCSV Importer with the additional customized features for MapPress Google maps navigation.<\/p>\n\n<h3>Map Navigator features<\/h3>\n\n<ul>\n<li>Map Navigation Files available (for a small fee) for geographical areas (USA available now)<\/li>\n<li>Documentation and Sample file so that you can create your own Map Navigation File   <\/li>\n<li>Automatically creates the MapPress Maps, Mashups and Markers with your organizations:\n\n<ul>\n<li>Name or Title<\/li>\n<li>Link to website or other location <\/li>\n<li>Image from an http:\/\/ link<\/li>\n<li>Icon from a list of icons supplied by MapPress or a custom icon placed into the MapPress icon directory<\/li>\n<\/ul><\/li>\n<li>Cleans database for 'orphaned' MapPress Maps<\/li>\n<li>Links exisitng MapPress Maps into your Map Navigation hierarchy<\/li>\n<li>Creates a Map Taxonomy that provides easy categorization of a Post by geographical location<\/li>\n<li>Provides the ability to add any post to your Map Navigation hierarchy without coding any\ncomplex MapPress parameters.<\/li>\n<li>Provides a customized WP-Affiliate Registration script that will place your new affiliate on the\nappropriate Map in your Map Navigation hierarchy<\/li>\n<li>Provides several customizations to the MapPress plugin to address limitations and enhancements that\nprovide the above functionality<\/li>\n<\/ul>\n\n<h4>CSV Importer Features<\/h4>\n\n<ul>\n<li>Imports post title, body, excerpt, tags, date, categories etc.<\/li>\n<li>Supports custom fields, custom taxonomies and comments<\/li>\n<li>Deals with Word-style quotes and other non-standard characters using\nWordPress' built-in mechanism (same one that normalizes your input when you\nwrite your posts)<\/li>\n<li>Columns in the CSV file can be in any order, provided that they have correct\nheadings<\/li>\n<li>Multilanguage support<\/li>\n<\/ul>\n\n<h3>Usage<\/h3>\n\n<p>Click on the Map Navigator link on your WordPress admin page, choose the\nMap Definition file you would like to import and click Import. You can\nbuild your own Map Definition file using the example file \"Test Map-Navigator-USA.csv\" in the <code>examples<\/code> directory\ninside the plugin's directory or you can download one for a small fee from:<\/p>\n\n<p>http:\/\/mapclick.org<\/p>\n\n<p>The Map Definition file is in CSV format that consists of rows and columns. Each row in\na CSV file represents a post; each column identifies a piece of information\nthat comprises a post. Each Post is assigned to a level in the Map Taxonomy which provides\nthe Map Navigational Hierarchy as follows:<\/p>\n\n<p>Maps Taxonomy\n* Continent\n    * Country\n        * Region (optional)\n            * State (optional)\n                * City<\/p>\n\n<h4>Basic post information<\/h4>\n\n<ul>\n<li><p><code>nav_post_title<\/code> - title of the post. The name should reflect the category of the taxonomy level. For instance : 'United States Regions'\n                    or 'Mountain Region States' or 'California Map'<\/p><\/li>\n<li><p><code>nav_post_post<\/code> - body of the post. This will hold the MapPress  command to create a 'mashup' or to display a map in this post<\/p><\/li>\n<li><p><code>nav_post_excerpt<\/code> - post excerpt. This will contain the title that will appear in the Map Marker. The word 'mapClicks' \n                    will be replaced with your organization's name entered on the Map Navigator Tool dialog in Wordpress.<\/p><\/li>\n<li><p><code>nav_post_categories<\/code> - a comma separated list of category names or ids. This will be the level associated with this post;\n                    for instance : Maps &gt; Continent &gt; Country &gt; Region<\/p><\/li>\n<li><p><code>nav_post_tags<\/code> - a comma separated list of tags. Tags are used in the nav_post_post column to specify the mashup posts that will be included in the\n                  mashup post. See the Examples directory for a sample file. Pay close attention to the tags defined in this column and the references\n                  in the nav_post_post column.<\/p><\/li>\n<li><p><code>nav_post_date<\/code> - about any English textual description of a date and time.\nFor example, <code>now<\/code>, <code>11\/16\/2009 0:00<\/code>, <code>1999-12-31 23:55:00<\/code>, <code>+1 week<\/code>,\n    next Thursday, <code>last year<\/code> are all valid descriptions. For technical\ndetails, consult PHP's <code>strtotime()<\/code> function <a href=\"http:\/\/php.net\/manual\/en\/function.strtotime.php\">documentation<\/a>.<\/p><\/li>\n<li><p>nav_ctax_maps - See the Examples directory for a sample file (Test Map-Navigator-USA.csv). \n                This column is used to specify the Post's taxonomy tags and thus what the post will appear as in the 'Maps' taxonomy \n                (Continent, Country, Region, State or City)<\/p><\/li>\n<li><p>'map_address' - holds the address of the MapPress map marker. This must be defined as a Custom field and specified in the \n                MapPress setup as the field used to create maps automatically from when a post is updated.<\/p><\/li>\n<\/ul>\n\n<h4>Custom fields<\/h4>\n\n<p>Any column that doesn't start with <code>nav_<\/code> is considered to be a custom field\nname. The data in that column will be imported as the custom field\u2019s value.<\/p>\n\n<h4>General remarks<\/h4>\n\n<ul>\n<li>WordPress pages <a href=\"http:\/\/codex.wordpress.org\/Pages\">don't have categories or tags<\/a>.<\/li>\n<li>Most columns are optional. Either <code>nav_post_title<\/code>, <code>nav_post_post<\/code> or\n    nav_post_excerpt are sufficient to create a post. If all of these\ncolumns are empty in a row, the plugin will skip that row.<\/li>\n<li>The plugin will attempt to reuse existing categories or tags; if an\nexisting category or tag cannot be found, the plugin will create it.<\/li>\n<li>To specify a category that has a greater than sign (&gt;) in the name, use\nthe HTML entity <code>&amp;gt;<\/code><\/li>\n<\/ul>\n\n<h4>Advanced usage<\/h4>\n\n<ul>\n<li><code>nav_post_author<\/code> - numeric user id or login name. If not specified or\nuser does not exist, the plugin will assign the posts to the user\nperforming the import.<\/li>\n<li><code>nav_post_slug<\/code> - post slug used in permalinks.<\/li>\n<li><code>nav_post_parent<\/code> - post parent id.<\/li>\n<\/ul>\n\n<h3>Custom taxonomies<\/h3>\n\n<p>Once custom taxonomies are set up in your theme's functions.php file or\nby using a 3rd party plugin, <code>nav_ctax_(taxonomy name)<\/code> columns can be \nused to assign imported data to the taxonomies.<\/p>\n\n<p><strong>Non-hierarchical taxonomies<\/strong><\/p>\n\n<p>The syntax for non-hierarchical taxonomies is straightforward and is essentially\nthe same as the <code>nav_post_tags<\/code> syntax.<\/p>\n\n<p><strong>Hierarchical taxonomies<\/strong><\/p>\n\n<p>The syntax for hierarchical taxonomies is more complicated. Each hierarchical\ntaxonomy field is a tiny two-column CSV file, where <em>the order of columns\nmatters<\/em>. The first column contains the name of the parent term and the second\ncolumn contains the name of the child term. Top level terms have to be preceded\neither by an empty string or a 0 (zero).<\/p>\n\n<p>Sample <code>examples\/custom-taxonomies.csv<\/code> file included with the plugin\nillustrates custom taxonomy support. To see how it works, make sure to set up\ncustom taxonomies from <code>functions.inc.php<\/code>.<\/p>\n\n<p>Make sure that the quotation marks used as text delimiters in <code>nav_ctax_<\/code>\ncolumns are regular ASCII double quotes, not typographical quotes like \u201c\n(U+201C) and \u201d (U+201D).<\/p>\n\n<h3>Comments<\/h3>\n\n<p>An example file with comments is included in the <code>examples<\/code> directory.\nIn short, comments can be imported along with posts by specifying columns\nsuch as <code>nav_comment_*_author<\/code>, <code>nav_comment_*_content<\/code> etc, where * is\na comment ID number. This ID doesn't go into WordPress. It is only there\nto have the connection information in the CSV file.<\/p>\n\n<h3>Credits<\/h3>\n\n<p>This plugin is based upon  [csv-importer][3] by Denis Kobozev (thanks !) .\nThis plugin uses [php-csv-parser][3] by Kazuyoshi Tlacaelel (thanks !).<\/p>\n\n<p>Contributors:\n*   Israeli Rothman (Original Idea and Requirements Spec)<\/p>\n\n<!--section=installation-->\n<p>Installing the plugin:<\/p>\n\n<ol>\n<li>Unzip the plugin's directory into <code>wp-content\/plugins<\/code>.<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n<li>The plugin will be available under Tools -&gt; Map Navigator on the WordPress administration page.<\/li>\n<li>Copy the contents of the \"map-navigator\/mappress-google-maps-for-wordpress\/*\" to \"wp-content\/plugins\/mappress-google-maps-for-wordpress\/\"<\/li>\n<li>Copy the contents of the \"map-navigator\/wp-affiliate-platform\/*\" to \"wp-content\/plugins\/wp-affiliate-platform\/\"<\/li>\n<li>Add a new Custom Field called 'map_address' in any post<\/li>\n<li>Go to MapPress Settings and Custom Fields section. Assign 'field for addresses' to 'map_address' <\/li>\n<li>Check \"Update map when post is updated\" and \"Update map when address is changed by a program\", then Save Changes<\/li>\n<\/ol>\n\n<!--section=faq-->\n<blockquote>\n  <p>I have quotation marks and commas as values in my Map Navigation file. How do I tell Map Navigator to use a different separator?<\/p>\n<\/blockquote>\n\n<p>It doesn't really matter what kind of separator you use if your file is\nproperly escaped. To see what I mean by proper escaping, take a look at\n    examples\/sample.csv file which has cells with quotation marks and commas.<\/p>\n\n<blockquote>\n  <p>How can I import characters with diacritics, Cyrillic or Han characters?<\/p>\n<\/blockquote>\n\n<p>Make sure to save your CSV file with utf-8 encoding.<\/p>\n\n<p>Prior to version 6.0.4, MySQL <a href=\"http:\/\/dev.mysql.com\/doc\/refman\/5.1\/en\/faqs-cjk.html#qandaitem-24-11-1-13\">did not support<\/a> some rare Han characters. As\na workaround, you can insert characters such as &#x2028e; (U+2028E) by\nconverting them to HTML entities - &amp;&#035;x2028e;<\/p>\n\n<blockquote>\n  <p>I'm importing a file, but not all rows in it are imported and I don't see\n  a confirmation message. Why?<\/p>\n<\/blockquote>\n\n<p>WordPress can be many things, but one thing it's not is blazing fast. The\nreason why not all rows are imported and there's no confirmation message is\nthat the plugin times out during execution - PHP decides that it has been\nrunning too long and terminates it.<\/p>\n\n<p>There are a number of solutions you can try. First, make sure that you're not\nusing any plugins that may slow down post insertion. For example, a Twitter\nplugin might attempt to tweet every post you import - not a very good idea\nif you have 200 posts. Second, you can break up a file into smaller chunks that\ntake less time to import and therefore will not cause the plugin to time out.\nThird, you can try adjusting PHP's <code>max_execution_time<\/code> option that sets how\nlong scripts are allowed to run. Description of how to do it is beyond the\nscope of this FAQ - you should search the web and\/or use your web host's help\nto find out how. However, putting the following line in <code>.htaccess<\/code> file inside\npublic_html directory works for some people:<\/p>\n<dl>\n<dt>Sets max execution time to 2 minutes. Adjust as necessary.<\/dt>\n<dd><p>php_value max_execution_time 120<\/p>\n\n<p>The problem can be approached from another angle, namely instead of giving\nscripts more time to run making them run faster. There's not much I can do to\nspeed up the plugin (you can contact me at dvkobozev at gmail.com if you like\nto prove me wrong), so you can try to speed up WordPress. It is a pretty broad\ntopic, ranging from database optimizations to PHP accelerators such as APC,\neAccelerator or XCache, so I'm afraid you're on your own here.<\/p>\n\n<blockquote>\n  <p>I'm getting the following error: <code>Parse error: syntax error, unexpected\n  T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or '}' in ...\/public_html\/wp-content\/plugins\/csv-importer\/File_CSV_DataSource\/DataSource.php\n  on line 61<\/code>. What gives?<\/p>\n<\/blockquote>\n\n<p>This plugin requires PHP5, while you probably have PHP4 or older. Update your\nPHP installation or ask your hosting provider to do it for you.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Add new Functionality<\/li>\n<li>\n<ul>\n<li>MapPress Map Tables cleanup to remove orphan maps<\/li>\n<\/ul><\/li>\n<li>\n<ul>\n<li>Link all maps in MapPress database into the MapNavigator Hierarchy<\/li>\n<\/ul><\/li>\n<li>\n<ul>\n<li>Option to update all posts with Maps to set Maps Taxonomy and tags<\/li>\n<\/ul><\/li>\n<li>\n<ul>\n<li>MapNavigator Admin Tool user interface updates for new functionality<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<h4>1.0.4<\/h4>\n\n<ul>\n<li>Move mappress_pro.php to the correct directory under mappress-google-maps-for-wordpress<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>ReadMe update for issue with screenshots not correct on WP site<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>ReadMe update for issue with update version not correct on WP site<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Code cleanup<\/li>\n<li>Documentation and insertion of a link to download map Navigation files by geography.<\/li>\n<li>Provide MapPress Icon to be inserted into Map Markers and specified on Tool Dialog<\/li>\n<\/ul>\n\n<h4>v1.0.0<\/h4>\n\n<ul>\n<li>Initial version of the plugin<\/li>\n<\/ul>","raw_excerpt":"Create Posts for Map Navigation for a geographical taxonomy using MapPress Google Maps in WordPress.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/16346","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=16346"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/rothmaniac"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=16346"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=16346"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=16346"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=16346"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=16346"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=16346"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}