rothmaniac

This plugin imports a Map Navigation file into your WordPress blog. 
The Map Navigation file defines one or more Continents, Countries, Regions, States and Cities. 
The plugin creates Posts that each contain a MapPress map or mashup that provide a linked 
navigation of the geography using your organization’s name, image file and icon in the Post’s 
Post, Excerpt and on the Map markers. The Map Navigation hierarchy can then be added to your 
themes header or provided as a link so that your organization can locate its members Posts 
or Pages by Geographical area. The plugin also provides an affiliate Register script that adds 
an Affiliate to your Map Navigation hierarchy along with their link and image when they join 
your organization. Any post can be added to the Map Navigation hierarchy using the Map Taxonomy 
tags and a Custom field used by the MapPress plugin. Exisitng MapPress maps can be linked into 
the Map Navigation Hierarchy from the MapNavigator Admin Tool Interface.
This plugin is built on top of the CSV Importer plugin so it contains all of the features of 
CSV Importer with the additional customized features for MapPress Google maps navigation.
<h3>Map Navigator features</h3>
<ul>
<li>Map Navigation Files available (for a small fee) for geographical areas (USA available now)</li>
<li>Documentation and Sample file so that you can create your own Map Navigation File </li>
<li>Automatically creates the MapPress Maps, Mashups and Markers with your organizations:
<ul>
<li>Name or Title</li>
<li>Link to website or other location </li>
<li>Image from an http:// link</li>
<li>Icon from a list of icons supplied by MapPress or a custom icon placed into the MapPress icon directory</li>
</ul>
</li>
<li>Cleans database for ‘orphaned’ MapPress Maps</li>
<li>Links exisitng MapPress Maps into your Map Navigation hierarchy</li>
<li>Creates a Map Taxonomy that provides easy categorization of a Post by geographical location</li>
<li>Provides the ability to add any post to your Map Navigation hierarchy without coding any 
complex MapPress parameters.</li>
<li>Provides a customized WP-Affiliate Registration script that will place your new affiliate on the 
appropriate Map in your Map Navigation hierarchy</li>
<li>Provides several customizations to the MapPress plugin to address limitations and enhancements that 
provide the above functionality</li>
</ul>
<h4>CSV Importer Features</h4>
<ul>
<li>Imports post title, body, excerpt, tags, date, categories etc.</li>
<li>Supports custom fields, custom taxonomies and comments</li>
<li>Deals with Word-style quotes and other non-standard characters using 
WordPress’ built-in mechanism (same one that normalizes your input when you 
write your posts)</li>
<li>Columns in the CSV file can be in any order, provided that they have correct 
headings</li>
<li>Multilanguage support</li>
</ul>
<h3>Usage</h3>
Click on the Map Navigator link on your WordPress admin page, choose the 
Map Definition file you would like to import and click Import. You can 
build your own Map Definition file using the example file “Test Map-Navigator-USA.csv” in the <code>examples</code> directory 
inside the plugin’s directory or you can download one for a small fee from:
http://mapclick.org
The Map Definition file is in CSV format that consists of rows and columns. Each row in 
a CSV file represents a post; each column identifies a piece of information 
that comprises a post. Each Post is assigned to a level in the Map Taxonomy which provides 
the Map Navigational Hierarchy as follows:
Maps Taxonomy 
* Continent 
 * Country 
 * Region (optional) 
 * State (optional) 
 * City
<h4>Basic post information</h4>
<ul>
<li>
<code>nav_post_title</code> – title of the post. The name should reflect the category of the taxonomy level. For instance : ‘United States Regions’ 
 or ‘Mountain Region States’ or ‘California Map’
</li>
<li>
<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
</li>
<li>
<code>nav_post_excerpt</code> – post excerpt. This will contain the title that will appear in the Map Marker. The word ‘mapClicks’ 
 will be replaced with your organization’s name entered on the Map Navigator Tool dialog in WordPress.
