March 18, 2023

Radio Buttons for Taxonomies Plugin

Replace the default taxonomy boxes with a custom metabox that uses radio buttons... effectively limiting each post to a single term in that taxonomy.

Replace the default taxonomy boxes with a custom metabox that uses radio buttons… effectively limiting each post to a single term in that taxonomy.

A plugin options page allows the user can select which taxonomies she’d like to switch to using the custom radio-button style metabox.

Originally based on the the class by Stephen Harris

Support

Support is handled in the WordPress forums. Please note that support is limited and does not cover any custom implementation of the plugin. Before posting a question, read the FAQ and confirm that the problem still exists with a default theme and with all other plugins disabled.

Please report any bugs, errors, warnings, code problems to Github

Installation

Upload the plugin folder to the /wp-content/plugins/ directory
Activate the plugin through the ‘Plugins’ menu in WordPress
Go to Settings > Radio Buttons for Taxonomies and use the checkboxes to indicate which taxonomies you’d like to use radio buttons

Screenshots

The settings page where you determine which taxonomies will get radio buttons.
This is what the metabox will look like on the post editor screen.

FAQ

Why do the metaboxes have a “No {$taxonomy}” ( ex: No Genre ) radio button!?

This was a feature added in version 1.4, but due to some faulty logic on my part probably wasn’t showing it everywhere that I intended.

It has come to my attention that not everybody likes this feature, so I have enabled an easy way to disable it for taxonomies that you wish to make mandatory. Simply add the following to your theme’s functions.php or your site’s custom functions plugin.

add_filter( "radio_buttons_for_taxonomies_no_term_{$taxonomy}", "__return_FALSE" );

So for example, to disabled the “No term” option on a taxonomy called “genre” you’d do the following:

add_filter( 'radio_buttons_for_taxonomies_no_term_genre', '__return_FALSE' );

Changelog

2023.03.18 – Version 2.4.7

Manual update to ensure SVN version is the same as GitHub version.

2023.02.15 – Version 2.4.6

Fix: Typo from 2.4.5 patch. Closes #111.

2023.02.13 – Version 2.4.5

Fix: Reload non-hierarchical terms as forced-hierarchical after quick edit save. Closes #109.

2022.06.28 – Version 2.4.4

Fix: Bulk edit removes terms (set to default) when not editing the term. Closes #105.

2022.06.15 – Version 2.4.3

Fix: Fatal error when deleting plugin. uninstall callback must be static. Closes #104.

2022.01.06 – Version 2.4.2

Fix: Conflict with default term, multiple checked terms (term plus default term). Closes #103.

2021.12.27 – Version 2.4.1

Fix: Fatal error from compatibility module includes.

2021.12.27 – Version 2.4.0

Update: Drop support for WordPress < 4.4
New: Compatibility with WP SEO’s primary term (disable for Radio terms)
New: Save default term if it exists and no term is selected.
Fix: Default term is checked by default.
Fix: “No term” is not displayed when taxonomy has a default term option.
Fix: Missing translations in block editor. Props @ocean90.

2.3.1

Fix: Optimize compatibility for Tabify Edit Screen. Props @remcokalf.

Removed ‘tabify_add_meta_boxes’ action, as it is doubled by do_action( ‘add_meta_boxes’)in settings-posttype.php of Tabify Edit Screen.

2.3.0

New: Optimize to load taxonomy class hooks/callbacks only on radio-enabled taxonomies. Props @remcokalf.
New: Compatibility for Tabify Edit Screen

2.2.3

Fix: Add term for non-hierarchical custom taxonomy in custom post type

2.2.2

Fix: Add term for custom taxonomy in custom post type
Fix: remove jQuery 3 deprecated handlers
Fix: Don’t load the metabox script in the block editor

2.2.1

Fix: Define schema for new REST field added in 2.2.0

2.2.0

New: Conditionally show a “no term” radio button in Gutenberg sidebar. props @tomjn!

2.1.1

Fix: Missing NONCE preventing bulk/quick edit from saving correctly.
Fix: Use in Gutenberg sidebar instead of

2.1.0

Fix: Refactor sidebar script to remove unneeded higher order components. Props @torounit!
Fix: Add core class to radio buttons in sidebar. Props @torounit!

2.0.8

Fix: Missing index.asset.php file.

2.0.7

Fix: “No {$term}” not translatable.

2.0.6

Fix: Vulnerable nonce in save routine.

2.0.5

Fix: Admin settings- Get all taxonomies with show_ui=true.

2.0.4

Fix: Settings link on plugin page.

2.0.3

Fix: Stop breaking quick edit on Taxonomy pages.

2.0.2

Update from Gutenberg source

2.0.1

Fix: Fatal error use_block_editor_for_post_type() undefined in WP 4.x

2.0.0

Gutenberg compatibility! Props @5ally and @leymannx

1.8.3

