SharePoint Wiki Plus Customization Guide

Transcription

1 SharePoint Wiki Plus Customization Guide

2 Copyright KWizCom Corporation. All rights reserved. Company Headquarters KWizCom 50 McIntosh Drive, Unit 109 Markham, Ontario ON L3R 9T3, Canada Web site: Sales Telephone:

3 Table of Contents Introduction... 4 What is Wiki Plus? 4 The content of this customization guide 4 Product Overview... 5 Wiki Plus modules 6 Wiki Plus is a standard SharePoint add-on. It is composed out of the following standard SharePoint modules: 6 Wiki Plus customization scenarios... 8 Introduction 8 Site layout customization 9 Site style sheet... 9 Change the Wiki Plus master page Change the Wiki Plus site's home page Change the top banner Data structure changes 17 Add/remove wiki page fields (columns) Change the tagging method Wiki Plus editor 23 Customize the editor's toolbar Customize "Custom Links" drop-down Customize "Wiki markup" drop-down Customize "Paragraph Style" drop-down Customize "Content Snippets" drop-down Change the editor's default content styles Customize Emoticons Additional customizations 37 Change the file size limit for upload Wiki Plus localization Technical Support The KWizCom Web site 40 The Web Form 40 3

4 Introduction What is Wiki Plus? KWizCom's Wiki Plus is an advanced, comprehensive Wiki solution for SharePoint. Its unique additional features make it the ideal tool for true crossorganization knowledge sharing. Wiki Plus is compatible with MOSS 2007/ WSS 3.0 and SharePoint 2010 Server/Foundation. As a SharePoint add-on, Wiki Plus building blocks include Site/library templates, content types, site columns, features, master page etc. ALL standard SharePoint modules. As a SharePoint implementer you can fully customize the Wiki Plus solution to fit your exact business requirements. The content of this customization guide This customization guide includes the following sections: Product Overview Short functional overview and product structure. Customization scenarios Detailed step-by-step customization scenarios including changes in the solutions layout, structure and logic. 4

5 Product Overview True, SharePoint-based Enterprise Wiki solution. Wiki Plus is built on-top of SharePoint infrastructure, enhancing all the standard SharePoint features with comprehensive Wiki capabilities. The advanced wiki features and their enmeshment with the SharePoint platform provide the most productive and cost effective tool for real collaboration and knowledge sharing across the enterprise. Wiki Plus key features include: Support for standard Wiki markup language Improved content editing capabilities Complete taxonomy solution (Web 2.0 tagging / Hierarchical categories) Content rating Support for RSS feeds / Alerting / Subscriptions on wiki pages and categories Content lifecycle management Support for discussions on Wiki pages Support for Printing a Wiki page Support for Previewing a Wiki page before saving it Advanced reporting Wiki content template Content snippets Enable adding images, flash, movie clips, emoticons and file attachments to wiki pages the easy way! Support for mapping images and setting absolute position Support for adding a source code True SharePoint integration it s all standard SharePoint behind the scenes No separate maintenance costs! For additional information about Wiki Plus features and functionality, please review the Wiki Plus user's guide document. 5

