Title: Zen Custom Fields
Author: Grzegorz Sarzy?ski
Published: <strong>2015 年 10 月 21 日</strong>
Last modified: 2019 年 5 月 9 日

---

搜索插件

**该插件尚未通过WordPress的最新3个主要版本进行测试**。 当与较新版本的WordPress一起
使用时，可能不再受到维护或支持，并且可能会存在兼容性问题。

![](https://ps.w.org/zen-custom-fields/assets/icon-256x256.png?rev=1270361)

# Zen Custom Fields

 作者：[Grzegorz Sarzy?ski](https://profiles.wordpress.org/grzecho/)

[下载](https://downloads.wordpress.org/plugin/zen-custom-fields.zip)

 * [详情](https://cn.wordpress.org/plugins/zen-custom-fields/#description)
 * [评价](https://cn.wordpress.org/plugins/zen-custom-fields/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/zen-custom-fields/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/zen-custom-fields/#developers)

 [支持](https://wordpress.org/support/plugin/zen-custom-fields/)

## 描述

The plugin converts regular HTML tables, embedded in your page, into arrays of values
that you can use in your templates to output the data.
 Custom fields can hold text
and any HTML code (except for tables). Array of values can be simple index based
or more complex key value pairs. You can embed many tables with values on your page
with various data.

#### 用法

 1. Place the table with values you want to use on your page between ‘[zen-fields] …[/
    zen-fields]’ short-tags
 2. In your template use ‘zen_field()’ function to output values from above table

If your would like to use multiple tables with values you should name ech table 
and use table name as the last parameter of `zen_field()` function

…

#### Iteration over values in tables

It is possible to iterate over values from your tables. The variable ‘$zen_fields-
>tables’ holds the array with values from all the tables on the page.

#### Escaping output

By default output is not escaped which allows you to use links, images and another
HTML content in your custom fields. If you would like to escape the output use ‘
zen_field_esc()’ function instead of ‘zen_field()’.

For more details check ‘Screenshots’ section

## 屏幕截图

 * [[
 * Basic usage – simple table with values only.
 * [[
 * A better approach is to use key/value pairs. In this case you should use table
   header tags for field names.
 * [[
 * Using 2 dimensional tables

## 安装

 1. Download zen-custom-fields.zip and unzip its content to the /wp-content/plugins/
    directory in your WordPress installation folder
 2. 通过WordPress的“插件”菜单激活插件

## 常见问题

  How to use this plugin?

Simply add table to your page between [zen-fileds] short-tags. And use `zen_field()`
function to output value from that table.

e.g. `<?php echo zen_field(1) ?>` – will output value from second row of your table
that contains values only

    ```
    <?php echo zen_field(1, 2) ?> - output values from 2 dimensional tables

    <?php echo zen_field('field name 2') ?> - output value from table with key names defined. Key names should be defined in `<th>` - table header tags.

    <?php echo zen_field('field name 2','column 1') ?> - output values from 2 dimensional table with key names defined.
    ```

Check ‘Screenshots’ section for more details.

  How to use multiple tables?

Firstly define the name of each table e.g. `<table data-name="some table name">...
</table>`, secondly use the table name in the last parameter of `zen_field()` function

e.g. `<?php echo zen_field('field name 1','column name 2', 'some table name') ?>`

  How to iterate over table values

The variable `$zen_fields->tables` holds an array with values from all the tables
on the page. You can use this variable to iterate the data. The way varies depending
on table structure. You can output structure of the variable for testing using `
<pre><?php print_r($zen_fields->tables) ?></pre>` code.

  How to report errors or submit feature requests?

You can submit an issue on GitHub page, where the main repository of the plugin 
is held. GitHub account is needed.

https://github.com/Grzegorzsa/zen-custom-fields/issues

  How to escape output from values of the table

By default output is not escaped which allows you to echo html tags e.g. links or
images. If you would like to escape your output use ‘zen_field_esc()’ instead of‘
zen_field()’ function.

  How to get image src attribute

‘zen_field_src()’ function can be used to extract link from the image placed in 
custom field.

## 评价

此插件暂无评价。

## 贡献者及开发者

「Zen Custom Fields」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ Grzegorz Sarzy?ski ](https://profiles.wordpress.org/grzecho/)

[帮助将「Zen Custom Fields」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/zen-custom-fields)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/zen-custom-fields/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/zen-custom-fields/)，或通过[RSS](https://plugins.trac.wordpress.org/log/zen-custom-fields/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/zen-custom-fields/)。

## 更新日志

#### 1.16

 * Fix issues with `<br>` tags in new version of WordPress

#### 1.15

 * Fix get variables outside of post loop

#### 1.14

 * Fix critical bug

#### 1.13

 * Prevent from showing errors when no custom fields are defined

#### 1.12

 * Improve data iteration
 * Fix problem with plugin initalization
 * Add parse image source function

#### 1.11

 * Fix critical bug

#### 1.1

 * Fix bugs
 * Allow attributes in `<th>` element

## 额外信息

 *  版本 **1.16**
 *  最后更新：**7 年前**
 *  活跃安装数量 **10+**
 *  WordPress 版本 ** 3.1 或更高版本 **
 *  已测试的最高版本为 **5.2.24**
 *  语言
 * [English (US)](https://wordpress.org/plugins/zen-custom-fields/)
 * 标签
 * [custom fields](https://cn.wordpress.org/plugins/tags/custom-fields/)[custom templates](https://cn.wordpress.org/plugins/tags/custom-templates/)
   [post meta](https://cn.wordpress.org/plugins/tags/post-meta/)
 *  [高级视图](https://cn.wordpress.org/plugins/zen-custom-fields/advanced/)

## 评级

尚未提交反馈。

[Your review](https://wordpress.org/support/plugin/zen-custom-fields/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/zen-custom-fields/reviews/)

## 贡献者

 *   [ Grzegorz Sarzy?ski ](https://profiles.wordpress.org/grzecho/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/zen-custom-fields/)