Frequently Asked Questions

How to install a template

As we provide two different products for each template of course there are two different approaches to install a template.

  • Sitefinity Theme:

    • Unzip the .zip file. Copy folder "WebsiteTemplates" to "~/App_Data/Sitefinity/" and follow Telerik instructions:

      http://www.sitefinity.com/documentation/documentationarticles/designer-s-guide/download-a-template-and-theme-from-sitefinity-marketplace

    • If .zip contains second folder "Widgets", copy it in root of your website.

      1. Build your SitefinityWebApp project:
      a) In root of your website open file SitefinityWebApp.csproj
      b) In Solution Explorer select "Show All Files"
      c) Right-click on folder "Widgets" and select "Include In Project"
      d) In Menu select Build->Build SitefinityWebApp

      2. Install the control in the Settings as follows:
      a) In the sitefinity back-end navigate Administration -> Settings ->Advanced
      b) choose Toolboxes -> Page Controls -> ContentToolboxSection
      c) Add a new widget of type "~/Widgets/YourControl/YourControlName.ascx"

    • Some themes have customizations for SearchBox widget. If you found this file in you theme: /WidgetTemplates/SearchBox.ascx - please follow these steps to install custom widget template for SearchBox widget:

      1) Go to Administration -> Settings -> Advanced -> Controls -> ViewMap and create new record there
      2) Into the HostType field copy that line: Telerik.Sitefinity.Services.Search.Web.UI.Public.SearchBox, Telerik.Sitefinity.Search.Impl
      3) Into the LayoutTemplatePath input the relative path to SearchBox.ascx file containing new widget template:
      ~/App_Data/Sitefinity/WebsiteTemplates/ThemeName/WidgetTemplates/SearchBox.ascx (Put existing folder name instead of "ThemeName")
      4) Save this new mapping. It could require to restart the web application to apply all changes. Best way is "iisreset" command in command line. Changes in web.config file are restarting web application too.

    • Themes often use images from Sitefinity Image Libraries. You can find these images in your theme's folder and upload into Image Library. Make sure to use proper urls when you try to access these images. You can see the correct url on Image Library page, just click on button "Actions" under the image and select "View original" - this option will show you the image in new tab with correct url.

  • Sitefinity Community License Site:

    These are for clean installs. The benefit of these sites is they come with pages set up as in the examples. Use instructions below to install the site.

    1. Unzip and copy files to some directory on your server

    2. Restore the database backup using SQL Management Studio
    a) Open SQL Server Management Studio.
    b) Right click on Databases folder -> Restore Database
    c) Select "From device" radio and select the backup file from unzipped template (.bak file)
    d) From the "To database" dropdown select the database you want to restore or put there a new name

    e) On the left side click "Options" tab and check "Overwrite the existing database (WITH REPLACE)"
    f). Click “OK” and wait till the restore process will be finished

    3. Setup IIS website

    a) Open the IIS Management Tool from Administrative Tools
    b) Right click on the "Sites" node and select "Add Web Site"
    c) Put the Site Name there, then input a path to the folder where your unzipped and copied template files and Host name binding that you had assigned to your website. Click OK.

    d) Go to "Application Pools" node and select the pool that was just created with your website (it has the same name that you assigned to website).
    e) In the Application Pool options change .NET version to 4.0.XXX (Note you should have the .NET 4 installed on your server to use Sitefinity CMS)


    4. Setup website configuration
    a) Open the DataConfig.config located in your template directory under \App_Data\Sitefinity\Configuration.
    b) Modify the connection string, according to your new database:

    <add connectionString="data source=YOUR_SERVER_NAME;Integrated Security=false;initial catalog=YOUR_DATABASE_NAME;user id=YOUR_USER_ID;password=YOUR_PASSWORD;" providerName="System.Data.SqlClient" dbType="MsSql" name="Sitefinity" />

How to install widget

  • To install example follow instructions for Sitefinity Community License Siteinstallation

  • To install widget on your site:

    1. Build your SitefinityWebApp project:
    a) In root of your website open file SitefinityWebApp.csproj
    b) In Solution Explorer select "Show All Files"
    c) Right-click on folder "Widgets" and select "Include In Project"
    d) In Menu select Build->Build SitefinityWebApp

    2. Install the control in the Settings as follows:
    a) In the sitefinity back-end navigate Administration -> Settings ->Advanced
    b) choose Toolboxes -> Page Controls -> ContentToolboxSection
    c) Add a new widget of type "~/Widgets/YourControl/YourControlName.ascx"