README

注意：目前这是一个针对 CakePHP 3.x 的非稳定插件。它目前正在开发中，应被视为实验性的。

安装

您可以使用 composer 将此插件安装到您的 CakePHP 应用程序中。

安装 composer 包的推荐方法是

composer require leoruhland/cakephp-fieldtypes

现在使用以下命令加载插件

bin/cake plugin load -r -b FieldTypes

用法

您可以使用 FieldTypes 扩展核心 FormHelper 并使用 BootstrapUI.Form 设置您想要使用的部件。

$this->loadHelper('Form', [
    'className' => 'BootstrapUI.Form',
    'widgets' => [
        //Date
        'flatpickr' => ['FieldTypes\View\Widget\FlatpickrWidget', '_view'],
        'bootstrap-datepicker' => ['FieldTypes\View\Widget\BootstrapDatepickerWidget', '_view'],
        'bootstrap-datetimepicker' => ['FieldTypes\View\Widget\BootstrapDatetimepickerWidget', '_view'],

        //Color
        'bootstrap-colorpicker' => ['FieldTypes\View\Widget\BootstrapColorpickerWidget', '_view'],

        //Number
        'bootstrap-touchspin' => ['FieldTypes\View\Widget\BootstrapTouchspinWidget', '_view'],

        //Boolean
        'bootstrap-switch' => ['FieldTypes\View\Widget\BootstrapSwitchWidget', '_view'],

        //Content
        'summernote' => ['FieldTypes\View\Widget\SummernoteWidget', '_view'],
        'wysiwygjs' => ['FieldTypes\View\Widget\WysiwygjsWidget', '_view'],

        //Select
        'bootstrap-select' => ['FieldTypes\View\Widget\BootstrapSelectWidget', '_view'],
        'select2' => ['FieldTypes\View\Widget\Select2Widget', '_view'],

        //Other
        'stringtoslug' => ['FieldTypes\View\Widget\StringToSlugWidget', '_view'],
        'textcount' => ['FieldTypes\View\Widget\TextCounterWidget', '_view'],
    ]
]);

您也可以覆盖默认部件。

$this->loadHelper('Form', [
    'className' => 'BootstrapUI.Form',
    'widgets' => [
        'date' => ['FieldTypes\View\Widget\FlatpickrWidget', '_view'],
        'select' => ['FieldTypes\View\Widget\Select2Widget', '_view']
    ]
]);

然后，使用它

$this->Form->input('some_field', ['type' => 'summernote']);

它与 CakeAdmin 的 表单字段 也很兼容。

public function postType() {
	return [
		'formFields' => [
			'some_field' => [
				'type' => 'summernote',
			],
		]
	];
};

类型

Select2 - GitHub

'type' => 'select2'

'type' => 'select2', 'multiple' => true

Summernote - GitHub

'type' => 'summernote'

Bootstrap Datepicker - GitHub

'type' => 'datepicker'

Bootstrap Colorpicker - GitHub

'type' => 'colorpicker'

Bootstrap TouchSpin - GitHub

'type' => 'touchspin'

Bootstrap Toggle - GitHub

'type' => 'toggle'

CakeAdmin

该插件与 CakeAdmin 兼容！