Title: Single Category Permalink Author: Scott Reilly Published: 2011 年 7 月 18 日 Last modified: 2021 年 9 月 29 日 --- 搜尋外掛 ![](https://ps.w.org/single-category-permalink/assets/banner-772x250.png?rev=845064) 這個外掛**並未在最新的 3 個 WordPress 主要版本上進行測試**。開發者可能不再對這個 外掛進行維護或提供技術支援，並可能會與更新版本的 WordPress 產生使用上的相容性問題。 ![](https://ps.w.org/single-category-permalink/assets/icon-128x128.png?rev=1092767) # Single Category Permalink 由 [Scott Reilly](https://profiles.wordpress.org/coffee2code/) 開發 [下載](https://downloads.wordpress.org/plugin/single-category-permalink.2.5.2.zip) * [詳細資料](https://tw.wordpress.org/plugins/single-category-permalink/#description) * [使用者評論](https://tw.wordpress.org/plugins/single-category-permalink/#reviews) * [安裝方式](https://tw.wordpress.org/plugins/single-category-permalink/#installation) * [開發資訊](https://tw.wordpress.org/plugins/single-category-permalink/#developers) [技術支援](https://wordpress.org/support/plugin/single-category-permalink/) ## 外掛說明 Reduce permalinks (category or post) that include entire hierarchy of categories to just having the lowest category in the hierarchy. By default, WordPress replaces the %category% permalink tag in a custom permalink structure with the entire hierarchy of categories for the post’s first matching category. For example, assuming your site has a hierarchical category structure like so: ``` Applications |_ Desktop |_ Web |_ WordPress ``` By default, if you have a permalink structure defined as `%category%/%year%/%monthnum%/% day%/%postname%`, your post titled “Best Plugins” assigned to the “WordPress” category would have a permalink of: ``` https://www.example.com/applications/web/wordpress/2008/01/15/best-plugins ``` If you activate the Single Category Permalink plugin, this would be the permalink generated for the post (and recognized by the blog): ``` https://www.example.com/wordpress/2008/01/15/best-plugins ``` In order for a category to be used as part of a post’s permalink structure, `%category%` must be explicitly defined in the Settings -> Permalinks admin page as part of a custom structure, i.e. `/%category%/%postname%`. For category links, `%category%` is implied to follow the value set as the “Category base” (or the default category base if none is specified). So if your category base is ‘category’, the above example would list posts in the ‘WordPress’ category on this category listing page: ``` https://www.example.com/category/applications/web/wordpress/ ``` With this plugin activated, that link would become: ``` https://www.example.com/category/wordpress/ ``` NOTE: The fully hierarchical category and post permalinks will continue to work. The plugin issues a 302 redirect to browsers and search engines pointing them to the shorter URL. Links: [Plugin Homepage](https://coffee2code.com/wp-plugins/single-category-permalink/) | [Plugin Directory Page](https://wordpress.org/plugins/single-category-permalink/) | [GitHub](https://github.com/coffee2code/single-category-permalink/) | [Author Homepage](https://coffee2code.com) ### Hooks The plugin exposes one filter for hooking. Code using this filter should ideally be put into a mu-plugin or site-specific plugin (which is beyond the scope of this readme to explain). Less ideally, you could put them in your active theme’s functions. php file. **c2c_single_category_redirect_status (filter)** The ‘c2c_single_category_redirect_status’ hook allows you to specify an HTTP status code used for the redirect. By default this is 302. Arguments: * $status (integer) : The default HTTP status code Example: ``` /** * Change the redirection HTTP status to a 302. * * @param int $code The HTTP status code. By default 301. * @return int */ function scp_change_redirect_status( $code ) { return 302; } add_filter( 'c2c_single_category_redirect_status', 'scp_change_redirect_status' ); ``` ## 安裝方式 1. Install via the built-in WordPress plugin installer. Or download and unzip `single- category-permalinks.zip` inside the plugins directory for your site (typically ` wp-content/plugins/`) 2. Activate the plugin through the ‘Plugins’ admin menu in WordPress 3. Use `%category%` as a permalink tag in the `Settings` -> `Permalinks` admin options page when defining a custom permalink structure ## 常見問題集 ### Will existing links to my site that used the full category hierarchy still work? Yes, WordPress will still serve the category listings and posts regardless of whether it is of the full category hierarchy format or just the single category format. But do note that WordPress doesn’t perform any sort of redirects; it responds directly to the category/post URL requested. ### Could this give the appearance that I have duplicate content on my site if pages are accessible via the full category hierarchy permalink format and the single category permalink format? Whether this plugin is active or not, WordPress treats both types of category links the same. This plugin will however issue redirects for all of the non-canonical category and post permalink pages to point to the single category link version. ### What can this plugin do for me if I don’t use `%category%` in my custom permalink structure? In addition to handling custom permalink structures (used to generate permalinks for posts) that contain `%category%`, the plugin also shortens category archive links. WordPress by default generates those links in a fully hierarchical fashion which this plugin will reduce to a single category. See the Description section for an example. ### Does this plugin include unit tests? Yes. ## 使用者評論 ![](https://secure.gravatar.com/avatar/0af3987aa3971c903e816f1ecfd8ecd00ba97c32dc0ca79bf82258b194bcde33? s=60&d=retro&r=g) ### 󠀁[nice plugins](https://wordpress.org/support/topic/nice-plugins-47/)󠁿 [hangtotnenmua](https://profiles.wordpress.org/hangtotnenmua/) 2021 年 1 月 15 日 nice plugins! i love you! chup chup ![](https://secure.gravatar.com/avatar/e59c78b59657f417469963e4c07fb0a86e7edf0c419df4584740c486b240f0b7? s=60&d=retro&r=g) ### 󠀁[Unstopable Thanks](https://wordpress.org/support/topic/unstopable-thanks/)󠁿 [Rabby](https://profiles.wordpress.org/mynameisrabby/) 2020 年 1 月 18 日 Unstopable thanks, So far it can be said. This tiny plugin is very very helpful to make good url structure for big site, which is huge category and sub-category.[ Note: I’m not good at English so much] ![](https://secure.gravatar.com/avatar/5b78ba7274d2d03b1738258629fc7b1d71cdf2262fdfd6de1ad1bf63b7f41e08? s=60&d=retro&r=g) ### 󠀁[Great plugin!](https://wordpress.org/support/topic/great-plugin-18009/)󠁿 [dandeedo](https://profiles.wordpress.org/dandeedo/) 2018 年 5 月 17 日 gives you full control of your category permalinks… Really great plugin, works well! [ 閱讀全部 5 則使用者評論 ](https://wordpress.org/support/plugin/single-category-permalink/reviews/) ## 參與者及開發者 以下人員參與了開源軟體〈Single Category Permalink〉的開發相關工作。 參與者 * [ Scott Reilly ](https://profiles.wordpress.org/coffee2code/) [將〈Single Category Permalink〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/single-category-permalink) ### 對開發相關資訊感興趣？ 任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/single-category-permalink/)、 查看 [SVN 存放庫](https://plugins.svn.wordpress.org/single-category-permalink/)， 或透過 [RSS](https://plugins.trac.wordpress.org/log/single-category-permalink/?limit=100&mode=stop_on_copy&format=rss) 訂閱[開發記錄](https://plugins.trac.wordpress.org/log/single-category-permalink/)。 ## 變更記錄 #### 2.5.2 (2021-09-28) * Change: Note compatibility through WP 5.8+ * Unit tests: - Change: Restructure unit test directories * Change: Move `phpunit/bin/` into `tests/` * Change: Move `phpunit/` into `tests/` - Change: Remove ‘test-‘ prefix from unit test file - Change: In bootstrap, store path to plugin file constant - Change: In bootstrap, add backcompat for PHPUnit pre-v6.0 #### 2.5.1 (2021-04-30) * Change: Note compatibility through WP 5.7+ * Change: Update copyright date (2021) #### 2.5 (2020-09-23) * Fix: Default the `$taxonomy` argument of `category_link()` to ‘category’ to avoid a PHP warning/error * Fix: Handle the possibility that `get_category()` could return `null` for an invalid category ID * New: Add a TODO item about removing deprecated functions (which is not something I want to do just yet, hence the TODO) * Change: Update docs for return value of `category_link()` to reflect that `WP_Error` or `null` are also possible values * Change: Note compatibility through WP 5.5+ * Change: Restructure unit test file structure - New: Create new subdirectory `phpunit/` to house all files related to unit testing - Change: Move `bin/` to `phpunit/bin/` - Change: Move `tests/bootstrap.php` to `phpunit/` - Change: Move `tests/` to `phpunit/tests/` - Change: Rename `phpunit.xml` to `phpunit.xml.dist` per best practices * Unit tests: - New: Add tests for `category_link()`, `post_link()` - New: Add `unset_permalink_structures()` to unset configured permalink structures _Full changelog is available in [CHANGELOG.md](https://github.com/coffee2code/single-category-permalink/blob/master/CHANGELOG.md)._ ## 中繼資料 * 版本 **2.5.2** * 最後更新 **5 年前** * 啟用安裝數 **400+** * WordPress 版本需求 ** 4.6 或更新版本 ** * 已測試相容的 WordPress 版本 **5.8.13** * 語言 * [English (US)](https://wordpress.org/plugins/single-category-permalink/) * 標籤: * [category](https://tw.wordpress.org/plugins/tags/category/)[coffee2code](https://tw.wordpress.org/plugins/tags/coffee2code/) [link](https://tw.wordpress.org/plugins/tags/link/)[permalink](https://tw.wordpress.org/plugins/tags/permalink/) [structure](https://tw.wordpress.org/plugins/tags/structure/) * [進階檢視](https://tw.wordpress.org/plugins/single-category-permalink/advanced/) ## 評分 5 星，滿分為 5 星 * [ 5 個 5 星使用者評論 ](https://wordpress.org/support/plugin/single-category-permalink/reviews/?filter=5) * [ 0 個 4 星使用者評論 ](https://wordpress.org/support/plugin/single-category-permalink/reviews/?filter=4) * [ 0 個 3 星使用者評論 ](https://wordpress.org/support/plugin/single-category-permalink/reviews/?filter=3) * [ 0 個 2 星使用者評論 ](https://wordpress.org/support/plugin/single-category-permalink/reviews/?filter=2) * [ 0 個 1 星使用者評論 ](https://wordpress.org/support/plugin/single-category-permalink/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/single-category-permalink/reviews/#new-post) [查看全部使用者評論](https://wordpress.org/support/plugin/single-category-permalink/reviews/) ## 參與者 * [ Scott Reilly ](https://profiles.wordpress.org/coffee2code/) ## 技術支援 使用者可在技術支援論壇提出意見反應或使用問題。 [檢視技術支援論壇](https://wordpress.org/support/plugin/single-category-permalink/) ## 贊助 想要支援這個外掛的發展嗎？ [ 贊助這個外掛 ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=6ARCFJ9TX3522)