README

适用于cake 2.x

将TinyMCE放置在插件中是为了使其与主题视图、常规webroot或应用程序本身分开，这使得更新更容易，并且整体上遵循保持代码清洁和模块化的理念。

要使用TinyMCE，您需要克隆git仓库

git clone git://github.com/CakeDC/TinyMCE.git Plugin/TinyMCE

或者，如果您的CakePHP应用程序已设置为git仓库，您可以将其添加为子模块

git submodule add git://github.com/CakeDC/TinyMCE.git Plugin/TinyMCE

或者，您可以从Github的2.0分支下载存档，并将其内容提取到Plugin/TinyMCE。

TinyMCE助手基本上只是一个方便的助手，允许您使用PHP和CakePHP约定来生成TinyMCE的配置，并且作为额外功能，它还允许您加载配置。

您可以使用两种方式使用此插件，简单地使用助手或手动加载编辑器

$this->Html->script('/TinyMCE/js/tiny_mce/tiny_mce.js', array('inline' => false);

并将自己的脚本放在页面的头部。请注意，如果使用助手，助手将自动将TinyMCE编辑器脚本添加到页面的头部。如果使用助手，无需手动添加。

如果您的应用程序未设置在宿主/的最高级别工作，而是在/yourapp/中工作，则自动包含脚本将不起作用。您将必须手动将js文件添加到应用程序中

$this->Html->script('/yourapp/TinyMCE/js/tiny_mce/tiny_mce.js', array('inline' => false);

如何使用助手

从CakePHP 2.0开始，在应用程序中激活插件是必要的。为此，编辑app/Config/bootstrap.php并在底部添加一行CakePlugin::load('TinyMCE');。如果您已经有CakePlugin::loadAll();来自动加载所有插件，则可以跳过此步骤。

您想在哪个地方使用它，就在控制器中加载它

$this->helpers = array('TinyMCE.TinyMCE');

在视图中，只需使用editor()方法并传递数组中的config键/值对。

$this->TinyMCE->editor(array('theme' => 'advanced', 'mode' => 'textareas'));

这将指示TinyMCE将页面上所有的textarea元素转换为TinyMCE编辑器。如果您需要更精确的控制或想要更改此行为，请参阅TinyMCE网站上的TinyMCE配置选项。

助手的高级使用

多配置

助手有一个名为configs的属性，可以从数据库或配置文件中填充数据。如何存储、获取并将这些数据传递给助手取决于您。助手的configs属性接受一个具有命名键的数组，键用于加载配置。

以下是一个基本配置数据的示例

$configs = array(
		'simple' => array(
			'mode' => 'textareas',
			'theme' => 'simple',
			'editor_selector' => 'mceSimple'
		),
		'advanced' => array(
			'mode' => 'textareas',
			'theme' => 'advanced',
			'editor_selector' => 'mceAdvanced'
		)
);

$this->TinyMCE->configs = $configs;

您也可以将配置放入APP/config/bootstap.php或其他配置文件中并加载它。在配置文件中，您可以将配置写入TinyMce配置，如下所示

Configure::write('TinyMCE.configs', array(
		'simple' => ...,
		'advanced' => ...));

助手将自动在构造函数内部加载不同的配置数据集。建议您使用这种方式向助手传递不同的配置，因为这样您可以将其全部存储在一个地方。

当您向助手传递配置时，您可以通过调用助手的editor()方法并传递一个与数组中配置键相等的字符串来简单地使用它

$this->TinyMCE->editor('simple'); // This matches the 'simple' config name we passed in earlier.

应用程序范围的默认选项

如果您想快速配置应用程序中所有TinyMCE编辑器的默认值，可以使用'TinyMCE.editorOptions'配置。

以下是在bootstrap.php中可以有的示例行

Configure::write('TinyMCE.editorOptions', array('height' => '300px'))

这将使所有编辑器都具有300px的高度。您可能希望为单个编辑器覆盖此值。要这样做，只需将选项传递给editor()方法，它将覆盖默认值。

您始终可以检查测试来查看如何使用辅助工具。

要求

PHP版本：PHP 5.2+
CakePHP版本：CakePHP 2.0+
jQuery JavaScript库 https://jqueryjs.cn/

特殊依赖注意事项

此插件依赖于jQuery (https://jqueryjs.cn)，因此您需要确保它在您想要显示编辑器的布局或视图中已加载。以下是如何在布局中加载jQuery的示例：<?php ...

	echo $this->Html->script(array('https://ajax.googleapis.ac.cn/ajax/libs/jquery/1.7.2/jquery.min.js'));

	...

	echo $this->fetch('script');
?>

当然，您也可以像这样从您的app/webroot/js文件夹中复制jQuery库

<?php
	...
	
	echo $this->Html->script(array('jquery.min'));

	...

	echo $this->fetch('script');
?>

支持

有关支持和功能请求，请访问TinyMCE插件支持网站。

有关我们专业CakePHP服务的更多信息，请访问Cake Development Corporation网站。

分支策略

master分支包含插件的稳定最新版本。开发分支是不稳定的，用于在发布之前测试新功能。

之前的维护版本以与CakePHP兼容的版本命名，例如，分支1.3是与CakePHP 1.3兼容的维护版本。所有版本都更新了安全补丁。

为插件做出贡献

请随时通过新的问题、请求、单元测试和代码修复或新功能为插件做出贡献。如果您想贡献一些代码，请从开发分支创建一个功能分支，并向我们发送您的pull请求。新功能和检测到的问题的单元测试是强制性的，以保持高质量。

许可证

许可协议：GNU Lesser General Public License
文件再分发必须保留上述版权声明。

分支策略

master分支包含插件的稳定最新版本。开发分支是不稳定的，用于在发布之前测试新功能。

之前的维护版本以与CakePHP兼容的版本命名，例如，分支1.3是与CakePHP 1.3兼容的维护版本。所有版本都更新了安全补丁。

ryu818 / tiny-mce

维护者

详细信息

README

如何使用助手

助手的高级使用

多配置

应用程序范围的默认选项

要求

特殊依赖注意事项

支持

分支策略

为插件做出贡献

许可证

分支策略

为插件做出贡献

版权