Imageshop.Optimizely.Plugin 1.0.35

There is a newer version of this package available.
See the version list below for details.
dotnet add package Imageshop.Optimizely.Plugin --version 1.0.35                
NuGet\Install-Package Imageshop.Optimizely.Plugin -Version 1.0.35                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Imageshop.Optimizely.Plugin" Version="1.0.35" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Imageshop.Optimizely.Plugin --version 1.0.35                
#r "nuget: Imageshop.Optimizely.Plugin, 1.0.35"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Imageshop.Optimizely.Plugin as a Cake Addin
#addin nuget:?package=Imageshop.Optimizely.Plugin&version=1.0.35

// Install Imageshop.Optimizely.Plugin as a Cake Tool
#tool nuget:?package=Imageshop.Optimizely.Plugin&version=1.0.35                

Imageshop.Optimizely.Plugin

Platform Platform Github repository: https://github.com/screentek/Optimizely

Imageshop is an online-based Digital Asset Management (DAM) software. This module integrates Imageshop in the Optimizely 12 CMS User Interface. It contains a custom property and a TinyMCE plugin that launches the Imageshop image selection interface in a dialogue.

How to get started - Installation

Summary

The installation process currently requires some manual work. We are working to improve this process.

1. Installing Nuget Package:

Start by installing NuGet package (use Nuget.org feed)

Install-Package Imageshop.Optimizely.Plugin

Files needed for the project will be copied from the nuget package once the project is built. If files already exists, they will be overwritten on each build, except for the view files: ImageshopImage.cshtml and ImageshopVideo.cshtml. If you want the newest versions of these files, delete these two and rebuild the project.

2. Adding two lines to your Startup.cs:

Add the following lines to your startup.cs file.

First line to be added at the top (before the CMS is added):

services.AddImageShopRegistration()

Second line can be added later on:

services.AddImageshopTinyMceConfiguration()

ScreenShot

3. Add to module.config:

Edit your Module.config file by adding the details from ModifyTheseFiles/module.config. If you don't have a module.config file, copy paste the file into the root directory of your project.

4. Configure access token:

After the package is successfully installed you need to add your access token to configuration section GetaEpiImageshop in your appsettings.json located in root directory:

    "GetaEpiImageshop": {
        "Settings": {
            "token": "<Token here>",
            "interfaceName": "",
            "documentPrefix": "Warning",
            "culture": "nb-NO",
            "profileId": "",
            "showSizeDialog": "true",
            "showCropDialog": "true",
            "freeCrop": "true",
            "initializeTinyMCEPlugin": "true"
        }
    }

ScreenShot

Basics

Add an Imageshop image property to your content model:

[BackingType(typeof(PropertyImageshopImage))]
[UIHint(ImageshopSettings.UIHint.ImageshopImage)]
[ImageshopSettings(InterfaceName = "", DocumentPrefix = "", ProfileID = "", Culture = "nb-NO")]
[ImageshopSizePreset("Main image (1280x720)", 1280, 720)]
[ImageshopSizePreset("Thumbnail image (400x300)", 400, 300)]
public virtual ImageshopImage MainImage { get; set; }

Minimal Imageshop image property example:

[BackingType(typeof(PropertyImageshopImage))]
public virtual ImageshopImage MainImage { get; set; }

Render the image property in a view:

@Html.PropertyFor(m => m.CurrentPage.MainImage)

Image collection property:

[Display(Name = "Bilder")]
[BackingType(typeof(PropertyImageshopImageCollection))]
[UIHint(ImageshopSettings.UIHint.ImageshopImageCollection)]
[ImageshopSettings(ProfileID = "CAROUSEL", ShowCropDialog = false, ShowSizeDialog = false)]
public virtual IEnumerable<ImageshopImage> Images { get; set; }

Imageshop video property:

[BackingType(typeof(PropertyImageshopVideo))]
public virtual ImageshopVideo MainVideo { get; set; }

Render the video property in a view:

@Html.PropertyFor(m => m.CurrentPage.MainVideo)

Imageshop video collection property:

[BackingType(typeof(PropertyImageshopVideoCollection))]
[UIHint(ImageshopSettings.UIHint.ImageshopVideoCollection)]
public virtual IEnumerable<ImageshopVideo> Videos { get; set; }

TinyMCE

A TinyMCE plugin is included for browsing Imageshop images to add to your XhtmlString properties. It's located in the "media" group.

Configuration

Parameter Type Description
baseUrl string Base URL to Imageshop client. Default is https://client.imageshop.no/InsertImage2.aspx
token string Token identifying the user.
interfaceName string Standard interface used when searching images.
documentPrefix string Standard document code prefix used when uploading images.
culture string Language for the client. Supports en-US and nb-NO. Norwegian is default (nb-NO).
showSizeDialog true/false Indicates whether the size dialogue should be shown. Default is true.
showCropDialog true/false Indicates whether the crop dialogue should be show. Default is true.
initializeTinyMCEPlugin true/false Indicates whether the tinymce plugin should be initialized.
sizePresets string Separated with semicolon and colon. See IMAGESHOPSIZES: https://apidocumentation.imageshop.no/

See configuration section GetaEpiImageshop in appSettings.json for examples.

Screenshots

ScreenShot

ScreenShot

ScreenShot

Changelog

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.2.6 70 10/31/2024
1.2.5 80 10/23/2024
1.2.2 1,969 12/10/2023
1.2.1 553 10/26/2023
1.2.0 2,818 6/26/2023
1.1.1 637 6/16/2023
1.1.0 157 6/15/2023
1.0.41 166 6/8/2023
1.0.40 387 3/22/2023
1.0.39 237 3/17/2023
1.0.38 384 1/23/2023
1.0.37 314 1/16/2023
1.0.36 431 12/1/2022
1.0.35 413 11/11/2022 1.0.35 is deprecated because it has critical bugs.
1.0.34 405 11/11/2022 1.0.34 is deprecated because it has critical bugs.
1.0.33 418 11/10/2022 1.0.33 is deprecated because it has critical bugs.