Constants¶

externalFileCacheLifetime¶

plugin.tx_scriptmerger.externalFileCacheLifetime = t3tsref:data-type-integer

“Time to live” in seconds for the cache files of external CSS and JS

css.enable¶

plugin.tx_scriptmerger.css.enable = t3tsref:data-type-boolean

Enable all css processes

css.addContentInDocument¶

plugin.tx_scriptmerger.css.addContentInDocument = t3tsref:data-type-boolean

Embed the resulting css directly into the document in favor of a linked resource (this automatically disables the compression step).

css.doNotRemoveInDoc¶

plugin.tx_scriptmerger.css.doNotRemoveInDoc= t3tsref:data-type-boolean

This option can be used to prevent embedded scripts to be merged, minified or compressed.

css.mergedFilePosition¶

plugin.tx_scriptmerger.css.mergedFilePosition= t3tsref:data-type-string

Use this option to define the final position of the merged files and any other ones that were processed by the scriptmerger. The value is used inside a regular expression, but you cannot use any wildcards or such stuff. A possible value could be “</head>”. If empty, the position of the first merged file is reused.

css.minify.enable¶

plugin.tx_scriptmerger.css.minify.enable = t3tsref:data-type-boolean

Enable the minification process

css.minify.ignore¶

plugin.tx_scriptmerger.css.minify.ignore = t3tsref:data-type-string

A comma-separated list of files which should be ignored from the minification process. Be careful, because you need to quote the characters yourself as the entries are considered as regular expressions. If a file is added to all three ignore options, it’s not touched at all.

css.compress.enable¶

plugin.tx_scriptmerger.css.compress.enable = t3tsref:data-type-boolean

Enable the compression process

css.compress.ignore¶

plugin.tx_scriptmerger.css.compress.ignore = t3tsref:data-type-string

A comma-separated list of files which should be ignored from the compression process. Be careful, because you need to quote the characters yourself as the entries are considered as regular expressions. If a file is added to all three ignore options, it’s not touched at all.

css.merge.enable¶

plugin.tx_scriptmerger.css.merge.enable = t3tsref:data-type-boolean

Enable the merging process

css.merge.ignore¶

plugin.tx_scriptmerger.css.merge.ignore = t3tsref:data-type-string

A comma-separated list of files which should be ignored from the merging process. Be careful, because you need to quote the characters yourself as the entries are considered as regular expressions. If a file is added to all three ignore options, it’s not touched at all. Also this setting will trigger the process to readd the file at the same position it was taken from.

css.uniqueCharset.enable¶

plugin.tx_scriptmerger.css.uniqueCharset.enable = t3tsref:data-type-boolean

Enables the replacement of multiple @charset definitions by the given value option

css.uniqueCharset.value¶

plugin.tx_scriptmerger.css.uniqueCharset.value = t3tsref:data-type-string

@charset definition that is added on the top of the merged css files

css.postUrlProcessing.pattern¶

plugin.tx_scriptmerger.css.postUrlProcessing.pattern = t3tsref:data-type-string

Regular expression pattern (e.g. /(fileadmin)/i)

The pattern and replacement values can be used to fix broken urls inside the combined css file.

css.postUrlProcessing.replacement¶

plugin.tx_scriptmerger.css.postUrlProcessing.replacement = t3tsref:data-type-string

Regular expression replacement (e.g. prefix/$i)

javascript.minify.enable¶

plugin.tx_scriptmerger.javascript.minify.enable = t3tsref:data-type-boolean

Enable the minification process

javascript.minify.ignore¶

plugin.tx_scriptmerger.javascript.minify.ignore = t3tsref:data-type-string

A comma-separated list of files which should be ignored from the minification process. Be careful, because you need to quote the characters yourself as the entries are considered as regular expressions. If a file is added to all three ignore options, it’s not touched at all.

javascript.minify.useJSMinPlus¶

plugin.tx_scriptmerger.javascript.minify.useJSMinPlus = t3tsref:data-type-boolean

Use JSMin+ instead of JSMin or JShrink.

javascript.minify.useJShrink¶

plugin.tx_scriptmerger.javascript.minify.useJShrink = t3tsref:data-type-boolean

