Come creare un messaggio personalizzato sull'aggiornamento del plug-in

Ho visto questo messaggio oggi durante l'accesso alla mia pagina di plugin:

Quindi, come posso crearlo se voglio aggiornare i miei plugin che sono ospitati su wordpress?

Questo messaggio è creato da W3_Total_Cache->in_plugin_update_message()agganciato a "in_plugin_update_message-$file"in wp_plugin_update_row().

Fa qualche sforzo per analizzare il readme e visualizzare le informazioni dal log delle modifiche, ma nel complesso puoi semplicemente fare eco ad alcune cose come con qualsiasi altro hook.

Costruzione di ganci

Per chiarire il nome del gancio di azione:

global $pagenow;
if ( 'plugins.php' === $pagenow )
{
    // Better update message
    $file   = basename( __FILE__ );
    $folder = basename( dirname( __FILE__ ) );
    $hook = "in_plugin_update_message-{$folder}/{$file}";
    add_action( $hook, 'your_update_message_cb', 20, 2 );
}

Funzione di callback agganciata

La funzione stessa ha due $variablesallegati: $plugins_data& $r, a cui puoi accedere dal tuo plugin.

/**
 * Displays an update message for plugin list screens.
 * Shows only the version updates from the current until the newest version
 * 
 * @param (array) $plugin_data
 * @param (object) $r
 * @return (string) $output
 */
function your_update_message_cb( $plugin_data, $r )
{
    // readme contents
    $data       = file_get_contents( 'http://plugins.trac.wordpress.org/browser/YOUR_PLUGIN_FOLDER_NAME_IN_THE_OFFICIAL_REPO/trunk/readme.txt?format=txt' );

    // assuming you've got a Changelog section
    // @example == Changelog ==
    $changelog  = stristr( $data, '== Changelog ==' );

    // assuming you've got a Screenshots section
    // @example == Screenshots ==
    $changelog  = stristr( $changelog, '== Screenshots ==', true );

    // only return for the current & later versions
    $curr_ver   = get_plugin_data('Version');

    // assuming you use "= v" to prepend your version numbers
    // @example = v0.2.1 =
    $changelog  = stristr( $changelog, "= v{$curr_ver}" );

    // uncomment the next line to var_export $var contents for dev:
    # echo '<pre>'.var_export( $plugin_data, false ).'<br />'.var_export( $r, false ).'</pre>';

    // echo stuff....
    $output = 'whatever you want to do';
    return print $output;
}

Nota:

^{Questo approccio è disponibile nel plug-in Controllo link interno .}

aggiunta:

plugin_basename(__FILE__)può essere utilizzato al posto di quelle due righe sopra. Inoltre, verificare se la pagina corrente è la pagina del plug-in non è realmente necessario in quanto la funzione verrà chiamata solo da quella pagina comunque. Il vantaggio (molto minore) è che non è stata allegata un'altra richiamata. Dato che questa risposta è piuttosto vecchia, dovresti, mentre questo approccio funziona ancora senza problemi, ora controlla l'oggetto restituito get_current_screen().