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
- Add
<add name="VirtualFolder" virtualPath="~/" physicalPath="..\Images" vpp="false "/>
to the<plugins />
section. - 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?
- In Visual Studio, right click on your project and choose "Add reference". Browse to the plugin DLL and click "OK".
- In the <plugins> section of Web.config, insert <add name="PluginName" />
- Look at the plugin documentation to see what configuration options (if any) are available.