Page JavaScript Selector¶

What does it do?¶

This extension allows you to select one or more javascript(s) for each page of the tree.

Compatibility notice¶

Prior to version 1.0.0, the js_select extension should run on any version of TYPO3, on PHP 4 and 5. Version 1.0.0 and later are designed exclusively for PHP 5.2.

Installation¶

The installation of this extension is very simple. Just connect to the Typo3 Extension Repository and download «Page JavaScript Selector» (js_select), located in the backend section.

From the extension manager, you'll be able to specify the directory where you will store your JS files (you must manually create this folder). By default, it's fileadmin/js/. Note that you can specify multiple directories, by separating them by a comma. Specified paths are relative to the TYPO3 site path.

You can also choose from here the allowed extensions for the JS files.

If you keep your JS files in sub-directories, you can also get them by enabling the third option.

Extension update¶

If you are upgrading from an older version, you will have to update the database. From the extension manager, you'll see an update option.

If you don't see this item in the menu, that means that your database doesn't need to be updated.

On the update page, you'll see the list of the TYPO3 pages that will be updated.

Simple click the «Update» button, and you're done.

Static TypoScript template¶

In order to enable this new version, you'll also have to include it's static template into your main TypoScript template, as it's not included by default anymore.

Adding a specific JavaScript to a page¶

Once the extension is installed, you'll be able to specify one or more JavaScript(s) for each of your pages. This is done through the page headers:

You'll find in the selector all the JS files located in the directory you've set during the install process. Just click on a filename to add it.

You'll also be able to define the inheritance mode for the selected JavaScripts. These options of course only have an effect if the recursivity option is set (see the next section).

The default setting (normal) will allow inheritance

If «Skip» is set, selected JavaScripts from this page won't be inherited, but JavaScripts from the pages above will be.

If «Stop» is set, selected JavaScripts from this page and the above won't be inherited.

Specifying the JS storage directory¶

You can override the settings made from the extension manager about the JS directory through the page TSConfig. In order to do this, edit the properties of a page, and place the following code in the TSConfig field:

tx_jsselect.jsDir = path/to/a/directory,path/to/another/directory

Specified paths are relative to the TYPO3 site path.

Reference¶

Here's the complete reference of the TypoScript options for the plugin. Remember that you can set each one through the constant editor.