Priority File Manager
📁 public_html
Base Directory:
/home/ecedu/public_html
/home/ecedu/public_html/wp-content/plugins
/home/ecedu/public_html/wp-content
/home/ecedu
/var/www
/var/www/cgi-bin
/var/www/html
public_html
/
wp-includes
/home/ecedu/public_html/wp-includes
Name
Type
Size
Actions
📁
..
Folder
-
Delete
Rename
📁
ID3
Folder
-
Delete
Rename
📁
IXR
Folder
-
Delete
Rename
📁
PHPMailer
Folder
-
Delete
Rename
📁
Requests
Folder
-
Delete
Rename
📁
SimplePie
Folder
-
Delete
Rename
📁
Text
Folder
-
Delete
Rename
📄
admin-bar.php
File
37106
Delete
Rename
Edit
Download
📁
assets
Folder
-
Delete
Rename
📄
atomlib.php
File
12078
Delete
Rename
Edit
Download
📄
author-template.php
File
18951
Delete
Rename
Edit
Download
📁
block-bindings
Folder
-
Delete
Rename
📄
block-bindings.php
File
5594
Delete
Rename
Edit
Download
📄
block-editor.php
File
28797
Delete
Rename
Edit
Download
📄
block-i18n.json
File
316
Delete
Rename
Edit
Download
📁
block-patterns
Folder
-
Delete
Rename
📄
block-patterns.php
File
13213
Delete
Rename
Edit
Download
📁
block-supports
Folder
-
Delete
Rename
📄
block-template-utils.php
File
61907
Delete
Rename
Edit
Download
📄
block-template.php
File
15356
Delete
Rename
Edit
Download
📁
blocks
Folder
-
Delete
Rename
📄
blocks.php
File
113051
Delete
Rename
Edit
Download
📄
bookmark-template.php
File
12768
Delete
Rename
Edit
Download
📄
bookmark.php
File
15427
Delete
Rename
Edit
Download
📄
cache-compat.php
File
5969
Delete
Rename
Edit
Download
📄
cache.php
File
13474
Delete
Rename
Edit
Download
📄
canonical.php
File
34523
Delete
Rename
Edit
Download
📄
capabilities.php
File
42718
Delete
Rename
Edit
Download
📄
category-template.php
File
57003
Delete
Rename
Edit
Download
📄
category.php
File
12829
Delete
Rename
Edit
Download
📁
certificates
Folder
-
Delete
Rename
📄
class-IXR.php
File
2616
Delete
Rename
Edit
Download
📄
class-avif-info.php
File
29615
Delete
Rename
Edit
Download
📄
class-feed.php
File
539
Delete
Rename
Edit
Download
📄
class-http.php
File
367
Delete
Rename
Edit
Download
📄
class-json.php
File
43684
Delete
Rename
Edit
Download
📄
class-oembed.php
File
401
Delete
Rename
Edit
Download
📄
class-phpass.php
File
6771
Delete
Rename
Edit
Download
📄
class-phpmailer.php
File
664
Delete
Rename
Edit
Download
📄
class-pop3.php
File
21121
Delete
Rename
Edit
Download
📄
class-requests.php
File
2237
Delete
Rename
Edit
Download
📄
class-simplepie.php
File
453
Delete
Rename
Edit
Download
📄
class-smtp.php
File
457
Delete
Rename
Edit
Download
📄
class-snoopy.php
File
37715
Delete
Rename
Edit
Download
📄
class-walker-category-dropdown.php
File
2469
Delete
Rename
Edit
Download
📄
class-walker-category.php
File
8477
Delete
Rename
Edit
Download
📄
class-walker-comment.php
File
14221
Delete
Rename
Edit
Download
📄
class-walker-nav-menu.php
File
12044
Delete
Rename
Edit
Download
📄
class-walker-page-dropdown.php
File
2710
Delete
Rename
Edit
Download
📄
class-walker-page.php
File
7612
Delete
Rename
Edit
Download
📄
class-wp-admin-bar.php
File
17874
Delete
Rename
Edit
Download
📄
class-wp-ajax-response.php
File
5266
Delete
Rename
Edit
Download
📄
class-wp-application-passwords.php
File
17099
Delete
Rename
Edit
Download
📄
class-wp-block-bindings-registry.php
File
8463
Delete
Rename
Edit
Download
📄
class-wp-block-bindings-source.php
File
2992
Delete
Rename
Edit
Download
📄
class-wp-block-editor-context.php
File
1350
Delete
Rename
Edit
Download
📄
class-wp-block-list.php
File
4757
Delete
Rename
Edit
Download
📄
class-wp-block-metadata-registry.php
File
11895
Delete
Rename
Edit
Download
📄
class-wp-block-parser-block.php
File
2555
Delete
Rename
Edit
Download
📄
class-wp-block-parser-frame.php
File
2017
Delete
Rename
Edit
Download
📄
class-wp-block-parser.php
File
11532
Delete
Rename
Edit
Download
📄
class-wp-block-pattern-categories-registry.php
File
5371
Delete
Rename
Edit
Download
📄
class-wp-block-patterns-registry.php
File
10783
Delete
Rename
Edit
Download
📄
class-wp-block-styles-registry.php
File
6403
Delete
Rename
Edit
Download
📄
class-wp-block-supports.php
File
5626
Delete
Rename
Edit
Download
📄
class-wp-block-template.php
File
2033
Delete
Rename
Edit
Download
📄
class-wp-block-templates-registry.php
File
7231
Delete
Rename
Edit
Download
📄
class-wp-block-type-registry.php
File
5013
Delete
Rename
Edit
Download
📄
class-wp-block-type.php
File
17265
Delete
Rename
Edit
Download
📄
class-wp-block.php
File
23041
Delete
Rename
Edit
Download
📄
class-wp-classic-to-block-menu-converter.php
File
4088
Delete
Rename
Edit
Download
📄
class-wp-comment-query.php
File
48395
Delete
Rename
Edit
Download
📄
class-wp-comment.php
File
9437
Delete
Rename
Edit
Download
📄
class-wp-customize-control.php
File
25851
Delete
Rename
Edit
Download
📄
class-wp-customize-manager.php
File
202593
Delete
Rename
Edit
Download
📄
class-wp-customize-nav-menus.php
File
57660
Delete
Rename
Edit
Download
📄
class-wp-customize-panel.php
File
10710
Delete
Rename
Edit
Download
📄
class-wp-customize-section.php
File
11209
Delete
Rename
Edit
Download
📄
class-wp-customize-setting.php
File
29962
Delete
Rename
Edit
Download
📄
class-wp-customize-widgets.php
File
72210
Delete
Rename
Edit
Download
📄
class-wp-date-query.php
File
35732
Delete
Rename
Edit
Download
📄
class-wp-dependencies.php
File
15139
Delete
Rename
Edit
Download
📄
class-wp-dependency.php
File
2627
Delete
Rename
Edit
Download
📄
class-wp-duotone.php
File
40783
Delete
Rename
Edit
Download
📄
class-wp-editor.php
File
72335
Delete
Rename
Edit
Download
📄
class-wp-embed.php
File
15931
Delete
Rename
Edit
Download
📄
class-wp-error.php
File
7502
Delete
Rename
Edit
Download
📄
class-wp-exception.php
File
253
Delete
Rename
Edit
Download
📄
class-wp-fatal-error-handler.php
File
8150
Delete
Rename
Edit
Download
📄
class-wp-feed-cache-transient.php
File
3176
Delete
Rename
Edit
Download
📄
class-wp-feed-cache.php
File
969
Delete
Rename
Edit
Download
📄
class-wp-hook.php
File
16000
Delete
Rename
Edit
Download
📄
class-wp-http-cookie.php
File
7389
Delete
Rename
Edit
Download
📄
class-wp-http-curl.php
File
12541
Delete
Rename
Edit
Download
📄
class-wp-http-encoding.php
File
6689
Delete
Rename
Edit
Download
📄
class-wp-http-ixr-client.php
File
3501
Delete
Rename
Edit
Download
📄
class-wp-http-proxy.php
File
5980
Delete
Rename
Edit
Download
📄
class-wp-http-requests-hooks.php
File
2022
Delete
Rename
Edit
Download
📄
class-wp-http-requests-response.php
File
4400
Delete
Rename
Edit
Download
📄
class-wp-http-response.php
File
2977
Delete
Rename
Edit
Download
📄
class-wp-http-streams.php
File
16859
Delete
Rename
Edit
Download
📄
class-wp-http.php
File
41579
Delete
Rename
Edit
Download
📄
class-wp-image-editor-gd.php
File
20162
Delete
Rename
Edit
Download
📄
class-wp-image-editor-imagick.php
File
34735
Delete
Rename
Edit
Download
📄
class-wp-image-editor.php
File
17527
Delete
Rename
Edit
Download
📄
class-wp-list-util.php
File
7443
Delete
Rename
Edit
Download
📄
class-wp-locale-switcher.php
File
6776
Delete
Rename
Edit
Download
📄
class-wp-locale.php
File
16883
Delete
Rename
Edit
Download
📄
class-wp-matchesmapregex.php
File
1828
Delete
Rename
Edit
Download
📄
class-wp-meta-query.php
File
30531
Delete
Rename
Edit
Download
📄
class-wp-metadata-lazyloader.php
File
6833
Delete
Rename
Edit
Download
📄
class-wp-navigation-fallback.php
File
9211
Delete
Rename
Edit
Download
📄
class-wp-network-query.php
File
19857
Delete
Rename
Edit
Download
📄
class-wp-network.php
File
12296
Delete
Rename
Edit
Download
📄
class-wp-object-cache.php
File
17524
Delete
Rename
Edit
Download
📄
class-wp-oembed-controller.php
File
6905
Delete
Rename
Edit
Download
📄
class-wp-oembed.php
File
31606
Delete
Rename
Edit
Download
📄
class-wp-paused-extensions-storage.php
File
5111
Delete
Rename
Edit
Download
📄
class-wp-phpmailer.php
File
3802
Delete
Rename
Edit
Download
📄
class-wp-plugin-dependencies.php
File
25315
Delete
Rename
Edit
Download
📄
class-wp-post-type.php
File
30680
Delete
Rename
Edit
Download
📄
class-wp-post.php
File
6488
Delete
Rename
Edit
Download
📄
class-wp-query.php
File
158023
Delete
Rename
Edit
Download
📄
class-wp-recovery-mode-cookie-service.php
File
6877
Delete
Rename
Edit
Download
📄
class-wp-recovery-mode-email-service.php
File
11183
Delete
Rename
Edit
Download
📄
class-wp-recovery-mode-key-service.php
File
4884
Delete
Rename
Edit
Download
📄
class-wp-recovery-mode-link-service.php
File
3463
Delete
Rename
Edit
Download
📄
class-wp-recovery-mode.php
File
11453
Delete
Rename
Edit
Download
📄
class-wp-rewrite.php
File
63688
Delete
Rename
Edit
Download
📄
class-wp-role.php
File
2523
Delete
Rename
Edit
Download
📄
class-wp-roles.php
File
8586
Delete
Rename
Edit
Download
📄
class-wp-script-modules.php
File
19463
Delete
Rename
Edit
Download
📄
class-wp-scripts.php
File
28344
Delete
Rename
Edit
Download
📄
class-wp-session-tokens.php
File
7319
Delete
Rename
Edit
Download
📄
class-wp-simplepie-file.php
File
3408
Delete
Rename
Edit
Download
📄
class-wp-simplepie-sanitize-kses.php
File
1910
Delete
Rename
Edit
Download
📄
class-wp-site-query.php
File
31625
Delete
Rename
Edit
Download
📄
class-wp-site.php
File
7454
Delete
Rename
Edit
Download
📄
class-wp-speculation-rules.php
File
7527
Delete
Rename
Edit
Download
📄
class-wp-styles.php
File
11010
Delete
Rename
Edit
Download
📄
class-wp-tax-query.php
File
19555
Delete
Rename
Edit
Download
📄
class-wp-taxonomy.php
File
18559
Delete
Rename
Edit
Download
📄
class-wp-term-query.php
File
40869
Delete
Rename
Edit
Download
📄
class-wp-term.php
File
5298
Delete
Rename
Edit
Download
📄
class-wp-text-diff-renderer-inline.php
File
979
Delete
Rename
Edit
Download
📄
class-wp-text-diff-renderer-table.php
File
18880
Delete
Rename
Edit
Download
📄
class-wp-textdomain-registry.php
File
10481
Delete
Rename
Edit
Download
📄
class-wp-theme-json-data.php
File
1809
Delete
Rename
Edit
Download
📄
class-wp-theme-json-resolver.php
File
35738
Delete
Rename
Edit
Download
📄
class-wp-theme-json-schema.php
File
7367
Delete
Rename
Edit
Download
📄
class-wp-theme-json.php
File
163545
Delete
Rename
Edit
Download
📄
class-wp-theme.php
File
65810
Delete
Rename
Edit
Download
📄
class-wp-token-map.php
File
28618
Delete
Rename
Edit
Download
📄
class-wp-url-pattern-prefixer.php
File
4802
Delete
Rename
Edit
Download
📄
class-wp-user-meta-session-tokens.php
File
2990
Delete
Rename
Edit
Download
📄
class-wp-user-query.php
File
43655
Delete
Rename
Edit
Download
📄
class-wp-user-request.php
File
2305
Delete
Rename
Edit
Download
📄
class-wp-user.php
File
22994
Delete
Rename
Edit
Download
📄
class-wp-walker.php
File
13322
Delete
Rename
Edit
Download
📄
class-wp-widget-factory.php
File
3347
Delete
Rename
Edit
Download
📄
class-wp-widget.php
File
18429
Delete
Rename
Edit
Download
📄
class-wp-xmlrpc-server.php
File
215444
Delete
Rename
Edit
Download
📄
class-wp.php
File
26318
Delete
Rename
Edit
Download
📄
class-wpdb.php
File
118284
Delete
Rename
Edit
Download
📄
class.wp-dependencies.php
File
373
Delete
Rename
Edit
Download
📄
class.wp-scripts.php
File
343
Delete
Rename
Edit
Download
📄
class.wp-styles.php
File
338
Delete
Rename
Edit
Download
📄
comment-template.php
File
103104
Delete
Rename
Edit
Download
📄
comment.php
File
131547
Delete
Rename
Edit
Download
📄
compat.php
File
16376
Delete
Rename
Edit
Download
📄
cron.php
File
42658
Delete
Rename
Edit
Download
📁
css
Folder
-
Delete
Rename
📁
customize
Folder
-
Delete
Rename
📄
date.php
File
400
Delete
Rename
Edit
Download
📄
default-constants.php
File
11365
Delete
Rename
Edit
Download
📄
default-filters.php
File
36697
Delete
Rename
Edit
Download
📄
default-widgets.php
File
2295
Delete
Rename
Edit
Download
📄
deprecated.php
File
191563
Delete
Rename
Edit
Download
📄
embed-template.php
File
338
Delete
Rename
Edit
Download
📄
embed.php
File
38172
Delete
Rename
Edit
Download
📄
error-protection.php
File
4121
Delete
Rename
Edit
Download
📄
feed-atom-comments.php
File
5504
Delete
Rename
Edit
Download
📄
feed-atom.php
File
3121
Delete
Rename
Edit
Download
📄
feed-rdf.php
File
2668
Delete
Rename
Edit
Download
📄
feed-rss.php
File
1189
Delete
Rename
Edit
Download
📄
feed-rss2-comments.php
File
4136
Delete
Rename
Edit
Download
📄
feed-rss2.php
File
3799
Delete
Rename
Edit
Download
📄
feed.php
File
23411
Delete
Rename
Edit
Download
📁
fonts
Folder
-
Delete
Rename
📄
fonts.php
File
9751
Delete
Rename
Edit
Download
📄
formatting.php
File
342921
Delete
Rename
Edit
Download
📄
functions.php
File
287546
Delete
Rename
Edit
Download
📄
functions.wp-scripts.php
File
14558
Delete
Rename
Edit
Download
📄
functions.wp-styles.php
File
8583
Delete
Rename
Edit
Download
📄
general-template.php
File
172498
Delete
Rename
Edit
Download
📄
global-styles-and-settings.php
File
21261
Delete
Rename
Edit
Download
📁
html-api
Folder
-
Delete
Rename
📄
http.php
File
25312
Delete
Rename
Edit
Download
📄
https-detection.php
File
5857
Delete
Rename
Edit
Download
📄
https-migration.php
File
4741
Delete
Rename
Edit
Download
📁
images
Folder
-
Delete
Rename
📁
interactivity-api
Folder
-
Delete
Rename
📁
js
Folder
-
Delete
Rename
📄
kses.php
File
74472
Delete
Rename
Edit
Download
📁
l10n
Folder
-
Delete
Rename
📄
l10n.php
File
68530
Delete
Rename
Edit
Download
📄
link-template.php
File
157801
Delete
Rename
Edit
Download
📄
load.php
File
56440
Delete
Rename
Edit
Download
📄
locale.php
File
162
Delete
Rename
Edit
Download
📄
media-template.php
File
63060
Delete
Rename
Edit
Download
📄
media.php
File
220496
Delete
Rename
Edit
Download
📄
meta.php
File
65243
Delete
Rename
Edit
Download
📄
ms-blogs.php
File
25845
Delete
Rename
Edit
Download
📄
ms-default-constants.php
File
4921
Delete
Rename
Edit
Download
📄
ms-default-filters.php
File
6636
Delete
Rename
Edit
Download
📄
ms-deprecated.php
File
21759
Delete
Rename
Edit
Download
📄
ms-files.php
File
2744
Delete
Rename
Edit
Download
📄
ms-functions.php
File
91582
Delete
Rename
Edit
Download
📄
ms-load.php
File
19883
Delete
Rename
Edit
Download
📄
ms-network.php
File
3782
Delete
Rename
Edit
Download
📄
ms-settings.php
File
4197
Delete
Rename
Edit
Download
📄
ms-site.php
File
41320
Delete
Rename
Edit
Download
📄
nav-menu-template.php
File
25990
Delete
Rename
Edit
Download
📄
nav-menu.php
File
44373
Delete
Rename
Edit
Download
📄
option.php
File
103065
Delete
Rename
Edit
Download
📁
php-compat
Folder
-
Delete
Rename
📄
pluggable-deprecated.php
File
6324
Delete
Rename
Edit
Download
📄
pluggable.php
File
122700
Delete
Rename
Edit
Download
📄
plugin.php
File
35465
Delete
Rename
Edit
Download
📁
pomo
Folder
-
Delete
Rename
📄
post-formats.php
File
7102
Delete
Rename
Edit
Download
📄
post-template.php
File
68648
Delete
Rename
Edit
Download
📄
post-thumbnail-template.php
File
10879
Delete
Rename
Edit
Download
📄
post.php
File
291712
Delete
Rename
Edit
Download
📄
query.php
File
37035
Delete
Rename
Edit
Download
📄
registration-functions.php
File
200
Delete
Rename
Edit
Download
📄
registration.php
File
200
Delete
Rename
Edit
Download
📁
rest-api
Folder
-
Delete
Rename
📄
rest-api.php
File
100257
Delete
Rename
Edit
Download
📄
revision.php
File
30741
Delete
Rename
Edit
Download
📄
rewrite.php
File
19541
Delete
Rename
Edit
Download
📄
robots-template.php
File
5185
Delete
Rename
Edit
Download
📄
rss-functions.php
File
255
Delete
Rename
Edit
Download
📄
rss.php
File
23113
Delete
Rename
Edit
Download
📄
script-loader.php
File
133262
Delete
Rename
Edit
Download
📄
script-modules.php
File
7712
Delete
Rename
Edit
Download
📄
session.php
File
258
Delete
Rename
Edit
Download
📄
shortcodes.php
File
24051
Delete
Rename
Edit
Download
📁
sitemaps
Folder
-
Delete
Rename
📄
sitemaps.php
File
3238
Delete
Rename
Edit
Download
📁
sodium_compat
Folder
-
Delete
Rename
📄
speculative-loading.php
File
8558
Delete
Rename
Edit
Download
📄
spl-autoload-compat.php
File
441
Delete
Rename
Edit
Download
📁
style-engine
Folder
-
Delete
Rename
📄
style-engine.php
File
7563
Delete
Rename
Edit
Download
📄
taxonomy.php
File
176227
Delete
Rename
Edit
Download
📄
template-canvas.php
File
544
Delete
Rename
Edit
Download
📄
template-loader.php
File
3012
Delete
Rename
Edit
Download
📄
template.php
File
24154
Delete
Rename
Edit
Download
📁
theme-compat
Folder
-
Delete
Rename
📄
theme-i18n.json
File
1526
Delete
Rename
Edit
Download
📄
theme-previews.php
File
2832
Delete
Rename
Edit
Download
📄
theme-templates.php
File
6238
Delete
Rename
Edit
Download
📄
theme.json
File
8704
Delete
Rename
Edit
Download
📄
theme.php
File
134303
Delete
Rename
Edit
Download
📄
update.php
File
37503
Delete
Rename
Edit
Download
📄
user.php
File
175823
Delete
Rename
Edit
Download
📄
vars.php
File
6562
Delete
Rename
Edit
Download
📄
version.php
File
1090
Delete
Rename
Edit
Download
📁
widgets
Folder
-
Delete
Rename
📄
widgets.php
File
70719
Delete
Rename
Edit
Download
📄
wp-db.php
File
445
Delete
Rename
Edit
Download
📄
wp-diff.php
File
799
Delete
Rename
Edit
Download
Upload
Create Folder
📝 Editing:
class-wp-tax-query.php
Size: 19,555 bytes
Lines: 660
Type: .php
💾 Save
Cancel
✕
<?php /** * Taxonomy API: WP_Tax_Query class * * @package WordPress * @subpackage Taxonomy * @since 4.4.0 */ /** * Core class used to implement taxonomy queries for the Taxonomy API. * * Used for generating SQL clauses that filter a primary query according to object * taxonomy terms. * * WP_Tax_Query is a helper that allows primary query classes, such as WP_Query, to filter * their results by object metadata, by generating `JOIN` and `WHERE` subclauses to be * attached to the primary SQL query string. * * @since 3.1.0 */ #[AllowDynamicProperties] class WP_Tax_Query { /** * Array of taxonomy queries. * * See WP_Tax_Query::__construct() for information on tax query arguments. * * @since 3.1.0 * @var array */ public $queries = array(); /** * The relation between the queries. Can be one of 'AND' or 'OR'. * * @since 3.1.0 * @var string */ public $relation; /** * Standard response when the query should not return any rows. * * @since 3.2.0 * @var string */ private static $no_results = array( 'join' => array( '' ), 'where' => array( '0 = 1' ), ); /** * A flat list of table aliases used in the JOIN clauses. * * @since 4.1.0 * @var array */ protected $table_aliases = array(); /** * Terms and taxonomies fetched by this query. * * We store this data in a flat array because they are referenced in a * number of places by WP_Query. * * @since 4.1.0 * @var array */ public $queried_terms = array(); /** * Database table that where the metadata's objects are stored (eg $wpdb->users). * * @since 4.1.0 * @var string */ public $primary_table; /** * Column in 'primary_table' that represents the ID of the object. * * @since 4.1.0 * @var string */ public $primary_id_column; /** * Constructor. * * @since 3.1.0 * @since 4.1.0 Added support for `$operator` 'NOT EXISTS' and 'EXISTS' values. * * @param array $tax_query { * Array of taxonomy query clauses. * * @type string $relation Optional. The MySQL keyword used to join * the clauses of the query. Accepts 'AND', or 'OR'. Default 'AND'. * @type array ...$0 { * An array of first-order clause parameters, or another fully-formed tax query. * * @type string $taxonomy Taxonomy being queried. Optional when field=term_taxonomy_id. * @type string|int|array $terms Term or terms to filter by. * @type string $field Field to match $terms against. Accepts 'term_id', 'slug', * 'name', or 'term_taxonomy_id'. Default: 'term_id'. * @type string $operator MySQL operator to be used with $terms in the WHERE clause. * Accepts 'AND', 'IN', 'NOT IN', 'EXISTS', 'NOT EXISTS'. * Default: 'IN'. * @type bool $include_children Optional. Whether to include child terms. * Requires a $taxonomy. Default: true. * } * } */ public function __construct( $tax_query ) { if ( isset( $tax_query['relation'] ) ) { $this->relation = $this->sanitize_relation( $tax_query['relation'] ); } else { $this->relation = 'AND'; } $this->queries = $this->sanitize_query( $tax_query ); } /** * Ensures the 'tax_query' argument passed to the class constructor is well-formed. * * Ensures that each query-level clause has a 'relation' key, and that * each first-order clause contains all the necessary keys from `$defaults`. * * @since 4.1.0 * * @param array $queries Array of queries clauses. * @return array Sanitized array of query clauses. */ public function sanitize_query( $queries ) { $cleaned_query = array(); $defaults = array( 'taxonomy' => '', 'terms' => array(), 'field' => 'term_id', 'operator' => 'IN', 'include_children' => true, ); foreach ( $queries as $key => $query ) { if ( 'relation' === $key ) { $cleaned_query['relation'] = $this->sanitize_relation( $query ); // First-order clause. } elseif ( self::is_first_order_clause( $query ) ) { $cleaned_clause = array_merge( $defaults, $query ); $cleaned_clause['terms'] = (array) $cleaned_clause['terms']; $cleaned_query[] = $cleaned_clause; /* * Keep a copy of the clause in the flate * $queried_terms array, for use in WP_Query. */ if ( ! empty( $cleaned_clause['taxonomy'] ) && 'NOT IN' !== $cleaned_clause['operator'] ) { $taxonomy = $cleaned_clause['taxonomy']; if ( ! isset( $this->queried_terms[ $taxonomy ] ) ) { $this->queried_terms[ $taxonomy ] = array(); } /* * Backward compatibility: Only store the first * 'terms' and 'field' found for a given taxonomy. */ if ( ! empty( $cleaned_clause['terms'] ) && ! isset( $this->queried_terms[ $taxonomy ]['terms'] ) ) { $this->queried_terms[ $taxonomy ]['terms'] = $cleaned_clause['terms']; } if ( ! empty( $cleaned_clause['field'] ) && ! isset( $this->queried_terms[ $taxonomy ]['field'] ) ) { $this->queried_terms[ $taxonomy ]['field'] = $cleaned_clause['field']; } } // Otherwise, it's a nested query, so we recurse. } elseif ( is_array( $query ) ) { $cleaned_subquery = $this->sanitize_query( $query ); if ( ! empty( $cleaned_subquery ) ) { // All queries with children must have a relation. if ( ! isset( $cleaned_subquery['relation'] ) ) { $cleaned_subquery['relation'] = 'AND'; } $cleaned_query[] = $cleaned_subquery; } } } return $cleaned_query; } /** * Sanitizes a 'relation' operator. * * @since 4.1.0 * * @param string $relation Raw relation key from the query argument. * @return string Sanitized relation. Either 'AND' or 'OR'. */ public function sanitize_relation( $relation ) { if ( 'OR' === strtoupper( $relation ) ) { return 'OR'; } else { return 'AND'; } } /** * Determines whether a clause is first-order. * * A "first-order" clause is one that contains any of the first-order * clause keys ('terms', 'taxonomy', 'include_children', 'field', * 'operator'). An empty clause also counts as a first-order clause, * for backward compatibility. Any clause that doesn't meet this is * determined, by process of elimination, to be a higher-order query. * * @since 4.1.0 * * @param array $query Tax query arguments. * @return bool Whether the query clause is a first-order clause. */ protected static function is_first_order_clause( $query ) { return is_array( $query ) && ( empty( $query ) || array_key_exists( 'terms', $query ) || array_key_exists( 'taxonomy', $query ) || array_key_exists( 'include_children', $query ) || array_key_exists( 'field', $query ) || array_key_exists( 'operator', $query ) ); } /** * Generates SQL clauses to be appended to a main query. * * @since 3.1.0 * * @param string $primary_table Database table where the object being filtered is stored (eg wp_users). * @param string $primary_id_column ID column for the filtered object in $primary_table. * @return string[] { * Array containing JOIN and WHERE SQL clauses to append to the main query. * * @type string $join SQL fragment to append to the main JOIN clause. * @type string $where SQL fragment to append to the main WHERE clause. * } */ public function get_sql( $primary_table, $primary_id_column ) { $this->primary_table = $primary_table; $this->primary_id_column = $primary_id_column; return $this->get_sql_clauses(); } /** * Generates SQL clauses to be appended to a main query. * * Called by the public WP_Tax_Query::get_sql(), this method * is abstracted out to maintain parity with the other Query classes. * * @since 4.1.0 * * @return string[] { * Array containing JOIN and WHERE SQL clauses to append to the main query. * * @type string $join SQL fragment to append to the main JOIN clause. * @type string $where SQL fragment to append to the main WHERE clause. * } */ protected function get_sql_clauses() { /* * $queries are passed by reference to get_sql_for_query() for recursion. * To keep $this->queries unaltered, pass a copy. */ $queries = $this->queries; $sql = $this->get_sql_for_query( $queries ); if ( ! empty( $sql['where'] ) ) { $sql['where'] = ' AND ' . $sql['where']; } return $sql; } /** * Generates SQL clauses for a single query array. * * If nested subqueries are found, this method recurses the tree to * produce the properly nested SQL. * * @since 4.1.0 * * @param array $query Query to parse (passed by reference). * @param int $depth Optional. Number of tree levels deep we currently are. * Used to calculate indentation. Default 0. * @return string[] { * Array containing JOIN and WHERE SQL clauses to append to a single query array. * * @type string $join SQL fragment to append to the main JOIN clause. * @type string $where SQL fragment to append to the main WHERE clause. * } */ protected function get_sql_for_query( &$query, $depth = 0 ) { $sql_chunks = array( 'join' => array(), 'where' => array(), ); $sql = array( 'join' => '', 'where' => '', ); $indent = ''; for ( $i = 0; $i < $depth; $i++ ) { $indent .= ' '; } foreach ( $query as $key => &$clause ) { if ( 'relation' === $key ) { $relation = $query['relation']; } elseif ( is_array( $clause ) ) { // This is a first-order clause. if ( $this->is_first_order_clause( $clause ) ) { $clause_sql = $this->get_sql_for_clause( $clause, $query ); $where_count = count( $clause_sql['where'] ); if ( ! $where_count ) { $sql_chunks['where'][] = ''; } elseif ( 1 === $where_count ) { $sql_chunks['where'][] = $clause_sql['where'][0]; } else { $sql_chunks['where'][] = '( ' . implode( ' AND ', $clause_sql['where'] ) . ' )'; } $sql_chunks['join'] = array_merge( $sql_chunks['join'], $clause_sql['join'] ); // This is a subquery, so we recurse. } else { $clause_sql = $this->get_sql_for_query( $clause, $depth + 1 ); $sql_chunks['where'][] = $clause_sql['where']; $sql_chunks['join'][] = $clause_sql['join']; } } } // Filter to remove empties. $sql_chunks['join'] = array_filter( $sql_chunks['join'] ); $sql_chunks['where'] = array_filter( $sql_chunks['where'] ); if ( empty( $relation ) ) { $relation = 'AND'; } // Filter duplicate JOIN clauses and combine into a single string. if ( ! empty( $sql_chunks['join'] ) ) { $sql['join'] = implode( ' ', array_unique( $sql_chunks['join'] ) ); } // Generate a single WHERE clause with proper brackets and indentation. if ( ! empty( $sql_chunks['where'] ) ) { $sql['where'] = '( ' . "\n " . $indent . implode( ' ' . "\n " . $indent . $relation . ' ' . "\n " . $indent, $sql_chunks['where'] ) . "\n" . $indent . ')'; } return $sql; } /** * Generates SQL JOIN and WHERE clauses for a "first-order" query clause. * * @since 4.1.0 * * @global wpdb $wpdb The WordPress database abstraction object. * * @param array $clause Query clause (passed by reference). * @param array $parent_query Parent query array. * @return array { * Array containing JOIN and WHERE SQL clauses to append to a first-order query. * * @type string[] $join Array of SQL fragments to append to the main JOIN clause. * @type string[] $where Array of SQL fragments to append to the main WHERE clause. * } */ public function get_sql_for_clause( &$clause, $parent_query ) { global $wpdb; $sql = array( 'where' => array(), 'join' => array(), ); $join = ''; $where = ''; $this->clean_query( $clause ); if ( is_wp_error( $clause ) ) { return self::$no_results; } $terms = $clause['terms']; $operator = strtoupper( $clause['operator'] ); if ( 'IN' === $operator ) { if ( empty( $terms ) ) { return self::$no_results; } $terms = implode( ',', $terms ); /* * Before creating another table join, see if this clause has a * sibling with an existing join that can be shared. */ $alias = $this->find_compatible_table_alias( $clause, $parent_query ); if ( false === $alias ) { $i = count( $this->table_aliases ); $alias = $i ? 'tt' . $i : $wpdb->term_relationships; // Store the alias as part of a flat array to build future iterators. $this->table_aliases[] = $alias; // Store the alias with this clause, so later siblings can use it. $clause['alias'] = $alias; $join .= " LEFT JOIN $wpdb->term_relationships"; $join .= $i ? " AS $alias" : ''; $join .= " ON ($this->primary_table.$this->primary_id_column = $alias.object_id)"; } $where = "$alias.term_taxonomy_id $operator ($terms)"; } elseif ( 'NOT IN' === $operator ) { if ( empty( $terms ) ) { return $sql; } $terms = implode( ',', $terms ); $where = "$this->primary_table.$this->primary_id_column NOT IN ( SELECT object_id FROM $wpdb->term_relationships WHERE term_taxonomy_id IN ($terms) )"; } elseif ( 'AND' === $operator ) { if ( empty( $terms ) ) { return $sql; } $num_terms = count( $terms ); $terms = implode( ',', $terms ); $where = "( SELECT COUNT(1) FROM $wpdb->term_relationships WHERE term_taxonomy_id IN ($terms) AND object_id = $this->primary_table.$this->primary_id_column ) = $num_terms"; } elseif ( 'NOT EXISTS' === $operator || 'EXISTS' === $operator ) { $where = $wpdb->prepare( "$operator ( SELECT 1 FROM $wpdb->term_relationships INNER JOIN $wpdb->term_taxonomy ON $wpdb->term_taxonomy.term_taxonomy_id = $wpdb->term_relationships.term_taxonomy_id WHERE $wpdb->term_taxonomy.taxonomy = %s AND $wpdb->term_relationships.object_id = $this->primary_table.$this->primary_id_column )", $clause['taxonomy'] ); } $sql['join'][] = $join; $sql['where'][] = $where; return $sql; } /** * Identifies an existing table alias that is compatible with the current query clause. * * We avoid unnecessary table joins by allowing each clause to look for * an existing table alias that is compatible with the query that it * needs to perform. * * An existing alias is compatible if (a) it is a sibling of `$clause` * (ie, it's under the scope of the same relation), and (b) the combination * of operator and relation between the clauses allows for a shared table * join. In the case of WP_Tax_Query, this only applies to 'IN' * clauses that are connected by the relation 'OR'. * * @since 4.1.0 * * @param array $clause Query clause. * @param array $parent_query Parent query of $clause. * @return string|false Table alias if found, otherwise false. */ protected function find_compatible_table_alias( $clause, $parent_query ) { $alias = false; // Confidence check. Only IN queries use the JOIN syntax. if ( ! isset( $clause['operator'] ) || 'IN' !== $clause['operator'] ) { return $alias; } // Since we're only checking IN queries, we're only concerned with OR relations. if ( ! isset( $parent_query['relation'] ) || 'OR' !== $parent_query['relation'] ) { return $alias; } $compatible_operators = array( 'IN' ); foreach ( $parent_query as $sibling ) { if ( ! is_array( $sibling ) || ! $this->is_first_order_clause( $sibling ) ) { continue; } if ( empty( $sibling['alias'] ) || empty( $sibling['operator'] ) ) { continue; } // The sibling must both have compatible operator to share its alias. if ( in_array( strtoupper( $sibling['operator'] ), $compatible_operators, true ) ) { $alias = preg_replace( '/\W/', '_', $sibling['alias'] ); break; } } return $alias; } /** * Validates a single query. * * @since 3.2.0 * * @param array $query The single query. Passed by reference. */ private function clean_query( &$query ) { if ( empty( $query['taxonomy'] ) ) { if ( 'term_taxonomy_id' !== $query['field'] ) { $query = new WP_Error( 'invalid_taxonomy', __( 'Invalid taxonomy.' ) ); return; } // So long as there are shared terms, 'include_children' requires that a taxonomy is set. $query['include_children'] = false; } elseif ( ! taxonomy_exists( $query['taxonomy'] ) ) { $query = new WP_Error( 'invalid_taxonomy', __( 'Invalid taxonomy.' ) ); return; } if ( 'slug' === $query['field'] || 'name' === $query['field'] ) { $query['terms'] = array_unique( (array) $query['terms'] ); } else { $query['terms'] = wp_parse_id_list( $query['terms'] ); } if ( is_taxonomy_hierarchical( $query['taxonomy'] ) && $query['include_children'] ) { $this->transform_query( $query, 'term_id' ); if ( is_wp_error( $query ) ) { return; } $children = array(); foreach ( $query['terms'] as $term ) { $children = array_merge( $children, get_term_children( $term, $query['taxonomy'] ) ); $children[] = $term; } $query['terms'] = $children; } $this->transform_query( $query, 'term_taxonomy_id' ); } /** * Transforms a single query, from one field to another. * * Operates on the `$query` object by reference. In the case of error, * `$query` is converted to a WP_Error object. * * @since 3.2.0 * * @param array $query The single query. Passed by reference. * @param string $resulting_field The resulting field. Accepts 'slug', 'name', 'term_taxonomy_id', * or 'term_id'. Default 'term_id'. */ public function transform_query( &$query, $resulting_field ) { if ( empty( $query['terms'] ) ) { return; } if ( $query['field'] === $resulting_field ) { return; } $resulting_field = sanitize_key( $resulting_field ); // Empty 'terms' always results in a null transformation. $terms = array_filter( $query['terms'] ); if ( empty( $terms ) ) { $query['terms'] = array(); $query['field'] = $resulting_field; return; } $args = array( 'get' => 'all', 'number' => 0, 'taxonomy' => $query['taxonomy'], 'update_term_meta_cache' => false, 'orderby' => 'none', ); // Term query parameter name depends on the 'field' being searched on. switch ( $query['field'] ) { case 'slug': $args['slug'] = $terms; break; case 'name': $args['name'] = $terms; break; case 'term_taxonomy_id': $args['term_taxonomy_id'] = $terms; break; default: $args['include'] = wp_parse_id_list( $terms ); break; } if ( ! is_taxonomy_hierarchical( $query['taxonomy'] ) ) { $args['number'] = count( $terms ); } $term_query = new WP_Term_Query(); $term_list = $term_query->query( $args ); if ( is_wp_error( $term_list ) ) { $query = $term_list; return; } if ( 'AND' === $query['operator'] && count( $term_list ) < count( $query['terms'] ) ) { $query = new WP_Error( 'inexistent_terms', __( 'Inexistent terms.' ) ); return; } $query['terms'] = wp_list_pluck( $term_list, $resulting_field ); $query['field'] = $resulting_field; } }
✅ File saved successfully!