Skip to content

jop-software/typo3-conf-js

Repository files navigation

TYPO3 EXT:conf_js

Access your ext_conf in JavaScript

CI Pipeline

Professional Support

Professional support is available, please contact [email protected] 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

Extension Version TYPO3 Version PHP-Version
1.x 11.5 7.4 - 8.0
2.x 12.0 8.1

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.