VirtualFolder plugin

Functions like an IIS virtual folder, but works within Visual Studio/Cassini web server.

IIS Virtual Folders perform better, however, so this plugin should only be used for testing, development, or as a last resort.

A virtual folder masking the root of the website can sometimes trigger perpetual restarts. To avoid this, set vpp="false" (will make the images/files only accessible when they have a querystring) or use a subfolder for the virtualPath value instead of "~/".

Installation

  1. Add <add name="VirtualFolder" virtualPath="~/" physicalPath="..\Images" vpp="false "/> to the <plugins /> section.
  2. You're done. If you want to add more virtual folders, repeat step 1.

Notes

  • VirtualPath can either be app-relative (~/folder) or domain-relative (/appfolder/folder).

  • PhysicalPath can be absolute (C:\folder\etc) or relative to the app physical path (..\Images).

This plugin (VirtualFolder plugin) is part of the Essential edition

Where is the plugins section?

The <plugins> section is located in Web.config, and is nested inside the <resizer> element, which is nested inside <configuration>. For examples, see this sample Web.config file.

Where can I find the dll?

We prefer that you install via NuGet, but you can also find the plugin DLL files in the /dlls/release folder of your download.

How do I typically install a plugin via Web.Config?

  1. In Visual Studio, right click on your project and choose "Add reference". Browse to the plugin DLL and click "OK".
  2. In the <plugins> section of Web.config, insert <add name="PluginName" />
  3. Look at the plugin documentation to see what configuration options (if any) are available.

How do I typically install a plugin via code?