Ticket #18449: 18449.diff

src/wp-admin/includes/list-table.php

@@ -48 +48 @@
                 else
                         $args['screen'] = null;
 
+                /**
+                 * Filter whether to short-circuit the _get_list_table() return.
+                 *
+                 * Returning a non-null value to the filter will short-circuit
+                 * _get_list_table(), allowing developers to return an object
+                 * of a custom class that extends or replaces one of the core
+                 * list table classes.
+                 *
+                 * @param object|null $list_table Replacement List Table object to short-circuit with. Default null.
+                 * @param string      $class      The type of the list table, which is the class name.
+                 * @param object      $args       An object containing _get_list_table() arguments.
+                 */
+                $list_table = apply_filters( 'pre_get_list_table', null, $class, $args );
+
+                if ( null !== $list_table ) {
+                        return $list_table;
+                }
+
                 return new $class( $args );
         }