Plugin Filters - mcguffin/acf-quickedit-fields GitHub Wiki
Filters
Filter field type support
- Filter name:
acf_quick_edit_fields_types
- Parameter:
$fields
An associative array of field type support having the ACF field name as keys and an array of supported fetaures as values.
Features are 'column', 'quickedit' and 'bulkedit'.
Specifying which field groups to display
- Filter name:
acf_quick_edit_fields_group_filter
- Parameter:
$conditions
Field group conditions passed toacf_get_field_groups()
Number of images in a Gallery Column
- Filter name:
acf_quick_edit_fields_gallery_col_max_images
- Parameter:
$max_images
Maximum Number of images
Default:15
Render a quick edit input or not
- Filter name:
acf_quick_edit_render_{$field_type}
- Parameter:
$render
Default:true
- Parameter:
$acf_field
- Parameter:
$post_type
Make a column sortable
- Filter name:
acf_quick_edit_sortable_column_{$field_name}
- Parameter:
$sortable
Default: Whatever is_sortable() on the specific field type returns.
Return false
to suppress sortability for the a specific field.
Return a value_type like numeric
or datetime
if you desire a specific typecasting.
See WP_Meta_Query::__construct for a list of available types.
By returning true
the meta value will not be casted to any type. The native Database sorting for the meta_value
column type (which is LONGTEXT) will be applied instead.
Examples
Let's assume there is an ACF number field named size
. Sorting is numeric by default:
| Post ID | size |
|---------|--------|
| 89 | NULL |
| 155 | -9 |
| 123 | 1 |
| 456 | 2 |
| 789 | 3 |
| 812 | 10 |
| 890 | 11 |
Sort by absolute numeric value:
add_filter( 'acf_quick_edit_sortable_column_size', function( $sort ){
return 'unsigned';
});
Result:
| Post ID | size |
|---------|--------|
| 89 | NULL |
| 123 | 1 |
| 456 | 2 |
| 789 | 3 |
| 155 | -9 |
| 812 | 10 |
| 890 | 11 |
… or alphabetically:
// will fall back to default database sorting:
add_filter( 'acf_quick_edit_sortable_column_size', '__return_true' );
// same result, but more specific:
add_filter( 'acf_quick_edit_sortable_column_size', function( $sort ){
return 'CHAR';
});
Result
| Post ID | size |
|---------|--------|
| 89 | NULL |
| 155 | -9 |
| 123 | 1 |
| 812 | 10 |
| 890 | 11 |
| 456 | 2 |
| 789 | 3 |
Actions
Before render quick/bulk edit Element
- Action name:
acf_quick_edit_field_{$field_type}
- Parameter:
$acf_field
- Parameter:
$post_type