</li>
<li>
<code>nav_post_categories</code> – a comma separated list of category names or ids. This will be the level associated with this post; 
 for instance : Maps > Continent > Country > Region
</li>
<li>
<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 
 mashup post. See the Examples directory for a sample file. Pay close attention to the tags defined in this column and the references 
 in the nav_post_post column.
</li>
<li>
<code>nav_post_date</code> – about any English textual description of a date and time. 
For example, <code>now</code>, <code>11/16/2009 0:00</code>, <code>1999-12-31 23:55:00</code>, <code>+1 week</code>, 
 next Thursday, <code>last year</code> are all valid descriptions. For technical 
details, consult PHP’s <code>strtotime()</code> function <a href="http://php.net/manual/en/function.strtotime.php" rel="nofollow ugc">documentation</a>.
</li>
<li>
nav_ctax_maps – See the Examples directory for a sample file (Test Map-Navigator-USA.csv). 
 This column is used to specify the Post’s taxonomy tags and thus what the post will appear as in the ‘Maps’ taxonomy 
 (Continent, Country, Region, State or City)
</li>
<li>
‘map_address’ – holds the address of the MapPress map marker. This must be defined as a Custom field and specified in the 
 MapPress setup as the field used to create maps automatically from when a post is updated.
</li>
</ul>
<h4>Custom fields</h4>
Any column that doesn’t start with <code>nav_</code> is considered to be a custom field 
name. The data in that column will be imported as the custom field’s value.
<h4>General remarks</h4>
<ul>
<li>WordPress pages <a href="https://codex.wordpress.org/Pages" rel="nofollow ugc">don’t have categories or tags</a>.</li>
<li>Most columns are optional. Either <code>nav_post_title</code>, <code>nav_post_post</code> or 
 nav_post_excerpt are sufficient to create a post. If all of these 
columns are empty in a row, the plugin will skip that row.</li>
<li>The plugin will attempt to reuse existing categories or tags; if an 
existing category or tag cannot be found, the plugin will create it.</li>
<li>To specify a category that has a greater than sign (>) in the name, use 
the HTML entity <code>&gt;</code></li>
</ul>
<h4>Advanced usage</h4>
<ul>
<li><code>nav_post_author</code> – numeric user id or login name. If not specified or 
user does not exist, the plugin will assign the posts to the user 
performing the import.</li>
<li><code>nav_post_slug</code> – post slug used in permalinks.</li>
<li><code>nav_post_parent</code> – post parent id.</li>
</ul>
<h3>Custom taxonomies</h3>
Once custom taxonomies are set up in your theme’s functions.php file or 
by using a 3rd party plugin, <code>nav_ctax_(taxonomy name)</code> columns can be 
used to assign imported data to the taxonomies.
Non-hierarchical taxonomies
The syntax for non-hierarchical taxonomies is straightforward and is essentially 
the same as the <code>nav_post_tags</code> syntax.
Hierarchical taxonomies
The syntax for hierarchical taxonomies is more complicated. Each hierarchical 
taxonomy field is a tiny two-column CSV file, where the order of columns 
matters. The first column contains the name of the parent term and the second 
column contains the name of the child term. Top level terms have to be preceded 
either by an empty string or a 0 (zero).
Sample <code>examples/custom-taxonomies.csv</code> file included with the plugin 
illustrates custom taxonomy support. To see how it works, make sure to set up 
custom taxonomies from <code>functions.inc.php</code>.
Make sure that the quotation marks used as text delimiters in <code>nav_ctax_</code> 
columns are regular ASCII double quotes, not typographical quotes like “ 
(U+201C) and ” (U+201D).
<h3>Comments</h3>
An example file with comments is included in the <code>examples</code> directory. 
In short, comments can be imported along with posts by specifying columns 
such as <code>nav_comment_*_author</code>, <code>nav_comment_*_content</code> etc, where * is 
a comment ID number. This ID doesn’t go into WordPress. It is only there 
to have the connection information in the CSV file.
<h3>Credits</h3>
This plugin is based upon [csv-importer][3] by Denis Kobozev (thanks !) . 
This plugin uses [php-csv-parser][3] by Kazuyoshi Tlacaelel (thanks !).
Contributors: 
* Israeli Rothman (Original Idea and Requirements Spec)

