Skip to content

Installation

Mihail Yankov edited this page Apr 7, 2018 · 4 revisions

How to install:

1. From NuGet

  • if you are using Sitefinity between 7.3.5600 and 9.0.6041 inclusive.

PM > Install-Package Sitefinity.LibraryItemsDownloader -Version 7.3.5600

  • if you are using Sitefinity 9.1.6100 or higher.

PM > Install-Package Sitefinity.LibraryItemsDownloader -Version 9.1.6100

The difference between versions is a little change in the Sitefinity API when saving configuration files.

2. From Releases page

Download the release depending on your sitefinity version.
Open your project with Visual Studio.
Add Sitefinity.LibraryItemsDownloader.dll as reference.

3. Debug or troubleshoot problems of the project

Clone the project to local machine.
From your solution, right click, Add existing project and navigate to Sitefinity.LibraryItemsDownloader.csproj Add Sitefinity.LibraryItemsDownloader as project reference.

Additional

The package depends on these assemblies from Sitefinity:

  • Telerik.Sitefinity
  • Telerik.Sitefinity.Model
  • Telerik.Sitefinity.Utilities
  • Telerik.OpenAccess

You may need to add <assemblyBinding /> configurations:

<dependentAssembly>
  <assemblyIdentity name="Telerik.Sitefinity" publicKeyToken="b28c218413bdf563" culture="neutral" />
  <bindingRedirect oldVersion="0.0.0.0-<sfVersion>" newVersion="<sfVersion>" />
</dependentAssembly>
<dependentAssembly>
  <assemblyIdentity name="Telerik.Sitefinity.Model" publicKeyToken="b28c218413bdf563" culture="neutral" />
  <bindingRedirect oldVersion="0.0.0.0-<sfVersion>" newVersion="<sfVersion>" />
</dependentAssembly>
<dependentAssembly>
  <assemblyIdentity name="Telerik.Sitefinity.Utilities" publicKeyToken="b28c218413bdf563" culture="neutral" />
  <bindingRedirect oldVersion="0.0.0.0-<sfVersion>" newVersion="<sfVersion>" />
</dependentAssembly>
<dependentAssembly>
  <assemblyIdentity name="Telerik.OpenAccess" publicKeyToken="b28c218413bdf563" culture="neutral" />
  <bindingRedirect oldVersion="0.0.0.0-<openAccessVersion>" newVersion="<openAccessVersion>" />
</dependentAssembly>
<dependentAssembly>

where <sfVersion> is the version of the Sitefinty in the project. and <openAccessVersion> is the version of the Telerik.OpenAccess assembly.

The dependencies are added using this approach instead as nuget package, because lot of sitefinity projects have directly references to dll-s.

There are several ways to identify which version of sitefinity you are using

  1. If you have access to the backend - open the licensing page (under Administration).
  2. At the home page open the page source and search for meta tag <meta name="Generator" content="Sitefinity 8.1.5800.0 PU" />
  3. In Visual Studio, expand the references of the project, find Telerik.Sitefinity , Right click > properties

source: https://knowledgebase.progress.com/articles/Article/How-to-check-your-current-Sitefinity-version

Backup

It's recommended to make a backup of the project and database before proceed.