Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/helgatheviking/radio-buttons-for-taxonomies
Turn any WordPress taxonomy into a list of radio buttons, which forces users to select only 1 term!
https://github.com/helgatheviking/radio-buttons-for-taxonomies
custom-metabox hacktoberfest radio-taxonomies wordpress-taxonomy
Last synced: about 7 hours ago
JSON representation
Turn any WordPress taxonomy into a list of radio buttons, which forces users to select only 1 term!
- Host: GitHub
- URL: https://github.com/helgatheviking/radio-buttons-for-taxonomies
- Owner: helgatheviking
- Created: 2012-07-11T17:34:59.000Z (over 12 years ago)
- Default Branch: trunk
- Last Pushed: 2023-06-20T16:56:44.000Z (over 1 year ago)
- Last Synced: 2024-04-09T21:18:34.028Z (7 months ago)
- Topics: custom-metabox, hacktoberfest, radio-taxonomies, wordpress-taxonomy
- Language: PHP
- Homepage:
- Size: 1.19 MB
- Stars: 55
- Watchers: 8
- Forks: 28
- Open Issues: 9
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Radio Buttons for Taxonomies #
**Contributors:** [helgatheviking](https://profiles.wordpress.org/helgatheviking/)
**Donate link:** https://www.paypal.me/kathyisawesome
**Tags:** taxonomy, admin, interface, ui, post, radio, terms, metabox
**Requires at least:** 4.5.0
**Tested up to:** 6.1.0
**Stable tag:** 2.4.7
**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](https://github.com/stephenh1988/Radio-Buttons-for-Taxonomies)
### Support ###
Support is handled in the [WordPress forums](http://wordpress.org/support/plugin/radio-buttons-for-taxonomies). Please note that support is limited and does not cover any custom implementation of the plugin. Before posting a question, read the [FAQ](https://wordpress.org/plugins/radio-buttons-for-taxonomies/#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](https://github.com/helgatheviking/Radio-Buttons-for-Taxonomies/issues)
## Installation ##
1. Upload the `plugin` folder to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. 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 ##
### 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](https://github.com/WordPress/gutenberg/pull/14786)
### 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.