Configuring Your Portal Settings

The Portal configuration affects the content areas available to the user, the presentation of Custom Pages, the navigation labels, the types of moderation required for different types of content, and the headers and footers on each page. To change the Portal configuration settings, go to the Settings tab of the Dashboard.

Portal Setup Tab


The Header section defines the information that displays at the top of your Portal pages.

  • Title The title of your Portal appears in the title bar.

  • Logo link URL The destination for your linked corporate logo; this is usually the home page for your company website.

Primary Navigation

Each line of the Primary Navigation section defines how and where each part of the Mashery-powered Portal appears in the top (tabbed) navigation. Selecting a type of content, such as Blog, enables that type of content and creates a navigation link. Select only the types of content that you will offer in your Portal.

  • Order Specify where the defined area displays in the Portal's horizontal navigation.
  • Link To Select the content type you want to display (Blog, Docs, Forum, Wiki, About, Custom). Multiple Custom Pages are allowed, and each must have a location specified in the Link column. All other content types are limited to a single instance.
  • Link Name The Link Name is the label for the primary navigation. For example, the blog content might be labeled News in the navigation. Keep Link Names short for best layout.
  • Link The link location for this content. Only the location for Custom Pages is editable. The link location reflects the file structure.

Tip: Start with defining a single content area, then add its content by using the Content navigation. After populating one content area, return to the Portal Configuration page to set up the next content area, then add its content.

The footer section defines the information that displays at the bottom of your Portal pages.

  • Copyright The copyright line appears at the bottom of each page, and can contain HTML (such as code for displaying the copyright symbol &copy).
  • Footer Links Above the copyright line, the footer links allow for navigation to custom pages related to your site. These links are normally used for static information such as the terms of service, privacy policy, contact information, and other corporate information. Use Custom Pages to conveniently display this type of information, defining the page's location by entering it in the Location box.

Custom JavaScript Source Inclusion

If you have any custom JavaScript files to include, specify them here.

Custom CSS

Mashery uses Cascading Style Sheets (CSS) to create a skin for your Portal, giving you complete control over look and feel. The structure and naming scheme of each page of the Portal is the same throughout the site, making global changes easy for your CSS expert. To change the presentation of your Portal, enter a location for your custom CSS file.

Caution: The Mashery team works with you to design your pages to integrate with your existing corporate website. Using custom CSS can have detrimental effects on your site's look and feel. Use custom CSS at your own risk.

The file cool-theme.css controls the skin of your Portal. You can download cool-theme.css from a link on the Settings page or from here. You can get started by modifying this file to suit your own branding, style and personality.

To give you an idea how the <DIV> sections are used, the following example shows the structure and order of the Blog page's layout.

<body id="page-(page name)" class="(state)">
<!-- PAGE --> <div id="page">
<!-- HEADER --> <div id="header" class="clearfix">
<div id="branding">
<div id="branding-logo"> </div>
<!-- /branding-logo -->
<div id="branding-tagline"> </div><!-- /branding-tagline -->
</div><!-- /branding -->
<div id="search"> </div><!-- /search -->
</div> <!-- /HEADER -->

<div id="user" class="clearfix">
<div id="user-auth"> </div><!-- /user-auth -->
<div id="user-main"> </div><!-- /user-main -->
<div id="user-nav"> </div><!-- /user-nav -->
</div><!-- /user -->
<div id="info" style="display: none;"> </div><!-- /info -->

<!-- CONTENT --> <div id="content" class="clearfix">
<!-- MAIN --> <div id="main"> </div><!-- /main -->
<!-- SUB --> <div id="sub"> </div><!-- /sub -->
<div id="breadcrumbs"> </div><!-- /breadcrumbs -->
<div id="local">
<li><a href="/index.php/wiki">Wiki</a></li>
<li class="active"><a href="/index.php/blog">Blog</a></li>
<li><a href="/index.php/forum">Forum</a></li>
<li><a href="/index.php/page/about">About</></li>
</div><!-- /local -->
</div><!-- /CONTENT -->
<div id="footer" class="clearfix">
<li><a href="/index.php/page/about">About</a></li>
<li><a href="/index.php/blog">Corporate Blog</a></li>
<li><a href="/index.php/page/contact">Contact Us</a></li>
<li><a href="/index.php/page/terms">Terms &amp; Conditions</a></li>
<!-- SITEINFO --> <div id="siteinfo" class="clearfix">
<p>&copy; 2007 Mashery, Inc.</p>
</div> <!-- /SITEINFO -->
</div><!-- /footer -->
</div><!-- /page -->

Custom Inline CSS

In addition to using CSS themes, inline CSS can be added to each file by including it here.

Moderation Tab

Several content types in your Portal allow Developers to post content themselves (such as a Forum post) or comment. You can establish Moderation Settings that define how content is posted to the Portal.

To set up Moderation:

  1. Log into your Mashery-powered Portal and go to the Dashboard.

  2. Click Settings and then Moderation.

  3. Define the Moderation Settings for each type of content and the action for that content type. Your choices are to allow posts by Developers to be posted without moderation, or for a member of your team to moderate Developer content. If content is moderated, it will not be posted until the moderator approves it. (See Monitoring User Comments and Forums.) For example, if you check Moderate for Wiki:Existing Pages:Edits and Allow for Wiki:Existing Pages:Annotations/comments, Developer edits to existing Wiki pages will not be published until the moderator approves them but comments will be posted immediately.