jop-software/typo3-conf-js

TYPO3 view helper to load extension configuration in JavaScript

Installs: 118

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 3

Type:typo3-cms-extension

v2.0.2 2022-10-11 20:11 UTC

This package is auto-updated.

Last update: 2024-10-12 00:43:58 UTC


README

TYPO3 EXT:conf_js

Access your ext_conf in JavaScript

CI Pipeline

Professional Support

Professional support is available, please contact info@jop-software.de for more information.

Installation

Install this extension with composer.

composer require jop-software/typo3-conf-js

Usage

The extension provides a simple ViewHelper that generated a <script> tag that makes the configuration available in JavaScript. The ViewHelper gets the extKey as an input, so you can control from which configuration you want to load the configuration.

Execute the ViewHelper in a fluid template

{namespace confJs=JopSoftware\TYPO3\ConfJs\ViewHelpers}
<confJs:extensionConfiguration extKey="my_ext_key" />

And access the Configuration in JavaScript later

let configuration = window.extConf.get("my_ext_key");

You can also find an extension, implementing this behaviour for testing in ./Tests/Packages/testing-site-package.

Security

Many times the extension configuration of an extension does contain secret information - like API Keys - that should not get exposed to the end user.

Currently, the extension always exports the entire extension configuration, but you can choose which extensions get exposed.

There already exists an issue (#4) about only exposing parts of the extension configuration, but this is not implemented at the moment.

Supported TYPO3 Versions

Local Development

We use DDEV for local development.

You get a complete ddev setup in this repository, just run ddev start.

License

This project is licensed under GPL-2.0-or-later, see the LICENSE file for more information.

© 2022, jop-software Inh. Johannes Przymusinski