CKSource Docs - User contributions [en]

CKFinder 2.x/Developers Guide/ASP/Troubleshooting/Windows Authentication

2011-12-06T21:41:00Z

AlfonsoML:

Note: there's still no version of CKFinder released with these changes, but I have to write the explanation somewhere :-)

If you want to use CKFinder for Asp in an environment with Windows Authentication and use Asp.Net to handle the images, then you might need to perform a little adjustment on your side.

== Overview ==

The Asp code of CKFinder calls an Asp.Net page on the same server, so if the server is using some authentication method, we must forward the credentials to this new request. This is done automatically by CKFinder when Basic authentication is used, but for Windows Authentication we must rely on the configuration of the server as explained by Microsoft. [http://support.microsoft.com/kb/314404/en-us How to forward the Kerberos authentication].

That's the idea, but surely you don't want to read too much, and you want something that works, ok, this [http://groups.google.com/group/microsoft.public.xml.msxml-webrelease/msg/cf30bb4d61cbf3fd post shows an easy way].

== Solution ==

First run '''proxycfg''' to see the current configuration, it should show that there is no proxy configured and no servers with direct access.

Now we want to add the domain to the list of direct access and that way the server will forward the authentication credentials, run this command: 
'''proxycfg -d -p " " "*.domain.com" ''' 
(note that after the -p the first parameter is a quoted space and the second one your domain name).

After this step the wizard should be able to pass this test correctly.

CKFinder 2.x/Developers Guide/ASP/Troubleshooting

2011-12-06T21:28:20Z

AlfonsoML:

If you are unable to quickly setup CKFinder for Asp you can use a [http://cksource.com/forums/viewtopic.php?f=10&t=13604 wizard script] as explained in the forums. That script should be able to tell you exactly the steps to follow in your configuration or your server and get CKFinder working in just a matter of minutes.

The script might point you to this pages in order to get extended info about some common problems, this is a list of articles aimed to help you fix any problem while setting up your installation of CKFinder

*[[CKFinder_2.x/Developers Guide/ASP/Troubleshooting/ParentPath|Error "ASP 0131", not being able to use relative paths]]
*[[CKFinder_2.x/Developers Guide/ASP/Troubleshooting/UploadSize|Adjusting maximum upload size]]
*[[CKFinder_2.x/Developers Guide/ASP/Troubleshooting/Windows_Authentication|Using CKFinder with Windows Authentication]]

CKFinder 2.x/Developers Guide/ASP/Troubleshooting/Windows Authentication

2011-12-06T21:27:54Z

AlfonsoML: moved CKFinder 2.x/Developers Guide/ASP/Troubleshooting/WindowsAuthentication to CKFinder 2.x/Developers Guide/ASP/Troubleshooting/Windows Authentication

Note: there's still no version of CKFinder released with these changes, but I have to write the explanation somewhere :-)

If you want to use CKFinder for Asp in an environment with Windows Authentication and use Asp.Net to handle the images, then you might need to perform a little adjustment on your side.

Overview:
The Asp code of CKFinder calls an Asp.Net page on the same server, so if the server is using some authentication method, we must forward the credentials to this new request. This is done automatically by CKFinder when Basic authentication is needed, but for Windows Authentication we must rely on the configuration of the server as explained by Microsoft. [http://support.microsoft.com/kb/314404/en-us How to forward the Kerberos authentication].

That's the idea, but surely you don't want to read too much, and you want something that works, ok, this [http://groups.google.com/group/microsoft.public.xml.msxml-webrelease/msg/cf30bb4d61cbf3fd post shows an easy way].
If you just login to your server and run
{{{proxycfg -d -p " " "*" }}}
then the wizard should be able to run correctly.

CKFinder 2.x/Developers Guide/ASP/Troubleshooting/WindowsAuthentication

2011-12-06T21:27:54Z

AlfonsoML: moved CKFinder 2.x/Developers Guide/ASP/Troubleshooting/WindowsAuthentication to CKFinder 2.x/Developers Guide/ASP/Troubleshooting/Windows Authentication

#REDIRECT [[CKFinder 2.x/Developers Guide/ASP/Troubleshooting/Windows Authentication]]

CKFinder 2.x/Developers Guide/ASP/Troubleshooting/Windows Authentication

2011-12-06T21:26:20Z

AlfonsoML: Created page with 'Note: there's still no version of CKFinder released with these changes, but I have to write the explanation somewhere :-) If you want to use CKFinder for Asp in an environment w…'

Note: there's still no version of CKFinder released with these changes, but I have to write the explanation somewhere :-)

If you want to use CKFinder for Asp in an environment with Windows Authentication and use Asp.Net to handle the images, then you might need to perform a little adjustment on your side.

Overview:
The Asp code of CKFinder calls an Asp.Net page on the same server, so if the server is using some authentication method, we must forward the credentials to this new request. This is done automatically by CKFinder when Basic authentication is needed, but for Windows Authentication we must rely on the configuration of the server as explained by Microsoft. [http://support.microsoft.com/kb/314404/en-us How to forward the Kerberos authentication].

That's the idea, but surely you don't want to read too much, and you want something that works, ok, this [http://groups.google.com/group/microsoft.public.xml.msxml-webrelease/msg/cf30bb4d61cbf3fd post shows an easy way].
If you just login to your server and run
{{{proxycfg -d -p " " "*" }}}
then the wizard should be able to run correctly.

CKFinder 2.x/Developers Guide/ASP/Troubleshooting

2011-12-06T21:13:32Z

AlfonsoML:

If you are unable to quickly setup CKFinder for Asp you can use a [http://cksource.com/forums/viewtopic.php?f=10&t=13604 wizard script] as explained in the forums. That script should be able to tell you exactly the steps to follow in your configuration or your server and get CKFinder working in just a matter of minutes.

The script might point you to this pages in order to get extended info about some common problems, this is a list of articles aimed to help you fix any problem while setting up your installation of CKFinder

*[[CKFinder_2.x/Developers Guide/ASP/Troubleshooting/ParentPath|Error "ASP 0131", not being able to use relative paths]]
*[[CKFinder_2.x/Developers Guide/ASP/Troubleshooting/UploadSize|Adjusting maximum upload size]]
*[[CKFinder_2.x/Developers Guide/ASP/Troubleshooting/WindowsAuthentication|Using CKFinder with Windows Authentication]]

CKEditor 3.x/Developers Guide

2010-04-04T16:40:20Z

AlfonsoML: Added link to dialog customization

{{#CUSTOMTITLE:CKEditor 3.x - Developer's Guide}}

*[[CKEditor 3.x/Developers Guide/Installation|Installation]]
* Integration
**[[CKEditor 3.x/Developers Guide/Integration|Integration]]
** [[CKEditor 3.x/Developers Guide/jQuery Adapter|jQuery]]
*Configuration
**[[CKEditor 3.x/Developers Guide/Setting Configurations|Setting Configurations]]
**[[CKEditor 3.x/Developers Guide/Toolbar|Toolbar]]
**[[CKEditor_3.x/Developers_Guide/Styles|Styles]]
**[[CKEditor 3.x/Developers Guide/Output Formatting|Output Formatting]]
**[[CKEditor 3.x/Developers Guide/Templates|Templates]]
**Spell Checker
**[[CKEditor 3.x/Developers Guide/File Browser (Uploader)|File Browser/Uploader ]]
*Customization
**[[CKEditor 3.x/Developers Guide/Dialog_Customization|Dialogs]]
**Plugins
**Skins
*Advanced Tasks
**[[CKEditor_3.x/Developers_Guide/Editor_Core_URLs_Manipulation|Editor Core URLs Manipulation]]
*Deployment
*[http://docs.cksource.com/ckeditor_api/ JavaScript API]
*[[FCKeditor 3.x/Design and Architecture|Design and Architecture]]

CKEditor 3.x/Developers Guide/Dialog Customization

2010-04-04T16:38:28Z

AlfonsoML: Provide sample of porting FCKeditor options

The architecture in CKEditor allows for very flexible customization of the contents of the dialogs without any need to change the source files.

In order to see some examples, please, take a look at the _samples/api_dialog.html file of the distribution.

This is another example, showing how to use some the options that existed in FCKeditor:

<source lang="javascript">
CKEDITOR.on( 'dialogDefinition', function( ev )
{
// Take the dialog name and its definition from the event data.
var dialogName = ev.data.name;
var dialogDefinition = ev.data.definition;

// Check if the definition is from the dialog we're
// interested on (the Link dialog).
if ( dialogName == 'link' )
{
// FCKConfig.LinkDlgHideAdvanced = true
dialogDefinition.removeContents( 'advanced' );

// FCKConfig.LinkDlgHideTarget = true
dialogDefinition.removeContents( 'target' );
/*
Enable this part only if you don't remove the 'target' tab in the previous block.

// FCKConfig.DefaultLinkTarget = '_blank'
// Get a reference to the "Target" tab.
var targetTab = dialogDefinition.getContents( 'target' );
// Set the default value for the URL field.
var targetField = targetTab.get( 'linkTargetType' );
targetField[ 'default' ] = '_blank';
*/
}

if ( dialogName == 'image' )
{
// FCKConfig.ImageDlgHideAdvanced = true
dialogDefinition.removeContents( 'advanced' );
// FCKConfig.ImageDlgHideLink = true
dialogDefinition.removeContents( 'Link' );
}

if ( dialogName == 'flash' )
{
// FCKConfig.FlashDlgHideAdvanced = true
dialogDefinition.removeContents( 'advanced' );
}

});
</source>
By listening to the dialogDefinition event of CKEditor it's possible to customize the dialogs removing tabs or changing the default values.

FCKeditor 3.x/Design and Architecture/Memory Leak

2010-03-07T19:17:09Z

AlfonsoML: /* Garbage collection */

(Draft)

Web browser applications are quite sensible to memory leak. Actually, there is a set of well known coding patterns that cause leak. V3 will provide several features to avoid matching such patterns.

== DOM Abstraction ==

Our API provides a [[FCKeditor 3.x/Design and Architecture/DOM Abstraction|DOM abstraction]] set of classes to manage DOM objects. Memory leak free is the most important benefit of it.

It means that we are able to use the API in any situation, including within well known leakage patterns, and we'll be sure that no leak will happen. The DOM abstraction classes will be the only point of the code dealing with DOM elements, so we can concentrate all our leak free efforts in this set of classes only.

== No Cross References (DOM x JS) ==

The most relevant leak patterns are related to cross references set between DOM objects and JavaScript objects. There are several ways to achieve it, but the result is that you end up with a JavaScript object that has a property pointing to a DOM element that has a property pointing back to the same JavaScript object (even indirectly).

The solution implemented by the DOM Abstraction classes is that we have references in one direction only: JavaScript objects that point to DOM elements. The opposite will never happen.

== Expandos Handling ==

To avoid having references to JavaScript objects inside DOM objects, we should avoid setting the so called '''expando''' properties, thus JavaScript properties not native to the DOM.

But, at the same time, expandos are quite useful, as they can be used to append further information, or back references in the DOM element itself, so those properties can be used later in the code execution.

To have the expandos flexibility, avoiding leakage, we'll provide a specific function to set and get expando properties. Internally, this function will simply set an integer key in a single expando property in the DOM object. That key can be used to retrieve an item from an internal array, which contains all expandos set to that DOM object. So, in the DOM object, we'll have this one and only expando containing an integer value, which doesn’t happen to cause leaks.

== Garbage collection ==

Besides those techniques to avoid the common patterns for memory leaks there are other possible problems. For example, using the editor in an AJAX way means creating and destroying instances without reloading the page, and as long as we keep a reference to some object or function in a 'global' object it can't be cleared by the browser.

One example of such pattern is the CKEDITOR.tools.addFunction function: it takes as the parameter a function and it will store it in a private array, including the scope. If we don't remove that reference with CKEDITOR.tools.removeFunction after it's no longer needed, for example using the 'destroy' event of the editor instance, that function and its scope (including variables in a closure) will remain in memory forever because the browser can't call its garbage collector on it.

We must be careful also about adding listeners to the CKEDITOR object because that object will remain live all the time along the page, so the plugins shouldn't add listeners using the initialization methods (beforeInit, init and afterInit) but just at the main scope so it runs only once when the file is loaded. If we have to add a listener inside the plugin code then we must remove that listener when the editor instance is destroyed.

The last pattern is using event listeners or using setCustomData to DOM objects, in those cases we must call clearCustomData() on that object if we want to avoid any leaks.

The [http://dev.fckeditor.net/ticket/4555 ticket 4555] includes some extra info about how to check for increased usage of memory and the patch to clear the known issues related to creating/destroying an editor in a loop.

FCKeditor 3.x/Design and Architecture/Memory Leak

2010-03-07T19:14:24Z

AlfonsoML: Explanation about potential increase of memory

(Draft)

Web browser applications are quite sensible to memory leak. Actually, there is a set of well known coding patterns that cause leak. V3 will provide several features to avoid matching such patterns.

== DOM Abstraction ==

Our API provides a [[FCKeditor 3.x/Design and Architecture/DOM Abstraction|DOM abstraction]] set of classes to manage DOM objects. Memory leak free is the most important benefit of it.

It means that we are able to use the API in any situation, including within well known leakage patterns, and we'll be sure that no leak will happen. The DOM abstraction classes will be the only point of the code dealing with DOM elements, so we can concentrate all our leak free efforts in this set of classes only.

== No Cross References (DOM x JS) ==

The most relevant leak patterns are related to cross references set between DOM objects and JavaScript objects. There are several ways to achieve it, but the result is that you end up with a JavaScript object that has a property pointing to a DOM element that has a property pointing back to the same JavaScript object (even indirectly).

The solution implemented by the DOM Abstraction classes is that we have references in one direction only: JavaScript objects that point to DOM elements. The opposite will never happen.

== Expandos Handling ==

To avoid having references to JavaScript objects inside DOM objects, we should avoid setting the so called '''expando''' properties, thus JavaScript properties not native to the DOM.

But, at the same time, expandos are quite useful, as they can be used to append further information, or back references in the DOM element itself, so those properties can be used later in the code execution.

To have the expandos flexibility, avoiding leakage, we'll provide a specific function to set and get expando properties. Internally, this function will simply set an integer key in a single expando property in the DOM object. That key can be used to retrieve an item from an internal array, which contains all expandos set to that DOM object. So, in the DOM object, we'll have this one and only expando containing an integer value, which doesn’t happen to cause leaks.

== Garbage collection ==

Besides those techniques to avoid the common patterns for memory leaks there are other possible problems. For example, using the editor in an AJAX way means creating and destroying instances without reloading the page, and as long as we keep a reference to some object or function in a 'global' object it can't be cleared by the browser.

One example of such pattern is the CKEDITOR.tools.addFunction function: it takes as the parameter a function and it will store it in a private array, including the. If we don't remove that reference with CKEDITOR.tools.removeFunction after it's no longer needed, for example using the 'destroy' event of the editor instance.

We must be careful also about adding listeners to the CKEDITOR object because that object will remain live all the time along the page, so the plugins shouldn't add listeners using the initialization methods (beforeInit, init and afterInit) but just at the main scope so it runs only once when the file is loaded. If we have to add a listener inside the plugin code then we must remove that listener when the editor instance is destroyed.

The last pattern is using event listeners or using setCustomData to DOM objects, in those cases we must call clearCustomData() on that object if we want to avoid any leaks.

The [http://dev.fckeditor.net/ticket/4555 ticket 4555] includes some extra info about how to check for increased usage of memory and the patch to clear the known issues related to creating/destroying an editor in a loop.

CKEditor 3.x/Developers Guide/Styles

2010-02-13T19:10:34Z

AlfonsoML: Undo revision 2844 by AlfonsoML (Talk)

The "stylescombo" plugin adds a nice selection box to the toolbar, with which it's easy to apply customized styles and semantics value to the content.

The entries available in the style combo list can be easily customized to match your web site needs. For that, you must work on your styles definition, which is a simple JavaScript array containing the rules to be used for each style.

== The Styles Definition ==

The styles definition is a JavaScript array which is registered by calling the CKEDITOR.addStylesSet() function. A unique name must be assigned to your style definition, so you can later set each editor instance to load it. It means that you can have a single style definition which is shared by several editor instances present on the page.

The following is a sample style definition registration:

<pre>
CKEDITOR.addStylesSet( 'my_styles',
[
// Block Styles
{ name : 'Blue Title', element : 'h2', styles : { 'color' : 'Blue' } },
{ name : 'Red Title' , element : 'h3', styles : { 'color' : 'Red' } },

// Inline Styles
{ name : 'CSS Style', element : 'span', attributes : { 'class' : 'my_style' } },
{ name : 'Marker: Yellow', element : 'span', styles : { 'background-color' : 'Yellow' } }
]);
</pre>

The above definition registration can be placed inline in the page using the editor, or can even live in an external file, which is loaded "on demand", when needed only (see below).

After that, you must instruct the editor to use your newly registered style definition by using the stylesCombo_stylesSet setting. This may be set into the config.js file, for example:

<pre>
config.stylesCombo_stylesSet = 'my_styles';
</pre>

=== Using an External Styles Definition File ===

You can include the above styles definition registration call into an external JavaScript file. This is the preferred way for it because it will be loaded only when opening the Styles selection box, enhancing the page loading performance. Users may feel a small loading gap because of it though.

By default, the editor uses the "plugins/stylescombo/styles/default.js" file, which is a "minified" JavaScript file. You can find the uncompressed version of it at "_source/plugins/stylescombo/styles/default.js". You can see it online at our SVN also: http://svn.fckeditor.net/CKEditor/trunk/_source/plugins/stylescombo/styles/default.js. It can be used as a template for your custom file.

Your style definition file can be saved anywhere at your web site (or the web). You must just know the URL to reach it. For example, you can save at it at the root of your web site, so you can reach it with "/styles.js", or even place it in a central web site, so you can locate it with "http://www.example.com/styles.js". At that point, simply change the stylesCombo_stylesSet setting to point the editor to your file:

<pre>
config.stylesCombo_stylesSet = 'my_styles:/styles.js';

OR

config.stylesCombo_stylesSet = 'my_styles:http://www.example.com/styles.js';
</pre>

The above setting syntax is "style definition name" + ":" + "file URL". Note that you must still use the unique name you have used to register the style definition into the file.

== Style Rules ==

The entries inside a style definition are called "style rules". Each rule defines the display name for a single style as well as the element, attributes and css styles to be used for it. The following is the generic representation for it:
<pre>{
name : 'Display name',
element : 'tag name (for example "span")',
styles :
{
'css-style1' : 'desired value',
'css-style2' : 'desired value',
...
}
attributes :
{
'attribute-name1' : 'desired value',
'attribute-name2' : 'desired value',
...
}
}
</pre>
The "name" and "element" values are required, while other values are optional.

== Style Types ==

There are three types of style types, each one related to the element used in the style rule:

*'''Block styles''': applied to the text blocks (paragraphs) as a whole, not limited to the text selection. The elements values for that are: address, div, h1, h2, h3, h4, h5, h6, p and pre.
*'''Object styles''': applied to special selectable objects (not textual), whenever such selection is supported by the browser. The elements values for that are: a, embed, hr, img, li, object, ol, table, td, tr and ul.
*'''Inline styles''': applied to text selections for style rules using elements not defined in the other style types.

CKEditor 3.x/Developers Guide/Styles

2010-02-13T18:35:33Z

AlfonsoML: Update information of CKEDITOR.stylesSet.add for CKEditor 3.2

The "stylescombo" plugin adds a nice selection box to the toolbar, with which it's easy to apply customized styles and semantics value to the content.

The entries available in the style combo list can be easily customized to match your web site needs. For that, you must work on your styles definition, which is a simple JavaScript array containing the rules to be used for each style.

== The Styles Definition ==

The styles definition is a JavaScript array which is registered by calling the CKEDITOR.stylesSet.add() function (see note below for CKEditor<3.2). A unique name must be assigned to your style definition, so you can later set each editor instance to load it. It means that you can have a single style definition which is shared by several editor instances present on the page.

The following is a sample style definition registration:

<pre>
CKEDITOR.stylesSet.add( 'my_styles',
[
// Block Styles
{ name : 'Blue Title', element : 'h2', styles : { 'color' : 'Blue' } },
{ name : 'Red Title' , element : 'h3', styles : { 'color' : 'Red' } },

// Inline Styles
{ name : 'CSS Style', element : 'span', attributes : { 'class' : 'my_style' } },
{ name : 'Marker: Yellow', element : 'span', styles : { 'background-color' : 'Yellow' } }
]);
</pre>

'''Note:''' Up to CKEditor 3.2 the call must be done using CKEDITOR.addStylesSet instead of CKEDITOR.stylesSet.add

The above definition registration can be placed inline in the page using the editor, or can even live in an external file, which is loaded "on demand", when needed only (see below).

After that, you must instruct the editor to use your newly registered style definition by using the stylesCombo_stylesSet setting. This may be set into the config.js file, for example:

<pre>
config.stylesCombo_stylesSet = 'my_styles';
</pre>

=== Using an External Styles Definition File ===

You can include the above styles definition registration call into an external JavaScript file. This is the preferred way for it because it will be loaded only when opening the Styles selection box, enhancing the page loading performance. Users may feel a small loading gap because of it though.

By default, the editor uses the "plugins/stylescombo/styles/default.js" file, which is a "minified" JavaScript file. You can find the uncompressed version of it at "_source/plugins/stylescombo/styles/default.js". You can see it online at our SVN also: http://svn.fckeditor.net/CKEditor/trunk/_source/plugins/stylescombo/styles/default.js. It can be used as a template for your custom file.

Your style definition file can be saved anywhere at your web site (or the web). You must just know the URL to reach it. For example, you can save at it at the root of your web site, so you can reach it with "/styles.js", or even place it in a central web site, so you can locate it with "http://www.example.com/styles.js". At that point, simply change the stylesCombo_stylesSet setting to point the editor to your file:

<pre>
config.stylesCombo_stylesSet = 'my_styles:/styles.js';

OR

config.stylesCombo_stylesSet = 'my_styles:http://www.example.com/styles.js';
</pre>

The above setting syntax is "style definition name" + ":" + "file URL". Note that you must still use the unique name you have used to register the style definition into the file.

== Style Rules ==

The entries inside a style definition are called "style rules". Each rule defines the display name for a single style as well as the element, attributes and css styles to be used for it. The following is the generic representation for it:
<pre>{
name : 'Display name',
element : 'tag name (for example "span")',
styles :
{
'css-style1' : 'desired value',
'css-style2' : 'desired value',
...
}
attributes :
{
'attribute-name1' : 'desired value',
'attribute-name2' : 'desired value',
...
}
}
</pre>
The "name" and "element" values are required, while other values are optional.

== Style Types ==

There are three types of style types, each one related to the element used in the style rule:

*'''Block styles''': applied to the text blocks (paragraphs) as a whole, not limited to the text selection. The elements values for that are: address, div, h1, h2, h3, h4, h5, h6, p and pre.
*'''Object styles''': applied to special selectable objects (not textual), whenever such selection is supported by the browser. The elements values for that are: a, embed, hr, img, li, object, ol, table, td, tr and ul.
*'''Inline styles''': applied to text selections for style rules using elements not defined in the other style types.

CKEditor 3.x/Developers Guide/Templates

2010-01-12T09:45:14Z

AlfonsoML: fixed typo

With CKEditor, content writers can select a template from a list by clicking the "Templates" button in the toolbar. A template is a predefined piece of HTML that is placed inside the editor. In this way the user doesn't need to start writing from scratch. Designers can prepare well designed templates, avoiding user errors before they happen.

=== Template Definition Files ===

The editor comes with three sample templates that are there just to show the way it works. They are defined into the "plugins/templates/templates/default.js" file.

Developers should definitely change the default templates as they are not especially useful to end users.

Note that a template definition file is a JavaScript file that's loaded when opening the templates dialog for the first time. This file may be changed to include custom templates, or even better, you can create a separated template file outside the editor installation directory, configuring the editor to use it.

=== Pointing the Editor to a Custom Templates Definitions File ===

Assuming you have created a custom Templates Definitions file named "mytemplates.js" (starting from a copy of default.js) and have placed it into the root of your web site. Now, just add the following setting in the editor configuration:

<pre>
config.templates_files = [ '/mytemplates.js' ];
</pre>

Note that the [http://docs.cksource.com/ckeditor_api/symbols/CKEDITOR.config.html#.templates_files templates_files] setting is an array, which means that more than one templates file can be used.

=== The Templates Definitions File Contents ===

This is a sample Template Definition file that defines two simple templates:

<pre>
// Register a templates definition set named "default".
CKEDITOR.addTemplates( 'default',
{
// The name of sub folder which hold the shortcut preview images of the templates.
imagesPath : CKEDITOR.getUrl( CKEDITOR.plugins.getPath( 'templates' ) + 'templates/images/' ),

// The templates definitions.
templates :
[
{
title: 'My Template 1',
image: 'template1.gif',
description: 'Description of my template 1.',
html:
'<h2>Template 1</h2>' +
'<img src="/logo.png" style="float:left" />Type the text here.'
},
{
title: 'My Template 2',
html:
'<h3>Template 2</h3>' +
'Type the text here.'
}
]
});
</pre>

As we can see here, the above is pure JavaScript code. It's a simple call to the [http://docs.cksource.com/ckeditor_api/symbols/CKEDITOR.html#.addTemplates CKEDITOR.addTemplates] function, which registers the templates under a unique name ("default"). This name can be then used by the [http://docs.cksource.com/ckeditor_api/symbols/CKEDITOR.config.html#.templates templates] setting.

CKFinder 1.x/Developers Guide/ASP/Troubleshooting

2009-04-10T20:08:24Z

AlfonsoML: added info about the wizard

If you are unable to quickly setup CKFinder for Asp you can use a [http://www.fckeditor.net/forums/viewtopic.php?f=10&t=13604 wizard script] as explained in the forums. That script should be able to tell you exactly the steps to follow in your configuration or your server and get CKFinder working in just a matter of minutes.

The script might point you to this pages in order to get extended info about some common problems, this is a list of articles aimed to help you fix any problem while setting up your installation of CKFinder

*[[CKFinder/Developers Guide/ASP/Troubleshooting/ParentPath|Error "ASP 0131", not being able to use relative paths]]
*[[CKFinder/Developers Guide/ASP/Troubleshooting/UploadSize|Adjusting maximum upload size]]

CKFinder 1.x/Developers Guide/ASP/Configuration/Images/Scaling

2009-02-09T20:45:38Z

AlfonsoML: updated asp components

{{Ckfinder scaling description}}
<pre>Set Images = server.CreateObject("Scripting.Dictionary")
Images.Add "maxWidth", 1200
Images.Add "maxHeight", 1200
Images.Add "quality", 80
Images.Add "component", "Auto"
</pre>
The component entry indicates the method that should be used to handle images and thumbnails. These are the possible values: 

*"Asp.Net", it should work with Asp.Net 1.1 and 2.0 without any extra software 
*"Persits.Jpeg" Commercial component from Persits 
*"briz.AspThumb" Commercial component from BRIZ Software
*"AspImage.Image" Commercial component from ServerObjects. The available demo it's expired and doesn't seems to handle gifs properly 
*"shotgraph.image", Commercial component from ShotGraph. The demo version doesn't allow resizing 
*"Auto": It will try to autodetect which one is available, in the order described above. It's the default value, but for better performance you should state the component that you are going to use. 
*"None": Image manipulation (thumbnails, maximum dimensions, validation) won't be available.

EMailProtection

2008-11-01T17:28:00Z

AlfonsoML: New page: The EMailProtection and EMailProtectionFunction configuration options have been added in the 2.6.3 beta options. They provide the ability to use some javascript in order to avoid bot...

The EMailProtection and EMailProtectionFunction configuration options have been added in the 2.6.3 beta options. 

They provide the ability to use some javascript in order to avoid bots that crawls the web pages to get email addresses. 

Further info available in the bug report: http://dev.fckeditor.net/ticket/2220

FCKeditor 2.x/Developers Guide/Configuration/Configuration Options

2008-11-01T17:24:41Z

AlfonsoML:

== Editor Behavior ==

*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/AutoDetectPasteFromWord|AutoDetectPasteFromWord]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/BaseHref|BaseHref]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/CleanWordKeepsStructure|CleanWordKeepsStructure]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ContentLangDirection|ContentLangDirection]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/DefaultLinkTarget|DefaultLinkTarget]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/DocType|DocType]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ForcePasteAsPlainText|ForcePasteAsPlainText]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FullPage|FullPage]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/LinkDlgHideTarget|LinkDlgHideTarget]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/MaxUndoLevels|MaxUndoLevels]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/StartupFocus|StartupFocus]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/StartupShowBlocks|StartupShowBlocks]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/TemplateReplaceAll|TemplateReplaceAll]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/TemplateReplaceCheckbox|TemplateReplaceCheckbox]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ToolbarComboPreviewCSS|ToolbarComboPreviewCSS]]

