Using Active Page Reference Filter

Another type of filter is ActivePageReferenceFilter, which is used solely with page data folders and page metatypes.

When you use the Get<DataType>Xml function for these two page-specific datatypes, it retrieves all the data items regardless the page they are attached or added to.

The ActivePageReferenceFilter allows you to retrieve only those items that are specific to a certain page.

By using its Page Scope parameter, you can retrieve items the current page has relation with.

For example, you can retrieve data items specific to the child pages instead of, or in addition to, those specific to the current page.

The following are the page scopes you can use to control what data items to retrieve for page-specific datatypes:

<NONE>
Current page
All pages (no filter)
Ancestors and current (breadcrumbs)
Ancestor pages
Parent pages
Current and descendant pages
Child pages
Sibling pages
Level 1 page (homepage)
Level 1 and descendant pages (current site)
Level 1 and sibling pages (all homepages)
Level 2 page
Level 2 and descendant pages
Level 2 and sibling pages (site main areas)
Level 3 page
Level 3 and descendant pages
Level 3 and sibling pages
Level 4 page
Level 4 and descendant pages
Level 4 and sibling pages