Layout Options

v1.5 Documentation

These reference documents are designed to help you when things don't go as planned. The individual screen type documents are useful for looking up available JSON properties.

How To's

Change Log

How it Works

Design Considerations

Data URL's and Merge Fields

Global Theme

Tabs, Layout

Screens, Menus, Features

Menus

Content Screens

Settings Screens

Splash Screens

Other Actions

About Right Side Nav Buttons

Screens, Menus, Features

Every mobile app is a collection of screens, menus, and features. Menus can lead to other menus allowing for an unlimited amount of navigational depth. The best applications are easy to navigate and offer end-users efficient ways to reach content and features within the app.

The apps configuration file lists each screen, menu, or feature in an organized, plain-text structure. Each item in this list has an "item type" and this item type is what describes that screen or features behavior. Item types are things like BT_screen_call, BT_screen_images, BT_screen_splash and so on.

Screen Types

This list represents the standard types of screens and features available in the buzztouch control panel. Each screen, menu, or feature is customized using individual properties. If one of the standard buzztouch screens is not appropriate, custom plug-ins are used to extend the functionality even further.

Menu Screens
Menu List	"itemType":"BT_screen_menuList" This navigational screen is used to display a list of choices. Choosing an item in the list loads a new screen or menu or feature.
Menu Buttons	"itemType":"BT_screen_menuButtons" This navigational screen is used to display a list of buttons. Choosing an item in the list loads a new screen or menu or feature.
Menu Search	"itemType":"BT_screen_menuSearch" This screen allows users to search for other screens within the application. Choosing an item in the list loads that screen or feature.
Content Screens
Multiple Choice Quiz	"itemType":"BT_screen_quiz" This screen is used to create a quiz. Quizzes can be fun, educational, entertaining, or enlightenting.
Custom URL, Webpage	"itemType":"BT_screen_webView" This screen is used to display a web page. For best results, only include web-pages optimized for mobile devices.
Custom HTML, TEXT	"itemType":"BT_screen_customHTML" This screen is used to display HTML or TEXT content. This is similiar to a Custom URL page differs in that the control panel is used to create the HTML instead of pointing to a web-page online.
YouTube™ Video	"itemType":"BT_screen_webView" This screen behaves exactly like a Custom URL page. It's listed in the control panel because it's a popular option.
HTML Document	"itemType":"BT_screen_webView" This screen is used to display an HTML document that is included in the Xcode or Eclipse project, or hosted online.
PDF™ Document	"itemType":"BT_screen_webView" This screen is used to display an PDF™ document that is included in the Xcode or Eclipse project, or hosted online.
Word™ Document	"itemType":"BT_screen_webView" This screen is used to display an Word™ document that is included in the Xcode or Eclipse project, or hosted online.
Excel™ Document	"itemType":"BT_screen_webView" This screen is used to display an Excel™ document that is included in the Xcode or Eclipse project, or hosted online.
PowerPoint™ Document	"itemType":"BT_screen_webView" This screen is used to display an PowerPoint™ document that is included in the Xcode or Eclipse project, or hosted online.
Location Map	"itemType":"BT_screen_map" This screen is used to display a location map. Maps can have multiple locaitons. Selecting an item on the map can load another screen or show driving directions. Locations can be included in the Xcode or Eclipse project or can come from a remote file.
RSS Feed	"itemType":"BT_screen_rssReader" This screen is used to display a list of RSS stories from a remote URL. Selecting an item loads the story in a BT_screen_webView.
Image Gallery	"itemType":"BT_screen_images" This screen is used to display a list of images. Images can be included in the Xcode or Eclipse project or come from a remote file.
Image Uploader	"itemType":"BT_screen_imageUpload" This screen is used to allow users to upload images to your website or your buzztouch control panel. Users can take a new image or select an existing image from their gallery.
Image Emailer	"itemType":"BT_screen_imageEmail" This screen allows end users to send an email to a pre-configured address.
Streaming Audio	"itemType":"BT_screen_audio" This screen is used to play streaming audio. The audio file be included in the Xcode or Eclipse project or it can come from a remote location.
Streaming Video	"itemType":"BT_screen_video" This screen is used to play streaming video. The video file be included in the Xcode or Eclipse project or it can come from a remote location.
Settings Screens
Show Device Info	"itemType":"BT_screen_settingsDevice" This screen is used to display important information about the device such as it's ability to take videos or report it's location.
Allow / Prevent GPS	"itemType":"BT_screen_settingsLocation" This screen is used to allow end users to opt-out of location reporting features and prevent their device from turning on the GPS.
Login Screen	"itemType":"BT_screen_settingsLogIn" This screen is used to allow end users to log into the app. All screens and features can be login protected.
Splash Screens
Image Splash Screen	"itemType":"BT_screen_splash" This screen is used to introduce the application. Multiple options are used to control the screens animation.
Other Actions and Features
Launch a Native App	"itemType":"BT_screen_launchNativeApp" This feature is used to launch other native applications on the device such as the music player.
Share via Facebook™	"itemType":"BT_screen_shareFacebook" This screen is used to allow end users to post to their Facebook™ walls. It can be configured with a standard message.
Share via Twitter™	"itemType":"BT_screen_shareTwitter" This screen is used to allow end users to post tweets from within the app. It can be pre-configured with a standard message.
Share via Email	"itemType":"BT_screen_shareEmail" This feature is used to launch the devices native email compose sheet showing a pre-configured message. Users send to an email address they enter or choose from their list of contacts.
Share via Text (SMS)	"itemType":"BT_screen_shareSms" This feature is used to launch the devices native Text Message compose sheet showing a pre-configured message. Users send to a phone number of they enter or choose from their list of contacts.
Email Us	"itemType":"BT_screen_email" This feature is used to launch the devices native email compose sheet with a pre-configured email address and message.
Call Us	"itemType":"BT_screen_call" This feature is used to launch the devices native dialer with a pre-configured telephone number.
Text Us (SMS)	"itemType":"BT_screen_sms" This feature is used to launch the devices native Text Message compose sheet showing a pre-configured number and message.
Custom Plug-in	"itemType":"BT_screen_plugIn" This feature allows you to load a custom UIViewController (iOS) or a custom Activity (Android) that you create or somebody else creates for you. Refer to the plugin documents for details about it's configuration options.