get_admin_url() ); exit; } } /** * Customizes the admin table columns. * * @date 1/4/20 * @since 5.9.0 * * @param array $_columns The columns array. * @return array */ public function admin_table_columns( $_columns ) { // Set the "no found" label to be our custom HTML for no results. if ( empty( acf_request_arg( 's' ) ) ) { global $wp_post_types; $wp_post_types['acf-field-group']->labels->not_found = $this->get_not_found_html(); } $columns = array( 'cb' => $_columns['cb'], 'title' => $_columns['title'], 'acf-description' => __( 'Description', 'acf' ), 'acf-key' => __( 'Key', 'acf' ), 'acf-location' => __( 'Location', 'acf' ), 'acf-count' => __( 'Fields', 'acf' ), ); if ( acf_get_local_json_files( $this->post_type ) ) { $columns['acf-json'] = __( 'Local JSON', 'acf' ); } return $columns; } /** * Renders a specific admin table column. * * @date 17/4/20 * @since 5.9.0 * * @param string $column_name The name of the column to display. * @param array $post The main ACF post array. * @return void */ public function render_admin_table_column( $column_name, $post ) { switch ( $column_name ) { // Key. case 'acf-key': echo ''; echo esc_html( $post['key'] ); break; // Description. case 'acf-description': if ( ( is_string( $post['description'] ) || is_numeric( $post['description'] ) ) && ! empty( $post['description'] ) ) { echo '' . acf_esc_html( $post['description'] ) . ''; } else { echo '—'; echo '' . esc_html__( 'No description', 'acf' ) . ''; } break; // Location. case 'acf-location': $this->render_admin_table_column_locations( $post ); break; // Count. case 'acf-count': $this->render_admin_table_column_num_fields( $post ); break; // Local JSON. case 'acf-json': $this->render_admin_table_column_local_status( $post ); break; } } /** * Displays a visual representation of the field group's locations. * * @date 1/4/20 * @since 5.9.0 * * @param array $field_group The field group. * @return void */ public function render_admin_table_column_locations( $field_group ) { $objects = array(); // Loop over location rules and determine connected object types. if ( $field_group['location'] ) { foreach ( $field_group['location'] as $i => $rules ) { // Determine object types for each rule. foreach ( $rules as $j => $rule ) { // Get location type and subtype for the current rule. $location = acf_get_location_rule( $rule['param'] ); $location_object_type = ''; $location_object_subtype = ''; if ( $location ) { $location_object_type = $location->get_object_type( $rule ); $location_object_subtype = $location->get_object_subtype( $rule ); } $rules[ $j ]['object_type'] = $location_object_type; $rules[ $j ]['object_subtype'] = $location_object_subtype; } // Now that each $rule conains object type data... $object_types = array_column( $rules, 'object_type' ); $object_types = array_filter( $object_types ); $object_types = array_values( $object_types ); if ( $object_types ) { $object_type = $object_types[0]; } else { continue; } $object_subtypes = array_column( $rules, 'object_subtype' ); $object_subtypes = array_filter( $object_subtypes ); $object_subtypes = array_values( $object_subtypes ); $object_subtypes = array_map( 'acf_array', $object_subtypes ); if ( count( $object_subtypes ) > 1 ) { $object_subtypes = call_user_func_array( 'array_intersect', $object_subtypes ); $object_subtypes = array_values( $object_subtypes ); } elseif ( $object_subtypes ) { $object_subtypes = $object_subtypes[0]; } else { $object_subtypes = array( '' ); } // Append to objects. foreach ( $object_subtypes as $object_subtype ) { $object = acf_get_object_type( $object_type, $object_subtype ); if ( $object ) { $objects[ $object->name ] = $object; } } } } // Reset keys. $objects = array_values( $objects ); // Display. $html = ''; if ( $objects ) { $limit = 3; $total = count( $objects ); // Icon. $html .= ''; // Labels. $labels = array_column( $objects, 'label' ); $labels = array_slice( $labels, 0, 3 ); $html .= implode( ', ', $labels ); // More. if ( $total > $limit ) { $html .= ', ...'; } } else { $html = ' ' . __( 'Various', 'acf' ); } // Filter. echo acf_esc_html( $html ); } /** * Renders the number of fields created for the field group in the list table. * * @since 6.1.5 * * @param array $field_group The main field group array. * @return void */ public function render_admin_table_column_num_fields( $field_group ) { $field_count = acf_get_field_count( $field_group ); if ( ! $field_count || ! is_numeric( $field_count ) ) { echo '—'; echo '' . esc_html__( 'No fields', 'acf' ) . ''; return; } // If in JSON but not synced or in trash, the link won't work. if ( empty( $field_group['ID'] ) || 'trash' === get_post_status( $field_group['ID'] ) ) { echo esc_html( number_format_i18n( $field_count ) ); return; } printf( '%s', esc_url( admin_url( 'post.php?action=edit&post=' . $field_group['ID'] ) ), esc_html( number_format_i18n( $field_count ) ) ); } /** * Gets the class(es) to be used by field groups in the list table. * * @since 6.2.8 * * @param array $classes An array of the classes used by the field group. * @param array $css_class An array of additional classes added to the field group. * @param integer $post_id The ID of the field group. * @return array */ public function get_admin_table_post_classes( $classes, $css_class, $post_id ) { // Bail early if not in the field group list table. if ( ! is_admin() || $this->post_type !== get_post_type( $post_id ) ) { return $classes; } return apply_filters( 'acf/field_group/list_table_classes', $classes, $css_class, $post_id ); } /** * Fires when trashing a field group. * * @date 8/01/2014 * @since 5.0.0 * * @param integer $post_id The post ID. * @return void */ public function trashed_post( $post_id ) { if ( get_post_type( $post_id ) === $this->post_type ) { acf_trash_field_group( $post_id ); } } /** * Fires when untrashing a field group. * * @date 8/01/2014 * @since 5.0.0 * * @param integer $post_id The post ID. * @return void */ public function untrashed_post( $post_id ) { if ( get_post_type( $post_id ) === $this->post_type ) { acf_untrash_field_group( $post_id ); } } /** * Fires when deleting a field group. * * @date 8/01/2014 * @since 5.0.0 * * @param integer $post_id The post ID. * @return void */ public function deleted_post( $post_id ) { if ( get_post_type( $post_id ) === $this->post_type ) { acf_delete_field_group( $post_id ); } } /** * Gets the translated action notice text for list table actions (activate, deactivate, sync, etc.). * * @since 6.1 * * @param string $action The action being performed. * @param integer $count The number of items the action was performed on. * @return string */ public function get_action_notice_text( $action, $count = 1 ) { $text = ''; $count = (int) $count; switch ( $action ) { case 'acfactivatecomplete': $text = sprintf( /* translators: %s number of field groups activated */ _n( 'Field group activated.', '%s field groups activated.', $count, 'acf' ), $count ); break; case 'acfdeactivatecomplete': $text = sprintf( /* translators: %s number of field groups deactivated */ _n( 'Field group deactivated.', '%s field groups deactivated.', $count, 'acf' ), $count ); break; case 'acfduplicatecomplete': $text = sprintf( /* translators: %s number of field groups duplicated */ _n( 'Field group duplicated.', '%s field groups duplicated.', $count, 'acf' ), $count ); break; case 'acfsynccomplete': $text = sprintf( /* translators: %s number of field groups synchronized */ _n( 'Field group synchronized.', '%s field groups synchronized.', $count, 'acf' ), $count ); break; } return $text; } } // Instantiate. acf_new_instance( 'ACF_Admin_Field_Groups' ); endif; // Class exists check.