Skip to content

Taxonomy

Oleg Ivanchenko edited this page Oct 18, 2026 · 5 revisions

Taxonomy

oCMS provides two types of taxonomy for organizing content: categories and tags.

Categories

Categories provide hierarchical content organization:

  • Nested Structure — Create parent-child category hierarchies for tree-based navigation
  • Category Pages — Each category has a public page listing its content at /category/{slug}
  • Translation — Categories can be translated into multiple languages (see Multi-Language)
  • Admin Management — Full CRUD at /admin/categories; siblings are ordered by position, then name; set the position in the category form, through the REST API (position) or by an import

Tags

Tags provide flat (non-hierarchical) content classification:

  • Flexible Labeling — Add multiple tags to any page
  • Tag Pages — Each tag has a public page listing tagged content at /tag/{slug}
  • Translation — Tags can be translated into multiple languages
  • Admin Management — Full CRUD at /admin/tags

Post subscriptions

Categories provide /category/{slug}/rss.xml and /category/{slug}/atom.xml; tags provide /tag/{slug}/rss.xml and /tag/{slug}/atom.xml. Each subscription contains up to 20 published posts after language, taxonomy and visibility filtering. Other active languages use their URL prefix, for example /ru/category/tech-ru/rss.xml. Missing terms and terms from another language return 404. Archive layouts advertise these contextual links. See Feeds.

API Access

Both categories and tags are accessible via the REST API:

# List categories (returns tree structure)
curl http://localhost:8080/api/v2/categories

# List tags
curl http://localhost:8080/api/v2/tags

Admin Features

The tag list supports:

  • Bulk Actions — Multi-select and bulk delete (see Admin Interface)
  • Sorting — Sort by name, language, usage count or creation date
  • Pagination — Configurable items per page

The category list shows the whole tree on one page, without bulk actions, sorting or pagination.

Clone this wiki locally