TYPO3-Auxlibs ============= |Build Status| |Latest Version| -------------- This TYPO3 extension provides 3rd party libraries to be used in non-composer mode. Currently the following libraries are available: ================ ======= Library Version ================ ======= hashids/hashids 4.0.0 erusev/parsedown 1.7.4 ================ ======= Libraries --------- Hashids ~~~~~~~ `Hashids `__ is small PHP library to generate YouTube-like ids from numbers. Use it when you don’t want to expose your database ids to the user. Example: .. code:: php $hashids = new \Hashids\Hashids; $handle = $hashids->encode(5, 5, 5); Parsedown ~~~~~~~~~ `Parsedown `__ transforms text with `markdown syntax `__ to html. Example: .. code:: php $parsedown = new \Parsedown; $htmlText = $parsedown->text($markdownText); ViewHelper ^^^^^^^^^^ A ViewHelper is available and can be used as following: .. code:: xhtml {auxlibs:parsedown(text: textWithMarkedownSyntax)} {task.description -> auxlibs:parsedown()} {task.description} The ViewHelper has the following properties: ======== ============================ ==== ======= Property Description Type Default ======== ============================ ==== ======= nl2br If set maintains line breaks bool false ======== ============================ ==== ======= Usage ----- The libraries are automatically loaded in a middleware. In case a library needs to be available at an earlier stage it might be loaded with an include statement. The include statement for the library ``hashids`` would look as following: .. code:: php use TYPO3\CMS\Core\Utility\ExtensionManagementUtility; @include 'phar://' . ExtensionManagementUtility::extPath('auxlibs') . 'Libraries/hashids-hashids.phar/vendor/autoload.php'; .. |Build Status| image:: https://badgen.net/travis/buepro/typo3-auxlibs/master :target: https://travis-ci.org/buepro/typo3-auxlibs .. |Latest Version| image:: https://badgen.net/packagist/v/buepro/typo3-auxlibs :target: https://github.com/buepro/typo3-auxlibs/releases