Adds developer hooks and a feature-request link. No changes to saved orders.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3777136,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3777136,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3777136,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3777136,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3777176,"resolution":"1","location":"assets","locale":"","width":665,"height":779},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3777176,"resolution":"2","location":"assets","locale":"","width":665,"height":779},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3777176,"resolution":"3","location":"assets","locale":"","width":665,"height":635}},"screenshots":{"1":"The Arrange screen: a separate order for each category, shown as cards you can drag, move with buttons or the keyboard, with an ordering preview.","2":"Pinned-first mode: a few posts pinned to the top, the rest sorted automatically.","3":"Settings: choose content types, taxonomies and which archives use a saved order."}},"plugin_section":[],"plugin_tags":[22233,16376,289955,4648,168028],"plugin_category":[],"plugin_contributors":[289956],"plugin_business_model":[],"class_list":["post-394749","plugin","type-plugin","status-publish","hentry","plugin_tags-category-order","plugin_tags-custom-post-order","plugin_tags-pin-posts","plugin_tags-post-order","plugin_tags-reorder-posts","plugin_contributors-jundarwinragodos","plugin_committers-jundarwinragodos"],"banners":{"banner":"https:\/\/ps.w.org\/jdr-category-post-order\/assets\/banner-772x250.png?rev=3777136","banner_2x":"https:\/\/ps.w.org\/jdr-category-post-order\/assets\/banner-1544x500.png?rev=3777136","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/jdr-category-post-order\/assets\/icon-128x128.png?rev=3777136","icon_2x":"https:\/\/ps.w.org\/jdr-category-post-order\/assets\/icon-256x256.png?rev=3777136","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/jdr-category-post-order\/assets\/screenshot-1.png?rev=3777176","caption":"The Arrange screen: a separate order for each category, shown as cards you can drag, move with buttons or the keyboard, with an ordering preview."},{"src":"https:\/\/ps.w.org\/jdr-category-post-order\/assets\/screenshot-2.png?rev=3777176","caption":"Pinned-first mode: a few posts pinned to the top, the rest sorted automatically."},{"src":"https:\/\/ps.w.org\/jdr-category-post-order\/assets\/screenshot-3.png?rev=3777176","caption":"Settings: choose content types, taxonomies and which archives use a saved order."}],"raw_content":"\n
This plugin gives editors one focused screen (Tools \u2192 Category Post Order) to:<\/p>\n\n
Each term keeps its own order per content type. The same post can be 2nd in \"Residential\" and 9th in \"Commercial\". The global order is stored separately and never mixed with term orders.<\/p>\n\n
jdcpo<\/code> argument.<\/li>\n- Search results, feeds, REST API responses, admin lists and other secondary queries are never reordered unless they opt in explicitly.<\/li>\n
- When a listing selects several terms, the plugin does not guess. It keeps the normal order unless the developer names the ordering term.<\/li>\n<\/ul>\n\n
No external services, tracking, accounts or page builder required.<\/p>\n\n
Using a saved order<\/h3>\n\n1. Native archives<\/h4>\n\n
Enable them in Settings. The main query of an enabled archive uses the saved order unless:<\/p>\n\n
\n- the request asks for another sort (for example
?orderby=title<\/code>, or a theme's pre_get_posts<\/code> sets orderby<\/code>)<\/li>\n- the archive mixes several content types<\/li>\n
- several terms are selected<\/li>\n<\/ul>\n\n
2. Query Loop block<\/h4>\n\n
Select a Query Loop block and open Curated post order<\/strong> in the block sidebar. Choose Global order<\/strong> or A term's order\u2026<\/strong> and pick the term. The editor preview and the published page use the same order. (Query Loops set to \"Use default query \/ inherit\" follow the archive integration instead.)<\/p>\n\n3. Custom PHP queries<\/h4>\n\n
Pass the jdcpo<\/code> argument to WP_Query<\/code>, or use the helper jdcpo_query_args()<\/code>, which also sets suppress_filters => false<\/code> (required for get_posts()<\/code>).<\/p>\n\nGlobal order of a custom post type:<\/p>\n\n
$q = new WP_Query( jdcpo_query_args( array( 'post_type' => 'project', 'posts_per_page' => 12 ), 'global' ) );\n<\/code><\/pre>\n\nOne term's order (the query still decides which posts appear):<\/p>\n\n
$q = new WP_Query( jdcpo_query_args( array(\n 'post_type' => 'project',\n 'tax_query' => array( array( 'taxonomy' => 'project_category', 'terms' => 12 ) ),\n), array( 'term' => 12 ) ) );\n<\/code><\/pre>\n\nAutomatic: the single selected term's order, or the global order when no term is selected:<\/p>\n\n
$q = new WP_Query( array( 'post_type' => 'project', 'project_category' => 'residential', 'jdcpo' => true ) );\n<\/code><\/pre>\n\nPinned first: nothing extra in code. Pinned-first vs manual is part of the saved order, so the same query follows whichever mode the editor chose.<\/p>\n\n
Multi-term listing with a chosen ordering term, and a fallback to the global order when that term has no saved order:<\/p>\n\n
'jdcpo' => array( 'term' => 'residential', 'taxonomy' => 'project_category', 'fallback' => 'global' )\n<\/code><\/pre>\n\nAccepted values: true<\/code> \/ 'auto'<\/code>, 'global'<\/code>, 'term:123'<\/code>, or an array with term<\/code> (ID or slug), taxonomy<\/code> (required for slugs), post_type<\/code>, fallback<\/code> ('global'<\/code> or 'none'<\/code>).<\/p>\n\n4. AJAX \"load more\"<\/h4>\n\n
Use the same arguments on every page request. Pagination stays correct because only the ORDER BY changes.<\/p>\n\n
add_action( 'wp_ajax_nopriv_projects_more', 'mytheme_projects_more' );\nadd_action( 'wp_ajax_projects_more', 'mytheme_projects_more' );\nfunction mytheme_projects_more() {\n $page = max( 1, absint( $_POST['page'] ?? 1 ) );\n $term = absint( $_POST['term'] ?? 0 );\n $query = new WP_Query( jdcpo_query_args( array(\n 'post_type' => 'project',\n 'post_status' => 'publish', \/\/ admin-ajax runs as \"admin\": always set the status.\n 'posts_per_page' => 9,\n 'paged' => $page,\n 'tax_query' => $term ? array( array( 'taxonomy' => 'project_category', 'terms' => $term ) ) : array(),\n ), $term ? array( 'term' => $term ) : 'global' ) );\n ob_start();\n while ( $query->have_posts() ) { $query->the_post(); get_template_part( 'parts\/project-card' ); }\n wp_reset_postdata();\n wp_send_json_success( array( 'html' => ob_get_clean(), 'more' => $page < $query->max_num_pages ) );\n}\n<\/code><\/pre>\n\nImportant: requests to admin-ajax.php<\/code> run with is_admin() === true<\/code>, where WordPress includes drafts in queries without an explicit status. Always set post_status => 'publish'<\/code> in public AJAX handlers. That is standard WordPress practice, not something this plugin changes.<\/p>\n\nDebugging<\/h4>\n\n\n- Check integration<\/strong> (on the Arrange screen) lists what is configured for the selected scope and common reasons an order may not apply.<\/li>\n
- While logged in as an Editor or Administrator, open any listing on your site. The Post order<\/strong> toolbar menu reports each relevant query on that page and why it did or did not use a curated order, for example \"This listing sorts by title and has not opted into curated ordering.\"<\/li>\n
- In code:
jdcpo_explain_query( $query )<\/code> returns the same plain-language reason.<\/li>\n<\/ul>\n\nHooks for developers<\/h4>\n\n\njdcpo_loaded<\/code> (action): fires after the plugin has loaded. Add-ons hook in here.<\/li>\njdcpo_order_config<\/code> (filter): ( array $config, Scope $scope, WP_Query $query )<\/code>. Adjust pins or positions for one query just before ORDER BY is built. It cannot change which posts are returned.<\/li>\njdcpo_order_saved<\/code> (action): ( Scope $scope, array $config )<\/code>. Fires after an order is saved or undone on the Arrange screen.<\/li>\njdcpo_available_post_types<\/code> (filter): ( WP_Post_Type[] $types )<\/code>. The content types that can be enabled in Settings.<\/li>\njdcpo_scope_capability<\/code> (filter): ( string $cap, Scope $scope )<\/code>. Who can arrange a scope.<\/li>\n<\/ul>\n\nKnown limitations<\/h3>\n\n\n- One order per term per content type: up to 5,000 arranged and 200 pinned posts per scope. The admin screen loads 50 cards at a time and can load up to 2,000 for \"Move to bottom\". Positions beyond the loaded range keep their saved order.<\/li>\n
- Ordering is applied with a CASE expression on post IDs. That is fast for typical collections (hundreds to a few thousand arranged posts). Very large catalogues have not been benchmarked.<\/li>\n
- Listings that mix several content types, or several terms without a named ordering term, keep their normal order by design.<\/li>\n
- WordPress sticky posts are ignored on a curated blog index (pins replace them).<\/li>\n
get_posts()<\/code> skips query filters by default. Pass suppress_filters => false<\/code>, or use jdcpo_query_args()<\/code>.<\/li>\n- Page caches may serve an older copy of a listing after you save. Clear your cache.<\/li>\n
- Theme template files that contain a Query Loop are not scanned by \"Where this applies\"; only content saved in the database is.<\/li>\n
- Multilingual plugins (WPML, Polylang), WooCommerce product sorting and third-party page builders (Elementor, Divi, etc.) need separate compatibility verification. Translated terms are separate terms, so each language's term has its own order. Builder widgets that run their own queries need the
jdcpo<\/code> argument.<\/li>\n<\/ul>\n\n\n\n- Upload the
jdr-category-post-order<\/code> folder to \/wp-content\/plugins\/<\/code> or install the ZIP via Plugins \u2192 Add New \u2192 Upload Plugin.<\/li>\n- Activate JDR Category Post Order & Pinned Posts<\/strong>.<\/li>\n
- Go to Tools \u2192 Category Post Order \u2192 Settings<\/strong> (administrators):\n\n
\n- Tick the content types to arrange, and for each one the taxonomies that should have per-term orders. Posts + Categories are enabled by default.<\/li>\n
- Optionally turn on native archives<\/strong>: the blog\/post-type archive uses the global order; selected taxonomy archives use the term's order.<\/li>\n
- Choose what a term archive does when the term has no saved order: keep the theme order (default) or use the global order.<\/li>\n<\/ul><\/li>\n
- Go to Tools \u2192 Category Post Order \u2192 Arrange<\/strong>, choose a content type and a term, arrange or pin, and click Save order<\/strong>.<\/li>\n<\/ol>\n\n
Who can arrange: users who can edit others' posts of that content type (Editors and Administrators by default). Change it with the jdcpo_scope_capability<\/code> filter. Only Administrators see Settings.<\/p>\n\n\n\n