| 1 |
=== Autoptimize === |
| 2 |
Contributors: futtta, turl |
| 3 |
Tags: css, html, javascript, js, optimize, speed, cache, data-uri, aggregate, minimize, performance, pagespeed, booster, multisite |
| 4 |
Requires at least: 2.7 |
| 5 |
Tested up to: 3.6 |
| 6 |
Stable tag: 1.6.5 |
| 7 |
|
| 8 |
Autoptimize speeds up your website and helps you save bandwidth by aggregating and minimizing JS and CSS. |
| 9 |
|
| 10 |
== Description == |
| 11 |
|
| 12 |
Autoptimize makes optimizing your site really easy. It concatenates all scripts and styles, minifies and compresses them, adds expires headers, caches them, and moves styles to the page head, and scripts to the footer. It also minifies the HTML code itself, making your page really lightweight. |
| 13 |
|
| 14 |
If you consider performance important, we recommend the use of a caching-plugin such as e.g. [WP Super Cache](http://wordpress.org/extend/plugins/wp-super-cache/) or |
| 15 |
[HyperCache](http://wordpress.org/extend/plugins/hyper-cache/). |
| 16 |
|
| 17 |
== Installation == |
| 18 |
|
| 19 |
1. Upload the `autoptimize` folder to to the `/wp-content/plugins/` directory |
| 20 |
1. Activate the plugin through the 'Plugins' menu in WordPress |
| 21 |
1. Go to `Settings -> Autoptimize` and enable the options you want. Generally this means "Optimize HTML/CSS/JavaScript", but if you experience problems you might want to disable some. |
| 22 |
|
| 23 |
== Frequently Asked Questions == |
| 24 |
|
| 25 |
= What does the plugin do to help speed up my site? = |
| 26 |
|
| 27 |
It concatenates all scripts and styles, minifies and compresses them, adds expires headers, caches them, and moves styles to the page head, and scripts to the footer. It also minifies the HTML code itself, making your page really lightweight. |
| 28 |
|
| 29 |
= Will this work with for my blog? = |
| 30 |
|
| 31 |
Yes, most of the time, but there will always be exceptions. Although Autoptimize goes through great lengths to work with as many themes and plugins possible, there undoubtably are circumstances in which Autoptimize will not work to the full extent (full HTML, JS and CSS optimization). See "Troubleshooting" below for info on how to proceed if you encounter issues. |
| 32 |
|
| 33 |
= Does Autoptimize work with BuddyPress? = |
| 34 |
|
| 35 |
Based on feedback received from BuddyPress users, CSS and JS-Autoptimization do not seem to work correctly, leaving you with only HTML optimizations. I will look into this in the future and am happy to take hints or code-improvements the help with BuddyPress compatibility in the mean time. |
| 36 |
|
| 37 |
= Compatibility with WP SlimSat = |
| 38 |
|
| 39 |
There have been reports of sightings of javascript errors when using Autoptimize together with WP SlimStat. Both [Camu (WP SlimStat developer)](http://profiles.wordpress.org/coolmann/) and I have installed both plugins on test-environments and [found no proof of such incompatibility](http://wordpress.org/support/topic/dropdown-menus-dont-work-when-slimstat-is-enabled?replies=14#post-4086894). Our common conclusion is that there are rare cases in which yet another theme or plugin's JavaScript are triggering these errors. If you do encounter JavaScript-errors when you have both WP SlimStat and Autoptimize installed, add "SlimStatParams, wp-slimstat.js" in the "Exclude scripts from autoptimize:" option on the admin-page and all should be well. |
| 40 |
|
| 41 |
= Why are some options marked as Deprecated? = |
| 42 |
YUI compression and the CDN options are marked as deprecated to indicate that this functionality will be removed for the next major version (probably 1.7.0). YUI compression was pretty exotic and required one to install JAVA and the YUI compression software. CDN options are deprecated as well; CDN isn't core functionality and can better be accomplished using e.g. [WP Super Cache](http://wordpress.org/extend/plugins/wp-super-cache/) (which is a must-have companion of Autoptimize anyhow). |
| 43 |
|
| 44 |
= Configuring & Troubleshooting Autoptimize = |
| 45 |
|
| 46 |
After having installed and activated the plugin, you'll have access to an admin page where you can to enable HTML, CSS and JavaScript optimization. According to your liking, you can start of just enabling all of them, or if you're more cautious one at a time. |
| 47 |
|
| 48 |
If your blog doens't function normally after having turned on Autoptimize, here are some pointers to identify & solve such issues: |
| 49 |
* In case your blog looks weird, i.e. when the layout gets messed up, there is problem with CSS optimization. In this case you can turn on the option "Look for styles on just head?" and see if that solves the problem. |
| 50 |
* In case some functionality on your site stops working (a carroussel, a menu, the search input, ...) you're likely hitting JavaScript optimization trouble. Enable the option "Look for scripts only in head?" and/or "Force JavaScript in <head>?" and try again. Alternatively -for the technically savvy- you can exclude specific scripts from being treated (moved and/ or aggregated) by Autoptimize by adding a string that will match the offending Javascript. Identifying the offending JavaScript and choosing the correct exclusion-string can be trial and error, but in the majority of cases JavaScript optimization issues can be solved this way. |
| 51 |
* If you can't get either CSS or JS optimization working, you can off course always continue using the other two optimization-techniques. |
| 52 |
* If you tried the troubleshooting tips above and you still can't get CSS and JS working at all, you can ask for support on the [WordPress Autoptimize support forum](http://wordpress.org/support/plugin/autoptimize). See below for a description of what information you should provide in your "trouble ticket" |
| 53 |
|
| 54 |
= Where can I report an error? = |
| 55 |
|
| 56 |
You can report problems on the [wordpress.org support forum](http://wordpress.org/support/plugin/autoptimize), or [contact the maintainer using this contact form](http://blog.futtta.be/contact/). |
| 57 |
|
| 58 |
= What information should I include when requesting support = |
| 59 |
|
| 60 |
* A description of the problem, including screenshots and information from your browser's Error/ debug console |
| 61 |
* URL of your blog (you can turn Autoptimize off, but should be willing to turn it briefly on to have the error visible) |
| 62 |
* your Autoptimize settings (including a description of changes you made to the configuration to try to troubleshoot yourself) |
| 63 |
* the Theme used (including the Theme's download link) |
| 64 |
* optionally plugins used (if you suspect one or more plugins are raising havoc) |
| 65 |
|
| 66 |
== Changelog == |
| 67 |
|
| 68 |
= 1.6.5 = |
| 69 |
* new javascript-debug option to force the aggregated javascript file in the head-section of the HTML instead of at the bottom |
| 70 |
* YUI compression & CDN are now deprecated functionality that will be removed in 1.7.0 |
| 71 |
|
| 72 |
= 1.6.4 = |
| 73 |
* fix for PHP notice about mfunc_functions |
| 74 |
* fix for strpos warnings due to empty values from the "Exclude scripts from autoptimize" configuration as [reported by CandleFOREX](http://wordpress.org/support/topic/empty-needle-warning) |
| 75 |
* fix for broken feeds as [reported by Dinata and talgalili](http://wordpress.org/support/topic/feed-issue-5) |
| 76 |
|
| 77 |
= 1.6.3 = |
| 78 |
* fix for IE-hacks with javascript inside, causing javascript breakage (as seen in Sampression theme) as reported by [Takahiro of hiskip.com](http://www.hiskip.com/wp/) |
| 79 |
* fix for escaping problem of imported css causing css breakage (as seen in Sampression theme) as reported by Takahiro as well |
| 80 |
* fix to parse imports with syntax @import 'custom.css' not being parsed (as seen in Arras theme), again as reported by Takahiro |
| 81 |
* fix for complex media types in media-attribute [as reported by jvwisssen](http://wordpress.org/support/topic/autoptimize-and-media-queries) |
| 82 |
* fix for disappearing background-images that were already datauri's [as reported by will.blaschko](http://wordpress.org/support/topic/data-uris) |
| 83 |
* fix not to strip out comments in HTML needed by WP Super Cache or W3 Total Cache (e.g. mfunc) |
| 84 |
* added check to clean cache on upgrade |
| 85 |
* updated FAQ in readme with information on troubleshooting and support |
| 86 |
* tested with WordPress 3.6 beta |
| 87 |
|
| 88 |
= 1.6.2 = |
| 89 |
* Yet another emergency bugfix I'm afraid: apache_request_headers (again in config/delayed.php) is only available on ... Apache (duh), breaking non-Apache systems such as ngnix, Lighttpd and MS IIS badly. Reported by multiple users, thanks all! |
| 90 |
|
| 91 |
= 1.6.1 = |
| 92 |
* fixed stupid typo in config/delayed.php which broke things badly (april fools-wise); strpos instead of str_pos as reported by Takahiro. |
| 93 |
|
| 94 |
= 1.6.0 = |
| 95 |
* You can now specify scripts that should not be Autoptimized in the admin page. Just add the names (or part of the path) of the scripts in a comma-seperated list and that JavaScript-file will remain untouched by Autoptimize. |
| 96 |
* Added support for ETag and LastModified (essentially for a better pagespeed score, as the files are explicitely cacheable for 1 year) |
| 97 |
* Autoptimizing for logged in users is enabled again |
| 98 |
* Autoptimize now creates an index.html in wp-content/cache/autoptimize to prevent snooping (as [proposed by Chris](http://blog.futtta.be/2013/01/07/adopting-an-oss-orphan-autoptimize/#li-comment-36292)) |
| 99 |
* bugfix: removed all deprecated functions ([reported by Hypolythe](http://wordpress.org/support/topic/many-deprecated-errors) and diff by Heiko Adams, thanks guys!) |
| 100 |
* bugfix for HTTPS-problem as [reported by dbs121](http://wordpress.org/support/topic/woocommerce-autoptimizer-https-issue) |
| 101 |
* bugfix for breakage with unusual WordPress directory layout as reported by [Josef from blog-it-solutions.de](http://www.blog-it-solutions.de/). |
| 102 |
|
| 103 |
= 1.5.1 = |
| 104 |
* bugfix: add CSS before opening title-tag instead of after closing title, to avoid CSS being loaded in wrong order, as reported by [fotofashion](http://fotoandfashion.de/) and [blogitsolutions](www.blog-it-solutions.de) (thanks guys) |
| 105 |
|
| 106 |
= 1.5 = |
| 107 |
* first bugfix release by [futtta](http://blog.futtta.be/2013/01/07/adopting-an-oss-orphan-autoptimize/), thanks for a great plugin Turl! |
| 108 |
* misc bug fixes, a.o. support for Twenty Twelve theme, admin bar problem in WP3.5, data-uri breaking CSS file naming |
| 109 |
|
| 110 |
= 1.4 = |
| 111 |
* Add support for inline style tags with CSS media |
| 112 |
* Fix Wordpress top bar |
| 113 |
|
| 114 |
= 1.3 = |
| 115 |
* Add workaround for TinyMCEComments |
| 116 |
* Add workaround for asynchronous Google Analytics |
| 117 |
|
| 118 |
= 1.2 = |
| 119 |
* Add workaround for Chitika ads. |
| 120 |
* Add workaround for LinkWithin widget. |
| 121 |
* Belorussian translation |
| 122 |
|
| 123 |
= 1.1 = |
| 124 |
* Add workarounds for amazon and fastclick |
| 125 |
* Add workaround for Comment Form Quicktags |
| 126 |
* Fix issue with Vipers Video Quicktags |
| 127 |
* Fix a bug in where some scripts that shouldn't be moved were moved |
| 128 |
* Fix a bug in where the config page wouldn't appear |
| 129 |
* Fix @import handling |
| 130 |
* Implement an option to disable js/css gzipping |
| 131 |
* Implement CDN functionality |
| 132 |
* Implement data: URI generation for images |
| 133 |
* Support YUI CSS/JS Compressor |
| 134 |
* Performance increases |
| 135 |
* Handle WP Super Cache's cache files better |
| 136 |
* Update translations |
| 137 |
|
| 138 |
= 1.0 = |
| 139 |
* Add workaround for whos.among.us |
| 140 |
* Support preserving HTML Comments. |
| 141 |
* Implement "delayed cache compression" |
| 142 |
* French translation |
| 143 |
* Update Spanish translation |
| 144 |
|
| 145 |
= 0.9 = |
| 146 |
* Add workaround for networkedblogs. |
| 147 |
* Add workarounds for histats and statscounter |
| 148 |
* Add workaround for smowtion and infolinks. |
| 149 |
* Add workaround for Featured Content Gallery |
| 150 |
* Simplified Chinese translation |
| 151 |
* Update Spanish Translation |
| 152 |
* Modify the cache system so it uses wp-content/cache/ |
| 153 |
* Add a clear cache button |
| 154 |
|
| 155 |
= 0.8 = |
| 156 |
* Add workaround for Vipers Video Quicktags |
| 157 |
* Support <link> tags without media. |
| 158 |
* Take even more precautions so we don't break urls in CSS |
| 159 |
* Support adding try-catch wrappings to JavaScript code |
| 160 |
* Add workaround for Wordpress.com Stats |
| 161 |
* Fix a bug in where the tags wouldn't move |
| 162 |
* Update translation template |
| 163 |
* Update Spanish translation |
| 164 |
|
| 165 |
= 0.7 = |
| 166 |
* Add fix for DISQUS Comment System. |
| 167 |
|
| 168 |
= 0.6 = |
| 169 |
* Add workaround for mybloglog, blogcatalog, tweetmeme and Google CSE |
| 170 |
|
| 171 |
= 0.5 = |
| 172 |
* Support localization |
| 173 |
* Fix the move and don't move system (again) |
| 174 |
* Improve url detection in CSS |
| 175 |
* Support looking for scripts and styles on just the header |
| 176 |
* Fix an issue with data: uris getting modified |
| 177 |
* Spanish translation |
| 178 |
|
| 179 |
= 0.4 = |
| 180 |
* Write plugin description in English |
| 181 |
* Set default config to everything off |
| 182 |
* Add link from plugins page to options page |
| 183 |
* Fix problems with scripts that shouldn't be moved and were moved all the same |
| 184 |
|
| 185 |
= 0.3 = |
| 186 |
* Disable CSS media on @imports - caused an infinite loop |
| 187 |
|
| 188 |
= 0.2 = |
| 189 |
* Support CSS media |
| 190 |
* Fix an issue in the IE Hacks preservation mechanism |
| 191 |
* Fix an issue with some urls getting broken in CSS |
| 192 |
|
| 193 |
= 0.1 = |
| 194 |
* First released version. |
| 195 |
|
