13/04 2014

ViewHelper References Updated

A few annoyances and missing references have been fixed - with a huge improvement for PHPStorm users.

Dear developers,

Today the ViewHelper references have been updated to fix a few incorrect values and XSD files incompatible with the PHP namespaces we switched to have been updated (and in extension of this, the missing references for the development branches of our extensions). Perhaps most importantly, the arguments in references are now correctly displayed - within the limitations posed by the standard XSD format. Basically this means that ViewHelpers which require object instances as parameters, will display as "mixed" or "anySimpleType" in the type column. In these cases the actual expected type is prepended to the description - but this only works for XSD files we will be generating in the future, the current archive of XSD files will not be updated (but you are welcome to contribute fixed versions! Get in touch with us if you do).

For all IDEs/editors

Since Fluid only requires the xmlns on the container tag in your template, you only need to copy/paste the example namespace inclusion from the landing pages of the extension you wish to use. Make sure you select the right version!

You do not need to include the namespacename:schemaLocation unless you are convinced your editor supports this. The sad news is that in all likely it does not.

For PHPStorm users

Congratulations on your choice - you only need to copy both the xmlns:namespacename and namespacename:schemaLocation in order to enable full-on autocompletion for all Fluid ViewHelper tags. Zero configuration needed. PHPStorm will download (and cache) the schema file, only checking it for updates on application startup and only downloading it when updates are needed. Pointing the schemaLocation parameter to another version of the XSD file also means the autocompletion feature switches to this version.

Full change list

1. XSD files and references updated (some still pending, the next commit in git will trigger building).
2. Automatic XSD building on new TER release - you should now see the XSD and documentation for new versions appear within an hour after release.
3. Development branch added to documentation and XSD downloads. The development branch XSD and documentation updates itself every hour.
4. Namespace inclusion examples changed and made copy-paste friendly, switched from old to new style.

The changes are also available in EXT:schemaker on github and will be released on TER as well shortly.

Kind regards,
The FluidTYPO3 Team