storage = $storage;
$this->field_group_cache = $field_group_cache;
$this->column_matcher = $column_matcher;
$this->location = $location;
}
public function register(): void
{
if ( ! Acf::is_active()) {
return;
}
add_filter('acf/field_group/additional_field_settings_tabs', [$this, 'add_tab']);
add_action('acf/field_group/render_field_settings_tab/admin_columns', [$this, 'render_tab']);
add_action('acf/field_group/admin_enqueue_scripts', [$this, 'enqueue_scripts']);
}
public function enqueue_scripts(): void
{
$style = new Style('ac-acf-field-settings', $this->location->with_suffix('assets/css/acf-field-settings.css'));
$style->enqueue();
$script = new Script('ac-acf-field-settings', $this->location->with_suffix('assets/js/acf-field-settings.js'), ['jquery']);
$script->enqueue();
wp_localize_script('ac-acf-field-settings', 'ac_acf_field_settings', [
'nonce' => wp_create_nonce('ac-ajax'),
'adding' => __('Adding...', 'codepress-admin-columns'),
'added' => __('Added', 'codepress-admin-columns'),
'edit_column' => __('Edit column →', 'codepress-admin-columns'),
'add_as_column' => $this->get_add_column_label(),
]);
}
public function add_tab(array $tabs): array
{
$tabs['admin_columns'] = __('Admin Columns', 'codepress-admin-columns');
return $tabs;
}
private function get_add_column_label(): string
{
return __('Add as column', 'codepress-admin-columns');
}
public function render_tab(array $field): void
{
if ($this->is_pro_only_field($field)) {
$this->render_pro_only_upsell($field);
return;
}
if ( ! $this->is_field_supported($field)) {
acf_render_field_setting(
$field,
[
'label' => '',
'type' => 'message',
'name' => 'ac_unsupported',
'message' => '
'
. esc_html__('This field type cannot be used as an admin column.', 'codepress-admin-columns')
. '
',
]
);
return;
}
$this->render_table_screen_rows($field);
}
private function render_pro_only_upsell(array $field): void
{
$url = (new UtmTags(new Site(Site::PAGE_ADDON_ACF), 'acf-field-settings-upsell'))->get_url();
acf_render_field_setting(
$field,
[
'label' => '',
'type' => 'message',
'name' => 'ac_pro_upsell',
'message' => $this->get_upsell_html(
__('This field type is supported in Admin Columns Pro', 'codepress-admin-columns'),
__('Add this field as a column with sorting, filtering, and inline editing.', 'codepress-admin-columns'),
$url,
__('Learn more →', 'codepress-admin-columns')
),
]
);
}
private function render_table_screen_rows(array $field): void
{
$table_screens = $this->resolve_table_screens($field);
if ( ! $table_screens) {
return;
}
$meta_key = $field['name'] ?? '';
$has_meta_key = $meta_key !== '' && $meta_key !== 'new_field';
$rows_html = '';
foreach ($table_screens as $table_screen) {
$table_id = (string)$table_screen->get_id();
$label = $table_screen->get_labels()->get_plural();
if ( ! $has_meta_key) {
$rows_html .= $this->render_unavailable_row($label);
continue;
}
$match = $this->find_column_in_list_screens($table_screen->get_id(), $meta_key);
if ($match) {
$url = EditorUrlFactory::create($table_screen->get_id(), false, $match['list_screen']->get_id())
->with_arg('open_columns', (string)$match['column']->get_id());
$rows_html .= $this->render_added_row($label, $url);
} else {
$rows_html .= $this->render_available_row($table_id, $label);
}
}
$intro = '
'
. esc_html__('Add this field as a column in the list tables below. Once added, you can open that specific column in Admin Columns to configure it.', 'codepress-admin-columns')
. '
';
if ( ! $has_meta_key) {
$intro .= '
'
. sprintf(
esc_html__('Enter a %1$s under the %2$s tab to enable adding this field as a column.', 'codepress-admin-columns'),
'' . esc_html__('Field Name', 'codepress-admin-columns') . '',
'' . esc_html__('General', 'codepress-admin-columns') . ''
)
. '
';
}
$helper = '
'
. esc_html__('Column settings are managed in Admin Columns after creation.', 'codepress-admin-columns')
. '