Examples | Developer's Guide | ASP.NET Developer's Guide

1. Getting Started
2. Applying Stylesheet
3. Using Asset Manager Add-on
   1. Enabling the Asset Manager Add-on
   2. Multiple Asset Base/Root Folders
   3. Localization
   4. Returning Absolute Path
4. Advanced Settings
5. Extending the Editor
6. Toolbar
7. Localization
8. FAQ

III. Using Asset Manager Add-on

III.1. Enabling the Asset Manager Add-on

Included in the Editor is an Asset Manager add-on. Using the Asset Manager add-on, you can browse and manage your web assets (upload and delete files, create and delete folders). Asset Manager add-on is located in folder assetmanager. The main file is assetmanager.asp. To enable the Asset Manager add-on:

1. Copy the assetmanager folder anywhere in your web server.
2. specify AssetManager property with the location of the assetmanager.asp. Then, specify AssetManagerWidth and AssetManagerHeight properties with the dimension (width & height in pixels) of the dialog to open the Asset Manager page (assetmanager.asp).
   
   
   <editor:wysiwygeditor
   Runat="server"
   scriptPath="scripts/"
   AssetManager="/assetmanager/assetmanager.asp"
   AssetManagerWidth="600"
   AssetManagerHeight="445"
   Content="Hello World!"
   ID="oEdit1" />
   
   
   
   Important:
   Please use 'relative to root' path when specifying the location of the assetmanager.asp. 'Relative to root' path always starts with "/".
   
   
3. Specify your web assets location. Open settings.asp (in the assetmanager folder) using your text editor & set the arrBaseFolder variable with the location of your web assets folder (please use "relative to root" path). Then give a friendly name/caption using arrBaseName:
   
   
   arrBaseFolder(0)="/assets/"
   arrBaseName(0)="Assets"
   
   The above settings means that your web asset files are located in "http://yourserver/assets/" and the displayed name is "Assets". As a result, the folder selection dropdown in Asset Manager dialog page will display "Assets" and all sub folders within it:
   
   
   Important:
   Your web asset folder must have Write Permission.

If you enable the Asset Manager add-on, these dialogs will automatically show a Browse button :

• Hyperlink dialog
• Image dialog
• Insert Flash dialog
• Insert Media dialog
• Background Image dialog (opened from table and cell properties dialogs)

The Browse button will open the Asset Manager add-on dialog so that you can select a file which can be inserted as hyperlink or object (image, flash, video, etc).

III.2. Multiple Asset Base/Root Folders

Asset Manager add-on allows you to specify more than one base/root folder (up to 4). Here are example settings in seetings.asp :

arrBaseFolder(0)="/assets/"
arrBaseName(0)="Assets"

arrBaseFolder(1)="/public_assets/"
arrBaseName(1)="Public Assets"

III.3. Localization

If required, you can localize the Asset Manager add-on to be displayed in specific language by setting the lang variable in querystring:

<editor:wysiwygeditor
Runat="server"
scriptPath="scripts/"
AssetManager="/assetmanager/assetmanager.asp?lang=german"
AssetManagerWidth="600"
AssetManagerHeight="445"
ID="oEdit1" />

The current available values lang variable are: danish, dutch, finnish, french, german, schi (Chinese Simplified), tchi (Chinese Traditional), norwegian, spanish, swedish. If lang variable is not specified, English version will be displayed.

III.4. Returning Absolute Path

The Asset Manager dialog will return the selected file url in the form of 'relative to root' path, for example:

/assets/image.gif

If required, it can be changed to return absolute path by setting bReturnAbsolute variable in seetings.asp to true:

bReturnAbsolute=true

This will make the Asset Manager dialog returns:

http://yourservername/assets/image.gif

Inserting images using absolute path usually is required if you use the Editor in web-based email applications.