/Radio-Buttons-for-Taxonomies

Turn any WordPress taxonomy into a list of radio buttons, which forces users to select only 1 term!

Primary LanguagePHP

Radio Buttons for Taxonomies

Contributors: helgatheviking
Donate link: https://www.youcaring.com/wnt-residency
Tags: taxonomy, admin, interface, ui, post, radio, terms, metabox
Requires at least: 4.5.0
Tested up to: 4.9.6
Stable tag: 2.0.0
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Description

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

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

Screenshots

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

Frequently Asked Questions

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

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 helgatheviking#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.