6 Wiki Plus modules Wiki Plus is a standard SharePoint add-on. It is composed out of the following standard SharePoint modules: Module File/Assembly Description Wiki Plus field type fldtypes_kwizcomwikiplusfield.xml definition located in: \TEMPLATE\XML folder This field provides rich-text editing capabilities including Wiki markup support. Wiki Plus content type WikiPlusContentType.xml definition located in: This content type includes all fields composing a Wiki Plus page. \TEMPLATE\FEATURES\WikiPlusResources folder Wiki Plus library template WikiPlus library definition located in: \TEMPLATE\SiteTemplates folder This library template is used to create Wiki Plus libraries. Wiki Plus site template WikiPlus site definition located in: \TEMPLATE\SiteTemplates folder This site template is used to create Wiki Plus sites. Wiki Plus master page default.master into \TEMPLATE\LAYOUTS\KWizCom_Wikiplus This master pages is used when new WikiPlus site is created folder Wiki Plus site A site created from Wiki Plus site template. Tags field type fldtypes_kwizcomtags.xml definition located in: \TEMPLATE\XML folder Field type used to create tagging fields Rating field type fldtypes_kwizcomrating.xml definition located in:\template\xml folder Field type used to create rating fields Wiki Plus style sheet defaultwiki.css, KWizCom_WikiPlus.css, editorwiki.css defaultwiki.css defines wiki site styles KWizCom_WikiPlus.css defines tagging feature styles editorwiki.css defines additional style in edit mode Wiki Plus resource files 1. wikiplus.resx, wikiplus.en-us.resx located in \Resources folder Used to translate the Wiki Plus application to any required language 2. wikiplus.resx, wikiplus.en-us.resx located in App_GlobalResources folder in Web application folder WikiPlus control templates WikiPlusTemplates.ascx Contains all control templates which are used in WikiPlus Default pages wkptmpl.aspx, wkptmpl_site.aspx wkptmpl.aspx default template for 6

7 Module File/Assembly Description templates WikiPlus page. Uploads to Forms directory during creating of WikiPlus document library wkptmpl_site.aspx default template for Home page into WikiPlus site. Uploads to Forms directory during creating of WikiPlus document library 7

8 Wiki Plus customization scenarios Introduction This chapter presents the various customizations that can be done in order to deploy a tailored Wiki Plus solution. The following customization scenarios are covered: Subject Customization Scenario Description Site Layout Site style sheet (CSS) Customize the Wiki Plus site's graphic layout. Change the master page Change the home page Change the top banner Change the master page structure, including changing navigation, top banner etc. Customize the structure of the Wiki Plus homepage Data structure Add/remove wiki page fields (columns) Change tagging method Implement web 2.0 tagging vs. hierarchical tagging. Wiki Plus Editor Update the editor styles Add new toolbar buttons Manage content snippets Additional Change the file size limit for upload Localizing Wiki Plus Step by Step localization guideline 8

9 Site layout customization Site style sheet Purpose After Wiki Plus is installed and a Wiki Plus site is created, it appears in its default style definitions: One of the 1 st customization needs is to change the Wiki Plus site so it will match the overall branding of your MOSS portal's styles. 9

10 Guidelines Wiki Plus includes 2 style sheet files, both located in "C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\template\layouts\kwizcom_wikiplus" folder: (In SharePoint 2010 these files are located in 14\TEMPLATE\LAYOUTS\KWizCom_WikiPlus\css) defaultwiki.css This file includes the following styles definition: Style Name ms-globalbreadcrumb ms-globaltitlearea ms-bannercontainer ms-titlearea ms-leftareacell Description Top page menu area (Site actions, My site ) Global title, includes background image (default KWizCom image) Search and breadcrumbs container Breadcrumbs class Left (quick launch) area Create a new Wiki Page and other links in quick launch ms-bodyareaframe ms-pagetitle ms-toccontainer ms-toctitle ms-toctoggle ms-editsection Page body area Page title Table of content container Table of content title Table of content show/hide toggle button Edit section link All other styles are defined by SharePoint stylesheet (like any other SharePoint site): CORE.CSS, PORTAL.CSS KWizCom_WikiPlus.css This file includes the following styles definition: Style Name wphp-navitem wphp-addnew wphp-lactionitem wphp-navheader ms-toccontainer ms-toctitle ms-toctoggle ms-toclevel Description Tag link in tag cloud Show all tags link in tag cloud Index characters and tag links in Tag index mode Tag links in tag tree mode Style for TOC div container Toc title style TOC toggle (hide/show) style TOC level style 10