== Styles ==

*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/BodyId and BodyClass|BodyId and BodyClass]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/CoreStyles|CoreStyles]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/CustomStyles|CustomStyles]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/EditorAreaCSS|EditorAreaCSS]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/EditorAreaStyles|EditorAreaStyles]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FontColors|FontColors]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FontFormats|FontFormats]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FontNames|FontNames]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FontSizes|FontSizes]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/IndentClasses|IndentClasses]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/IndentLength|IndentLength]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/IndentUnit|IndentUnit]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/JustifyClasses|JustifyClasses]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/RemoveFormatTags|RemoveFormatTags]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/StylesXmlPath|StylesXmlPath]]

== HTML Output ==

*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/AdditionalNumericEntities|AdditionalNumericEntities]]
*[[EMailProtection|EMailProtection and EMailProtectionFunction]] 
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/EnterMode|EnterMode]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FillEmptyBlocks|FillEmptyBlocks]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ForceSimpleAmpersand|ForceSimpleAmpersand]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FormatIndentator|FormatIndentator]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FormatOutput|FormatOutput]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FormatSource|FormatSource]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/HtmlEncodeOutput|HtmlEncodeOutput]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/IgnoreEmptyParagraphValue|IgnoreEmptyParagraphValue]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/IncludeGreekEntities|IncludeGreekEntities]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/IncludeLatinEntities|IncludeLatinEntities]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ProcessHTMLEntities|ProcessHTMLEntities]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ProcessNumericEntities|ProcessNumericEntities]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ShiftEnterMode|ShiftEnterMode]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/TabSpaces|TabSpaces]]

