Documentation

Introduction

This page will show you how to add Posts to your page after you have created both a page and a Post Type. By adding the Post Types element to your page, you will create what is called a "Post Browser."

Post Browsers list the posts that are collected in a Post Type, and allow you to change filtering and display options as needed.

Adding a Post Type

While editing a page, click the Content Element labeled "Post Types," in the right margin. This will add a Post Browser to your page.

Post Types link

 

From the new Post Browser's content block, click the "+Existing Post Types" button near the bottom of the block, as seen below.

Add Posts - Existing Post Types

Next, select the Post Type(s) that you wish to display, from the list in the "Select Post Type" section. Once you have selected your Post Types, click the "Submit" button. This add the posts from your selected Post Type to the page.

Add Posts - Select Post Type

Optional - Settings

If you would like to change the default settings for displaying posts, click link labeled "Settings," in the top right section of the blue header. This will bring up the settings menus. There are five tabs in the settings: Display Options, Labels, Features, Variables, and Layout.

Note, some websites may display fewer settings, while others may have had extra, custom designed settings added. If you would like to increase your site's functionality by adding one or more of the settings described below, contact support@gslsolutions.com. If you require assistance with settings that do not appear in this section of the User Guide, contact support@gslsolutions.com.

From these tabs, you will be able to change the display options of your Post Browser to create calendars or maps, filter your news articles by month or year, attach or remove labels, and more. Each tab and it's options are described in detail below. 

Display Options

Below is a list of the fields you will see in your Post Browser's Disply Options tab, along with descriptions of each setting. 

The "Layout" options allow you to change the fundamental way in which your Post Browser functions. Each "Layout" changes the way your Posts are displayed on the page, as described below. The default setting is "Browse by Month & Year."

  • The "Browse by Month & Year" option is the default setting. This will create a a table, which lists the title of each Post, along with their creation/publication date, in separate columns. Each month will have it's own heading, as seen in the example below. The Post titles act as links to the content of the Post.

    The example shown at the bottom of this page is set to "Browse by Month & Year."

  • The "Gallery" option creates an image gallery, for Post Types with image-based content. Gallery content can be browsed by clicking the arrows on the left or right of the current image. Clicking the image will forward visitors to the text content of the Post.

  • When choosing "Digest Format," the entire "Content" section of each Post is displayed within the Post Browser.

  • To create a calendar on your page, select "Calendar." Selecting a calendar-specific Post Type will populate your calendar with events.

  • The "List" layout creates a compact, single spaced version of the "Browse by Month & Year" format. This layout displays only the shorthand date of each Post, and omits the month and year headings.
  • Selecting "Map" will allow you to create a map on your page. This format uses addresses from your map-specific Post Type to create Points-of-Interest on an interactive map.

  • Selecting "Panels" uses a large, image-based format. Your newest Post will be displayed as a large 600 x 400 image, with the next three Posts appearing on the right as three equally sized thumbnail images. This layout is recommended for "Featured" posts, or other Post Types that include large, high quality images.

  • "Tiles" is another image-based layout. Your three newest Posts will be displayed as a row of three equally sized images, with a drop-down function that allows visitors to view later Posts. This layout is also recommended for "featured" Posts.

Template Placement:
This option determines which section of your page the Posts will be displayed on.

  • The default "Template Placement" is "Main Body." This will display your Post Browser within the central content area of your page.

  • Selecting "Sidebar" will display the Post Browser in the right (or left - depending on your specific site layout) margin of your page.

Display Group Title?:
The "Display Group Title?" option allows you to choose whether you would like the Group Title (which can be entered below "Post Type Group" in the Post Browser's content block), to be visible to visitors.

Detail Page:

This setting determines which page your Posts will be displayed on. Selecting the "Post Type Default Page" will redirect the visitor to the designated page for the Post Type you have added to your Post Browser. Selecting "This Page" will display the Post on the page where the Post Browser is located. 

For example, if you are adding a Post Browser to your home page for news articles: "Post Type Default Page" will send visitors who click on a Post title link to your "News" page, when displaying the content of the post. "This Page" will display the Post directly on the home page. In this case, selecting "Post Type Default Page"  is recommended, unless you have specifically designed your home page to display news articles.
Sort By:

The "Sort By" option allows you to sort your Posts by Date Written, Date Uploaded, or alphabetically by Title.

Sort Order:

This option determines the order of your "Sort By" selection.

For example: If you are sorting by "Date Written," selecting "Ascending" will display the newest Posts first, and "Descending" will display the oldest Posts first.

Items to Display:
This option allows you to set the number of Posts that will be displayed in your Post Browser. If you are using your Post Browser as a calendar, this should be set to "All."

This option allows your visitors apply filters to the Posts in the Post Browser.  For example, by selecting the "Labels" filter, your visitors could filter calendar events by grade level or sports team - if the calendar entries have grade or team specific Labels attached to them.

"Default Set" filters by month and year.

If you have images attached to your Posts, this gives you the option to display them within the Post Browser.

If you have chosen to display your images, this drop-down menu allows you to select the display size. "Thumbnail" displays a small 100x100 pixel image. "Featured" displays a larger 600x400 pixel image. The default option for this setting is "Thumbnail."

This option allows you to select whether the date of the Post is visible to visitors. The default option is "Yes."


This option allows you to select whether the exact time the post was published is visable. The default option is "No."

This setting allows you to limit which Posts are displayed on the page, relative to the current date. The default setting is "All," which displays every Post in the Post Type. "Upcoming" limits the available Posts to those with a future publishing date. "Past" displays only the Posts whose publishing date has already occurred. 

Labels

Show filters for Posts with Labels from the Label Type(s)
If you have attached Labels to your Posts, this setting allows you to create a new drop-down menu in the Filter Bar, which allows visitors to choose from any of the Label Types you have selected in this section. Once a visitor has chosen a Label from the menu, only Posts with the selected will be displayed.

Only display Posts that match the Label(s):
By selecting a Label from the "Label Type" menus in this section, your Post Browser will display only those Posts with the selected Label attached. Posts without the selected Labels will not be viewable by visitors.

Features

The default setting for this tab is "Do Not Limit," which will display all Posts in the Post Type. If you have selected a Feature Groups in this tab, such as "Homepage," the Posts will be limited to those you have marked as "Featured." for your chosen Feature Group. 

Variables

This tab is used by GSL Solutions developers to push specific data to a Post Browser. If you require assistance with this setting, contact support@gslsolutions.com.

Layout

If you have customized your Web page with the "Page Layout" feature, this option allows you to place your Post Browser in a specific section of your page.

Finish - Click Submit

Once you have selected the appropriate layout and settings for your Post Browser, click the "Submit" button to save your changes. 

Example Layout

Browse by Month & Year

This is the most common layout for a Post Types browser. This layout creates a list of Posts, sorted by date with additional label filtering options available. To add this layout, click "Group Settings" then under the "Display Options" tab select the "Browse by Month & Year" option in the Layout section.

May 2011
Date Title
5/12/11 Test 3
September 2010
Date Title
9/3/10 Test 2
9/3/10 Title