Correct type in rss_widget_feed_link filter docs

[sabernhardt]

In changeset:52031, the rss_widget_feed_link filter's DocBlock says the first parameter is a string. However, I had recommended returning false to remove the link.

Mentioning both possibilities is probably enough, though I think switching to __return_empty_string would improve it (in the documentation and in Twenty Twenty-One).

[sabernhardt]

editing documentation and Twenty Twenty-One

[Mista-Flo]

Patch looks good thanks @sabernhardt

[sabernhardt]

@audrasjb @joedolson Could this be worth adding to 6.2?

[joedolson]

It certainly cleans things up. It's a minor tweak, so I don't see any reason not to get it into 6.2. I can take that.

[audrasjb]

Yes, this looks ready to go 👍

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

Closed in https://core.trac.wordpress.org/changeset/55409

[sabernhardt]

Fixed in [55409]

[sabernhardt]

The ​dev note from WP5.9 probably could be updated. Here's a draft for the modified example and revision note:

add_filter( 'rss_widget_feed_link', '__return_empty_string' );

For Twenty Twenty-One, the after_setup_theme action contains the filter. Update: Since March 2023, Twenty Twenty-One's filter returns an empty string instead of the boolean false. See #57594.