== User Interface ==

*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/AutoDetectLanguage|AutoDetectLanguage]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ContextMenu|ContextMenu]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/DefaultFontFormatLabel|DefaultFontFormatLabel]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/DefaultFontSizeLabel|DefaultFontSizeLabel]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/DefaultFontLabel|DefaultFontLabel]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/DefaultLanguage|DefaultLanguage]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/DefaultStyleLabel|DefaultStyleLabel]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/DisableFFTableHandles|DisableFFTableHandles]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/DisableObjectResizing|DisableObjectResizing]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/EnableMoreFontColors|EnableMoreFontColors]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FlashDlgHideAdvanced|FlashDlgHideAdvanced]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FloatingPanelsZIndex|FloatingPanelsZIndex]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ImageDlgHideLink|ImageDlgHideLink]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ImageDlgHideAdvanced|ImageDlgHideAdvanced]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/Keystrokes|Keystrokes]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/LinkDlgHideAdvanced|LinkDlgHideAdvanced]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ShowBorders|ShowBorders]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ShowDropDialog|ShowDropDialog]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/SkinPath|SkinPath]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/SourcePopup|SourcePopup]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/SmileyColumns|SmileyColumns]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/SmileyWindowHeight|SmileyWindowHeight]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/SmileyWindowWidth|SmileyWindowWidth]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ToolbarCanCollapse|ToolbarCanCollapse]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ToolbarStartExpanded|ToolbarStartExpanded]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ToolbarLocation|ToolbarLocation]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ToolbarSets|ToolbarSets]]

