Хук/Действие обновления плагина WordPress начиная с версии 3.9

Начиная с WordPress 3.9 вы можете использовать хук upgrader_process_complete.
Этот хук срабатывает после завершения процесса обновления (плагинов и тем).

Смотрите ссылки 1, 2, 3

Пример кода:

<?php 
/**
 * Plugin Name: Test plugin 1
 * Plugin URI: https://rundiz.com
 * Description: Очень простой плагин для тестирования. Этот плагин ничего не делает.
 * 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);
/**
 * Завершение процесса обновления.
 *
 * @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)
{
    // Получаем текущую версию плагина. ( 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'
        ) {
            // Если обновлены плагины.
            $this_plugin = plugin_basename(__FILE__);
            $this_plugin_updated = false;
            if (array_key_exists('plugins', $hook_extra)) {
                // Если массовое обновление плагинов (на странице обновлений)
                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)) {
                // Если обычное обновление плагина или автоматическое.
                if ($this_plugin === $hook_extra['plugin']) {
                    $this_plugin_updated = true;
                }
            }
            if ($this_plugin_updated === true) {
                // Если этот плагин только что обновлен.
                // Выполняем ваши задачи здесь.
                // НЕ обрабатывайте ничего из новой версии кода здесь, потому что он будет работать в старой версии плагина.
                // Прочтите еще раз!! Код, выполняемый здесь, не из новой (только что обновленной) версии, а из версии до этого.
                file_put_contents(WP_CONTENT_DIR . '/test.txt', 'v'.$plugin_version."\r\n", FILE_APPEND);
                // Устанавливаем транзиент для выполнения позже.
                set_transient('testplugin_just_updated', 1);
            }
        } elseif (
            array_key_exists('type', $hook_extra) && 
            $hook_extra['type'] == 'theme'
        ) {
            // Если обновлены темы.
            // То же самое, что и с плагинами: массовое обновление тем будет указано в $hook_extra['themes'] как 'theme1', 'theme2'.
            // Обычное обновление или автоматическое будет указано в $hook_extra['theme'] как 'theme1'.
        }
    }// endif; $hook_extra
}// testplugin_upgrade_completed


add_action('plugins_loaded', 'testplugin_pluginloaded');
/**
 * Запускается один раз после загрузки плагина (при каждой загрузке страницы).
 */
function testplugin_pluginloaded()
{
    // Получаем текущую версию плагина. ( 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')) {
        // Если в транзиенте отмечено, что этот плагин только что обновлен и текущий пользователь - администратор.
        // Здесь можно использовать код из новой версии.
        file_put_contents(WP_CONTENT_DIR . '/test-update-by-transient.txt', 'v'.$plugin_version."\r\n", FILE_APPEND);

        // Ваш код обновления здесь.
        
        // Удаляем транзиент после выполнения, чтобы этот код не запускался снова.
        delete_transient('testplugin_just_updated');
    }
}// testplugin_pluginloaded

Хук upgrader_process_complete будет выполняться с текущей версией кода во время обновления плагина/темы. Он не использует новую версию.

Сценарий

1. У вас есть плагин версии 1.0
2. Вы запускаете страницу обновления или автоматическое обновление.
3. Ваш плагин версии 2.0 будет загружен и распакован. Будет вызван хук upgrader_process_complete.
4. Ваш плагин версии 1.0 будет выполнен в хуке upgrader_process_complete.
5. После завершения страница перезагружается, и вызывается хук plugins_loaded.
6. Ваш плагин версии 2.0 выполняется в хуке plugins_loaded. (Плагин должен быть активирован.)

Это уже объяснено в коде, который я опубликовал ранее (до редактирования), но, возможно, не так ясно или трудно заметить.

Хук upgrader_process_complete создан именно для этого (см. ссылку 3). Для выполнения после завершения обновления.

Вы можете использовать хук plugins_loaded с кодом из принятого ответа. Это работает и выглядит короче, или у вас может быть лучшая идея с использованием хука upgrader_process_complete.

Хук upgrader_process_complete будет работать в случаях:

1. Обновление через страницу обновлений.
2. Обновление через страницу плагинов или тем.
3. Обновление через автоматическое обновление или WP Cron.

Приведенный выше код не работает при обновлении плагина или темы через FTP, так как не может обнаружить транзиентную опцию. В этом случае принятый ответ — единственный лучший вариант для вас.

Из обсуждения, где решили не добавлять специальный хук/функцию для обновления, следует, что «большинство людей» (по состоянию на 4 года назад) используют register_activation_hook, так как он вызывается при обновлении плагина через административную панель; большинство примеров, которые я видел с тех пор, следуют этой тенденции.

Для большинства случаев я бы не рекомендовал использовать хук через plugins_loaded, так как он будет вызываться при каждой загрузке страницы. Исключение упоминается в обсуждении: пути обновления через FTP/SVN являются «крайними случаями», поскольку WordPress не имеет механизма для определения изменений плагина, и в этом случае предыдущий ответ может быть более актуальным.

Смотрите https://gist.github.com/zaus/c08288c68b7f487193d1 для примера «простой структуры» с использованием register_activation_hook.

Поскольку я искал что-то связанное с этим в ноябре 2023 года, хотел бы предложить следующее: фильтр update_plugins_{$hostname} был добавлен в WordPress начиная с версии 5.8.0.

Эта функция работает только если плагин использует заголовок Update URI. Поэтому, если вы разрабатываете плагин, вы можете добавить этот заголовок в начало основного файла, указав в качестве значения URL-адрес вашего JSON-эндпоинта. Затем вам нужно подключиться к фильтру, заменив {hostname} на имя хоста этого URL. Например, предположим, что у меня есть кастомный плагин по пути /wp-content/plugins/my-custom-plugin/my-custom-plugin.php, и в начале файла у меня указано:

/**
 * Plugin Name: My Custom Plugin
 * Version: 1.0.0
 * Author: AuRise Creative
 * Update URI: https://aurisecreative.com/update-my-custom-plugin/
 */

Теперь я могу подключиться к обновлениям плагина, чтобы получать данные об обновлениях (если они есть) для этого плагина.

/**
 * Проверка обновлений плагина
 *
 * @param array|false $update Данные об обновлении плагина с актуальной информацией. По умолчанию false.
 * @param array $plugin_data Заголовки плагина.
 * @param string $plugin_file Имя файла плагина.
 * @param string $locales Установленные локали для поиска переводов.
 *
 * @return array|false Ассоциативный массив с данными об обновлении в случае успеха. Иначе false.
 */
function prefix_check_for_plugin_updates($update, $plugin_data, $plugin_file, $locales = '')
{
    // Логика проверки
    return $update;
}
add_filter('update_plugins_aurisecreative.com', 'prefix_check_for_plugin_updates', 10, 4);

К сожалению, это работает только для плагинов, использующих этот заголовок, поэтому, скорее всего, только для премиальных плагинов.

Источники:

• Документация разработчика для фильтра update_plugins_{hostname}
• Заголовки плагинов
• Анонс заголовка "Update URI" для плагинов в WordPress 5.8 опубликовано 29 июня 2021 года

Вы можете подключиться к фильтрам upgrader_pre_install и upgrader_post_install.