Installing The Portal Connector on Sitefinity 15 (NuGet)

  • 1. Prerequisites
  • 2. Setup
  • 3. Installation
  • 4. Activation
  • 5. Licensing

PLEASE NOTE: The Portal Connector supports the last three revisions of each Sitefinity minor version. We don’t provide builds to other Sitefinity versions because of potential security issues and bugs present in the older versions.

Prerequisites

  • A web server running Sitefinity with one of the last two builds of the following Sitefinity versions:
    • Sitefinity 15.0 (8200)
  • No existing Portal Connector installation (see Upgrade for information on updating an existing installation)
  • Any Microsoft® Visual Studio editions for version 2017 or later
  • Microsoft® .NET Framework 4.8

Setup

  1.  In Visual Studio, Navigate to Tools -> NuGet Package Manager -> Package Manager Settings. Click on the + icon in package sources and add the name and Source of NuGet packages.
  2. Name: The Portal Connector
  3. Source:   https://nuget.portalconnector.com/index.json  
     
  4. Click OK and it will add the TPC NuGet Package feed to your Visual Studio. 

Installation

  1. In the Solution Explorer in Visual Studio on the right-hand side, right-click References and then click Manage NuGet Packages…
    NuGetInstall1
  2. In the NuGet Package Manager select the package source The Portal Connector set in step 2 of Preparing for Upgrade.
    NuGetInstall2
  3. If you want to upgrade the Sitefinity version of your project, upgrade the Sitefinity.All NuGet package now.
  4. Find the PortalConnector.All package that matches your current TPC and Sitefinity version and click the Install/Update button. If you are developing against a class library rather than a Sitefinity site, you can install the PortalConnector.Core package.
    NuGetInstall3

    The Portal Connector package versions follow a standard convention. We can look at the following example to understand that convention.

    Example: PortalConnector.All - 6.2.150.101

    6.2 – This indicates that the package is for The Portal Connector version 6.2.

    130 – This indicates that the package is for Sitefinity 15.0 (Any patch version).

    101 – This indicates that the package is Revision 101.

  5. In order to utilize the latest Razor templating features, The Portal Connector utilizes the package Microsoft.CodeDom.Providers.DotNetCompilerPlatform. This package should modify the web.config when it is installed with the product, although in some cases the web.config will not be modified. Verify that the following code has been added within the configuration element of the web.config, or add it manually. Please ensure the DotNetCompilerPlatform version in the web.config matches with the version of DotNetCompilerPlatform in the packages.config.

    <system.codedom>
      <compilers>
            <compiler language="c#;cs;csharp" extension=".cs" type="Microsoft.CodeDom.Providers.DotNetCompilerPlatform.CSharpCodeProvider, Microsoft.CodeDom.Providers.DotNetCompilerPlatform, Version=3.6.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" warningLevel="4" compilerOptions="/langversion:default /nowarn:1659;1699;1701" />
            <compiler language="vb;vbs;visualbasic;vbscript" extension=".vb" type="Microsoft.CodeDom.Providers.DotNetCompilerPlatform.VBCodeProvider, Microsoft.CodeDom.Providers.DotNetCompilerPlatform, Version=3.6.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" warningLevel="4" compilerOptions="/langversion:default /nowarn:41008 /define:_MYTYPE=\&quot;Web\&quot; /optionInfer+" />
        </compilers>
    </system.codedom>
    
  6. Once the package has been installed to your Sitefinity project, Rebuild your solution in Visual Studio. The project should be ready to run!

Activation

Now that the Portal Connector binaries are installed, we need to activate the module in order to gain access to all of the custom widgets and functionality TPC provides.

To activate The Portal Connector, follow these steps:

  1. Navigate to the Sitefinity backend
  2. Under the Administration menu, select Modules & Services under the System section, or go to the page ~/Sitefinity/Administration/ModulesAndServices. 
  3. Scroll down until you find “The Portal Connector” module. On the right-hand side of this option, select “Actions” and then “Install”. Do the same for “The Portal Connector (MVC)”. This process usually takes between 2-4 minutes, depending on server speed.
  4. Add in your Portal Connector License by going to Administration > Licensing under The Portal Connector section.  
  5. After these steps, you are ready to use Portal Connector.

Licensing

This section will show you how to apply your license to your Portal Connector installation. For more information on licensing please contact sales at info@crmportalconnector.com

You can read The Portal Connector End-User License Agreement here: https://www.crmportalconnector.com/license/eula.pdf

  1. Navigate to the license keys page on The Portal Connector web portal found here.
  2. Select View Keys next to the portal where you wish to install the license.
  3. On the next page, click View on the appropriate TPC version for your installation.
  4. Copy the contents of the License Key in the text box to your clipboard.
  5. Log in to the Sitefinity backend of your portal.
  6. Under the Administration menu, select Portal Connector Licensing.
     
  7. Paste the license key from your clipboard into to the license text area.
  8. Click Update License.
     
  9. If the correct license was copied, the Portal Connector will be licensed with a valid license.