== Advanced ==

*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/AllowQueryStringDebug|AllowQueryStringDebug]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/BrowserContextMenuOnCtrl|BrowserContextMenuOnCtrl]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/CustomConfigurationsPath|CustomConfigurationsPath]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/Debug|Debug]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FirefoxSpellChecker|FirefoxSpellChecker]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/IeSpellDownloadUrl|IeSpellDownloadUrl]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/PluginsPath|PluginsPath]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/Plugins.Add|Plugins.Add]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/PreloadImages|PreloadImages]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/PreserveSessionOnFileBrowser|PreserveSessionOnFileBrowser]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ProtectedSource.Add|ProtectedSource.Add]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ProtectedTags|ProtectedTags]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/SmileyPath|SmileyPath]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/SmileyImages|SmileyImages]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/SpellChecker|SpellChecker]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/SpellerPagesServerScript|SpellerPagesServerScript]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/TemplatesXmlPath|TemplatesXmlPath]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/MsWebBrowserControlCompat|MsWebBrowserControlCompat]]

== File Browser and Uploader ==

*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/LinkBrowser|LinkBrowser]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/LinkBrowserURL|LinkBrowserURL]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/LinkBrowserWindowWidth|LinkBrowserWindowWidth]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/LinkBrowserWindowHeight|LinkBrowserWindowHeight]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ImageBrowser|ImageBrowser]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ImageBrowserURL|ImageBrowserURL]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ImageBrowserWindowWidth|ImageBrowserWindowWidth]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ImageBrowserWindowHeight|ImageBrowserWindowHeight]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FlashBrowser|FlashBrowser]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FlashBrowserURL|FlashBrowserURL]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FlashBrowserWindowWidth|FlashBrowserWindowWidth]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FlashBrowserWindowHeight|FlashBrowserWindowHeight]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/LinkUpload|LinkUpload]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/LinkUploadURL|LinkUploadURL]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/LinkUploadAllowedExtensions|LinkUploadAllowedExtensions]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/LinkUploadDeniedExtensions|LinkUploadDeniedExtensions]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ImageUpload|ImageUpload]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ImageUploadURL|ImageUploadURL]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ImageUploadAllowedExtensions|ImageUploadAllowedExtensions]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/ImageUploadDeniedExtensions|ImageUploadDeniedExtensions]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FlashUpload|FlashUpload]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FlashUploadURL|FlashUploadURL]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FlashUploadAllowedExtensions|FlashUploadAllowedExtensions]]
*[[FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/FlashUploadDeniedExtensions|FlashUploadDeniedExtensions]]