Map Navigator

Create Posts for Map Navigation for a geographical taxonomy using MapPress Google Maps in WordPress.

Jason Judge

This WordPress plugin imports posts from CSV (Comma Separated Value) files into your 
WordPress blog. It can prove extremely useful when you want to import a bunch 
of posts from an Excel document or the like – simply export your document into 
a CSV file and the plugin will take care of the rest.
https://wordpress.org/plugins/csv-importer-improved/
<h4>Features</h4>
<ul>
<li>Imports post title, body, excerpt, tags, date, categories etc.</li>
<li>Supports custom fields, custom taxonomies and comments</li>
<li>Deals with Word-style quotes and other non-standard characters using 
WordPress’ built-in mechanism (same one that normalizes your input when you 
write your posts)</li>
<li>Columns in the CSV file can be in any order, provided that they have correct 
headings</li>
<li>Multi-language support</li>
</ul>
This plugin is forked from https://wordpress.org/plugins/csv-importer/ by dvkob 
in order to keep up with changes to the core WordPress.
This importer writes directly to the database. It does not go through the internal 
WordPress objects for creating posts etc. That may be an advantage to you (it will 
be faster for large imports) but do be aware of any data integrity issues that may arrise.
Only UTF-8 encoding is supported, both with and without Byte Order Marks (BOM).
The development repository for this plugin can be found here:
https://github.com/academe/csv-importer-improved
Please feel free to raise issues there, and submit pull requests, as well as through 
the normal WordPress channels.
<h3>Usage</h3>
Click on the CSV Importer link on your WordPress admin page, choose the 
file you would like to import and click Import. The <code>examples</code> directory 
inside the plugin’s directory contains several files that demonstrate 
how to use the plugin. The best way to get started is to import one of 
these files and look at the results.
CSV is a tabular format that consists of rows and columns. Each row in 
a CSV file represents a post; each column identifies a piece of information 
that comprises a post.
You can create new posts, or update existing posts by supplying the csv_post_id 
field pointing to an existing post. When updating, all field names you provide 
in the CSV file will be updated – even if blank – but fields you don’t list at 
the head of the CSV file will be left intact.
<h4>Basic post information</h4>
<ul>
<li><code>csv_post_id</code> – optional, used to update an existing post.</li>
<li><code>csv_post_title</code> – title of the post</li>
<li><code>csv_post_post</code> – body of the post</li>
<li><code>csv_post_type</code> – <code>post</code>, <code>page</code> or a custom post type. 
From 0.3.2, <code>csv_post_type</code> column supports custom post types. 
Refer to the WordPress 
<a href="https://codex.wordpress.org/Custom_Post_Types" rel="nofollow ugc">documentation on custom post types</a> for more info 
on how to set up custom post types.</li>
<li><code>csv_post_excerpt</code> – post excerpt</li>
<li><code>csv_post_categories</code> – a comma separated list of category names or ids. 
The list must be enclosed in quotes, e.g. “EC > UK, Island”. 
If a chain of subcategories does not exist, e.g. <code>Animalia > Chordata > Mammalia</code> 
then they will all be created and the post assigned to the end of the chain. 
The parent category can also be defined using its id, e.g. 
 42 > Primates > Callitrichidae, where <code>42</code> is an 
existing category id.</li>
<li><code>csv_post_tags</code> – a “quoted” comma separated list of tags.</li>
<li><code>csv_post_date</code> – most standard formats are supported. 
For example, <code>now</code>, <code>11/16/2009 0:00</code>, <code>1999-12-31 23:55:00</code>, <code>+1 week</code>, 
 next Thursday, <code>last year</code> are all valid. For technical 
