buepro/typo3-auxlibs

Provides third party libraries to be used in non-composer mode. The following libraries are embedded: hashids/hashids, erusev/parsedown.

Maintainers

Details

github.com/buepro/typo3-auxlibs

Homepage

Source

Issues

Installs: 525

Dependents: 2

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

Type:typo3-cms-extension

v1.4.0 2021-10-26 17:42 UTC

Requires

Requires (Dev)

Replaces

GPL-2.0-or-later abc9150a014af9ce5d06ad9b599641cbe03a6d78

  • Roman Büchler

typo3hashids

This package is auto-updated.

Last update: 2021-11-27 04:57:19 UTC

README

Continuous integration 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.1.0
erusev/parsedown 1.7.4
rlanvin/php-rrule 2.3.0

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

PHP RRule

RRule is a lightweight and fast implementation of recurrence rules for PHP (RRULE from RFC 5545), to easily calculate recurring/repeating dates and events (such as in a calendar).

Example:

$rrule = new RRule('RRULE:FREQ=DAILY;UNTIL=19971224T000000Z;WKST=SU;BYDAY=MO,WE,FR;BYMONTH=1');
foreach ($rrule as $occurrence) {
    echo $occurrence->format('r'),"\n";
}

With RSet even more complex rules can be defined:

$rset = new RSet(
    "DTSTART;TZID=America/New_York:19970901T090000
    RRULE:FREQ=DAILY;COUNT=3
    EXRULE:FREQ=DAILY;INTERVAL=2;COUNT=1
    EXDATE;TZID=America/New_York:19970903T090000
    RDATE;TZID=America/New_York:19970904T090000"
);

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';