❗ NEW DEPRECATIONS AND REMOVED DEPRECATED CODE

• 49e2295 Deprecated VHS typoLink ViewHelpers (use core versions instead)
• 'includeHidden', 'showHiddenInMenu' attributes deprecated on all Menu ViewHelpers
• 'linkAccessRestrictedPages' was deprectaed in favor of 'showAccessProtected' on all Menu ViewHelpers
• 'resolveExclude', 'showHidden', 'excludeSubpageTypes' attributes removed from all Menu ViewHelpers
• Removed FluidTYPO3\Vhs\Service\PageSelectService (use FluidTYPO3\Vhs\Service\PageService and TYPO3 native TYPO3\CMS\Frontend\Page\PageRepository instead)
• #1023 RegEx related ViewHelpers changed
• v:condition.string.preg removed and v:variable.pregMatch should be used instead
• v:format.regularExpression removed and v:format.pregReplace should be used instead
• v:variable.pregMatch
• v:format.pregReplace
• #1003 v:switch and v:case ViewHelpers removed (use core versions instead)
• 7ca6865 Argument arguments on Asset ViewHelpers removed (use variables instead)

#970 PHP7 is supported

TYPO3 8 supported

❗ #974 'allowMoveToFooter' attribute removed from asset ViewHelpers

• use 'movable' instead

❗ fc1baf9 'name' attribute removed from v:variable.extensionConfiguration

• use 'path' instead
• v:variable.extensionConfiguration

❗ #1003 v:switch and v:case ViewHelpers removed

• use f:switch and f:case from Fluid itself
• check the notes from PR #1003 for migration instruction

❗ #987 Major refactoring of menu ViewHelpers

• WIP: the list of changes and work on this isn't complete yet. Feel free to add more items here to provide a better overview of the work, which was done.
• All the menu ViewHelpers are relocated from v:page.menu.[vh-name] to v:menu.[vh-name]
• Removed FluidTYPO3\Vhs\Service\PageSelectService (use FluidTYPO3\Vhs\Service\PageService and TYPO3 native TYPO3\CMS\Frontend\Page\PageRepository instead)
• v:condition.page.hasSubpages
  • 'includeHiddenInMenu' attribute added - include pages hidden in menu
  • 'includeAccessProtected' attribute added - includes pages, protected by FE groups constraints, see #976
  • 'includeHidden', 'showHiddenInMenu' attributes deprecated
• All the menu ViewHelpers
  • 'showAccessProtected' attribute added - if TRUE links to access protected pages are always rendered regardless of user login status
  • 'classAccessProtected' attribute added - optional class name to add to links which are access protected
  • 'classAccessGranted' attribute added - optional class name to add to links which are access protected but access is actually granted (user is logged in with corrrect FE usergroup)
  • 'resolveExclude', 'showHidden', 'excludeSubpageTypes' attributes removed
• All the menu objects, used in Fluid manual menu rendering
  • got 'accessProtected' property, which indicates, that page is protected by FE groups constraints
  • got 'accessGranted' property, which indicates, that page is protected by FE groups, but currently logged in user can access the page
  • 'hasSubPages' property was renamed to 'hasSubpages' (lowercase P)
• Source commit with more info
• Followup no. 1
• Followup no. 2
• Followup no. 3

❗ #1024 v:page.link functionality was aligned with same link creation behavior, which was introdiced in menu ViewHelpers, regarding shrotcuts and protected pages

• Received new attributes 'showAccessProtected', 'classAccessProtected', 'classAccessGranted', 'useShortcutUid', 'useShortcutTarget', 'useShortcutData'
• 'linkAccessRestrictedPages' was deprectaed in favor of 'showAccessProtected'
• v:page.link

#1022 All the possible ViewHelpers are static compilable, which results in major performance improve

• Discover Static compilable

#955 v:unless ViewHelper added

• Inverted f:if which only supports negative matching
• v:unless

