settings = array( 'version' => '1.3.5', 'dir_url' => plugins_url( '', __FILE__ ) . '/', ); /* * name (string) Single word, no spaces. Underscores allowed */ $this->name = 'table'; /* * label (string) Multiple words, can include spaces, visible when selecting a field type */ $this->label = __('Table', 'acf-table'); /* * category (string) basic | content | choice | relational | jquery | layout | CUSTOM GROUP NAME */ $this->category = 'layout'; /* * defaults (array) Array of default settings which are merged into the field object. These are used later in settings */ $this->defaults = array( //'font_size' => 14, ); /* * l10n (array) Array of strings that are used in JavaScript. This allows JS strings to be translated in PHP and loaded via: * var message = acf._e('table', 'error'); */ $this->l10n = array( //'error' => __('Error! Please enter a higher value.', 'acf-table'), ); // do not delete! parent::__construct(); // PREVENTS SAVING INVALID TABLE FIELD JSON DATA { if ( ! defined( 'ACF_TABLEFIELD_FILTER_POSTMETA' ) OR constant( 'ACF_TABLEFIELD_FILTER_POSTMETA' ) === true ) { add_filter( 'update_post_metadata', function( $x, $object_id, $meta_key, $meta_value, $prev_value ) { // detecting ACF table json if ( is_string( $meta_value ) and strpos( $meta_value, '"acftf":{' ) !== false ) { // is new value a valid json string json_decode( $meta_value ); if ( json_last_error() !== JSON_ERROR_NONE ) { // canceling meta value uptdate error_log( 'The plugin advanced-custom-fields-table-field prevented a third party update_post_meta( ' . $object_id . ', "' . $meta_key . '", $value ); action that would save a broken JSON string.' . "\n" . 'For details see https://codex.wordpress.org/Function_Reference/update_post_meta#Character_Escaping.' ); return true; } } return $x; }, 10, 5 ); } // } } /* * render_field_settings() * * Create extra settings for your field. These are visible when editing a field * * @type action * @since 3.6 * @date 23/01/13 * * @param $field (array) the $field being edited * @return n/a */ function render_field_settings( $field ) { /* * acf_render_field_setting * * This function will create a setting for your field. Simply pass the $field parameter and an array of field settings. * The array of settings does not require a `value` or `prefix`; These settings are found from the $field array. * * More than one setting can be added by copy/paste the above code. * Please note that you must also have a matching $defaults value for the field name (font_size) */ acf_render_field_setting( $field, array( 'label' => __('Table Header','acf-table'), 'instructions' => __('Presetting the usage of table header','acf-table'), 'type' => 'radio', 'name' => 'use_header', 'choices' => array( 0 => __( "Optional", 'acf-table' ), 1 => __( "Yes", 'acf-table' ), 2 => __( "No", 'acf-table' ), ), 'layout' => 'horizontal', 'default_value' => 0, )); acf_render_field_setting( $field, array( 'label' => __('Table Caption','acf-table'), 'instructions' => __('Presetting the usage of table caption','acf-table'), 'type' => 'radio', 'name' => 'use_caption', 'choices' => array( 1 => __( "Yes", 'acf-table' ), 2 => __( "No", 'acf-table' ), ), 'layout' => 'horizontal', 'default_value' => 2, )); } /* * render_field() * * Create the HTML interface for your field * * @param $field (array) the $field being rendered * * @type action * @since 3.6 * @date 23/01/13 * * @param $field (array) the $field being edited * @return n/a */ function render_field( $field ) { /* * Review the data of $field. * This will show what data is available */ if ( empty( $field['use_header'] ) ) { $field['use_header'] = 0; } if ( empty( $field['use_caption'] ) ) { $field['use_caption'] = 0; } $data_field['use_header'] = $field['use_header']; $data_field['use_caption'] = $field['use_caption']; $e = ''; $e .= '
'; $e .= '
'; // OPTION HEADER { if ( $data_field['use_header'] === 0 ) { $e .= '
'; $e .= ''; $e .= ''; $e .= '
'; } // } // OPTION CAPTION { if ( $data_field['use_caption'] === 1 ) { $e .= '
'; $e .= '
'; $e .= ''; $e .= '
'; } // } $e .= '
'; if ( is_array( $field['value'] ) ) { $field['value'] = wp_json_encode( $field['value'] ); } if ( is_string( $field['value'] ) ) { if ( substr( $field['value'] , 0 , 1 ) === '{' ) { $field['value'] = urlencode( $field['value'] ); } } $e .= '
'; $e .= ''; $e .= '
'; $e .= '
'; echo $e; } /* * input_admin_enqueue_scripts() * * This action is called in the admin_enqueue_scripts action on the edit screen where your field is created. * Use this action to add CSS + JavaScript to assist your render_field() action. * * @type action (admin_enqueue_scripts) * @since 3.6 * @date 23/01/13 * * @param n/a * @return n/a */ function input_admin_enqueue_scripts() { // register & include JS wp_enqueue_script( 'acf-input-table', $this->settings['dir_url'] . 'js/input-v5.js', array( 'jquery', 'acf-input' ), $this->settings['version'], true ); // register & include CSS wp_register_style( 'acf-input-table', $this->settings['dir_url'] . 'css/input.css', array( 'acf-input' ), $this->settings['version'] ); wp_enqueue_style( 'acf-input-table' ); } /* * input_admin_head() * * This action is called in the admin_head action on the edit screen where your field is created. * Use this action to add CSS and JavaScript to assist your render_field() action. * * @type action (admin_head) * @since 3.6 * @date 23/01/13 * * @param n/a * @return n/a */ /* function input_admin_head() { } */ /* * input_form_data() * * This function is called once on the 'input' page between the head and footer * There are 2 situations where ACF did not load during the 'acf/input_admin_enqueue_scripts' and * 'acf/input_admin_head' actions because ACF did not know it was going to be used. These situations are * seen on comments / user edit forms on the front end. This function will always be called, and includes * $args that related to the current screen such as $args['post_id'] * * @type function * @date 6/03/2014 * @since 5.0.0 * * @param $args (array) * @return n/a */ /* function input_form_data( $args ) { } */ /* * input_admin_footer() * * This action is called in the admin_footer action on the edit screen where your field is created. * Use this action to add CSS and JavaScript to assist your render_field() action. * * @type action (admin_footer) * @since 3.6 * @date 23/01/13 * * @param n/a * @return n/a */ /* function input_admin_footer() { } */ /* * field_group_admin_enqueue_scripts() * * This action is called in the admin_enqueue_scripts action on the edit screen where your field is edited. * Use this action to add CSS + JavaScript to assist your render_field_options() action. * * @type action (admin_enqueue_scripts) * @since 3.6 * @date 23/01/13 * * @param n/a * @return n/a */ /* function field_group_admin_enqueue_scripts() { } */ /* * field_group_admin_head() * * This action is called in the admin_head action on the edit screen where your field is edited. * Use this action to add CSS and JavaScript to assist your render_field_options() action. * * @type action (admin_head) * @since 3.6 * @date 23/01/13 * * @param n/a * @return n/a */ /* function field_group_admin_head() { } */ /* * load_value() * * This filter is applied to the $value after it is loaded from the db * * @type filter * @since 3.6 * @date 23/01/13 * * @param $value (mixed) the value found in the database * @param $post_id (mixed) the $post_id from which the value was loaded * @param $field (array) the field array holding all the field options * @return $value */ /* function load_value( $value, $post_id, $field ) { return $value; } */ /* * update_value() * * This filter is applied to the $value before it is saved in the db * * @type filter * @since 3.6 * @date 23/01/13 * * @param $value (mixed) the value found in the database * @param $post_id (mixed) the $post_id from which the value was loaded * @param $field (array) the field array holding all the field options * @return $value */ function update_value( $value, $post_id, $field ) { if ( is_string( $value ) ) { $value = wp_unslash( $value ); $value = urldecode( $value ); $value = json_decode( $value, true ); } // UPDATE via update_field() { if ( isset( $value['header'] ) OR isset( $value['body'] ) ) { $data = get_post_meta( $post_id, $field['name'], true ); // prevents updating a field, thats data are not defined yet if ( empty( $data ) ) { return false; } if ( is_string( $data ) ) { $data = json_decode( $data, true ); } if ( isset( $value['caption'] ) ) { $data['p']['ca'] = $value['caption']; } if ( isset( $value['header'] ) AND $value['header'] !== false ) { $data['h'] = $value['header']; } if ( isset( $value['body'] ) ) { $data['b'] = $value['body']; } $value = $data; } // } $value = $this->table_slash( $value ); return $value; } /* * format_value() * * This filter is appied to the $value after it is loaded from the db and before it is returned to the template * * @type filter * @since 3.6 * @date 23/01/13 * * @param $value (mixed) the value which was loaded from the database * @param $post_id (mixed) the $post_id from which the value was loaded * @param $field (array) the field array holding all the field options * * @return $value (mixed) the modified value */ function format_value( $value, $post_id, $field ) { if ( is_string( $value ) ) { // CHECK FOR GUTENBERG BLOCK CONTENT (URL ENCODED JSON) { if ( substr( $value , 0 , 1 ) === '%' ) { $value = urldecode( $value ); } // } $value = json_decode( $value, true ); // decode gutenberg JSONs, but also old table JSONs strings to array } $a = $value; $value = false; // IF BODY DATA if ( ! empty( $a['b'] ) AND count( $a['b'] ) > 0 ) { // IF HEADER DATA if ( $a['p']['o']['uh'] === 1 ) { $value['header'] = $a['h']; } else { $value['header'] = false; } // IF CAPTION DATA if ( ! empty( $field['use_caption'] ) AND $field['use_caption'] === 1 AND ! empty( $a['p']['ca'] ) ) { $value['caption'] = $a['p']['ca']; } else { $value['caption'] = false; } // BODY $value['body'] = $a['b']; // IF SINGLE EMPTY CELL, THEN DO NOT RETURN TABLE DATA if ( count( $a['b'] ) === 1 AND count( $a['b'][0] ) === 1 AND trim( $a['b'][0][0]['c'] ) === '' ) { $value = false; } } return $value; } /* * validate_value() * * This filter is used to perform validation on the value prior to saving. * All values are validated regardless of the field's required setting. This allows you to validate and return * messages to the user if the value is not correct * * @type filter * @date 11/02/2014 * @since 5.0.0 * * @param $valid (boolean) validation status based on the value and the field's required setting * @param $value (mixed) the $_POST value * @param $field (array) the field array holding all the field options * @param $input (string) the corresponding input name for $_POST value * @return $valid */ /* function validate_value( $valid, $value, $field, $input ){ // Basic usage if( $value < $field['custom_minimum_setting'] ) { $valid = false; } // Advanced usage if( $value < $field['custom_minimum_setting'] ) { $valid = __('The value is too little!','acf-table'), } // return return $valid; } */ /* * delete_value() * * This action is fired after a value has been deleted from the db. * Please note that saving a blank value is treated as an update, not a delete * * @type action * @date 6/03/2014 * @since 5.0.0 * * @param $post_id (mixed) the $post_id from which the value was deleted * @param $key (string) the $meta_key which the value was deleted * @return n/a */ /* function delete_value( $post_id, $key ) { } */ /* * load_field() * * This filter is applied to the $field after it is loaded from the database * * @type filter * @date 23/01/2013 * @since 3.6.0 * * @param $field (array) the field array holding all the field options * @return $field */ /* function load_field( $field ) { return $field; } */ /* * update_field() * * This filter is applied to the $field before it is saved to the database * * @type filter * @date 23/01/2013 * @since 3.6.0 * * @param $field (array) the field array holding all the field options * @return $field */ /* function update_field( $field ) { return $field; } */ /* * delete_field() * * This action is fired after a field is deleted from the database * * @type action * @date 11/02/2014 * @since 5.0.0 * * @param $field (array) the field array holding all the field options * @return n/a */ /* function delete_field( $field ) { } */ /** * table_slash() * * Add slashes to a string or strings in an array. * * This should be used instead of wp_slash() because wp_slash() convertes all * array values to strings which affects also the table object values of * type number converting to string. */ function table_slash( $value ) { if ( is_array( $value ) ) { foreach ( $value as $k => $v ) { if ( is_array( $v ) OR is_object( $v ) ) { $value[ $k ] = $this->table_slash( $v ); } else if( is_string( $v ) ) { $value[ $k ] = addslashes( $v ); } else { $value[ $k ] = $v; } } } else { $value = addslashes( $value ); } return $value; } } // create field new acf_field_table();