2017 © Pedro Peláez
 

contao-bundle contao-categories-bundle

This bundle allows to assign nestable categories to arbitrary entities in Contao-driven systems.

image

heimrichhannot/contao-categories-bundle

This bundle allows to assign nestable categories to arbitrary entities in Contao-driven systems.

  • Monday, July 16, 2018
  • by digitales@heimrich-hannot.de
  • Repository
  • 6 Watchers
  • 2 Stars
  • 807 Installations
  • PHP
  • 4 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 17 Versions
  • 71 % Grown

The README.md

Contao Categories Bundle

, (*1)

This bundle allows to assign nestable categories to arbitrary entities in Contao-driven systems., (*2)

Features

  • the module is done in a generic way, i.e. you can assign category/categories field(s) to arbitrary DCAs
  • conveniently add single category fields (radio button) or multiple categories fields (checkbox) via a simple function call
  • specify overridable properties in categories and compute the correct result depending on the given context easily
  • multilanguage support via heimrichhannot/contao-categories-multilingual-bundle
  • categories filter type for Contao Filter Bundle

Impressions

Category management

alt preview, (*3)

Main category management view. By clicking the cog icon you can navigate to the category configs., (*4)

Widget integration in your DCA

alt preview, (*5)

Add category fields to your DCA easily. The category marked as primary category is colored in green., (*6)

Picker widgets

alt preview, (*7)

Single category picker with radio buttons (selecting parent categories is allowed -> can be disallowed if necessary; no primary category marker necessary), (*8)

alt preview, (*9)

Single category picker with checkboxes (selecting parent categories is disallowed; the yellow asterisk marks the primary category -> this attribute is stored to an automatically created field named <categoriesFieldname>_primary), (*10)

Usage

Install

  1. Install bundle with composer or contao manager, (*11)

    composer require heimrichhannot/contao-categories-bundle
    
  2. Update database, (*12)

  3. Add category support to the datacontainer you want, e.g. news, (*13)

Filter bundle integration

This bundle comes with two filter types: - CategoryChoiceType let you select categories to filter a list. - 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)., (*14)

Entity structure

alt entities, (*15)

Table Description
tl_category Contains the category instances
tl_category_association Association table between tl_category and your DCA's table
tl_category_context Defines context keys (simple strings) usable in category configs
tl_category_config Contains category configs. Here you can override properties defined per default in a category linked with a certain category context
tl_category_property_cache Contains the resolved overridable property values

Documentation

Concepts, (*16)

Technical instructions, (*17)

Guide: News categories field, (*18)

The Versions

16/07 2018
30/05 2018
15/03 2018
05/03 2018
02/03 2018
15/02 2018
15/02 2018
14/02 2018
05/02 2018
24/01 2018
06/12 2017

1.0.0-beta

1.0.0.0-beta

This bundle allows to assign nestable categories to arbitrary entities in Contao-driven systems.

  Sources   Download

LGPL-3.0+

The Requires

 

The Development Requires