#988 v:iterator.diff ViewHelper added

• Computes the difference of arrays/Traversables
• v:iterator.diff

#1018 v:iterator.unique ViewHelper added

• Accepts a subject and returns or assigns a new uniques-filtered array
• v:iterator.unique

#1019 v:iterator.column ViewHelper added

• Allows doing everything that array_column in PHP does but also supporting Iterator as input
• v:iterator.column

#958 v:page.header.alternate got 'addQueryString' attribute

• If TRUE, the current query parameters will be kept in the URI
• v:page.header.alternate

#980 v:media.youtube got 'enableJsApi' attribute

• Adds enablejsapi=1 to a list of YouTube parameters
• v:media.youtube

aff7034 v:variable.extensionConfiguration returns a complete extension settings in case NULL provided as 'path'

• v:variable.extensionConfiguration

6851420 Image and ImageInfo ViewHelpers cna now correctly recognize a FileReference, supplied as 'src', so no need to set up manually 'treatIdAsUid' and 'treatIdAsReference' attributes

#966 Fixed links of type "external" in menu ViewHelpers

• Source commit with more info

#981 Fixed player_id argument for Vimeo player

#982 Fixed rendering of restricted pages by menu ViewHelpers

#984 Fixed 'caseSensitive' behavior of v:format.replace

#994 Fixed deprecation warnings with TSFE->getPageRenderer()

#995 Fixed 'addQueryString' behavior in v:page.languageMenu

#997 Fixed path to SVG flag icons in v:page.languageMenu

Easter egg: over 1000 commitments into repository!

#1001 v:format.placeholder.image now loads the placeholder via https: https://placehold.it

#953 v:page.resources.fal respects enableFileds, when sliding records by rootline

#1015 v:render.template is aware of TYPO3 7 paths definition (layoutRootPaths and partialRootPaths)

#1042 v:page.header.canonical includes query string, like with addQueryString

#1044 Fix duplicate content in workspace previews

8085f56 v:media.source respect fully qualified uris

456d709 src-set of image ViewHelper works correctly with treatIdAsReference

4ea3cb2 Bug fix for incorrect type cast causing translated FAL records to be incorrectly detected

f38acef Bug fix for returned variable in v:resource.collection

62428e8 Security condition ViewHelpers fixed to work in compiled templates

5e17260 Bug fix for interpretation of movable argument on Assets

9c739c7 Bug fix to localise all FAL records individually

efa01ee Bug fix to exclude DELETED placeholders for FAL records when in workspace mode

