This repository contains an application designed to facilitate the integration of Enonic XP-based sites with the ImageShop platform. The application includes features for efficiently importing, editing, and synchronizing images between the site and the ImageShop media library.
- Installation check: Automatically detects if the ImageShop app is installed on configured sites.
- Image import: Enables importing images directly from ImageShop into the site environment.
- Information synchronization: Displays a synchronization button to update information for already imported images.
- Informative error messages: Provides visual feedback in case of installation issues, misconfiguration, or detection of multiple installations.
- Thymeleaf template integration: Renders the user interface using Thymeleaf templates for consistent presentation.
The application handles HTTP requests and performs the following checks and actions:
- Checks whether ImageShop is installed on the current site.
- Retrieves content based on the
contentId
provided in the request. - Validates the app configuration and returns appropriate error messages if any issues are found.
- Constructs a model with service URLs, translation strings, and control variables for the user interface.
- Renders the interface using the
iimage.html
template, which includes import and sync buttons.
This application is ideal for development teams looking to integrate ImageShop seamlessly and effectively into their Enonic XP-based projects.
git clone https://github.com/99x/imageshop-xp.git
cd imageshop-xp
./gradlew build
-
Install the application: Deploy the
ImageShop
in your Enonic XP environment via Enonic market in the applications tool or build it yourself. -
Configure the application on your site:
-
Ensure that the application is set up in your site structure.
-
In the site configuration, you will need to fill in the following inputs:
- Imported resources folder
- Host
- Token
- Private Key
- Interface Name (optional, used when searching images)
- Document Prefix (optional, used as a prefix for uploaded images)
- Sizes (optional, format example:
Normal 320x240;320x240
) - Language (optional, default language for image searches)
These inputs ensure the proper configuration and functionality of the ImageShop integration in your site.
-
-
Alternative Token and Private Key Configuration:
The Token and Private Key required for HTTP requests to the ImageShop endpoint can also be provided through the configuration fileio.99x.imageshop.cfg
. Use the following variables in the file:imageshopToken
: Specify the ImageShop token.imageshopPrivateKey
: Specify the ImageShop private key.
This approach offers a centralized and secure way to manage these credentials.
Version | XP version |
---|---|
1.0.x | 7.9.0 |
2.0.x | 7.11.0 |
The application is licensed under the Enonic License
Made by 99x