Designing Overview Pages and Place Pages
6. Click OK when you're finished. These changes won't take affect until you Save the changes you've made to the place
Setting Up Image Navigation
You can configure any Overview page, including the community Home page, with image-based navigation to quickly direct your users to useful pages. First, you'll add the Image Navigation Widget to your place's layout, then add images and links to the widget.
Add the Image Navigation Widget to Your Place's Layout
1. Go to the place you own and click Manage > Overview Page to begin editing the place's Overview page. (If you're editing the community's Home page, you'll click your avatar in the upper right corner, and then Manage > Overview Page).
2. From the widgets list, select Other > Image Navigation Widget.
3. Drag the widget down into your layout area and drop it where you want it.
4. Click the small triangle in the upper right corner of the widget and select Edit this widget.
5. Change the widget's title or leave that field blank if you do not want any title.
6. Select whether you want the header and border to be displayed.
7. Click Save Properties.
Add Images to the Widget
After you've added the Image Navigation Widget to your place's layout, you'll add images and links to the widget, then publish the updated layout of the place.
1. Click the small triangle in the upper right corner of the Image Navigation Widget and select Edit this widget.
2. Click Add a new image link.
3. In the "Provide a Target Link" field, type in the URL that you want the image to link to.
4. Provide a caption for the image. You can use the caption Jive provides automatically, or overwrite it with your own.
5. Select the image you want to use for this link, and then click Save.
6. Repeat these steps until you have all the images you want to display in the widget. The limit is 8. You can move them around to change the order in which they are displayed by dragging and dropping them.
7. When you're finished, click Publish Layout on the editing page.
Setting Up the Search Widget
The Search widget allows your users to quickly search a specific space or group in your community, or the entire community.
1. Go to the place you own and click Manage > Overview Page to begin editing the place's Overview page. (If you're editing the community's Home page, you'll click your avatar in the upper right corner, and then Manage > Overview Page).
2. From the widgets list, select Content > Search Widget.
3. Drag the widget down into your layout area and drop it where you want it.
4. Click the small triangle in the upper right corner of the widget and select Edit this widget.
5. Use the title "Search Widget" or create your own, for example, "Search this Group" or "Search Me!"
6. Select the number of results to return in the search.
7. Select the place to perform the search. This can be any place in the community, or the entire community (which would be your "root" space).
8. Click Save Properties.
9. When you're finished making changes to your place's layout, click Publish Layout.
Setting Up the Ask Widget
The Ask (a place) widget allows users to quickly ask a question in a specific space or group in your community, or the entire community. After the user types a question into the Ask widget, the search function displays possible answers based on matching keywords. If the user doesn't see the correct answer in the results list, they can create a discussion right from the widget. This can be very helpful in places designed to support customers or employees.
1. Go to the place you own and click Manage > Overview Page to begin editing the place's Overview page. (If you're editing the community's Home page, you'll click your avatar in the upper right corner, and then Manage > Overview Page).
2. From the widgets list, select Content > Ask (place).
3. Drag the widget down into your layout area and drop it where you want it.
4. Click the small triangle in the upper right corner of the widget and select Edit this widget.
5. Use the title "Ask (place)" or create your own, for example, "Ask Us a Question". You can also change the text that will be displayed on the actual Ask button, for example, instead of "Ask It," you might want
"Submit Your Question".
6. Specify the place you want to perform the search. You can search in the current place, a single place that you specify, or all public places in the community (this would be your "root" space).
7. Select the number of results to return in the search.
8. You have some options for what will be displayed in the search results. You can select one, some, or all of these options:
Option Description
All Questions Displays in search results all questions that have been asked, whether or not they have been answered.
All Discussions Displays only discussions in search results.
Answered Questions Displays only Answered Questions in search results.
Documents Displays only documents in search results.
9. Select the place you want questions posted to. This can be different from the place where the Ask widget is located. For example, you could put the Ask widget in an "Employee Questions" group, but post the questions to the "Employee Q&A" group.
10.Click Save Properties.
11.When you're finished making changes to your place's layout, click Publish Layout.
Setting Up the Answered Questions Widget
The Answered Questions widget allows your users to quickly see a list of questions that have been answered in a specific space or group in your community, or the entire community. Answered questions displayed in this widget are those that include a reply marked as a "Correct Answer".
1. Go to the place you own and click Manage > Overview Page to begin editing the place's Overview page. (If you're editing the community's Home page, you'll click your avatar in the upper right corner, and then Manage > Overview Page).
2. From the widgets list, select Content > Answered Questions.
3. Drag the widget down into your layout area and drop it where you want it.
4. Click the small triangle in the upper right corner of the widget and select Edit this widget.
5. Use the title "Answered Questions" or create your own, for example, "Recently Answered".
6. Select the number of answered questions to display in the widget.
7. Select the order in which you want the answered questions to be displayed.
8. Specify the place you want to pull the answered questions from. Typically, you'll want this to be the current place, but it could be any other place in the community as well, or the entire community (this would be your "root" space).
9. Click Save Properties.
10.When you're finished making changes to your place's layout, click Publish Layout.
HTML and Formatted Text Widgets
The HTML and Formatted Text widgets are extremely flexible, but should be used carefully to ensure effective, performant pages.
The HTML and Formatted Text widgets are designed to display customized information on Overview places, including the community Home page. You can use them to embed all kinds of assets, including
images. These widgets are often used to provide visual orientation or branding to the site or the place. The HTML widget also allows you to add JavaScript and CSS elements, with certain security limitations, which are described later in this topic.
Uploading Resources to a Widget
You can use the Formatted Text and HTML widgets to upload up to 10 file resources per place. (Spaces can include any kind of files: groups and projects are limited to GIF, JPEG, PNG and BMP files.) Files you upload will be stored as part of your community so you don't have to retrieve them from an external location, which can improve performance and saves you the trouble of hosting them elsewhere. You can then refer to these resources in any Formatted Text or HTML widget you have access to edit. For instructions, see Uploading Static Resources to a Widget.
Warning: Keep in mind that resources you upload this way are posted on the Internet and can be viewed by anyone with access to the network. By design, they don't inherit the authentication requirements of your site or the permissions to the place where you upload them.
Managing Performance
Uploading resources is a good way to limit the performance impact of resource loading from your widgets:
uploaded resources don't need to be authenticated on page load. However, you'll still want to consider user page loads when determining the number and content of widgets.
Managing HTML Widget Security
To ensure security and prevent problems that can corrupt your pages and keep them from loading, any HTML widget code that calls a <script> tag will be contained in an isolated iFrame. This is known as
"safe mode." If you want to include CSS or other styling in the widget, you can include it in the same location as your HTML code. Isolation of the HTML widget also means that the widget can't borrow
JavaScript from the Overview page, and that visual components cannot extend beyond the perimeter of the iframe. Simple HTML, JavaScript, and CSS continue to be supported.
In safe mode, you can still call the assets associated with the core Jive installation as follows: <script src="/resources/scripts/jquery/jquery.js"></script> <link rel="stylesheet"
href="/styles/jive.css" media="all">
Widget upload access should be limited to users you trust. Because any social group owner can upload resources to these widgets, it's possible for users to make incorrect judgments about appropriateness and security, so make sure group owners are carefully chosen.
Uploading Static Resources to a Widget
You can use the Formatted Text and HTML widgets to upload file resources into Jive, so you can link to them directly using a URL.
You can upload any kind of static file from a menu inside the Formatted Text and HTML widgets. You can also see the available uploaded resources and copy their URLs so you can use them in your widget code.
You can upload up to 300 files per place.
Warning: Keep in mind that resources you upload this way are posted on the Internet and can be viewed by anyone with access to the network. By design, they don't inherit the authentication requirements of your site or the permissions to the place where you upload them.
To upload a static resource: