CKEditor for SharePoint/2007/Administrators Guide/Installation/Installing/Publishing Sites - Revision history

Anna: Validity note aded

2012-01-11T14:01:07Z

Validity note aded

Anna: Article contents proof-read

2011-12-16T13:26:14Z

Article contents proof-read

Wiktor: Created page with '{{#CUSTOMTITLE:Enabling CKEditor on Publishing Sites}} TOC During the installation process, CKEditor will be automatically enabled on Publishing Sites. However, if you have m…'

2011-12-16T11:52:11Z

Created page with '{{#CUSTOMTITLE:Enabling CKEditor on Publishing Sites}} __TOC__ During the installation process, CKEditor will be automatically enabled on Publishing Sites. However, if you have m…'

New page

{{#CUSTOMTITLE:Enabling CKEditor on Publishing Sites}} __TOC__
During the installation process, CKEditor will be automatically enabled on Publishing Sites. However, if you have modified the default master pages or if you are using your own, custom master pages, then you will need to manually enable CKEditor on these sites.

=== Adding CKEditor to a Master Page ===

The master pages are located in the following folders:
* <code>C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\GLOBAL\default.master</code>
* <code>C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\FEATURES\PublishingLayouts\MasterPages\</code>

In each file master file that is used on your sites do the following changes:

==== Step 1: Register an Assembly ====

To enable CKEditor, in the <code>Register</code> section at the top of the page add:

<source>
<%-- Start CKEditorForSharePoint --%>
<%@ Register TagPrefix="my" Assembly="CKEditorForSharePoint, Version=1.0.0.0, Culture=neutral, PublicKeyToken=2c0483256f3286a8"
Namespace="CKEditorForSharePoint" %>
<%-- End CKEditorForSharePoint --%>
</source>

==== Step 2: Add the Page_Load Method ====

Straight below the <code>Register</code> tag or somewhere in the <code><body></code> of the master page add:
<source>
<%-- Start CKEditorForSharePoint --%>
<script language="C#" runat="server">
private void Page_Load(object sender, EventArgs e) {
this.Page.ClientScript.RegisterStartupScript(this.Page.GetType(), "CKEditorConfigScript",
string.Format("var CKTabConfig =\"{0}\";", SPUtils.ReadConfigurationForCKEditor()), true);
}
</script>
<%-- End CKEditorForSharePoint --%>
</source>

<note>
The extra comments <code><%-- Start CKEditorForSharePoint --%></code> and <code><%-- End CKEditorForSharePoint --%></code>
are not required, but they will be helpful e.g. during uninstallation process or when modifying the page to understand what they are used for.
</note>

==== Step 3: Enable Code Blocks in Master Pages ====

In previous step we added server side code to the page. In order to execute this part of code, SharePoint must be configured to allow this operation. If code blocks are disallowed, you will see the following error:

'''Parser Error Message''' : Code blocks are not allowed in this file

Code blocks can be enabled in the <code>web.config</code> file, in the <code>configuration/SharePoint/PageParserPaths</code> configuration section. Find the <code><PageParserPaths></code> option and add there <code><PageParserPath></code> element:

<source lang="xml">
<PageParserPaths>
<PageParserPath VirtualPath="/_catalogs/masterpage/*" CompilationMode="Always" AllowServerSideScript="true"
IncludeSubFolders="true"/>
</PageParserPaths>
</source>

<note>Such configuration option should be '''restricted only to certain set of pages''' (or even to a single page). Anyone that can modify or add a page to the specified <code>VirtualPath</code> can insert code that will be executed server side with no restrictions. A good location to specify as a <code>PageParserPath</code> is the location where you store your masterpages, for example <code>/_catalogs/masterpage</code>.</note>

@@ Line 2: / Line 2: @@
 {{#CUSTOMTITLE:Enabling CKEditor on Publishing Sites}}
 During the installation process CKEditor will be automatically enabled on Publishing Sites. However, if you have modified the default master pages or if you are using your own custom master pages, you will need to manually enable CKEditor on these sites.
 == Adding CKEditor to a Master Page ==

@@ Line 1: / Line 1: @@
-{{#CUSTOMTITLE:Enabling CKEditor on Publishing Sites}} __TOC__
+__TOC__
-During the installation process, CKEditor will be automatically enabled on Publishing Sites. However, if you have modified the default master pages or if you are using your own, custom master pages, then you will need to manually enable CKEditor on these sites.
+{{#CUSTOMTITLE:Enabling CKEditor on Publishing Sites}}
 During the installation process CKEditor will be automatically enabled on Publishing Sites. However, if you have modified the default master pages or if you are using your own custom master pages, you will need to manually enable CKEditor on these sites.
 The master pages are located in the following folders:
 * <code>C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\GLOBAL\default.master</code>
 * <code>C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\FEATURES\PublishingLayouts\MasterPages\</code>
-In each file master file that is used on your sites do the following changes:
+For each master file that is used on your sites you need to introduce the changes described below.
-==== Step 1: Register an Assembly ====
+=== Step 1: Register an Assembly ===
+To enable CKEditor, add the following code in the <code>Register</code> section at the top of the page:
-To enable CKEditor, in the <code>Register</code> section at the top of the page add:
+<source lang="asp">
 <%-- Start CKEditorForSharePoint --%>
 <%@ Register TagPrefix="my" Assembly="CKEditorForSharePoint, Version=1.0.0.0, Culture=neutral, PublicKeyToken=2c0483256f3286a8"
@@ Line 21: / Line 19: @@
 </source>
-==== Step 2: Add the Page_Load Method ====
+=== Step 2: Add the Page_Load Method ===
+Add the following code straight below the <code>Register</code> tag or somewhere inside the <code><body></code> of the master page:
-Straight below the <code>Register</code> tag or somewhere in the <code><body></code> of the master page add:
+<source lang="asp">
 <%-- Start CKEditorForSharePoint --%>
 <script language="C#" runat="server">
@@ Line 36: / Line 33: @@
 <note>
-The extra comments <code><%-- Start CKEditorForSharePoint --%></code> and <code><%-- End CKEditorForSharePoint --%></code>
+The extra comments in the form of <code><%-- Start CKEditorForSharePoint --%></code> and <code><%-- End CKEditorForSharePoint --%></code> are not required, but they will be helpful e.g. during the uninstallation process or when modifying the page to understand what they are used for.</note>
-In previous step we added server side code to the page. In order to execute this part of code, SharePoint must be configured to allow this operation. If code blocks are disallowed, you will see the following error:
+=== Step 3: Enable Code Blocks in Master Pages ===
    '''Parser Error Message''' : Code blocks are not allowed in this file
-Code blocks can be enabled in the <code>web.config</code> file, in the <code>configuration/SharePoint/PageParserPaths</code> configuration section. Find the <code><PageParserPaths></code> option and add there <code><PageParserPath></code> element:
+Code blocks can be enabled in the <code>configuration/SharePoint/PageParserPaths</code> configuration section of the <code>web.config</code> file. Find the <code><PageParserPaths></code> option and add an <code><PageParserPath></code> element there:
 <source lang="xml">
@@ Line 56: / Line 50: @@
 </source>
-<note>Such configuration option should be '''restricted only to certain set of pages''' (or even to a single page). Anyone that can modify or add a page to the specified <code>VirtualPath</code> can insert code that will be executed server side with no restrictions. A good location to specify as a <code>PageParserPath</code> is the location where you store your masterpages, for example <code>/_catalogs/masterpage</code>.</note>
+<note>Such configuration option should be '''restricted only to a certain set of pages''' (or even to a single page). Anyone that can modify or add a page to the specified <code>VirtualPath</code> can insert code that will be executed on the server side with no restrictions. A good location to specify as a <code>PageParserPath</code> is the location where you store your masterpages, for example <code>/_catalogs/masterpage</code>.</note>

CKEditor for SharePoint/2007/Administrators Guide/Installation/Installing/Publishing Sites - Revision history

Anna: Validity note aded

Anna: Article contents proof-read

Wiktor: Created page with '{{#CUSTOMTITLE:Enabling CKEditor on Publishing Sites}} __TOC__ During the installation process, CKEditor will be automatically enabled on Publishing Sites. However, if you have m…'

Wiktor: Created page with '{{#CUSTOMTITLE:Enabling CKEditor on Publishing Sites}} TOC During the installation process, CKEditor will be automatically enabled on Publishing Sites. However, if you have m…'