WordPress/wp-admin/media.php
audrasjb bc802e7b51 Help/About: Update help tab texts to consistently describe button labels.
This changeset ensures help tab texts consistently refer to the related button labels.

Props kebbet, costdev.
Fixes #57608.

Built from https://develop.svn.wordpress.org/trunk@55195


git-svn-id: http://core.svn.wordpress.org/trunk@54728 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-02-02 20:24:20 +00:00

179 lines
5.5 KiB
PHP

<?php
/**
* Media management action handler.
*
* @package WordPress
* @subpackage Administration
*/
/** Load WordPress Administration Bootstrap */
require_once __DIR__ . '/admin.php';
$parent_file = 'upload.php';
$submenu_file = 'upload.php';
wp_reset_vars( array( 'action' ) );
switch ( $action ) {
case 'editattachment':
$attachment_id = (int) $_POST['attachment_id'];
check_admin_referer( 'media-form' );
if ( ! current_user_can( 'edit_post', $attachment_id ) ) {
wp_die( __( 'Sorry, you are not allowed to edit this attachment.' ) );
}
$errors = media_upload_form_handler();
if ( empty( $errors ) ) {
$location = 'media.php';
$referer = wp_get_original_referer();
if ( $referer ) {
if ( false !== strpos( $referer, 'upload.php' ) || ( url_to_postid( $referer ) === $attachment_id ) ) {
$location = $referer;
}
}
if ( false !== strpos( $location, 'upload.php' ) ) {
$location = remove_query_arg( 'message', $location );
$location = add_query_arg( 'posted', $attachment_id, $location );
} elseif ( false !== strpos( $location, 'media.php' ) ) {
$location = add_query_arg( 'message', 'updated', $location );
}
wp_redirect( $location );
exit;
}
// No break.
case 'edit':
// Used in the HTML title tag.
$title = __( 'Edit Media' );
if ( empty( $errors ) ) {
$errors = null;
}
if ( empty( $_GET['attachment_id'] ) ) {
wp_redirect( admin_url( 'upload.php' ) );
exit;
}
$att_id = (int) $_GET['attachment_id'];
if ( ! current_user_can( 'edit_post', $att_id ) ) {
wp_die( __( 'Sorry, you are not allowed to edit this attachment.' ) );
}
$att = get_post( $att_id );
if ( empty( $att->ID ) ) {
wp_die( __( 'You attempted to edit an attachment that does not exist. Perhaps it was deleted?' ) );
}
if ( 'attachment' !== $att->post_type ) {
wp_die( __( 'You attempted to edit an item that is not an attachment. Please go back and try again.' ) );
}
if ( 'trash' === $att->post_status ) {
wp_die( __( 'You cannot edit this attachment because it is in the Trash. Please move it out of the Trash and try again.' ) );
}
add_filter( 'attachment_fields_to_edit', 'media_single_attachment_fields_to_edit', 10, 2 );
wp_enqueue_script( 'wp-ajax-response' );
wp_enqueue_script( 'image-edit' );
wp_enqueue_style( 'imgareaselect' );
get_current_screen()->add_help_tab(
array(
'id' => 'overview',
'title' => __( 'Overview' ),
'content' =>
'<p>' . __( 'This screen allows you to edit fields for metadata in a file within the media library.' ) . '</p>' .
'<p>' . __( 'For images only, you can click on Edit Image under the thumbnail to expand out an inline image editor with icons for cropping, rotating, or flipping the image as well as for undoing and redoing. The boxes on the right give you more options for scaling the image, for cropping it, and for cropping the thumbnail in a different way than you crop the original image. You can click on Help in those boxes to get more information.' ) . '</p>' .
'<p>' . __( 'Note that you crop the image by clicking on it (the Crop icon is already selected) and dragging the cropping frame to select the desired part. Then click Save to retain the cropping.' ) . '</p>' .
'<p>' . __( 'Remember to click Update to save metadata entered or changed.' ) . '</p>',
)
);
get_current_screen()->set_help_sidebar(
'<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
'<p>' . __( '<a href="https://wordpress.org/support/article/edit-media/">Documentation on Edit Media</a>' ) . '</p>' .
'<p>' . __( '<a href="https://wordpress.org/support/">Support</a>' ) . '</p>'
);
require_once ABSPATH . 'wp-admin/admin-header.php';
$parent_file = 'upload.php';
$message = '';
$class = '';
if ( isset( $_GET['message'] ) ) {
switch ( $_GET['message'] ) {
case 'updated':
$message = __( 'Media file updated.' );
$class = 'updated';
break;
}
}
if ( $message ) {
echo "<div id='message' class='$class'><p>$message</p></div>\n";
}
?>
<div class="wrap">
<h1 class="wp-heading-inline">
<?php
echo esc_html( $title );
?>
</h1>
<?php
if ( current_user_can( 'upload_files' ) ) {
?>
<a href="media-new.php" class="page-title-action"><?php echo esc_html_x( 'Add New', 'file' ); ?></a>
<?php } ?>
<hr class="wp-header-end">
<form method="post" class="media-upload-form" id="media-single-form">
<p class="submit" style="padding-bottom: 0;">
<?php submit_button( __( 'Update' ), 'primary', 'save', false ); ?>
</p>
<div class="media-single">
<div id="media-item-<?php echo $att_id; ?>" class="media-item">
<?php
echo get_media_item(
$att_id,
array(
'toggle' => false,
'send' => false,
'delete' => false,
'show_title' => false,
'errors' => ! empty( $errors[ $att_id ] ) ? $errors[ $att_id ] : null,
)
);
?>
</div>
</div>
<?php submit_button( __( 'Update' ), 'primary', 'save' ); ?>
<input type="hidden" name="post_id" id="post_id" value="<?php echo isset( $post_id ) ? esc_attr( $post_id ) : ''; ?>" />
<input type="hidden" name="attachment_id" id="attachment_id" value="<?php echo esc_attr( $att_id ); ?>" />
<input type="hidden" name="action" value="editattachment" />
<?php wp_original_referer_field( true, 'previous' ); ?>
<?php wp_nonce_field( 'media-form' ); ?>
</form>
</div>
<?php
require_once ABSPATH . 'wp-admin/admin-footer.php';
exit;
default:
wp_redirect( admin_url( 'upload.php' ) );
exit;
}