=== TaxoSelect - Taxonomy Template Selector ===
Contributors: runthingsdev
Tags: category, template, taxonomy, custom template, archive
Requires at least: 6.4
Requires PHP: 7.4
Tested up to: 6.9
Stable tag: 1.3.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Assign archive templates to categories, tags and other taxonomy terms.

== Description ==

Assign custom archive templates to categories, tags and other taxonomy terms, similar to how WordPress page templates work.

Template selection is automatically enabled for all public taxonomies. Edit any term to choose a custom archive template.

= Features: =

* Zero configuration - works out of the box for all public taxonomies
* Choose templates per-term from the term edit screen
* Works with categories, tags, and custom taxonomies
* Bulk edit support - assign templates to multiple terms at once
* Quick edit support - change templates inline without leaving the list table
* Optional admin column shows assigned template at a glance (hidden by default)
* Backwards compatible with legacy "Category Template:" headers

= Links: =

* [Plugin page](https://runthings.dev/wordpress-plugins/taxonomy-template-selector/)
* [GitHub repository](https://github.com/runthings-dev/runthings-taxonomy-template-selector)

== Installation ==

1. Upload the plugin to your `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Create template files in your theme with the header comment `Taxonomy Template: Your Template Name`
4. Edit a category/term and select your template from the dropdown

== Frequently Asked Questions ==

= How do I create a custom template? =

Add a PHP file to your theme directory with this header comment:

`<?php
/**
 * Taxonomy Template: My Custom Template
 */`

= Which taxonomies are supported? =

All public taxonomies including categories, tags, custom taxonomies from plugins like WooCommerce product categories, and any custom post type taxonomies.

= I'm using "Category Template:" in my theme files. Do I need to change it? =

No. The plugin supports both `Taxonomy Template:` (recommended) and `Category Template:` (legacy) headers for backwards compatibility. Your existing templates will continue to work.

= Can I prevent data deletion when uninstalling? =

Yes. Add this to your wp-config.php before uninstalling:

`define( 'RUNTHINGS_TAXONOMY_TEMPLATE_SELECTOR_KEEP_DATA', true );`

= Why don't I see the template dropdown? =

Make sure your theme has at least one PHP file with either a `Taxonomy Template:` or `Category Template:` header comment. The dropdown only appears if templates are available to select.

= Can I add custom directories for template scanning? =

Yes. Use the `runthings_taxonomy_template_selector_dirs` filter to add additional directories. Note that subdirectories are not scanned automatically - you must add each folder path explicitly.

`add_filter( 'runthings_taxonomy_template_selector_dirs', function( $dirs ) {
    $dirs[] = get_stylesheet_directory() . '/taxonomy-templates';
    return $dirs;
} );`

= Can I add or remove templates without modifying theme files? =

Yes. Use the `runthings_taxonomy_template_selector_list` filter to modify the available templates. The filename is a path relative to your theme root - if using a child theme, it checks the child theme first, then falls back to the parent theme.

`add_filter( 'runthings_taxonomy_template_selector_list', function( $templates ) {
    // Add a template from theme root
    $templates['My Custom Archive'] = 'custom-archive.php';
    // Add a template from a subdirectory
    $templates['Product Archive'] = 'template-parts/archive-product.php';
    // Remove one you don't want
    unset( $templates['Unwanted Template'] );
    return $templates;
} );`

= How do I upgrade from Advanced Category Template? =

This plugin is a fork of the original "Advanced Category Template" plugin by Praveen Goswami. It was adopted because the original plugin was removed from the WordPress.org plugin directory due to security issues.

Your existing template mappings will be migrated automatically when you activate this plugin. You can safely deactivate and delete the old plugin in any order.

== Screenshots ==

1. Template selection dropdown on the term edit screen.

== Changelog ==

= 1.3.3 - 14th January 2026 =
* Revert readme.md exclusion - it was a false positive / bug in plugin check plugin
* First release on WordPress.org

= 1.3.2 - 14th January 2026 =
* Exclude readme.md from plugin distribution zip file

= 1.3.1 - 14th January 2026 =
* Renamed display name to 'TaxoSelect - Taxonomy Template Selector' for WP.org submission compliance

= 1.3.0 - 3rd January 2026 =
* Added quick edit support for changing templates inline
* Fixed form field spacing on add term page

= 1.2.0 - 3rd January 2026 =
* Added optional Template column to taxonomy list tables (hidden by default, enable via Screen Options)
* Added bulk action to assign templates to multiple terms at once

= 1.1.0 - 2nd January 2026 =
* Renamed to runthings-taxonomy-template-selector for WP.org submission compliance
* Moved assets into .wordpress-org folder
* Renamed option key to use consistent prefix (auto-migrates from 1.0.0)

= 1.0.0 - 16th December 2025 =
* Forked from Advanced Category Template by Praveen Goswami
* Added namespace and modern PHP structure
* Fixed security issues found in original plugin
* Added proper sanitization and escaping
* Renamed to runthings-taxonomy-template
* Auto-enabled for all public taxonomies (no settings page needed)
* Added support for "Taxonomy Template:" header (with backwards compatibility for "Category Template:")

== Upgrade Notice ==

= 1.3.3 =
Revert readme.md exclusion - it was a false positive / bug in plugin check plugin.

= 1.3.2 =
Exclude readme.md from plugin distribution zip file.

= 1.3.1 =
Renamed display name to 'TaxoSelect - Taxonomy Template Selector' for WP.org submission compliance

== License ==

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, see [https://www.gnu.org/licenses/gpl-2.0.html](https://www.gnu.org/licenses/gpl-2.0.html).