_default_wp_die_handler() - Kills WordPress execution and display HTML message with error message.

Description

Kills WordPress execution and display HTML message with error message.

This is the default handler for wp_die if you want a custom one for your site then you can overload using the wp_die_handler filter in wp_die().

Usage

_default_wp_die_handler( $message, $title, $args );

Parameters

$message: ( string|WP_Error ) required – Error message or WP_Error object.
$title: ( string ) optional – Optional. Error title. Default empty.
$args: ( string|array ) optional – Optional. Arguments to control behavior. Default empty array.

Returns

void

Source

File name: wordpress/wp-includes/functions.php
Lines: 1 to 100 of 185

function _default_wp_die_handler( $message, $title = '', $args = array() ) {
  $defaults = array( 'response' => 500 );
  $r = wp_parse_args($args, $defaults);

  $have_gettext = function_exists('__');

  if ( function_exists( 'is_wp_error' ) && is_wp_error( $message ) ) {
    if ( empty( $title ) ) {
      $error_data = $message->get_error_data();
      if ( is_array( $error_data ) && isset( $error_data['title'] ) )
        $title = $error_data['title'];
    }
    $errors = $message->get_error_messages();
    switch ( count( $errors ) ) {
    case 0 :
      $message = '';
      break;
    case 1 :
      $message = "<p>{$errors[0]}</p>";
      break;
    default :
      $message = "<ul>\n\t\t<li>" . join( "</li>\n\t\t<li>", $errors ) . "</li>\n\t</ul>";
      break;
    }
  } elseif ( is_string( $message ) ) {
    $message = "<p>$message</p>";
  }

  if ( isset( $r['back_link'] ) && $r['back_link'] ) {
    $back_text = $have_gettext? __('&laquo; Back') : '&laquo; Back';
    $message .= "\n<p><a href='javascript:history.back()'>$back_text</a></p>";
  }

  if ( ! did_action( 'admin_head' ) ) :
    if ( !headers_sent() ) {
      status_header( $r['response'] );
      nocache_headers();
      header( 'Content-Type: text/html; charset=utf-8' );
    }

    if ( empty($title) )
      $title = $have_gettext ? __('WordPress &rsaquo; Error') : 'WordPress &rsaquo; Error';

    $text_direction = 'ltr';
    if ( isset($r['text_direction']) && 'rtl' == $r['text_direction'] )
      $text_direction = 'rtl';
    elseif ( function_exists( 'is_rtl' ) && is_rtl() )
      $text_direction = 'rtl';
?>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" <?php if ( function_exists( 'language_attributes' ) && function_exists( 'is_rtl' ) ) language_attributes(); else echo "dir='$text_direction'"; ?>>
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
	<meta name="viewport" content="width=device-width">
	<?php
  if ( function_exists( 'wp_no_robots' ) ) {
    wp_no_robots();
  }
  ?>
	<title><?php echo $title ?></title>
	<style type="text/css">
		html {
			background: #f1f1f1;
		}
		body {
			background: #fff;
			color: #444;
			font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen-Sans, Ubuntu, Cantarell, "Helvetica Neue", sans-serif;
			margin: 2em auto;
			padding: 1em 2em;
			max-width: 700px;
			-webkit-box-shadow: 0 1px 3px rgba(0,0,0,0.13);
			box-shadow: 0 1px 3px rgba(0,0,0,0.13);
		}
		h1 {
			border-bottom: 1px solid #dadada;
			clear: both;
			color: #666;
			font-size: 24px;
			margin: 30px 0 0 0;
			padding: 0;
			padding-bottom: 7px;
		}
		#error-page {
			margin-top: 50px;
		}
		#error-page p {
			font-size: 14px;
			line-height: 1.5;
			margin: 25px 0 20px;
		}
		#error-page code {
			font-family: Consolas, Monaco, monospace;
		}
		ul li {
			margin-bottom: 10px;
			font-size: 14px ;
		}
		a {
			color: #0073aa;

[1] [2] Next » View on GitHub View on Trac

Called by

Invoked by

Calls

1 to 10 of 10

Call hooks

Function name: _default_wp_die_handler

Plugin ref: WordPress

Version: 4.9.6

Sourcefile: wp-includes/functions.php

File ref: wp-includes/functions.php

API type: private

Deprecated?: No

API Letters: _,D,H,W