{"id":22293483,"url":"https://github.com/evanherman/simple-taxonomy-ordering","last_synced_at":"2026-03-08T16:01:38.831Z","repository":{"id":4936119,"uuid":"47847260","full_name":"EvanHerman/simple-taxonomy-ordering","owner":"EvanHerman","description":"Drag and drop order support for taxonomies, using the new termmeta table.","archived":false,"fork":false,"pushed_at":"2023-02-04T13:40:55.000Z","size":986,"stargazers_count":13,"open_issues_count":4,"forks_count":4,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-07-29T00:44:12.657Z","etag":null,"topics":["hacktoberfest","taxonomy-terms","wordpress-plugin"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EvanHerman.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.txt","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null}},"created_at":"2015-12-11T19:40:07.000Z","updated_at":"2024-08-23T12:51:31.000Z","dependencies_parsed_at":"2023-02-18T16:45:24.468Z","dependency_job_id":null,"html_url":"https://github.com/EvanHerman/simple-taxonomy-ordering","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/EvanHerman/simple-taxonomy-ordering","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EvanHerman%2Fsimple-taxonomy-ordering","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EvanHerman%2Fsimple-taxonomy-ordering/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EvanHerman%2Fsimple-taxonomy-ordering/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EvanHerman%2Fsimple-taxonomy-ordering/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EvanHerman","download_url":"https://codeload.github.com/EvanHerman/simple-taxonomy-ordering/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EvanHerman%2Fsimple-taxonomy-ordering/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30263672,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-08T14:54:00.943Z","status":"ssl_error","status_checked_at":"2026-03-08T14:53:54.486Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","taxonomy-terms","wordpress-plugin"],"created_at":"2024-12-03T17:29:20.050Z","updated_at":"2026-03-08T16:01:38.812Z","avatar_url":"https://github.com/EvanHerman.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eSimple Taxonomy Ordering\n\t\u003ca href=\"https://github.com/EvanHerman/simple-taxonomy-ordering/releases/latest/\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/static/v1?pluginVersion=\u0026message=v2.3.4\u0026label=\u0026color=999\u0026style=flat-square\"\u003e\n\t\u003c/a\u003e\n\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003eQuickly and easily reorder taxonomy terms with an easy to use and intuitive drag and drop interface.\u003c/h4\u003e\n\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://github.com/EvanHerman/simple-taxonomy-ordering/actions/workflows/phpunit.yml?query=branch%3Amaster\" target=\"_blank\"\u003e\n\t\t\u003cimg src=\"https://github.com/EvanHerman/simple-taxonomy-ordering/actions/workflows/phpunit.yml/badge.svg?branch=master\"\u003e\n\t\u003c/a\u003e\n\t\u003ca href=\"https://github.com/EvanHerman/simple-taxonomy-ordering/actions/workflows/wpcs.yml?query=branch%3Amaster\" target=\"_blank\"\u003e\n\t\t\u003cimg src=\"https://github.com/EvanHerman/simple-taxonomy-ordering/actions/workflows/wpcs.yml/badge.svg?branch=master\"\u003e\n\t\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://codeclimate.com/github/EvanHerman/simple-taxonomy-ordering/maintainability\"\u003e\n\t\t\u003cimg src=\"https://api.codeclimate.com/v1/badges/82ec3b9e928a60ba91d2/maintainability\" /\u003e\n\t\u003c/a\u003e\n\t\u003ca href=\"https://codeclimate.com/github/EvanHerman/simple-taxonomy-ordering/test_coverage\"\u003e\n\t\t\u003cimg src=\"https://api.codeclimate.com/v1/badges/82ec3b9e928a60ba91d2/test_coverage\" /\u003e\n\t\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://wordpress.org/\" target=\"_blank\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/static/v1?label=\u0026message=4.4+-+6.0\u0026color=blue\u0026style=flat-square\u0026logo=wordpress\u0026logoColor=white\" alt=\"WordPress Versions\"\u003e\n\t\u003c/a\u003e\n\t\u003ca href=\"https://www.php.net/\" target=\"_blank\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/static/v1?label=\u0026message=5.6+-+8.0\u0026color=777bb4\u0026style=flat-square\u0026logo=php\u0026logoColor=white\" alt=\"PHP Versions\"\u003e\n\t\u003c/a\u003e\n\u003c/p\u003e\n\nInstallation\n===========\n1. Install and activate the plugin\n2. If you need to enable term sorting on default WordPress taxonomies, please see below.\n3. If you would like to enable taxonomy term sorting on custom post type taxonomies, please see below.\n4. Once enabled, you can drag \u0026 drop re-order your taxonomy terms. Whenever '[get_terms()](https://developer.wordpress.org/reference/functions/get_terms/)' is used to display your terms, they will display in the order you've set.\n\nUsage\n===========\n\n#### Default WordPress Taxonomies\nAfter installing and activating the plugin, you have two options. You can enable drag \u0026 drop on any of the default taxonomies. To enable drag \u0026 drop sorting on default WordPress taxonomies, you'll want to assign the `tax_position` parameter to the register_post_type call.\n\nThe easiest way to do so, is to use the following [snippet](https://gist.github.com/EvanHerman/4e83fda88d2b210dce95).\n\n```php\n/*\n* Enable drag \u0026 drop sorting on default WordPress taxonomies (ie: categories) - (page/post)\n*/\nadd_filter( 'register_taxonomy_args' , 'add_tax_position_support', PHP_INT_MAX, 3 );\nfunction add_tax_position_support( $args, $taxonomy, $object_type ) {\n\tif( 'category' == $taxonomy ) { // Change the name of the taxonomy you want to enable drag\u0026drop sort on\n\t\t$args['tax_position'] = true;\n\t}\n\treturn $args;\n}\n```\n\n#### Custom Taxonomies\nAlternatively, if you've defined a custom taxonomy that you'd like to allow drag \u0026 drop sorting on, you'll want to pass in a `tax_position` parameter to the `$args` array inside of [register_taxonomy](https://codex.wordpress.org/Function_Reference/register_taxonomy). You can place this line directly after `'hierarchical'`.\n\n[Example Snippet](https://gist.github.com/EvanHerman/170e2a46db4cecdeb607)\n\n`'tax_position' =\u003e true,`\n\n\n#### Front End\nOn the front end of the site, anywhere [get_terms()](https://developer.wordpress.org/reference/functions/get_terms/) is used to query a set of taxonomy terms, they will be returned in the order of their position on the taxonomy list. No additional steps need to be taken on on your end.\n\nExample\n=========\n![Admin Taxonomy Sorting Usage](https://cldup.com/bFZrQxtCPT.gif)\n\n\nFrequently Asked Questions\n===========\n\n### Can I make default WordPress taxonomies drag and drop sortable?\n\nIndeed, you can! You'll have to assign the `'tax_position'` parameter to the taxonomy. You can do this easily, using the following [sample code snippet](https://gist.github.com/EvanHerman/4e83fda88d2b210dce95).\n\n**You'll notice in the code snippet, the taxonomy we are using is 'category' - but you can change this value to suit your needs.**\n\n### I have a custom post type, but it won't let me drag and drop sort it's taxonomies. How come?\n\nAs mentioned above, the taxonomies need to have the parameter\t`'tax_position' =\u003e true` assigned to it. If the taxonomy is missing this parameter the items won't actually be sortable. For an example of how to implement it, please see the following [code snippet](https://gist.github.com/EvanHerman/170e2a46db4cecdeb607).\n\n### How does the taxonomy know what order to remain in?\n\nWith the release of WordPress 4.4 came taxonomy meta data, which gets stored inside of the `wp_termmeta` table in the database. Each taxonomy is assigned an integer value related to it's position on the taxonomy list.\n\nFilters\n===========\n* `yikes_simple_taxonomy_ordering_capabilities` - Filter to adjust who can access the 'Simple Taxonomy Ordering' settings page.\n* `yikes_simple_taxonomy_ordering_excluded_taxonomies` - Filter to add additional taxonomies or remove default taxonomies. Items in this array will **not** be displayed in the dropdown on the settings page, and thus cannot have drag and drop sorting enabled.\n\nIssues\n===========\nIf you're running into any issues, we would love to hear about it. Please head over to the [Simple Taxonomy Ordering Issue Tracker](https://wordpress.org/support/plugin/simple-taxonomy-ordering/) and create a new issue.\n\n_________________\n\n\u003cdiv align=\"center\" style=\"font-weight: bold;\"\u003eOriginally built with \u003cspan style=\"color: #F3A4B2;\"\u003e\u0026hearts;\u003c/span\u003e by YIKES Inc. in Philadelphia, PA.\u003cbr /\u003eNow Maintained by Evan Herman in Lancaster, PA.\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevanherman%2Fsimple-taxonomy-ordering","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevanherman%2Fsimple-taxonomy-ordering","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevanherman%2Fsimple-taxonomy-ordering/lists"}