An experimental, Views-based taxonomy manager:
* browse large taxonomies (assumes non-hierarchical vocabularies)
* filter using Search API Database search (offers English stemming) or Search API Solr
* e.g. performer matches perform, performer, performance
* apply Views Bulk Operations actions to terms
* merge multiple terms to a single term
* move term to a different vocabulary

Currently assumes use in the context of Islandora (https://islandora.ca).

Post-Installation

If you manage your site dependencies via Composer then this module's dependencies will be installed automatically once the module itself is installed via Composer.

After enabling the module, ensure all terms are indexed in the CCA Taxonomy Manager Term index `/admin/config/search/search-api/index/cca_taxonomy_manager_term_index`

Browe a taxonomy via path such as `/admin/structure/taxonomy/manage/{vocabulary}/cca-search`, e.g. `/admin/structure/taxonomy/manage/person/cca-search`.

Ensure the "Merge taxonomy terms" permission is assigned appropriately.

@todo: check if it is necessary to ensure users managing terms have Fedora Admin role to persist term changes into fcrepo.

1. To move a term, browse or search within `/admin/structure/taxonomy/manage/{vocabulary}/cca-search` to locate the term(s).
1. Check the (views bulk operations) checkbox on left of terms table.
1. Choose "Move term" option from Action select widget.
1. Click "Apply to selected items" button.
1. Choose target vocabulary from select widget.
1. Click "Apply" button.
1. A batch process will start, "Performing Move term on selected entities"...

_Warning: term move does not account for hierarchies, nor does it account for the possible difference in fields assigned to taxonomy terms in different vocabularies._

@todo: define what will survive a move, e.g. term name, description.

1. To merge one or more terms, browse or search within `/admin/structure/taxonomy/manage/{vocabulary}/cca-search` to locate the term(s) to be merged (but not the target term).
1. Check the (views bulk operations) checkbox on left of terms table.
1. Choose "Merge terms" option from Action select widget.
1. Click "Apply to selected items" button.
1. Choose target term from Existimg term autocomplete widget.
1. Click "Apply" button.

_Warning: the patch for term_reference_change must be applied in order to update reference in typed_relation fields (e.g. Islandora Object Linked Agent field)._

_Warning: redirects are not added automatically, e.g. from old term to target term._

### Override taxonomy term list
e.g. for a vocabulary `tags`:
1. Visit view edit for CCA Taxonomy Manager search `/admin/structure/views/view/cca_taxonomy_manager_search/edit/admin_page`
2. Duplicate page:
3. On new display, set machine_name=tags`; this needs to match the machine name of the taxonomy that we are overriding the term listing for.
4. Set path=`admin/structure/taxonomy/manage/tags/overview` (this is the path of the core term listing for tags)
5. Set Menu to be Type=Menu tab, Menu link title=List, Parent=Structure > Taxonomy > Tags, Weight=-5 (i.e. under the default vocabulary list menu item)
6. Click "Save" button.
7. Visit `admin/config/cca_taxonomy_manager/settings`, check Keywords `tags`, click "Save configuration".
8. Now visit `admin/structure/taxonomy/manage/tags/overview` to confirm List display is from CCA Taxonomy Manager `tags` display instead of the Drupal core taxonomy term listing.

To override additional taxonomy term lists, repeat the process of (a) add a view display, (b) adding a new menu tab for the List item, (c) updating CCA Taxonomy Manager settings to specify the taxonomy.

## Known issues

* Page title on cca-search view is vocabulary machine name, not human label.

Additional Requirements

This module is a Drupal feature, and requires:

* controlled_access_terms
* controlled_access_terms_defaults
* csv_serialization
* rest
* search_api
* search_api_db
* search_api_solr
* serialization
* taxonomy
* term_merge
with patch from https://www.drupal.org/project/term_merge/issues/3089426#comment-14179070 for Create Action for Views Bulk Operations
* term_reference_change
with patch from https://git.drupalcode.org/project/term_reference_change/-/merge_request... for merging references in typed_relation fields
* user
* views
* views_bulk_operations
* views_data_export

Recommended modules/libraries

Use with Search API Solr for improved search (e.g. use keyword matching suited to person names).

Similar projects

See also https://www.drupal.org/project/taxonomy_manager

CCA Taxonomy Manager

Top 1 contributors

Issues