11 Style Name ms-editsection Description Edit section link style Change the Wiki Plus master page Purpose Wiki Plus master page defines the shared ingredients across the Wiki Plus pages (navigation, branding). In most deployments the master page needs to be customized in order to change the navigation (See for example the customization scenario: Implement hierarchical tagging instead of the default Web 2.0 textual tagging.) Guidelines Changing the Wiki Plus master page can be done in one of the following ways: For an existing Wiki Plus site Edit "default.master" in SharePoint Designer. For new created sites Edit the 'default.master" file located in the "C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\template\layouts\kwizcom_wikiplus" folder. In SharePoint 2010 WikiPlus Sites use the out of the box default master located at: 14\TEMPLATE\LAYOUTS\default.master 11

12 Change the Wiki Plus site's home page Purpose Wiki Plus site home page is a standard MOSS 2007 web part page that includes the following ingredients: (1) Home page welcome content fully customizable by the Wiki plus administrator (simply by navigating to Wiki Plus library and editing this page's properties). (2) Popular Tags This Tag Cloud web part displays all used tags/keywords using the Tag Cloud standard. This means that keywords that are used to tag many pages will appear larger than tags that are used less. Clicking a tag will redirect to the 12

13 "Tags List Page" which displays all pages that are tagged to the clicked tag. (3) "More about KWizCom" this is a simple "Content Editor Web Part" that contains some graphic links to information that the site admin would like to offer all users (such as: "more about our policies"). (4) Top 5 rated wiki pages This is a regular list view web part that displays the highest rated wiki pages (sorted according to their "Rate" column (that shows the 5 stars). This guideline describes what you can change and customize in this page. Guidelines Changing the home page's ingredients Well, this is easy because this is a regular web part page. If you edit the page (Site Actions > Edit Page): 13

14 You will see the home page's structure: You can see that the page includes 3 web part zones, enabling you to change the content of this page by adding/removing web parts. Changing the home page's Structure There are 2 ways to make more deep changes in the home page's structure (besides adding/removing web parts): To change that you have 2 ways: 1. For existing sites open the site with SharePoint designer and customize the home page. 2. For new created sites - Modify wkptmpl_site.aspx file in C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\template\layouts\kwizcom_wikiplus\wplibfiles folder. (In SharePoint 2010 the path is 14\ TEMPLATE\LAYOUTS\KWizCom_Wikiplus\WPlibFiles) 14

15 Change the top banner Purpose The wiki Plus site includes by default a "KWizCom WikiPlus" top banner as appears in the following screenshot: As a part of the site's branding, you may want to replace this banner. 15

16 Guidelines This banner is defined in the Wiki Plus "defaultwiki.css" file. In order to replace it: Open the "defaultwiki.css" file located in "C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\template\layouts\kwizcom_wikiplus" folder. (In SharePoint 2010 the file is located in TEMPLATE\LAYOUTS\KWizCom_Wikiplus\css ) Find the ".ms-globaltitlearea" style:.ms-globaltitlearea { background-color: #007bde; height: 96px; background-image: url( '/_layouts/kwizcom_wikiplus/kwizcom_header_wikiplus.jpg' ); } border-left: 10px #ffffff solid; border-right: 10px #ffffff solid; border-top: 4px #ffffff solid; Copy your own banner image to the same folder and update the "background-image" attribute. IMPORTANT! After making changes to client-side files such ass javascript files (.js) or stylesheet files (.css), you need to clear your browser s cache before the changes take effect. After making changes to server-side files such as.ascx, xml,.aspx) you may not see changes take effect until you do an iisreset. 16

17 Data structure changes Add/remove wiki page fields (columns) Purpose By default, the Wiki Plus library (in which all wiki pages are stored) includes the following fields: As you can see, these fields are defined by the Wiki Plus Page content type (which is a part of the Wiki Plus solution). As a part of your custom implementation, you may want to change the fields that are part of the Wiki Plus library (maybe some of the fields are not needed or maybe there are more needed fields). Guidelines You can make changes in the Wiki Plus library fields (columns) in 2 ways: Make local changes in the Wiki Plus library just like in any other SharePoint library, you can add more columns or remove columns and these changes will be reflected in the Wiki plus edit/view pages. IMPORTANT REMARK: You may NOT remove the following mandatory fields from the Wiki Plus library: Name, Title, Wiki Content and Lifecycle alert. Make changes in the Wiki Plus Page content type this will have a more global effect over all Wiki Plus libraries in the same site collection. 17

18 Change the tagging method Purpose Wiki Plus includes taxonomy management capabilities. These capabilities include: Tagging a "Tags" field that enables contributors to tag wiki pages in Web 2.0 style textual keywords or by using hierarchical categories. Browsing a "Tag Cloud/Tag Index" web part that enables finding wiki pages by tags/categories. Subscription users can subscribe to tags and receive notifications when new wiki pages are tagged to some tag/category. For more details about Wiki Plus tagging feature, please review KWizCom's Tagging Feature manual: NodeID=522 By default, Wiki Plus is configured with a Web 2.0 style tagging functionality. You may want to change the tagging method to hierarchical categorizing, which is more suitable to central taxonomy management needs. 18

19 Guidelines Update the Tags field (in the Wiki Plus library settings or in Tags site column) to work with Hierarchical category tree method: In order to define the central taxonomy (hierarchical tree of categories) go to the site collection settings (you have to be a site collection manager in order to manage the Tagging Feature), click the "KWizCom Tagging Feature Management" link: 19

20 Scroll all the way down and you will see the "Tags Collection" link. 20

21 Click the "Tags Collection' link and you will be redirected to this list page. This list contains all shared tags/categories and this is the place where you can manage those tags and define the tags hierarchy: In order to add new categories, simply click the "New" menu and add new tags to this list: You only need to fill the "Title" field (which is the tag/category title) and click "OK". 21

22 If you want to create a category below an existing category, select the parent node in the "Parent' field as in the following example ("DB2" tag is a sub-category of the "Database" tag): This way you define all your tags and the relations between them (the hierarchy). Now, you need to change the site master page to include the category tree in order to enable users to find wiki pages by clicking a category. This is done by: o o o o Open default.master in SharePoint designer. Add the "Tag Cloud" web part (part of Wiki Plus solution) to the required place in the master page Configure the web part to work in "Category Tree" mode. Save changes to the Master page. IMPORTANT! After making changes to client-side files such ass javascript files (.js) or stylesheet files (.css), you need to clear your browser s cache before the changes take effect. After making changes to server-side files such as.ascx, xml,.aspx) you may not see changes take effect until you do an iisreset. 22

23 Wiki Plus editor Wiki Plus editor is based on Telerik RadEditor control (which on top of it we have added Wiki unique features such as the Wiki markup parser). This section presents the various customization capabilities of the Wiki Plus editor. Customize the editor's toolbar Purpose Configure the toolbar to include requested buttons. Guidelines The toolbar is configured using an XML ToolsFile, which defines: the number of toolbars the collection of buttons in each toolbar and their order specific options (if any) for the respective tools (i.e. Fonts collections, Colors collection, etc.) the default docking zone for each toolbar The ToolsFile.xml file is located in: "C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\template\layouts\kwizcom_wikiplus\ RadControls\Editor folder, on your MOSS 2007 server. (In SharePoint 2010 the path is 14\TEMPLATE\LAYOUTS\KWizCom_Wikiplus\ RadControls\Editor) The following table describes for every toolbar control, which xml node defines its behavior: Icon Description ToolsFile Declaration Insert a link to a wiki page (new or existing). Save current edited wiki page as a wiki content template. <tool name="newwiki" /> <tool name="existedwiki" /> <tool name="saveastemplate" iconurl="/_layouts/kwizcom_wikiplus/sa VEastemplate.gif" /> 23

24 Icon Description ToolsFile Declaration Convert the text of the current selection to upper case, preserving the non-text elements such as images and tables. Convert the text of the current selection to lower case, preserving the non-text elements such as images and tables. Allows the user to apply to the current selection font size measured in pixels (px) or points (pt), rather than a fixed-size 1 to 7 (as does the FontSize tool). Toggle Screen Mode - Switches Telerik RadEditor into Full Screen Mode. Show/Hide Border - Shows or hides borders around tables in the content area. Zoom - Changes the level of text magnification. Repeat Last Command - A short-cut to repeat the last action performed. Find and Replace - Find (and replaces) text in the editor's content area. Print button - Prints the contents of the editor the whole web page. Spell button - Launches the spell checker. Cut button - Cuts the selected content and copies it to the clipboard. Copy button - Copies the selected content to the clipboard. Paste button - Pastes the copied content from the clipboard into the editor. Paste from Word button - Pastes content copied from Word and removes the web-unfriendly tags. Paste from Word cleaning fonts and sizes button - cleans all Word-specific tags and removes font names and text sizes. Paste Plain Text button - Pastes plain text (no formatting) into the editor. Paste as HTML button - Pastes HTML code in the content area and keeps all the HTML tags. <tool name="converttoupper" /> <tool name="converttolower" /> <tool name="realfontsize"/> <tool name="togglescreenmode" shortcut="f11"/> <tool name="toggletableborder" /> <tool name="zoom" /> <tool name="repeatlastcommand" shortcut="f4"/> <tool name="findandreplace" shortcut="ctrl+f"/> <tool name="print" shortcut="ctrl+p"/> <tool name="spellcheck" shortcut="f7"/> <tool name="cut" shortcut="ctrl+x"/> <tool name="copy" shortcut="ctrl+c"/> <tool name="paste" shortcut="ctrl+v"/> <tool name="pastefromword" /> <tool name="pastefromwordnofontsnosize s" /> <tool name="pasteplaintext" /> <tool name="pasteashtml" /> 24

25 Icon Description ToolsFile Declaration Redo button - Redoes/Repeats the last action, which has been undone. <tool name="redo" shortcut="ctrl+y"/> Format Stripper button - Removes custom or all formatting from selected text. About Dialog - Shows the current version and credentials of Telerik RadEditor. <tool name="formatstripper"/> <tool name="aboutdialog" /> INSERT AND MANAGE LINKS, TABLES, SPECIAL CHARACTERS, IMAGES and MEDIA Image Manager button - Inserts an image from a predefined image folder(s). Insert Table button - Inserts a table in the Telerik RadEditor. Insert Snippet - Inserts pre-defined code snippets. Insert Date button - Inserts current date. Insert Time button - Inserts current time. Document Manager - Inserts a link to a document on the server (PDF, DOC, etc.) Hyperlink Manager button - Makes the selected text or image a hyperlink. Remove Hyperlink button - Removes the hyperlink from the selected text or image. Insert Special Character dropdown - Inserts a special character (,, ±, etc.) Insert Custom Link dropdown - Inserts an internal or external link from a predefined list. Image Map Editor map an image, allows inserting links on the image. Set absolute position to an image Flash Manager add flash items to the page Movie manager add movie clips to the page Add an emoticon to the page <tool name="imagemanager" shortcut="ctrl+g"/> <tool name="inserttable" /> <tool name="insertsnippet" /> <tool name="insertdate" /> <tool name="inserttime" /> <tool name="documentmanager" /> <tool name="linkmanager" shortcut="ctrl+k"/> <tool name="unlink" shortcut="ctrl+shift+k"/> <tool name="insertsymbol" /> <tool name="insertcustomlink"/> <tool name="imagemapdialog"/> <tool name="absoluteposition"/> <tool name="flashmanager"/> <tool name="mediamanager"/> <tool iconurl="/_layouts/kwizcom_wikiplus/em 25

26 Icon Description ToolsFile Declaration oticons.gif" showtext="false" name="emoticons" type="dropdown" dropdownwidth="300px" dropdownheight="200px" ItemsPerRow="7"></tool> CREATE, FORMAT AND EDIT PARAGRAPHS and LINES Insert New Paragraph button - Inserts new paragraph. <tool name="insertparagraph" /> Paragraph Style Dropdown button - Applies standard text styles to selected text. Indent button - Indents paragraphs to the right. Outdent button - Indents paragraphs to the left. Align Left button - Aligns the selected paragraph to the left. Center button - Aligns the selected paragraph to the center. <tool name="formatblock"/> <tool name="indent" /> <tool name="outdent" /> <tool name="justifyleft" /> <tool name="justifycenter" /> Align Right button - Aligns the selected paragraph to the right. Justify button - Justifies the selected paragraph. Justify None Button - Removes the alignment Bulleted List button - Creates a bulleted list from the selection. Numbered List button - Creates a numbered list from the selection. <tool name="justifyright" /> <tool name="justifyfull" /> <tool name="justifynone" /> <tool name="insertunorderedlist" /> <tool name="insertorderedlist" /> Insert horizontal line (e.g. horizontal ruler) button - Inserts a horizontal line at the cursor position. <tool name="inserthorizontalrule" /> CREATE, FORMAT AND EDIT TEXT, FONT and LISTS Bold button - Applies bold formatting to selected text. <tool name="bold" shortcut="ctrl+b"/> Italic button - Applies italic formatting to selected text. Underline button - Applies underline formatting to selected text. <tool name="italic" shortcut="ctrl+i"/> <tool name="underline" shortcut="ctrl+u"/> 26

27 Icon Description ToolsFile Declaration Strikethrough button - Applies strikethrough formatting to selected text. Superscript button - Makes a text superscript. Subscript button - Makes a text subscript. Font Select button - Sets the font typeface. Font Size button - Sets the font size. <tool name="strikethrough" /> <tool name="superscript" /> <tool name="subscript" /> <tool name="fontname"/> <tool name="fontsize"/> Text Color (foreground) button - Changes the foreground color of the selected text. Text Color (background) button - Changes the background color of the selected text. <tool name="forecolor"/> <tool name="backcolor"/> Format code block dialog tool. <tool name="formatcodeblock" /> Custom Styles drop down - Applies custom, predefined styles to the selected text. Custom Links drop down - Inserts custom, predefined link. Separate the tools icons on the toolbar <tool name="applyclass"/> <tool name="insertcustomlink"/> <tool separator="true" /> IMPORTANT! After making changes to client-side files such ass javascript files (.js) or stylesheet files (.css), you need to clear your browser s cache before the changes take effect. After making changes to server-side files such as.ascx, xml,.aspx) you may not see changes take effect until you do an iisreset. 27

28 Customize "Custom Links" drop-down Purpose The "custom links" drop-down contains a pre-defined list of internal/external links. This list can be modified to hold your required list of links. Guidelines Locate the <links> node in ToolsFile.xml file. Every displayed link in the "Custom Links" drop-down is represented by a <link> node below the <links> container. Update <link> nodes according to the links you want to appear in the drop-down. Example: If we want the drop-down list to hold the following links: We should edit the <links> node as follows: <links> <link name="search engines" > <link name="google" href=" /> <link name="microsoft Live" href=" /> <link name="yahoo" href=" /> </link> </links> IMPORTANT! After making changes to client-side files such ass javascript files (.js) or stylesheet files (.css), you need to clear your browser s cache before the changes take effect. After making changes to server-side files such as.ascx, xml,.aspx) you may not see changes take effect until you do an iisreset. 28

29 Customize "Wiki markup" drop-down Purpose The "Wiki markup" drop-down contains a pre-defined list of wiki markup scripts (instead of typing the markup you can select a command from this list). You can further enhance this list with additional commands. Guidelines Locate the <tool name="wikimarkup" /> node in ToolsFile.xml file. Every <item> node below contains a displayed caption and a text that will be inserted into the editor once this command is selected. Update existing <item> nodes or add new ones. Example: In wiki markup, the text " TOC " in interpreted as "Display table of contents" by the wiki editor in view mode. The following <item> node defines this command to appear in the "wiki markup" drop-down: <tool name="wikimarkup" showtext="true" type="dropdown" dropdownwidth="200px"> <item name="show Table of Content" value=" TOC "/> <item name="hide Table of Content" value=" NOTOC " /> <item name="hide Edit Section" value=" NOEDITSECTION " /> <item name="hide TOC Numeration" value=" NOTOCNUMBERS " /> <item name="show History Breadcrumbs" value="[[breadcrumbs 4]]" /> </tool> IMPORTANT! 29

30 After making changes to client-side files such ass javascript files (.js) or stylesheet files (.css), you need to clear your browser s cache before the changes take effect. After making changes to server-side files such as.ascx, xml,.aspx) you may not see changes take effect until you do an iisreset. 30

