README

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.1.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:

$hashids = new \Hashids\Hashids;
$handle = $hashids->encode(5, 5, 5);

Parsedown

Parsedown transforms text with markdown syntax to html.

Example:

$parsedown = new \Parsedown;
$htmlText = $parsedown->text($markdownText);

ViewHelper

A ViewHelper is available and can be used as following:

<html xmlns:f="http://typo3.org/ns/TYPO3/CMS/Fluid/ViewHelpers"
      xmlns:auxlibs="http://typo3.org/ns/Buepro/Auxlibs/ViewHelpers"
      data-namespace-typo3-fluid="true">

<!--Inline mode-->
{auxlibs:parsedown(text: textWithMarkedownSyntax)}
{task.description -> auxlibs:parsedown()}

<!--Tag mode-->
<auxlibs:parsedown text="{task.description}" />
<auxlibs:parsedown>{task.description}</auxlibs:parsedown>

</html>

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:

use TYPO3\CMS\Core\Utility\ExtensionManagementUtility;
@include 'phar://'
    . ExtensionManagementUtility::extPath('auxlibs')
    . 'Libraries/hashids-hashids.phar/vendor/autoload.php';

buepro / typo3-auxlibs

Maintainers

Details