[wordpress插件] CSV ImporterCSV导入器

This plugin imports posts from CSV (Comma Separated Value) files into your

此插件将CSV（逗号分隔值）文件中的帖子导入您的

WordPress blog.

WordPress博客。

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

Excel文档或类似文档中的帖子–只需将文档导出到

a CSV file and the plugin will take care of the rest.

CSV文件，其余的将由插件负责。

Features

功能

• Imports post title, body, excerpt, tags, date, categories etc.
• 导入帖子标题，正文，摘录，标签，日期，类别等。

• Supports custom fields, custom taxonomies and comments
• 支持自定义字段，自定义分类法和注释

• Deals with Word-style quotes and other non-standard characters using
  

• 使用
  以Word样式的引号和其他非标准字符进行交易

  WordPress’ built-in mechanism (same one that normalizes your input when you
  

  WordPress的内置机制（在您
  时，该机制可以规范您的输入

  write your posts)

写你的帖子）

• Columns in the CSV file can be in any order, provided that they have correct
  

• CSV文件中的列可以任意顺序，只要它们具有正确的
  

  headings

标题

• Multi-language support
• 多语言支持

Usage

用法

Click on the CSV Importer link on your WordPress admin page, choose the


点击WordPress管理页面上的CSV导入器链接，选择


file you would like to import and click Import.

您要导入的文件，然后单击导入。

The examples directory


examples 目录


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.

CSV是一种由行和列组成的表格格式。

Each row in


每行


a CSV file represents a post;

CSV文件代表帖子；

each column identifies a piece of information


每列标识一条信息


that comprises a post.

包含一个帖子。

Basic post information

基本信息

• csv_post_title – title of the post
• csv_post_title –帖子标题

• csv_post_post – body of the post
• csv_post_post –帖子正文

• csv_post_type – post, page or a custom post type.
  

• csv_post_type – post ， page 或自定义帖子类型。
  

  New in version 0.3.2
  

  0.3.2版的新功能
  

  In prior versions, importing rows as pages could be specified on a
  

  在以前的版本中，可以在
  上指定将行作为页面导入

  per-file basis using the plugins UI.

  使用插件的用户界面按文件分类。

  In 0.3.2, csv_post_type column
  

  在0.3.2中， csv_post_type 列


  was added to support custom post types as well.


  已添加以支持自定义帖子类型。


  Refer to the WordPress


  请参阅WordPress


  documentation on custom post types for more info


  有关自定义帖子类型的文档以获取更多信息


  on how to set up custom post types.

有关如何设置自定义帖子类型的信息。

• csv_post_excerpt – post excerpt
• csv_post_excerpt –摘录

• csv_post_categories – a comma separated list of category names or ids.
  

• csv_post_categories –用逗号分隔的类别名称或ID列表。
  

  New in version 0.3.5
  

  0.3.5版的新功能
  

  It’s also possible to assign posts to non-existing subcategories, using
  

  还可以使用
  将帖子分配给不存在的子类别

  > to denote category relationships, e.g.

  >表示类别关系，例如

  Animalia > Chordata > Mammalia.
  

  Animalia> Chordata> Mammalia 。


  If any of the categories in the chain does not exist, the plugin will


  如果链中没有任何类别，则插件将


  automatically create it.

  自动创建它。

  It’s also possible to specify the parent category


  还可以指定父类别


  using an id, as in 42 > Primates > Callitrichidae, where 42 is an


  使用ID，如 42> Primates> Callitrichidae ，其中 42 是


  existing category id.

现有类别ID。

• csv_post_tags – a comma separated list of tags.
• csv_post_tags –以逗号分隔的标签列表。

• csv_post_date – about any English textual description of a date and time.
  

• csv_post_date –关于日期和时间的任何英语文字描述。
  

  For example, now, 11/16/2009 0:00, 1999-12-31 23:55:00, +

  例如， now ， 2009/11/16 0:00 ， 1999-12-31 23:55:00 ， +

  1 week,
    

  1周，
    

  next Thursday, last year are all valid descriptions.

  下个星期四，去年都是有效的描述。

  For technical


  对于技术


  details, consult PHP's strtotime() function documentation.

  详细信息，请查阅PHP的 strtotime（）函数文档。

Custom fields

自定义字段

Any column that doesn’t start with csv_ is considered to be a custom field


