Blog List Settings


General Setup

  • CMS ID: (input) The file identifier to publish the content to. You will use this same identifier when you want to import content submitted by this form. Total IDs should only contain letters and numbers.
    • Default: totalcms

  • Images For: (button-3) Enable custom image galleries that will be linked to blog post properties
    • Default: [false, false, false, false]

  • Author Gallery ID: (input) The CMS ID of the Gallery that will be used to manage the author images. When uploading author images, the images must be named properly. Ex: If the author is Joe Workman, the image name must be joe-workman.jpg
    • Enable: When Images For is set to true
    • Default: authors
  • Default Author Image: (image) A default author image to use in the case an author is not found inside the author gallery. This should be a square cropped image.
    • Enable: When Images For is set to true
    • Default:

  • Category Gallery ID: (input) The CMS ID of the Gallery that will be used to manage the category images. When uploading category images, the images must be named properly. Ex: If the cateogry is “My Cateogry”, the image name must be my-category.jpg
    • Enable: When Images For is set to true
    • Default: categories
  • Default Category Image: (image) A default category image to use in the case an category is not found inside the category gallery. This should be a square cropped image.
    • Enable: When Images For is set to true
    • Default:

  • Tag Gallery ID: (input) The CMS ID of the Gallery that will be used to manage the tag images. When uploading tag images, the images must be named properly. Ex: If the tag is “My Tag”, the image name must be my-tag.jpg
    • Enable: When Images For is set to true
    • Default: tags
  • Default Tag Image: (image) A default tag image to use in the case an tag is not found inside the tag gallery. This should be a square cropped image.
    • Enable: When Images For is set to true
    • Default:

Filter & Sort

  • Load Count: (slider) The max number of posts to display. If you want to load more posts, then enable the load more option. Keep this number as low as possible will make the page load faster.
    • Default: 10
    • Min Value: 1
    • Max Value: 20
  • No Posts: (input) The message displayed when no posts are found
    • Default: No Posts Found

  • Sort: (select) The order logic for posts
    • Default: Newest First
    • Possible Values:
      • Newest First
      • Oldest First
      • Alphabetical (ABC)
      • Reverse Alphabetical (ZYX)
      • Shuffle

  • Date: (select) Filter posts from the view by date
    • Default: Only Past Posts
    • Possible Values:
      • All Posts
      • Only Future Posts
      • Only Past Posts
  • Featured: (select) Filter & Sort featured attribute
    • Default: Before all Posts
    • Possible Values:
      • Before all Posts
      • Display with Posts
      • Only Featured
      • Hide Featured
  • Draft: (select) Filter & Sort draft attribute
    • Default: Hide Drafts
    • Possible Values:
      • Before all Posts
      • Display with Posts
      • Only Drafts
      • Hide Drafts
  • Exclude Displayed Post?: (checkbox) If using the Blog List on a Blog Post page, this setting will ensure that the blog post being displayed does not also show up in the list of posts
    • Default: true
  • Filter: (button-4) Filters to apply to post list
    • Default: [false, false, false, false]
  • Related Author from Post?: (checkbox) Pull the author information from the blog post. This option should only be used when displaying related posts on the actual Blog post page
    • Enable: When Filter is set to true
    • Default: false
  • Author: (input) The author to Filter & Sort. This should be the URL friendly version of the author. All lowercase and replace spaces with dashes. You can supply mutlple values, separated by “|”
    • Enable: When Filter is set to true
    • Default:
  • Related Category from Post?: (checkbox) Pull the category information from the blog post. This option should only be used when displaying related posts on the actual Blog post page
    • Enable: When Filter is set to true
    • Default: false
  • Category: (input) The category to Filter & Sort. This should be the URL friendly version of the author. All lowercase and replace spaces with dashes. You can supply mutlple values, separated by “|”
    • Enable: When Filter is set to true
    • Default:
  • Related Tags from Post?: (checkbox) Pull the tag information from the blog post. This option should only be used when displaying related posts on the actual Blog post page
    • Enable: When Filter is set to true
    • Default: false
  • Tag: (input) The tag to Filter & Sort. This should be the URL friendly version of the author. All lowercase and replace spaces with dashes. You can supply mutlple values, separated by “|”
    • Enable: When Filter is set to true
    • Default:
  • History: (number-2) The dates to Filter & Sort. If the month is set to 0, then only the year is taken into account
    • Enable: When Filter is set to true
    • Default: [2015, 0]
    • Min Value: 0
    • Max Value: 3000

Grid Setup

  • Grid Style: (select) The type of grid to use
    • Default: Grid
    • Possible Values:
      • Grid
      • Flex Grid
      • Flex Grid + Full Width
  • Columns: (number-4) The number of columns used at each breakpoint
    • Enable: When Grid Style is set to grid
    • Default: [1, 1, 2, 3]
    • Min Value: 1
    • Max Value: 20
  • Flex Width: (slider) The min width of each blog post. When using the default Grid, the Flex width will be used for fallback on older browsers
    • Default: 300px
    • Min Value: 100px
    • Max Value: 1000px
  • Gutter: (slider) Gutters around each post
    • Default: 20px
    • Min Value: 0px
    • Max Value: 100px
  • nth Full Width: (slider) The nth number of blog post that is going to be full width. The first blog post will always be full width.
    • Enable: When Grid Style is set to flex-grid-full
    • Default: 6
    • Min Value: 0
    • Max Value: 10

