Hook/Acción de Actualización de Plugin en WordPress desde 3.9

Desde WordPress 3.9 puedes usar el hook upgrader_process_complete.
Este hook se ejecutará cuando el proceso de actualización esté completo (plugins y temas actualizados).

Ver referencias 1, 2, 3

Aquí tienes un ejemplo de código:

<?php 
/**
 * Plugin Name: Plugin de prueba 1
 * Plugin URI: https://rundiz.com
 * Description: Un plugin muy simple para pruebas. Este plugin no hace nada.
 * Version: 0.1.8
 * Author: Vee Winch
 * Author URI: http://rundiz.com
 * License: MIT
 * License URI: https://opensource.org/licenses/MIT
 * Text Domain: test-plugin1
 * Domain Path: 
 */


add_action('upgrader_process_complete', 'testplugin_upgrade_completed', 10, 2);
/**
 * Proceso de actualización completado.
 *
 * @see \WP_Upgrader::run() (wp-admin/includes/class-wp-upgrader.php)
 * @param \WP_Upgrader $upgrader_object
 * @param array $hook_extra
 */
function testplugin_upgrade_completed(\WP_Upgrader $upgrader_object, $hook_extra)
{
    // obtener versión actual del plugin. ( https://wordpress.stackexchange.com/a/18270/41315 )
    if(!function_exists('get_plugin_data')){
        require_once(ABSPATH . 'wp-admin/includes/plugin.php');
    }
    // https://developer.wordpress.org/reference/functions/get_plugin_data/
    $plugin_data = get_plugin_data(__FILE__);
    $plugin_version = ($plugin_data['Version'] ?? 'unknown.version');
    unset($plugin_data);

    if (
        is_array($hook_extra) && 
        array_key_exists('action', $hook_extra) && 
        $hook_extra['action'] == 'update'
    ) {
        if (
            array_key_exists('type', $hook_extra) && 
            $hook_extra['type'] == 'plugin'
        ) {
            // si se actualizaron plugins.
            $this_plugin = plugin_basename(__FILE__);
            $this_plugin_updated = false;
            if (array_key_exists('plugins', $hook_extra)) {
                // si es actualización masiva de plugins (en página de actualizaciones)
                foreach ($hook_extra['plugins'] as $each_plugin) {
                    if ($each_plugin === $this_plugin) {
                        $this_plugin_updated = true;
                        break;
                    }
                }// endforeach;
                unset($each_plugin);
            } elseif (array_key_exists('plugin', $hook_extra)) {
                // si es actualización normal o automática.
                if ($this_plugin === $hook_extra['plugin']) {
                    $this_plugin_updated = true;
                }
            }
            if ($this_plugin_updated === true) {
                // si este plugin acaba de actualizarse.
                // realiza tus tareas aquí.
                // NO proceses nada del nuevo código aquí, porque se ejecutará la versión antigua del plugin.
                // ¡¡léelo de nuevo!! el código que se ejecuta aquí NO es la nueva versión (recién actualizada) sino la versión anterior.
                file_put_contents(WP_CONTENT_DIR . '/test.txt', 'v'.$plugin_version."\r\n", FILE_APPEND);
                // configura transient para ejecutar más tarde.
                set_transient('testplugin_just_updated', 1);
            }
        } elseif (
            array_key_exists('type', $hook_extra) && 
            $hook_extra['type'] == 'theme'
        ) {
            // si se actualizaron temas.
            // igual que con plugins, la actualización masiva estará en $hook_extra['themes'] como 'theme1', 'theme2'.
            // la actualización normal o automática estará en $hook_extra['theme'] como 'theme1'.
        }
    }// endif; $hook_extra
}// testplugin_upgrade_completed


add_action('plugins_loaded', 'testplugin_pluginloaded');
/**
 * Ejecutar una vez que el plugin se cargue (en cada carga de página).
 */
function testplugin_pluginloaded()
{
    // obtener versión actual del plugin. ( https://wordpress.stackexchange.com/a/18270/41315 )
    if(!function_exists('get_plugin_data')){
        require_once(ABSPATH . 'wp-admin/includes/plugin.php');
    }
    // https://developer.wordpress.org/reference/functions/get_plugin_data/
    $plugin_data = get_plugin_data(__FILE__);
    $plugin_version = ($plugin_data['Version'] ?? 'unknown.version');
    unset($plugin_data);

    if (get_transient('testplugin_just_updated') && current_user_can('manage_options')) {
        // si está marcado en el transient que este plugin se acaba de actualizar y el usuario actual es admin.
        // aquí puedes usar el código de la nueva versión.
        file_put_contents(WP_CONTENT_DIR . '/test-update-by-transient.txt', 'v'.$plugin_version."\r\n", FILE_APPEND);

        // tu código de actualización aquí.
        
        // eliminar el transient cuando termines para evitar que este código se ejecute de nuevo.
        delete_transient('testplugin_just_updated');
    }
}// testplugin_pluginloaded

