You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+39-15Lines changed: 39 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,56 +1,64 @@
1
1
# UmbracoFileSystemProviders.Azure v2
2
2
3
-
**This version is for Umbraco v8 only**. For the v1 package for **Umbraco v7** please visit the [main branch](https://github.com/JimBobSquarePants/UmbracoFileSystemProviders.Azure)
3
+
**This version is for Umbraco v8 only**. For the v1 package for **Umbraco v7** please visit the [main branch](https://github.com/umbraco-community/UmbracoFileSystemProviders.Azure)
An [Azure Blob Storage](http://azure.microsoft.com/en-gb/develop/net/) IFileSystem provider for [Umbraco](https://umbraco.com)
10
10
Used to offload static files in the media section to the cloud.
11
11
12
12
This package allows the storage and retrieval of media items using Azure Blob Storage while retaining the relative paths to the files expected in the back office.
13
13
14
-
**v2 requires Umbraco v8.0.1+**
14
+
**v2 requires Umbraco v8.1.0+**
15
15
16
16
## Installation
17
17
18
18
Both NuGet and Umbraco packages are available. If you use NuGet but would like the benefit of the Umbraco configuration wizard you can install the Umbraco package first, use the wizard, then install the NuGet package, the configuration will be maintained.
19
19
20
+
From **v2.0.0-alpha3** onwards this package was split into 2 NuGet packages and an additional one was added to support Umbraco Forms. When using NuGet install the `UmbracoFileSystemProviders.Azure.Media` package to swap Media storage to Blobs.
21
+
22
+
**If upgrading from v2.0.0-alpha1 or v2.0.0-alpha2 to v2.0.0-alpha3 you will need to install `UmbracoFileSystemProviders.Azure.Media`**
@@ -72,10 +80,10 @@ Additionally the provider can be further configured with the following applicati
72
80
</configuration>
73
81
```
74
82
75
-
## Virtual Path Provider
76
-
By default the plugin will serve files transparently from your domain or serve media directly from Azure. This is made possible by using a custom [Virtual Path Provider](https://msdn.microsoft.com/en-us/library/system.web.hosting.virtualpathprovider%28v=vs.110%29.aspx) included and automatically initialised upon application startup. This can be disable by adding the configuration setting noted above.
83
+
###Virtual Path Provider
84
+
By default the plugin will serve files transparently from your domain or serve media directly from Azure. This is made possible by using a custom [Virtual Path Provider](https://msdn.microsoft.com/en-us/library/system.web.hosting.virtualpathprovider%28v=vs.110%29.aspx) included and automatically initialised upon application startup. This can be disabled by adding the configuration setting noted above.
77
85
78
-
**Note:** Virtual Path Providers may affect performance/caching depending on your setup as the process differs from IIS's [unmanaged handler](http://www.paraesthesia.com/archive/2011/05/02/when-staticfilehandler-is-not-staticfilehandler.aspx/). Virtual files sent via the provider though are correctly cached in the browser so this shouldn't be an issue. VVP providers also **don't work** with **Precompiled sites** or when used in a **virtual directory/application**.
86
+
**Note:** Virtual Path Providers may affect performance/caching depending on your setup as the process differs from IIS's [unmanaged handler](http://www.paraesthesia.com/archive/2011/05/02/when-staticfilehandler-is-not-staticfilehandler.aspx/). Virtual files sent via the provider though are correctly cached in the browser so this shouldn't be an issue. VPP providers also **don't work** with **Precompiled sites** or when used in a **virtual directory/application**.
79
87
80
88
The following configuration is required in your `web.config` to enable static file mapping in IIS Express.
81
89
@@ -108,7 +116,7 @@ Also add this configuration to the `web.config` inside the `Media` folder
108
116
</configuration>
109
117
```
110
118
111
-
## Combining with ImageProcessor
119
+
###Combining with ImageProcessor
112
120
113
121
ImageProcessor.Web contains a [`IImageService`](http://imageprocessor.org/imageprocessor-web/extending/#iimageservice) called `CloudImageService`, to enable that service and pull images directly from
114
122
the cloud replace the `CloudImageService`setting with the following:
@@ -123,17 +131,33 @@ the cloud replace the `CloudImageService`setting with the following:
**Note** The `CloudImageService`is not compatible with the FileSystemProvider when using private storage. You will have to build your own `IImageService` implementation.
133
-
140
+
**Note** The `CloudImageService`is not compatible with the FileSystemProvider when using private storage. You can instead use the `AzureImageService` which is included with the [AzureBlobCache](http://imageprocessor.org/imageprocessor-web/plugins/azure-blob-cache/) package
134
141
135
142
Optionally install the [AzureBlobCache](http://imageprocessor.org/imageprocessor-web/plugins/azure-blob-cache/) plugin to get the most out of the package.
136
143
144
+
## Umbraco Forms
145
+
146
+
Currently this package is available only via NuGet
0 commit comments