任何以 csv _ 开头的列均被视为自定义字段


name.

名称。

The data in that column will be imported as the custom fields value.

该列中的数据将作为自定义字段值导入。

General remarks

一般说明

• WordPress pages don’t have categories or tags.
• WordPress页面没有类别或标签。

• Most columns are optional.

• 大多数列是可选的。

  Either csv_post_title, csv_post_post or
      

  csv_post_title ， csv_post_post 或
    

  csv_post_excerpt are sufficient to create a post.

  csv_post_excerpt足以创建一个帖子。

  If all of these


  如果所有这些


  columns are empty in a row, the plugin will skip that row.

列连续为空，插件将跳过该行。

• The plugin will attempt to reuse existing categories or tags;

• 该插件将尝试重用现有的类别或标签；

  if an
  

  如果
  

  existing category or tag cannot be found, the plugin will create it.

找不到现有的类别或标签，插件将创建它。

• To specify a category that has a greater than sign (>) in the name, use
  

• 要指定名称中带有大于号（>）的类别，请使用
  

  the HTML entity >

HTML实体＆gt;

Advanced usage

高级用法

• csv_post_author – numeric user id or login name.

• csv_post_author –数字用户ID或登录名。

  If not specified or
  

  如果未指定或
  

  user does not exist, the plugin will assign the posts to the user
  

  用户不存在，插件会将帖子分配给用户
  

  performing the import.

执行导入。

• csv_post_slug – post slug used in permalinks.
• csv_post_slug –永久链接中使用的后。

• csv_post_parent – post parent id.
• csv_post_parent –发布父ID。

Custom taxonomies

自定义分类法

New in version 0.3.0

版本0.3.0的新功能

Once custom taxonomies are set up in your theme’s functions.php file or


一旦在主题的functions.php文件或
中设置了自定义分类法，

by using a 3rd party plugin, csv_ctax_(taxonomy name) columns can be


通过使用第三方插件， csv_ctax_（分类名称）列可以


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 csv_post_tags syntax.

与 csv_post_tags 语法相同。

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


分类字段是一个很小的两列CSV文件，其中列的顺序


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).

可以是空字符串，也可以是0（零）。

Sample examples/custom-taxonomies.csv file included with the plugin


插件随附的

示例 examples / custom-taxonomies.csv 文件


illustrates custom taxonomy support.

说明了自定义分类支持。

To see how it works, make sure to set up


要查看其工作原理，请确保设置


custom taxonomies from functions.inc.php.

functions.inc.php 中的自定义分类法。

Make sure that the quotation marks used as text delimiters in csv_ctax_


确保在 csv_ctax _
中用作文本定界符的引号

columns are regular ASCII double quotes, not typographical quotes like “


列是常规的ASCII双引号，而不是“
”等印刷引号

(U+201C) and ” (U+201D).

（U + 201C）和”（U + 201D）。

Comments

评论

New in version 0.3.1

0.3.1版的新功能

An example file with comments is included in the examples directory.


examples 目录中包含带有注释的示例文件。


In short, comments can be imported along with posts by specifying columns


简而言之，可以通过指定列将评论与帖子一起导入


such as csv_comment_*_author, csv_comment_*_content etc, where * is


例如 csv_comment _ * _ author ， csv_comment _ * _ content 等，其中*是


a comment ID number.

评论ID号。

This ID doesn’t go into WordPress.

此ID不适用于WordPress。

It is only there


只有那里


to have the connection information in the CSV file.

在CSV文件中包含连接信息。

Credits

积分

This plugin uses php-csv-parser by Kazuyoshi Tlacaelel.<

此插件使用Kazuyoshi Tlacaelel的 php-csv-parser 。<

br />

br />

It was inspired by JayBlogger's CSV Import plugin

它的灵感来自JayBlogger的 CSV导入插件

.

Contributors:

贡献者：

• Kevin Hagerty (post_author support)
• Kevin Hagerty（作者后支持）

• Edir Pedro (root category option and tableless HTML markup)
• Edir Pedro（根类别选项和无表HTML标记）

• Frank Loeffler (comments support)
• 弗兰克·洛夫勒（评论支持）

• Micah Gates (subcategory syntax)
• Micah Gates（子类别语法）

• David Hollander (deprecation warnings, linebreak handling)
• David Hollander（弃用警告，换行处理）