Skip to content
  • Log In
  • Register
WordPress.org

English (UK)

  • Themes
  • Plugins
  • News
  • About
  • Support
  • Patterns
  • Get Involved
    • Translations
  • Team P2
  • Get WordPress
Get WordPress

Plugins

  • My Favourites
  • Beta Testing
  • Developers

This plugin hasn’t been tested with the latest three major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Download

Zen Custom Fields

By Grzegorz SarzyƄski
  • Details
  • Reviews
  • Installation
  • Development
Support

Description

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.

Usage

  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

Screenshots

  • 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

Installation

  1. Download zen-custom-fields.zip and unzip its content to the /wp-content/plugins/ directory in your WordPress installation folder
  2. Activate the plugin through the ‘Plugins’ menu in WordPress

FAQ

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.

Reviews

There are no reviews for this plugin.

Contributors and Developers

“Zen Custom Fields” is open source software. The following people have contributed to this plugin.

Contributors
  • Grzegorz Sarzy?ski

Translate “Zen Custom Fields” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Change Log

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

Meta

  • Version: 1.16
  • Last updated: 4 years ago
  • Active installations: 10+
  • WordPress Version: 3.1 or higher
  • Tested up to: 5.2.17
  • Language:
    English (US)
  • Tags:
    custom fieldscustom templatespost meta
  • Advanced View

Ratings

This plugin has not been rated yet.

Log in to submit a review.

Contributors

  • Grzegorz Sarzy?ski

Support

Got something to say? Need help?

View support forum

  • About
  • News
  • Hosting
  • Donate
  • Swag
  • Documentation
  • Developers
  • Get Involved
  • Learn
  • Showcase
  • Plugins
  • Themes
  • Patterns
  • WordCamp
  • WordPress.TV
  • BuddyPress
  • bbPress
  • WordPress.com
  • Matt
  • Privacy
  • Public Code
WordPress.org
WordPress.org

English (UK)

  • Visit our Facebook page
  • Visit our Twitter account
  • Visit our Instagram account
  • Visit our LinkedIn account
Code is Poetry