README

QCubed插件，简化Twitter Bootstrap的集成

安装

1. 使用Composer安装插件和Twitter Bootstrap。从主安装目录的命令行执行以下命令

	composer require kukrik/bootstrap
	composer require twbs/bootstrap v3.3.7

1. 接下来，你可能想修改bootstrap.cfg.php文件中的某些设置。在/project/includes/configuration/active中查找它

QCUBED_BOOTSTRAP_CSS

此文件的默认设置是

	define ('QCUBED_BOOTSTRAP_CSS', QCUBED_VENDOR_URL . '/twbs/bootstrap/dist/css/bootstrap.min.css');

如果你正在编译自己的自定义版本的bootstrap css文件，只需将此定义设置为指向你的版本。

1. 将基本类指向Bootstrap类，以便它们添加其功能。

在你的项目/qcubed/Control/ControlBase.php文件中，从Bootstrap Control类扩展。例如，你应该将第一行更改为

abstract class ControlBase extends QCubed\Bootstrap\Control 
{

QCUBED_BOOTSTRAP_JS

此插件中包含的默认机制仅在使用插件小部件并需要bootstrap.js的表单上加载bootstrap.js文件。如果你正在手动编码一些也需要bootstrap.js的bootstrap表单，你应该执行以下两个操作以避免加载多个bootstrap.js文件

1. 在bootstrap.cfg.php文件中定义QCUBED_BOOTSTRAP_JS并将其指向所需的bootstrap js文件，如下所示

	define ('QCUBED_BOOTSTRAP_JS', QCUBED_VENDOR_URL . '/twbs/bootstrap/dist/js/bootstrap.js'); (or bootstrap.min.js if you prefer)

1. 或者像这样将其添加到footer.inc.php文件中

	<script type="text/javascript" src="<?= QCUBED_BOOTSTRAP_JS ?>"></script>

或者像这样将其添加到QForm.class.php文件中的自动加载javascript表单列表中

	protected function getFormJavaScripts() {
		$scripts = parent::getFormJavaScripts();
		$scripts[] = QCUBED_BOOTSTRAP_JS;
		return $scripts;
	}

用法

请参阅示例页面以获取详细信息。主要功能包括

1. 使用RenderFormGroup而不是RenderWithName来以Bootstrap方式绘制表单对象。Bootstrap Control类公开了多个实用程序类，可以将Bootstrap类添加到对象、标签、包装器，甚至在某些特殊情况下的一些内部包装器。

2. 特定的Bootstrap类型控件来在屏幕上绘制特定内容。例如包括

• 轮播
• 导航栏
• 菜单按钮
• 警告
• 手风琴

1. 基础QCubed控件的扩展，增加了额外的Bootstrap功能。包括

• 复选框以Bootstrap方式绘制复选框，标签包裹复选框
• 文本框以添加将其绘制为与另一个对象内联组的能力

1. 定义，通过PHP常量提供对各种Bootstrap类名的便捷访问。这些位于Bootstrap.php文件中。