Pages

Friday, June 27, 2008

Using a Custom CSS File in DotNetNuke For FCK Editor


I've been working on implementing DotNetNuke at work for a few weeks now. After finally getting the hand of skinning DotNetNuke and building a custom skin that mimicked the look of the design provided by Marketing, I wanted to create a set of styles for formatting text. This would allow users to format text (and other elements) with a pre-set look and not have to use font-size, font-color and other outdated markup, thereby creating uniformity and smaller page/code sizes.


Well, after trying many attempts using the FCK Editor settings, I found the steps necessary to implement a set of custom CSS styles in DotNetNuke using the FCK Editor.


Add your customs styles to portal.css in the portal root (Site Settings > Style Sheet) and save. These styles will be applied to your module text outside of the editor.
Create a text file: FCK.xml. Here is where you will define styles to appear in the style list inside the FCK editor.
Using the information in the FCK Editor Wiki help site, create your custom styles in FCK.xml. There should be an entry for each style you want to appear in the editor and in the order you want them to appear. See example below.
Create a text file: FCK.css. These styles give the formatting to the styles you defined in FCK.xml so text in the editor will be formatted properly.
Add your custom styles to FCK.css. This file contains ONLY your custom styles which are exactly the same as the custom styles you added to portal.css. There should be an entry for each style in FCK.xml you want to format. Using these lists limits the styles that appear in the editor to only those you want, rather than the long list of styles in portal.css.
Upload FCK.css and FCK.xml to your portal root using the File Manger.
Log in to your portal as Host and edit an HTML/Text module with the FCK Editor.
Select "Show custom editor options" Select "Portal" for Settings Type.
Expand "List of available styles for the editor" Select "URL" for Style list generation mode. Do not choose "Dynamic" or you will get a style list of garbage. Select "File" for Custom XML file, and select FCK.xml you uploaded to the root.
Expand "Editor area CSS" Select "URL" for CSS Generator mode. Again, do not select "Dynamic". Select "File" for Custom CSS file, and select FCK.css you uploaded to the root.
Confirm "Apply custom settings to: Portal" and click "Apply" Close the FCK Editor custom options page and Cancel module editing.
Refresh your browser with Ctl-F5 to force a refresh of the cache.
The list of styles should appear in the editor now. If you don't see your styles and the formatting is not right, you might try deleting files in your cache. Also, check for mistakes in FCK.xml, FCK.css and portal.css. They must all be in sync and correct.


Here is a sample FCK.xml adapted from FCK:





And corresponding FCK.css: body, td {
font-family: Verdana, Sans-Serif;
font-size: 13px;
}


.Title {
font-family: Ariel, sans-serif;
font-size: 16px;
font-weight: bold;
color: red;
}


.Topic {
font-family: Ariel, sans-serif;
font-size: 14px;
font-weight: bold;
color: red;
font-style: italic;
}


.Bold {
font-weight: bold;
}


H1 {
font-family: arial, sans-serif;
font-size: 1.7em;
font-weight: bold;
color: #006699;
}


H2 {
font-family: arial, sans-serif;
font-size: 1.3em;
font-weight: bold;
color: #006699;
}
Those steps worked perfectly. Now I've just got to create the XML file to match the CSS file. I'll go ahead and complain. It seems like there should be an easier way. Second, I don't like the way it applies the styles. If I have a style ".red" (to make the text a specific shade of red) and I've got a style .bold (to make the font-weight:bold), DotNetNuke applies each one in a separate SPAN tag. I guess chaining CSS styles (span class="red bold") is too complicated.


Ugh! I guess this is the trade off. Moving the tedious task of menial updates to the users means uglier code underneath.