Custom Page Activity

The Custom Page activity allows you to easily create stylish pages with text and graphics. It's perfect for creating pages like 'About Us', 'Biography', 'Contact Information' etc.

Adding a Custom Page Activity

To add a Custom Page activity to your project: start editing your project and go to the Activities tab. Under 'Your App Activities' click the + Add an Activity button and select Custom Page from the list.

Settings

The Custom Page activity has the following settings.

Activity Name
The name that you want to give your activity. This will appear on the dashboard, toolbar, and navigation drawer. This can be whatever you want but should probably describe the page that you will be displaying. For example 'About Us', 'Biography', or 'Contact Information'.

Subtitle
A few words describing this activity. This subtitle text may be displayed on the dashboard if the dashboard's item style supports it.

Description
A longer paragraph describing this activity. This description text may be displayed on the dashboard if the dashboard's item style supports it.

Position
This is a relative index that controls the order of the activities in your application. The position will effect where your activity is displayed on the dashboard and navigation drawer. For more information on this setting please read: How to change the order of the icons on the dashboard.

Build this activity (include it in the app)
Whether or not this activity will be included in the app. This may be useful if you're creating different versions of your app that you want to contain different content.

Hide this activity (don't list it on any dashboards or navigation drawer)
When selected, this activity won't show on the dashboard or the navigation drawer. You can still access this activity from an HTML-based activity using it's Activity URL. For more information, refer to the topic Linking to Another Activity.

Theme

The Theme setting allows you to inherit theme settings from the global theme, parent theme, or override the theme settings for the activity. See the Activity Theme topic for descriptions of these settings.

Images

The Images section allows you to provide the images to show on the activity and those that will be used to represent it on it's parent dashboard and navigation drawer. See the Activity Images topic for descriptions of these settings.

Toolbar

The Toolbar setting allows you to inherit the toolbar settings from the global toolbar, parent toolbar, or override the toolbar settings for the activity. See the Activity Toolbar topic for descriptions of these settings.

Details

This area contains an HTML editor that allows you to create formatted text that can include graphics, links etc. Simply choose the desired format or style, and start typing! Explore the editor menu for a wide variety of available options. You can press the "Source" button in the editor menu to view or edit the raw HTML source text if needed.

Orientation
This setting allows you to force the activity to stay in a particular orientation. Leave this on 'Automatic' unless you absolutely need to lock the display orientation for some reason (like games etc.).

• Automatic - Switch orientations automatically (the normal behavior).
• Landscape - Lock this activity in landscape orientation.
• Portrait - Lock this activity in portrait orientation.

Enable Geolocation permissions
You can enable this option if the page needs access to HTML5 Geolocation features. When this feature is enabled, the appropriate permissions will be added to the app requesting access to their location.

Open links in external browser
You can enable this option to open external links outside of the app, within the default browser.

Activity URL

The unique reference URL for this activity that can be used for linking to it. For an example of it's usage, refer to the topic Linking to Another Activity .

Linking to Another Activity
The Custom Page activity also allows you to open another activity from a link using the special URL format:

andromo://<<internal-activity-identifier>>

Each activity contains an internal unique identifier that can be referenced for opening it. You can find each activity's reference URL in the the section labelled "Activity URL" located below the activity's Example Screenshot. Each activity's settings can be accessed from the "Activities" tab, by clicking the desired activity name or icon, or by selecting "Edit" from its Action drop-down list. It will appear as a value such as:

where "custompage968701" is the internal identifier for that particular activity. This value will be different for each activity in your project.

As an HTML hyperlink, this would be formatted as:

<a href="andromo://custompage968701">Visit Our Custom Page</a>

You can view the Custom Page's HTML source by clicking the "Source" button in the editor.

If you'd like to open the dashboard, you can specify the following:

andromo://dashboard

As an HTML hyperlink, this would be formatted as:

<a href="andromo://dashboard">Go Home</a>