How to use title hook to edit association item titles

[RachelRVasquez]

Hi there,

I've been browsing the hooks page, and I'd like to edit the titles of my association field items on the dashboard.

https://carbonfields.net/docs/advanced-topics-hooks/?crb_version=2-1-0

I tried using the carbon_fields_association_field_title hook but it didn't seem to work quite like the only other hook I've tried for query options:

add_filter( 'carbon_fields_association_field_options_[field_name]_[post_type]_[cpt_name/sub_type]', function( $query_arguments ) {
				$query_arguments['meta_query'] = [
					'future_movies' => [
						'key'     => '_movie_start_date',
						'value'   => date( 'Y-m-d H:i:s' ),
						'type'    => 'date',
						'compare' => '>=',
					],
				];

				return $query_arguments;
			} );

Since the above hook accepts an array of options, I can return the array $query_arguments. But for the title hook, if I just want to add say, the first category name to all association titles, I just want to return the $title once I'm done without having to specify an $id. Is that possible?

[atanas-dev]

Hi @RachelRVasquez ,

The hook only expects you to return a title - the other arguments are there to help you out with extra information should you need it.

Here's an example:

add_filter( 'carbon_fields_association_field_title', function( $title, $field_name, $id, $type, $subtype ) {
	$field = 'related_posts'; // the field you wish to filter
	if ( $field_name !== $field ) {
		return $title; // not the field we want to filter - return the title unmodified
	}
	return 'Custom Prefix: ' . $title; // add a custom prefix to all options
}, 10, 5 );

This filter will cause all of your options to have a "Custom Prefix: " prefix.

[RachelRVasquez]

@atanas-angelov-dev That works perfectly. Just what I needed. Thank you. It'd be great to see some of these examples on the docs. Perhaps I'll fork the docs and make a contribution. 😄