Add-on Documentation from JCOGS Design

ChangelogLast updated: 28 October 2023

1.3.11 (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

1.3.10 (18 July 2023)

New:
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

1.3.9 (12 July 2023)

New:
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

1.3.8 (10 June 2023)

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

1.3.7 (10 May 2023)

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

1.3.6 (10 April 2023)

New:
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

1.3.5 (10 March 2023)

New:
Added: 
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

1.3.4 (12 February 2023)

Added: 
Improved: 
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

1.3.3 (10 January 2023)

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: 
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

1.3.2 (20 December 2022)

Added: 
Bug fixes for:
  • Allow Scale Larger default value being ignored sometimes
  • Issue with filedir when validating some images

1.3.1 (14 December 2022)

Added: 
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=)

1.3 (12 December 2022)

New: 
  • Significant changes in the JCOGS Image codebase to support future developments
Added: 
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

1.2.16 (5 November 2022)

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

1.2.15 (6 October 2022)

Added: 
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

1.2.14 (17 August 2022)

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

1.2.13 (15 June 2022)

Bug fix for:
  • Minor but annoying bug relating to licensing utility methods

1.2.12 (30 May 2022)

Added: 
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)

1.2.11 (21 April 2022)

Bug fix for:
  • Minor but annoying bug relating to staging server validation

1.2.10 (13 April 2022)

Improved: 
  • More efficient licensing validation processes
Bug fixes for:
  • Cache clearing status message
  • Licensing server validation

1.2.9 (11 April 2022)

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

1.2.8 (6 April 2022)

New:
  • Staging Server support in Licensing system
Added:
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

1.2.7 (31 March 2022)

New:
Added: 
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

1.2.6 (21 February 2022)

New: 
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)

1.2.5 (1 February 2022)

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

1.2.4 (21 January 2022)

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

1.2 (12 January 2022)

New:
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

1.1 (6 December 2021)

New: 
Improved:
  • detection / handling of PNG8 and PNG24
  • processing of bulk images
Bug Fixes for:
  • filesize reporting
  • fit calculations
  • fast cache processing
  • transparency collapsing

1.0.12 (8 November 2021)

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

1.0.11 (25 October 2021)

New:
  • First Commercial Release