To add an app (in this example, the news app) to your site navigation structure, use the following steps. Note that the app has to be able to do so for this to work. See below for how to enable this in an app.

Adding News to the Site Navigation

1) Create a new web page with the ID something like 'news' and the title 'News' or whatever you want to call your news section.

Instead of creating a page body, leave that empty and click on the Properties tab. Under the External field there, enter '/index/news-app'.

When you're done that, set the page to public/approved under the state tab and save it.

2) Open the file inc/app/news/conf/properties.php. Set the news_name setting to the same thing as your page title, change any other settings you want for how your news section should behave, and near the bottom set the template, page_below and page_alias fields to match the page you made in step 1.

The page is a placeholder for the news app within your site hierarchy, and you've now told the news app about the placeholder page so that it will render breadcrumb-style menus accordingly inside the news app.

Enabling Placeholders For Your Apps

Open your app's inc/app/your_app/conf/properties.php file and add the following to it:

<?php

/**
 * Set this to the template you wish to use to display the app, otherwise
 * the default is used.
 */
appconf_set ('template', false);

/**
 * Set this to the page ID of the page you would like to be the parent of
 * the app.  This affects the web site navigation while within the
 * app itself, and the breadcrumb trail as well.
 */
appconf_set ('page_below', false);

/**
 * Set this to the ID of the page which is an alias of the app.
 */
appconf_set ('page_alias', false);

if ($context == 'action') {
    if (appconf ('page_below')) {
        page_below (appconf ('page_below'));
    }
    if (appconf ('page_alias')) {
        page_id (appconf ('page_alias'));
    }
    if (appconf ('template')) {
        page_template (appconf ('template'));
    }
}

?>

Now all people have to do is follow the steps outlined above and they can add your app to their site navigation.