[2614c18[(https://github.com/FluidTYPO3/vhs/commit/2614c189ba08cf1b58c9f9fbbd250b7114e593f9) Bug fix to make image sub-ViewHelpers function with changed parent class

#1065 Updated deprecated usage of PageRenderer

TYPO3 7 LTS supported

❗ No more testing for PHP 5.4

❗ Support of TYPO3 6.2 dropped

• For TYPO3 6.2 based projects there will be a legacy branch

❗ #829 'allowMoveToFooter' attribute became deprecated in asset ViewHelpers

• use 'movable' instead

❗ #856 'pageUid' attribute removed from v:render.request

• In fact it was never used, so shouldn't break your code, unless you explicitly defined it
• v:render.request

#906 #907 #908 #909 #910 #911 #912 #913 All the condition (v:condition.*) ViewHelpers are static compilable

• Makes these ViewHelpers compatible with TYPO3 7.3+
• Improves Fluid rendering speed
• Discover Static compilable

#875 Responsive images support added

• v:media.image got 'srcset' attribute, which contains CSV or Traversable with image widths
• v:media.image got 'srcsetDefault' attribute, expected to contain default width, which should be used as fallback for non-srcset aware browsers
• v:media.picture - fully-functional implementation of picturefill

#825 v:page.resources.fal got 'slide', 'slideCollect' and 'slideCollectReverse' attributes, which enables page media to slide

• v:page.resources.fal
• As a bonus, SlideViewHelperTrait introduced

#884 v:media.gravatar and v:uri.gravatar ViewHelpers added

• v:media.gravatar
• v:uri.gravatar
• Gravatar

#945 v:variable.extensionConfiguration can fetch a subpart of extension configuration

• 'path' attribute introduced, which is responsible for this; contains TS-dotted path, like 'bar.baz'
• ❗ 'name' attribute became optional and deprecated
• 'name' and 'path' are both optional, but at least one of them must be set
• v:variable.extensionConfiguration

#883 v:resource.image returns an img-tag instead of an array, when no 'as' attribute provided

• v:resource.image

#861 All the menu ViewHelpers got 'forceAbsoluteUrl' attribute

• Forces menu items to contain absolute URLs
• Default: FALSE

v:page.resources.fal respects overrides in page localizations

• v:page.resources.fal
• Source commit with more info

#921 v:page.header.canonical respects RealURL configuration

• ❗ Due to internal changes, attribute 'normalWhenNoLanguage' is not used anymore and deprecated
• v:page.header.canonical

v:format.tidy got 'encoding' attribute

• Sets string encoding for Tidy
• Default: utf8
• v:format.tidy
• Source commit with more info

v:format.replace got 'caseSensitve' attribute

• Makes replacements case sensitive
• Default: TRUE
• v:format.replace

#847 All the menu ViewHelpers got rid of hardcoded backup values

• This allows to use any variable names in 'as' and 'rootLineAs' attributes

#879 All the menu ViewHelpers respect empty values in page translations

#763 All the menu ViewHelpers respect moved pages in workspaces

#854 v:page.languageMenu correctly detects TYPO3 version and provides appropriate path to flag-images

• v:page.languageMenu

#871 v:page.languageMenu applies both: 'inactive' and 'current' classes, when this is a case

• v:page.languageMenu

#858 Force closing tag (instead of self-closing), when no file specified (or found) for asset

#922 v:page.resources.fal loads resources of current page by default

• v:page.resources.fal

#865 v:resource.image respects fully qualified URIs

• This VH can be used with external storages from now
• v:resource.image

#905 v:page.menu correctly calculates number of translated sub-pages

#915 v:media.image correctly define paths to images, when config.absRefPrefix contains sub-folder in path

• v:media.image

#939 v:resource.record.fal handles workspaces better

• v:resource.record.fal

#898 All the menu ViewHelpers are aware of possible anonymous users, when checking access rights against pages, links to which they generate

• anonymous users are those, who doesn't have a concrete user object, but have group only, like is done in EXT:sfpipauth

#925 v:media.audio correctly handles audio-files with non-lowercase file extension

• v:media.audio

#934 PageSelectService is instantiated via GeneralUtility::makeInstance() instead of new(), making it possible to Xclass

Bugfix to respect 'preload' argument of v:media.audio

• v:media.audio

#826 v:format.wordWrap added - breaks a 'subject' into strings with maximum size of 'limit' (default = 80) characters, breaking with 'break' (default = PHP_EOL) and concatenating them with 'glue' (default = PHP_EOL)

• v:format.wordWrap

#819 v:format.eliminate got 'whitespaceBetweenHtmlTags' attribute, which makes VH to remove all spaces between HTML tags

• v:format.eliminate

#798 v:page.header.meta got 'property' attribute - used for open graph metadata

• v:page.header.meta

#799 v:iterator.filter got 'nullFilter' attribute - allows to filter NULL or empty values

• v:iterator.filter

v:or 'arguments' array also applies on 'alternative' text

• Format is same, as in PHP sprintf
• v:or

❗ Legacy namespace support completely removed

• It is no longer possible to use any of VHS classes by their legacy names. Switch to the proper vendor and namespace.

Reusable Traits implemented to extend ViewHelper capabilities, as a replacement for ViewHelperUtility:

• BasicViewHelperTrait
• ArrayConsumingViewHelperTrait
• TemplateVariableViewHelperTrait
• TagViewHelperTrait

❗ Support of TYPO3 6.0 and 6.1 was dropped

❗ Minimum PHP requirement is now 5.4.0 due to the use of Traits

• Details
• Reason for raising requirement

#734 ❗ v:format.url.sanitizeString changed

• Became deprecated - use v:format.sanitizeString instead
• Got 'customMap' attribute - allows to override built-in replacement mapping with custom one
• v:format.sanitizeString

❗ CompilableAsset concept removed

• Details

#735 Context ViewHelpers added: v:condition.context.isDevelopment, v:condition.context.isProduction, v:condition.context.isTesting and v:context.get

• v:condition.context.isDevelopment - returns TRUE if application context is 'Development' or a sub-context of it
• v:condition.context.isProduction - returns TRUE if application context is 'Production' or a sub-context of it
• v:condition.context.isTesting - returns TRUE if application context is 'Testing' or a sub-context of it
• v:context.get - returns the current application context which may include possible sub-contexts
• Note: these ViewHelpers will work on TYPO3 >= 6.2 only. Read more about contexts in TYPO3

#771 v:variable.extensionConfiguration added - reads extensions settings located in ext_conf_template.txt

• v:variable.extensionConfiguration

#746 v:resource.language added - reads a language file and returns all the translations from it

• v:resource.language

#770 #773 v:media.youtube got more control attributes:

• 'hideControl' - hide player's control bar
• 'hideInfo' - hide player's info bar
• 'playlist' - comma separated list of video IDs to be played
• 'loop' - play the video in a loop
• 'start' - start playing after seconds
• 'end' - stop playing after seconds
• 'lightTheme' - use the player's light theme
• 'videoQuality' - set the player's video quality (hd1080,hd720,highres,large,medium,small)
• 'windowMode' - Set the Window-Mode of the player (transparent,opaque). This is necessary for z-index handling in IE10/11.
• v:media.youtube

#751 v:iterator.filter also accepts an array as 'filter' attribute; in case of array provided as filter, each value of 'subject' is compared with each value of 'filter'

#757 v:iterator.merge can be used in a chain

• suggested usage: {abc -> v:iterator.merge(b: def)}
• v:iterator.merge

Contents of Fluid assets (asset's attribute fluid="TRUE") can be stored (or overridden) with TS 'content' property

• See commit message
• Check asset TS settings

#740 v:page.languageMenu got 'excludeQueryVars' attribute - set to comma-separate list of GET variables to exclude from generated link

• v:page.languageMenu

v:debug got more intelligence in debugging ObjectAccessors - shows properties only accessible in Fluid

• v:debug

#710 ❗ Asset's 'arguments' property is removed - use 'variables' instead

• v:asset.prefetch
• v:asset.script
• v:asset.style

❗ MenuViewHelpers attribute 'useShortcutUid' default value was changed from TRUE to FALSE

• v:page.menu.browse
• v:page.menu.deferred
• v:page.menu.directory
• v:page.menu.list
• v:page.breadCrumb
• v:page.menu

#688 v:condition.type.isBoolean added

• v:condition.type.isBoolean

#697 v:format.removeXss added - accepts 'string' as argument and cleans it out from possible XSS

• Not included in VH reference, so please check commit

• v:page.languageMenu

#681 v:tag added - generate dynamic HTML tag names without breaking XHTML validation and with nice features, like disabling empty attributes

• Check release notes to find out more about this VH
• v:tag

v:iterator.filter got 'invert' attribute - inverts the behavior of the ViewHelper, so the filtered element is removed from the array

• v:iterator.filter

❗ Asset's 'arguments' property is deprecated - use 'variables' instead

• v:asset.prefetch
• v:asset.script
• v:asset.style

v:iterator.extract got 'single' attribute - returns the first value instead of always returning all values

• v:iterator.extract

#545 ❗ PHP namespaces support

• VHS now uses the FluidTYPO3\Vhs namespace which means you are advised to change all your Fluid namespace inclusions.
• {namespace v=Tx_Vhs_ViewHelpers} -> {namespace v=FluidTYPO3\Vhs\ViewHelpers}
• xmlns:v="http://fedext.net/ns/vhs/ViewHelpers" -> xmlns:v="http://typo3.org/ns/FluidTYPO3/Vhs/ViewHelpers"
• More info

#540 ❗ Deprecated ViewHelpers removed

• v:var namespace is now v:variable
• v:if namespace is now v:condition
• v:condition ViewHelper is removed (use v:if)
• all the ViewHelpers from v:condition namespace were reworked - check VHS reference page
• v:form.hasValidator is now v:condition.form.hasValidator
• v:form.required is now v:condition.form.isRequired
• all the client-information ViewHelpers: ..client.isBrowser, ..client.isMobile, ..client.isSystem removed
• v:if.condition - use v:if, it can do the same
• v:if.condition.extend - use v:if, it can do the same
• v:iterator.contains is now v:condition.iterator.contains
• v:page.content.footer is now v:page.footer
• v:page.content.get is now v:content.get
• v:page.content.render is now v:content.render
• v:page.siteUrl is now v:site.url
• v:var.isset is now v:condition.variable.isset

#643 ❗ ImageInfoViewHelpers attribute path renamed to src

• v:media.image.height
• v:media.image.width
• v:media.image.mimetype

❗ 'allowMoveToFooter' property renamed to 'movable' in asset definitions through TypoScript

• Check commit message for details

❗ 'showHidden' property is deprecated in MenuViewHelpers

• Check commit message for a reason
• v:page.menu.browse
• v:page.menu.deferred
• v:page.menu.directory
• v:page.menu.list
• v:page.breadCrumb
• v:page.menu

Workspaces support in menus added

• Commit message

#534 v:content.info added - ViewHelper to access data of the current content element record

• v:content.info

v:variable.register.get and v:variable.register.set added - allow to work with TSFE registers

• v:variable.register.get
• v:variable.register.set

v:media.audio added - renders HTML code to embed a HTML5 audio player

• v:media.audio

v:iterator.keys added - gets keys from an iterator

• v:iterator.keys

#578 v:resource.collection added - returns a TYPO3 collection (records or files)

• v:resource.collection

#538 ImageViewHelpers got 'format' and 'quality' attributes

• v:media.image
• v:uri.image

#629 ImageViewHelpers got 'maxW', 'maxH', 'minW', 'minH' attributes

• v:media.image
• v:uri.image

#626 v:iterator.sort can now combine sort flags in 'sortFlags'

• v:iterator.sort

#634 ImageInfoViewHelpers support FAL now via new attributes: 'treatIdAsUid' and 'treatIdAsReference'

• v:media.image.height
• v:media.image.width
• v:media.image.mimetype

#635 v:iterator.chunk fills up missing chunks/elements with NULLs, when 'fixed' is TRUE

• v:iterator.chunk

#641 v:iterator.chunk got 'preserveKeys' attribute

• v:iterator.chunk

v:page.menu.browse got 'pageUid' attribute

• v:page.menu.browse

#660 v:page.menu.browse got 'currentPageUid' attribute

• v:page.menu.browse

#620 v:page.languageMenu got 'pageUid' attribute

• v:page.languageMenu

ContentViewHelpers got 'sectionIndexOnly' attribute - allows to include content elements which are indicated as "Include in section index" in content attributes

• v:render.record
• v:content.get
• v:content.render
• v:content.random.get
• v:content.random.render

#552 Mount points are supported in menus

vhs_main and vhs_markdown caching configurations added, so you may configure to use your own caching backend (e.g. Redis) instead of DB