Changeset 12790

Timestamp:

01/21/2010 10:13:20 PM (15 years ago)

Author:

westi

Message:

Allow for an alternative handler for wp_die to be used if required. See #11892.

File:

• trunk/wp-includes/functions.php (modified) (2 diffs)

trunk/wp-includes/functions.php

@@ -2471 +2471 @@
 }
 
+
 /**
  * Kill WordPress execution and display HTML message with error message.
  *
- * Call this function complements the die() PHP function. The difference is that
+ * This function complements the die() PHP function. The difference is that
  * HTML will be displayed to the user. It is recommended to use this function
  * only, when the execution should not continue any further. It is not
@@ -2487 +2488 @@
  */
 function wp_die( $message, $title = '', $args = array() ) {
+    if ( function_exists( 'apply_filters' ) ) {
+        $function = apply_filters( 'wp_die_handler', '_default_wp_die_handler');
+    }else {
+        $function = '_default_wp_die_handler';
+    }
+
+    call_user_func( $function, $message, $title, $args );
+}
+
+/**
+ * Kill 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
+ *
+ * @since 3.0.0
+ * @private
+ * 
+ * @param string $message Error message.
+ * @param string $title Error title.
+ * @param string|array $args Optional arguements to control behaviour.
+ */
+function _default_wp_die_handler( $message, $title = '', $args = array() ) {
     global $wp_locale;