_default_wp_die_handler

Kills WordPress execution and display HTML message with error message.

Description

_default_wp_die_handler( (string|WP_Error) $message, (string) $title = '', (array) $args = array() ); 

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

Parameters (3)

0. $message (string|WP_Error)
Error message or WP_Error object.
1. $title — Optional. (string) => ''
Error title. Default empty.
2. $args — Optional. (array) => array()
Arguments to control behavior. Default empty array.

Usage

  1. if ( !function_exists( '_default_wp_die_handler' ) ) { 
  2.     require_once ABSPATH . WPINC . '/functions.php'; 
  3. } 
  4.   
  5. // Error message or WP_Error object. 
  6. $message = null; 
  7.   
  8. // Optional. Error title. Default empty. 
  9. $title = ''; 
  10.   
  11. // Optional. Arguments to control behavior. Default empty array. 
  12. $args = array(); 
  13.   
  14. // NOTICE! Understand what this does before running. 
  15. $result = _default_wp_die_handler($message, $title, $args); 
  16.     

Defined (1)

The function is defined in the following location(s).

/wp-includes/functions.php  
  1. function _default_wp_die_handler( $message, $title = '', $args = array() ) { 
  2.     $defaults = array( 'response' => 500 ); 
  3.     $r = wp_parse_args($args, $defaults); 
  4.  
  5.     $have_gettext = function_exists('__'); 
  6.  
  7.     if ( function_exists( 'is_wp_error' ) && is_wp_error( $message ) ) { 
  8.         if ( empty( $title ) ) { 
  9.             $error_data = $message->get_error_data(); 
  10.             if ( is_array( $error_data ) && isset( $error_data['title'] ) ) 
  11.                 $title = $error_data['title']; 
  12.         } 
  13.         $errors = $message->get_error_messages(); 
  14.         switch ( count( $errors ) ) { 
  15.         case 0 : 
  16.             $message = ''; 
  17.             break; 
  18.         case 1 : 
  19.             $message = "<p>{$errors[0]}</p>"; 
  20.             break; 
  21.         default : 
  22.             $message = "<ul>\n\t\t<li>" . join( "</li>\n\t\t<li>", $errors ) . "</li>\n\t</ul>"; 
  23.             break; 
  24.         } 
  25.     } elseif ( is_string( $message ) ) { 
  26.         $message = "<p>$message</p>"; 
  27.     } 
  28.  
  29.     if ( isset( $r['back_link'] ) && $r['back_link'] ) { 
  30.         $back_text = $have_gettext? __('« Back') : '« Back'; 
  31.         $message .= "\n<p><a href='javascript:history.back()'>$back_text</a></p>"; 
  32.     } 
  33.  
  34.     if ( ! did_action( 'admin_head' ) ) : 
  35.         if ( !headers_sent() ) { 
  36.             status_header( $r['response'] ); 
  38.             header( 'Content-Type: text/html; charset=utf-8' ); 
  39.         } 
  40.  
  41.         if ( empty($title) ) 
  42.             $title = $have_gettext ? __('WordPress › Error') : 'WordPress › Error'; 
  43.  
  44.         $text_direction = 'ltr'; 
  45.         if ( isset($r['text_direction']) && 'rtl' == $r['text_direction'] ) 
  46.             $text_direction = 'rtl'; 
  47.         elseif ( function_exists( 'is_rtl' ) && is_rtl() ) 
  48.             $text_direction = 'rtl'; 
  49. ?> 
  50. <!DOCTYPE html> 
  51. <!-- Ticket #11289, IE bug fix: always pad theerrorpage with enough characters such that it is greater than 512 bytes, even after gzip compression abcdefghijklmnopqrstuvwxyz1234567890aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz11223344556677889900abacbcbdcdcededfefegfgfhghgihihjijikjkjlklkmlmlnmnmononpopoqpqprqrqsrsrtstsubcbcdcdedefefgfabcadefbghicjkldmnoepqrfstugvwxhyz1i234j567k890laabmbccnddeoeffpgghqhiirjjksklltmmnunoovppqwqrrxsstytuuzvvw0wxx1yyz2z113223434455666777889890091abc2def3ghi4jkl5mno6pqr7stu8vwx9yz11aab2bcc3dd4ee5ff6gg7hh8ii9j0jk1kl2lmm3nnoo4p5pq6qrr7ss8tt9uuvv0wwx1x2yyzz13aba4cbcb5dcdc6dedfef8egf9gfh0ghg1ihi2hji3jik4jkj5lkl6kml7mln8mnm9ono 
  52. --> 
  53. <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'"; ?>> 
  54. <head> 
  55.     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
  56.     <meta name="viewport" content="width=device-width"> 
  57.     <?php 
  58.     if ( function_exists( 'wp_no_robots' ) ) { 
  60.     } 
  61.     ?> 
  62.     <title><?php echo $title ?></title> 
  63.     <style type="text/css"> 
  64.         html { 
  65.             background: #f1f1f1; 
  66.         } 
  67.         body { 
  68.             background: #fff; 
  69.             color: #444; 
  70.             font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen-Sans, Ubuntu, Cantarell, "Helvetica Neue", sans-serif; 
  71.             margin: 2em auto; 
  72.             padding: 1em 2em; 
  73.             max-width: 700px; 
  74.             -webkit-box-shadow: 0 1px 3px rgba(0, 0, 0, 0.13); 
  75.             box-shadow: 0 1px 3px rgba(0, 0, 0, 0.13); 
  76.         } 
  77.         h1 { 
  78.             border-bottom: 1px solid #dadada; 
  79.             clear: both; 
  80.             color: #666; 
  81.             font-size: 24px; 
  82.             margin: 30px 0 0 0; 
  83.             padding: 0; 
  84.             padding-bottom: 7px; 
  85.         } 
  86.         #error-page { 
  87.             margin-top: 50px; 
  88.         } 
  89.         #error-page p { 
  90.             font-size: 14px; 
  91.             line-height: 1.5; 
  92.             margin: 25px 0 20px; 
  93.         } 
  94.         #error-page code { 
  95.             font-family: Consolas, Monaco, monospace; 
  96.         } 
  97.         ul li { 
  98.             margin-bottom: 10px; 
  99.             font-size: 14px ; 
  100.         } 
  101.         a { 
  102.             color: #0073aa; 
  103.         } 
  104.         a:hover,  
  105.         a:active { 
  106.             color: #00a0d2; 
  107.         } 
  108.         a:focus { 
  109.             color: #124964; 
  110.             -webkit-box-shadow: 
  111.                 0 0 0 1px #5b9dd9,  
  112.                 0 0 2px 1px rgba(30, 140, 190, .8); 
  113.             box-shadow: 
  114.                 0 0 0 1px #5b9dd9,  
  115.                 0 0 2px 1px rgba(30, 140, 190, .8); 
  116.             outline: none; 
  117.         } 
  118.         .button { 
  119.             background: #f7f7f7; 
  120.             border: 1px solid #ccc; 
  121.             color: #555; 
  122.             display: inline-block; 
  123.             text-decoration: none; 
  124.             font-size: 13px; 
  125.             line-height: 26px; 
  126.             height: 28px; 
  127.             margin: 0; 
  128.             padding: 0 10px 1px; 
  129.             cursor: pointer; 
  130.             -webkit-border-radius: 3px; 
  131.             -webkit-appearance: none; 
  132.             border-radius: 3px; 
  133.             white-space: nowrap; 
  134.             -webkit-box-sizing: border-box; 
  135.             -moz-box-sizing:    border-box; 
  136.             box-sizing:         border-box; 
  137.  
  138.             -webkit-box-shadow: 0 1px 0 #ccc; 
  139.             box-shadow: 0 1px 0 #ccc; 
  140.              vertical-align: top; 
  141.         } 
  142.  
  143.         .button.button-large { 
  144.             height: 30px; 
  145.             line-height: 28px; 
  146.             padding: 0 12px 2px; 
  147.         } 
  148.  
  149.         .button:hover,  
  150.         .button:focus { 
  151.             background: #fafafa; 
  152.             border-color: #999; 
  153.             color: #23282d; 
  154.         } 
  155.  
  156.         .button:focus  { 
  157.             border-color: #5b9dd9; 
  158.             -webkit-box-shadow: 0 0 3px rgba( 0, 115, 170, .8 ); 
  159.             box-shadow: 0 0 3px rgba( 0, 115, 170, .8 ); 
  160.             outline: none; 
  161.         } 
  162.  
  163.         .button:active { 
  164.             background: #eee; 
  165.             border-color: #999; 
  166.              -webkit-box-shadow: inset 0 2px 5px -3px rgba( 0, 0, 0, 0.5 ); 
  167.              box-shadow: inset 0 2px 5px -3px rgba( 0, 0, 0, 0.5 ); 
  168.              -webkit-transform: translateY(1px); 
  169.              -ms-transform: translateY(1px); 
  170.              transform: translateY(1px); 
  171.         } 
  172.  
  173.         <?php 
  174.         if ( 'rtl' == $text_direction ) { 
  175.             echo 'body { font-family: Tahoma, Arial; }'; 
  176.         } 
  177.         ?> 
  178.     </style> 
  179. </head> 
  180. <body id="error-page"> 
  181. <?php endif; // ! did_action( 'admin_head' ) ?> 
  182.     <?php echo $message; ?> 
  183. </body> 
  184. </html> 
  185. <?php 
  186.     die(); 
  187. }