Select a site

IMPORTANT: This version of Sitefinity CMS is out of support and the respective product documentation is no longer maintained and can be outdated. Use the version selector to view a supported product version.

For developers: Add downloadable files to a product

To add a downloadable file to a product you must perform the following:

  1. Get instances of the following managers:
    • Libraries manager
      Note that you  must specify the manager to use the system libraries provider.
    • Catalog manager
    • Content links manager
  2. Get the document.
    Get an instance of the file that you want to add to the product. For more information, see For developers: Query documents.
  3. Get the product.
    Get an instance of the product that you want to add the file to. For more information, see For developers: Query products.
  4. Create a product file.
    Create an instance of the ProductFile class. This class wraps the information about the document and stores it in the product.
  5. Set the properties of the ProductFile instance.
    You must set the following properties:
    • Id
      Gets or sets the ID of the product file. You must set this property to the ID of the Document instance.
    • Title
      Gets or sets the title of the product file. You must set this property to the title of the Document instance.
    • FileSize
      Gets or sets the file size. You must set this property to the value for the TotalSize property of the Document instance.
    • FileName
      Gets or sets the name of the file. You must set this property to the value of the FilePath property of the Document instance.
    • UploadedDate
      Gets or sets the date when the product file has been uploaded. Set this property to the value of the DateCreated property of the Document instance.
    • Url
      Gets or sets the URL of the product file. Set this property to the value of the URL property of the Document instance.
  6. Add the product file.
    To add the product file instance to the product, use the Files collection property of the Product instance.
  7. Save the product.
    Save the changes to the catalog manager.
  8. Create a content link between the document and the product.
    To create a content link, call the CreateContentLink method of the ContentLinksManager instance. As componentPropertyName pass “ProductFile”, as parentDataItem pass the instance of the product, and as childDataItem pass the instance of the document.
  9. Save the content link.
    Save the changes to the content links manager.

Here is a code example:

public static void AddDownloadableFileToProduct(Guid productId, Guid documentId)
{
    string providerName = "SystemLibrariesProvider";
 
    CatalogManager catalogManager = CatalogManager.GetManager();
    LibrariesManager librariesManager = LibrariesManager.GetManager(providerName);
    ContentLinksManager contentLinksManager = ContentLinksManager.GetManager();
 
    Product product = catalogManager.GetProduct(productId);
 
    Document document = librariesManager.GetDocument(documentId);
 
    ProductFile file = new ProductFile();
    file.Id = document.Id;
    file.Title = document.Title;
    file.FileSize = document.TotalSize.ToString();
    file.FileName = document.FilePath;
    file.UploadedDate = document.DateCreated.ToString();
    file.Url = document.Url;
 
    product.Files.Add(file);
 
    catalogManager.SaveChanges();
 
    ContentLink contentLink = contentLinksManager.CreateContentLink("ProductFile", product, document);
 
    contentLinksManager.SaveChanges();
}

Back To Top

Next: For developers: Remove downloadable files from a product