快捷蛋糕（快速代碼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，這比“內容項目”更具描述性。
- 許多錯誤修復。
- 完整的發行說明。
