Media title falsely has kebab case when inserted via REST API (e.g. in Block Editor)

[abitofmind]

Reproduction I: "Upload New Media" creates media title "My Great Photo"

1) Media > Add New
2) Drag-n-drop "My Great Photo.jpg"
3) Inspecting this in "Edit Media" shows a media title "My Great Photo".

Reproduction II: Insertion via Block Editor (Gutenberg) creates media title "My-Super-Photo"

1) Edit an existing page or create a new page.
2) Set the cursor into an empty block.
3) Drag-n-drop "My Super Photo.jpg" into this block. This automatically creates a media page behind the scenes.
4) Save the page.
5) Inspecting the media title via "Edit Media"

• Actual: The media title is "My-Super-Photo".
• Expected: The media title should be "My Super Photo".
  • The media title should be the filename portion (without the suffix) in its purest possible form (UTF-8) and only the slug and filename should then be transformed according settings regarding ascii/whitespace/transliteration/escaping/punycode/etc.
  • Achieving the same goal via different means (Upload New Media vs. drag-n-drop in editor) should result in the same outcome. Otherwise this is an inconsistency.

Analysis & Fix

@adamsilverstein already analyzed and fixed this bug in the Gutenberg issue tracker and asked to re-file here in WordPress Core for review & adding to the codebase.

Adam's Analysis

This is actually something that happens on the core side where the logic to set the title is currently different in the REST API vs. the regular media uploader.

Adam's Fix which should be reviewed

I proposed a fix in ​WordPress/wordpress-develop #3981 that works in my testing. Would be good to have some additional feedback, maybe from the REST API team.

Environment

• First ​reported on 2021-08-19 in WordPress v5.8 , ​confirmed/patched in 2023-02 on a WordPress v6.1.1 instance.

Priority

• If the fix is deemed solid and the review process goes quickly without bumps: Is there a chance that the fix can make it into the 6.2 release? If not, no worry, am happy whenever this will get eventually fixed.

References

• Gutenberg: ​Discussion and investigation details where it was determined to be a Core issue.

[audrasjb]

Hello and thanks for the detailed ticket!

This is an annoying bug, but since it wasn't introduced in WP 6.2 development cycle and as we're about to release RC3, it's far too late to fix it during this cycle :)

We can of course fix it in 6.3, but we can also consider this for 6.2.1. For the moment, I'm moving it to 6.2.1 for visibility.

[abitofmind]

Thanks for the first reaction. 6.2.1 then, certainly good!

Match the naming behavior for uploaded media in the REST API to the way media is named when uploading in the media library.

Fixes ​https://github.com/WordPress/gutenberg/issues/34149

Trac ticket: https://core.trac.wordpress.org/ticket/57957

[hellofromTonya]

Adding a link to the original bug report from Gutenberg.

Description updated. This PR is now linked to the Trac ticket ✅

@adamsilverstein are there existing unit tests to validate this fix? If no, would you mind adding tests?

[adamsilverstein]

@adamsilverstein are there existing unit tests to validate this fix? If no, would you mind adding tests?

Good suggestion @hellofromTonya, will do.

I'd also like to get some more REST API component maintainer feedback, maybe @TimothyBlynJacobs or @spacedmonkey can review?

@adamsilverstein are there existing unit tests to validate this fix? If no, would you mind adding tests?

I'll take a look, thanks for the suggestion.

Any idea when this will be ready?
And if it is ready, in which WP version will it be included?

Asking to estimate for myself whether my upcoming mass picture placement session can count on this feature already or whether I must use a workaround. Thanks.

[audrasjb]

Since WordPress 6.2.1 Release candidate 1 is planned today, let's move this ticket to 6.2.2 to give it more time to add unit test cases and proper testing.

[abitofmind]

And regarding unit tests: What's the holdup? Any progress?

[audrasjb]

@abitofmind for the moment, this patch still needs unit tests.

Anyone is welcome to refresh the patch to add unit test cases, so this ticket could be considered for the next minor or major release.

[abitofmind]

My question is: What's the challenge with the unit tests? And what timeline to expect roughly.

