Filters the attachment fields to be saved.

Description

See also

• wp_get_attachment_metadata()

Parameters

$postarray

An array of post data.

$attachmentarray

An array of attachment metadata.

More Information

The attachment_fields_to_save filter is used to filter the associated data of images.

By default, it receives the input from the Media Upload screen and provides default values to the post_title, in case the user hasn’t done so.

It returns the $post array to be handled by the media_upload_form_handler function.

A plugin (or theme) can register as a content filter with the code:

<?php add_filter( 'attachment_fields_to_save', 'filter_function_name', 10, 2 ) ?>

Where ‘filter_function_name’ is the function WordPress should call when an attachment is being saved.

Note that the filter function must return the $post array after it is finished processing.

NOTE: per ticket #30687, any validation errors passed in via $post['errors'] array are silently unset and the attachment is processed without notifying the user

Source

$post = apply_filters( 'attachment_fields_to_save', $post, $attachment );

View all references View on Trac View on GitHub

Changelog