History of TopBarTutorial

Differences from version 4 to 8



@@ -1,8 +1,45 @@

+The ((layout)) of pages in bitweaver follows a typical pattern, where a top or head block spans whole the first row and then one, two or three columns of content are presented below. In the file structure, the top block is called __top_bar.tpl__ and it is frequently the first thing changed when customizing a bitweaver site. This page will explain how to change elements in the top bar both from within the CMS' admin panels and manually by changing the template (tpl) file.
+
+||__::Top Bar::__
+::Left Column:: |::Centre Column::|::Right Column::
+::Bottom Bar::
+::Bottom bar 2?::||
+
 {maketoc}
-! Version 1.0.2
-since version 1.0.2 nexus provides the possibility to pre / append or replace the bitweaver top menu bar. this means that this tutorial is only for users with version 1.0.1 or below...
 
-! Where does the top bar come from?
+!!Elements of the top bar.
+In the default ((theme)) that bitweaver installs with, the top bar includes
+*a pre-title header (small font)
+*a logo, followed by the name of the site.
+*a slogan (optional) in small font beneath the site name.
+*a login field, justified right.
+*a css driven horizontal menu (suckerfish)
+
+All of the above can be modified within the admin menus without changing the tpl file manually.
+
+*to change the header and the site name goto Admin-->Kernel-->Server Settings-->Page Settings "Site Title" and "Site Slogan"
+*to change the site name in the horizontal menu goto Admin-->Kernel-->General Settings-->Miscellaneous "Menu Title"
+*to change the menu items goto Nexus-->Menus--> Create/Edit menus - here you will have to create a new menu and prepend, append or replace the existing horizontal suckerfish menu (all the other menus apply to something else)
+
+!!Where does the Title, Slogan, and User Greeting come from?
+the top is controlled by this template:
+{code source=php}
+kernel/templates/top.tpl
+{code}
+
+for your own convenience, copy the file to your own theme directory
+{code source=php}
+themes/styles/<style>/kernel/top.tpl
+{code}
+any changes found in this file will override the original file.
+
+!Editing the Top file
+Under the Div id bittop, is a new DIV, holding the user greeting.
+When that Div finishes the Site Header H1 kicks in, followed by the Site slogan, H3.
+Removing everything between the opening and closing DIV tags will result in an empty header bar. This may be preferable if you have a fancy image / flash you want to insert. Just remember that such things are not indexed by search engines.
+
+
+!!Where does the top bar come from?
 the top bar is controlled by this template:
 {code source=php}
 kernel/templates/top_bar.tpl

@@ -15,7 +52,7 @@

 
 any changes found in this file will override the original file. this way you keep the original file and make upgrading easier. for more information see ThemeTutorial.
 
-! Editing the top bar file
+!!Editing the top bar file
 now that you have the file there, you can open in with any text editor. for your own convenience, we will maintain the original menu when you are logged in as admin but regular users will only see the custom menu.
 
 after <div id="bittopbar"> insert:

@@ -53,23 +90,23 @@

 !! Custom Menu
 the custom menu is a simple XHTML unordered list with a few classes set for the links and looks something like this:
 {code()}
-<ul id="nav" class="menu hor">
+<ul id="nav">
  <li>
- <a class="head" href="/link/to/page">Foo</a>
+ <a href="/link/to/page">Foo</a>
  <ul>
- <li><a class="item" href="/link/to/page">Pile</a></li>
- <li><a class="item" href="/link/to/page">Of</a></li>
- <li><a class="item" href="/link/to/page">Foo</a></li>
+ <li><a href="/link/to/page">Pile</a></li>
+ <li><a href="/link/to/page">Of</a></li>
+ <li><a href="/link/to/page">Foo</a></li>
  </ul>
  </li>
 
  <li>
- <a class="head" href="/link/to/page">Bar</a>
+ <a href="/link/to/page">Bar</a>
  <ul>
- <li><a class="item" href="/link/to/page">Another</a></li>
- <li><a class="item" href="/link/to/page">Pile</a></li>
- <li><a class="item" href="/link/to/page">Of</a></li>
- <li><a class="item" href="/link/to/page">Foo</a></li>
+ <li><a href="/link/to/page">Another</a></li>
+ <li><a href="/link/to/page">Pile</a></li>
+ <li><a href="/link/to/page">Of</a></li>
+ <li><a href="/link/to/page">Foo</a></li>
  </ul>
  </li>
 </ul>

@@ -82,13 +119,13 @@

 {* this link is for textbrowsers *}
 <div id="bittopbar">
 {if $gBitUser->isAdmin()}
