ChangelogLast updated: 28 October 2023

Bug fixes for:

• SVG processing failing on image size - #266
• ee('Filesystem')->exists($path) triggers wrongly reports files as missing - #265
• Attributes parameter with quotes in causes error - #264
• GD Filter folder wrongly capitalised - affecting case-sensitive server installations - #263
• Background colour not being set on transparent images - #262
• Watermark throws deprecation errors when used with php 8.2 and null values - #261
• Deprecation error - Watermark Filter - #260
• Improve php 8.2 compatibility - #267, #259
  If native image size is less than first srcset image size given srcset/sizes output is incorrect - #258
• Crop would fail due to issue with auto-scale calculations - #254
• Under some conditions null images can be passed to SVG-Santize causing exception error - #252
• {made_url} variable not returning full URL - #251

New:

• Added new variables to access EE File meta fields (title, description, location, credits) for images originating in local EE File system
• Added new active checking for the availability of updates to JCOGS Image

Improved: 

• Additional information about local system reported when JCOGS Image debugging is enabled.

Bug fixes for:

• Bug: Text Overlay - negative position co-ordinates being ignored
• Bug: php 8.2 warnings - filesize calculations
• Bug: Exception error (negative point coords) when operating without license and source image smaller than demo mode marker
• Bug: Third party libraries not always loading correctly
• Bug: Image may trigger an exception when remote image requests returns 404 response

New:

• Added new Image system setting to optionally to force output of full URLs in generated <img> tags.

Improved: 

• When added to EE CP side bar, Image now provides ‘pop up menu’ to give quick access to common options
• Image will now optionally evaluate Image Variables when they appear in attributes parameter values

Bug fixes for:

• php 8.2 compatibility - remove deprecation warnings associated with image utilities library
• php 8.2 compatibility - fix a type match error
• Image path prefix not being applied to all output paths
• Filesize variable values not always available depending upon image type
• Attributes parameter processing requires class consolidation to be enabled

New:

• Added new Image setting to optionally ensure that processing of animated gifs ignores save_type= parameter

Improved: 

• Improved compatibility with php 8.2

Bug fixes for:

• Automanage not working when source file contains Capital letter
• Warning thrown when uploading new files and cache-automanagement enablied
• When smartscale crop is on % widths don't seem to be effective
• When lazy loading happening, Image removes closing </head> tag
• Exception error when clearing a cache when cache folder does not exist

New:

• Source images can now use the HEIC format (i.e. iPhone images now supported!)
• Cache auto-manage option - when enabled, using the EE File Manager to make changes to source image files will trigger updates to the JCOGS Image cache

Improved: 

• Images that don't need resizing are now not resized … 🤨
• Documentation relating to licensing modes
• Documentation relating to crop operations / options
• Debug Messaging associated with Crop/Smart Scale activity
• Advanced Topic text on Image Caching
• Debug Messaging associated with Cache Audting

Bug fixes for:

• php 8.1 TypeError when using php 7.4 and Face Detect
• odd results happening when filter processing fails
• text processing issue when empty string sent to Text Overlay method
• cache audit not clearing all legacy files from cache folders
• improperly formatted crop parameter can trigger php warnings in php 8.1
• CP status message when licensing server not reachable not reporting location of licensing server correctly

New:

• face_detect filter
• face_crop_margin parameter
• face_detect_sensitivity parameter

Improved: 

• crop parameter now includes face_detect directive to determine focus point for crop
• browser capability testing methods (for determining webp image format support)

Bug fixes for:

• Browser capability detection not working for some versions of macos / safari
• Allow Scale Larger flag being misinterpreted within resize
• php 8 ignores font files due to incorrect mime type report
• TypeErrors in Text Overlay filter
• License error - new builds on php 8.1
• Fallback colour field images not generated when image has no dimensions
• Lazy Loading - spurious / at start of src string
• Mask Filter - Negative values can sometimes cause an exception fault

New:

• replace_colors filter

Added: 

• Add image size constraint to auto-adjust options

Improved: 

• compatibility of <img> tags with accessibility guideance when outputing SVGs
• license keys are now obscured in license tab of add-on control panel
• license validation methods
• behaviour when image enlargement requested by allow_scale_larger parameter not set to ‘yes’

Bug fixes for:

• License error triggers wrong help message for serial number
• CP setting for maximum image size duplicated Image settings and advanced settings
• Debug notice for invalid image path contained wrongly formed path
• Animated gifs could not be converted to other formats
• {lazy_image} variable appears as unprocessed term when Lazy option not selected
• Crop parameters not being interpreted correctly when smart-scaling enabled

Added: 

• Add image size constraint to auto-adjust options

Improved: 