Escape all the inputs. Props @tomjn and @rtCamp

1.8.2

Friendlier error messages

1.8.1

Fix: fatal error for undefined boolval in PHP < 5.5

1.8.0

Compatibility with WordPress 4.9.2
Update donation link
Add radio_buttons_for_taxonomies_no_term_selected_text filter to allow for custom “No Genre” texts. props @hokoo
Convert switch_terms_filter() to get and setter
Rename radio-buttons-for-taxonomies-no-term-$taxonomy filter to radio_buttons_for_taxonomies_no_term_$taxonomy to disable the “No term” feature

1.7.8

Compatibility with WordPress 4.8.3
Update donation link

1.7.7

Compatibility with WordPress 4.4

1.7.6

Validate options against get_all_taxonomies() which allows for private taxonomies to be saved in options if they’ve been added via filter

1.7.5

Add Dutch translation. props @maarten00
Add Persian translation. props @Ghaem

1.7.4

Add German translation. props @carstingaxion

1.7.3

Use “singular” label for metabox. props @lchski

1.7.2

Fixes popular terms

1.7.1

add minified script to svn repo

1.7.0

Add support for bulk-edit
more quick edit fixes
save tax terms for attachments
switch ajax callback for adding non-hierarchical terms
use default JS scripts on post.php page
remove filtering of columns via manage_{$post_type}_posts_custom_column, etc
switch all taxonomies to “hierarchical” on edit.php so quick edit is automatically switched to radio buttons

1.6.1

Bug-fix for quick-edit

1.6

Use later priority (99) to launch the WordPress_Radio_Taxonomy class instances, resolves bug with custom taxonomies
Switch to class instance initialization instead of global
filtering "manage_taxonomies_for_{$post_type}_columns" doesn’t do anything to quickedit, so removed
removed disable_ui() method in favor of adding to manage_{$post_type}_posts_custom_column hook
** this lets us keep the taxonomy columns in their original places, versus adding to end
** currently no way to remove quick edit without disabling UI in global $wp_taxonomies variable
better docbloc

1.5.6

fix PHP notice in class.WordPress_Radio_Taxonomy.php

1.5.5

verify WP 3.8 compatibility

1.5.4

Fix PHP warnings in class.Walker_Category_Radio.php

1.5.3

Fix error on edit screen if taxonomy is deleted

1.5.2

Fix untranslatable string
Add Arabic translation thanks to @hassanhamm

1.5.1

Load admin scripts only where needed, fixes conflict on edit-terms screens

1.5

Move launch of WordPress_Radio_Taxonomy class to init hook
Move no-term filter inside get_terms() method which should make the proposed FAQ solution for disabling the “No term” work now

1.4.5

Enabled “No {$taxonomy}” in quick edit
Changed column headers to use the singular taxonomy label
Respect the show_admin_column argument when registering taxonomy
Automatically unset default taxonomy column (if conventionally named) to prevent duplicate columns

1.4.4

Change generic “No term” to “No {$taxonomy}”, ex: “No Genre”

1.4.3

Fix PHP warning in metabox related to “No term”
Fix conditional logic for “No term” option
Added filter to disabled “No term”
Fixed “Add new” term WPLists markup

1.4.2

Fix fatal error on settings update

1.4.1

Fix “No term” option showing in non-radio taxonomies

1.4

Add “No term” option to taxonomy metaboxes

1.3

fix problem with adding new terms, #7

1.2.5

fix markdown for changelog

1.2.4

return changelog to readme.txt

1.2.3

fix PHP notice https://github.com/helgatheviking/Radio-Buttons-for-Taxonomies/issues/5
fix popular/all clicking for WP 3.5.1
move changelog to own file

1.2.2

Still fixing SVN

1.2.1

Hopeful fix of SVN failure to include class.Walker_Category_Radio.php in v1.2 – SVN Is not my strong suit. Sorry for any inconvenience!

1.2

change donation URL
fixed save bug for users without the manage_categories

1.1.4

Correct plugin URL
fixed quick edit bug
fixed undefined $post variable warning

1.1.3

Code cleanup

1.1.2

Removed unneeded localize_script object
Fix fatal error on multisite ( caused by using an anonymous function when not supported until PHP 5.3)
Fixed quick edit refresh ( second click on quick edit for same item and the value still reflected the original)

1.1.1

Fix notice in popular terms tab
Attempted fix fatal error on multisite

1.1

Added columns to edit screen for every radio taxonomy
Add quick edit for all radio taxonomies
Enforce limit of single terms via save_post
fixed error with taxonomy object property not being loaded on the right hook
fixed uninstall hook
fixed saving of ‘delete’ option

1.0.3

updated donate link

1.0.2

fixed incorrect plugin settings link
fixed variable scope in javascript that was preventing plugin from working on multiple metaboxes

1.0.1

bug fix for when no taxonomies are selected

1.0

Initial release.