El hook upgrader_process_complete se ejecutará con tu versión actual de código mientras el plugin/tema se está actualizando. No usa la nueva versión.

Escenario

1. Tienes el plugin en versión 1.0
2. Ejecutas la página de actualizaciones o actualización automática.
3. Se descargará y extraerá tu plugin versión 2.0. Se llamará al hook upgrader_process_complete.
4. Tu plugin versión 1.0 se ejecutará en el hook upgrader_process_complete.
5. Una vez terminado, al recargar la página se llamará al hook plugins_loaded.
6. Tu plugin versión 2.0 se ejecutará en el hook plugins_loaded. (El plugin debe estar activado).

Esto ya está explicado en el código que he publicado anteriormente (antes de editar) pero quizás no de forma clara o es difícil de ver.

El hook upgrader_process_complete está creado para esto (lee la referencia 3). Para ejecutarse después de que la actualización haya terminado.

Puedes usar el hook plugins_loaded con el código de la respuesta aceptada. Funciona y es más corto o puedes tener alguna idea mejor para usar con el hook upgrader_process_complete.

El hook upgrader_process_complete funcionará cuando:

1. Actualizas desde la página de actualizaciones.
2. Actualizas desde la página de plugins o temas.
3. Actualizas automáticamente o mediante WP Cron.

El código anterior no funciona cuando actualizas plugins o temas vía FTP porque no puede detectar la opción transient. En este caso, la respuesta aceptada es la mejor opción para ti.

Por la discusión donde decidieron no añadir un hook/función personalizado específico para actualizaciones, parece que "la mayoría de la gente" (hace 4 años) usa register_activation_hook, ya que se llama cuando un plugin se actualiza a través de la página de administración; la mayoría de ejemplos que he visto desde entonces siguen esa tendencia.

Para la mayoría de los casos de uso, sugeriría no enganchar a través de plugins_loaded, ya que se llamaría en cada carga de página. La excepción a esto se menciona en la discusión: las rutas de actualización mediante FTP/SVN son 'casos marginales', ya que WP no tendría un mecanismo para saber que el plugin fue cambiado, en cuyo caso la respuesta previa podría ser más relevante.

Mira https://gist.github.com/zaus/c08288c68b7f487193d1 para ver un ejemplo de 'marco simple' usando register_activation_hook.

Mientras buscaba algo relacionado en noviembre de 2023, pensé en ofrecer esta sugerencia: el filtro update_plugins_{$hostname} se introdujo en la versión 5.8.0 de WordPress.

Esta característica solo funciona si el plugin utiliza la cabecera Update URI. Así que si estás creando un plugin, puedes incluir la cabecera Update URI en la parte superior del archivo principal con el valor siendo el endpoint de tu JSON. Luego engancharías el filtro reemplazando {hostname} con el nombre de host de esa URL. Por ejemplo, digamos que este es mi archivo de plugin personalizado ubicado en /wp-content/plugins/mi-plugin-personalizado/mi-plugin-personalizado.php y tengo esto en la parte superior:

/**
 * Plugin Name: Mi Plugin Personalizado
 * Version: 1.0.0
 * Author: AuRise Creative
 * Update URI: https://aurisecreative.com/actualizar-mi-plugin-personalizado/
 */

Ahora podría engancharme a las actualizaciones del plugin para recuperar mis datos de actualización (si los hay) para ese plugin.

/**
 * Comprobar actualizaciones del plugin
 *
 * @param array|false $update Los datos de actualización del plugin con los últimos detalles. Por defecto false.
 * @param array $plugin_data Cabeceras del plugin.
 * @param string $plugin_file Nombre del archivo del plugin.
 * @param string $locales Idiomas instalados para buscar traducciones.
 *
 * @return array|false Un array asociativo con datos de actualización en caso de éxito. False en caso contrario.
 */
function prefijo_comprobar_actualizaciones_plugin($update, $plugin_data, $plugin_file, $locales = '')
{
    // Hacer cosas
    return $update;
}
add_filter('update_plugins_aurisecreative.com', 'prefijo_comprobar_actualizaciones_plugin', 10, 4);

Desafortunadamente, esto solo funciona para plugins que usan la cabecera, por lo que probablemente solo en plugins premium.

Fuentes:

• Documentación para desarrolladores del filtro update_plugins_{hostname}
• Campos de Cabecera de Plugins
• Anuncio de la cabecera "Update URI" para plugins en WordPress 5.8 publicado el 29 de junio de 2021

Puedes engancharte a los filtros upgrader_pre_install y upgrader_post_install.