Use JShrink instead of JSMin or JSMin+.

javascript.compress.enable¶

plugin.tx_scriptmerger.javascript.compress.enable = t3tsref:data-type-boolean

Enable the compression process.

javascript.compress.ignore¶

plugin.tx_scriptmerger.javascript.compress.ignore = t3tsref:data-type-string

A comma-separated list of files which should be ignored from the compression process. Be careful, because you need to quote the characters yourself as the entries are considered as regular expressions. If a file is added to all three ignore options, it’s not touched at all.

javascript.merge.enable¶

plugin.tx_scriptmerger.javascript.merge.enable = t3tsref:data-type-boolean

Enable the merging process

javascript.merge.ignore¶

plugin.tx_scriptmerger.javascript.merge.ignore = t3tsref:data-type-string

A comma-separated list of files which should be ignored from the merging process. Be careful, because you need to quote the characters yourself as the entries are considered as regular expressions. If a file is added to all three ignore options, it’s not touched at all. Also this setting will trigger the process to readd the file at the same position it was taken from.

javascript.enable¶

plugin.tx_scriptmerger.javascript.enable= t3tsref:data-type-boolean

Enable all javascript processes (by default only for the head section)

javascript.addContentInDocument¶

plugin.tx_scriptmerger.javascript.addContentInDocument= t3tsref:data-type-boolean

Embed the resulting javascript code directly into the document in favor of a linked resource (this automatically disables the compression step).

javascript.parseBody¶

plugin.tx_scriptmerger.javascript.parseBody= t3tsref:data-type-boolean

Enable this option to enable the minification, processing and merging processes for the body section. The resulting files are always included directly before the closing body tag.

javascript.doNotRemoveInDocInBody¶

plugin.tx_scriptmerger.javascript.doNotRemoveInDocInBody= t3tsref:data-type-boolean

This option can be used to prevent embedded scripts inside the document of the body section to be merged, minified or compressed as this is in many cases a possible error source in the final result. Therefore the option is enabled by default.

javascript.doNotRemoveInDocInHead¶

plugin.tx_scriptmerger.javascript.doNotRemoveInDocInHead= t3tsref:data-type-boolean

This option can be used to prevent embedded scripts inside the document of the head section to be merged, minified or compressed.

javascript.mergedHeadFilePosition¶

plugin.tx_scriptmerger.javascript.mergedHeadFilePosition= t3tsref:data-type-string

Use this option to define the final position of the merged files and any other ones in the head section that were processed by the scriptmerger. The value is used inside a regular expression, but you cannot use any wildcards or such stuff. A possible value could be “</head>”. If empty, the position of the first merged file is reused.

javascript.mergedBodyFilePosition¶

plugin.tx_scriptmerger.javascript.mergedBodyFilePosition= t3tsref:data-type-string

Use this option to define the final position of the merged files and any other ones in the body section that were processed by the scriptmerger. The value is used inside a regular expression, but you cannot use any wildcards or such stuff.

javascript.asyncLoading¶

plugin.tx_scriptmerger.javascript.asyncLoading= t3tsref:data-type-boolean

This option is set to false by default.

If set to true, the merged JavaScript file will be included with the ‘async’ attribute set. This will prevent the main thread from being blocked while downloading your JavaScript. Be aware that enabling that option requires that all JavaScript that is dependent on the contents of the merged file must not be executed before the DOMContentLoaded event (e.g. inline JavaScript snippets).

Also note that this flag does not enable ‘deferred’ loading of scripts. asyncLoading will download your JS asynchronously but execute it as soon as it is loaded. If you need scripts to also be executed only after the page is ready, add a ‘data-ignore=”1’ and ‘defer’ attribute to your script-tag.

javascript.deferLoadingInHead¶

plugin.tx_scriptmerger.javascript.deferLoadingInHead= t3tsref:data-type-boolean

This option is set to false by default.

If set to true the defer attribute will be added to javascript inside the head.

NOTE: If set asyncLoading will be set to FALSE and all JS is loaded inside the HEAD. For details see:

https://flaviocopes.com/javascript-async-defer/