Helpfulcore - helpful features for Sitecore

Helpfulcore Logging

Abstracted logging service to support multiple log providers.

Helpfulcore.Logging

This project declares the

Helpfulcore.Logging.ILoggingService

interface which is meant to be the container for different provider implementation. Its implementation is

Helpfulcore.Logging.LoggingService

Initialize your LoggingService with number of

Helpfulcore.Logging.ILoggingProvider

instances and use interface methods for writing to your logs into all specified providers.

Providers

There are 2 implementation to use currently:

• Helpfulcore.Logging.Sc - provider which uses Sitecore.Diagnostics.Log
• Helpfulcore.Logging.NLog - provider which uses NLog file logger.

Helpfulcore.Logging.Sc

In order to use in your Sitecore website solution please install next nuget packages to your Website solution:

Install-Package Helpfulcore.Logging.Sc

This package will install the Sitecore provider and will add the configuration for the LoggingService with one provider which just writes to Sitecore.Diagnostics.Log. The configuration will reside in dedicated include config file /App_Config/Include/Helpfulcore/Helpfulcore.Logging.Sc.config

<?xml version="1.0" encoding="utf-8" ?>
<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/">
  <sitecore>
    <helpfulcore>
      <logging>
        <loggingService type="Helpfulcore.Logging.LoggingService, Helpfulcore.Logging" singleInstance="true" >
          <param name="provider1" ref="helpfulcore/logging/providers/scLoggingProvider"/>
        </loggingService>
        <providers>
          <scLoggingProvider type="Helpfulcore.Logging.Sc.ScLoggingProvider, Helpfulcore.Logging.Sc" singleInstance="true" >
            <LogLevel>Debug</LogLevel>
          </scLoggingProvider>
        </providers>
      </logging>
    </helpfulcore>
  </sitecore>
</configuration>

In order to use it you can call it directly from Sitecore configuration factory

var loggingService = Factory.CreateObject("helpfulcore/logging/loggingService", true) as ILoggingService;

or register it in your IoC container like

container.Register(
	typeof(ILoggingService),
	() => Factory.CreateObject("helpfulcore/logging/loggingService", true) as ILoggingService,
	Lifestyle.Singleton);

Helpfulcore.Logging.NLog

In order to use this provider in your solution, please install nuget package:

Install-Package Helpfulcore.Logging.NLog

This package will install the NLog provider and will add it to the LoggingService as second provider injected into constructor. Installing both packages leads to having single logging service which writes to both providers. The configuration will reside in dedicated include config file /App_Config/Include/Helpfulcore/Helpfulcore.Logging.NLog.config The default configuration will write to your $(dataFolder)/logs/Website.log.${date:format=yyyyMMdd}.txt file.

<?xml version="1.0" encoding="utf-8" ?>
<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/">
  <sitecore>
    <helpfulcore>
      <logging>
        <loggingService type="Helpfulcore.Logging.LoggingService, Helpfulcore.Logging" singleInstance="true" >
          <param name="provider2" ref="helpfulcore/logging/providers/websiteLogFileProvider"/>
          <param name="provider3" ref="helpfulcore/logging/providers/errorLogFileProvider"/>
        </loggingService>
        <providers>
          <websiteLogFileProvider type="Helpfulcore.Logging.NLog.NLogLoggingProvider, Helpfulcore.Logging.NLog" logFilePath="$(dataFolder)/logs/Website.log.${date:format=yyyyMMdd}.txt" singleInstance="true">
            <param name="filePath">$(logFilePath)</param>
            <LogLevel>Debug</LogLevel>
          </websiteLogFileProvider>
          <errorLogFileProvider type="Helpfulcore.Logging.NLog.NLogLoggingProvider, Helpfulcore.Logging.NLog" logFilePath="$(dataFolder)/logs/Website.Errors.log.${date:format=yyyyMMdd}.txt" singleInstance="true">
            <param name="filePath">$(logFilePath)</param>
            <LogLevel>Warn</LogLevel>
          </errorLogFileProvider>
        </providers>
      </logging>
    </helpfulcore>
  </sitecore>
</configuration>

This feature also allows you to configure your features and make them writing to dedicated log files if you need that.