{"id":61218,"date":"2012-12-10T13:12:00","date_gmt":"2012-12-10T18:12:00","guid":{"rendered":"http:\/\/www.bu.edu\/tech\/?page_id=61218"},"modified":"2013-04-11T13:57:16","modified_gmt":"2013-04-11T17:57:16","slug":"use","status":"publish","type":"page","link":"https:\/\/www.bu.edu\/tech\/services\/cccs\/websites\/www\/wordpress\/advanced-workflows\/versions\/use\/","title":{"rendered":"Use the BU Versions Plugin"},"content":{"rendered":"<p>The alternate versions workflow starts with a published post.<\/p>\n<p>WordPress uses the term post generically to refer to all content that shares the <strong>Post<\/strong> admin user interfaces. A post type is a specific instance of a post \u2014 both <strong>Post<\/strong> and <strong>Page<\/strong> are built-in examples of post types. In addition, plugins and themes may add their own custom post types for managing special types of content. For instance the <a href=\"\/tech\/services\/cccs\/websites\/www\/wordpress\/how-to\/profiles\/\">BU Profiles plugin<\/a> uses a custom post type called Profile to allow management of faculty and staff profiles.<\/p>\n<p>The alternate version workflow is designed to work on published content. <strong>Publish<\/strong> is an example of a post status \u2014 other statuses include <strong>Draft<\/strong>, <strong>Pending<\/strong>, and <strong>Trash<\/strong>. If you see one of these status labels next to your post title on the edit posts page, you will not be able to create alternate versions for them.<\/p>\n<div id=\"attachment60616\" style=\"width: 646px\" class=\"wp-caption alignnone\"><img aria-describedby=\"caption-attachment60616\" loading=\"lazy\" src=\"\/tech\/files\/2012\/11\/post-statuses-example-636x273.jpg\" alt=\"Example of different post statuses\" title=\"post-statuses-example\" width=\"636\" height=\"273\" class=\"size-medium wp-image-60616 \" srcset=\"https:\/\/www.bu.edu\/tech\/files\/2012\/11\/post-statuses-example-636x273.jpg 636w, https:\/\/www.bu.edu\/tech\/files\/2012\/11\/post-statuses-example.jpg 948w\" sizes=\"(max-width: 636px) 100vw, 636px\" \/><p id=\"caption-attachment60616\" class=\"wp-caption-text\">Example of different post statuses<\/p><\/div>\n<p>By default all post types that appear in your UI will gain the alternate version workflow.<\/p>\n<div class=\"bu_collapsible_container \" aria-live=\"polite\" data-customize-animation=\"false\"><h3 class=\"bu_collapsible\" aria-expanded=\"false\"tabindex=\"0\" role=\"button\">Clone -- Creating an Alternate Version<\/h3><div class=\"bu_collapsible_section\" style=\"display: none;\"><\/p>\n<p><div id=\"attachment60615\" style=\"width: 519px\" class=\"wp-caption alignnone\"><img aria-describedby=\"caption-attachment60615\" loading=\"lazy\" class=\"size-medium wp-image-60615  \" height=\"256\" width=\"509\" title=\"pages-alt-versions-column\" alt=\"Pages table, with additional Alternate Versions column\" src=\"\/tech\/files\/2012\/11\/pages-alt-versions-column-636x320.jpg\" srcset=\"https:\/\/www.bu.edu\/tech\/files\/2012\/11\/pages-alt-versions-column-636x320.jpg 636w, https:\/\/www.bu.edu\/tech\/files\/2012\/11\/pages-alt-versions-column.jpg 953w\" sizes=\"(max-width: 509px) 100vw, 509px\" \/><p id=\"caption-attachment60615\" class=\"wp-caption-text\">Pages table, with additional Alternate Versions column<\/p><\/div><\/p>\n<p>As soon as the BU Versions plugin is activated for your site, published posts will gain an extra column in the edit posts table \u2014 <strong>Alternate Versions<\/strong>. From this column you can clone a post, creating an alternate version that can be used to stage content changes.<\/p>\n<p>Click on <strong>create clone<\/strong> to create an alternate version for a published Post or Page.<\/p>\n<p><\/div>\n<\/div>\n\n<div class=\"bu_collapsible_container \" aria-live=\"polite\" data-customize-animation=\"false\"><h3 class=\"bu_collapsible\" aria-expanded=\"false\"tabindex=\"0\" role=\"button\">Edit an Alternate Version as a Site Admin or Lead Editor<\/h3><div class=\"bu_collapsible_section\" style=\"display: none;\"><\/p>\n<p><div id=\"attachment60619\" style=\"width: 519px\" class=\"wp-caption alignnone\"><img aria-describedby=\"caption-attachment60619\" loading=\"lazy\" class=\"size-medium wp-image-60619  \" height=\"279\" width=\"509\" title=\"training-home-clone\" alt=\"Home page alternate version\" src=\"\/tech\/files\/2012\/11\/training-home-clone-636x349.jpg\" srcset=\"https:\/\/www.bu.edu\/tech\/files\/2012\/11\/training-home-clone-636x349.jpg 636w, https:\/\/www.bu.edu\/tech\/files\/2012\/11\/training-home-clone-1024x562.jpg 1024w, https:\/\/www.bu.edu\/tech\/files\/2012\/11\/training-home-clone.jpg 1053w\" sizes=\"(max-width: 509px) 100vw, 509px\" \/><p id=\"caption-attachment60619\" class=\"wp-caption-text\">Home page alternate version<\/p><\/div><\/p>\n<p>Clicking on <strong>create clone<\/strong> will bring you to the familiar post editing interface, with a few twists. A blue heading will let you know that you are editing an alternate version, and give you a link to edit the original if needed. After the alternate version is created, changes can be made without affecting the original post.<\/p>\n<p>An alternate version starts with the an exact copy of the content and supported meta data (content banner, post details, etc.) from the original post. Alternate versions even have their own revision history, allowing you to spread content changes over multiple editing sessions by saving the alternate version as a Draft.<\/p>\n<div class=\"notice-yellow\">Once the alternate version is created, changes to the original post will not propagate to the alternate version \u2014 they are two separate posts from the point they are created. Care must be taken when an alternate version exists. Changes made to the original, but not also made to the alternate version, can be lost when the original post is replaced.<\/div>\n<p><div id=\"attachment60618\" style=\"width: 274px\" class=\"wp-caption alignnone\"><img aria-describedby=\"caption-attachment60618\" loading=\"lazy\" class=\"size-full wp-image-60618  \" height=\"185\" width=\"264\" title=\"training-home-clone-publish-metabox\" alt=\"Publish metabox for alternate versions, as viewed by a site admin\" src=\"\/tech\/files\/2012\/11\/training-home-clone-publish-metabox.jpeg\" \/><p id=\"caption-attachment60618\" class=\"wp-caption-text\">Publish metabox for alternate versions, as viewed by a site admin<\/p><\/div><\/p>\n<p>While you are editing an alternate version, there are a few actions available through the <strong>Publish<\/strong> metabox.<\/p>\n<ul>\n<li><strong>Save Draft<\/strong> \u2014 Saves any changes you have made, keeping the alternate version in draft status<\/li>\n<li><strong>Preview<\/strong> \u2014 Test your alternate version, viewing it as it would appear on your live site<\/li>\n<li><strong>Schedule for Replacement<\/strong> \u2014 By clicking on the <strong>Edit<\/strong> link next to <strong>Publish immediately<\/strong>, you are given the ability to schedule the alternate version to replace the live content at a specific date and time<\/li>\n<li><strong>Replace Original<\/strong> \u2014 Replace the original version of this post with the changes you have staged. The alternate will be published as the newest revision of the orignal post. The content of the alternate version will be published and the revision history of the alternate version will be removed.<\/li>\n<li><strong>Move to Trash<\/strong> \u2014 Moves the alternate version to the trash. This works the same way as the trash for real posts \u2014 it does not delete it permanently, but will not let you edit or preview the post until it has been recovered from the trash.<\/li>\n<\/ul>\n<p><\/div>\n<\/div>\n\n<div class=\"bu_collapsible_container \" aria-live=\"polite\" data-customize-animation=\"false\"><h3 class=\"bu_collapsible\" aria-expanded=\"false\"tabindex=\"0\" role=\"button\">Edit an Alternate Version as a Contributor or Section Editor<\/h3><div class=\"bu_collapsible_section\" style=\"display: none;\"><\/p>\n<p>These options are available to you if you have a user role that permits you to edit and publish content. If the user editing the alternate version has limited capabilities \u2014 for example, if they have the Contributor role assigned or they are a member of a <a href=\"\/tech\/services\/cccs\/websites\/www\/wordpress\/advanced-workflows\/section-editing\/\">section editing group<\/a>, they will have a slightly different view.<\/p>\n<p><div id=\"attachment60621\" style=\"width: 519px\" class=\"wp-caption alignnone\"><img aria-describedby=\"caption-attachment60621\" loading=\"lazy\" class=\"size-medium wp-image-60621  \" height=\"300\" width=\"509\" title=\"training-se-home-clone\" alt=\"Home page alternate version, limited permissions\" src=\"\/tech\/files\/2012\/11\/training-se-home-clone-636x375.jpg\" srcset=\"https:\/\/www.bu.edu\/tech\/files\/2012\/11\/training-se-home-clone-636x375.jpg 636w, https:\/\/www.bu.edu\/tech\/files\/2012\/11\/training-se-home-clone-1024x604.jpg 1024w, https:\/\/www.bu.edu\/tech\/files\/2012\/11\/training-se-home-clone.jpg 1053w\" sizes=\"(max-width: 509px) 100vw, 509px\" \/><p id=\"caption-attachment60621\" class=\"wp-caption-text\">Home page alternate version, limited permissions<\/p><\/div><\/p>\n<p><div id=\"attachment60620\" style=\"width: 272px\" class=\"wp-caption alignnone\"><img aria-describedby=\"caption-attachment60620\" loading=\"lazy\" class=\"size-full wp-image-60620  \" height=\"164\" width=\"262\" title=\"training-se-home-clone-publish-metabox\" alt=\"Publish metabox for alternate versions, as viewed by a contributor\" src=\"\/tech\/files\/2012\/11\/training-se-home-clone-publish-metabox.jpeg\" \/><p id=\"caption-attachment60620\" class=\"wp-caption-text\">Publish metabox for alternate versions, as viewed by a contributor<\/p><\/div><\/p>\n<p>The key difference is that this user does not have the ability to replace the original post. They can save drafts, and they can notify administrators that their changes are ready for review and publishing by clicking <strong>Submit for Review<\/strong>, but they cannot replace the original post themselves.<\/p>\n<p>The use of the BU Versions plugin in conjunction with the <a href=\"\/tech\/services\/cccs\/websites\/www\/wordpress\/advanced-workflows\/section-editing\/\">BU Section Editing plugin<\/a> creates a useful and controlled publishing workflow \u2014 very good for sites with many content editors that should not be able to publish content anywhere without approval by a higher authority.<\/p>\n<p><\/div>\n<\/div>\n\n<div class=\"bu_collapsible_container \" aria-live=\"polite\" data-customize-animation=\"false\"><h3 class=\"bu_collapsible\" aria-expanded=\"false\"tabindex=\"0\" role=\"button\">In-Progress Alternate Versions<\/h3><div class=\"bu_collapsible_section\" style=\"display: none;\"><\/p>\n<p>Saving an alternate version as a draft allows users to save changes incrementally without immediately replacing the original post.\u00a0<strong>You can only have one alternate version per post at any given time<\/strong>. When a post has an alternate version in progress, it can be accessed from a few different locations.<\/p>\n<h4>Access an Alternate Version From the Edit Posts Table<\/h4>\n<p><div id=\"attachment60622\" style=\"width: 519px\" class=\"wp-caption alignnone\"><img aria-describedby=\"caption-attachment60622\" loading=\"lazy\" class=\"size-medium wp-image-60622  \" height=\"313\" width=\"509\" title=\"training-table-with-alt-home\" alt=\"Pages table with alternate version of home page \u2014 WordPress Training\" src=\"\/tech\/files\/2012\/11\/training-table-with-alt-home-636x391.jpg\" srcset=\"https:\/\/www.bu.edu\/tech\/files\/2012\/11\/training-table-with-alt-home-636x391.jpg 636w, https:\/\/www.bu.edu\/tech\/files\/2012\/11\/training-table-with-alt-home-1024x630.jpg 1024w, https:\/\/www.bu.edu\/tech\/files\/2012\/11\/training-table-with-alt-home.jpg 1053w\" sizes=\"(max-width: 509px) 100vw, 509px\" \/><p id=\"caption-attachment60622\" class=\"wp-caption-text\">Pages table with alternate version of home page \u2014 WordPress Training<\/p><\/div><\/p>\n<p>On the edit pages table pictured above you can see that the <strong>create clone<\/strong> button has been replaced by one that reads <strong>edit version<\/strong> for the page \u201cWordPress Training.\u201d This lets you know that an alternate version exists for that page, and you can edit it by clicking on that link. As always, you can edit the original by clicking on the post title, or by hovering over the post row and clicking the <strong>Edit<\/strong> button that appears beneath the title.<\/p>\n<h4>View Only Alternate Versions<\/h4>\n<p>With the alternate version workflow in place, it is possible for multiple posts and pages to have alternate versions in progress at once.<\/p>\n<p>You can filter the admin post table to display only alternate versions by clicking on the <strong>Alternate Versions<\/strong> link above the table.<\/p>\n<p><div id=\"attachment60617\" style=\"width: 519px\" class=\"wp-caption alignnone\"><img aria-describedby=\"caption-attachment60617\" loading=\"lazy\" class=\"size-medium wp-image-60617  \" height=\"313\" width=\"509\" title=\"training-filter-by-alt-versions\" alt=\"The \u201cPages\u201d table, filtered to only display alternate versions\" src=\"\/tech\/files\/2012\/11\/training-filter-by-alt-versions-636x391.jpg\" srcset=\"https:\/\/www.bu.edu\/tech\/files\/2012\/11\/training-filter-by-alt-versions-636x391.jpg 636w, https:\/\/www.bu.edu\/tech\/files\/2012\/11\/training-filter-by-alt-versions-1024x630.jpg 1024w, https:\/\/www.bu.edu\/tech\/files\/2012\/11\/training-filter-by-alt-versions.jpeg 1053w\" sizes=\"(max-width: 509px) 100vw, 509px\" \/><p id=\"caption-attachment60617\" class=\"wp-caption-text\">The \u201cPages\u201d table, filtered to only display alternate versions<\/p><\/div><\/p>\n<h4>Access an Alternate Version While Editing the Original<\/h4>\n<p><div id=\"attachment60614\" style=\"width: 285px\" class=\"wp-caption alignnone\"><img aria-describedby=\"caption-attachment60614\" loading=\"lazy\" class=\"size-full wp-image-60614  \" height=\"95\" width=\"275\" title=\"edit-original-notification\" alt=\"Notification of alternate version while editing original post\" src=\"\/tech\/files\/2012\/11\/edit-original-notification.jpeg\" \/><p id=\"caption-attachment60614\" class=\"wp-caption-text\">Notification of alternate version while editing original post<\/p><\/div><\/p>\n<p>A notification will appear while editing a post that has an alternate version in progress. This notification includes a link to edit the alternate version, which will open in a new tab or window to prevent you from losing any changes to the post you are currently editing.<\/p>\n<h4>Access the Original Post While Editing an Alternate Version<\/h4>\n<p><div id=\"attachment60613\" style=\"width: 482px\" class=\"wp-caption alignnone\"><img aria-describedby=\"caption-attachment60613\" loading=\"lazy\" class=\"size-full wp-image-60613  \" height=\"95\" width=\"472\" title=\"edit-alt-version-notification\" alt=\"Notification while editing alternate version\" src=\"\/tech\/files\/2012\/11\/edit-alt-version-notification.jpeg\" \/><p id=\"caption-attachment60613\" class=\"wp-caption-text\">Notification while editing alternate version<\/p><\/div><\/p>\n<p>Similarly, a notification will appear while editing an alternate version with a link to edit the original post. This link will open in a new tab or window to prevent you from losing any changes you have made to the alternate version.<\/p>\n<p><\/div>\n<\/div>\n\n<div class=\"bu_collapsible_container \" aria-live=\"polite\" data-customize-animation=\"false\"><h3 class=\"bu_collapsible\" aria-expanded=\"false\"tabindex=\"0\" role=\"button\">Admin Bar Integration<\/h3><div class=\"bu_collapsible_section\" style=\"display: none;\"><\/p>\n<p><div id=\"attachment60612\" style=\"width: 570px\" class=\"wp-caption alignnone\"><img aria-describedby=\"caption-attachment60612\" loading=\"lazy\" class=\"size-full wp-image-60612  \" height=\"197\" width=\"560\" title=\"admin-bar-ui\" alt=\"Admin bar, shown while viewing the site\" src=\"\/tech\/files\/2012\/11\/admin-bar-ui.jpeg\" \/><p id=\"caption-attachment60612\" class=\"wp-caption-text\">Admin bar, shown while viewing the site<\/p><\/div><\/p>\n<p>If you have the admin bar enabled when viewing your site, you can use it to access the editing interface for both the original post and the alternate version.<\/p>\n<p>If the page you are viewing does not have an alternate version, there will be an <strong>Edit<\/strong> button which links to the editing interface for that post.<\/p>\n<p><div id=\"attachment60610\" style=\"width: 582px\" class=\"wp-caption alignnone\"><img aria-describedby=\"caption-attachment60610\" loading=\"lazy\" class=\"size-medium wp-image-60610  \" height=\"265\" width=\"572\" title=\"admin-bar-no-alt-version\" alt=\"Admin bar, current page does not have an alternate version\" src=\"\/tech\/files\/2012\/11\/admin-bar-no-alt-version-636x294.jpg\" srcset=\"https:\/\/www.bu.edu\/tech\/files\/2012\/11\/admin-bar-no-alt-version-636x294.jpg 636w, https:\/\/www.bu.edu\/tech\/files\/2012\/11\/admin-bar-no-alt-version.jpeg 711w\" sizes=\"(max-width: 572px) 100vw, 572px\" \/><p id=\"caption-attachment60610\" class=\"wp-caption-text\">Admin bar, current page does not have an alternate version<\/p><\/div><\/p>\n<p>If the page you are viewing has an alternate version in progress, the <strong>Edit<\/strong> button will gain an arrow, and hovering over it will reveal another option: <strong>Edit Alternate Version<\/strong>.<\/p>\n<p><div id=\"attachment60611\" style=\"width: 583px\" class=\"wp-caption alignnone\"><img aria-describedby=\"caption-attachment60611\" loading=\"lazy\" class=\"size-full wp-image-60611 \" height=\"290\" width=\"573\" title=\"admin-bar-orig-w-alt-version\" alt=\"Admin bar, current page has an alternate version in progress\" src=\"\/tech\/files\/2012\/11\/admin-bar-orig-w-alt-version.jpeg\" \/><p id=\"caption-attachment60611\" class=\"wp-caption-text\">Admin bar, current page has an alternate version in progress<\/p><\/div><\/p>\n<p>If you do not see the admin bar and would like to, visit <strong>Users<\/strong> &gt; <strong>Your Profile <\/strong>in the WordPress Dashboard\u00a0\u00a0and select the <strong>Show Admin Bar<\/strong> setting.<\/p>\n<p><\/div>\n<\/div>\n\n","protected":false},"excerpt":{"rendered":"<p>The alternate versions workflow starts with a published post. WordPress uses the term post generically to refer to all content that shares the Post admin user interfaces. A post type is a specific instance of a post \u2014 both Post and Page are built-in examples of post types. In addition, plugins and themes may add&#8230;<\/p>\n","protected":false},"author":1303,"featured_media":0,"parent":60608,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/pages\/61218"}],"collection":[{"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/users\/1303"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/comments?post=61218"}],"version-history":[{"count":6,"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/pages\/61218\/revisions"}],"predecessor-version":[{"id":61221,"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/pages\/61218\/revisions\/61221"}],"up":[{"embeddable":true,"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/pages\/60608"}],"wp:attachment":[{"href":"https:\/\/www.bu.edu\/tech\/wp-json\/wp\/v2\/media?parent=61218"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}