ACF: TablePress

July 14, 2016

ACF: TablePress Plugin

ACF field type to select a TablePress table

This is an extension for the popular Advanced Custom Fields plugin and TablePress plugin. By itself, this plugin does NOTHING.

This add-on for Advanced Custom Fields creates a custom field type to select a TablePress table, providing a dropdown menu that lets you select from a list of available tables. The field can return the table ID for the table selected, or the full HTML of the table.

This plugin requires:

  • Advanced Custom Fields version 4+ or 5+
  • TablePress version 1.5+

Just to be sure there’s no confusion…This plugin does nothing unless ACF (Or ACF Pro) and TablePress are both active on your site

Follow this plugin on GitHub

Using the Field

This field can return the table ID for the table selected, or the full HTML of the table (the same output as the rendered shortcode).

When returning the table ID, either of the following code snippets will output your table (replacing ‘your_table_here’ with the field name you defined in your ACF Field Group settings).

<?php $tablepress_id = get_field( 'your_field_here' ); echo do_shortcode( '[table id="'.$tablepress_id.'"]' ); ?> 

or, to avoid using do_shortcode(), use

<?php $tablepress_id = get_field( 'your_field_here' ); $args = array( 'id' => $tablepress_id, ); if ( function_exists( 'tablepress_print_table' ) ) { tablepress_print_table( $args ); } ?> 

To simply display the chosen table on your page, choose the HTML output option in your field settings, and insert into your php with

the_field( 'your_field_here' ); 

For a more detailed explanation, see our article, Setting up an ACF field for TablePress.

Installation

  1. Copy the acf-tablepress folder into your plugins folder
  2. Activate the plugin via the Plugins admin page

Changelog

1.3.2

  • Fix: Fixed bug that prevented non-administrator users from inserting tables.
  • Fix: Fixed bug that failed to display the table while logged out and using “HTML Output”

1.3.1

  • Fix: Fixed undefined variable notices introduced in 1.3.

1.3

  • Update: Improved activation check: plugin now checks for Advanced Custom Fields as well as TablePress before activating.

1.2.2

  • Update: Drop-down list sorts by table title instead of table ID.

1.2.1

  • Fix: bug intoducted in last update displaying wrong version number.

1.2

  • Update: Updated TGM-Plugin-Activation library to 2.5.2

1.1

  • New: Added i18n support
  • New: Added Portuguese translations (pt_PT, pt_BR)
  • Update: Changed text domain to match the plugin slug (‘acf-tablepress’)
  • Update: Removed hard-coded settings in rendered tables

1.0

  • Initial Release

Details

  • Version: 1.3.2
  • Active installations: 1,000
  • WordPress Version: 4.0
  • Tested up to: 4.5.32

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars