Index Application

The page index offers a quick way of accessing and managing pages and attachments in your wiki. The page list is available by clicking the DrawerMenuIcon.png button which opens the drawer menu, then on "Page Index".

DocumentIndexMenu.png

Page Index View

The "Index" tab displays all the wiki pages alphabetically  using the {{documents /}} macro and allows you to filter them by different criteria like title, location, the last edit date and the last author. Depending on the user privileges, the "Actions" column displays 4 possible actions for each page: delete, copy, rename and edit the access rights.

DocumentIndex.png

The "Location" column displays the location of the page in the reference hierarchy and allows to filter at several path levels.

DocumentIndexFilterLocation.png

Also, XWiki has introduced the "Title" column instead of the old "Page" column because all nested pages are called WebHome, so displaying this value would not be user-friendly. However, note that XWiki doesn't support filtering on page titles.

The "Orphaned Pages" tab is visible only if the Parent-Child Hierarchy Mode is enabled, which is not the case by default. A system administrator can enable it at any time by setting the core.hierarchyMode property to parentchild in the /WEB-INF/xwiki.properties configuration file, followed by a server restart. 

Page Tree View

The "Tree" tab displays a tree view of all pages and attached files using the reworked Document Tree Macro and is thus honoring the Nested Pages paradigm.

TreeView.png

The Document Tree Macro is based on a JQuery plugin named jstree. For more details, check the dedicated documentation pages listed in the "Related Pages" section under "Programming Guide". Also, the integrated Page Tree Finder allows to easily locate pages and attachments. 

DocumentTreeFinder.png

Attachments View

The "Attachments" tab lists all files attached to XWiki pages that you can now sort and filter by file name, file type, size or date (thanks to the new range picker). 

File Type FilterFile Size FilterDate Range Filer
FileTypeFilter.pngFileSizeFilter.pngDateRangeFilter.png

Just like in the case of page attachments the "Type" column displays:

  • a thumbnail preview for image attachments
  • an icon for non-image files depending on their extension (the icons are using the configured Icon Theme)

AllAttachments.png

Similarly to the Page Index, you can search for attachments in the nested pages hierarchy using the new "Location" column that has replaced the old "Page" and "Space" columns.

AttachmentsLocation.png

Deleted Pages and Attachments

Additionally, provided you have wiki administration rights, you will see a livetable of deleted pages 

DeletedDocuments.png

and deleted attachments.

DeletedAttachments.png

Deleted pages and attachments are stored in a database in the "xwikirecyclebin" and "xwikiattrecyclebin" tables. In order to permanently delete a page from recycle bin, click on the "X" button in the "Actions" column.

Restore Deleted Pages and Attachments

To recover an individual page, click on the green icon in the "Actions" column. Note that if a new page has been created with the same name, the deleted one cannot be restored anymore. 

In case you have performed a delete operation that removed multiple pages at the same time (like deleting a nested page and its children), it is now possible to restore them all together to their original state and location. This is possible by assigning a common batch ID to the deleted pages in the recycle bin so that you can now browse the deleted documents and group them by batch.

To list the deleted pages from the same batch, simply click the link in the "Deleted Batch ID" column.

DeletedBatchID.png

You will be redirected to the restore screen where you can choose to either restore just that page or the entire batch of pages that were deleted with it. Note that you are only seeing the pages from that batch that still exist in the recycle bin. It is possible for some pages to have been restored in the meantime or to have been deleted from the recycle bin. 

RestoreBatch.png

The batch ID is also displayed in the "Notice" screen when trying to access a deleted page and clicking it will redirect to the batch restore screen.

NoticeScreen.png

After clicking on "Restore" an asynchronous job is launched and if successful you will see a confirmation message.

RestoreBatchSuccess.png

If a page from the batch was recreated in the meantime with the same name and in the same location as the deleted one, then the restore operation will report as failed, even if all the other pages may have been successfully restored. An advanced user can inspect the log to see which page from the batch failed to restore.

RestoreBatchFail.png

In order to be able to restore a deleted translation, the main page containing the default translation needs to be restored first or recreated. To do that you have 2 options:

  • restore the default translation from the "Deleted Pages" tab
  • click on the disabled restore button of the translation and you will be redirected to the location of the default page where you can re-create it.

Regarding deleted attachments, they cannot be restored separately, but along with the deleted page that contained them. You will need to restore the page, then rollback to a version before the attachment was deleted. In case the page is no longer in recycle bin, the deleted attachment cannot be recovered any more.

To work around database limitation when deleting pages with many attachments, a new file recycle bin component has been introduced. You can enable it in the "WEB-INF/xwiki.cfg" configuration file with the following:

xwiki.store.recyclebin.content.hint=file

Page Children

Nested or non-terminal Pages are wiki pages that can have other child pages which are also known as terminal.

In order to access the children of a nested page, click the PageActionsMenuButton.png button and choose "Children" in the "Viewers" section.

ContentMenuChildren.png 

The livetable is similar to the one displayed by the "Index" tab of the wiki page index. You may filter pages by location or last modification date and, depending on the user privileges, you can also copy, delete, rename pages and change the page access rights.

PageChildren.png

Page Siblings

For terminal pages, the "Siblings" livetable is available by clicking the PageActionsMenuButton.png button, then on "Siblings" 

ContentMenuSiblings.png 

and displays the pages having the current page as parent. 

PageSiblings.png

       

Search this space