Related Pages API

[cjbrooks12]

The Related Pages API would be another modular list type attached to the Page object, and would have an API similar to Menu Items. Implementations of these modular types would return a list of pages they find to be related to the current page, and can do it in a any way and with any options they need.

The display of these pages is very free-form, and could be displayed as a list of thumbnails, links, and even converted directly/added to the page's Menu (probably just as a MenuItem type that is 'related' and wraps these related pages).

The Apache Lucene integration (#77) would be implemented as a type in this relation.

Open Questions:

• Would this API return the pages directly, or return wrappers around pages, similar to how Menu Items do.
• If there was a wrapper, how would we order these pages? What metric could be shared amongst all implementers that would be able to correctly merge related pages from different relations in a way that is accurate?

To-Do:

• Add RelatedPages as a ModularList type
• Add several implementations, either in Core or as a new plugin
  • Apache Lucene for similar by page content
  • Previous/next pages
  • Raw queries, using the PageRelation
  • Siblings/children in a wiki
  • Classes that implement/extend the current page class in Javadoc
  • Other items in the taxonomy