31 Customize "Paragraph Style" drop-down Purpose The "Paragraph Style" drop-down (the drop-down) contains a pre-defined list of paragraph styles that can be applied to selected text. You can further enhance this list with additional styles. Guidelines Locate the <paragraphs> node in ToolsFile.xml file. Add a <paragraph> node for every paragraph style you want to appear in this drop-down. The <paragraph> node should include a caption (that will be displayed in the drop-down) and a valid style name (which is defined in MOSS/Wiki Plus stylesheet files). Example: The following <paragraph> node defines a "Heading 3" entry that will apply the <H3> style: <paragraph name="<h3>heading 3</H3>" value="<h3>" /> IMPORTANT! After making changes to client-side files such ass javascript files (.js) or stylesheet files (.css), you need to clear your browser s cache before the changes take effect. After making changes to server-side files such as.ascx, xml,.aspx) you may not see changes take effect until you do an iisreset. 31

32 Customize "Content Snippets" drop-down Purpose The "Content snippets" drop-down (the drop-down) contains a predefined list of html snippets (pieces of rich text that are inserted into the editor when you click a snippet in this drop-down). You can further enhance this list with additional shared content snippets. Guidelines Locate the <snippets> node in ToolsFile.xml file. Update or add <snippet> nodes below the <snippets> container node. Example: The following <snippet> node will display a "Problem Report Feedback" caption in the snippets drop-down list. When a user clicks that item, the following text will be inserted into the editing area: Hi, Thank you for reporting this issue. We have verified the problem and it is logged in our system. We will notify you once we have a solution. Please, contact us if you have any problems. <snippet name="problem Report Feedback"> <![CDATA[ <div style="width:300px;border:2px outset #D8D2BD;padding:34px;fontfamily:Arial, Verdana; font-size:11px;background-color:#f1efe6;"> Hi,<br /> Thank you for reporting this issue. We have verified the problem and it is logged in our system. We will notify you once we have a solution. <br /><br /> <b>please, contact us if you have any problems.</b> </div> ]]> </snippet> IMPORTANT! After making changes to client-side files such ass javascript files 32

