Getting Started

Sitefinity Feather introduces a modern, convention-based, mobile-first UI framework for Telerik Sitefinity CMS. It allows developers to build mobile-ready sites using their favorite frameworks and includes MVC stock widgets, an AngularJS widget designer framework, Boostrap, Foundation and Semantic UI support, and more.

Requirements

• Sitefinity requirements

Prerequisites

Add a custom nuget feed in VisualStudio:

• In VS open Tools -> Options -> NuGet Package Manager -> Package Sources
• Add new package source: Name: FeatherPackages | Source: http://nuget.sitefinity.com/nuget

Clear the NuGet cache files. To do this:

• In Windows Explorer, open the %localappdata%\NuGet\Cache folder.
• Select all files and delete them.

Install Feather

To use Feather, you must install the respective Feather project package from the Sitefinity NuGet Repository. Next, you manually register the Feather module in your project’s assembly.

1. In Sitefinity Project Manager create a blank Sitefinity project. Then, open the Administration and follow the initialization steps to setup the database and create the administrator user account.

2. Install the NuGet package of the Feather project. To do so, in Visual Studio navigate to View » Other Windows » Package Manager Console. Select FeatherPackages as the Package source. Enter the following command to install Feather in your Sitefinity project:

Install-Package Telerik.Sitefinity.Feather 3. In Visual Studio, open your SitefinityWebApp project

4. Expand the Properties node and open the AssemblyInfo.cs file.

   Modify by adding the following snippet:

using Telerik.Sitefinity.Frontend.Mvc.Infrastructure.Controllers.Attributes;
[assembly: ControllerContainer] 

5. In the SystemConfig.config file, add the following markup before the closing tag of <systemConfig>:

<systemServices>
    <add title="Telerik.Sitefinity.Frontend" 
         description="Telerik.Sitefinity.Frontend" 
         moduleId="00000000-0000-0000-0000-000000000000"   
         type="Telerik.Sitefinity.Frontend.FrontendService, Telerik.Sitefinity.Frontend" 
         startupType="OnApplicationStart" 
         name="Telerik.Sitefinity.Frontend" />
</systemServices>

NOTE: If you are using different versions of Sitefinity and the Feather project assemblies, there is a possibility to get errors after running your website. For more information, see Troubleshooting Guide.

Troubleshooting Guide

Errors when using different versions of Sitefinity and Feather project assemblies

In case Sitefinity version you are using is newer than 7.2.5300.0 and it differs from the version of the Feather project assemblies, after running your website, you may get errors. To avoid this, you force your Sitefinity project to use the correct version of Sitefinity, that is, the newer version. To do this, open your web.config file and add the following binding redirects:

<runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="Telerik.OpenAccess" publicKeyToken="7ce17eeaf1d59342" culture="neutral" />
        <bindingRedirect oldVersion="2014.2.910.1" newVersion="****.*.***.*" />
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="Telerik.OpenAccess.35.Extensions" publicKeyToken="7ce17eeaf1d59342" culture="neutral" />
        <bindingRedirect oldVersion="2014.2.910.1" newVersion="****.*.***.*" />
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="Telerik.Sitefinity" publicKeyToken="b28c218413bdf563" culture="neutral" />
        <bindingRedirect oldVersion="7.2.5300.0" newVersion="7.*.****.*" />
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="Telerik.Sitefinity.Model" publicKeyToken="b28c218413bdf563" culture="neutral" />
        <bindingRedirect oldVersion="7.2.5300.0" newVersion="7.*.****.*" />
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="Telerik.Sitefinity.ContentModules" publicKeyToken="b28c218413bdf563" culture="neutral" />
        <bindingRedirect oldVersion="7.2.5300.0" newVersion="7.*.****.*" />
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="Telerik.Sitefinity.Utilities" publicKeyToken="b28c218413bdf563" culture="neutral" />
        <bindingRedirect oldVersion="7.2.5300.0" newVersion="7.*.****.*" />
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="Telerik.Sitefinity.Services.Events" publicKeyToken="b28c218413bdf563" culture="neutral" />
        <bindingRedirect oldVersion="7.2.5300.0" newVersion="7.*.****.*" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>

Fill the newVersion attributes with versions of the assemblies that are in the bin folder of your Sitefinity web application project.

NOTE: Avoid duplications of binding redirects.

[FAQ]