AdvAgg for Drupal 8 has some significant differences from Drupal 7; instead of totally reworking asset handling, AdvAgg only applies some improvements. This is mostly because the core handling is much better. It is also better for compatibility with quite a few other modules such as http2serverpush.
Url query string to turn off AdvAgg for that request. ?advagg=0 will turn off file optimization if the user has the "bypass advanced aggregation" permission. ?advagg=-1 will completely bypass all of Advanced CSS/JS Aggregations modules and submodules. ?advagg=1 will enable Advanced CSS/JS Aggregation if it is currently disabled.
Button on the admin page for dropping a cookie that will turn off file optimization. Useful for theme development.
Gzip support. All optimized files can be pre-compressed into a .gz file and served from Apache. This is faster then gzipping the file on each request.
Brotli support. All optimized files can be pre-compressed with the newer brotli compression algorithm; this often shows close to 30% improvements in file size vs gzip. Requires the brotli php extension is installed.
With various submodules substantially improved front end performance through minification of assets and other techniques can be achieved. Read more below.
AdvAgg comes with quite a few submodules to do various tasks. Most are compatible with the vast majority of other mods but some may have conflicts. If so those are noted here and more details in the module's full write-ups.
This module may have conflicts, but only with other CDN type modules.
Load CSS or JavaScript libraries from a public CDN; currently only supports jQuery and jQuery UI with either Google's or Microsoft's CDN.
Validate CSS and or JS files in your site through a few different validators.
Minify CSS or JS through an otherwise unsupported method, with a configurable command line.
Minify the CSS files using a 3rd party minifier; currently supports YUI (included) or the Core minification algorithm.
Compress the compiled JavaScript files using a 3rd party minifier; built in support for a number of minifiers.
Depending on tweaks applied this module may cause compatibility issues with other modules.
Includes additional tweaks that may not work for all sites such as:
rel=preload and JavaScript Polyfill.This module may have conflicts with other modules if it is enabled.
Includes additional functionality to improve Drupal compatibility with old versions of Internet Explorer (6-9).
Settings page is located at: admin/config/development/performance/advagg.
Enable Advanced Aggregation: You can quickly temporarily disable all AdvAgg functionality by un-checking this. For testing purposes, see also Testing AdvAgg. [Default: enabled]
Use DNS Prefetch for external CSS/JS: If enabled places prefetch tags near the top of your html to trigger DNS look-ups as soon as possible on load. [Default: disabled]
Send immutable header for all optimized files: Include directives for Apache to send Cache-Control Immutable headers for all optimized files. Only supported on Edge 15+ and Firefox 49+. In other browsers, they will have no effect, so can be safely enabled. [Default: enabled]
AdvAgg Cache Settings: Development will scan all files for a change on every page load. Normal is fine for all use cases. Aggressive should be fine in almost all use cases. [Default: Normal]
Gzip [CSS/JS] Assets: If enabled, AdvAgg will create gzip compressed version of every file that is generated. This will then be served if the users' browser supports it instead of the uncompressed file saving time and bandwidth. [Default: enabled]
Brotli Compress [CSS/JS] Assets: Only selectable if the non standard PHP brotli extension is installed. If enabled, Advagg will create brotli compressed versions of every file that is generated. Moderately better compression ratios than Gzip, but lower server and browser support. [Default: disabled]
Combine CSS files by using media queries: If enabled, AdvAgg will add a media query wrapper to any file that needs it so that aggregation is more efficient. [Default: disabled]
Fix improperly set type: If type is external but does not start with http, https, or // change it to be type file. If type is file but it starts with http, https, or // change type to be external. [Default: enabled]
Fix improperly set type: If type is external but does not start with http, https, or // change it to be type file. If type is file but it starts with http, https, or // change type to be external. [Default: enabled]
Do not change external to file if on same host: In rare cases, JS files may be on the same host but are actually still external such as served via a CDN. [Default: disabled]
Unless you have a good understanding of what you are trying to do, probably better to leave these alone. For best performance, setting up an external cron task is better than relying on Drupal's built in "poor man's cron".
Minimum amount of time between advagg_cron() runs: Set the minimum
amount of time between advagg_cron runs. advagg_cron whenever you site
cron runs, if less than the minimum time, will return before further
processing. [Default: 1 day]
Delete aggregates modified more than a set time ago: Set how old to keep generated files for. Longer will have higher performance and with AdvAgg 8.x-3.x should have no negatives except for possibly wasted disk space from rarely used or changed files. [Default: 1 month]
Convert absolute paths to protocol relative paths: Only applies to external files, this will change any http:// or https:// based urls to use //. [Default: enabled]
Convert http:// to https://: Also only applies to external files and is mutually incompatible with Convert absolute paths to protocol relative paths. [Default: disabled]
Use "Options +SymLinksIfOwnerMatch": On some rare hosting configurations
the AdvAgg htaccess files need to use Options +SymLinksIfOwnerMatch
instead of the more common Options +FollowSymlinks. [Default: disabled]
Located at admin/config/development/performance/advagg/info. This page
provides debugging information. There are no configuration options here.
Hook Theme Info: Displays the preprocess_html order.
Core Asset Hooks Implemented by Modules: List modules implementing the various core asset hook functions. Note: if a module does not use these but is changing things with assets beyond adding/removing, there is a much greater chance that there may be conflicts with AdvAgg especially with some of the submodules.
Get information about an optimized file: Enter the name of an optimized file and get back an array of information about the file including its original name and location.
Located at admin/config/development/performance/advagg/operations. This is a
collection of commands to control the cache and manage testing of this
module. In general this page is useful when troubleshooting some aggregation
issues.
Aggregation Bypass Cookie: Toggle The "aggregation bypass cookie" for the current browser. If enabled will disable AdvAgg for the user for the period of time specified. It acts almost the same as adding ?advagg=0 to every URL.
Cron Maintenance Tasks: Remove All Stale Files: Scan all files in the
css/js optimized directories and remove old files. See also Cron
Options on the Configuration Page.
Clear All Caches: Remove all data stored in the advagg cache, and delete all optimized files.
Increment Global Counter: Force the creation of all new files with new names by incrementing a global counter.
You can use this JS code as a bookmarklet for toggling the AdvAgg URL parameter. See http://en.wikipedia.org/wiki/Bookmarklet for more details.
javascript:(function(){
var loc = document.location.href,
qs = document.location.search,
regex_off = /\&?advagg=-1/,
goto = loc;
if(qs.match(regex_off)) {
goto = loc.replace(regex_off, '');
} else {
qs = qs ? qs + '&advagg=-1' : '?advagg=-1';
goto = document.location.pathname + qs;
}
window.location = goto;
})();
Go to admin/config/development/performance/advagg
Ensure AdvAgg Modifier is enabled and go to
admin/config/development/performance/advagg/mod
Ensure AdvAgg Minify JS is enabled and go to
admin/config/development/performance/advagg/js-minify
Note: This module may have conflicts, but only with other CDN type modules.
Load CSS or JavaScript libraries from a public CDN; currently only supports
jQuery and jQuery UI with either Google's or Microsoft's CDN. Note the theme
for the jQuery UI CSS that Drupal core uses is not available from either CDN.
There is a similar one, smoothness, available which has only very minor
differences.
Located at admin/config/development/performance/advagg/cdn.
CDN to use: Which CDN to use. [Default: Google]
Use Minified resources: Use the minified versions of the resource if possible. [Default: enabled]
Serve jQuery by CDN: Use the CDN jQuery instead of the local copy. [Default: enabled]
jQuery version: The version to use, defaults to the version included in Drupal 8. [Default: 2.1.4]
Serve jQuery UI CSS by CDN: Use the CDN jQuery UI CSS instead of the local copy. _**Warning: this may change the appearance due to slight differences from the core theme. [Default: disabled]
jQuery UI theme: The theme to use; Smoothness is the most similar to
the basic jQuery UI theme in Drupal 8. [Default: smoothness]
Serve jQuery UI JavaScript by CDN: Use the CDN jQuery UI JavaScript instead of the local copy. [Default: enabled]
jQuery UI version: The version to use, defaults to the version included in Drupal 8. [Default: 1.11.4]
Validate CSS and or JS files in your site through a few different validators.
Use the CSSLint JavaScript and the Drupal 8 core .csslintrc settings to lint the selected file(s) from your site.
Warning: this has privacy implications. Specifically this sends your CSS to the W3 servers.
Use the W3.org CSS Validator to lint the selected file(s) from your site.
Use the JSHint JavaScript to lint the files on your site.
Warning: depending on permissions this presents a security risk due to using administrator configurable command line calls.
Note: May conflict with AdvAgg Minify CSS and or AdvAgg Minify JS depending on configuration. Don't use 2 minifiers on one asset type.
Minify CSS or JS through an otherwise unsupported method, with a configurable command line. This may not work on all servers depending on security settings.
### CSS
Command to run: the shell command to run. The form provides some examples and lists the available variables. [Default: empty]
Enable external CSS minification: Whether to use the configured command. [Default: False]
Command to run: the shell command to run. The form provides some examples and lists the available variables. [Default: empty]
Enable external JavaScript minification: Whether to use the configured command. [Default: False]
Minify CSS files using a 3rd party minifier; currently supports YUI (included) or the Core cleaning algorithm. YUI will lead to much smaller files sizes and is the recommended option - basically, if you aren't using it, you probably will get better performance without this sub-module enabled. The YUI Compressor included with Advanced Aggregates is slightly different from that found on GitHub (as of last check, one patch had not been applied to the GitHub version).
Located at admin/config/development/performance/advagg/css-minify
Minification: Select a minifier: Choose between Disabled, Core and
YUI. [Default: YUI]
Add licensing Comments: If enable will include comment with path to the original file in every optimized file. Better follows the spirit of GPL but not required to conform. Will increase file size slightly. [Default: Enabled]
Minify JavaScript files using a 3rd party minifier. AdvAgg includes a few and supports one faster compiled PHP extension. The options are:
JSMin +: No installation required. Usually the second best minification, however it is the slowest supported option.
JShrink: No installation required, JShrink is reliable and has fairly comparable minification to JSMin.
JSqueeze: No installation required, JSqueeze provides the most effective minification and is the fallback if another minification method fails. It is still fairly slow.
JSMin: The fast compiled C extension for PHP. Supports PHP 5.3+ and 7.x. Must be installed separately. Much faster than the other options but slightly less reliable although that is mostly mitigated within AdvAgg. See below for more details.
Located at admin/config/development/performance/advagg/css-minify
Minification: Select a minifier: Choose which minifier to user. [Default: Disabled]
Add licensing Comments: If enable will include comment with path to the original file in every optimized file. Better follows the spirit of GPL but not required to conform. Will increase file size slightly. [Default: Enabled]
The AdvAgg Minify JavaScript module can take advantage of jsmin.c if it is
available and selected as minifier. In that case, JavaScript parsing and
minimizing will be done in C instead of PHP dramatically speeding up the
process. The JsMin extension can be found at
GitHub. There are instructions on
installing and compiling it there. Note that if you are using PHP 7.x you'll
need to use the feature/php7 branch rather than the master branch.
Depending on tweaks applied this module may cause compatibility issues with other modules.
Includes additional tweaks that may not work for all sites such as:
rel=preload and JavaScript Polyfill.Located at admin/config/development/performance/advagg/mod.
Enable preprocess on all JS: Enables optimization for all JavaScript files. Warning: this may not be compatible with all mod added files. In fact, it is incompatible with CKEditor JavaScript and specifically excludes it to prevent problems. [Default: Disabled]
Remove console logging from JS Files: Removes any calls to console.log() Warning: this is experimental. Will decrease file size and may improve performance. [Default: Disabled]
Optimize JavaScript Ordering: Re-order the JavaScript to improve aggregation. If you're not using aggregation, will have minimal effect.
Move all external scripts to the top of the execution order: Move external scripts to the be loaded first. [Default: Disabled]
Move all browser conditional JavaScript to the bottom of the group: As browser conditional scripts are usually the last needed, this often provides better front-end performance. [Default: Disabled]
Adjust JavaScript Location and Execution: Mostly safe but may cause serious issues depending on your specific site configuration. Due to changes in Drupal 8 these options are mostly irrelevant but may still have some small effect.
Deferred JavaScript Execution: Add the defer tag to all or only local scripts. [Default: Disabled]
Experimental settings:
Asynchronous JavaScript Execution: Add the async tag to all JavaScript. Warning: this may cause issues! [Default: Disabled]
Group Async JavaScript: Group any Async Javascript together. May lead to better aggregates if only some of your scripts are being loaded asynchronously otherwise irrelevant. [Default: Disabled]
Enable preprocess on all CSS: Enables optimization for all CSS files. Warning: this may not be compatible with all mod added files, although there are no known cases of it causing problems at this time. [Default: Disabled]
Optimize CSS Ordering: Re-order the CSS to improve aggregation. If you're not using aggregation, will have minimal effect.
Move all external CSS to the top of the execution order: Move external CSS to the be loaded first. [Default: Disabled]
Move all browser conditional CSS to the bottom of the group: As browser conditional CSS are usually applied last so this often provides better front-end performance. [Default: Disabled]
Adjust CSS Location and Execution: Warning: may cause serious issues depending on your specific site configuration. Unlikely to see any improvement if using HTTP 2 but may find some if using HTTP 1.x.
Deferred CSS Execution: Use JS to Load CSS: Attempt optimized CSS delivery using JavaScript. [Default: Disabled]
Use JS to load CSS in admin theme: Apply JS based CSS loading to the admin theme as well. [Default: Disabled]
How to include the JS loading code: Method of including the JS to load the CSS. [Default: Inline]
This module may have conflicts with other modules if it is enabled.
Includes additional functionality to improve Drupal compatibility with old versions of Internet Explorer (6-9). No currently known compatibility issues however due to method required to override core on this it is easily possible that there are other modules that do conflict.
This module prevents CSS aggregates from being produced with more than 4095 (or a configured value) selectors as old Internet Explorer versions do not handle more than 4095 selectors in an individual file.
Located at admin/config/development/performance/advagg/old_ie_compatibility.
Prevent more than [number] CSS selectors in an aggregate CSS file: [Default: enabled]
Selector count limit: The maximum number of selectors to allow in an aggregate CSS file. [Default 4095]