Nested Page Actions

The Page Administration Menu

The page administration menu is available by clicking on the cog button in the page content area and it has 2 versions depending on the page type. If the page is nested (non-terminal) the menu has the following 4 items:

  • Administer Page
  • Copy 
  • Rename
  • Delete

If the page is terminal (non-nested), "Administer Page" is replaced by "Administer Parent".

Nested Page (Non-Terminal)Non-Nested Page (Terminal)
PageMenuNonTerminal.pngPageMenuTerminal.png

Administer Page

The "Administer Page" menu item redirects to a UI that resembles the old space preferences page ("WebPreferences"). 

The vertical menu on the left allows you to:

  • choose the skin, color theme and icon theme to use
  • decide which panel column to display and the width of each column
  • globally activate or deactivate the display of history, attachments, annotations, comments and page information
  • customize the panels layout using the Panel Wizard
  • set the permissions scheme which can apply either on the current page only or on all its children

AdministerPageUI.png

Administer Parent

The "Administer Parent" UI is the same as "Administer Page" - the only difference is that you are actually customizing the preferences of the parent, not of the page itself.

AdministerParentUI.png

Copy Page

Copy a Terminal Page

For a terminal page, the copy form has 4 elements:

  • Source - the breadcrumb of the page that is going to be copied

    CopyTerminalPageSource.png

  • Copy Title - the title of the target page; by default, this field copies the name of the source, but you can easily change it
  • Location - the location of the target page; by default the path is the same as for the source
  • Copy as Terminal Page - leave this option unchecked if you want to create a nested page instead of a terminal one

    CopyTerminalCopyTitleLocation.png

To change the target page location:

  • click on the blue editing pen icon and select the wiki, parent and name; just like when creating a new page, you may leave the "Parent" field empty in order to create a top-level page, but only provided you leave Copy as Terminal Page unchecked.

    CopyTerminalChangeLocation.png

  • click the blue hierarchy icon and select the wiki and parent from the page tree or search for them using the integrated finder.

    CopyTerminalChangeLocationTree.png

Copy a Nested Page

For a nested page, the copy form has an extra option, "Preserve children", allowing you to copy the entire page hierarchy. 

CopyNestedPageForm.png

To load the children livetable, click on "[x] children".

CopyNestedPageChildrenList.png

In case its previous value was equal to the old page name, the page title is updated when copying a nested page in order to reflect the new page name.

If the page has multiple translations, you can either copy all of them or you may select a particular one.

CopyTranslations.png

The copy process is asynchronous and it is performed in a background thread, when triggered from the UI. After clicking on "Copy" (for both nested and terminal pages), you will be redirected to a status page where you can see the options that have been selected, as well as the progress of the operation. 

CopyStatus.png

If successful, advanced users have access to the copy log from which they can navigate to the target page using the breadcrumbs.

CopyLog.png

Rename Page

Before renaming a page, please be aware of the following limitations:

  • backlinks have to be enabled - they are by default but if you have deactivated them, the rename operation will not update backlinks.
  • backlinks located in XWiki objects and translated content are not currently renamed.
  • backlinks are saved when a page is saved but it is possible for this operation to fail, especially on a clean database. In this special case, you can log in as administrator and call $xwiki.refreshLinks() in a wiki page in order to update all links.

Rename a Terminal Page

When renaming a terminal page, the form displays the following elements:

  • Source - the breadcrumb of the page that is going to be renamed.
  • Update Links - by checking this option, all the links pointing to the source page will be updated in order to point to the target page. To load a livetable with the wiki pages having backlinks to the source page, simply click on [x] incoming links.
  • Create an Automatic Redirect - this option is useful when you have external links like bookmarks that point to the source page and, by selecting it, these links will redirect to the target page.

    RenameTerminalPageUI.png

  • New Title - the title of the target page; by default, this field copies the name of the source, but you may change it
  • New Location - the location of the target page; by default the path is the same as for the source
  • Rename as Terminal Page - leave this option unchecked if you want to create a nested page instead of a terminal one

    RenameTerminalPageUI2.png

