Sitefinity Configuration XDT Transformation

sitefinity | 2024-03-20

⚙️ Pre-requisite

Before you begin, ensure you have installed the Slow-Cheetah NuGet package:


🚀 Here We Go: Step-by-Step Guide

Step 1: Locate the Configuration Folder

In Visual Studio, navigate to the App_DataSitefinityConfiguration folder.

Note: If this folder is not already included in the Visual Studio project, make sure to add it.

Step 2: Create a New Configuration File

Create a new configuration file that needs transformation. The file should follow the naming convention:

<ConfigName>.<Stage>.config (Ex. PagesConfig.Staging.config)

Step 3: Set File Properties

Right-click the newly created file and select Properties.

Set the Build Action to Content.

Step 4: Install Slow-Cheetah

Ensure you have installed the Slow-Cheetah NuGet package in your project.

Step 5: Add the Transformation File

Add a transformation file for the configuration. For example, Authentication.Staging.config.

Screenshot1

Step 6: Verify .csproj File

Check your .csproj file to make sure the root config (e.g., AuthenticationConfig.config) contains the following:

<TransformOnBuild>true</TransformOnBuild>

and the created AuthenticationConfig.Staging.config contains

<DependentUpon>AuthenticationConfig.config</DependentUpon>
<IsTransformFile>True</IsTransformFile>

Screenshot2

Step 7: Publish with the Correct Build Configuration

Finally, publish the project with the appropriate build configuration (e.g., Staging, Production) to apply the transformation.

📚 References