CKFinder 1.x/Developers Guide/ASP/Troubleshooting/UploadSize

2008-08-24T15:43:52Z

AlfonsoML: New page: The maximum upload size can be adjusted for each resource type in its configuration, ...

The maximum upload size can be adjusted for each resource type in its [[CKFinder/Developers_Guide/ASP/Configuration/Resource_Types/Built-in#Changing_the_default_resources|configuration]], but sometimes you might want to upload a file and the process will fail. This is usually due to the maximum size allowed for an Asp request in the server configuration.

In order to fix it, if you don't have direct access to the server you should ask your hosting provider to increase this limit for you. If you have full control on the server, then you can follow the steps outlined in this [http://support.microsoft.com/kb/327659 MS KB article] or follow this other [http://www.banmanpro.com/support2/File_Upload_limits.asp visual guide].

CKFinder 1.x/Developers Guide/ASP/Troubleshooting/ParentPath

2008-08-24T15:36:08Z

AlfonsoML: New page: In some IIS 6 instalations you might receive an error 'ASP 0131'. That's due to a [http://support.microsoft.com/?scid=kb%3Ben-us%3B226474 security setting in IIS] that doesn't allow to ...

In some IIS 6 instalations you might receive an error 'ASP 0131'. That's due to a [http://support.microsoft.com/?scid=kb%3Ben-us%3B226474 security setting in IIS] that doesn't allow to use a relative paths in include files.

There are two solutions for this problem.

#Using the Administrative tools you can change the setting as explained in [http://support.microsoft.com/?scid=kb%3Ben-us%3B332117 MS KB Q332117]
#If you don't have access or don't want to change that, then open the ckfinder/core/connector/asp/connector.asp file, go to line 51 (it might change in newer versions) and change 
<pre><! -- #INCLUDE file="../../../config.asp" -->
</pre>
with 
<pre><! -- #INCLUDE VIRTUAL="/ckfinder/config.asp" --></pre>
Please, note that if you have placed ckfinder under a different root folder you'll need to adjust the path in that line

Also, there's a space in the previous lines due to a security restriction in this server, the lines should start with <!-- with no extra space between ! and -

CKFinder 1.x/Developers Guide/ASP/Troubleshooting

2008-08-24T15:35:48Z

AlfonsoML: changed to a list with subarticles.

This is a list of articles aimed to help you fix any problem while setting up your installation of CKFinder

*[[CKFinder/Developers Guide/ASP/Troubleshooting/ParentPath|Error "ASP 0131", not being able to use relative paths]]
*[[CKFinder/Developers Guide/ASP/Troubleshooting/UploadSize|Adjusting maximum upload size]]

Talk:FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/LinkUpload

2008-07-12T11:41:39Z

AlfonsoML: Applied suggestion, Thanks

FCKeditor 2.x/Developers Guide/Configuration/Configuration Options/LinkUpload

2008-07-12T11:40:54Z

AlfonsoML:

== LinkUpload ==

This option allows you to enable/disable "Upload" tab in the "Link" window. By default it is set to 'true' so the tab is displayed. Example:
<pre>FCKConfig.LinkUpload = true ;
</pre>

Talk:FCKeditor 2.x/Developers Guide/Integration/PHP

2008-05-21T21:21:03Z

AlfonsoML:

How to set config settings when instantiating: 

$oFCKeditor->Config['varName'] = 'value'; 

 

These variables will be available as editorInstance.Config.varName 

 

There are some settings that should be explained before the config options as they can be set only here, not in the config file: 

$oFCKeditor->Width = '100%' ; $oFCKeditor->Height = '200' ; $oFCKeditor->ToolbarSet = 'Default' ;

CKFinder 1.x/Developers Guide/ASP/Troubleshooting

2008-03-22T12:07:04Z

AlfonsoML:

In some IIS 6 instalations you might receive an error 'ASP 0131'. That's due to a [http://support.microsoft.com/?scid=kb%3Ben-us%3B226474 security setting in IIS] that doesn't allow to use a relative paths in include files.

There are two solutions for this problem.

# Using the Administrative tools you can change the setting as explained in [http://support.microsoft.com/?scid=kb%3Ben-us%3B332117 MS KB Q332117]
# If you don't have access or don't want to change that, then open the ckfinder/core/connector/asp/connector.asp file, go to line 51 (it might change in newer versions) and change 
<pre><! -- #INCLUDE file="../../../config.asp" -->
</pre>
with 
<pre><! -- #INCLUDE VIRTUAL="/ckfinder/config.asp" --></pre>
Please, note that if you have placed ckfinder under a different root folder you'll need to adjust the path in that line

Also, there's a space in the previous lines due to a security restriction in this server, the lines should start with <!-- with no extra space between ! and -

CKFinder 1.x/Developers Guide/ASP/Installation

2008-03-22T11:21:07Z

AlfonsoML: added troubleshooting link

== Installation Instructions ==

# Copy the distribution files to your web server inside the "/ckfinder/" folder or any other folder in your web site.
# Create a folder in the server to hold all uploaded files. By default, CKFinder is configured to use the "/ckfinder/userfiles/" folder in your web site.
# Make the above userfiles folder writable by the internet user. On Windows, give write permissions to the IUSR_<ServerName> user.
# Edit the '''config.asp''' file. Be sure you have correctly set all settings in that file, and that you have enabled CKFinder on it. See [[CKFinder/Developers Guide/ASP/Configuration|Configuration]]

You should be ready to go. Just browse _samples/asp/standalone.asp to test and see CKFinder.

== Security Tips ==

* For security tips see [[CKFinder/Developers Guide/ASP/Configuration/Security|Security]] section

== Troubleshooting ==

If you have some problem trying to install CKFinder, please check the [[CKFinder/Developers_Guide/ASP/Troubleshooting|Troubleshooting]]section.

CKFinder 1.x/Developers Guide/ASP/Troubleshooting

2008-03-22T11:19:08Z

AlfonsoML: Explain the "Enable Parent Paths" problem in IIS6

In some IIS 6 instalations you might receive an error 'ASP 0131'. That's due to a [http://support.microsoft.com/?scid=kb%3Ben-us%3B226474 security setting in IIS] that doesn't allow to use a relative paths in include files.

There are two solutions for this problem.

# Using the Administrative tools you can change the setting as explained in [http://support.microsoft.com/?scid=kb%3Ben-us%3B332117 MS KB Q332117]
# If you don't have access or don't want to change that, then open the ckfinder/core/connector/asp/connector.asp file, go to line 51 and change 
<pre><! -- #INCLUDE file="../../../config.asp" -->
</pre>
with 
<pre><! -- #INCLUDE VIRTUAL="/ckfinder/config.asp" --></pre>
Please, note that if you have placed ckfinder under a different root folder you'll need to adjust the path in that line

CKFinder 1.x/Developers Guide/ASP/System Requirements

2008-03-22T10:49:25Z

AlfonsoML: updated image components

{{Ckfinder Requirements Description}}

== Server ==

CKFinder for ASP is designed to run in '''IIS versions 5 and 6''', with no need of any extra component for its basic functionality, except for image manipulation.

In order to create thumbnails or restrict image dimensions, one of the following options must be available:

* ASP.NET 1.1 or 2.0. If the .Net Framework is available in the server and enabled in IIS, and both the ASP and ASP.NET runtimes have write access to the Windows temporary folder then it will be used automatically. This is the recommended solution. 
* [http://www.aspjpeg.com/ AspJpeg] component from Persits Software Inc. Not distributed with CKFinder.
* [http://www.serverobjects.com/comp/Aspimage.htm ASPImage 2] component from ServerObjects. Not distributed with CKFinder. 
* [http://www.brizsoft.com/asp/thumb/ ASPThumb] component from BRIZ Software. Not distributed with CKFinder.

Talk:FCKeditor 2.x/Users Guide

2008-02-08T21:17:29Z

AlfonsoML:

- the filemanager is not documented 

 

- I believe there should be a FAQ here too, with entries like :

* '''Setting the page's background''' In your fckconfig.js set 'FCKConfig.FullPage' to 'true'; and make sure the buttons 'DocProps' is set in your toolbarset. (This button was greyed out when 'FCKConfig.FullPage' was 'false') Now reload the FCKeditor (ctrl + F5 and perhaps disable your cache to make sure). You will now be able to click the button 'DocProps' and set the background of the document in tab 'Background'. 

You must remember that this part of the guide is aimed to the end users, so they won't be able to change the FullPage setting or the toolbar buttons. It must be strange enough for them when they see some references to a button that isn't present in their layout, let's avoid giving them a big headache talking about things that they can't control.

Also, a user that needs to read this guide in order to use the toolbar buttons won't know what's the "cache" or how to disable it.

Talk:FCKeditor 3.x/Design and Architecture/Browsers Compatibility

2008-02-06T17:14:43Z

AlfonsoML: New page: In the notable exclusions, I would add Firefox<2 and remark that now Netscape is dead (or it will be soon)

In the notable exclusions, I would add Firefox<2 and remark that now Netscape is dead (or it will be soon)

FCKeditor 3.x/Contributors

2008-01-30T21:48:20Z

AlfonsoML: Added myself

=== Frederico Caldeira Knabben (fredck) - Warsaw, Poland ===

Fred is the project manager for V3. He's responsible for designing it, organizing all information and research, and putting all contributors together at the same line of thought. He's the so called [http://producingoss.com/html-chunk/social-infrastructure.html#benevolent-dictator Benevolent Dictator] for the project, defining its directions and taking critical decisions, handling the hot potato when it comes to light ;-) 

=== Martin Kou (martinkou) - Hong Kong, China ===

Part of the FCKeditor core team, Martin is all about JavaScript and browsers hacking. His hands touch all over the code, bringing to reality many of the amazing features to be found in V3.

=== Wiktor Walc (wwalc) - Gdansk, Poland ===

Wiktor is our integration expert. For integration, we're talking about server side integration as well as managing our efforts to make V3 playing well with many of the most important software platforms out there.

=== Alfonso Martínez de Lizarrondo (alfonsoml) - Pamplona, Spain ===

When times allows, Alfonso works trying to fix some of the bugs that he finds more annoying and that could bring headaches to the end users.

CKFinder 1.x/Developers Guide/ASP/Configuration/Access Control

2008-01-10T22:10:05Z

AlfonsoML:

__TOC__

Access control is a way you to give your users different permissions while working on folders and files. The default setting in the config.asp file gives permission to every user and permits all the options. In order to change this configuration you must firstly know the basic of the '''accessControl(0)''' function placed in the config.asp file. 

The syntax of the function:
<pre>Set accessControl(0) = DefineAccessControlItem("*", "*", "/", true, true, true, true, true, true, true, true)</pre>
Functions are definied in the following order:
<pre>Function DefineAccessControlItem( _ role, resourceType, folder, _ folderView, folderCreate, folderRename, folderDelete, _ fileView, fileUpload, fileRename, fileDelete )</pre>
The three most important parameters of the "'''Access Control'''" function are:

=== role ===

The '''role'''is an attribute which sets the type of the user. It is set to "*" as default and you may treat as 'every user'. You may set this parameter to other name like: 'user' or 'limited_functions'. The name of the user type will be directly connected to the function the user may use.

=== resourceType ===

The '''resourceType''' defines the resources handled in CKFinder. A resource type is nothing more than a way to group files under different paths, each one having different configuration settings. E.g. Images, Flash, Files.It is set to "*" as default and means that all of the resources are available.

=== folder ===

'''Folder''' determines where your limitations will be used. By placing the folders name you specify the place you want to put your restrictions in. It is set to "/" as default so no folder is set.

=== folder and file options ===

The rest of the variables are bool type and can be set as '''true''' or '''false'''. True of course enables an option, false disables it. Example: If you want to restrict the upload, rename or delete of files in the "Logos" folder of the resource type "Images":
<pre>Set accessControl(1) = DefineAccessControlItem("*", "Images", "/Logos", true, true, true, true, true, false, false, false)</pre>
The above example only refers to file operations in the folder "/Logos" itself. It doesn't restrict operations on the folder so the user can delete or rename the folder. In order to limit users ability to modify the folder (not its context) you should change permissions in the parent folder. Example:
<pre>Set accessControl(1) = DefineAccessControlItem("*", "Images", "/", true, true, false, false, true, false, false, false)</pre>
Now a user can view and create a folder, but he will be unable to rename or delete it. This is the best way to secure your folders from unauthorized access. '''Note''':Please, remember to adjust Dim accessControl(0) to Dim accessControl(1) as necessary.

=== sessions ===

In order to enable the access control options for different users you should initialize a session.
<pre>CKFinder_Config.Add "RoleSessionVar", "CKFinder_UserRole"
</pre>
The session is a mechanism which will allow you to give different permissions to different users. Example: In your config.asp file you create three different roles:

First role '''admin''' '''(*)''':
<pre>Set accessControl(1) = DefineAccessControlItem("*", "*", "/", false, false, false, false, false, false, false, false)
</pre>
Second role '''user''':
<pre>Set accessControl(2) = DefineAccessControlItem("user", "*", "/", true, true, false, false, true, true, false, false)
</pre>
Third role '''guest''':
<pre>Set accessControl(3) = DefineAccessControlItem("guest", "*", "/", true, false, false, false, true, false, false, false)
</pre>
You've created three different users permissions.

'''Important:''' Note that when the role is set to '''*''' the user always has administrative privileges even though all the options are set to '''false'''.

Now you must create a place where you will point out the role you want to use e.g. a file. In this file you put initialize the session and write the command which will access you pre-defined role:
<pre><%
Session("CKFinder_UserRole")="user"
%></pre>

CKFinder 1.x/Developers Guide/ASP/Configuration/Resource Types/New

2008-01-10T22:06:35Z

AlfonsoML:

To create a new resource type you should place the section below in your config.asp file. Note that the options you can use are described in the [[CKFinder/Developers Guide/ASP/Configuration/Resource Types/Built-in|Built-in resource types]] section.

Example: You want to create a resource type MSdocs which will only have doc,ppt,xls extensions and be maximum 2 megabites large.
<pre>Set ResourceTypes(3) = DefineResourceType( _
"MSdocs", _
baseUrl & "MSdocs", _
baseDir & "MSdocs", _
2M, _
"doc,ppt,xls", _
"" _
)
</pre>
The CKFinder will use all the resources types including the one specifies by you. 

You must adjust the array definition to include your new resources: 
<pre>Dim ResourceTypes(3)
</pre>
If you want to limit the CKFinder to use only your resource type you must place it in the <nowiki>CKFinder_Config.Add "DefaultResourceTypes", ""</nowiki> field. Example'':''
<pre>CKFinder_Config.Add "DefaultResourceTypes", "MSdocs"</pre>
{{DISPLAYTITLE:Adding new resource types}}

CKFinder 1.x/Developers Guide/ASP/Configuration/Resource Types/Built-in

2008-01-10T22:03:30Z

AlfonsoML:

== Default resources ==

=== Resources types ===

There are three built-in resources types in CKFinder: '''files''', '''images''' and '''flash'''. They appear in the config.asp file as below:
<pre>Set ResourceTypes(0) = DefineResourceType( _
"Files", _
baseUrl & "files", _
baseDir & "files", _
0, _
"7z,aiff,asf,avi,bmp,csv,doc,fla,flv,gif,gz,gzip,jpeg,jpg,mid,mov,mp3,mp4,mpc,mpeg,mpg,ods,odt,pdf,png,ppt,pxd,qt,ram,rar,rm,rmi,rmvb,rtf,sdc,sitd,swf,sxc,sxw,tar,tgz,tif,tiff,txt,vsd,wav,wma,wmv,xls,xml,zip", _
"" _
)

Set ResourceTypes(1) = DefineResourceType( _
"Images", _
baseUrl & "images", _
baseDir & "images", _
0, _
"bmp,gif,jpeg,jpg,png", _
"" _
)

Set ResourceTypes(2) = DefineResourceType( _
"Flash", _
baseUrl & "flash", _
baseDir & "flash", _
0, _
"swf,flv", _
"" _
)</pre>
The above syntaz reffers to functions written bellow in the following order:
<pre>ResourceType.Add "name", name
ResourceType.Add "url", url
ResourceType.Add "directory", directory
ResourceType.Add "maxSize", maxSize
ResourceType.Add "allowedExtensions", allowedExtensions
ResourceType.Add "deniedExtensions", deniedExtensions
</pre>
These resources will be enabled if this option:
<pre>CKFinder_Config.Add "DefaultResourceTypes", ""</pre>
is left empty. If not you may specify what resources types you want to use by placing their names separated by a comma.

=== Changing the default resources ===

Every resource type has several options which you may change.

'''url''' and '''directory''' - you can place any url adress and directory you wish but be sure that their specification will follow the rules reffering to '''url''' and '''directory''' in the [[CKFinder/Developers Guide/ASP.NET/Configuration/Quick Start|Quick Start]] section.

'''maxSize''' - is the maximum size of the uploaded image defined in bytes.You may also use shorthand notation. Available options are: G, M, K (case insensitive). Remember that: 1M equals 1048576 bytes (one Megabyte), 1K equals 1024 bytes (one Kilobyte), 1G equals one Gigabyte. Example: 'maxSize' => "8M",

'''allowedExtensions''' - here you place all the extensions you wish the CKFinder to use, separated by a comma. .

'''deniedExtensions''' - here you place all the extensions you don't wish the CKFinder to use, separated by a comma.

 '''Important''': if you leave '''allowedExtensions''' empty and you will put something in '''deniedExtensions''' e.g.pdf it will allow the upload of all the files except the pdf. However it isn't a good way to secure your server from unwanted uploads. The best way is to put all of the prefered extensions in '''allowedExtensions''' and put the unwanted ones in the '''deniedExtensions'''. Only in this way you will secure your server from junk.

== FCKeditor issues ==

CKFinder may be integrated with FCKeditor. If so when looking through the files the editor will use the resources types specifies in the config.asp file of the CKFinder. To instead configure FCKeditor manually to use CKFinder, just edit the fckconfig.js file in the FCKeditor directory and modify the following settings:
<pre>FCKConfig.LinkBrowserURL = '/ckfinder/ckfinder.html' ;
FCKConfig.ImageBrowserURL = '/ckfinder/ckfinder.html?type=Images' ;
FCKConfig.FlashBrowserURL = '/ckfinder/ckfinder.html?type=Flash' ;
</pre>
Just change "/ckfinder/" in the above URLs if you have CKFinder installed in a different place. {{DISPLAYTITLE:Built-in resource types}}

CKFinder 1.x/Developers Guide/ASP/Configuration/Resource Types/Built-in

2008-01-10T22:01:48Z

AlfonsoML:

== Default resources ==

=== Resources types ===

There are three built-in resources types in CKFinder: '''files''', '''images''' and '''flash'''. They appear in the config.asp file as below:
<pre>Set ResourceTypes(0) = DefineResourceType( _
"Files", _
baseUrl & "files", _
baseDir & "files", _
0, _
"7z,aiff,asf,avi,bmp,csv,doc,fla,flv,gif,gz,gzip,jpeg,jpg,mid,mov,mp3,mp4,mpc,mpeg,mpg,ods,odt,pdf,png,ppt,pxd,qt,ram,rar,rm,rmi,rmvb,rtf,sdc,sitd,swf,sxc,sxw,tar,tgz,tif,tiff,txt,vsd,wav,wma,wmv,xls,xml,zip", _
"" _
)

Set ResourceTypes(1) = DefineResourceType( _
"Images", _
baseUrl & "images", _
baseDir & "images", _
0, _
"bmp,gif,jpeg,jpg,png", _
"" _
)

Set ResourceTypes(2) = DefineResourceType( _
"Flash", _
baseUrl & "flash", _
baseDir & "flash", _
0, _
"swf,flv", _
"" _
)</pre>
The above syntax reffers to functions written bellow in the following order:
<pre>Function DefineResourceType(name, url, directory, maxSize, allowedExtensions, deniedExtensions)

</pre>
These resources will be enabled if this option:
<pre>CKFinder_Config.Add "DefaultResourceTypes", ""</pre>
is left empty. If not you may specify what resources types you want to use by placing their names separated by a comma.

=== Changing the default resources ===

Every resource type has several options which you may change.

'''url''' and '''directory''' - you can place any url adress and directory you wish but be sure that their specification will follow the rules reffering to '''url''' and '''directory''' in the [[CKFinder/Developers Guide/ASP.NET/Configuration/Quick Start|Quick Start]] section.

'''maxSize''' - is the maximum size of the uploaded image defined in bytes.You may also use shorthand notation. Available options are: G, M, K (case insensitive). Remember that: 1M equals 1048576 bytes (one Megabyte), 1K equals 1024 bytes (one Kilobyte), 1G equals one Gigabyte. Example: 'maxSize' => "8M",

'''allowedExtensions''' - here you place all the extensions you wish the CKFinder to use, seperated by a comma. .

'''deniedExtensions''' - here you place all the extensions you don't wish the CKFinder to use, seperated by a comma.

 '''Important''': if you leave '''allowedExtensions''' empty and you will put something in '''deniedExtensions''' e.g.pdf it will allow the upload of all the files exept the pdf. However it isn't a good way to secure your server from unwanted uploads. The best way is to put all of the prefered extensions in '''allowedExtensions''' and put the unwanted ones in the '''deniedExtensions'''. Only in this way you will secure your server from junk.

== FCKeditor issues ==

CKFinder may be intergrated with FCKeditor. If so when looking througout the files the editor will use the resources types specifies in the config.php file of the CKFinder. To instead configure FCKeditor manually to use CKFinder, just edit the fckconfig.js file in the FCKeditor directory and modify the following settings:
<pre>FCKConfig.LinkBrowserURL = '/ckfinder/ckfinder.html' ;
FCKConfig.ImageBrowserURL = '/ckfinder/ckfinder.html?type=Images' ;
FCKConfig.FlashBrowserURL = '/ckfinder/ckfinder.html?type=Flash' ;
</pre>
Just change "/ckfinder/" in the above URLs if you have CKFinder installed in a different place. {{DISPLAYTITLE:Built-in resource types}}

CKFinder 1.x/Developers Guide/ASP/Configuration/Images/Scaling

2008-01-10T21:48:52Z

AlfonsoML: describe the image component option

{{Ckfinder scaling description}}
<pre>Set Images = server.CreateObject("Scripting.Dictionary")
Images.Add "maxWidth", 1200
Images.Add "maxHeight", 1200
Images.Add "quality", 80
Images.Add "component", "Auto"
</pre>
The component entry indicates the method that should be used to handle images and thumbnails. These are the possible values: 

* "Asp.Net", it should work with Asp.Net 1.1 and 2.0 
* "Persits.Jpeg" Commercial component from Persits 
* "AspImage.Image" Commercial component from ServerObjects. The available demo it's expired and doesn't seems to handle gifs properly 
* "OWC10.ChartSpace", Microsoft Office Web Components, it won't keep the proportions of the scaled images 
* "Auto": It will try to autodetect which one is available, in the order described above. It's the default value.

CKFinder 1.x/Developers Guide/ASP/Installation

2008-01-10T21:42:09Z

AlfonsoML:

== Installation Instructions ==

# Copy the distribution files to your web server inside the "/ckfinder/" folder or any other folder in your web site.
# Create a folder in the server to hold all uploaded files. By default, CKFinder is configured to use the "/ckfinder/userfiles/" folder in your web site.
# Make the above userfiles folder writable by the internet user. On Windows, give write permissions to the IUSR_<ServerName> user.
# Edit the '''config.asp''' file. Be sure you have correctly set all settings in that file, and that you have enabled CKFinder on it. See [[CKFinder/Developers Guide/ASP/Configuration|Configuration]]

You should be ready to go. Just browse _samples/asp/standalone.asp to test and see CKFinder.

== Security Tips ==

* For security tips see [[CKFinder/Developers_Guide/ASP/Configuration/Security|Security]] section

CKFinder 1.x/Developers Guide/ASP/Installation

2008-01-10T21:41:01Z

AlfonsoML:

== Installation Instructions ==

# Copy the distribution files to your web server inside the "/ckfinder/" folder or any other folder in your web site.
# Create a folder in the server to hold all uploaded files. By default, CKFinder is configured to use the "/ckfinder/userfiles/" folder in your web site.
# Make the above userfiles folder writable by the internet user. On Windows, give write permissions to the IUSR_<ServerName> user.
# Edit the '''config.asp''' file. Be sure you have correctly set all settings in that file, and that you have enabled CKFinder on it. See [[CKFinder/Developers Guide/ASP/Configuration|Configuration]]

You should be ready to go. Just browse _samples/asp/standalone.asp to test and see CKFinder.

== Security Tips ==

* For security tips see [[CKFinder/Developers Guide/ColdFusion/Configuration/Security|Security]] section

CKFinder 1.x/Developers Guide/ASP/System Requirements

2008-01-10T21:40:01Z

AlfonsoML: describe the server enviroment

{{Ckfinder Requirements Description}}

The asp version of CKFinder has been designed to run in IIS 5 or 6, without the need to any extra component for its basic functionality.

In order to create thumbnails or restrict image dimensions one of these items should be available:

* Asp.net 1.1 or 2.0. If the .Net framework is available in the server and both the asp and asp.net code have access to the temp folder then it will be used automatically.
* AspJpeg component from Persits Software Inc.
* ASPImage 2 component from ServerObjects
* Microsoft Office Web Components. It will provide very low quality thumbnails.