\WP_Stager_Integration\Event::parse_events(array $events): array[]

Full Code

/**
 * Parses a list of raw Stager events: removes empty entries and runs the result through a filter.
 *
 * @param array $events Array of raw Stager event data (may contain empty arrays).
 *
 * @return array[] Filtered list of raw Stager event arrays.
 */
public static function parse_events( $events ) {

    // Type casting
    $events = (array) ($events ?: array());

    // Remove empty entries
    $events = array_filter( $events );

    /**
     * Filters the list of raw Stager events before they are returned by any event retrieval method.
     *
     * @param array[] $events List of raw Stager event arrays.
     */
    $filtered = (array) apply_filters( 'wpstagerintegration_events', $events );

    return $filtered;
}