Setting up the Template Path

To enable the template management function of the RichTextEditor control, you must set up a managed template folder.

This is simply a folder in which you will be placing templates for your users to use in their content. Create a folder in your application's root folder. The folder can be named something like "/uploads/", "/templates" or "/UserTemplate".

Make sure that the Internet Guest Account has Read+Write permissions on this folder and its contents.

How to specify the template path?

You can easily specify the template path using the following methods:

Edit security policy file

The security policy file (default.config, admin.config and guest.config) can be found in the richtexteditor/config folder. In security policy file you can find the following code which defines the template path information within RichTextEditor. By default, insert template dialog has the following settings:

<category for="Template"><!-- Insert Template Dialog -->  
       <security name="Extensions">*.txt,*.doc,*.pdf,*.zip,*.rar,*.htm,*.xls,*.html,*.rtf</security>
       <storage id="default>
              <security name="StoragePath">~/uploads</security>
              <security name="StorageName">Template Files</security><!-- storage display name -->
       </storage>
</category>

If you want to add new folders as template path, you need to create new storages and specify the storgae ID, name, path.

<category for="Template">
       <storage id="newtemplatepath>
              <security name="StorageName">New Template</security><!-- storage display name -->
              <security name="StoragePath">~/newtemplatepath</security>
       </storage>
       <storage id="newtemplatepath2>
              <security name="StorageName">New Template2</security><!-- storage display name -->
              <security name="StoragePath">~/newtemplatepath2</security>
       </storage>
</category>

Programmatically specify the template path

RichTextEditor provides a powerful method named Editor.SetSecurity that allows you programmatically manage the security settings.

1. Set template path using the default storage

$rte->SetSecurity("Template", "default", "StoragePath", "~/uploads"); 
$rte->SetSecurity("Template", "default", "StorageName", "Uploads");

This is equivalent to the following code:

<category for="Template"><!-- Template Dialog -->  
       <storage id="default>
              <security name="StoragePath">~/uploads</security>
              <security name="StorageName">Template Files</security><!-- storage display name -->
       </storage>
</category>

2. Create a new storage for insert template dialog and specify the ID, name and path

$rte->SetSecurity("Template", "newtemplatepath", "StoragePath", "~/newtemplatepath"); 
$rte->SetSecurity("Template", "newtemplatepath ", "StorageName", "New Template");

This is equivalent to the following code:

<category for="Template">
       <storage id="newtemplatepath>
              <security name="StorageName">New Template</security>
              <security name="StoragePath">~/newtemplatepath</security>
       </storage>
</category>

3. To programmatically disable a storage access, you can use the following method:

$rte->SetSecurity("Template", "newtemplatepath", "AllowAccess", "false"); 

In the above code, insert template dialog access to a storage is disabled. The storage ID in the above code is "newtemplatepath".