[audrasjb]

No specific challenge, we are just waiting for someone wanting to handle them. No timeline for now as we're still waiting for these tests :)

[desrosj]

Moving this to 6.2.3.

[abitofmind]

#44789 was marked as a duplicate.

[abitofmind]

I now found #33789 which is already known for 5 years, and still unfixed.

[adamsilverstein]

57957.diff​ includes a new unit test to validate the fix, also on the PR

are there existing unit tests to validate this fix? If no, would you mind adding tests?

@hellofromtonya - tests added

[adamsilverstein]

@abitofmind - can you test if the latest patch fixes the issue for you?

[adamsilverstein]

While the unit tests passed, this didn't actually work in Gutenberg as written: no "Content-Disposition" header is being passed.

Instead we can use the $files data which contains the original filename of the uploaded file, from which we can extract the correct media title. I have updated the PR to use this approach.

Here is where this is handled elsewhere in core.

​https://github.com/WordPress/wordpress-develop/blob/1815f4c76c9f51665f046d79284552d09849597b/src/wp-admin/includes/media.php#L312-L319

[SergeyBiryukov]

Moving to 6.4 for now, as there are no plans for 6.2.3 at this time, and this does not appear to be a regression in 6.3.

[abitofmind]

What needs to happen next that we get progress?

• Must this whole issue be handled "elsewhere in core"?

• Or is this just a hint/reference to apply the same practices for this very issue?

[adamsilverstein]

I see there was some additional feedback on the PR from @spacedmonkey that still needs addressing. I have been focused elsewhere so if anyone else want to pick this one up, please do so!

[oglekler]

Because the patch needs a bit of work and some additional test coverage, I am adjusting keywords.

[oglekler]

@spacedmonkey I know that you are very popular person to ping, but if you are already know something about this issue, it will be much easier for you to tell what needs to be done to fix it.

Thank you! 🙏🙂

[spacedmonkey]

@oglekler I am still awaiting response / actioned feedback from @adamsilverstein. Sadly I don't think I have time to work on this change myself. But if Adam can take the time to look at into, I will provide code review.

[nicolefurlan]

@adamsilverstein with 6.4 RC1 rapidly approaching, I'm wondering if you think this fix will make it in this release cycle. Would it would be better to move it to a Future Release?

[adamsilverstein]

Apologies I have been focused elsewhere (mostly post meta revisioning) and haven't had a chance to get back to this yet. Feel free to punt if needed.

[hellofromTonya]

With the last scheduled 6.4 beta released today (beta 3) and committers working on this not being available, moving this ticket to 6.5. That said, if a fix is completed before RC1 and there's consensus it needs or should go into 6.4, please move it back into the milestone.

[abitofmind]

Could someone please write that missing unit test(s) so that this can finally get shipped?

[adamsilverstein]

57957.2.diff​ is refreshed against trunk, includes tests, and addresses all feedback on the PR (I hope). @spacedmonkey please review again if you haven't had a chance to.

@spacedmonkey the code you linked to leverages $_FILES[ $file_id ]['name']; - would we have access to that here?

The use of sanitize_text_field might not be appropriate in the REST handler where sanitization would be expected to happen elsewhere?

[spacedmonkey]

Marking as commit. Take it away @adamsilverstein

[rajinsharwar]

Test Report

Description

This report validates that the PR 3981 works as expected.

Patch tested: ​https://github.com/WordPress/wordpress-develop/pull/3981

Environment

• WordPress: 6.6-alpha
• PHP: 8.1.23
• Browser: Chrome
• OS: Windows
• Site - Multisite environment

Actual Results

1. ✅ Text changes work fine with the patch.

Screenshots

Before:

After:

[adamsilverstein]

In 58447:

Media: improve titles when inserting via REST API.

Match the naming behavior for uploaded media in the REST API to the way media is named when uploading in the media library. Fix an issue where dashes were replacing spaces unnecessarily.

Props abitofmind, kadamwhite, spacedmonkey, adamsilverstein, audrasjb, hellofromTonya.
Fixes #57957.