DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Add BITV marker to every section¶

The BITV links and the BITV menu are configured with two userfunctions.

Note

This way works for fluid templates (cObject:FLUIDTEMPLATE) as for pure typoscript renderings(cObject: TEMPLATE) as well. But be always assure that the navigation copied from the typoscript Object lib.tx_form4_bitv.navigation comes after the registration of the section links! See the example for more infos.

Here a small explaination of the first userfunction to register a BITV link and the depending settings. Here as a pure USER cObject:

lib.example = USER
lib.example = FORM4\Form4Bitv\Utility\BitvUtility->setBitvAnchor
# this is the name for the label in link and the navigation it will be used for the language key
#- please see the chapter **Change locallang.xml file** for more details
lib.example.userFunc.anchor = content
# the position is important for the order of the section link in the bitv navigation!
lib.example.userFunc.position = 2

Especially take a look to the comments of the properties: userFunc.anchor and userFunc.position.

The next one is a example if you want to add it to typical typoscript objects, where you should embed the link into the section:

#first render the bitv link
lib.bitvContent = COA
lib.bitvContent{
    # this part should be seen as example - we want the bitv in front of a content object.
    # but you also can just make a single content out of it which renders a TEXT cObject
    # with the given anchor.

    stdWrap {
        prepend = TEXT
        prepend{
            wrap =  <div class="invisible"><hr /><p><strong>|</strong></p></div>
            value = point3
         }
         append = USER
         append.userFunc = FORM4\Form4Bitv\Utility\BitvUtility->setBitvAnchor
         append.userFunc.anchor = subnavigation
         append.userFunc.position = 1
         required = 1        # end of including the bitv field - the ret just as an use case.
         outerWrap = <nav id="main-navigation">|</nav>
    }
    # this could maybe your section Element if you want to add it in the the old typoscript way.
    10 < styles.content.get
    10.content.select.where = colPos=0
    10.stdWrap.outerWrap = <div class="myexampleContent">|</div>
}

To configure the BITV markers you need to add a typoscript configuration like this to every key section of the page. So the links will only be created if the section is rendered and one or more of these sections and their corresponding BITV links can be removed and the BITV navigation will still works fine.

With a FLUIDTEMPLATE you might want to add it combined with a fluid content object.