forked from MattWilcox/Adaptive-Images
/
changelog.txt
executable file
·282 lines (209 loc) · 13 KB
/
changelog.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
version 1.5.2 (2012/04/16) ------------------------------------------------------------
BUG FIX
* AI was not generating high DPI images larger than the existing maximum
$resolutions value
I used a < when I needed a >. That is now fixed. If AI detects retina displays it
is now able to generate larger images than the top bounds set in $resolutions.
version 1.5.1 (2012/04/14) ------------------------------------------------------------
ENHANCEMENT
* JPGs are now created as Progressive rather than Optimised.
Progressive JPGs are actually slightly smaller in file-size than Optimised JPGs,
and have the benefit of appearing to load faster in modern browsers (they
download in passes, gradually getting sharper).
version 1.5 (2012/04/14) --------------------------------------------------------------
ENHANCEMENT
* Much improved support for Retina and other high DPI devices
NOTE: Retina support requires using alternate JavaScript:
<script>document.cookie='resolution='+Math.max(screen.width,screen.height)+("devicePixelRatio" in window ? ","+devicePixelRatio : ",1")+'; path=/';</script>
NOTE: If you see folders in the ai-cache directory which are *larger* than any
defined in your $resolutions array, it is because someone with a high DPI / Retina
display visited your site, and AI was able to generate the required image for them.
DETAILS:
Previous AI behaviour meant that supporting Retina required adding very high values
in the $resolutions array. This is sub-optimal because:
1) This array is meant to be nothing more than the same values as your media query
breakpoints. Adding larger ones isn't intuitive.
2) When no cookie is set, AI sends non-mobile devices the largest $resolution value,
which in that case could be far too large for most people (2000px+)
AI is now much smarter, you do not need to edit the $resolutions array; just leave
that as your CSS MQ sizes.
AI now auto-detects the pixel density of any high DPI device and either picks a
matching size from the existing array, or creates new high-dpi images which are
multiples of your chosen $resolutions values.
version 1.4.1 (2012/03/28) ------------------------------------------------------------
ENHANCEMENT
* More helpful error messages if something goes wrong.
* Updated the documentation a little.
version 1.4 (2012/02/19) --------------------------------------------------------------
ENHANCEMENT
* Auto-creates the cache folder with the correct permissions.
No need to manually create the ai-cache folder any more, AI does it for you.
BUG FIX
* Fixed an incorrect permission on created files, they're now 755 not 777.
version 1.3.9 (2012/02/17) ------------------------------------------------------------
Thanks to Gerv
ENHANCEMENT
* Better detection of mobile device in the event cookies are not available.
If cookies are unavailable AI resorts to basic UA sniffing.
Previously AI assumed all devices are mobile and searched the UA string for a
desktop OS. If found it overrode $mobile_first. However, this meant tablet
devices got mobile sized images as their OS is not a desktop OS.
Now switched to assume the device is a desktop, but AI searches the UA string for
'mobile' to switch to mobile first. All current mobile browsers behave in this
way, meaning mobiles still get mobile resolution, but tablets and desktop get
the largest configured resolution.
* Removed $mobile_first as it is no longer needed (see above)
version 1.3.8 (2012/01/24) ------------------------------------------------------------
BUG FIX
* Eliminated occasional double-slash in $cache_file path due to $requested_uri
sometimes starting with a /
version 1.3.7 (2011/11/21) ------------------------------------------------------------
BUG FIX
* A stupid mistake was causing the browser detect to always return false.
This has been fixed.
With this update Adaptive Images now detects if a user is running on a desktop OS
and switches $mobile_first to FALSE in that case. This means that if no cookie is
set and $mobile_first is TRUE the following will happen:
On a mobile phone, the mobile sized image will be delivered.
On a desktop, the highest resolution configured will be delivered.
If a cookie is set, Adaptive Images will use the cookie value to determine the
correct size image to send.
version 1.3.6 (2011/11/11) ------------------------------------------------------------
NOTES
* Added Linux desktop detection to the $mobile_first check routine (see previous
changelog details)
version 1.3.5 (2011/11/10) ------------------------------------------------------------
NEW FEATURE
* To work around browser issues with unreliable cookie setting speed
Adaptive Images now also checks the user agent string.
If a desktop environment is detected, $mobile_first is automatically
over-ridden to "FALSE". If not Adaptive Images will obey the configured
value.
This is a safety fallback and requires testing before I revert the
default $mobile_first configured value to TRUE.
version 1.3.4 (2011/11/10) ------------------------------------------------------------
BUG FIXES
* URLs are now allowed to have spaces and other encoded characters in them
* The sharpening function broke on libraries not compiled with the bundled version
of PHP/GD. Adaptive Images now tests the imageconvolution function is available
and gracefully handles cases where it isn't.
NEW FEATURE
* Instructions to take advantage of high-density displays like Apple's iPhone4
are now included. Just use the alternative JavaScript snippet.
NOTES
* Set $mobile_first to default to FALSE. Browsers are inconsistent with their
ability to set cookies before requesting <img>s. For more information visit
http://blog.yoav.ws/2011/09/Preloaders-cookies-and-race-conditions
version 1.3.3 (2011/10/18) ------------------------------------------------------------
BUG FIXES
* Added Gecko to the auto-disabled $mobile_first check: IE and Firefox don't
honour $mobile_first.
This is because both suffer from a race condition when setting the cookie.
Sometimes it's set before <img> are requested, sometimes not. This could produce
desktop websites with mobile versions on first page load.
OTHER IMPROVEMENTS
* Changed the HTTP Cache Header from "public" to "private".
This allows caches that are specific to one user (e.g., browser cache) to store
the image in cache; shared caches (e.g., a proxy server) won't. This should avoid
people behind proxies or other caching mechanisms experiencing wrongly sized images.
version 1.3.2 (2011/09/06) ------------------------------------------------------------
Thanks to Oncle Tom
BUG FIXES
* Internet Explorer was not correctly setting the cookie, and thus breaking badly
* Fixed a possible Cookie Injection, and optimised ai-cookie.php
NOTES
In testing it seems that Firefox is now behaving properly and setting the cookie
in time. Thus, I've re-instated support for $mobile_first = TRUE on that browser
version 1.3.1 (2011/09/06) ------------------------------------------------------------
Thanks to Emilio Bravo
BUG FIXES
* PNGs now maintain their alpha transparency when scaled down (previously got
black backgrounds where transparency should be)
version 1.3 (2011/09/04) --------------------------------------------------------------
Huge thanks to Jordi Boggiano
NEW FEATURES
* Finalised $mobile_first behaviour and defaulted it to TRUE
BUG FIXES
* Fixed typo which incorrectly set browser cache
OTHER IMPROVEMENTS
* When $mobile_first is FALSE now sends highest configured size instead of original
* Refactored the PHP to be more robust and efficient
* Simplified the JS to a single line and fixed pollution of the global namespace
* Made the .htaccess rule more robust and accurate
NOTES
Firefox will not honour $mobile_first as set in the CONFIG section. This is
intentional, and required due to a defect in Firefox's behaviour. It does not set
cookies fast enough, and therefor on the first visit to a site would load the
mobile sized image even if JS was enabled. Therefor, AI will not honour the
$mobile_first setting on Firefox based browsers that have JavaScript disabled.
version 1.3 beta (2011/08/31) ---------------------------------------------------------
NEW FEATURES
* Added support for Mobile First philosophy (see CONFIG, $mobile_first)
NOTES
When $mobile_first is set to TRUE it means the mobile sized version of the requested
image will be sent in the event that no cookie is set (likely because JavaScript is
unavailable). If FALSE, the original image is sent.
There is a known problem with Firefox on a first visit to a site where $mobile_first
is TRUE. It doesn't set the cookie fast enough, so the very first load sends the mobile
size image. All page loads after are fine. Opera, Safari, and Chrome all work OK.
version 1.2.2 (2011/08/30) ------------------------------------------------------------
NEW FEATURES
* Unsupported no-javascript solution (see instructions.htm)
version 1.2.1 (2011/08/26) ------------------------------------------------------------
NO NEW FEATURES
I have re-branded Responsive-Images to "Adaptive-Images", firstly to help distinguish
this project from the identically named project by Filament Group, and secondly
because it's a more appropriate name. This system actively adapts existing images as
well as "responding" to the visitors viewport to serve an appropriately sized version.
NOTES
The project is now available on GitHub for those who wish to track it there:
https://github.com/MattWilcox/Adaptive-Images
version 1.2 (2011/08/21) ------------------------------------------------------------
Contributions by Fabian Beiner, with thanks :)
NEW FEATURES
* Support for PNG and GIF images
* Added ability to sharpen re-scaled images (see CONFIG, $sharpen)
BUG FIXES
* Better extension detection (.jpeg was failing)
* First-run Firefox bug fixed. The JS must be in-line, in the <head>!
DETAILS:
Firefox (and potentially others, but not observed anywhere else) was requesting
the first <img> before it loaded the external javascript file, even when in the
<head>. This caused Firefox to load the full-resolution image the very first
time the site was visited. All subsequent page views were fine.
OTHER IMPROVEMENTS
* Cleaned up the .htaccess file and included clear comments on use
* Vastly improved instructions and examples on the downloadable zip
* Since 1.1 fixed issues with browser cache, default cache time now set to 7 days
* Refactored PHP code
version 1.1 (2011/08/16) ------------------------------------------------------------
NEW FEATURES
* Re-engineered the size detection methodology.
Now detects maximum possible screen size of the device instead of the current
window size. This removes the problem of visitors with small windows caching
small images to the browser, then upon maximising the browser having too small
images for the new screen size. It also simplifies the JS back down to its
original "just dump the size into a cookie" functionality.
This update removes the following:
* All JS config options
version 1.0 (2011/08/09) ------------------------------------------------------------
NEW FEATURES
* Headers sent along with the image, for browser side caching (see CONFIG, $browser_cache)
* JavaScript responds to window re-sizes, requests higher res images if required
BUG FIXES
* Fixed the MIME type for JPG's (image/jpeg not image/jpg)
beta 2 (2011/08/04) -----------------------------------------------------------------
NEW FEATURES
* Added the ability to control generated image quality (see CONFIG, $jpg_quality)
* Added configurable resolution breakpoints (see CONFIG, $resolutions)
* Optional Cache checking - defaults to on (see CONFIG, $watch_cache)
BUG FIXES
* The PHP now checks that the GD extension is loaded before proceeding
* Clarified comments further
beta 1 (2011/08/01) -----------------------------------------------------------------
NEW FEATURES
* Initial public release
* Commented the PHP for public consumption
* Added user-configurable cache directory (see CONFIG, $cache_path)
BUG FIXES
* Didn't generate downscaled images due to typo