ACF: TablePress

ACF field type to select a TablePress table

Author:Tyler Digital (profile at wordpress.org)
WordPress version required:4.0
WordPress version tested:4.5.31
Plugin version:1.3.2
Added to WordPress repository:04-05-2015
Last updated:14-07-2016
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
Rating, %:100
Rated by:4
Plugin URI:
Total downloads:22 453
Active installs:1 000+
plugin download
Click to start download

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.


ChangeLog