.. -*-doctest-*-

======================
Relative Path Criteria
======================

The RelativePathFormCriterion is provided for rendering a relative
path widget on the search form.

We start with a topic.

    >>> foo_topic = self.folder['foo-topic-title']

Open a browser as an anonymous user.

    >>> from Products.Five.testbrowser import Browser
    >>> from Products.PloneTestCase import ptc
    >>> browser = Browser()
    >>> browser.handleErrors = False

Add a path criterion for the subject/keywords.

    >>> foo_topic.addCriterion(
    ...     'path', 'RelativePathFormCriterion')
    <RelativePathFormCriterion at
    /plone/Members/test_user_1_/foo-topic-title/crit__path_RelativePathFormCriterion>

Designate the criterion's field as a form field.

    >>> crit = foo_topic.getCriterion('path_RelativePathFormCriterion')
    >>> crit.setFormFields(['relativePath', 'recurse'])
    
When viewing the collection in a browser path fields will be
rendered for the field.

    >>> browser.open(foo_topic.absolute_url())
    >>> browser.getControl('Relative path')
    <Control
    name='form_crit__path_RelativePathFormCriterion_relativePath'
    type='text'>