33 (.js) or stylesheet files (.css), you need to clear your browser s cache before the changes take effect. After making changes to server-side files such as.ascx, xml,.aspx) you may not see changes take effect until you do an iisreset. 33

34 Change the editor's default content styles Purpose The wiki Plus editor enables you to apply a paragraph style (such as Heading1, Heading 2, Normal etc.) on a selected text. You may want to change the style definition of these styles to match your portal styles. Guidelines You can easily change these paragraph style definitions by adding them to KWizCom_WikiPlus.css file in C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\template\layouts\kwizcom_wikiplus folder. In SharePoint 2010 the file is located in TEMPLATE\LAYOUTS\KWizCom_Wikiplus\css. Example: If we want to change the Heading 1 style, we should add the following to the KWizCom_WikiPlus.css file: H1 {[Enter you style definition here]} IMPORTANT! After making changes to client-side files such ass javascript files (.js) or stylesheet files (.css), you need to clear your browser s cache before the changes take effect. After making changes to server-side files such as.ascx, xml,.aspx) you may not see changes take effect until you do an iisreset. 34

35 Customize Emoticons Purpose The WikiPlus editor includes an emoticon icon which allows you to add emoticons on your wiki page. You may want to add or remove the emoticons, create your own collection. Guidelines To add a new emoticon: 1. Go to your portal site ( 2. Click on Site Actions > View All Site Content: 3. Click on WikiPlus Emoticons library 4. Upload your new emoticon icon by clicking on Upload 5. After uploading, you will be returned to the library. Find your added emoticon icon, click on the arrow next to it (on mouse over) and choose Edit Properties 35

36 6. In edit mode fill in the Title field: (The title will be an alternative text for the emoticon. For example, inserting the following text: :) will show a smiley.) Once the changes are complete, the your editor will be updated after 10 minutes since the emoticons are cached for performance reasons. 36