To change the target page location:

  • click on the blue editing pen icon and select the wiki, parent and name; just like when creating a new page, you may leave the "Parent" field empty in order to create a top-level page, but only provided you leave Rename as Terminal Page unchecked.

    RenameTerminalChangeLocation.png

  • click the blue hierarchy icon and select the wiki and parent from the page tree or search for them using the integrated finder.

    RenameTerminalChangeLocationTree.png

Rename a Nested Page

For a nested page, the copy form has an extra option, "Preserve children", allowing you to rename the entire page hierarchy. If left unchecked, all pages having this page as parent will become orphaned. 

RenameNestedPageForm.png

To load the children livetable, click on "[x] child pages".

When renaming a nested page, the page title is updated in order to reflect the new page name, provided its previous value was equal to the old page name.

Similarly to the copy operation, the rename process is also asynchronous and it is performed in a background thread, when triggered from the UI. After clicking on "Rename" (for both nested and terminal pages), you will be redirected to a status page where you can see the options that have been selected, as well as the progress of the operation. 

RenameStatus.png

Provided the operation is successful, advanced users have access to the rename log from which they can navigate to the target page using the breadcrumbs.

RenameLog.png

Delete Page

If the page you are about to delete is a terminal page, you will be asked to confirm the operation.

DeleteTerminalPage.png

For nested pages, there is an extra "Affect children ([Number_Of_Children])" option which allows you to delete the entire hierarchy. If left unchecked, all pages having this page as parent will become orphaned. 

DeleteNestedPageChildren.png

On the other hand, if the only child is the "WebPreferences" page, the "Affect children ([Number_Of_Children])" option is checked by default.

DeleteNestedPagePreferences.png

In order to list the children that might be affected, the delete UI uses the "Title" and "Location" columns. The reason why the "Title" column is not filterable is because XWiki doesn't currently support filtering on page title. 

Finally, in case there are pages having backlinks to the one you wish to delete, you will be warned of the fact that those links will point to an empty page, unless you manually remove the links. 

DeletePageBacklinks.png

After clicking on "Yes, please delete this page", you will see a progress bar and a confirmation message, provided there were no errors.

DeletePageSuccess.png

To recover the hierarchy, you will have to restore each page via the "Deleted Pages" tab of the Page Index.

The Content Menu

The content menu also varies depending on the page type. For a terminal page, you have an extra "Siblings" option, whereas for nested pages you have a "Children" option. 

Nested Page (Non-Terminal)Non-Nested Page (Terminal)
MoreActionsMenuNestedPage.pngMoreActionsMenuTerminalPage.png

The rest of the items are the same as for the old "More actions" menu:

  • Export allows exporting the current page in various formats like PDF, RTF, ODF, HTML or XAR
  • Annotate allows accessing the page annotations
  • Print Preview
  • View Source displays the wiki source code of the current page

    PageSource.png

  • In order to Share the page by email either as a link or inline in the message, you need to have a SMTP server correctly configured. 
  • Children - displays the children of the current nested page.

    PageChildren.png

  • Siblings - replaces the old "space index" feature and displays the pages having the same parent as the current terminal page.

    PageSiblings.png

Both "Children" and "Siblings" livetables display the "Title" and "Location" columns which are computed using the page breadcrumb. The reason why the "Title" column is not filterable is because XWiki doesn't currently support filtering on the page title. 
  • Comments allows accessing the page comments
  • Attachments redirects to the files attached to the current page
  • History redirects to the page versions
  • Information displays the backlinks and included pages. The old "Parent" and "Children" sections were removed because there are already dedicated menu items available.

    PageInformation.png

You can also access the page backlinks and included pages by scrolling down to the bottom of the page and clicking on the "Information" tab.

InformationTab.png

               

Search this space