├── .gitignore ├── .wordpressorg ├── banner-1544x500.png ├── banner-772x250.png ├── icon-128x128.png └── icon-256x256.png ├── LICENSE ├── README.md ├── Taxonomy_Switcher.php ├── Taxonomy_Switcher_UI.php ├── js └── taxonomy-switcher.js ├── readme.txt ├── screenshot-1.png ├── screenshot-2.png ├── taxonomy-switcher.php └── wp-cli.php /.gitignore: -------------------------------------------------------------------------------- 1 | .DS_Store 2 | -------------------------------------------------------------------------------- /.wordpressorg/banner-1544x500.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WebDevStudios/taxonomy-switcher/42b9809f84a49967f73ce48a26aec4284fe7829a/.wordpressorg/banner-1544x500.png -------------------------------------------------------------------------------- /.wordpressorg/banner-772x250.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WebDevStudios/taxonomy-switcher/42b9809f84a49967f73ce48a26aec4284fe7829a/.wordpressorg/banner-772x250.png -------------------------------------------------------------------------------- /.wordpressorg/icon-128x128.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WebDevStudios/taxonomy-switcher/42b9809f84a49967f73ce48a26aec4284fe7829a/.wordpressorg/icon-128x128.png -------------------------------------------------------------------------------- /.wordpressorg/icon-256x256.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WebDevStudios/taxonomy-switcher/42b9809f84a49967f73ce48a26aec4284fe7829a/.wordpressorg/icon-256x256.png -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | GNU GENERAL PUBLIC LICENSE 2 | Version 2, June 1991 3 | 4 | Copyright (C) 1989, 1991 Free Software Foundation, Inc., 5 | 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA 6 | Everyone is permitted to copy and distribute verbatim copies 7 | of this license document, but changing it is not allowed. 8 | 9 | Preamble 10 | 11 | The licenses for most software are designed to take away your 12 | freedom to share and change it. By contrast, the GNU General Public 13 | License is intended to guarantee your freedom to share and change free 14 | software--to make sure the software is free for all its users. This 15 | General Public License applies to most of the Free Software 16 | Foundation's software and to any other program whose authors commit to 17 | using it. (Some other Free Software Foundation software is covered by 18 | the GNU Lesser General Public License instead.) You can apply it to 19 | your programs, too. 20 | 21 | When we speak of free software, we are referring to freedom, not 22 | price. Our General Public Licenses are designed to make sure that you 23 | have the freedom to distribute copies of free software (and charge for 24 | this service if you wish), that you receive source code or can get it 25 | if you want it, that you can change the software or use pieces of it 26 | in new free programs; and that you know you can do these things. 27 | 28 | To protect your rights, we need to make restrictions that forbid 29 | anyone to deny you these rights or to ask you to surrender the rights. 30 | These restrictions translate to certain responsibilities for you if you 31 | distribute copies of the software, or if you modify it. 32 | 33 | For example, if you distribute copies of such a program, whether 34 | gratis or for a fee, you must give the recipients all the rights that 35 | you have. You must make sure that they, too, receive or can get the 36 | source code. And you must show them these terms so they know their 37 | rights. 38 | 39 | We protect your rights with two steps: (1) copyright the software, and 40 | (2) offer you this license which gives you legal permission to copy, 41 | distribute and/or modify the software. 42 | 43 | Also, for each author's protection and ours, we want to make certain 44 | that everyone understands that there is no warranty for this free 45 | software. If the software is modified by someone else and passed on, we 46 | want its recipients to know that what they have is not the original, so 47 | that any problems introduced by others will not reflect on the original 48 | authors' reputations. 49 | 50 | Finally, any free program is threatened constantly by software 51 | patents. We wish to avoid the danger that redistributors of a free 52 | program will individually obtain patent licenses, in effect making the 53 | program proprietary. To prevent this, we have made it clear that any 54 | patent must be licensed for everyone's free use or not licensed at all. 55 | 56 | The precise terms and conditions for copying, distribution and 57 | modification follow. 58 | 59 | GNU GENERAL PUBLIC LICENSE 60 | TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 61 | 62 | 0. This License applies to any program or other work which contains 63 | a notice placed by the copyright holder saying it may be distributed 64 | under the terms of this General Public License. The "Program", below, 65 | refers to any such program or work, and a "work based on the Program" 66 | means either the Program or any derivative work under copyright law: 67 | that is to say, a work containing the Program or a portion of it, 68 | either verbatim or with modifications and/or translated into another 69 | language. (Hereinafter, translation is included without limitation in 70 | the term "modification".) Each licensee is addressed as "you". 71 | 72 | Activities other than copying, distribution and modification are not 73 | covered by this License; they are outside its scope. The act of 74 | running the Program is not restricted, and the output from the Program 75 | is covered only if its contents constitute a work based on the 76 | Program (independent of having been made by running the Program). 77 | Whether that is true depends on what the Program does. 78 | 79 | 1. You may copy and distribute verbatim copies of the Program's 80 | source code as you receive it, in any medium, provided that you 81 | conspicuously and appropriately publish on each copy an appropriate 82 | copyright notice and disclaimer of warranty; keep intact all the 83 | notices that refer to this License and to the absence of any warranty; 84 | and give any other recipients of the Program a copy of this License 85 | along with the Program. 86 | 87 | You may charge a fee for the physical act of transferring a copy, and 88 | you may at your option offer warranty protection in exchange for a fee. 89 | 90 | 2. You may modify your copy or copies of the Program or any portion 91 | of it, thus forming a work based on the Program, and copy and 92 | distribute such modifications or work under the terms of Section 1 93 | above, provided that you also meet all of these conditions: 94 | 95 | a) You must cause the modified files to carry prominent notices 96 | stating that you changed the files and the date of any change. 97 | 98 | b) You must cause any work that you distribute or publish, that in 99 | whole or in part contains or is derived from the Program or any 100 | part thereof, to be licensed as a whole at no charge to all third 101 | parties under the terms of this License. 102 | 103 | c) If the modified program normally reads commands interactively 104 | when run, you must cause it, when started running for such 105 | interactive use in the most ordinary way, to print or display an 106 | announcement including an appropriate copyright notice and a 107 | notice that there is no warranty (or else, saying that you provide 108 | a warranty) and that users may redistribute the program under 109 | these conditions, and telling the user how to view a copy of this 110 | License. (Exception: if the Program itself is interactive but 111 | does not normally print such an announcement, your work based on 112 | the Program is not required to print an announcement.) 113 | 114 | These requirements apply to the modified work as a whole. If 115 | identifiable sections of that work are not derived from the Program, 116 | and can be reasonably considered independent and separate works in 117 | themselves, then this License, and its terms, do not apply to those 118 | sections when you distribute them as separate works. But when you 119 | distribute the same sections as part of a whole which is a work based 120 | on the Program, the distribution of the whole must be on the terms of 121 | this License, whose permissions for other licensees extend to the 122 | entire whole, and thus to each and every part regardless of who wrote it. 123 | 124 | Thus, it is not the intent of this section to claim rights or contest 125 | your rights to work written entirely by you; rather, the intent is to 126 | exercise the right to control the distribution of derivative or 127 | collective works based on the Program. 128 | 129 | In addition, mere aggregation of another work not based on the Program 130 | with the Program (or with a work based on the Program) on a volume of 131 | a storage or distribution medium does not bring the other work under 132 | the scope of this License. 133 | 134 | 3. You may copy and distribute the Program (or a work based on it, 135 | under Section 2) in object code or executable form under the terms of 136 | Sections 1 and 2 above provided that you also do one of the following: 137 | 138 | a) Accompany it with the complete corresponding machine-readable 139 | source code, which must be distributed under the terms of Sections 140 | 1 and 2 above on a medium customarily used for software interchange; or, 141 | 142 | b) Accompany it with a written offer, valid for at least three 143 | years, to give any third party, for a charge no more than your 144 | cost of physically performing source distribution, a complete 145 | machine-readable copy of the corresponding source code, to be 146 | distributed under the terms of Sections 1 and 2 above on a medium 147 | customarily used for software interchange; or, 148 | 149 | c) Accompany it with the information you received as to the offer 150 | to distribute corresponding source code. (This alternative is 151 | allowed only for noncommercial distribution and only if you 152 | received the program in object code or executable form with such 153 | an offer, in accord with Subsection b above.) 154 | 155 | The source code for a work means the preferred form of the work for 156 | making modifications to it. For an executable work, complete source 157 | code means all the source code for all modules it contains, plus any 158 | associated interface definition files, plus the scripts used to 159 | control compilation and installation of the executable. However, as a 160 | special exception, the source code distributed need not include 161 | anything that is normally distributed (in either source or binary 162 | form) with the major components (compiler, kernel, and so on) of the 163 | operating system on which the executable runs, unless that component 164 | itself accompanies the executable. 165 | 166 | If distribution of executable or object code is made by offering 167 | access to copy from a designated place, then offering equivalent 168 | access to copy the source code from the same place counts as 169 | distribution of the source code, even though third parties are not 170 | compelled to copy the source along with the object code. 171 | 172 | 4. You may not copy, modify, sublicense, or distribute the Program 173 | except as expressly provided under this License. Any attempt 174 | otherwise to copy, modify, sublicense or distribute the Program is 175 | void, and will automatically terminate your rights under this License. 176 | However, parties who have received copies, or rights, from you under 177 | this License will not have their licenses terminated so long as such 178 | parties remain in full compliance. 179 | 180 | 5. You are not required to accept this License, since you have not 181 | signed it. However, nothing else grants you permission to modify or 182 | distribute the Program or its derivative works. These actions are 183 | prohibited by law if you do not accept this License. Therefore, by 184 | modifying or distributing the Program (or any work based on the 185 | Program), you indicate your acceptance of this License to do so, and 186 | all its terms and conditions for copying, distributing or modifying 187 | the Program or works based on it. 188 | 189 | 6. Each time you redistribute the Program (or any work based on the 190 | Program), the recipient automatically receives a license from the 191 | original licensor to copy, distribute or modify the Program subject to 192 | these terms and conditions. You may not impose any further 193 | restrictions on the recipients' exercise of the rights granted herein. 194 | You are not responsible for enforcing compliance by third parties to 195 | this License. 196 | 197 | 7. If, as a consequence of a court judgment or allegation of patent 198 | infringement or for any other reason (not limited to patent issues), 199 | conditions are imposed on you (whether by court order, agreement or 200 | otherwise) that contradict the conditions of this License, they do not 201 | excuse you from the conditions of this License. If you cannot 202 | distribute so as to satisfy simultaneously your obligations under this 203 | License and any other pertinent obligations, then as a consequence you 204 | may not distribute the Program at all. For example, if a patent 205 | license would not permit royalty-free redistribution of the Program by 206 | all those who receive copies directly or indirectly through you, then 207 | the only way you could satisfy both it and this License would be to 208 | refrain entirely from distribution of the Program. 209 | 210 | If any portion of this section is held invalid or unenforceable under 211 | any particular circumstance, the balance of the section is intended to 212 | apply and the section as a whole is intended to apply in other 213 | circumstances. 214 | 215 | It is not the purpose of this section to induce you to infringe any 216 | patents or other property right claims or to contest validity of any 217 | such claims; this section has the sole purpose of protecting the 218 | integrity of the free software distribution system, which is 219 | implemented by public license practices. Many people have made 220 | generous contributions to the wide range of software distributed 221 | through that system in reliance on consistent application of that 222 | system; it is up to the author/donor to decide if he or she is willing 223 | to distribute software through any other system and a licensee cannot 224 | impose that choice. 225 | 226 | This section is intended to make thoroughly clear what is believed to 227 | be a consequence of the rest of this License. 228 | 229 | 8. If the distribution and/or use of the Program is restricted in 230 | certain countries either by patents or by copyrighted interfaces, the 231 | original copyright holder who places the Program under this License 232 | may add an explicit geographical distribution limitation excluding 233 | those countries, so that distribution is permitted only in or among 234 | countries not thus excluded. In such case, this License incorporates 235 | the limitation as if written in the body of this License. 236 | 237 | 9. The Free Software Foundation may publish revised and/or new versions 238 | of the General Public License from time to time. Such new versions will 239 | be similar in spirit to the present version, but may differ in detail to 240 | address new problems or concerns. 241 | 242 | Each version is given a distinguishing version number. If the Program 243 | specifies a version number of this License which applies to it and "any 244 | later version", you have the option of following the terms and conditions 245 | either of that version or of any later version published by the Free 246 | Software Foundation. If the Program does not specify a version number of 247 | this License, you may choose any version ever published by the Free Software 248 | Foundation. 249 | 250 | 10. If you wish to incorporate parts of the Program into other free 251 | programs whose distribution conditions are different, write to the author 252 | to ask for permission. For software which is copyrighted by the Free 253 | Software Foundation, write to the Free Software Foundation; we sometimes 254 | make exceptions for this. Our decision will be guided by the two goals 255 | of preserving the free status of all derivatives of our free software and 256 | of promoting the sharing and reuse of software generally. 257 | 258 | NO WARRANTY 259 | 260 | 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY 261 | FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN 262 | OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES 263 | PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED 264 | OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 265 | MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS 266 | TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE 267 | PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, 268 | REPAIR OR CORRECTION. 269 | 270 | 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING 271 | WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR 272 | REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, 273 | INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING 274 | OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED 275 | TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY 276 | YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER 277 | PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE 278 | POSSIBILITY OF SUCH DAMAGES. 279 | 280 | END OF TERMS AND CONDITIONS 281 | 282 | How to Apply These Terms to Your New Programs 283 | 284 | If you develop a new program, and you want it to be of the greatest 285 | possible use to the public, the best way to achieve this is to make it 286 | free software which everyone can redistribute and change under these terms. 287 | 288 | To do so, attach the following notices to the program. It is safest 289 | to attach them to the start of each source file to most effectively 290 | convey the exclusion of warranty; and each file should have at least 291 | the "copyright" line and a pointer to where the full notice is found. 292 | 293 | {description} 294 | Copyright (C) {year} {fullname} 295 | 296 | This program is free software; you can redistribute it and/or modify 297 | it under the terms of the GNU General Public License as published by 298 | the Free Software Foundation; either version 2 of the License, or 299 | (at your option) any later version. 300 | 301 | This program is distributed in the hope that it will be useful, 302 | but WITHOUT ANY WARRANTY; without even the implied warranty of 303 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 304 | GNU General Public License for more details. 305 | 306 | You should have received a copy of the GNU General Public License along 307 | with this program; if not, write to the Free Software Foundation, Inc., 308 | 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. 309 | 310 | Also add information on how to contact you by electronic and paper mail. 311 | 312 | If the program is interactive, make it output a short notice like this 313 | when it starts in an interactive mode: 314 | 315 | Gnomovision version 69, Copyright (C) year name of author 316 | Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. 317 | This is free software, and you are welcome to redistribute it 318 | under certain conditions; type `show c' for details. 319 | 320 | The hypothetical commands `show w' and `show c' should show the appropriate 321 | parts of the General Public License. Of course, the commands you use may 322 | be called something other than `show w' and `show c'; they could even be 323 | mouse-clicks or menu items--whatever suits your program. 324 | 325 | You should also get your employer (if you work as a programmer) or your 326 | school, if any, to sign a "copyright disclaimer" for the program, if 327 | necessary. Here is a sample; alter the names: 328 | 329 | Yoyodyne, Inc., hereby disclaims all copyright interest in the program 330 | `Gnomovision' (which makes passes at compilers) written by James Hacker. 331 | 332 | {signature of Ty Coon}, 1 April 1989 333 | Ty Coon, President of Vice 334 | 335 | This General Public License does not permit incorporating your program into 336 | proprietary programs. If your program is a subroutine library, you may 337 | consider it more useful to permit linking proprietary applications with the 338 | library. If this is what you want to do, use the GNU Lesser General 339 | Public License instead of this License. 340 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | Taxonomy Switcher 2 | ====================== 3 | 4 | Switch the taxonomy for terms by a specific parent of another taxonomy. 5 | 6 | ## Instructions 7 | 8 | 1. **Backup!** 9 | 2. Activate the plugin and browse to yourdomain.com/wp-admin/tools.php?page=taxonomy-switcher 10 | 3. Select your "From", and "To" Taxonomies. 11 | 12 | **Optional** 13 | 14 | 1. Select a parent term to limit terms to switch. Typing term names will do a live search of terms with the name you are typing AND possess child terms. 15 | 2. OR add a comma-separated list of term ids to switch. 16 | 17 | ## Notes 18 | 19 | If parent isn't set, or you don't specify a comma-separated list of term ids to migrate, it will migrate *all* terms for that taxonomy to the new taxonomy. 20 | 21 | Compatible with [wp-cli](http://wp-cli.org/). `wp taxonomy-switcher` for instructions. 22 | 23 | ## Changelog 24 | 25 | #### 1.0.3 26 | * Compatibility confirmation for WordPress 5.4 27 | 28 | #### 1.0.2 29 | * Update for xss vulnerability, https://make.wordpress.org/plugins/2015/04/20/fixing-add_query_arg-and-remove_query_arg-usage 30 | 31 | #### 1.0.1 32 | * Add ability to switch comma-separated list of term IDs. 33 | 34 | #### 1.0.0 35 | * Release 36 | -------------------------------------------------------------------------------- /Taxonomy_Switcher.php: -------------------------------------------------------------------------------- 1 | '', 76 | 'to_tax' => '', 77 | 'parent' => '', 78 | 'terms' => '', 79 | ] ); 80 | 81 | if ( ! $args['from_tax'] || ! $args['to_tax'] ) { 82 | return; 83 | } 84 | 85 | if ( ! empty( $args['parent'] ) ) { 86 | $this->parent = absint( $args['parent'] ); 87 | } 88 | 89 | if ( ! empty( $args['terms'] ) ) { 90 | $this->terms = wp_parse_id_list( $args['terms'] ); 91 | } 92 | 93 | $this->is_ui = ( isset( $_GET['page'] ) && 'taxonomy-switcher' == $_GET['page'] ); 94 | 95 | $this->from = sanitize_text_field( $args['from_tax'] ); 96 | $this->to = sanitize_text_field( $args['to_tax'] ); 97 | 98 | } 99 | 100 | /** 101 | * Convert taxonomy of terms from the Admin. 102 | * 103 | * @since 1.0.0 104 | */ 105 | public function admin_convert() { 106 | 107 | $count = $this->count(); 108 | 109 | if ( ! $count && $this->is_ui ) { 110 | return $this->notice( $this->notices( 'no_terms' ) ); 111 | } 112 | 113 | $this->notice( $this->notices( 'switching' ) ); 114 | 115 | if ( 0 < $this->parent ) { 116 | $this->notice( $this->notices( 'limit_by_parent' ) ); 117 | } elseif ( ! empty( $this->terms ) ) { 118 | $this->notice( $this->notices( 'limit_by_terms' ) ); 119 | } 120 | 121 | set_time_limit( 0 ); 122 | 123 | $this->convert(); 124 | 125 | $this->notice( $this->notices( 'switched' ) ); 126 | 127 | if ( $this->is_ui ) { 128 | return $this->notices; 129 | } 130 | 131 | die(); 132 | } 133 | 134 | /** 135 | * Stores and (maybe) displays notices. 136 | * 137 | * @since 1.0.0 138 | * 139 | * @param string $notice Notice to store and/or display. 140 | * 141 | * @return array 142 | */ 143 | public function notice( string $notice ) { 144 | // Add to our notices array. 145 | $this->notices[] = $notice; 146 | if ( ! $this->is_ui ) { 147 | echo $notice; 148 | } 149 | 150 | return $this->notices; 151 | } 152 | 153 | /** 154 | * Compile our notices. 155 | * 156 | * @since 1.0.0 157 | * 158 | * @param string $key Array key to retrieve. 159 | * 160 | * @return mixed 161 | */ 162 | public function notices( string $key ) { 163 | if ( ! empty( $this->messages ) ) { 164 | return $this->messages[ $key ]; 165 | } 166 | 167 | $count = $this->count(); 168 | $count_name = sprintf( _n( '1 term', '%d terms', $count, 'wds' ), $count ); 169 | $this->messages = [ 170 | 'no_terms' => __( 'No terms to be switched. Check if the term exists in your "from" taxonomy.', 'wds' ), 171 | 'switching' => sprintf( __( 'Switching %s with the taxonomy \'%s\' to the taxonomy \'%s\'', 'wds' ), $count_name, $this->from, $this->to ), 172 | 'limit_by_parent' => sprintf( __( 'Limiting the switch by the parent term_id of %d', 'wds' ), $this->parent ), 173 | 'limit_by_terms' => sprintf( __( 'Limiting the switch to these terms: %s', 'wds' ), implode( ', ', $this->terms ) ), 174 | 'switched' => sprintf( __( 'Taxonomies switched for %s!', 'wds' ), $count_name ), 175 | ]; 176 | 177 | return $this->messages[ $key ]; 178 | } 179 | 180 | /** 181 | * Get term ids based on $from and $parent. 182 | * 183 | * @since 1.0.0 184 | * 185 | * @return array An array of term ids. 186 | */ 187 | public function get_term_ids() : array { 188 | 189 | $args = [ 190 | 'hide_empty' => false, 191 | 'fields' => 'ids', 192 | 'child_of' => $this->parent, 193 | 'include' => $this->terms, 194 | ]; 195 | 196 | $args = apply_filters( 'taxonomy_switcher_get_terms_args', $args, $this->from, $this->to, [ 197 | 'parent' => $this->parent, 198 | 'terms' => $this->terms 199 | ] ); 200 | 201 | $terms = get_terms( $this->from, $args ); 202 | 203 | $this->term_ids = []; 204 | 205 | if ( ! is_wp_error( $terms ) && ! empty( $terms ) ) { 206 | $this->term_ids = $terms; 207 | } 208 | 209 | return $this->term_ids; 210 | 211 | } 212 | 213 | /** 214 | * Return the total count of terms found. 215 | * 216 | * @since 1.0.0 217 | * 218 | * @return int Total count of terms found. 219 | */ 220 | public function count() : int { 221 | 222 | if ( empty( $this->term_ids ) ) { 223 | $this->get_term_ids(); 224 | } 225 | 226 | return count( $this->term_ids ); 227 | 228 | } 229 | 230 | /** 231 | * Convert taxonomy of terms. 232 | * 233 | * @since 1.0.0 234 | * 235 | * @return bool Whether the conversion was successful. 236 | */ 237 | public function convert() : bool { 238 | 239 | if ( empty( $this->term_ids ) ) { 240 | $this->get_term_ids(); 241 | } 242 | 243 | if ( empty( $this->term_ids ) ) { 244 | return false; 245 | } 246 | 247 | global $wpdb; 248 | 249 | $term_ids = array_map( 'absint', $this->term_ids ); 250 | $term_ids = implode( ', ', $term_ids ); 251 | 252 | $wpdb->query( $wpdb->prepare( " 253 | UPDATE `{$wpdb->term_taxonomy}` 254 | SET `taxonomy` = %s 255 | WHERE `taxonomy` = %s AND `term_id` IN ( {$term_ids} ) 256 | ", $this->to, $this->from ) ); 257 | 258 | if ( 0 < $this->parent ) { 259 | $wpdb->query( $wpdb->prepare( " 260 | UPDATE `{$wpdb->term_taxonomy}` 261 | SET `parent` = 0 262 | WHERE `parent` = %d AND `term_id` IN ( {$term_ids} ) 263 | ", $this->parent ) ); 264 | } 265 | 266 | $post_ids = $wpdb->get_col( "SELECT post_id FROM $wpdb->postmeta WHERE meta_key = '_menu_item_object_id' AND meta_value IN ( {$term_ids} );" ); 267 | update_postmeta_cache( $post_ids ); 268 | foreach ( $post_ids as $post_id ) { 269 | $type = get_post_meta( $post_id, '_menu_item_type', true ); 270 | $object = get_post_meta( $post_id, '_menu_item_object', true ); 271 | if ( 'taxonomy' !== $type ) { 272 | continue; 273 | } 274 | if ( $this->from !== $object ) { 275 | continue; 276 | } 277 | update_post_meta( $post_id, '_menu_item_object', $this->to ); 278 | clean_post_cache( $post_id ); 279 | } 280 | 281 | // Clean term caches 282 | clean_term_cache( $term_ids, $this->from ); 283 | clean_term_cache( $term_ids, $this->to ); 284 | 285 | return true; 286 | } 287 | } 288 | -------------------------------------------------------------------------------- /Taxonomy_Switcher_UI.php: -------------------------------------------------------------------------------- 1 | not_37 = ! version_compare( $wp_version, '3.7' ) >= 0; 61 | $this->dir_url = plugins_url( '/', __FILE__ ); 62 | 63 | } 64 | 65 | /** 66 | * Peform our UI admin page hooks. 67 | * 68 | * @since 1.0.0 69 | */ 70 | public function hooks() { 71 | 72 | add_action( 'admin_menu', [ $this, 'add_page' ] ); 73 | add_action( 'wp_ajax_taxonomy_switcher_search_term_handler', [ $this, 'ajax_term_results' ] ); 74 | 75 | } 76 | 77 | /** 78 | * Add menu item/ui page. 79 | * 80 | * @since 1.0.0 81 | */ 82 | public function add_page() { 83 | 84 | $this->admin_title = esc_html__( 'Taxonomy Switcher', 'wds' ); 85 | $this->admin_slug = 'taxonomy-switcher'; 86 | 87 | $this->options_page = add_management_page( $this->admin_title, $this->admin_title, 'manage_options', $this->admin_slug, [ 88 | $this, 89 | 'do_page', 90 | ] ); 91 | 92 | add_action( 'admin_head-' . $this->options_page, [ $this, 'js' ] ); 93 | 94 | } 95 | 96 | /** 97 | * JS for UI page. 98 | * 99 | * @since 1.0.0 100 | */ 101 | public function js() { 102 | wp_enqueue_script( $this->admin_slug, $this->dir_url . 'js/' . $this->admin_slug . '.js', [ 'jquery' ], self::VERSION, true ); 103 | } 104 | 105 | /** 106 | * Taxonomy Switcher UI admin page. 107 | * 108 | * @since 1.0.0 109 | */ 110 | public function do_page() { 111 | 112 | $this->registered_taxonomies = get_taxonomies( [], 'objects' ); 113 | ?> 114 |
115 |