- <a style="display:none;position:absolute;top:0px;left:0px;" href="#top">{tr}go to top{/tr}</a>
- <ul id="nav" class="menu hor">
- <li class="m-home"><a class="item" href="{$gBitLoc.BIT_ROOT_URL}">{tr}{$siteTitle|default:"Home"}{/tr}</a></li>
+ <a href="#top">{tr}go to top{/tr}</a>
+ <ul id="nav">
+ <li><a href="{$gBitLoc.BIT_ROOT_URL}">{tr}{$siteTitle|default:"Home"}{/tr}</a></li>
  {foreach key=key item=menu from=$appMenu}
  {if $menu.title && $menu.titleUrl && $menu.template}
- <li class="m-{$key}{if $gBitLoc.ACTIVE_PACKAGE eq $menu.adminPanel} current{/if}">
- <a class="{if $gBitSystemPrefs.feature_top_bar_dropdown eq 'y'}head{else}item{/if}{if $gBitLoc.ACTIVE_PACKAGE eq $menu.adminPanel} selected{/if}" href="{$menu.titleUrl}">{tr}{$menu.title}{/tr}</a>
+ <li>
+ <a href="{$menu.titleUrl}">{tr}{$menu.title}{/tr}</a>
  {if $gBitSystemPrefs.feature_top_bar_dropdown eq 'y'}
  { include file="`$menu.template`"}
  {/if}

@@ -96,18 +133,18 @@

  {/if}
  {/foreach}
  {if $gBitUser->isAdmin()}
- <li class="m-admin{if $gBitLoc.ACTIVE_PACKAGE eq 'kernel'} current{/if}">
- <a class="{if $gBitSystemPrefs.feature_top_bar_dropdown eq 'y'}head{else}item{/if}{if $gBitLoc.ACTIVE_PACKAGE eq 'kernel'} selected{/if}" href="{$gBitLoc.KERNEL_PKG_URL}admin/index.php">{tr}Administration{/tr}</a>
+ <li>
+ <a href="{$gBitLoc.KERNEL_PKG_URL}admin/index.php">{tr}Administration{/tr}</a>
  {if $gBitSystemPrefs.feature_top_bar_dropdown eq 'y'}
  <ul>
  {foreach key=key item=menu from=$adminMenu}
  <li>
- <a class="head" href="{$gBitLoc.KERNEL_PKG_URL}admin/index.php">{tr}{$key|capitalize}{/tr}</a>
+ <a href="{$gBitLoc.KERNEL_PKG_URL}admin/index.php">{tr}{$key|capitalize}{/tr}</a>
  { include file=`$menu.tpl`}
  </li>
  {/foreach}
  <li>
- <a class="head" href="{$gBitLoc.KERNEL_PKG_URL}admin/index.php">{tr}Layout and Design{/tr}</a>
+ <a href="{$gBitLoc.KERNEL_PKG_URL}admin/index.php">{tr}Layout and Design{/tr}</a>
  { include file="bitpackage:kernel/menu_layout_admin.tpl"}
  </li>
  </ul>

@@ -115,26 +152,26 @@

  </li>
  {/if}
  </ul>
- <div class="clear"></div>
- <a style="padding:0;margin:0;border:0;" name="top"></a>
+ <div></div>
+ <a name="top"></a>
 {else}
- <ul id="nav" class="menu hor">
+ <ul id="nav">
  <li>
- <a class="head" href="/link/to/page">Foo</a>
+ <a href="/link/to/page">Foo</a>
  <ul>
- <li><a class="item" href="/link/to/page">Pile</a></li>
- <li><a class="item" href="/link/to/page">Of</a></li>
- <li><a class="item" href="/link/to/page">Foo</a></li>
+ <li><a href="/link/to/page">Pile</a></li>
+ <li><a href="/link/to/page">Of</a></li>
+ <li><a href="/link/to/page">Foo</a></li>
  </ul>
  </li>
 
  <li>
- <a class="head" href="/link/to/page">Bar</a>
+ <a href="/link/to/page">Bar</a>
  <ul>
- <li><a class="item" href="/link/to/page">Another</a></li>
- <li><a class="item" href="/link/to/page">Pile</a></li>
- <li><a class="item" href="/link/to/page">Of</a></li>
- <li><a class="item" href="/link/to/page">Foo</a></li>
+ <li><a href="/link/to/page">Another</a></li>
+ <li><a href="/link/to/page">Pile</a></li>
+ <li><a href="/link/to/page">Of</a></li>
+ <li><a href="/link/to/page">Foo</a></li>
  </ul>
  </li>
  </ul>
Page History
Date/CommentUserIPVersion
02 Jul 2008 (10:55 UTC)
fix up my mistake, add details for top.tpl
Combat Wombat118.90.77.1068
Current • Source
mlpvolt206.248.132.1096
View • Compare • Difference • Source
mlpvolt206.248.132.1095
View • Compare • Difference • Source
xing194.152.164.454
View • Compare • Difference • Source
xing194.152.164.453
View • Compare • Difference • Source
xing194.152.164.452
View • Compare • Difference • Source
xing194.152.164.451
View • Compare • Difference • Source