custom layouts+howto

Different sets of Wagn cards can have different layouts. By default, new Wagns have one layout, specified by *all+*layout:

*all+*layout

bruce layout

A layout setting card points to an HTML card that specifies the layout for the relevant set — so to add a layout just for User cards, you'd add their +*layout setting, pointing to a new HTML card that you would create. In the case of *all shown above, it points to a card called Default Layout, which looks like this:

<!DOCTYPE HTML>
<html>
  <head>
    {{*head}}
  </head>
  
  <body id="wagn">
    <div id="menu">
      [[/ | Home]]   [[/recent | Recent]]   {{*navbox}} {{*account links}}
    </div>
    
    <div id="primary">
      {{_main}}
    </div>
    
    <div id="secondary">
      <div id="logo">[[/ | {{*logo}}]]</div>
      {{*sidebar}}
      <div id="credit">Wheeled by [[http://www.wagn.org|Wagn]] v. {{*version}}</div>
      {{*alerts}}
    </div>
    
    {{*foot}}
  </body>
</html>

Notice how the only special syntax on the card is already very familiar stuff: inclusions.

Some of these inclusions, like {{*logo}} and {{*sidebar}} work just like any normal inclusion -- it simply includes those cards. Others are special, uneditable, dynamic "virtual" cards, which appear differently depending on context. If you click on them, however, you see they, too, largely behave like normal cards:

*head -- this one's invisible but very important for proper javascript functioning.
*navbox, *account links -- both of these appear in the default Wagn header.
*version -- Wagn release number.

Last but not least is the {{_main}} inclusion, which determines where the "main" card of the page will be. For example, if you click Support Ticket, then "Support Ticket" is the main card on the page, and {{_main}} determines where on the page that will appear.

Note: the default view for cards included anywhere outside the main card is core, rather than the usual content.

custom layouts+howto

wagneers

developers

wagn.org