{"id":99637,"date":"2019-03-11T10:19:27","date_gmt":"2019-03-11T10:19:27","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/backwards-compatible-permalinks\/"},"modified":"2019-03-11T10:19:27","modified_gmt":"2019-03-11T10:19:27","slug":"backwards-compatible-permalinks","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/backwards-compatible-permalinks\/","author":6654895,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"0.1.0","stable_tag":"trunk","tested":"5.1.22","requires":"4.8","requires_php":"5.6","requires_plugins":"","header_name":"Backwards Compatible Permalinks","header_author":"Chris Aprea","header_description":"Provides a degree of backwards compatibility when switching between permalink structures.","assets_banners_color":"bfddd5","last_updated":"2019-03-11 10:19:27","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/twitter.com\/chrisaprea","rating":0,"author_block_rating":0,"active_installs":0,"downloads":1777,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","faq","changelog"],"tags":[],"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":"2048062","resolution":"128x128","location":"assets"},"icon-256x256.png":{"filename":"icon-256x256.png","revision":"2048062","resolution":"256x256","location":"assets"}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":"2048062","resolution":"1544x500","location":"assets"},"banner-772x250.png":{"filename":"banner-772x250.png","revision":"2048062","resolution":"772x250","location":"assets"}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1.0"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[2662,939,538,539],"plugin_category":[59],"plugin_contributors":[92236],"plugin_business_model":[],"class_list":["post-99637","plugin","type-plugin","status-publish","hentry","plugin_tags-permalink","plugin_tags-permalinks","plugin_tags-url","plugin_tags-urls","plugin_category-utilities-and-tools","plugin_contributors-aprea","plugin_committers-aprea"],"banners":{"banner":"https:\/\/ps.w.org\/backwards-compatible-permalinks\/assets\/banner-772x250.png?rev=2048062","banner_2x":"https:\/\/ps.w.org\/backwards-compatible-permalinks\/assets\/banner-1544x500.png?rev=2048062","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/backwards-compatible-permalinks\/assets\/icon-128x128.png?rev=2048062","icon_2x":"https:\/\/ps.w.org\/backwards-compatible-permalinks\/assets\/icon-256x256.png?rev=2048062","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Backwards Compatible Permalinks helps prevent 404 errors when switching between permalink structures.<\/p>\n\n<p>It achieves this by appending a set of backwards compatible post rewrite rules. This ensures posts are still accessible at their previous permalink after the permalink structure is updated.<\/p>\n\n<h4>Example<\/h4>\n\n<p>Let's say your permalink structure is set to \"Month and name\" and you have a post titled \"I Love WordPress.\" That particular post would live at <code>https:\/\/example.com\/2019\/03\/i-love-wordpress\/<\/code>.<\/p>\n\n<p>But what if you wanted to switch to the \"Post name\" permalink structure and have your post live at <code>https:\/\/example.com\/i-love-wordpress\/<\/code> instead?<\/p>\n\n<p>You could but this would result in the existing post permalink 404ing when visited. Which is problematic if the previous URL was bookmarked or shared on social media.<\/p>\n\n<p>With Backwards Compatible Permalinks installed your post would be accessible at both the old and new permalink structures:<\/p>\n\n<ul>\n<li><code>https:\/\/example.com\/2019\/03\/i-love-wordpress\/<\/code><\/li>\n<li><code>https:\/\/example.com\/i-love-wordpress\/<\/code><\/li>\n<\/ul>\n\n<h4>Caveats<\/h4>\n\n<ul>\n<li>This plugin does not work retroactively. i.e. you must have the plugin installed and activated prior to switching permalink structures before backwards compatibility will work.<\/li>\n<li>Currently only standard posts are supported.<\/li>\n<li>Backwards compatibility is not supported between certain permalink structure updates. This is due to a clash between permalink structure regex matching.<\/li>\n<li>Backwards compatibility is only provided between the most recent permalink structure update. i.e. you cannot change your permalink structure 3 times and have backwards compatibility across all 3 structures.<\/li>\n<\/ul>\n\n<h4>Deactivate or uninstall<\/h4>\n\n<p>After deactivating or uninstalling this plugin please ensure you visit Settings &gt; Permalinks in the WordPress admin area to flush your rewrite rules.<\/p>\n\n<h4>Contributing<\/h4>\n\n<p>Contributions are <a href=\"https:\/\/github.com\/aprea\/backwards-compatible-permalinks\">welcomed on GitHub<\/a>.<\/p>\n\n<h3>From within WordPress<\/h3>\n\n<ol>\n<li>Visit 'Plugins &gt; Add New'.<\/li>\n<li>Search for 'Backwards Compatible Permalinks'.<\/li>\n<li>Activate Backwards Compatible Permalinks from your Plugins page.<\/li>\n<\/ol>\n\n<h3>Manually<\/h3>\n\n<ol>\n<li>Upload the <code>backwards-compatible-permalinks<\/code> folder to the <code>\/wp-content\/plugins\/<\/code> directory.<\/li>\n<li>Activate the Backwards Compatible Permalinks plugin through the 'Plugins' menu in WordPress.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt>Why is my old post URL not redirecting to the new URL?<\/dt>\n<dd><p>This is currently not supported, the post will be accessible at both URLs. I agree that this isn't the ideal behaviour but it was too tricky to support redirects while also ensuring query parameters and \"\/page\/xx\" and \"\/comment-page-xx\" modifiers were respected during the redirect. The good news is that the canonical tag will always point to the new URL so there shouldn't be any SEO ramifications.<\/p><\/dd>\n<dt>Does this plugin provide access to any actions\/filters?<\/dt>\n<dd><p>A single filter is available. You may use the <code>aprea_back_compat_permalink_structure<\/code> filter to provide a backwards compatible permalink structure, e.g. <code>\/%year%\/%monthnum%\/%day%\/%postname%\/<\/code>.<\/p>\n\n<p>This is helpful if you updated the permalink structure prior to installing this plugin.<\/p><\/dd>\n<dt>The plugin is not working for me!<\/dt>\n<dd><p>I'm terribly sorry! You may want to check the caveats section to see if any apply to your situation. Otherwise feel free to post in the support forums.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.1.0<\/h4>\n\n<p>Initial release.<\/p>","raw_excerpt":"Provides a degree of backwards compatibility when switching between permalink structures.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/99637","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=99637"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/aprea"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=99637"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=99637"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=99637"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=99637"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=99637"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=99637"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}