details, consult PHP’s <code>strtotime()</code> function <a href="http://php.net/manual/en/function.strtotime.php" rel="nofollow ugc">documentation</a>.</li>
</ul>
<h4>Custom fields</h4>
Any column that doesn’t start with <code>csv_</code> is considered to be a custom field 
name. The data in that column will be imported as the custom fields value.
All custom fields must be unique. Multiple fields with the same name will be 
updated to the same value if updating an existing post. 
Prior to version 0.6.0 loading the same field name multiple times to an existing 
post would create multiple custom fields.
<h4>General remarks</h4>
<ul>
<li>WordPress pages <a href="https://codex.wordpress.org/Pages" rel="nofollow ugc">don’t have categories or tags</a>.</li>
<li>Most columns are optional. Either <code>csv_post_title</code>, <code>csv_post_post</code> or 
 csv_post_excerpt are sufficient to create a post. If all of these 
columns are empty in a row, the plugin will skip that row.</li>
<li>The plugin will attempt to reuse existing categories or tags; if an 
existing category or tag cannot be found, the plugin will create it.</li>
<li>To specify a category that has a greater than sign (>) in the name, use 
the HTML entity <code>&gt;</code></li>
</ul>
<h4>Advanced usage</h4>
<ul>
<li><code>csv_post_author</code> – numeric user id or login name. If not specified or 
user does not exist, the plugin will assign the posts to the user 
performing the import.</li>
<li><code>csv_post_slug</code> – post slug used in permalinks.</li>
<li><code>csv_post_parent</code> – post parent id.</li>
</ul>
<h3>Custom taxonomies</h3>
New in version 0.3.0
Once custom taxonomies are set up in your theme’s functions.php file or 
by using a 3rd party plugin, <code>csv_ctax_(taxonomy name)</code> columns can be 
used to assign imported data to the taxonomies.
Non-hierarchical taxonomies
The syntax for non-hierarchical taxonomies is straightforward and is essentially 
the same as the <code>csv_post_tags</code> syntax.
Hierarchical taxonomies
The syntax for hierarchical taxonomies is more complicated. Each hierarchical 
taxonomy field is a tiny two-column CSV file, where the order of columns 
matters. The first column contains the name of the parent term and the second 
column contains the name of the child term. Top level terms have to be preceded 
either by an empty string or a 0 (zero).
Sample <code>examples/custom-taxonomies.csv</code> file included with the plugin 
illustrates custom taxonomy support. To see how it works, make sure to set up 
custom taxonomies from <code>functions.inc.php</code>.
Make sure that the quotation marks used as text delimiters in <code>csv_ctax_</code> 
columns are regular ASCII double quotes, not typographical quotes like “ 
(U+201C) and ” (U+201D).
<h3>Comments</h3>
New in version 0.3.1
An example file with comments is included in the <code>examples</code> directory. 
In short, comments can be imported along with posts by specifying columns 
such as <code>csv_comment_*_author</code>, <code>csv_comment_*_content</code> etc, where * is 
a comment ID number. This ID doesn’t go into WordPress. It is only there 
to have the connection information in the CSV file.
<h3>Credits</h3>
This plugin uses <a href="http://code.google.com/p/php-csv-parser/" rel="nofollow ugc">php-csv-parser</a> by Kazuyoshi Tlacaelel. 
It was inspired by JayBlogger’s <a href="http://www.jayblogger.com/the-birth-of-my-first-plugin-import-csv/" rel="nofollow ugc">CSV Import</a> plugin.
Contributors:
<ul>
<li>Kevin Hagerty (post_author support)</li>
<li>Edir Pedro (root category option and tableless HTML markup)</li>
<li>Frank Loeffler (comments support)</li>
<li>Micah Gates (subcategory syntax)</li>
<li>David Hollander (deprecation warnings, linebreak handling)</li>
</ul>

CSV Importer Improved

Import posts from CSV files into WordPress.

Map Navigator vs CSV Importer Improved