• php 8.2 compatibility
• Lazy loading - various updates plus new {lazy_image} variable
• Srcset operation - new variables {srcset_param} and {sizes_param} available for self-constructed tags
• PNG quality parameter processing now more effective
• Image less likely to trigger exception events
• Image now more informative about failure of server to meet Image's operational requirements

Bug fixes for:

• exception crash when trying to use with php 7.3 or earlier
• caching issues on some MSM sites
• issue that prevented Image from running on some Windows based machines
• srcset units should be w not px
• various Image debug message texts now properly mapped to errors / isssues 
• exception crash occurs when Image cache location is unwritable
• style consolidation activity fails if ‘background-image’ included in entry due to quoting issues
• srcset failing with exception error
• browser capability checks not working for some versions of macOS Safari

Added: 

• Default Image Size setting - incorporates SVG sizing defaults. If set, now also applies whenever insufficient dimension information given in tag.
• Run cache audit now option in caching control panel area
• documentation relating to cache audit and class consolidation features

Improved: 

• Caching and cache audit control panel now actions are now also applied to all cache directories defined via tags since last cache reset
• Significant changes to layout of caching panel to improve clarity and functionality

Bug fixes for:

• php warnings when using php 8.1, where image path prefix specified and not used
• cache status message (in template debug output) confusing after cache cleared
• under some update scenarios clearing the cache the first time after an update would trigger php warnings
• cache audit process could get confused by very old cache-log files on first audit after an update
• LQIP transformation queue being wrongly set to repeat all transformations to image before applying LQIP filter
• issue relating to class/style consolidation in some complex tag-pair use cases
• issue relating to ttf font file not being found during text overlay filter operation

Added: 

• Default option for class consolidation tag parameter

Bug fixes for:

• Allow Scale Larger default value being ignored sometimes
• Issue with filedir when validating some images

Added: 

• Option to set default Allow Scale Larger behaviour via add-on Control Panel pages

Bug fixes for:

• bug relating to casing for namespaces used in some custom Filters
• bug relating to use of attributes parameter with other unrecognised tags (e.g. class=)

New: 

• Significant changes in the JCOGS Image codebase to support future developments

Added: 

• New noise and dot image filters
• New square and rectangle mask filters
• Average_color variable
• Passthrough support for animated gif files
• Default setting for png_quality.
• Support for CE Image style tag / variable name-spacing (Thanks @Sy Andersohn!)
• EE processing hook for compatibility with CE Image's saved hook
• Option to use raw EE db format ‘file’ entries as an image source
• Audit / maintenance support for multiple image cache locations

Improved: 

• Online documentation 
• Layout of CP Settings pages
• Image cache operation and maintenance functions
• Rewritten filtering and transformation code
• Licensing process / operation
• Debug messaging 
• Tag parameter processing
• Workflows for internal image processing
• php8 compatibility wrt Dominant Colour calculations
• Tolerance of imperfect EE configurations
• Support for operations when EE cache driver disabled

Bug fixes for:

• bug relating to calculation of file information variables 
• bug in processing of default fallback sources
• bug in processing of fit parameter
• bugs in lazy loading / lqip / dominant colour processing
• bugs relating to Cache usage reporting
• bug in rendering of srcset based tags
• bug in reporting of {path} variable 
• bug in generation of Lazy-Loading tag output (path) 
• bug in saving of Add-on version information to settings db table
• bug in processing of invalid cache_dir parameter entries
• bug in filename_prefix / filename_suffix handling of URI reserved characters
• bug in handling empty options in Text Overlay parameter strings

Added: 

• Initial support for SVG format images

Bug fixes for

• image path problems for EE configurations with base_url directory offset from the webroot
• file access problems where filenames include urlencode special characters
• operational issues when EE base_path value not set
• demo mode not working on public domains

Added: 

• Processed Image mime type variable

Improved: 

• Messaging related to cache status reporting
• Option for limiting length of filename - added max-length validation rule
• Sensing of webp image rendering properties for Apple macOS browsers

Bug fix for:

• Handling of pass-through <img> parameters when processing bulk tag

Added: 

• Support for EE7's new file system.

Improved: 

• Added more tolerant processing of mal-formed PNG files.
• Better reporting of issues when validating a license.
• Less aggressive EE cache clearing on version update…

Bug fix for

• Corrected labelling issue with save button on License page

Bug fix for:

• Minor but annoying bug relating to licensing utility methods

Added: 

• Support for CE Image filename, filename_prefix, filename_suffix parameters.
• Demonstration mode now supports same list of TLDs as EE Pro's Trial Mode.

Improved: 

• Mechanism for generating unique caching hash for processed image filenames.
• Update to do documentation site - speed / navigation

Bug fix for:

• Remove trailing / from {path_orig} variable (kudos to Ron Hickson for both finding and fixing)

Bug fix for:

