Package com.atlassian.confluence.util.breadcrumbs

Interface BreadcrumbGenerator

    • Method Detail

      • getFilteredBreadcrumbTrail

        List<Breadcrumb> getFilteredBreadcrumbTrail​(ConfluenceActionSupport action,
                                            javax.servlet.http.HttpServletRequest request)
        Returns the breadcrumb trail after filtering.

        Since the new header (published in Confluence 5.0), we filter out the Dashboard from the breadcrumbs. We also filter out the last breadcrumb in the trail (usually the page name), unless the breadcrumb's filterTrailingBreadcrumb method returns false.

        Parameters:
        action - the action to build breadcrumbs for
        request - the request to build breadcrumbs for
        Returns:
        the filtered trail of breadcrumbs

      • getFilteredBreadcrumbTrail

        List<Breadcrumb> getFilteredBreadcrumbTrail​(Space space,
                                            Breadcrumb breadcrumb)
        Returns the breadcrumb trail after filtering.

        This method should be used when a breadcrumb is generated independently of an action - E.g. when showing the new location of a page in the move page dialog.

        Parameters:
        space - the space in which the breadcrumb belongs, or null when this is not applicable
        breadcrumb - the breadcrumb to retrieve a filtered trail for
        Returns:
        the filtered trail of breadcrumbs

      • getContentActionBreadcrumb

        Breadcrumb getContentActionBreadcrumb​(com.opensymphony.xwork2.Action action,
                                      Space space,
                                      AbstractPage page,
                                      DisplayableLabel label)
        Returns an appropriate breadcrumb for the given action, space, page and label.
        Parameters:
        action - the action to retrieve the breadcrumb for
        space - the space to retrieve the breadcrumb for, can be null for global labels
        page - the page to retrieve the breadcrumb for, can be null when retrieving breadcrumb for a label
        label - the label to retrieve the breadcrumb for, can be null when retrieving breadcrumb for a page
        Returns:
        the appropriate content breadcrumb for the given action, space, page and label.

      • getContentDetailActionBreadcrumb

        Breadcrumb getContentDetailActionBreadcrumb​(com.opensymphony.xwork2.Action action,
                                            Space space,
                                            AbstractPage page)
        Breadcrumb for the "detail" pages of a Page/Blog, like Info, Attachments or History. It displays "Collector > Parent > Page Name".

        This breadcrumb is not to be used for actions on content itself, like ViewPageAction, which should use getContentActionBreadcrumb(Action, Space, AbstractPage, DisplayableLabel).

        Parameters:
        action - the action to retrieve the breadcrumb for
        space - the space to retrieve the breadcrumb for
        page - the page to retrieve the breadcrumb for
        Returns:
        the breadcrumb for the Content Details.

      • getContentBreadcrumb

        Breadcrumb getContentBreadcrumb​(Space space,
                                AbstractPage page)
        Returns an appropriate breadcrumb for a page or blogpost
        Parameters:
        space - the space to retrieve the breadcrumb for
        page - the page or blogpost to retrieve the breadcrumb for
        Returns:
        the breadcrumb for the content

      • getContentCollectorBreadcrumb

        Breadcrumb getContentCollectorBreadcrumb​(Space space,
                                         Class contentClass)
        Returns an appropriate collector page breadcrumb to represent content at the root level of a space conforming to the new space information architecture.

        This should only be used for retrieving a breadcrumb for content creation at the root level of a space - once the content exists, the breadcrumb for that content should be used instead.

        Parameters:
        space - the space to retrieve a collector breadcrumb for.
        contentClass - the type of content to retrieve a collector breadcrumb for.
        Returns:
        the breadcrumb for an appropriate collector page, or null when there is nothing applicable.

      • getSpaceAdminBreadcrumb

        Breadcrumb getSpaceAdminBreadcrumb​(com.opensymphony.xwork2.Action action,
                                   Space space)
        Returns the breadcrumb for a space admin action in a space.
        Parameters:
        action - the action to retrieve a space admin breadcrumb for.
        space - the space to retrieve a space admin breadcrumb for.
        Returns:
        a space admin breadcrumb.

      • getSpaceOperationsBreadcrumb

        Breadcrumb getSpaceOperationsBreadcrumb​(Space space)
        Returns the space operations breadcrumb (i.e. Browse Space for spaces that don't conform to the new space information architecture) in a space.
        Parameters:
        space - the space to retrieve a space operations breadcrumb for.
        Returns:
        a space operations breadcrumb.

      • getAdvancedBreadcrumb

        Breadcrumb getAdvancedBreadcrumb​(Space space)
        Returns the advanced breadcrumb in a space. This falls back to the Browse Space breadcrumb for spaces that don't conform to the new space information architecture. This is the same fallback as for Space Operations, but we shouldn't run into a scenario where both breadcrumbs are requested.
        Parameters:
        space - the space to retrieve an advanced breadcrumb for.
        Returns:
        the advanced breadcrumb

      • getBlogCollectorBreadcrumb

        Breadcrumb getBlogCollectorBreadcrumb​(Space space)