Hook for getting image attachments IDs for the posts. Gallery by default uses meta key ‘tableon_gallery’ but sure on many sites image ids keeps in their own meta keys.
1 2 3 | add_filter('tableon_gallery', function($ids, $post_id) { return (array)get_post_meta($post_id, '__my_meta_key_with_img_ids', true); }, 10, 2); |
Manage by post labels for posts title cell. Code example:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | add_filter('tableon_titles_labels', function($labels=[], $post_id) { if (in_array(intval($post_id), [208])) { return [ [ 'title' => 'Label 1', 'css_class' => 'tableon-post-tag-out' ], [ 'title' => 'Label 2', 'css_class' => 'tableon-post-tag-featured' ], [ 'title' => 'Label 3', 'css_class' => 'tableon-post-tag-sale' ] ]; } return []; },10,2); |
This hooks allows to manipulate by the current language. Example:
1 2 3 4 5 6 7 8 | add_filter('tableon_current_lang', function($lang) { if (class_exists('SitePress')) { global $sitepress; $sitepress->switch_lang(substr($lang, 0, 2), true); } return $lang; }); |
The hook allows to change “Not found” text if no one posts were found in the table Example:
1 2 3 4 5 6 | add_filter('tableon_no_found_text', function($text, $table_id) { return sprintf(TABLEON_Vocabulary::get('Find more posts %s'), TABLEON_HELPER::draw_html_item('a', [ 'href' => 'https://pluginus.net', 'target' => '_blank' ], TABLEON_Vocabulary::get('here'))); }, 10, 2); |
This hook is helper for hook tableon_extend_settings and allows to set default data there. Example:
1 2 3 4 | add_action('tableon_extend_settings_default', function($defaults) { $defaults[$this->setting_key] = 'id,post_title,__price'; return $defaults; }, 10, 1); |
$this->setting_key – can be string value, for example ‘my_new_option_1’, see hook tableon_extend_settings.
By this hook it is possible to change text for “Load More” button. Also it is possible by: TABLEON_Vocabulary::get($word)
This hook allows to extend tables settings. Example:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 | add_filter('tableon_extend_options', 'my_tableon_extend_options', 10, 2); public function my_tableon_extend_options($rows, $table_id) { if ($table_id > 0) { if (TABLEON::get_table_action($table_id) === self::$action) { $rows[] = [ 'id' => $table_id, 'title' => esc_html__('Show Sorting Dropdown', 'posts-table'), 'value' => TABLEON_HELPER::draw_switcher('is_sort_droptdown_shown', tableon()->columns->options->get($table_id, 'is_sort_droptdown_shown', 0), $table_id, 'tableon_save_table_option'), 'value_custom_field_key' => 'is_sort_droptdown_shown', 'notes' => esc_html__('Displays Sorting Dropdown list', 'posts-table') ]; $rows[] = [ 'id' => $table_id, 'title' => esc_html__('Sorting Dropdown Fields', 'posts-table'), 'value' => TABLEON_HELPER::draw_select([ 'class' => 'tableon-multiple-select', 'multiple' => '', 'data-action' => 'tableon_save_table_option', 'data-values' => tableon()->columns->options->get($table_id, 'orderby_select_fields', ''), 'data-use-drag' => 1, ], apply_filters('tableon_table_orderby_select_args', self::$orderby_select_fields, $table_id), explode(',', tableon()->columns->options->get($table_id, 'orderby_select_fields', ''))), 'value_custom_field_key' => 'orderby_select_fields', 'notes' => esc_html__('fields which you want to see in Sorting Dropdown fields. Press and wait to reorder.', 'posts-table') ]; $rows[] = [ 'id' => $table_id, 'title' => esc_html__('Sorting Dropdown position', 'posts-table'), 'value' => TABLEON_HELPER::draw_select([ 'data-action' => 'tableon_save_table_option', ], [ 'right' => esc_html__('Right', 'posts-table'), 'left' => esc_html__('Left', 'posts-table'), ], tableon()->columns->options->get($table_id, 'sorting_position', 'right')), 'value_custom_field_key' => 'sorting_position', 'notes' => esc_html__('Sorting Dropdown position.', 'posts-table') ]; } } return $rows; } |
See also file: \classes\tables-options.php
This hook allows to manipulate by main WP_Query of the table data. Some examples:
1 2 3 4 5 6 | add_filter('tableon_wp_query_args', function($args, $table_id) { if ($table_id > 0) { $args['post__not_in'] = [1,2,3]; } return $args; }, 10, 2); |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | add_action('tableon_wp_query_args', function($args, $table_id) { if (!isset($args['meta_query'])) { $args['meta_query'] = []; } $args['meta_query'][] = array( 'key' => '_stock_status', 'value' => 'instock', 'compare' => 'IN' ); return $args; }, 10, 2); |
This hooks allows to make compatible a filters plugins with TABLEON. Lets review filter adaptation for MDTF (as an example ONLY because Compatibility for MDTF (redirect mode) in-built into the TABLEON code). into the file functions.php of the current WordPress theme add next code:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 | add_filter("tableon_profile_extend", function($profile, $action, $shortcode_args) { if ('tableon_default_tables' === $action) { if (isset($shortcode_args['filter_provider'])) { if ($shortcode_args['filter_provider'] === 'mdtf') { if (isset($_REQUEST['page_mdf']) AND!empty($_REQUEST['page_mdf'])) { $profile[0]['filter_provider'] = 'mdtf'; $_GLOBALS['MDF_META_DATA_FILTER'] = json_decode(base64_decode($_REQUEST['page_mdf']), true); $_REQUEST['mdf_do_not_render_shortcode_tpl'] = true; $_REQUEST['mdf_get_query_args_only'] = true; do_shortcode('[meta_data_filter_results]'); $args = $_REQUEST['meta_data_filter_args']; $args['posts_per_page'] = -1; $args['fields'] = 'ids'; if (isset($args['meta_query'])) { if (!empty($args['meta_query'])) { foreach ($args['meta_query'] as $key => $m) { if (isset($m['key'])) { if ($m['key'] === 'mdf_hide_post') { unset($args['meta_query'][$key]); } } } } } if (isset($args['ignore_sticky_posts'])) { unset($args['ignore_sticky_posts']); } unset($args['orderby']); unset($args['order']); //*** $profile[0]['filter_data'] = []; $profile[0]['filter_data']['ids'] = (new WP_Query($args))->posts; } //*** add_action('tableon_filter_provider_mdtf', function ($args, $filter_data) { if (!is_array($filter_data)) { $filter_data = json_decode($filter_data, true); } if (isset($filter_data['post_title']) AND!empty($filter_data['post_title'])) { tableon()->filter->provider($filter_data); } if (!empty($filter_data['ids'])) { $args['post__in'] = $filter_data['ids']; } else { //$args['post__in'] = [-1]; } return $args; }, 10, 2); } } } return $profile; }, 10, 3); |
This is for thumbnail column and allows to replace default empty thumbnail image
1 | apply_filters('tableon_no_img_found', $thumb, $table_id, $post_id) |
