快捷蛋糕（快速代码UI）
撰稿人： FusionEngineering，Mattheu，Danielbachhuber，Zebulonj，Goldenapples，Jitendraharpalani，Sanchothefat，Bfintal，Bfintal，Davisshaver，Garyj，Garyj，Mte90，Mte90，Fredserva，Fredserva，Fredserva，Fredserva，Khromov，Khromov，Bronnquick，dashalunaquick，dashalunaa，scravn ternklark，mehnkclknkclk，krknkclky，krknkigl，krknkigl，krkigl ,，
标签：短代码
至少需要： 4.5
测试到： 5.0.3
稳定标签： 0.7.4
许可证： GPLV2或更高版本
许可URI： http：//www.gnu.org/licenses/gpl-2.0.html
快捷蛋糕将使用WordPress短码制成一块蛋糕。
描述
与add_shortcode一起使用，ShortCake提供了一个用户友好的接口，用于将短码添加到帖子中，并在内容编辑器中查看和编辑。
安装插件后，您需要为短代码注册UI。为了获得灵感，请查看野外快捷蛋糕的例子。
要报告错误或功能请求，请使用GitHub问题。
安装
可以像任何其他WordPress插件一样安装酥饼。
完成此操作后，您需要为代码注册UI。
0.4.0中的新功能是将JavaScript函数附加到事件属性更新的能力。操作钩可用于根据另一个值的值动态显示或隐藏字段，或实现自定义验证规则。
常见问题
如何将UI注册为任意键/值对作为短代码属性？
快捷蛋糕不支持自定义键=>值对作为短代码属性，因为它不是一个很好的用户体验。
升级到折蛋糕0.7.x之后，一些短代码UI字段（邮政选择，用户选择等）无法按预期工作。我能做些什么？
在版本0.7.0中，我们更新到Select2库的最新分支，该分支在这些字段类型中提供了增强的选择字段。这会导致已知的与插件发生的冲突，该插件会导致Select2的较旧版本。 （具有已知冲突的流行插件包括WooCommerce和Advanced Custom Fields Pro等。）
如果发现自己与这些插件发生冲突，可以通过在wp-config.php中定义常数SELECT2_NOCONFLICT （或在“ init”挂钩之前定义的任何地方。
define( 'SELECT2_NOCONFLICT', true );
运行测试
我们使用PHP的PHP测试覆盖范围，并使用Jasmine具有JavaScript。
本地运行测试
茉莉测试可以使用grunt jasmine进行，也可以作为grunt scripts任务的一部分运行。要更新茉莉测试套件使用的核心WordPress文件，请运行grunt updateJasmineCoreScripts --abspath="/path/to/wordpress-install" 。
屏幕截图
1。如果没有酥油，短码的UI最小。
2。但是，使用快捷蛋糕，Tinymce将在Tinymce视图中渲染短码。
3。并添加一个用户友好的UI来编辑短代码内容和属性。
4。通过“添加媒体”向您的帖子中添加新的短代码。
升级通知
0.4.0
我们已删除了placeholder符属性参数的兼容性垫片。您应该使用meta参数为您的字段注册一个占位符。
0.3.0
我们已删除了神奇content属性的兼容性垫片。如果您使用它来支持编辑内部内容，则需要更改UI注册以使用inner_content 。
ChangElog
0.7.4（2019年1月16日）
- 块编辑器的兼容性：防止模板在文档头之前输出，该模板迫使浏览器进入QuirksMode，从而破坏了块编辑器中的某些CSS样式。
- 错误修复：以上错误文件。
- 错误修复：修复JavaScript错误，如果任何短代码包含一个没有可见选项且没有默认设置的选择字段，该错误将导致插入Post Element模式为空白。
- 错误修复：修复一个错误，其中插入后元素后，媒体控制器中的“选择文件”按钮变得无反应。
- 增强：添加可以将可选的“允许清晰”字段属性传递到Select2字段（发布，用户或术语选择），以便可以单击一次多选字段。 （此选项默认为OFF，不应影响现有字段。）
0.7.3（2017年9月5日）
- 安全性：在AJAX渲染短代码回调中使用NONCE验证来防止CSRF。
- 错误修复：确保在所有字段类型上相同的JS挂火。
- 错误修复：修复了影响多个选择字段的错误（设置后无法设置值，并且无法设置多个默认值）。
- 错误修复：防止包含2％字符的编码字段破裂。
- 错误修复：修复一些问题，其中媒体模态状态在不保存的情况下关闭了短码，则无法正确重置。
- 错误修复：支持案例，其中页面上有多个WP_Editor实例，并确保将要编辑的短代码发送到正确的页面。
- 增强：当post_select字段从多个帖子类型中选择时，请在邮政名称旁边显示帖子类型，以更轻松地选择。
- 增强：显示任何附件类型的附件缩略图，而不仅仅是图像。
- 增强：如果没有使用快捷蛋糕UI的快捷代码注册，请添加更多有用的错误消息。
- 更新挪威翻译
0.7.2（2017年4月24日）
- 错误修复：修复WordPress 4.7.4中的行为，其中编辑短码会将新的短码插入编辑器中，而不是更新正在编辑的短码。
- 错误修复：用于逃脱百分比（％）字符的替换仅取代了首次出现
- 错误修复：对于具有多重= true的选择字段，默认情况下允许选择多个选项
- 为附件字段模板中的所有字符串添加了I18N
- 添加了芬兰翻译
0.7.1（2017年3月16日）
- 更改短代码格式以在自封落后斜线之前添加一个空间。
- 修复用长文件名的附件预览的对齐。
- 错误修复：在选择字段上设置一个初始值（以前，除非用户与字段进行交互，否则不会为选择字段设置值）。
- 增强/修复：重复使用媒体模式的一份副本并在关闭时重置其状态，而不是每次访问模态时都会创建重复标记。
- 兼容性：使用select2.js 4.0.3的“完整”版本来防止插件与其他期望完整版本的插件发生冲突。
- 兼容性：将
SELECT2_NOCONFLICT标志添加到在唯一名称空间中加载Select2，以防止与加载Select2.js版本3的其他插件发生冲突。 - 添加了挪威翻译。
- 多个编码样式修复。
0.7.0（2016年11月18日）
- 将“添加帖子元素”按钮添加到媒体按钮 - 一单击以打开短代码列表，而不是单击“添加媒体”按钮，然后在菜单中查找“插入帖子元素”。
- 添加了“术语选择”字段类型。
- 添加了“用户选择”字段类型。
- 在渲染/编辑/关闭短码时添加了新钩子，该钩子可用于需要自定义JavaScript初始化或清理的现场类型。
- 选择字段：为多个选择字段添加全部支持。
- 选择字段：支持选项的自定义排序。
- 选择字段：
<optgroup> s中的支持分组选项通过将其作为嵌套数组传递。 - 附件字段：支持多重选择。
- 附件字段：支持SVG图像（如果SVG上传是由插件或主题启用）。
- 错误修复：使用
encode=true指定的解码字段时处理百分比符号。 - 错误修复：修复问题，其中在编辑器中需要两次单击短码来提出编辑短代码模式。
- 错误修复：修复问题在按名称搜索短代码时，如果多个短代码从搜索字符串开始，则仅返回第一个。
- 错误修复：如果属性不是空的，则仅在属性上输出描述字段。
- 兼容性：卸下用于处理WP 4.1和4.2中介质模式的垫片。
- 兼容性：将Select2库升级到4.0.3，以避免与使用最新版本的Select2的其他插件发生冲突。
- 添加了土耳其翻译。
- 添加了芬兰翻译。
- 添加了瑞典翻译。
- 添加了匈牙利翻译。
0.6.2（2015年11月12日）
- 错误修复：收音机和复选框上的“更改”事件的“更改”事件，以确保更新快点属性。
- 错误修复：在调用get_shortcodes（）之前，请始终运行
register_shortcode_ui 。修复使用register_shortcode_ui挂钩时选择AJAX回调。
0.6.1（2015年11月9日）
- 单击媒体框架菜单项时，请修复JavaScript TypeError。
- 更正读书中的链接。
0.6.0（2015年11月2日）
- 支持可选的
encode=true参数的属性，以允许有限的HTML支持。需要通过shortcode_atts()运行属性才能正确解码。 - 在呈现快捷代码预览时，定义了
SHORTCODE_UI_DOING_PREVIEW常数，它使回调能够在Tinymce中提供不同的短代码表示。 - 当已经为短代码属性选择附件时，将选择“开放媒体库”。
- 清理插入元件UI中的图标垂直对齐。
- 将CSS实用程序类添加到所有字段HTML。例如，附件字段现在用
shortcode-ui-field-attachment包裹。 - 添加了过滤器，以修改有关注册的短码UI参数。
- 清理了示例插件，因此它是一个更有用的开发人员参考。
- 使用Core的JavaScript Regex来解析快速代码，而不是维护单独的正则正则。
- 允许HTML进入现场标签和描述。
- 丹麦翻译添加了。
- 添加了意大利翻译。
- 添加了德语翻译。
- 核心集成：完全支持PHP 5.2。
- 错误修复：当没有UI注册时，持续的短代码属性和内部内容。以前，它们会被丢弃。
- 错误修复：在邮政选择字段上显示描述。
- 错误修复：属性字段更改事件绑定到
input事件，而不是keyup 。 - 完整的发行说明
0.5.0（2015年8月26日）
- 附件字段：通过单击缩略图更改附件变得更容易；在现场视图中添加了附件元数据。
- 附件字段：重构JavaScript以触发事件。
- 添加了
range输入类型。 - 引入了用于插件的
register_shortcode_ui钩，以更安全地使用。 - 删除了预览选项卡，以使快捷蛋糕的用户体验更接近Core，在这种情况下，Inline Visual Preview优于媒体模式中的单独预览。
- 使用Jshint清理JavaScript。
- 俄罗斯翻译添加了。
- 添加了葡萄牙翻译。
- 在所有类中添加了PHPDOC。
- 错误修复：即使未定义UI，也可以使用
inner_content 。 - 错误修复：在快捷蛋糕视图中击中ESC现在将关闭模式。 （固定在核心。）
- 错误修复：在Visual Editor中选择快捷蛋糕预览时，点击删除现在会导致删除短码。 （固定在核心。）
- 错误修复：短蛋糕的“搜索”功能在小屏幕尺寸上与短码网格不再在视觉上发生冲突。 （固定在核心。）
- 错误修复：使用
get_post_type()代替get_current_screen()->post_type因此在前端上正确设置了上下文。 - 完整的发行说明
0.4.0（2015年6月22日）
- 使用Carldanley/WP-JS钩作为基本API在短代码属性上注册JS回调。
- 附件预览正在加载时，附件字段使用加载指示器。
- 添加了中文翻译。
- 添加了法语翻译。
- 添加了西班牙语翻译。
- 错误修复：防止何时将编辑器加载在前端上下文中。
- 错误修复：颜色字段还支持
meta参数。 - 错误修复：从没有属性的短代码中删除尾随的空格。
- 错误修复：删除编辑器CSS路径中的双斜杠。
- 完整的发行说明
0.3.0（2015年4月27日）
- 打破变化：我们已删除了神奇
content属性的兼容性垫片。如果您使用它来支持编辑内部内容，则需要更改UI注册以使用inner_content 。 - 新的
post_select字段类型，用于从帖子列表中选择。支持其他query参数以修改搜索查询。 - 使用新的
post_type参数，可以为特定的帖子类型注册快捷代码UI。如果您希望给定短代码的UI仅出现在特定帖子类型上，这将很有帮助。 - 对于每个短代码属性，可以指定一个
meta参数将任意HTML属性添加到字段中。我们为现有的placeholder论点添加了兼容性。此兼容性将在v0.4中删除。 - 插入短代码时，UI显示短代码没有要配置的属性时会显示有用的消息。以前，向用户提供了一个相对空白的屏幕。
- 我们的示例插件可以通过WordPress管理员激活。
- 单击左菜单中的“插入帖子元素”有效地充当选择快捷代码的后按钮。
- 围绕编辑体验的语言反映了您正在编辑的短代码。例如，使用Plupquote快速代码，“编辑帖子元素”将变成“编辑plupquote”。
- 添加了荷兰翻译。
- 源JavaScript文件移至
js/src以在源和构建的JavaScript之间清晰。 - 使用php_codesniffer扫描PHP文件。
- 错误修复：适当支持未引用的短代码属性。
- 错误修复：附件字段正确注册依赖项。
- 错误修复：“插入帖子元素”经验在禁用视觉编辑器时应起作用。酥油仅与丁香菌松散结合。
- 错误修复：编辑器样式已加载在
after_setup_theme上以防止致命。 - 完整的发行说明。
0.2.3（2015年4月8日）
- 通过还原传递给Tinymce视图兼容性的参数来解决WP 4.1向后兼容问题。
0.2.2（2015年4月6日）
- 更新参数传递给WP 4.2兼容性的Tinymce视图渲染。以前通过的参数不是必需的，因此删除不会使向后兼容。
0.2.1（2015年3月18日）
- 确保在WP中使用jQuery尊重jQuery.noconflict（）模式。
0.2.0（2015年3月18日）
- JS使用浏览器抽象。
- “添加帖子元素” UI的增强功能：按字母顺序排序的短代码；基于标签搜索。
- 选择包括iframes的快速码预览更容易。
- WordPress 4.2兼容性。
- 添加了彩色选择器到潜在字段的列表。
- 错误修复：IE11兼容性。
- 错误修复：复选框字段现在可以取消选中。
- 完整的发行说明。
0.1.0（2014年12月23日）
- 支持表单字段的所有HTML5输入类型。
- 编辑体验中的短代码预览选项卡。 }*围绕“帖子元素”重新标记了UI，这比“内容项目”更具描述性。
- 许多错误修复。
- 完整的发行说明。
