Allow plugins to add info to the "new version" message

[JohnLamansky]

This patch would allow plugins to insert content directly after the "There is a new version of (name) available" line in the plugin administration, via a new after_plugin_update_row action.

A plugin could hook into this to insert pre-upgrade reminders or instructions, for example. (e.g. for those plugins that store custom files needing to be backed up.) I also would find this new action useful for a plugin I'm developing.

I know it's possible to add another <tr></tr> row using the existing after_plugin_row action, but it would look cleaner to include all upgrade-related information in the same row.

[Denis-de-Bernardy]

seems invalid. you can already do more or less the same with existing hooks: on the plugin_row hook (or whatever it is), check if an update is suggested in the update_plugins option.

[JohnLamansky]

There's currently no way to add upgrade-related information directly into the same row as the "There is a new version of (plugin name) available" message.

As I stated in the ticket:

I know it's possible to add another <tr></tr> row using the existing after_plugin_row action, but it would look cleaner to include all upgrade-related information in the same row.

Here's a hypothetical usage example:

Plugin code:

function myplugin_update_reminder( $file ) {
	if ( 'my_file' == $file )
		echo "\n\n<br />Remember to backup this plugin&#8217;s custom files <a href='(url)'>here</a> before upgrading.";
}
add_action( 'after_plugin_update_message', 'myplugin_update_reminder' );

Output example:

<tr><td colspan="5" class="plugin-update">

There is a new version of (plugin name) available. <a href="(url)" class="thickbox">View version 2.0 Details</a> or <a href="(url)">upgrade automatically</a>.

<br />Remember to backup this plugin&#8217;s custom files <a href='(url)'>here</a> before upgrading.

</td></tr>

[DD32]

+1 for this patch. But i'd change the hook to "in_plugin_update_message-{$plugin_file}" myself.

[JohnLamansky]

Uses the hook name recommended by DD32

[ryan]

(In [11193]) Add hook for adding info to plugin update message. Props JohnLamansky. fixes #9553