tollwerk / tw-viewhelpers

v3.0.0 2026-09-28 12:32 UTC

Requires

• php: >= 8.3
• typo3/cms-core: ^14
• typo3/cms-fluid-styled-content: ^14

MIT

• Klaus Fiedler

• typo3

Published on Packagist.org on 2026-09-28 12:33 UTC

README

A small collection of useful Fluid ViewHelpers for TYPO3.

Installation

Install extension with composer

composer require tollwerk/tw-viewhelpers

Available ViewHelpers

Image/InlineSvg

Render the content of a given file as an inline SVG image. The given file can be one of the following:

• TYPO3\CMS\Extbase\Domain\Model\FileReference
• TYPO3\CMS\Core\Resource\FileReference
• String of absolute or relative image path, uses GeneralUtility::getFileAbsFileName() to resolve the path

    <!-- Relative path, starting from TYPO3 'public' directory-->
    <twvhs:image.inlineSvg image="favicon.svg" />
    <twvhs:image.inlineSvg image="fileadmin/image.svg" />

    <!-- Absolute server path -->
    <twvhs:image.inlineSvg image="/var/www/path/to/image.svg" />

    <!-- Extension directory -->
    <twvhs:image.inlineSvg image="EXT:my_extension/Resources/Public/Images/image.svg" />

    <!-- FileReference (both TYPO3 core and Extbase) -->
    <twvhs:image.inlineSvg image="{someCoreOrExtbaseObject.image}" />
    

Link/TypolinkInfo

Decode a typolink string and return all properties as array.

<!-- Decode typolink string. Will return an array with all properties of that link. -->
<f:debug>{twvhs:link.typolinkInfo(typolink: 't3://page?uid=1 _blank link-css-class "This is the link title" foo=bar my-special-rel-value')}</f:debug>

Page/LastUpdate

Get date and author of the last change to a given page.

<!-- Show last update of page with UID 1 -->
<f:debug>{twvhs:page.lastUpdate(page: 1)}</f:debug>

<!-- Show last update of given page record -->
<f:debug>{twvhs:page.lastUpdate(page: page.uid)}</f:debug>

Heading

Render an HTML headline element, but with the ability to set the headline level manually or dynamically.

<!-- 
Manually set the level:
<h5 class="Heading Heading--h5">Hello world</h5> 
-->
<twvhs:heading level="5" content="Hello world!" />

<!--
Nesting and dynamic level:
<h2 class="Heading Heading--h2">Hello</h2>
<h3 class="Heading Heading--h3">world!</h3> 
-->
<twvhws heading level="2" content="Hello">
    <twvhs:heading content="world!" />
</twvhws>

<!-- 
Set other CSS class than the actual level:
<h2 class="Heading Heading--h5">Hello world!</h2> 
-->
<twvhs: heading level="2" type="5" content="Hello world!" />

<!-- 
Add custom CSS classes
<h1 class="Heading Heading--h1 my-custom-class">Hello world!</h1> 
-->
<twvhs: heading class="my-custom-class" content="Hello world!" />