KeyShot.Umbraco 1.1.0

DAM for Umbraco (DFU) Asset Picker

A lightweight and flexible DAM (Digital Asset Management) asset picker for Umbraco. This package adds a custom property editor that allows editors to browse and select assets directly from KeyShot DAM.

✨ Features

• Custom property editor for selecting DAM assets
• Configurable DAM endpoint and authentication
• Supports single or multiple selections
• Preview of selected assets directly in the backoffice

🚀 Installation

Install via NuGet:

Install-Package KeyShot.Umbraco

or using the .NET CLI:

dotnet add package KeyShot.Umbraco

⚙️ Configuration

After installation, configure your DAM endpoint in appsettings.json:

"Digizuite": {
    "MediaManagerUrl": "<base Media manager url>",
    "BaseUrl": "<base API url>",
    "SystemUsername": "<username> ",
    "SystemPassword": "<password>",    
    "MetaFieldItemGuids": [
        <list of unique ids to include>     
    ],
    "CacheTTLInMinutes": 15,
    "KeyShotManagedIntegrationConfiguration" : {
      "Name": "Cloudflare Clear Cache (Umbraco)",
      "ManagedIntegrationConfiguration": {
        "ForwardManagedIntegrationEndpoints":  ["<umbraco base url>/keyshot/managedintegration/invoke"]
      },
      "Enabled": false,
      "AuthenticationKey": "<Cloudflare auth key>"
    }
  }

Additionally, the following changes must be made to the program.cs file in the Umbraco project

The following line must be added before building the app

builder.Services.AddDamForUmbracoConnector(builder.Configuration);

The following line must be added after the app.UseUmbraco()

app.RegisterKeyShotEndpoints();

📦 Usage

1. Go to Settings → Data Types
2. Create a new data type using DAM Asset Picker
3. Configure options such as:
   • Allowed file types
   • Single/multiple selection
4. Add the data type to your document types

When editing content, authors will see an asset picker modal allowing them to browse and select assets from the DAM.

🧩 Extensibility

You can implement custom DAM providers by extending the service layer. The package exposes interfaces for:

• Fetching assets
• Searching
• Thumbnails & preview metadata

📚 Requirements

• Umbraco CMS 10+
• .NET 6+

📄 License

MIT License

Made with ❤️ for Umbraco editors.