admin_title ); ?>

116 | 117 |
118 | 119 | 120 | 121 | 122 | 123 | 124 | 125 | 126 | 131 | 132 | 133 | 134 | 139 | 140 | 141 | 144 | 147 | 148 | 149 | 152 | 161 | 162 | 163 |
127 | 130 |
135 | 138 |
142 | 143 | 145 | 146 |
150 | 151 | 153 | 154 | 155 | 156 | 157 | 158 | 159 |
160 |
164 | 165 | 166 |
167 |
168 | s with all taxonomies. 173 | * 174 | * @since 1.0.0 175 | * 176 | * @param string $name Name of select. 177 | */ 178 | public function fill_options( string $name ) { 179 | 180 | $current = $_GET[ $name ] ?? false; 181 | 182 | foreach ( $this->registered_taxonomies as $slug => $tax_object ) { 183 | echo ''; 184 | } 185 | 186 | } 187 | 188 | /** 189 | * Ajax handler for term search. 190 | * 191 | * @since 1.0.0 192 | */ 193 | public function ajax_term_results() { 194 | 195 | if ( ! ( isset( $_REQUEST[ 'nonce' ], $_REQUEST[ 'search' ] ) && wp_verify_nonce( $_REQUEST[ 'nonce' ], __FILE__ ) ) ) { 196 | $this->send_error( __LINE__, __( 'Security check failed', 'wds' ) ); 197 | } 198 | 199 | $taxonomy = $_REQUEST['tax_name'] ?? 'category'; 200 | 201 | $search_string = sanitize_text_field( $_REQUEST[ 'search' ] ); 202 | 203 | if ( empty( $search_string ) ) { 204 | $this->send_error( __LINE__, __( 'Please Try Again', 'wds' ) ); 205 | } 206 | 207 | $terms = $this->get_terms( $search_string, $taxonomy ); 208 | 209 | if ( ! $terms ) { 210 | $this->send_error( __LINE__ ); 211 | } 212 | 213 | // Loop found terms and concatenate list items. 214 | $items = $this->get_list_items( $terms ); 215 | 216 | if ( ! $items ) { 217 | // Do more extensive term search. 218 | $terms = $this->get_terms( $search_string, $taxonomy, 30 ); 219 | 220 | // Loop found terms and concatenate list items. 221 | $items = $this->get_list_items( $terms ); 222 | } 223 | 224 | if ( ! $items ) { 225 | $this->send_error( __LINE__, __( 'No terms found with children.', 'wds' ) ); 226 | } 227 | 228 | $return = sprintf( '
    %s
', $items ); 229 | 230 | wp_send_json_success( [ 'html' => $return ] ); 231 | 232 | } 233 | 234 | /** 235 | * The wp_send_json_error wrapper method. 236 | * 237 | * @since 1.0.0 238 | * 239 | * @param string $line Line number of error. 240 | * @param string $msg Message to send. 241 | */ 242 | public function send_error( string $line, string $msg = '' ) { 243 | 244 | $msg = $msg ?: esc_html__( 'No Results Found', 'wds' ); 245 | 246 | wp_send_json_error( [ 247 | 'html' => '', 248 | 'line' => $line, 249 | '$_REQUEST' => $_REQUEST, 250 | ] ); 251 | 252 | } 253 | 254 | /** 255 | * Get the terms for our query. 256 | * 257 | * @since 1.0.0 258 | * 259 | * @param string $search_string Search query. 260 | * @param string $taxonomy Taxonomy slug. 261 | * @param integer $number Number of results to grab. 262 | * @return mixed Array of terms or false. 263 | */ 264 | public function get_terms( string $search_string, string $taxonomy, int $number = 10 ) { 265 | 266 | if ( $this->not_37 ) { 267 | // Add our term clause filter for this iteration (if < than 3.7). 268 | add_filter( 'terms_clauses', [ $this, 'wilcard_term_name' ] ); 269 | } 270 | 271 | $terms = get_terms( $taxonomy, [ 272 | 'number' => absint( $number ), 273 | 'name__like' => $search_string, 274 | 'cache_domain' => 'taxonomy_switch_search2', 275 | 'get' => 'all', 276 | ] ); 277 | 278 | remove_filter( 'terms_clauses', [ $this, 'wilcard_term_name' ] ); 279 | 280 | return empty( $terms ) || is_wp_error( $terms ) ? false : $terms; 281 | 282 | } 283 | 284 | /** 285 | * Loops terms and builds list item strings (if terms have children). 286 | * 287 | * @since 1.0.0 288 | * 289 | * @param array $terms Array of term objects. 290 | * @return string List item markup on success. 291 | */ 292 | public function get_list_items( array $terms ) : string { 293 | 294 | $items = ''; 295 | 296 | foreach ( $terms as $term ) { 297 | $children = get_terms( $term->taxonomy, [ 298 | 'parent' => $term->term_id, 299 | 'hide_empty' => false, 300 | ] ); 301 | 302 | if ( ! $children ) { 303 | continue; 304 | } 305 | 306 | // Add parent term for clarity. 307 | $parent_term = $term->parent ? get_term_by( 'id', $term->parent, $term->taxonomy ) : false; 308 | $parent_name = $parent_term ? $parent_term->name . ' → ' : ''; 309 | 310 | $items .= '
  • ' . esc_html( $parent_name . $term->name ) . '
    • '; 311 | } 312 | 313 | return $items; 314 | 315 | } 316 | 317 | /** 318 | * Make term search wildcard on front as well as back. 319 | * 320 | * @since 1.0.0 321 | * 322 | * @param array $clauses Query clauses. 323 | * @return array Modified query clauses. 324 | */ 325 | public function wilcard_term_name( $clauses ) { 326 | 327 | // Add wildcard flag to beginning of term. 328 | $clauses['where'] = str_replace( "name LIKE '", "name LIKE '%", $clauses['where'] ); 329 | 330 | return $clauses; 331 | } 332 | } 333 | -------------------------------------------------------------------------------- /js/taxonomy-switcher.js: -------------------------------------------------------------------------------- 1 | (function(window, document, $, undefined){ 2 | 3 | window.TaxonomySwitcher = {}; 4 | 5 | var txsw = TaxonomySwitcher; 6 | var $context = $('.wrap.taxonomy-switcher'); 7 | var $nonce = $('#taxonomy_switcher_nonce'); 8 | var $ajaxinput = $('#taxonomy-switcher-parent'); 9 | var $ajaxcontext = $ajaxinput.parents('tr'); 10 | var $ajaxresults = $('.taxonomy-switcher-ajax-results-posts', $ajaxcontext); 11 | var $ajaxhelp = $('.taxonomy-switcher-ajax-results-help', $ajaxcontext); 12 | var $spinner = $('.taxonomy-switcher-spinner', $ajaxcontext); 13 | 14 | txsw.hideSpinner = function() { 15 | // when leaving the input 16 | setTimeout(function(){ 17 | // if it's been 2 seconds, hide our spinner 18 | $spinner.hide(); 19 | }, 2000); 20 | } 21 | 22 | txsw.resultsClick = function( event ) { 23 | event.preventDefault(); 24 | var $self = $(this); 25 | $spinner.hide(); 26 | // populate post ID to field 27 | $ajaxinput.val( $self.data('termid') );/*.focus()*/ 28 | $ajaxresults.html(''); 29 | $ajaxhelp.hide(); 30 | } 31 | 32 | txsw.ajaxSuccess = function(response) { 33 | console.log( 'response', response ); 34 | // hide our spinner 35 | $spinner.hide(); 36 | 37 | if ( typeof response.data !== 'undefined' ) { 38 | $ajaxresults.html(response.data.html); 39 | $ajaxhelp.show(); 40 | } 41 | } 42 | 43 | txsw.maybeAjax = function( evt ) { 44 | 45 | $self = $(this); 46 | var term_search = $self.val(); 47 | if ( term_search.length < 2 ) 48 | return this; 49 | 50 | // only proceed if the user has pressed a number, letter or backspace 51 | if (evt.which <= 90 && evt.which >= 48 || evt.which == 8) { 52 | // clear out our results 53 | $ajaxresults.html(''); 54 | $ajaxhelp.hide(); 55 | $spinner.css({'float':'none'}).show(); 56 | setTimeout(function(){ 57 | // if they haven't typed in 500 ms 58 | if ( $ajaxinput.val() == term_search ) { 59 | $.ajax({ 60 | type : 'post', 61 | dataType : 'json', 62 | url : ajaxurl, 63 | success : txsw.ajaxSuccess, 64 | data : { 65 | 'action' : 'taxonomy_switcher_search_term_handler', 66 | 'tax_name' : $('#from_tax').val(), 67 | 'search' : term_search, 68 | 'nonce' : $nonce.val() 69 | } 70 | }); 71 | } 72 | }, 500); 73 | } 74 | } 75 | 76 | $context 77 | .on( 'keyup', '#taxonomy-switcher-parent', txsw.maybeAjax ).blur( txsw.hideSpinner ) 78 | .on( 'click', '.taxonomy-switcher-ajax-results-posts a', txsw.resultsClick ); 79 | 80 | })(window, document, jQuery); 81 | -------------------------------------------------------------------------------- /readme.txt: -------------------------------------------------------------------------------- 1 | === Taxonomy Switcher === 2 | Contributors: webdevstudios, pluginize 3 | Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=3084056 4 | Tags: taxonomy, term, category, tag, switch 5 | Requires at least: 5.2 6 | Tested up to: 6.8.1 7 | Stable tag: 1.0.8 8 | License: GNU AGPLv3 9 | License URI: http://www.gnu.org/licenses/agpl-3.0.html 10 | Requires PHP: 7.4 11 | 12 | Switch the taxonomy for all terms or only child terms of a specified parent term. 13 | 14 | == Description == 15 | 16 | This plugin allows you to select your "From", and "To" Taxonomies, to convert all terms. Optionally select a parent term to limit terms to switch. Typing term names will do a live search of terms with the name you are typing AND possess child terms. 17 | 18 | Plugin also has built-in support for [WP-CLI](http://wp-cli.org/). In the command line, type in `wp taxonomy-switcher` for instructions. 19 | 20 | [Plugin is on GitHub](https://github.com/WebDevStudios/taxonomy-switcher). Pull Requests and Forks welcome. 21 | 22 | ### Notes 23 | 24 | Please keep in mind, if parent isn't set, or you don't specify a comma-separated list of term ids to migrate, it will migrate *all* terms for that taxonomy to the new taxonomy. 25 | 26 | [Pluginize](https://pluginize.com/?utm_source=taxonomy-switcher&utm_medium=text&utm_campaign=wporg) was launched in 2016 by [WebDevStudios](https://webdevstudios.com/) to promote, support, and house all of their [WordPress products](https://pluginize.com/shop/?utm_source=taxonomy-switcher&utm_medium=text&utm_campaign=wporg). Pluginize is not only creating new products for WordPress all the time, but also provides [ongoing support and development for WordPress community favorites like CPTUI](https://wordpress.org/plugins/custom-post-type-ui/), [CMB2](https://wordpress.org/plugins/cmb2/), and more. 27 | 28 | == Installation == 29 | 30 | 1. **Backup!** 31 | 2. Upload 'taxonomy-switcher' to the '/wp-content/plugins/' directory 32 | 3. Activate the plugin through the 'Plugins' menu in WordPress 33 | 4. Navigate to the 'Taxonomy Switcher' admin page. You'll find the menu item under the 'Tools' menu item on the left. 34 | 5. Select your "From", and "To" Taxonomies. 35 | 6. **a)** Optionally select a parent term to limit terms to switch. Typing term names will do a live search of terms with the name you are typing AND possess child terms. **OR** **b)** Add a comma-separated list of term ids to switch. 36 | 7. Switch them! 37 | 38 | == Frequently Asked Questions == 39 | 40 | 41 | == Screenshots == 42 | 43 | 1. Admin page 44 | 2. Live-searching for a parent term 45 | 46 | == Changelog == 47 | 48 | = 1.0.8 = 49 | * Updated: Confirmed WP 6.8 compatibility. 50 | * Updated: Misc little code cleanups that should not affect anyone. 51 | 52 | = 1.0.7 = 53 | * Updated: Confirmed WP 6.5 compatibility. 54 | 55 | = 1.0.6 = 56 | * Updated: Confirmed WP 6.4 compatibility. 57 | * Updated: Moved capability back to manage_options to sync with options page. 58 | * Updated: Clear caches after conversion. 59 | * Fixed: PHP8 deprecation notices. 60 | 61 | = 1.0.5 = 62 | * Updated: Confirmed WP 6.2.1 compatibility. 63 | 64 | = 1.0.4 = 65 | * Updated: changed required capability to manage_categories 66 | 67 | = 1.0.3 = 68 | * Confirmed compatibility with WordPress 5.4.0 69 | 70 | = 1.0.2 = 71 | * Update for xss vulnerability, https://make.wordpress.org/plugins/2015/04/20/fixing-add_query_arg-and-remove_query_arg-usage 72 | 73 | = 1.0.1 = 74 | * Add ability to switch comma-separated list of term IDs. 75 | 76 | = 1.0.0 = 77 | * Release 78 | 79 | == Upgrade Notice == 80 | 81 | = 1.0.5 = 82 | * Updated: Confirmed WP 6.2.1 compatibility. 83 | -------------------------------------------------------------------------------- /screenshot-1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WebDevStudios/taxonomy-switcher/42b9809f84a49967f73ce48a26aec4284fe7829a/screenshot-1.png -------------------------------------------------------------------------------- /screenshot-2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/WebDevStudios/taxonomy-switcher/42b9809f84a49967f73ce48a26aec4284fe7829a/screenshot-2.png -------------------------------------------------------------------------------- /taxonomy-switcher.php: -------------------------------------------------------------------------------- 1 | ui = new Taxonomy_Switcher_UI(); 39 | $this->ui->hooks(); 40 | } 41 | 42 | add_action( 'admin_init', [ $this, 'taxonomy_switcher_init' ] ); 43 | 44 | $this->notices = get_option( 'taxonomy-switcher-notices' ); 45 | if ( $this->notices ) { 46 | add_action( 'all_admin_notices', [ $this, 'do_admin_notice' ] ); 47 | } 48 | 49 | } 50 | 51 | /** 52 | * Include Taxonomy_Switcher if being run. 53 | * 54 | * @since 1.0.0 55 | */ 56 | public function taxonomy_switcher_init() { 57 | 58 | if ( 59 | ! isset( $_GET[ 'taxonomy_switcher' ] ) 60 | || 1 != $_GET[ 'taxonomy_switcher' ] 61 | || ! current_user_can( 'manage_options' ) 62 | || ! isset( $_GET[ 'from_tax' ] ) 63 | || empty( $_GET[ 'from_tax' ] ) 64 | || ! isset( $_GET[ 'to_tax' ] ) 65 | || empty( $_GET[ 'to_tax' ] ) 66 | ) { 67 | return; 68 | } 69 | 70 | require_once( dirname( __FILE__ ) . '/Taxonomy_Switcher.php' ); 71 | 72 | $taxonomy_switcher = new Taxonomy_Switcher( $_GET ); 73 | 74 | $success_notices = $taxonomy_switcher->admin_convert(); 75 | 76 | if ( empty( $success_notices ) ) { 77 | return; 78 | } 79 | 80 | add_option( 'taxonomy-switcher-notices', $success_notices, null, 'no' ); 81 | wp_redirect( esc_url_raw( add_query_arg( 'page', $this->ui->admin_slug, admin_url( '/tools.php' ) ) ) ); 82 | 83 | } 84 | 85 | /** 86 | * Show Notices for taxonomy switch. 87 | * 88 | * @since 1.0.0 89 | */ 90 | public function do_admin_notice() { 91 | echo '

    '. implode( '

    ', $this->notices ) .'

    '; 92 | delete_option( 'taxonomy-switcher-notices' ); 93 | } 94 | } 95 | $Taxonomy_Switcher_Init = new Taxonomy_Switcher_Init(); 96 | -------------------------------------------------------------------------------- /wp-cli.php: -------------------------------------------------------------------------------- 1 | 18 | * : The Taxonomy to switch from. 19 | * 20 | * --to= 21 | * : The Taxonomy to switch to. 22 | * 23 | * [--parent=] 24 | * : The term parent to limit by. 25 | * 26 | * [--terms=] 27 | * : Comma separated list of term ids to switch. 28 | * 29 | * ## EXAMPLES 30 | * 31 | * wp taxonomy-switcher convert --from=category --to=post_tag 32 | * wp taxonomy-switcher convert --from=category --to=post_tag --parent=123 33 | * wp taxonomy-switcher convert --from=category --to=post_tag --terms=1,2,13 34 | * 35 | * @synopsis --from= --to= [--parent=] [--terms=] 36 | * @param array $args Args. 37 | * @param array $assoc_args Args. 38 | */ 39 | public function convert( $args, $assoc_args ) { 40 | 41 | $args = $this->map_arg_names( $assoc_args ); 42 | $tax_switcher = new Taxonomy_Switcher( $this->map_arg_names( $assoc_args ) ); 43 | 44 | $count = $tax_switcher->count(); 45 | 46 | if ( ! $count ) { 47 | WP_CLI::error( $tax_switcher->notices( 'no_terms' ) ); 48 | } 49 | 50 | WP_CLI::log( $tax_switcher->notices( 'switching' ) ); 51 | 52 | if ( 0 < $tax_switcher->parent ) { 53 | WP_CLI::log( $tax_switcher->notices( 'limit_by_parent' ) ); 54 | } 55 | 56 | if ( ! empty( $tax_switcher->terms ) ) { 57 | WP_CLI::log( $tax_switcher->notices( 'limit_by_terms' ) ); 58 | } 59 | 60 | set_time_limit( 0 ); 61 | 62 | $tax_switcher->convert(); 63 | 64 | WP_CLI::success( $tax_switcher->notices( 'switched' ) ); 65 | 66 | } 67 | 68 | /** 69 | * Map args to a new array. 70 | * 71 | * @since 1.0.0 72 | * 73 | * @param array $args Array of args to map. 74 | * @return array 75 | */ 76 | protected function map_arg_names( $args ) { 77 | $tomap = [ 78 | 'to' => 'to_tax', 79 | 'from' => 'from_tax', 80 | ]; 81 | $newargs = []; 82 | foreach ( $args as $key => $value ) { 83 | if ( array_key_exists( $key, $tomap ) ) { 84 | $newargs[ $tomap[ $key ] ] = $value; 85 | } else { 86 | $newargs[ $key ] = $value; 87 | } 88 | } 89 | return $newargs; 90 | } 91 | } 92 | 93 | WP_CLI::add_command( 'taxonomy-switcher', 'Taxonomy_Switcher_Command' ); 94 | --------------------------------------------------------------------------------