hasFixes()) { $notices[] = [ self::class, 'showQuickFixNotice', ]; } $notices = apply_filters('duplicator_admin_notices', $notices); $action = is_multisite() ? 'network_admin_notices' : 'admin_notices'; foreach ($notices as $notice) { add_action($action, $notice); } } /** * Addon init fail notice * * @return void */ public static function addonInitFailNotice(): void { if (\Duplicator\Core\Addons\AddonsManager::getInstance()->isAddonsReady()) { return; } if (!CapMng::can(CapMng::CAP_BASIC, false)) { return; } ob_start(); ?>

isDuplicatorPage()) { return; } global $wp_filter; $filterHooks = [ 'user_admin_notices', 'admin_notices', 'all_admin_notices', 'network_admin_notices', ]; foreach ($filterHooks as $filterHook) { if (empty($wp_filter[$filterHook]->callbacks) || !is_array($wp_filter[$filterHook]->callbacks)) { continue; } foreach ($wp_filter[$filterHook]->callbacks as $priority => $hooks) { foreach ($hooks as $name => $arr) { if (is_object($arr['function']) && $arr['function'] instanceof Closure) { unset($wp_filter[$filterHook]->callbacks[$priority][$name]); continue; } if ( !empty($arr['function'][0]) && is_object($arr['function'][0]) && strpos(get_class($arr['function'][0]), Autoloader::ROOT_NAMESPACE) === 0 ) { continue; } if (!empty($name) && strpos($name, Autoloader::ROOT_NAMESPACE) !== 0) { unset($wp_filter[$filterHook]->callbacks[$priority][$name]); } } } } } /** * Shows notice in case we were enable to fetch contents of S3 bucket * * @throws Exception * @return void */ public static function s3ContentsFetchFailNotice(): void { if ( get_option(self::OPTION_KEY_S3_CONTENTS_FETCH_FAIL_NOTICE, false) != true || !ControllersManager::isCurrentPage(ControllersManager::PACKAGES_SUBMENU_SLUG) ) { return; } if (!CapMng::can(CapMng::CAP_CREATE, false)) { return; } $errorMessage = sprintf( /* translators: %s: plugin name wrapped in strong tags */ __('%s was unable to fetch the contents of the S3 bucket to remove old Backups.', 'duplicator'), esc_html(DUPLICATOR____NAME) ) . "

" . sprintf( __( 'RECOMMENDATION: Please make sure your S3 bucket settings are aligned with our %1$sStep-by-Step guide%2$s and %3$sUser Bucket Policy%4$s.', 'duplicator' ), '', '', '', '' ); self::displayGeneralAdminNotice( $errorMessage, self::GEN_ERROR_NOTICE, true, ['dupli-quick-fix-notice'], [ 'data-to-dismiss' => self::OPTION_KEY_S3_CONTENTS_FETCH_FAIL_NOTICE, ] ); } /** * Notice shown when one or more backups started with invalid storages, * skipped at build start. The option value is the list of invalid storage ids. * * @return void */ public static function backupInvalidStoragesNotice(): void { if ( ($storageIds = get_option(self::OPTION_KEY_BACKUP_INVALID_STORAGES, [])) === [] || !ControllersManager::isCurrentPage(ControllersManager::PACKAGES_SUBMENU_SLUG) ) { return; } if (!CapMng::can(CapMng::CAP_CREATE, false)) { return; } $storages = []; $cleanedIds = []; foreach ($storageIds as $storageId) { if (($storage = AbstractStorageEntity::getById($storageId)) === false) { continue; } $storages[] = $storage; $cleanedIds[] = $storageId; } if ($cleanedIds !== $storageIds) { if (count($cleanedIds) === 0) { delete_option(self::OPTION_KEY_BACKUP_INVALID_STORAGES); } else { update_option(self::OPTION_KEY_BACKUP_INVALID_STORAGES, $cleanedIds); } } if (count($storages) === 0) { return; } $message = TplMng::getInstance()->render( 'admin_pages/storages/storage_invalid_skipped_notice', [ 'storages' => $storages, 'storagesPageUrl' => ControllersManager::getMenuLink(ControllersManager::STORAGE_SUBMENU_SLUG), ], false ); self::displayGeneralAdminNotice( $message, self::GEN_WARNING_NOTICE, true, [], [ 'data-to-dismiss' => self::OPTION_KEY_BACKUP_INVALID_STORAGES, ], true ); } /** * Orphaned packages notice * * @throws Exception * @return void */ public static function orphanedPackagesNotice(): void { $orphan_info = PackageUtils::getOrphanedPackageInfo(); if ( $orphan_info['count'] < 1 || !ControllersManager::isCurrentPage(ControllersManager::PACKAGES_SUBMENU_SLUG) ) { return; } self::displayGeneralAdminNotice( TplMng::getInstance()->render('parts/packages/notices/orphaned_packages', [ 'count' => $orphan_info['count'], 'size' => SnapString::byteSize($orphan_info['size']), 'url' => ToolsPageController::getInstance()->getPurgeOrphanActionUrl(), ], false), self::GEN_ERROR_NOTICE, true, ['dupli-quick-fix-notice'], [ 'data-to-dismiss' => self::OPTION_KEY_S3_CONTENTS_FETCH_FAIL_NOTICE, ] ); } /** * Notice shown when an encrypted entity could not be decrypted on load and was * reset to defaults. Dismissible; dismissing clears the wp_option flag. * * @return void */ public static function encryptedResetNotice(): void { if (!get_option(self::ENCRYPTED_RESET_NOTICE)) { return; } if (!CapMng::can(CapMng::CAP_BASIC, false)) { return; } $html = TplMng::getInstance()->render('parts/notices/encrypted_reset', [ 'storageUrl' => ControllersManager::getMenuLink(ControllersManager::STORAGE_SUBMENU_SLUG), 'settingsUrl' => ControllersManager::getMenuLink(ControllersManager::SETTINGS_SUBMENU_SLUG), ], false); self::displayGeneralAdminNotice( $html, self::GEN_WARNING_NOTICE, true, ['dupli-notice-icon-warning-wrapper'], ['data-to-dismiss' => self::ENCRYPTED_RESET_NOTICE], true ); } /** * Suggestion to run AutoTune, shown on plugin pages while no AutoTune * session has ever been started. Dismissing hides it permanently. * * @return void */ public static function autoTuneSuggestionNotice(): void { if (get_option(self::AUTOTUNE_SUGGEST_DISMISSED, false)) { return; } if ( !ControllersManager::isCurrentPage(ControllersManager::PACKAGES_SUBMENU_SLUG) && !ControllersManager::isCurrentPage(ControllersManager::SETTINGS_SUBMENU_SLUG) ) { return; } if (!CapMng::can(CapMng::CAP_SETTINGS, false)) { return; } // AutoTune runs real test Backups: don't suggest it where backup creation is not allowed. if (!CapMng::can(CapMng::CAP_CREATE, false)) { return; } if (AutoTuneSessionEntity::getInstance()->getStatus() !== AutoTuneSessionEntity::STATUS_NONE) { return; } self::displayGeneralAdminNotice( TplMng::getInstance()->render('parts/notices/autotune_suggestion', [ 'autoTuneUrl' => ControllersManager::getMenuLink( ControllersManager::TOOLS_SUBMENU_SLUG, ToolsPageController::L2_SLUG_AUTOTUNE ), ], false), self::GEN_INFO_NOTICE, true, ['dupli-notice-icon-warning-wrapper'], ['data-to-dismiss' => self::AUTOTUNE_SUGGEST_DISMISSED], true ); } /** * Activity Log integration upgrade notice * * @return void */ public static function activityLogUpgradeNotice(): void { $count = get_transient(self::ACTIVITY_LOG_UPGRADE_NOTICE); if ($count === false) { return; } if (!CapMng::can(CapMng::CAP_BASIC, false)) { return; } self::displayGeneralAdminNotice( TplMng::getInstance()->render('parts/packages/notices/activity_log_upgrade', [ 'count' => $count, 'activityLogUrl' => ActivityLogPageController::getInstance()->getMenuLink(), ], false), self::GEN_INFO_NOTICE, true, ['dupli-activity-log-upgrade-notice'], [ 'data-to-dismiss' => self::ACTIVITY_LOG_UPGRADE_NOTICE, ], true ); } /** * Notice shown when WordPress Multisite is not supported. * * @return void */ public static function multisiteUnsupportedNotice(): void { if (!is_multisite()) { return; } /** * Whether WordPress Multisite is supported. * * @param bool $supported */ if (apply_filters('duplicator_multisite_supported', false)) { return; } if (!CapMng::can(CapMng::CAP_BASIC, false)) { return; } $defaults = [ 'title' => sprintf( /* translators: %s: plugin name (e.g. Duplicator) */ __('%s does not support WordPress Multisite', 'duplicator'), DUPLICATOR____NAME ), 'message' => __( 'Backup creation is not available on multisite installations.', 'duplicator' ), 'buttonUrl' => '', 'buttonLabel' => '', ]; /** * Filters the data passed to the multisite-unsupported notice template. * The button is rendered only when both buttonUrl and buttonLabel are * non-empty. * * @param array{title:string, message:string, buttonUrl:string, buttonLabel:string} $data */ $data = apply_filters('duplicator_multisite_unsupported_notice', $defaults); $data = array_merge($defaults, is_array($data) ? $data : []); $html = TplMng::getInstance()->render('parts/notices/multisite_unsupported', $data, false); self::displayGeneralAdminNotice( $html, self::GEN_ERROR_NOTICE, false, ['dupli-notice-icon-warning-wrapper'], [], true ); } /** * Shows a display message in the wp-admin if any reserved files are found * * @return void */ public static function migrationSuccessNotice(): void { if (get_option(self::OPTION_KEY_MIGRATION_SUCCESS_NOTICE) != true) { return; } if (!CapMng::can(CapMng::CAP_BASIC, false)) { return; } if (!ToolsPageController::isGeneralPage()) { TplMng::getInstance()->render('parts/migration/almost-complete', [ 'safeMsg' => MigrationMng::getSaveModeWarning(), 'isRestoreMode' => MigrationMng::getMigrationData()->restoreBackupMode, 'bottomMessageHtml' => apply_filters(MigrationMng::HOOK_BOTTOM_MIGRATION_MESSAGE, ''), ]); } } /** * Shows the unified failure-message notices: one box per fix title. * * @return void */ public static function showQuickFixNotice(): void { if (!CapMng::can(CapMng::CAP_CREATE, false)) { return; } $groups = FixesEntity::getInstance()->getViewDataGroupedByTitle(); if (count($groups) === 0) { return; } foreach ($groups as $title => $groupFixes) { if ($title === '') { $title = sprintf( /* translators: %s: plugin name */ __('%s Errors Detected', 'duplicator'), DUPLICATOR____NAME ); } $showLogLink = count(array_filter( $groupFixes, static fn(array $fix): bool => $fix['activityLogLink'] )) > 0; $suggestsAutoTune = count(array_filter( $groupFixes, static fn(array $fix): bool => $fix['autoTuneSuggestion'] )) > 0; $html = TplMng::getInstance()->render( 'parts/notices/fix_group', [ 'title' => $title, 'fixes' => $groupFixes, 'activityLogUrl' => $showLogLink ? self::getFixGroupActivityLogUrl($groupFixes) : '', 'autoTuneUrl' => $suggestsAutoTune ? ControllersManager::getMenuLink( ControllersManager::TOOLS_SUBMENU_SLUG, ToolsPageController::L2_SLUG_AUTOTUNE ) : '', ], false ); self::displayGeneralAdminNotice( $html, self::GEN_ERROR_NOTICE, true, [ 'dupli-quick-fix-notice', 'dupli-notice-icon-warning-wrapper', ], [ 'data-to-dismiss' => self::QUICK_FIX_NOTICE, 'data-fix-keys' => implode(',', array_keys($groupFixes)), ], true ); } } /** * Activity Log link for a fix group: when a fix carries the related log * event id, the link opens its detail directly. * * @param array $groupFixes Group display data * * @return string */ private static function getFixGroupActivityLogUrl(array $groupFixes): string { $params = ['filter_severity' => AbstractLogEvent::SEVERITY_ERROR]; foreach (array_reverse($groupFixes) as $fix) { if ($fix['activityLogId'] > 0) { return ActivityLogPageController::getOpenLogUrl($fix['activityLogId'], $params); } } return ActivityLogPageController::getInstance()->getMenuLink(null, null, $params); } /** * display genral admin notice by printing it * * @param string $htmlMsg html code to be printed * @param integer $noticeType constant value of SELF::GEN_ * @param boolean $isDismissible whether the notice is dismissable or not. Default is true * @param string|string[] $extraClasses add more classes to the notice div * @param array $extraAtts assosiate array in which key as attr and value as value of the attr * @param bool $blockContent if false wraps htmlMsg in

otherwise allows to use block tags e.g.

* * @return void */ public static function displayGeneralAdminNotice( $htmlMsg, $noticeType, $isDismissible = true, $extraClasses = [], $extraAtts = [], $blockContent = false ): void { if (empty($extraClasses)) { $classes = []; } elseif (is_array($extraClasses)) { $classes = $extraClasses; } else { $classes = [$extraClasses]; } $classes[] = 'notice'; switch ($noticeType) { case self::GEN_INFO_NOTICE: $classes[] = 'notice-info'; break; case self::GEN_SUCCESS_NOTICE: $classes[] = 'notice-success'; break; case self::GEN_WARNING_NOTICE: $classes[] = 'notice-warning'; break; case self::GEN_ERROR_NOTICE: $classes[] = 'notice-error'; break; default: throw new Exception('Invalid Admin notice type!'); } $classes[] = 'dupli-admin-notice'; if ($isDismissible) { $classes[] = 'is-dismissible'; } $classesStr = implode(' ', $classes); $attsStr = ''; if (!empty($extraAtts)) { $attsStrArr = []; foreach ($extraAtts as $att => $attVal) { $attsStrArr[] = esc_attr($att) . '="' . esc_attr($attVal) . '"'; } $attsStr = implode(' ', $attsStrArr); } // $htmlMsg = self::GEN_ERROR_NOTICE == $noticeType ? " " . $htmlMsg : $htmlMsg; $htmlMsg = !$blockContent ? "

" . $htmlMsg . "

" : $htmlMsg; ?>

>

$pluginSlug) { if (!isset($allPlugins[$pluginSlug])) { unset($pluginsToActive[$index]); continue; } $isActive = is_multisite() ? is_plugin_active_for_network($pluginSlug) : is_plugin_active($pluginSlug); if (!$isActive) { $shouldBeActivated[$pluginSlug] = $allPlugins[$pluginSlug]['Name']; } else { unset($pluginsToActive[$index]); } } if (empty($shouldBeActivated)) { delete_option(AdminNotices::OPTION_KEY_ACTIVATE_PLUGINS_AFTER_INSTALL); return; } else { update_option(AdminNotices::OPTION_KEY_ACTIVATE_PLUGINS_AFTER_INSTALL, $pluginsToActive); } $html = "

" . "

" . __('Warning!', 'duplicator') . " " . __('Migration Almost Complete!', 'duplicator') . "
" . __('Plugin(s) listed here must be activated. Please activate them:', 'duplicator') . "

' . esc_attr($title) . '

"; AdminNotices::displayGeneralAdminNotice( $html, AdminNotices::GEN_WARNING_NOTICE, true, ['dupli-yellow-border'], [ 'data-to-dismiss' => AdminNotices::OPTION_KEY_ACTIVATE_PLUGINS_AFTER_INSTALL, ], true ); } }