{"id":20961723,"url":"https://github.com/heimrichhannot/contao-categories-bundle","last_synced_at":"2025-05-14T07:30:58.559Z","repository":{"id":55650364,"uuid":"111789003","full_name":"heimrichhannot/contao-categories-bundle","owner":"heimrichhannot","description":"This bundle allows to assign nestable categories to arbitrary entities in Contao-driven systems.","archived":false,"fork":false,"pushed_at":"2024-07-25T15:48:24.000Z","size":550,"stargazers_count":4,"open_issues_count":2,"forks_count":1,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-13T10:07:59.978Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/heimrichhannot.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-11-23T09:23:15.000Z","updated_at":"2024-07-25T15:48:28.000Z","dependencies_parsed_at":"2023-01-31T06:45:26.869Z","dependency_job_id":null,"html_url":"https://github.com/heimrichhannot/contao-categories-bundle","commit_stats":null,"previous_names":[],"tags_count":52,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimrichhannot%2Fcontao-categories-bundle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimrichhannot%2Fcontao-categories-bundle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimrichhannot%2Fcontao-categories-bundle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heimrichhannot%2Fcontao-categories-bundle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/heimrichhannot","download_url":"https://codeload.github.com/heimrichhannot/contao-categories-bundle/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254094825,"owners_count":22013648,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-19T02:15:56.930Z","updated_at":"2025-05-14T07:30:57.113Z","avatar_url":"https://github.com/heimrichhannot.png","language":"PHP","readme":"# Contao Categories Bundle\n\n[![](https://img.shields.io/packagist/v/heimrichhannot/contao-categories-bundle.svg)](https://packagist.org/packages/heimrichhannot/contao-categories-bundle)\n[![](https://img.shields.io/packagist/dt/heimrichhannot/contao-categories-bundle.svg)](https://packagist.org/packages/heimrichhannot/contao-categories-bundle)\n\nThis bundle allows to assign nestable categories to arbitrary entities in Contao-driven systems.\n\n## Features\n\n- the module is done in a generic way, i.e. you can assign category/categories field(s) to arbitrary DCAs\n- conveniently add single category fields (radio button) or multiple categories fields (checkbox) via a simple function call\n- specify overridable properties in categories and compute the correct result depending on the given context easily\n- multilanguage support via [heimrichhannot/contao-categories-multilingual-bundle](https://github.com/heimrichhannot/contao-categories-multilingual-bundle)\n- categories filter type for [Contao Filter Bundle](https://github.com/heimrichhannot/contao-filter-bundle)\n\n## Impressions\n\n### Category management\n\n![alt preview](docs/categories.png)\n\nMain category management view. By clicking the cog icon you can navigate to the *category configs*.\n\n### Widget integration in your DCA\n\n![alt preview](docs/fields.png)\n\nAdd category fields to your DCA easily. The category marked as *primary category* is colored in green.\n\n### Picker widgets\n\n![alt preview](docs/radio-picker.png)\n\nSingle category picker with radio buttons (selecting parent categories is allowed -\u003e can be disallowed if necessary; no primary category marker necessary)\n\n![alt preview](docs/checkbox-picker.png)\n\nSingle category picker with checkboxes (selecting parent categories is disallowed; the yellow asterisk marks the primary category -\u003e this attribute is stored to an automatically created field named `\u003ccategoriesFieldname\u003e_primary`)\n\n## Usage\n\n### Install\n\n1. Install bundle with composer or contao manager\n\n   ```\n   composer require heimrichhannot/contao-categories-bundle\n   ```\n   \n1. Update database\n\n1. Add category support to the datacontainer you want, [e.g. news](docs/guide_news.md)\n\n### Filter bundle integration\n\nThis bundle comes with two filter types:\n- CategoryChoiceType let you select categories to filter a list. \n- ParentCategoryChoiceType is an inital filter to filter your list based on a parent category (means all elements are in a child category of the selected parent).\n\n## Entity structure\n\n![alt entities](docs/entities.png)\n\nTable | Description\n----- | -----------\ntl_category | Contains the *category* instances\ntl_category_association | Association table between tl_category and your DCA's table\ntl_category_context | Defines context keys (simple strings) usable in *category configs*\ntl_category_config | Contains *category configs*. Here you can override properties defined per default in a category linked with a certain *category context*\ntl_category_property_cache | Contains the resolved overridable property values\n\n## Documentation\n\n[Concepts](docs/concepts.md)\n\n[Technical instructions](docs/technical_intructions.md)\n\n[Guide: News categories field](docs/guide_news.md)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheimrichhannot%2Fcontao-categories-bundle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheimrichhannot%2Fcontao-categories-bundle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheimrichhannot%2Fcontao-categories-bundle/lists"}