👁 Image
SoundInTheory.Piranha.MediaExtensions.Images 4.8.0

Piranha Media Extensions

Various enhancements to Piranha CMS media

Cropped Image Field

An image field that allows multiple crops on a single image.

Only filesystem storage supported for now.

Supports cropping settings and multiple crops.

//In Piranha WebApplicationBuilder...
options.UseCroppedImageField();
//etc

//In PiranhaApplicationBuilder
options.UseCroppedImageField();
//etc

Then configure in Piranha content/model/etc

[Field, CroppedImageFieldSettings(AspectRatio = 16d / 9d, MinWidth = 100, MinHeight = 100, Crops = new string[] { "Default", "Second Crop" })]
public CroppedImageField TestImageFieldWithSettings { get; set; } 
[Field]
public CroppedImageField TestImageFieldWithoutSettings { get; set; }

Image Sharp Providers

Providers and resolvers for ImageSharp.Web

There is both a provider for Piranha Media and limited support for Remote Images as well.

Simply configure...

//In Piranha WebApplicationBuilder...
options.UseImageSharpForMedia((opts) =>
{
 opts
 //PhysicalFileSystemProvider cannot be first in the list. You can add it later on.
 .RemoveProvider<PhysicalFileSystemProvider>()

 .Configure<PiranhaMediaImageProviderOptions>(o => o.RootName = "/image")
 .AddProvider<PiranhaMediaImageProvider>()

 .Configure<RemoteImageProviderOptions>(o =>
 {
 o.RootName = "/remote";
 //A whitelist is necessary as it prevents any hijacking of your endpoint
 o.WhiteList = new List<string>()
 {
 "upload.wikimedia.org"
 //etc
 };
 })
 .AddProvider<RemoteImageProvider>();
});
//etc

//In PiranhaApplicationBuilder
options.UseImageSharpForMedia();
//etc

Gallery Field

Field that supports multiple images

//In Piranha WebApplicationBuilder...
options.UseGalleryField();
//etc

//In PiranhaApplicationBuilder
options.UseGalleryField();
//etc

Then configure in Piranha content/model/etc

[Field]
public GalleryField TestGalleryField { get; set; }

//In your view/wherever you want to access
foreach(var image in TestGalleryField.Images){
//Use as if it's a normal image field.
}

Extended Media Manager

Supports filtering and ordering on both mediapicker and media views.

//In Piranha WebApplicationBuilder...
options.UseMediaManager();
//etc

//In PiranhaApplicationBuilder
options.UseMediaManager();
//etc

Examples are provided in repo.