Introduction

 Once you have installed iKnowBase, you'll want to start building your first site. Let's say that you want to have three public pages ("Domestic", "International", and "Sport"). You want to display Articles on generic "section" pages along with "Read More" links that display the full article text on a separate "content" page. Also, the right column of the layout should display all the latest articles, regardless of section. All the pages should have a width of 800 pixels.

Instead of using the bundled xNet components, let's see how we can build a web site from scratch - this will make it easier to understand how things are connected.

In short, these are the steps:

  1. Define Metadata
  2. Create Page Group MFIKBS
  3. Create Page Elements Page Top, Page Bottom, and Page Menu
  4. Create HTML Templates MFIKBS_FORM and MFIKBS_PAGE
  5. Create Page Template MFIKBS_PAGE
  6. Create Pages Domestic, International, and Sport
  7. Create iKnowBase Elements (targets, menu, form, quick links, presentation styles, shared viewers)
  8. Start using the site

Defining Metadata

  1. Create Dimension type MFIKBS_sectionType
  2. Create Dimension MFIKBS_sectionDim with subdimensions (each with Dimension type MFIKBS_sectionType):
  3. Create Attribute MFIKBS_section:
  4. Create Attribute MFIKBS_section:
  5. Create Information type MFIKBS_article with the following Attributes:

Creating Page Group
  1. Create a Page Group with Name MFIKBS and Display Name My First IKB Site

Creating Page Elements

 Some areas of the pages will contain static HTML. To avoid having the same HTML stored in multiple locations across the portal, we'll create Navigation Pages that will be available as portlets under Portlet Repository > Published Portal Content > your_page_group.
  1. Create a Navigation Page with Name MFIKBS_top and Display Name Page Top and insert an HTML Portlet with the following content: 
    <table cellspacing="0" cellpadding="10" width="100%" bgcolor="#999999"><tr><td>
<font class="PortletHeaderText">My First IKB Site's Amazing Banner</font>
</td></tr></table>
  2. Create a Navigation Page with Name MFIKBS_bottom and Display Name Page Bottom and insert an HTML Portlet with the following content: 
    <table cellspacing="0" cellpadding="10" width="100%" bgcolor="#999999"><tr><td>
<font class="PortletHeaderText">Our motto is <i>Productivity with Choice</i></font>
</td></tr></table>
  3. Create a Menu with Name MFIKBS_menu and Display Name Page Menu (we'll add and configure a menu portlet on this page once the Pages have been created)

Creating HTML Templates
  1. Create a CSS file called mfikbs.css (containing font classes MFIKBS_title and MFIKBS_lead) and copy it to a folder called css under the DocumentRoot of your Portal Middle-Tier (e.g. C:\ora101202mt\Apache\Apache\htdocs\css)

  2. Create an HTML Template with Name MFIKBS_PAGE and the following Template Definition: 
    <html>
<head>
<title>iKnowBase - #TITLE#</title>
#PAGE.STYLE#
<ORACLE>
begin
	ikb.ikb_portal_functions.initialize_from_ui(portal.wwpro_api_parameters.retrieve, '#PAGE.STYLE#');
	ikb.ikb_portal_api.generate_common_jsscript;
end;
</ORACLE>
<link rel="stylesheet" href="/css/mfikbs.css" type="text/css">
</head>
<body>
<center><table width=800><tr><td>
#BODY#
</td></tr></table></center>
</body>
</html>

  3. Create an HTML Template with Name MFIKBS_FORM and the following Template Definition: 
    <html>
<head>
<title>iKnowBase - #TITLE#</title>
<ORACLE>
begin
	ikb.ikb_portal_functions.initialize_from_ui(portal.wwpro_api_parameters.retrieve, '#PAGE.STYLE#');
	ikb.ikb_portal_api.generate_common_jsscript;
end;
</ORACLE>
</head>
<body>
<center><table width=800><tr><td>
#BODY#
</td></tr></table></center>
</body>
</html>

Creating Page Template

 To minimize administration overhead, we'll base all Portal Pages on a Page Template.

  1. In Page Group MFIKBS, create a Page Template with Name MFIKBS_PAGE and organize it with the regions shown here:

    Connect the Page Template to the HTML Page Skin MFIKBS_PAGE (found on the Optional tab in the Properties form)

 
Portlet "Page Top"
Portlet "Page Menu"
(100 pixels)		 iKnowBase Viewer
(550 pixels)		 Portlet "10 Latest Articles"
(150 pixels)
Portlet "Page Bottom"
 

Creating Pages

  1. Create the following Pages in the MFIKBS Page Group based on the MFIKBS_PAGE Page Template:

  2. Create a page called MFIKBS_form based on the HTML Template MFIKBS_FORM and include the "Run Form" portlet

Creating iKnowBase Elements
  1. Create Target MFIKBS_form:

  2. Create Menu MFIKBS_menu with menu items pointing to the Portal pages MFIKBS_domestic, MFIKBS_international, and MFIKBS_sport
    Please note:

  3. Create Form MFIKBS_article:

  4. Create Quick link MFIKBS_article:

  5. Create Presentation style (Free form) MFIKBS_section:

  6. Create Presentation style (Free form) MFIKBS_content:

  7. Create Presentation style (Free form) MFIKBS_last:

  8. Create Target MFIKBS_goto_content:

  9. Create Shared Viewer MFIKBS_last:

  10. Create Shared Viewer MFIKBS_domestic:

  11. Copy Shared Viewer MFIKBS_domestic to MFIKBS_international and MFIKBS_sport and adjust parameter "MFIKBS_section within this dimension ..."

  12. Create Shared Viewer MFIKBS_show_content:

Connecting the Elements
  1. Add portlet "Advanced menu" (Portlet Repository > Portlet Staging Area > iKnowBase - Menu Tools (IKB)) to the Navigation Page MFIKBS_menu and configure:

  2. Add portlet "iKnowBase Viewer" (Portlet Repository > Portlet Staging Area > iKnowBase - Content Tools (IKB)) in the right region of Portal Template MFIBKS_page and choose Shared Viewer MFIKBS_last

  3. Add portlet "iKnowBase Viewer" (Portlet Repository > Portlet Staging Area > iKnowBase - Content Tools (IKB)) in the middle region of Portal Page MFIBKS_content and choose Shared Viewer MFIKBS_show_content

  4. Add portlet "iKnowBase Viewer" (Portlet Repository > Portlet Staging Area > iKnowBase - Content Tools (IKB)) in the middle region of Portal Pages MFIBKS_domestic, MFIBKS_international, and MFIBKS_sport and choose Shared Viewer with the same name as the Portal Page

Start using the site
  1. Go to http://donald.disney.com/portal/page/portal/MFIKBS/MFIKBS_domestic
  2. Click on the "Add new article" link