• Minor but annoying bug relating to staging server validation

Improved: 

• More efficient licensing validation processes

Bug fixes for:

• Cache clearing status message
• Licensing server validation

Improved: 

• Handling of situations where JCOGS Image cannot contact its licensing server.
• Reduce need for multiple calls to licensing server during one validation campaign

New:

• Staging Server support in Licensing system

Added:

• Parameter to disable browser checks on per-tag basis

Improved:

• Demonstration Mode always active when no license present
• Reporting of reasons why license validation has failed

Bug fixes for:

• Licensing for domains with ports specified

New:

• Sobel Edgify Filter
• Report on cache utilisation on System Defaults add-on settings page

Added: 

• An Auto-sharpen default setting
• Auto_sharpen as tag parameter
• Ability to rotate text overlays and watermark images
• Ability to specify image path prefix (for CDNs etc)
• Cache Clearance Button

Improved: 

• JCOGS License validation support
• completely re-written methods for image masking and for adding borders to masked images; 
  • masking on average 13% faster, 
  • masks with a border on average 17% faster; 
  • image quality significantly improved for both operations
• layout for add-on settings page
• code optimisations give 10-15% reduction in processing time on typical workloads
• better png compression
• cached image handling
• image processing workflows (internal to add-on)

Bug fixes for:

• attribute consolidation in bulk tag processing
• caching of settings after a change
• generation of lazy-loading images for images that include image masks and borders

New: 

• Auto Sharpen filter
• Sepia filter (two versions of)

Added:

• Rounded Corners parameter
• Reflection parameter
• border support for masked shapes / rounded corners
• option to limit max dimensions for processing of image
• option to disable active browser checking
• looking for remote images in CE Image remote cache if all else fails
• user selectable cache filename separator

Improved: 

• sharpen filter now uses unsharp mask (matching CE Image)
• filename processing avoids separator clashes
• very much faster image validation
• better CP layout
• image format selection logic when chosen format not supported
• error trapping / reporting (421 Savepath issue)
• processing time reporting
• parameter validation for rotate and flip operations
• php 8.1 compatibility
• manipulation parse sequence more accurately follows that used by CE Image
• moved some functions to Image Utilities Class

Bug fixes for:

• browser image format detection for recent Safari browsers
• calculation of watermark repeat offsets
• rotated image dimension calculation
• a colour validation bug (rba contains non-numerical values)
• a colour validation bug (validation of three character colours -> black)
• initial dimension calculation (use round not int)

Added:

• support for GD's built-in image filters
• control panel options for setting default php memory and execution time limits

Improved: 

• Standardise on tiger160,3 hashing algorithm (faster... https://php.watch/articles/php-hash-benchmark)
• image validation methods
• processing of fallback image options
• methods and default options for remote file retrieval
• initial image loading method (reduce memory footprint, more reliable)
• compatibility with php8.1

Bug fixes for:

• calculation of watermark repeat offsets
• default values for filter - shaped masks

New:

• Jump Menu support

Added: 

• active check for php version being used (fails gracefully if version is not sufficient)

Improved:

• file retrieval methods for local files

Bug Fixes for:

• issue with autocache and template caching competing, changed JCOGS Image to work around conflicts
• edge condition where fallback_src= parameter might be ignored
• url_only= parameter was outputing full URL rather than local URL. Updated to ensure compatibility with CE-Image behaviour
• added a work-around for Wygwam double-encoding error

New:

• Lazy-loading feature
• Mask filter
• dominant_color filter
• palette method
• LQIP filter

Improved:

• handling of fallback options
• Improved methods for setup / image validation
• Improved method to retrieve remote images
• Improved handling of oversized source images
• Improved cache operations (cache_mode= parameter deprecated)

Bug Fixes for:

• php8 compatibility improvements
• naming of cache images when fallback images used now reflect fallback image name
• fit calculations - further edge-case improvements

New: 

• aspect_ratio variables
• automatic cache cleaning process
• automatic generation of <img> srcset parameter for responsive images
• automatic image format substitution when incompatible format chosen
• browser image format capabilities detection
• server image format capabilities detection
• filename based cache duration management
• default image save format option
• support for default fallback local or remote image or colour field
• support for overlay text
• support for RGB / RGBA / 4 and 8 digit hex colour patterns
• server image format capabilities detection
• srcset auto-generation for responsive images
• support for watermarking

Improved:

• detection / handling of PNG8 and PNG24
• processing of bulk images

Bug Fixes for:

• filesize reporting
• fit calculations
• fast cache processing
• transparency collapsing

New:

• border= parameter
• cache_mode option (fast / slow)
• documentation site launched

Bug Fixes for:

• parsing the {attributes} variable
• min / max precendence calculations
• processing of FIT parameter

New:

• First Commercial Release