Home > PrestaShop 1.7 > Core Reference > Components > Form > Types Reference > CategoryChoiceTreeType

Table of Contents

Warning: You are browsing the documentation for PrestaShop 1.7, which is outdated.

You might want to read an updated version of this page for the current version, PrestaShop 8. Read the updated version of this page

Learn how to upgrade to the latest version.

CategoryChoiceTreeType

CategoryChoiceTreeType is a child of MaterialChoiceTreeType, it extends parent options with options listed bellow. It is used to display category tree selection box and requires Javascript components.

Type options

Option	Type	Default value	Description
choices_tree	array	Array of all available categories	Values to choose from in choices tree
choice_label	string	`name`	An array key which should be targeted in provided choices list to get the label for input
choice_value	string	`id_category`	An array key which should be targeted in provided choices list to get the value for input

Required Javascript components

Component	Description
../admin-dev/themes/new-theme/js/components/form/choice-tree.js	Responsible for choice tree expanding and collapsing interactivity

Code example

<?php
// path/to/your/CustomType.php

use PrestaShopBundle\Form\Admin\Type\CategoryChoiceTreeType;
use Symfony\Component\Form\AbstractType;

class CustomType extends AbstractType
{
   public function buildForm(FormBuilderInterface $builder, array $options)
   {
        // you can disable some categories selection in choice tree
        $disabledCategories = [
            2, // category id
        ];
        $builder
            ->add('category_id', CategoryChoiceTreeType::class, [
                'disabled_values' => $disabledCategories,
            ])
        ;
    }    
}

Preview example

CategoryChoiceTree rendered in form example