Post Styles

  • Post Colors: (color-2) The background and border for each item
    • Allows Opacity: true
  • Custom Colors: (button-3) Custom colors for post backgrounds
    • Default: [false, false, false]
  • Alternate: (color-2) The background and border for alternating items
    • Enable: When Custom Colors is set to true
    • Allows Opacity: true
  • Featured: (color-2) The background and border for featured items
    • Enable: When Custom Colors is set to true
    • Allows Opacity: true
  • Draft: (color-2) The background and border for draft items
    • Enable: When Custom Colors is set to true
    • Allows Opacity: true

  • Border: (slider) The border width of each post
    • Enable: When ** is set to false
    • Default: 0px
    • Min Value: 0px
    • Max Value: 10px
  • Round Corners: (slider) The border radius of the post
    • Enable: When ** is set to false
    • Default: 0px
    • Min Value: 0px
    • Max Value: 10px
  • Border Size: (number-4) The size of the border
    • Enable: When ** is set to true
    • Default: [0, 0, 0, 0]px
    • Min Value: 0px
    • Max Value: 100px
  • Round Corners: (number-4) The size of the border
    • Enable: When ** is set to true
    • Default: [0, 0, 0, 0]px
    • Min Value: 0px
    • Max Value: 100px

  • Padding: (slider) The padding around the post
    • Enable: When ** is set to false
    • Default: 0px
    • Min Value: 0px
    • Max Value: 20px
  • Padding: (number-4) Padding on the post
    • Enable: When ** is set to true
    • Default: [0, 0, 0, 0]px
    • Min Value: 0px
    • Max Value: 50px

Hover Effects

  • Hover Effect: (select) The hover effect to use
    • Default: None
    • Possible Values:
      • None
      • Press
      • Raise
  • Hover Offset: (slider) Raise or lower the post when you hover over it
    • Enable: When Hover Effect is set to hover
    • Default: 0px
    • Min Value: -10px
    • Max Value: 10px

Text Styles

  • Text Style: (select) The color scheme for the text. All Site Styles options require the Foundation stacks.
    • Default: Default
    • Possible Values:
      • Default
      • -
      • Alternate (Site Style)
      • Swatch 1 (Site Style)
      • Swatch 2 (Site Style)
      • Swatch 3 (Site Style)
      • Swatch 4 (Site Style)
      • Swatch 5 (Site Style)
      • Swatch 6 (Site Style)
      • -
      • Custom
  • Text Color: (color-3) Post text colors
    • Enable: When Text Style is set to custom
    • Allows Opacity: true
  • Hyphenate Text?: (checkbox) Hyphenate all of the post text in the blog list items
    • Default: false

Image Setup

  • Image Display: (select) The style of image gallery of static image
    • Default: Collage
    • Possible Values:
      • Slideshow
      • Thumbnail Grid
      • Collage
      • -
      • Featured Image
      • First Image
      • Last Image
      • Random Image
  • Max Images: (slider) The maximum number of images to diplay when showing slideshows or thumbnails
    • Default: 3
    • Min Value: 1
    • Max Value: 25
  • Grid Cols: (slider) The number of columns in the image grid
    • Enable: When Image Display is set to thumbs
    • Default: 2cols
    • Min Value: 0cols
    • Max Value: 5cols
  • Slideshow Timer: (slider) The slide timer. The CMS will randomly add 0 to 2.5 seconds to the time that you confiure here. This is so that every image transitions at a different time
    • Enable: When Image Display is set to orbit
    • Default: 5s
    • Min Value: 1s
    • Max Value: 20s

  • Image Filter: (select) Filter the images used
    • Default:
    • Possible Values:
      • All Images
      • Featured Images Only
      • Non-Featured Images Only

Load More

  • Load More: (button-3) How the load more is triggered or disabled
    • Default: [true, false, false]

  • Load Button on Mobile?: (checkbox) The buttoon will be used instead of infinite scroll on mobile.
    • Enable: When Load More is set to true
    • Default: true
  • Button Text: (input) The text for the button
    • Default: Load More
  • Button Style: (select) The color scheme for the button
    • Default: Primary (Site Style)
    • Possible Values:
      • Primary (Site Style)
      • Secondary (Site Style)
      • Success (Site Style)
      • Alert (Site Style)
      • Swatch 1 (Site Style)
      • Swatch 2 (Site Style)
      • Swatch 3 (Site Style)
      • Swatch 4 (Site Style)
      • Swatch 5 (Site Style)
      • Swatch 6 (Site Style)
      • Custom
  • Text: (color) The color of the button text
    • Enable: When Button Style is set to custom
    • Allows Opacity: true
  • Button: (color) The color of the button
    • Enable: When Button Style is set to custom
    • Allows Opacity: true
  • Button Hover: (color) The color of the button when hovered over
    • Enable: When Button Style is set to custom
    • Allows Opacity: true
  • Size: (select) The size of the button
    • Default: Small
    • Possible Values:
      • Tiny
      • Small
      • Medium (default)
      • Large
  • Rounded: (select) The corener radius of the button
    • Default: Square
    • Possible Values:
      • Square
      • Round Corners
      • Pill
  • Ghost Button?: (checkbox) Make the button a ghost button
    • Default: false
  • Full Width?: (checkbox) Make the button expand to 100% width
    • Default: false

Advanced

  • Custom Post Link URL?: (checkbox) Provide a custom blog post view page that the blog list will link to. By default, the URL that is defined inside the Blog Form stack will be used. A custom link should only be used in the case that you have mutliple possible Blog Post view pages in your project.
    • Default: false
  • Post View Page: (link) The URL to the page that contains that blog post. You can have links formatted for pretty URLs. This setting will need to be set to the pretty URL. The post permalink will be added to the end. Do not end the url with a slash. You will need to also make sure that you have setup the proper .htaccess rules in order for this to work.
    • Enable: When Custom Post Link URL? is set to true
    • Default: