4.15 Point in time

Summary

Daisy keeps track of each document's "timeline". The timeline contains information about which version was live at any given point in time (hence the name of the feature).To the end user, the feature presents itself as a non-intrusive widget on your Daisy wiki. This widget allows the user to choose the version-mode. The versionmode can be 'last', 'live' or an arbitrary date.When selecting a date, the user sees the site "as it was" on the selected date. Selecting 'live' is the same as selecting the current date. Selecting 'last' is the same as selecting 'live' after making the lastversion of every document the live one.

Administration

This feature is active by default, but by default the version-mode widget is not displayed to guest users.By default, the version-mode widget only lets you select dates. If you want more fine-grained control (i.e. hours, minutes and seconds)

• This page explains how to enable the version-mode widget for guest users and how to enable selecting hours,minutes and seconds.

The full-text index maintains a separate entry for each entry in the timeline. For large repositories this may impose a large load on the repository server.

• This page explain how to instruct the full-text index index to only maintain an entry for the 'currently live' version of each document.

Access Control

Live history publish permission

With the live history publish permission users can make arbitrary changes to the timeline. There are two simple use-cases for this:

• History-alteration: When making changes using past dates - e.g. to remove a version which should never have been live from the live history.
• Planning ahead: When you create a 'future' timeline entry, you are essentially planning certain versions to 'go live' at a given date.

Without the 'Live history' detail permission users can only change the current live version.

Live history read permission

If the live history read permission is granted users can read all versions listed in the document's timeline.Note that this permission doesn't have any effect if you already have read non-live access.

See the Access Control documentation page for all information.

Gotcha's

Import & Export

The import and export tools do not copy the timeline data. In fact they only copy one version of your documents at a time. If you want to synchronize the complete document histories between two repositories (i.e. including all versions and the timeline information),you should consider using the replication service.

Various

• You can select dates in the future. (It can be interesting to review the 'future planned versions')
• When the version-mode is a date, viewing a document without a live version at the selected date results in a 'Version not found' error.
• Browsing with version-mode='live' is different from version-mode='{today}'.When browsing with the version-mode set to a specific date without hours, minutes and seconds, you actually get the document, as it was at the very start of that day (00h 00m 00s), so changes made during that day will not be seen.