To use JCOGS Image you need the following things to be available / in place:
- A web server running php version 7.4, 8 (recommended) or 8.1 (recommended).
- The web server needs to have a copy of the GD or GD2 library installed.
- An ExpressionEngine 5, 6 or 7 installation.
If your server does not fully meet the requirements stated JCOGS Image will not operate properly. However JCOGS Image will do its best to let you know which requirement is not being met so you can correct this:
- Within the Control Panel / Setup area JCOGS Image will display a warning message outlining what element of the requirements is not currently being met.
- If you try to process a template that contains JCOGS Image tags, these tags will return no output, but will write a message into the EE template debugging log to let you know which server requirement is not currently met, and so caused Image to stop processing your tag.
jcogs_img folder to your
system/user/addons folder and then install from the ExpressionEngine Control Panel Add-ons page.
To update the add-on copy the updated
jcogs_img folder to your
system/user/addons folder, replacing the folder that was there before, and then update the add-on from the ExpressionEngine Control Panel Add-ons page.
When you update JCOGS Image may clear both its own Image cache and the EE Template cache; it does this when this is necessary to ensure that when your site's pages next are accessed the images displayed are the correct ones.
If you have installed a third-party caching tool (such as Speedy or Rocket) or if your site uses an external caching system (Litespeed, Varnish etc.) you will need to ensure yourself that those caches are cleared as appropriate; failure to do so may lead to unpredictable output from your website until such times as those caches reset themselves.
Licensing and Operating Modes
JCOGS Image is licensed software, to get full use from it you will need to purchase a license key.
A license key will allow the add-on to operate without limitation on a single EE installation running on a server connected to the public internet and on any number of EE installations linked to servers with local IP ranges or using domains ending in any of these top level domain suffixes: acc, acceptance, demo, example, invalid, loc, local, localhost, sandbox, stage, staging, test, testing, vm.
You can to purchase a license online from the EE Add-on Store or from Devot:ee. Once purchased, enter your license key and the email address used for the purchase into the appropriate boxes in the System Defaults section of the JCOGS Image add-on control panel pages.
Use with staging servers
To facilitate the development of sites, licensed copies of JCOGS Image offer you the opportunity to register a staging server linked to a separate public internet domain to use alongside the live site.
Enter the domain name of the staging server into the input field that will appear below the spaces used to register the license key and email address.
The license status of the staging server will be recognised automatically when you install a copy of JCOGS Image on the staging server.
Using JCOGS Image without a license - demonstration mode
When used without a license JCOGS Image will operate in a demonstration mode.
While in demonstration mode JCOGS Image is fully functional, making it possible for you to fully evaluate the software, however:
- When demonstration mode is enabled JCOGS Image will add a watermark to any images processed.
If you encounter any difficulties activating your add-on please contact firstname.lastname@example.org with details.