Override Media Manager to Change Url

Question

I need to insert text for a media item when getting a media type of PDF by changing the GetMediaUrl method. This is for an RTE field. I went to override the MediaProvider, but found it was obsolete and replaced by the MediaManager. I created a class that inherits from the BaseMediaManager. Now I am wondering how to add that class to the pipeline. I see the one for MediaProvider, but can't figure out where to add one for MediaManager.

I found this for Media Provider:

<mediaProvider type="Sitecore.Resources.Media.MediaProvider, Sitecore.Kernel"/>

Thanks

Answer 1

You need register the new Media Manager using Sitecore Dependency Injection (see 'Registration in code' chapter). It can be done via Service Configurator as described in the article.

Creating Service Configurator

Implement Sitecore.DependencyInjection.IServicesConfigurator interface from Kernel assembly. Please note that you need to reference Microsoft Dependency Injection 1.0.0 NuGet package:

public class ServiceConfigurator : IServicesConfigurator
{
    public void Configure(IServiceCollection serviceCollection)
    {
        serviceCollection.AddSingleton<BaseMediaManager>(s =>
            new MyMediaManager(
                new DefaultMediaManager(
                    s.GetService<BaseFactory>(),
                    s.GetService<MediaProvider>()
                )));
    }
}

Implementing Media Manager

You may inherit the DefaultMediaManager class as you mentioned but in case of numerous changes required (probably by different teams) composition might be a better choise):

public class MyMediaManager : BaseMediaManager
{
    private readonly BaseMediaManager _mediaManager;

    public MyMediaManager(BaseMediaManager mediaManager)
    {
        _mediaManager = mediaManager;
    }

    public override Media GetMedia(MediaItem item)
    {
        // add you custom logic here
        return _mediaManager.GetMedia(item);
    }
    ...
}

Registering Service Configurator

Last step, add the following registration to your configuration files:

<configuration>
  <sitecore>
    <services>
      <configurator type="<younamespace>.DependencyInjection.ServiceConfigurator, <yourassembly>"/>
    </services>
  </sitecore>
</configuration>