Title: Customize Object Selector Author: Weston Ruter Published: 2016 年 9 月 7 日 Last modified: 2017 年 11 月 9 日 --- 搜尋外掛 ![](https://ps.w.org/customize-object-selector/assets/banner-772x250.png?rev=1499920) 這個外掛**並未在最新的 3 個 WordPress 主要版本上進行測試**。開發者可能不再對這個 外掛進行維護或提供技術支援，並可能會與更新版本的 WordPress 產生使用上的相容性問題。 ![](https://ps.w.org/customize-object-selector/assets/icon.svg?rev=1499920) # Customize Object Selector 由 [Weston Ruter](https://profiles.wordpress.org/westonruter/) 開發 [下載](https://downloads.wordpress.org/plugin/customize-object-selector.0.4.2.zip) * [詳細資料](https://tw.wordpress.org/plugins/customize-object-selector/#description) * [使用者評論](https://tw.wordpress.org/plugins/customize-object-selector/#reviews) * [開發資訊](https://tw.wordpress.org/plugins/customize-object-selector/#developers) [技術支援](https://wordpress.org/support/plugin/customize-object-selector/) ## 外掛說明 This plugin adds a Customizer control to select one or multiple posts (and eventually terms and users). Core has long had a `dropdown-pages` control type which is used in the static front page section for the “page on front” and “page for posts” controls. There is a problem with this control however: it outputs the entire tree of pages for every registered instance of the control. For sites that have a lot of pages, this can introduce a performance problem to generate this full list, not only once, but twice for the two controls. This plugin upgrades the “page on front” and “page for posts” controls to instead make use of the Customize Object Selector control, not only allowing for the list of pages to be loaded via Ajax on demand but also for the list to be _searched_. When the [Customize Posts](https://github.com/xwp/wp-customize-posts) plugin is active, buttons will appear after the Select2 control to be able to create new posts to add to the selection. The Customize Object Selector will also power the post parent control. See [wp-customize-posts#233](https://github.com/xwp/wp-customize-posts/pull/233). This plugin also includes a reusable JavaScript component available at `wp.customize. ObjectSelectorComponent` which can be used in widgets or other locations. For an example integration with widgets, see the [Post Collection widget](https://github.com/xwp/wp-js-widgets/pull/10). For an example integration with the Customize Posts plugin, see pending usage as the [Post Parent control](https://github.com/xwp/wp-customize-posts/pull/189#issuecomment-241216247). **Development of this plugin is done [on GitHub](https://github.com/xwp/wp-customize-object-selector). Pull requests welcome. Please see [issues](https://github.com/xwp/wp-customize-object-selector/issues) reported there before going to the [plugin forum](https://wordpress.org/support/plugin/customize-object-selector).** ## 使用者評論 這個外掛目前沒有任何使用者評論。 ## 參與者及開發者 以下人員參與了開源軟體〈Customize Object Selector〉的開發相關工作。 參與者 * [ Weston Ruter ](https://profiles.wordpress.org/westonruter/) * [ XWP ](https://profiles.wordpress.org/xwp/) [將〈Customize Object Selector〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/customize-object-selector) ### 對開發相關資訊感興趣？ 任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/customize-object-selector/)、 查看 [SVN 存放庫](https://plugins.svn.wordpress.org/customize-object-selector/)， 或透過 [RSS](https://plugins.trac.wordpress.org/log/customize-object-selector/?limit=100&mode=stop_on_copy&format=rss) 訂閱[開發記錄](https://plugins.trac.wordpress.org/log/customize-object-selector/)。 ## 變更記錄 #### 0.4.2 – 2017-11-01 * Bump minimum WP to 4.7 and indicated tested up to 4.9. * Update `ObjectSelectorControl` to allow passing `options` without `options.params`. #### 0.4.1 – 2017-02-17 * Increase importance of `z-index` in CSS rule for Select2 dropdown for compatibility with conflicting rule in Shortcake. * Fix bug with clearing a selection. See [#31](https://github.com/xwp/wp-customize-object-selector/pull/31) * Allow `LIKE` to be used in meta queries for object selector searches. See [#32](https://github.com/xwp/wp-customize-object-selector/pull/32) * Introduce `customize_object_selector_result` filter. See [issues and PRs in milestone](https://github.com/xwp/wp-customize-object-selector/milestone/2?closed=11) and [full release commit log](https://github.com/xwp/wp-customize-object-selector/compare/0.4.0...0.4.1). Props Weston Ruter ([@westonruter](https://github.com/westonruter)), Sayed Taqui( [@sayedwp](https://github.com/sayedwp). #### 0.4.0 – 2017-01-08 * Add an edit shortcut in selected posts to open corresponding post section from Customize Posts; re-use `wp.customize.Posts.startEditPostFlow()`. See [#8](https://github.com/xwp/wp-customize-object-selector/issues/8), PR [#12](https://github.com/xwp/wp-customize-object-selector/issues/12). * Add ability to whitelist additional query vars via `customize_object_selector_post_query_vars` filter. See PR [#25](https://github.com/xwp/wp-customize-object-selector/pull/25). * Fix Select2 elements erroneously appearing on top of a section’s header. See PR [#26](https://github.com/xwp/wp-customize-object-selector/pull/26). * Add ability to use Customize Object Selector component outside of the customizer entirely. Immediate use case is for [JS Widgets](https://github.com/xwp/wp-js-widgets) and its [Post Collection](https://github.com/xwp/wp-js-widgets/tree/develop/post-collection-widget) widget. See PR [#27](https://github.com/xwp/wp-customize-object-selector/pull/27). See [issues and PRs in milestone](https://github.com/xwp/wp-customize-object-selector/milestone/1?closed=1) and [full release commit log](https://github.com/xwp/wp-customize-object-selector/compare/0.3.0...0.4.0). Props Miina Sikk ([@miina](https://github.com/miina)), Weston Ruter ([@westonruter](https://github.com/westonruter)), Derek Herman ([@valendesigns](https://github.com/valendesigns)), Sayed Taqui ([@sayedwp](https://github.com/sayedwp). #### 0.3.0 – 2016-09-21 Added: * Add support for emulating `wp_dropdown_pages()`. The options for a dropdown are fetched via a call to `get_pages()`, and these dropdown options are displayed when no search is entered and `show_initial_dropdown: true` is passed among the` post_query_vars`. The arguments for `wp_dropdown_pages()` can then be passed via the `dropdown_args` query var. * Replace `page_on_front` and `page_for_posts` controls with object selector controls emulating `wp_dropdown_pages()`. * Add a control param for `show_add_buttons` to control whether or not the add buttons are shown (if Customize Posts is active). * Eliminates code in `setupAddNewButtons` in favor of re-using `startCreatePostFlow` code now in Customize Posts 0.8.0. This sets the initial placeholder title for created posts and navigate to url in preview. * Show loading indicator while re-population is happening. * Prevent `page_on_front` and `page_for_posts` from being set the same. * Ensure strings are translatable. * Add banner and icon assets. Fixed: * Update `post_query_args` to `post_query_vars` in PHP. * Prevent `post__in` from causing `posts_per_page` to be set too early. * Skip calling close on select2 if element already gone. Fixes JS error. * Fix issues related to syncing the setting value to the select2 value. * Ensure notifications are set on containing construct. * Fix transport implementation by returning request object. * Pass params from control to component by reference without cloning so that params can be adjusted on control to affect the component. (Not ideal long term.) #### 0.2.0 Initial release of fork from [Customizer Ajax Select](https://github.com/danielbachhuber/customizer-ajax-select). ## 中繼資料 * 版本 **0.4.2** * 最後更新 **9 年前** * 啟用安裝數 **40+** * WordPress 版本需求 ** 4.7.0 或更新版本 ** * 已測試相容的 WordPress 版本 **4.9.0** * PHP 版本需求 ** 5.3 或更新版本 ** * 語言 * [English (US)](https://wordpress.org/plugins/customize-object-selector/) * 標籤: * [customize](https://tw.wordpress.org/plugins/tags/customize/)[customizer](https://tw.wordpress.org/plugins/tags/customizer/) [pages](https://tw.wordpress.org/plugins/tags/pages/)[posts](https://tw.wordpress.org/plugins/tags/posts/) [select2](https://tw.wordpress.org/plugins/tags/select2/) * [進階檢視](https://tw.wordpress.org/plugins/customize-object-selector/advanced/) ## 評分 這個項目尚無任何評論記錄。 [撰寫評分](https://wordpress.org/support/plugin/customize-object-selector/reviews/#new-post) [查看全部使用者評論](https://wordpress.org/support/plugin/customize-object-selector/reviews/) ## 參與者 * [ Weston Ruter ](https://profiles.wordpress.org/westonruter/) * [ XWP ](https://profiles.wordpress.org/xwp/) ## 技術支援 使用者可在技術支援論壇提出意見反應或使用問題。 [檢視技術支援論壇](https://wordpress.org/support/plugin/customize-object-selector/)