{"pageProps":{"title":"get_terms_orderby","titleType":"Hook","type":"hooks","content":"<article><h1>get_terms_orderby <span>WordPress Filter Hook</span></h1><p class=\"main-description\">The get_terms_orderby hook allows you to modify the order in which terms are returned by the get_terms function. The most common use for this hook is to alphabetize terms, but it can also be used to order terms by popularity or by the number of posts in a given term.</p><h2><span class=\"hook-func\">apply_filters</span>( 'get_terms_orderby',  <nobr><span class=\"arg-type\">string</span> <span class=\"arg-name\">$orderby</span></nobr>,  <nobr><span class=\"arg-type\">array</span> <span class=\"arg-name\">$args</span></nobr>,  <nobr><span class=\"arg-type\">string[]</span> <span class=\"arg-name\">$taxonomies</span></nobr> ) <a id=\"block-level-html-elements-by-default\" href=\"#get_terms_orderby\">#</a></h2><section class=\"summary\"><p>Filters the ORDERBY clause of the terms query.</p></section><div class=\"content-toc\"><div class=\"table-of-contents\"><h2>Contents</h2><ul class=\"items\"><li><a href=\"#parameters\">Parameters</a></li><li><a href=\"#source\">Source</a></li><li><a href=\"#related\">Related</a><ul><li><a href=\"#used-by\">Used By</a></ul></li><li><a href=\"#changelog\">Changelog</a></li></ul></div><hr /><section class=\"parameters\"><h2 id=\"parameters\" class=\"toc-heading\" tabindex=\"-1\" ><a href=\"#parameters\" class=\"dashicons-before dashicons-admin-links\">Parameters</a></h2><dl><dt>$orderby</dt><dd><p class=\"desc\"><span class=\"type\">(<span class=\"string\">string</span>)</span><span class=\"description\"><code>ORDERBY</code> clause of the terms query.</span></p></dd><dt>$args</dt><dd><p class=\"desc\"><span class=\"type\">(<span class=\"array\">array</span>)</span><span class=\"description\">An array of term query arguments.</span></p></dd><dt>$taxonomies</dt><dd><p class=\"desc\"><span class=\"type\">(<span class=\"string[]\">string[]</span>)</span><span class=\"description\">An array of taxonomy names.</span></p></dd></dl></section><hr /><section class=\"source-content\"><p class=\"toc-jump\"><a href=\"#top\">Top &uarr;</a></p><h2 id=\"source\" class=\"toc-heading\" tabindex=\"-1\" ><a href=\"#source\" class=\"dashicons-before dashicons-admin-links\">Source</a></h2><p>File: <a href=\"/reference/files/wp-includes/class-wp-term-query.php\">wp-includes/class-wp-term-query.php</a></p><p><a href=\"https://core.trac.wordpress.org/browser/tags/6.0/src/wp-includes/class-wp-term-query.php#L943\">View on Trac</a></p></section><hr /><section class=\"related\"><p class=\"toc-jump\"><a href=\"#top\">Top &uarr;</a></p><h2 id=\"related\" class=\"toc-heading\" tabindex=\"-1\" ><a href=\"#related\" class=\"dashicons-before dashicons-admin-links\">Related</a></h2><article class=\"used-by\"><p class=\"toc-jump\"><a href=\"#top\">Top &uarr;</a></p><h3 id=\"used-by\" class=\"toc-heading\" tabindex=\"-1\" ><a href=\"#used-by\" class=\"dashicons-before dashicons-admin-links\">Used By</a></h3><table id=\"used-by-table\"><caption class=\"screen-reader-text\">Used By</caption><thead><tr><th>Used By</th><th class=\"related-desc\">Description</th></tr></thead><tbody><tr><td><span>wp-includes/class-wp-term-query.php:</span><a href=\"/reference/classes/wp_term_query/parse_orderby\">WP_Term_Query::parse_orderby()</a></td><td class=\"related-desc\"><p>Parse and sanitize &#8216;orderby&#8217; keys passed to the term query.</p></td></tr><tbody></table></article></section><hr /><section class=\"changelog\"><p class=\"toc-jump\"><a href=\"#top\">Top &uarr;</a></p><h2 id=\"changelog\" class=\"toc-heading\" tabindex=\"-1\" ><a href=\"#changelog\" class=\"dashicons-before dashicons-admin-links\">Changelog</a></h2><table><caption class=\"screen-reader-text\">Changelog</caption><thead><tr><th class=\"changelog-version\">Version</th><th class=\"changelog-desc\">Description</th></tr></thead><tbody><tr><td><a href=\"/reference/since/2.8.0\" alt=\"WordPress 2.8.0\">2.8.0</a></td><td>Introduced.</td></tr></tbody></table></section></div></article>","description":"Filters the ORDERBY clause of the terms query.","sidebarFiles":{"Class":[{"componentTitle":"WP_Term_Query","componentLink":"/reference/classes/wp_term_query","private":"","deprecated":""}],"Class Method":[{"componentTitle":"WP_Term_Query::__construct()","componentLink":"/reference/classes/wp_term_query/__construct","private":"","deprecated":""},{"componentTitle":"WP_Term_Query::format_terms()","componentLink":"/reference/classes/wp_term_query/format_terms","private":"","deprecated":""},{"componentTitle":"WP_Term_Query::get_search_sql()","componentLink":"/reference/classes/wp_term_query/get_search_sql","private":"","deprecated":""},{"componentTitle":"WP_Term_Query::get_terms()","componentLink":"/reference/classes/wp_term_query/get_terms","private":"","deprecated":""},{"componentTitle":"WP_Term_Query::parse_order()","componentLink":"/reference/classes/wp_term_query/parse_order","private":"","deprecated":""},{"componentTitle":"WP_Term_Query::parse_orderby_meta()","componentLink":"/reference/classes/wp_term_query/parse_orderby_meta","private":"","deprecated":""},{"componentTitle":"WP_Term_Query::parse_orderby()","componentLink":"/reference/classes/wp_term_query/parse_orderby","private":"","deprecated":""},{"componentTitle":"WP_Term_Query::parse_query()","componentLink":"/reference/classes/wp_term_query/parse_query","private":"","deprecated":""},{"componentTitle":"WP_Term_Query::populate_terms()","componentLink":"/reference/classes/wp_term_query/populate_terms","private":"","deprecated":""},{"componentTitle":"WP_Term_Query::query()","componentLink":"/reference/classes/wp_term_query/query","private":"","deprecated":""}],"Hook":[{"componentTitle":"get_terms_args","componentLink":"/reference/hooks/get_terms_args","private":"","deprecated":""},{"componentTitle":"get_terms_defaults","componentLink":"/reference/hooks/get_terms_defaults","private":"","deprecated":""},{"componentTitle":"get_terms_fields","componentLink":"/reference/hooks/get_terms_fields","private":"","deprecated":""},{"componentTitle":"get_terms_orderby","componentLink":"/reference/hooks/get_terms_orderby","private":"","deprecated":"","active":"active"},{"componentTitle":"list_terms_exclusions","componentLink":"/reference/hooks/list_terms_exclusions","private":"","deprecated":""},{"componentTitle":"parse_term_query","componentLink":"/reference/hooks/parse_term_query","private":"","deprecated":""},{"componentTitle":"pre_get_terms","componentLink":"/reference/hooks/pre_get_terms","private":"","deprecated":""},{"componentTitle":"terms_clauses","componentLink":"/reference/hooks/terms_clauses","private":"","deprecated":""},{"componentTitle":"terms_pre_query","componentLink":"/reference/hooks/terms_pre_query","private":"","deprecated":""}]}},"__N_SSG":true}