{"id":24795,"date":"2013-08-19T16:38:02","date_gmt":"2013-08-19T16:38:02","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/so-pinyin-slugs\/"},"modified":"2026-01-23T01:31:00","modified_gmt":"2026-01-23T01:31:00","slug":"so-pinyin-slugs","status":"publish","type":"plugin","link":"https:\/\/sq-xk.wordpress.org\/plugins\/so-pinyin-slugs\/","author":114455,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.3.7","stable_tag":"2.3.7","tested":"6.9.4","requires":"4.6","requires_php":"","requires_plugins":null,"header_name":"Pinyin Slugs","header_author":"SO WP","header_description":"","assets_banners_color":"b6926c","last_updated":"2026-01-23 01:31:00","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/so-wp.com\/plugin\/pinyin-slugs","header_author_uri":"https:\/\/so-wp.com","rating":5,"author_block_rating":0,"active_installs":3000,"downloads":56686,"num_ratings":8,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"senlin","date":"2015-06-19 10:11:33"},"1.0.1":{"tag":"1.0.1","author":"senlin","date":"2015-06-19 10:11:33"},"2.0.0":{"tag":"2.0.0","author":"senlin","date":"2015-06-19 10:11:33"},"2.0.1":{"tag":"2.0.1","author":"senlin","date":"2015-06-19 10:11:33"},"2.0.2":{"tag":"2.0.2","author":"senlin","date":"2015-06-19 23:10:48"},"2.0.3":{"tag":"2.0.3","author":"senlin","date":"2015-08-05 05:33:29"},"2.0.4":{"tag":"2.0.4","author":"senlin","date":"2015-12-10 21:42:47"},"2.1.0":{"tag":"2.1.0","author":"senlin","date":"2016-10-11 20:24:23"},"2.1.1":{"tag":"2.1.1","author":"senlin","date":"2016-11-29 16:19:15"},"2.1.2":{"tag":"2.1.2","author":"senlin","date":"2017-11-09 08:56:35"},"2.1.3":{"tag":"2.1.3","author":"senlin","date":"2018-07-09 06:34:26"},"2.1.4":{"tag":"2.1.4","author":"senlin","date":"2020-08-01 16:18:51"},"2.2.0":{"tag":"2.2.0","author":"senlin","date":"2022-08-12 10:00:57"},"2.2.1":{"tag":"2.2.1","author":"senlin","date":"2023-07-30 08:54:21"},"2.3.0":{"tag":"2.3.0","author":"senlin","date":"2023-11-10 09:00:38"},"2.3.1":{"tag":"2.3.1","author":"senlin","date":"2023-11-23 18:23:52"},"2.3.2":{"tag":"2.3.2","author":"senlin","date":"2024-04-11 12:08:51"},"2.3.3":{"tag":"2.3.3","author":"senlin","date":"2024-12-02 16:54:13"},"2.3.4":{"tag":"2.3.4","author":"senlin","date":"2025-03-11 20:58:47"},"2.3.5":{"tag":"2.3.5","author":"senlin","date":"2025-04-27 07:49:57"},"2.3.6":{"tag":"2.3.6","author":"senlin","date":"2026-01-12 05:22:04"},"2.3.7":{"tag":"2.3.7","author":"senlin","date":"2026-01-23 01:31:00"}},"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":8},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":2099459,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":2099459,"resolution":"256x256","location":"assets","locale":""},"icon-512x512.png":{"filename":"icon-512x512.png","revision":2099459,"resolution":"512x512","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":2099475,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":2099475,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","2.0.0","2.0.1","2.0.2","2.0.3","2.0.4","2.1.0","2.1.1","2.1.2","2.1.3","2.1.4","2.2.0","2.2.1","2.3.0","2.3.1","2.3.2","2.3.3","2.3.4","2.3.5","2.3.6","2.3.7"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":1059976,"resolution":"1","location":"assets","locale":""},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":1059976,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":1059976,"resolution":"3","location":"assets","locale":""}},"screenshots":{"1":"Settings page","2":"New Post with title in Chinese characters and auto-generated pinyin slug; Baidu Search Results page underneath","3":"WPML Compatible"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[4316,49268,939,4320,562],"plugin_category":[59],"plugin_contributors":[79884],"plugin_business_model":[],"class_list":["post-24795","plugin","type-plugin","status-publish","hentry","plugin_tags-chinese","plugin_tags-mandarin","plugin_tags-permalinks","plugin_tags-pinyin","plugin_tags-slugs","plugin_category-utilities-and-tools","plugin_contributors-senlin","plugin_committers-senlin"],"banners":{"banner":"https:\/\/ps.w.org\/so-pinyin-slugs\/assets\/banner-772x250.jpg?rev=2099475","banner_2x":"https:\/\/ps.w.org\/so-pinyin-slugs\/assets\/banner-1544x500.jpg?rev=2099475","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/so-pinyin-slugs\/assets\/icon-128x128.png?rev=2099459","icon_2x":"https:\/\/ps.w.org\/so-pinyin-slugs\/assets\/icon-256x256.png?rev=2099459","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/so-pinyin-slugs\/assets\/screenshot-1.jpg?rev=1059976","caption":"Settings page"},{"src":"https:\/\/ps.w.org\/so-pinyin-slugs\/assets\/screenshot-2.jpg?rev=1059976","caption":"New Post with title in Chinese characters and auto-generated pinyin slug; Baidu Search Results page underneath"},{"src":"https:\/\/ps.w.org\/so-pinyin-slugs\/assets\/screenshot-3.png?rev=1059976","caption":"WPML Compatible"}],"raw_content":"<!--section=description-->\n<p>Chinese characters don't come out good in permalinks. Without the Pinyin Slugs plugin activated, the example post I made for the screenshot will get a slug like this: <em>%e6%90%9c%e7%b4%a2%e5%bc%95%e6%93%8e%e4%bc%98%e5%8c%96<\/em>. With the plugin the slug automatically becomes <em>sousuoyinqingyouhua<\/em>.<\/p>\n\n<p>Search engines such as <a href=\"https:\/\/www.baidu.com\">Baidu<\/a> cannot make much of the first slug, but they can handle pinyin perfectly, especially when it is written as one long string without hyphens or underscores.<\/p>\n\n<p>It is possible to limit the amount of characters in the slug. The default is 100, which should be plenty for most.<\/p>\n\n<p>The Pinyin Slugs plugin was forked from the <a href=\"https:\/\/wordpress.org\/plugins\/pinyin-permalink\/\">Pinyin Permalinks<\/a> plugin by user <a href=\"https:\/\/profiles.wordpress.org\/xiaole_tao\/\">xiaole_tao<\/a> as that project seemed abandoned. There have been many improvements since; read the changelog for details.<\/p>\n\n<p>I have decided to only support this plugin through <a href=\"https:\/\/github.com\/senlin\/pinyin-slugs\/issues\">Github<\/a>. Therefore, if you have any questions, need help and\/or want to make a feature request, please open an issue over at Github. You can also browse through open and closed issues to find what you are looking for and perhaps even help others.<\/p>\n\n<p><strong>PLEASE DO NOT POST YOUR ISSUES VIA THE WORDPRESS FORUMS<\/strong><\/p>\n\n<p>Thanks for your understanding and cooperation.<\/p>\n\n<h4>WPML Compatible<\/h4>\n\n<p>The Pinyin Slugs plugin has received the <a href=\"https:\/\/wpml.org\/plugin\/pinyin-slugs\/\">WPML Certification of Compatibility<\/a> and is featured on the WPML website with the article <a href=\"https:\/\/wpml.org\/documentation\/how-to-build-a-wordpress-site-in-china\/\">How to Build a WordPress Website in China and Reach an International Audience<\/a>.<\/p>\n\n<!--section=installation-->\n<h4>WordPress<\/h4>\n\n<p>Search for \"Pinyin Slugs\" and install with the <strong>Plugins &gt; Add New<\/strong> back-end page.<\/p>\n\n<p>&hellip; OR &hellip;<\/p>\n\n<p>Follow these steps:<\/p>\n\n<ol>\n<li>Download zip file.<\/li>\n<li>Upload the zip file via the Plugins &gt; Add New &gt; Upload page &hellip; OR &hellip; unpack and upload with your favorite FTP client to the \/plugins\/ folder.<\/li>\n<li>Activate the plugin on the Plugins page.<\/li>\n<\/ol>\n\n<p>Done!<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20pinyin%20slugs%20work%20with%20simplified%20chinese%20characters%3F\"><h3>Does Pinyin Slugs work with Simplified Chinese characters?<\/h3><\/dt>\n<dd><p>Yes, the plugin transforms Simplified Chinese slugs into pinyin.<\/p><\/dd>\n<dt id=\"does%20pinyin%20slugs%20work%20with%20traditional%20chinese%20characters%3F\"><h3>Does Pinyin Slugs work with Traditional Chinese characters?<\/h3><\/dt>\n<dd><p>Yes, since September 2020 the plugin also can transform Traditional Chinese slugs into pinyin.<\/p><\/dd>\n<dt id=\"does%20pinyin%20slugs%20work%20with%20the%20wp%20block%20editor%3F\"><h3>Does Pinyin Slugs work with the WP block editor?<\/h3><\/dt>\n<dd><p>Yes, it does, although one caveat is that to be able to see the change of slug, the post\/page first needs to be saved. The same applies for edits.<\/p><\/dd>\n<dt id=\"known%20issues\"><h3>Known Issues<\/h3><\/dt>\n<dd><p>Pinyin Slugs will not auto-transform existing slugs, you will have to change them manually.<\/p><\/dd>\n<dt id=\"i%20have%20an%20issue%20with%20this%20plugin%2C%20where%20can%20i%20get%20support%3F\"><h3>I have an issue with this plugin, where can I get support?<\/h3><\/dt>\n<dd><p>Please open an issue over at <a href=\"https:\/\/github.com\/senlin\/so-pinyin-slugs\/issues\">Github<\/a>, as <strong>I will not use the support forums<\/strong> here on WordPress.org<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.3.7<\/h4>\n\n<ul>\n<li>date: January 23, 2026<\/li>\n<li>fix PHP 8+ warning by aligning pinyin dictionary global variable name <a href=\"https:\/\/github.com\/senlin\/pinyin-slugs\/issues\/31\">issue 31<\/a><\/li>\n<\/ul>\n\n<h4>2.3.6<\/h4>\n\n<ul>\n<li>date: January 12, 2026<\/li>\n<li>add escaping functions to output<\/li>\n<li>tested up to WP 6.9<\/li>\n<\/ul>\n\n<h4>2.3.5<\/h4>\n\n<ul>\n<li>date: April 27, 2025<\/li>\n<li>removed redundant <code>load_plugin_textdomain()<\/code> function and increased min required WP version<\/li>\n<li>tested up to WP 6.8<\/li>\n<\/ul>\n\n<h4>2.3.4<\/h4>\n\n<ul>\n<li>date: March 11, 2025<\/li>\n<li>fix <a href=\"https:\/\/github.com\/senlin\/pinyin-slugs\/issues\/27\">issue27<\/a> thanks for the PR @yabwee<\/li>\n<li>tested up to WP 6.7<\/li>\n<\/ul>\n\n<h4>2.3.3<\/h4>\n\n<ul>\n<li>date: July 9, 2024<\/li>\n<li>add new $autoload parameter (WP 6.6)<\/li>\n<li>tested up to WP 6.6<\/li>\n<li>removed logo from Settings page<\/li>\n<\/ul>\n\n<h4>2.3.2<\/h4>\n\n<ul>\n<li>date: November 27, 2023<\/li>\n<li>last security fix introduced problem where spaces in Title where no longer replaced by hyphens, this version brings back those hyphens (<a href=\"https:\/\/github.com\/senlin\/pinyin-slugs\/issues\/23\">issue 23<\/a> thanks for pointing it out @nhimthaoan)<\/li>\n<\/ul>\n\n<h4>2.3.1<\/h4>\n\n<ul>\n<li>date: November 23, 2023<\/li>\n<li>security fix CVE-2023-47511 Cross Site Scripting (XSS) vulnerability (<a href=\"https:\/\/github.com\/senlin\/pinyin-slugs\/issues\/22\">issue 22<\/a> thanks for pointing it out @ramiror)<\/li>\n<\/ul>\n\n<h4>2.3.0<\/h4>\n\n<ul>\n<li>date: August 27, 2023<\/li>\n<li>fix Slug Length function (<a href=\"https:\/\/github.com\/senlin\/pinyin-slugs\/issues\/19\">issue 19<\/a> thanks for reporting @zhouLife)<\/li>\n<\/ul>\n\n<h4>2.2.1<\/h4>\n\n<ul>\n<li>date: October 25, 2022<\/li>\n<li>edits in readme files and on Settings page<\/li>\n<\/ul>\n\n<h4>2.2.0<\/h4>\n\n<ul>\n<li>date: September 16, 2020<\/li>\n<li>dictionary update: UniHan database using the kMandarin Reading field as pinyin phonetic keys (https:\/\/unicode.org\/charts\/unihan.html); with many thanks to <a href=\"https:\/\/github.com\/senlin\/pinyin-slugs\/pull\/16\">Yun-yu Shen @ujamer<\/a><\/li>\n<li>edits in readme files and on Settings page<\/li>\n<\/ul>\n\n<h4>2.1.4<\/h4>\n\n<ul>\n<li>date: October 29, 2018<\/li>\n<li>tested up to WP 5.0<\/li>\n<li>tested up to ClassicPress 1.0.0<\/li>\n<\/ul>\n\n<h4>2.1.3<\/h4>\n\n<ul>\n<li>date: July 8, 2018<\/li>\n<li>tested up to WP 4.9.7<\/li>\n<\/ul>\n\n<h4>2.1.2<\/h4>\n\n<ul>\n<li>date: March 15, 2017<\/li>\n<li>add sanitize_title filter once the file has been included as per <a href=\"https:\/\/github.com\/senlin\/so-pinyin-slugs\/issues\/6#issuecomment-284342159\">suggestion<\/a> of Polylang author <a href=\"https:\/\/github.com\/Chouby\">@Chouby<\/a><\/li>\n<li>tidying up<\/li>\n<\/ul>\n\n<h4>2.1.1<\/h4>\n\n<ul>\n<li>date: November 29, 2016<\/li>\n<li>remove version check<\/li>\n<li>tested up to WP 4.7<\/li>\n<\/ul>\n\n<h4>2.1.0<\/h4>\n\n<ul>\n<li>date: March 10, 2016<\/li>\n<li>fix to not ignore alphanumerical characters by <a href=\"https:\/\/github.com\/vanabel\">vanabel<\/a>, closes <a href=\"https:\/\/github.com\/senlin\/so-pinyin-slugs\/issues\/4\">issue #4<\/a><\/li>\n<\/ul>\n\n<h4>2.0.4<\/h4>\n\n<ul>\n<li>date: August 7, 2015<\/li>\n<li>TWEAK: header settings page; only showed half logo after 2.0.3 update<\/li>\n<\/ul>\n\n<h4>2.0.3<\/h4>\n\n<ul>\n<li>date: August 5, 2015<\/li>\n<li>changed header settings page to h1 (https:\/\/make.wordpress.org\/plugins\/2015\/08\/03\/4-3-change-to-plugin-dashboard-pages\/)<\/li>\n<li>show 4.3 compatibility<\/li>\n<\/ul>\n\n<h4>2.0.2<\/h4>\n\n<ul>\n<li>date: June 19, 2015<\/li>\n<li>revert to <a href=\"http:\/\/semver.org\/\">semantic versioning<\/a><\/li>\n<\/ul>\n\n<h4>2.0.1<\/h4>\n\n<ul>\n<li>date: April 9, 2015<\/li>\n<li>changed logos<\/li>\n<li>new banner image for WP.org Repo by <a href=\"https:\/\/unsplash.com\/hmmrmnn\">Joschko Hammermann<\/a><\/li>\n<\/ul>\n\n<h4>2.0.0<\/h4>\n\n<ul>\n<li>date: July 29, 2014<\/li>\n<li>due to non-compatibility issues with WP 4.0, complete rewrite of the plugin from the ground up<\/li>\n<li>bump minimum required WP version up to 3.8<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>date: December 28, 2013<\/li>\n<li>fix reported <a href=\"https:\/\/github.com\/senlin\/so-pinyin-slugs\/issues\/1\">bug<\/a> that causes entire admin to be a maximum width of 48rem<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>date: December 26, 2013<\/li>\n<li>tested up to WP 3.9-alpha<\/li>\n<li>settings page overhaul to better match WP 3.8 style<\/li>\n<li>change version number format<\/li>\n<li>change links<\/li>\n<\/ul>\n\n<h4>0.1.3<\/h4>\n\n<ul>\n<li>change text domain to prepare for language packs (via Otto - http:\/\/otto42.com\/el)<\/li>\n<\/ul>\n\n<h4>0.1.2<\/h4>\n\n<ul>\n<li>compatible up to WordPress 3.7<\/li>\n<li>redo version check, min. requirement WordPress 3.6<\/li>\n<li>change Github link<\/li>\n<li>add Dutch language files<\/li>\n<li>add WPML accreditation<\/li>\n<\/ul>\n\n<h4>0.1.1<\/h4>\n\n<ul>\n<li>separate dictionary.php file<\/li>\n<li>add Mandarin Chinese language files<\/li>\n<li>edit readme.txt and readme.md<\/li>\n<li>fix textdomain issue<\/li>\n<\/ul>\n\n<h4>0.1<\/h4>\n\n<ul>\n<li>First stable release<\/li>\n<\/ul>","raw_excerpt":"Transforms Simplified or Traditional Chinese character titles into Pinyin to create a permalink friendly slug.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/sq-xk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/24795","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/sq-xk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/sq-xk.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/sq-xk.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=24795"}],"author":[{"embeddable":true,"href":"https:\/\/sq-xk.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/senlin"}],"wp:attachment":[{"href":"https:\/\/sq-xk.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=24795"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/sq-xk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=24795"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/sq-xk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=24795"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/sq-xk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=24795"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/sq-xk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=24795"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/sq-xk.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=24795"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}