37 Additional customizations Change the file size limit for upload Purpose The Wiki Plus editor includes a pre-defined uploaded file size (limits the file size of uploaded images/attached documents). The default maximum file size that you can upload is 4096kB. You may want to change this file size limit. Each manager has a property which determines the maximum upload sized allowed. Guidelines Open ConfigFile.xml file located in "C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\template\layouts\kwizcom_wikiplus\radcontrols \Editor" folder on your SharePoint server. (In SharePoint 2010 the path is 14\TEMPLATE\LAYOUTS\KWizCom_Wikiplus\RadControls\Editor) Modify or add the appropriate property for the manager 1. Image Manager: <property name="maximagesize">[file size in bytes]</property 2. Flash Manager: <property name="maxflashsize">[file size in bytes]</property> 3. Media Manager: <property name="maxmediasize">[file size in bytes]</property> 4. Document Manager: <property name="maxdocumentsize">[file size in bytes]</property> 5. Visio Manager: <property name="maxvisiosize">[file size in bytes]</property> IMPORTANT! After making changes to client-side files such ass javascript files (.js) or stylesheet files (.css), you need to clear your browser s cache before the changes take effect. After making changes to server-side files such as.ascx, xml,.aspx) you may not see changes take effect until you do an iisreset. 37

38 Wiki Plus localization Purpose You may need to localize Wiki Plus to your requested language. Guidelines All Wiki Plus strings are stored in.net resource files (.resx). The following steps are needed to localize Wiki Plus: Localize the Tagging feature please review the Tagging feature manual: tsubnodeid=522 Localize the Rating solution please review the Rating solution manual: tsubnodeid=687 Localize Wiki Plus There are 11 resource files that must be localized in order for WikiPlus to be fully localized. 1. Wikiplus.resx 2. RadEditor.Dialogs.resx 3. RadEditor.Main.resx 4. RadEditor.Modules.resx 5. RadEditor.Tools.resx 6. RadListBox.resx 7. RadProgressArea.resx 8. RadScheduler.Main.resx 9. RadSpell.Dialog.resx 10. RadUpload.resx 11. wikiplus.resx Steps 1. Copy all these files from folder Program Files\Common Files\Microsoft Shared\web server extensions\12\resources 38

39 (In SharePoint 2010 the files are located in 14\TEMPLATE\LAYOUTS\KWizCom_WikiPlus\Resources) 2. Rename the copied files to include your desired language name. For example: wikiplus.en-us.resx for USA English 3. Translate the all strings in the renamed files 4. Copy the files to 12\TEMPLATE\Resources (14\TEMPLATE\Resources) 12\TEMPLATE\CONFIG\Resources (14\TEMPLATE\CONFIG\Resources) 5. Run the following command Stsadm o copyappbincontent 6. Recycle the application pools for the targeted applications or perform an iisreset. 39

40 Technical Support Technical support may be obtained by using any of the following methods: The KWizCom Web site The KWizCom website at contains the most updated valuable information, including: Answers to frequently asked questions (FAQ's) about our products usability and technical questions. Product updates, which provide you with bug fixes and new features. The Web Form For technical support through the Internet, please fill in our support web form on our web site For more information on technical support, please review our support programs page. 40