Taxonomy and tagging
What is taxonomy?
Taxonomy allows you to categorise content by keywords on UQ Standard websites. You can tag content with a taxonomy term and then display all content that shares that term on a page.
Taxonomy terms are group into categories called vocabularies. UQ Standard websites have a default set of standard UQ-wide categories. Site coordinators can request additional categories for their sites, if required.
Taxonomy terms can be used:
- in staff directories using the 'Person' content type to filter lists by staff group (e.g. professional, academic etc.)
- on research profiles to show related projects
- in the catalogue to organise content
- on panel pages to display a filtered view of content.
How to create a taxonomy term
Taxonomy terms can be created by:
- site coordinators.
To create a new term and add it to a vocabulary:
- From the black Drupal menu at the top of the screen, select 'Structure' > 'Taxonomy'.
- Select the vocabulary you want to add the term to and select 'Add term'.
- Enter a title for your term.
- Select 'Save' to save your term.
How to tag content
Content can be tagged by :
- editors
- site coordinators.
When editing a page to tag the page with a term, select the relevant term from the 'Tags' drop-down menu.
How to display content by taxonomy term
Panel pages use 'views' to display content filtered by taxonomy terms.
Views can be configured by:
- site builders.
Before adding a view to a panel page, you'll need to find the ID of the taxonomy term you want to use to filter content.
To find a taxonomy term ID:
- In the black Drupal menu at the top of the page, select 'Structure' > 'Taxonomy'.
- Select the relevant vocabulary.
- Hover over the 'Edit' link to the right of the relevant taxonomy term.
- In the bottom left corner of your browser, the URL for the taxonomy term will pop up while you hover. The number at the end of this URL is the taxonomy term ID.
Once you have the ID, add a vertical content list to your panel page to display a list of filtered content.
How to restrict vocabularies
Vocabularies can be restricted for use on specific content types by:
- site coordinators.
Use the in-place editor to restrict vocabularies:
- From the black Drupal menu at the top of the screen, select 'Structure' > 'Taxonomy'> 'Term Select Filter'.
- Check the boxes next to the vocabularies you want to make available for that content type.
- Click the ‘Save Filters’ button at the bottom of the page.
If you don’t select anything from the list, all taxonomy terms from all vocabularies will be available for that content type.
How to access taxonomy term listing pages
Each taxonomy term has a listing page that displays all content tagged with that term.
To view a taxonomy term page, add /[vocabulary name]/[term name] to the end of your site's URL (e.g. https://hass.uq.edu.au/funding-source/uniquest).
Taxonomy term page URLs are stripped of joining words like ‘a’, ‘the’, ‘of’ and spaces are replaced with hyphens.
If you're a site coordinator, you can also view taxonomy term pages through Drupal:
- From the black Drupal menu at the top of the screen, select 'Structure' > 'Taxonomy'.
- Find the relevant vocabulary and select 'list terms'.
- Click on the relevant term and it will link to the term page.
Best practice
- Keep your taxonomy term names short.
- If your content doesn't fit within the standard categories, submit an IT request to have additional vocabularies added for different topic areas.
- Don’t tag content by date.