<?php class wfOnboardingController { const ONBOARDING_EMAILS = 'emails'; //New install, part 1 completed const ONBOARDING_LICENSE = 'license'; //New install, part 2 completed const ONBOARDING_SKIPPED = 'skipped'; //New install, onboarding attempt was skipped const TOUR_DASHBOARD = 'dashboard'; const TOUR_FIREWALL = 'firewall'; const TOUR_SCAN = 'scan'; const TOUR_BLOCKING = 'blocking'; const TOUR_LIVE_TRAFFIC = 'livetraffic'; const TOUR_AUDIT_LOG = 'auditlog'; const TOUR_LOGIN_SECURITY = 'loginsecurity'; /** * Sets the appropriate initial settings for an existing install so it's not forced through onboarding. */ public static function migrateOnboarding() { $alertEmails = wfConfig::getAlertEmails(); $onboardingAttempt1 = wfConfig::get('onboardingAttempt1'); $lastOnboardingVersion = wfConfig::get('onboardingLastVersion'); if (!empty($alertEmails) && empty($onboardingAttempt1)) { //Wordfence 7.0 migration wfConfig::set('onboardingAttempt1', self::ONBOARDING_LICENSE); //Mark onboarding as done $keys = array(self::TOUR_DASHBOARD, self::TOUR_FIREWALL, self::TOUR_SCAN, self::TOUR_BLOCKING, self::TOUR_LIVE_TRAFFIC, self::TOUR_AUDIT_LOG); foreach ($keys as $k) { wfConfig::set('needsNewTour_' . $k, 0); wfConfig::set('needsUpgradeTour_' . $k, 1); } wfConfig::set('onboardingLastVersion', WORDFENCE_VERSION); } else if (!empty($alertEmails) && !empty($onboardingAttempt1) && (empty($lastOnboardingVersion) || version_compare('8.0', $lastOnboardingVersion) == 1)) { //Future new tour steps can copy this block and extend $keys = array(self::TOUR_AUDIT_LOG); foreach ($keys as $k) { wfConfig::set('needsNewTour_' . $k, 0); wfConfig::set('needsUpgradeTour_' . $k, 1); } wfConfig::set('onboardingLastVersion', WORDFENCE_VERSION); } } /** * Initializes the onboarding hooks. * * Only called if (is_admin() && wfUtils::isAdmin()) is true. */ public static function initialize() { $willShowAnyTour = (self::shouldShowNewTour(self::TOUR_DASHBOARD) || self::shouldShowUpgradeTour(self::TOUR_DASHBOARD) || self::shouldShowNewTour(self::TOUR_FIREWALL) || self::shouldShowUpgradeTour(self::TOUR_FIREWALL) || self::shouldShowNewTour(self::TOUR_SCAN) || self::shouldShowUpgradeTour(self::TOUR_SCAN) || self::shouldShowNewTour(self::TOUR_BLOCKING) || self::shouldShowUpgradeTour(self::TOUR_BLOCKING) || self::shouldShowNewTour(self::TOUR_LIVE_TRAFFIC) || self::shouldShowUpgradeTour(self::TOUR_LIVE_TRAFFIC) || self::shouldShowNewTour(self::TOUR_AUDIT_LOG) || self::shouldShowUpgradeTour(self::TOUR_AUDIT_LOG) || self::shouldShowNewTour(self::TOUR_LOGIN_SECURITY) || self::shouldShowUpgradeTour(self::TOUR_LOGIN_SECURITY)); if (!self::shouldShowAnyAttempt() && !$willShowAnyTour) { return; } add_action('in_admin_header', 'wfOnboardingController::_admin_header'); //Called immediately after <div id="wpcontent"> add_action('pre_current_active_plugins', 'wfOnboardingController::_pre_plugins'); //Called immediately after <hr class="wp-header-end"> add_action('admin_enqueue_scripts', 'wfOnboardingController::_enqueue_scripts'); } /** * Enqueues the scripts and styles we need globally on the backend for onboarding. */ public static function _enqueue_scripts() { $willShowAnyPluginOnboarding = (self::shouldShowAttempt1() || self::shouldShowAttempt2()); $willShowAnyTour = (self::shouldShowNewTour(self::TOUR_DASHBOARD) || self::shouldShowUpgradeTour(self::TOUR_DASHBOARD) || self::shouldShowNewTour(self::TOUR_FIREWALL) || self::shouldShowUpgradeTour(self::TOUR_FIREWALL) || self::shouldShowNewTour(self::TOUR_SCAN) || self::shouldShowUpgradeTour(self::TOUR_SCAN) || self::shouldShowNewTour(self::TOUR_BLOCKING) || self::shouldShowUpgradeTour(self::TOUR_BLOCKING) || self::shouldShowNewTour(self::TOUR_LIVE_TRAFFIC) || self::shouldShowUpgradeTour(self::TOUR_LIVE_TRAFFIC) || self::shouldShowNewTour(self::TOUR_AUDIT_LOG) || self::shouldShowUpgradeTour(self::TOUR_AUDIT_LOG) || self::shouldShowNewTour(self::TOUR_LOGIN_SECURITY) || self::shouldShowUpgradeTour(self::TOUR_LOGIN_SECURITY)); $page = wfUtils::array_get($_GET, 'page', ''); if (wfUtils::isAdmin() && ( ( $willShowAnyPluginOnboarding && preg_match('~(?:^|/)wp-admin(?:/network)?/plugins\.php~i', $_SERVER['REQUEST_URI']) ) || ( !empty($page) && (preg_match('/^Wordfence/', $page) || preg_match('/^WFLS/', $page)) ) ) ) { self::enqueue_assets(); } } public static function enqueue_assets() { wp_enqueue_style('wordfence-font', wfUtils::getBaseURL() . wfUtils::versionedAsset('css/wf-roboto-font.css'), '', WORDFENCE_VERSION); wp_enqueue_style('wordfence-ionicons-style', wfUtils::getBaseURL() . wfUtils::versionedAsset('css/wf-ionicons.css'), '', WORDFENCE_VERSION); wp_enqueue_style('wordfenceOnboardingCSS', wfUtils::getBaseURL() . wfUtils::versionedAsset('css/wf-onboarding.css'), '', WORDFENCE_VERSION); wp_enqueue_style('wordfence-colorbox-style', wfUtils::getBaseURL() . wfUtils::versionedAsset('css/wf-colorbox.css'), '', WORDFENCE_VERSION); wp_enqueue_script('jquery.wfcolorbox', wfUtils::getBaseURL() . wfUtils::versionedAsset('js/jquery.colorbox-min.js'), array('jquery'), WORDFENCE_VERSION); } /** * Outputs the onboarding overlay if it needs to be shown on the plugins page. */ public static function _admin_header() { $willShowAnyTour = (self::shouldShowNewTour(self::TOUR_DASHBOARD) || self::shouldShowUpgradeTour(self::TOUR_DASHBOARD) || self::shouldShowNewTour(self::TOUR_FIREWALL) || self::shouldShowUpgradeTour(self::TOUR_FIREWALL) || self::shouldShowNewTour(self::TOUR_SCAN) || self::shouldShowUpgradeTour(self::TOUR_SCAN) || self::shouldShowNewTour(self::TOUR_BLOCKING) || self::shouldShowUpgradeTour(self::TOUR_BLOCKING) || self::shouldShowNewTour(self::TOUR_LIVE_TRAFFIC) || self::shouldShowUpgradeTour(self::TOUR_LIVE_TRAFFIC) || self::shouldShowNewTour(self::TOUR_AUDIT_LOG) || self::shouldShowUpgradeTour(self::TOUR_AUDIT_LOG) || self::shouldShowNewTour(self::TOUR_LOGIN_SECURITY) || self::shouldShowUpgradeTour(self::TOUR_LOGIN_SECURITY)); $screen = get_current_screen(); if ($screen->base == 'plugins' && self::shouldShowAttempt1()) { register_shutdown_function('wfOnboardingController::_markAttempt1Shown'); $freshInstall = wfView::create('onboarding/fresh-install')->render(); echo wfView::create('onboarding/overlay', array( 'contentHTML' => $freshInstall, ))->render(); } else if (preg_match('/wordfence/i', $screen->base) && $willShowAnyTour) { echo wfView::create('onboarding/tour-overlay')->render(); } } public static function _markAttempt1Shown() { wfConfig::set('onboardingAttempt1', self::ONBOARDING_SKIPPED); //Only show it once, default to skipped after outputting the first time } public static function shouldShowAttempt1() { //Overlay on plugin page if (wfConfig::get('onboardingAttempt3') == self::ONBOARDING_LICENSE) { return false; } switch (wfConfig::get('onboardingAttempt1')) { case self::ONBOARDING_LICENSE: case self::ONBOARDING_SKIPPED: return false; } return true; } public static function _pre_plugins() { if (self::shouldShowAttempt2()) { echo wfView::create('onboarding/plugin-header')->render(); } } private static function needsApiKey() { $key = wfConfig::get('apiKey'); return empty($key); } public static function shouldShowAttempt2() { //Header on plugin page if (wfConfig::get('onboardingAttempt3') == self::ONBOARDING_LICENSE) { return false; } return !wfConfig::get('onboardingAttempt2') && self::needsApiKey(); } public static function shouldShowAttempt3($dismissable = false) { if (self::needsApiKey()) { if (!$dismissable) return true; $delayedAt = (int) wfConfig::get('onboardingDelayedAt', 0); if (time() - $delayedAt > 43200 /*12 hours in seconds*/) return true; } return false; } /** * Whether or not to pop up attempt 3 at page load or wait for user interaction. * * @return bool */ public static function shouldShowAttempt3Automatically() { static $_shouldShowAttempt3Automatically = null; if ($_shouldShowAttempt3Automatically !== null) { //We cache this so the answer remains the same for the whole request return $_shouldShowAttempt3Automatically; } if (!self::shouldShowAttempt3()) { $_shouldShowAttempt3Automatically = false; return false; } return $_shouldShowAttempt3Automatically = self::shouldShowAttempt3(); } public static function willShowNewTour($page) { $key = 'needsNewTour_' . $page; return wfConfig::get($key); } public static function shouldShowNewTour($page) { $key = 'needsNewTour_' . $page; return (!self::shouldShowAttempt3Automatically() && !wfConfig::get('touppPromptNeeded') && wfConfig::get($key)); } public static function willShowUpgradeTour($page) { $key = 'needsUpgradeTour_' . $page; return wfConfig::get($key); } public static function shouldShowUpgradeTour($page) { $key = 'needsUpgradeTour_' . $page; return (!self::shouldShowAttempt3Automatically() && !wfConfig::get('touppPromptNeeded') && wfConfig::get($key)); } public static function shouldShowAnyAttempt() { return self::shouldShowAttempt1() || self::shouldShowAttempt2() || self::shouldShowAttempt3(); } }
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
Diff | Folder | 0755 |
|
|
audit-log | Folder | 0755 |
|
|
dashboard | Folder | 0755 |
|
|
rest-api | Folder | 0755 |
|
|
.htaccess | File | 354 B | 0644 |
|
Diff.php | File | 5.63 KB | 0644 |
|
GeoLite2-Country.mmdb | File | 7.46 MB | 0644 |
|
IPTraf.php | File | 1.17 KB | 0644 |
|
IPTrafList.php | File | 2.98 KB | 0644 |
|
WFLSPHP52Compatability.php | File | 1.27 KB | 0644 |
|
compat.php | File | 425 B | 0644 |
|
diffResult.php | File | 2.81 KB | 0644 |
|
email_genericAlert.php | File | 1.39 KB | 0644 |
|
email_newIssues.php | File | 8.82 KB | 0644 |
|
email_unlockRequest.php | File | 2.34 KB | 0644 |
|
email_unsubscribeRequest.php | File | 1.05 KB | 0644 |
|
flags.php | File | 6.62 KB | 0644 |
|
live_activity.php | File | 580 B | 0644 |
|
menu_dashboard.php | File | 28 KB | 0644 |
|
menu_dashboard_options.php | File | 15.21 KB | 0644 |
|
menu_firewall.php | File | 2.12 KB | 0644 |
|
menu_firewall_blocking.php | File | 10.25 KB | 0644 |
|
menu_firewall_blocking_options.php | File | 4.63 KB | 0644 |
|
menu_firewall_waf.php | File | 19.96 KB | 0644 |
|
menu_firewall_waf_options.php | File | 11.09 KB | 0644 |
|
menu_install.php | File | 1.73 KB | 0644 |
|
menu_options.php | File | 24.7 KB | 0644 |
|
menu_scanner.php | File | 21.53 KB | 0644 |
|
menu_scanner_credentials.php | File | 2.77 KB | 0644 |
|
menu_scanner_options.php | File | 8.41 KB | 0644 |
|
menu_support.php | File | 17.82 KB | 0644 |
|
menu_tools.php | File | 1.49 KB | 0644 |
|
menu_tools_auditlog.php | File | 16.43 KB | 0644 |
|
menu_tools_diagnostic.php | File | 49.35 KB | 0644 |
|
menu_tools_importExport.php | File | 1.28 KB | 0644 |
|
menu_tools_livetraffic.php | File | 39.43 KB | 0644 |
|
menu_tools_twoFactor.php | File | 19.6 KB | 0644 |
|
menu_tools_whois.php | File | 4.61 KB | 0644 |
|
menu_wordfence_central.php | File | 9.66 KB | 0644 |
|
noc1.key | File | 1.64 KB | 0644 |
|
sodium_compat_fast.php | File | 185 B | 0644 |
|
sysinfo.php | File | 1.47 KB | 0644 |
|
viewFullActivityLog.php | File | 1.47 KB | 0644 |
|
wf503.php | File | 9.63 KB | 0644 |
|
wfAPI.php | File | 9.73 KB | 0644 |
|
wfActivityReport.php | File | 20.45 KB | 0644 |
|
wfAdminNoticeQueue.php | File | 5.2 KB | 0644 |
|
wfAlerts.php | File | 7.37 KB | 0644 |
|
wfArray.php | File | 1.77 KB | 0644 |
|
wfAuditLog.php | File | 47.13 KB | 0644 |
|
wfBrowscap.php | File | 3.9 KB | 0644 |
|
wfBrowscapCache.php | File | 256.83 KB | 0644 |
|
wfBulkCountries.php | File | 9.77 KB | 0644 |
|
wfCache.php | File | 6.02 KB | 0644 |
|
wfCentralAPI.php | File | 25.8 KB | 0644 |
|
wfConfig.php | File | 122.49 KB | 0644 |
|
wfCrawl.php | File | 6.56 KB | 0644 |
|
wfCredentialsController.php | File | 5.16 KB | 0644 |
|
wfCrypt.php | File | 4.05 KB | 0644 |
|
wfCurlInterceptor.php | File | 1.02 KB | 0644 |
|
wfDB.php | File | 11.49 KB | 0644 |
|
wfDashboard.php | File | 8.2 KB | 0644 |
|
wfDateLocalization.php | File | 352.13 KB | 0644 |
|
wfDeactivationOption.php | File | 2.13 KB | 0644 |
|
wfDiagnostic.php | File | 66.87 KB | 0644 |
|
wfDict.php | File | 738 B | 0644 |
|
wfDirectoryIterator.php | File | 1.89 KB | 0644 |
|
wfFileUtils.php | File | 2.72 KB | 0644 |
|
wfHelperBin.php | File | 1.97 KB | 0644 |
|
wfHelperString.php | File | 2.13 KB | 0644 |
|
wfIPWhitelist.php | File | 1.56 KB | 0644 |
|
wfImportExportController.php | File | 3.23 KB | 0644 |
|
wfInaccessibleDirectoryException.php | File | 303 B | 0644 |
|
wfInvalidPathException.php | File | 266 B | 0644 |
|
wfIpLocation.php | File | 1.73 KB | 0644 |
|
wfIpLocator.php | File | 2.74 KB | 0644 |
|
wfIssues.php | File | 27.91 KB | 0644 |
|
wfJWT.php | File | 5.33 KB | 0644 |
|
wfLicense.php | File | 10.43 KB | 0644 |
|
wfLockedOut.php | File | 9.73 KB | 0644 |
|
wfLog.php | File | 57.1 KB | 0644 |
|
wfMD5BloomFilter.php | File | 5.2 KB | 0644 |
|
wfModuleController.php | File | 754 B | 0644 |
|
wfNotification.php | File | 6.41 KB | 0644 |
|
wfOnboardingController.php | File | 9.22 KB | 0644 |
|
wfPersistenceController.php | File | 819 B | 0644 |
|
wfRESTAPI.php | File | 377 B | 0644 |
|
wfScan.php | File | 15.92 KB | 0644 |
|
wfScanEngine.php | File | 133.31 KB | 0644 |
|
wfScanEntrypoint.php | File | 1.04 KB | 0644 |
|
wfScanFile.php | File | 1.01 KB | 0644 |
|
wfScanFileLink.php | File | 403 B | 0644 |
|
wfScanFileListItem.php | File | 408 B | 0644 |
|
wfScanFileProperties.php | File | 1.07 KB | 0644 |
|
wfScanMonitor.php | File | 4.05 KB | 0644 |
|
wfScanPath.php | File | 1.77 KB | 0644 |
|
wfSchema.php | File | 10.91 KB | 0644 |
|
wfStyle.php | File | 1.21 KB | 0644 |
|
wfSupportController.php | File | 24.18 KB | 0644 |
|
wfUnlockMsg.php | File | 1.14 KB | 0644 |
|
wfUpdateCheck.php | File | 27.23 KB | 0644 |
|
wfUtils.php | File | 124.11 KB | 0644 |
|
wfVersionCheckController.php | File | 19.27 KB | 0644 |
|
wfVersionSupport.php | File | 535 B | 0644 |
|
wfView.php | File | 2.22 KB | 0644 |
|
wfViewResult.php | File | 1.42 KB | 0644 |
|
wfWebsite.php | File | 1.75 KB | 0644 |
|
wordfenceClass.php | File | 435.98 KB | 0644 |
|
wordfenceConstants.php | File | 3.56 KB | 0644 |
|
wordfenceHash.php | File | 42.7 KB | 0644 |
|
wordfenceScanner.php | File | 30.47 KB | 0644 |
|
wordfenceURLHoover.php | File | 18.36 KB | 0644 |
|