b2evolution b2evolution

  • Sign in
  • Sign up
  • About
  • Downloads
  • Hosting
  • Docs
  • Support
  • Sign in
  • Sign up
  • Manuals Home
  • Latest Updates
 
  1. b2evolution CMS User Manual
  2. Front-office Reference
  3. Widgets Reference
  4. Listing Contents
  5. Universal Item List Widget

Universal Item List Widget

The Universal Item List widget can list Posts in a variety of ways with different filters, sort orders, and groupings which makes it incredibly versatile for displaying all kinds of lists in your sidebar.

Of course, it can also pull data from another collection and you can stack as many of these lists as you want on your page.

This widget virtually allows you to list anything, anywhere, and in any form.

This widget is actually the parent widget of much more specific – that means: simple – widgets.

Settings

Universal Item List Widget
  • Block title: specify the title that you want this widget to display in your collection (default entry: Items)
  • Template: select the Quick Template with context content_list_master to use when displaying the content of this widget.
  • Link to Blog: check to link the block title to the collection.
  • Layout: select how the contents should be laid out.
  • RWD block class: specify the classes that will be used by the responsive column.
  • Item visibility: include all the posts or only those that the current user is allowed to see.
  • Post type usage: this will filter the list to include only the selected item type usage.
  • Exact post type: this will filter the list to include only the selected item type.
  • Featured: select if you would like to restrict the list to featured posts, all posts, or posts that are not featured.
  • Flagged: check if you want to limit the list to flagged items.
  • Follow Main list: this will restrict contents related to what is currently displayed in the main area.
  • Collections: comma-separated collection IDs or asterisk * for all collections or dash - for current collection without aggregation or leave empty for current collection including aggregation. The list will be limited to posts/items belonging to the specified collection.
  • Categories: comma-separated category IDs. This will limit the list to items/posts that belong to the specified categories.
  • Group by: this will specify the grouping setting of your items, either by category/chapter or of no particular grouping (default setting).
  • Order by: this will specify the sorting setting of your items (by date issued (default setting), title, date last changed, specific order number, etc). You can specify up to 3 sort orders from highest to lowest priority. For each, you can specify either ascending or descending order.
  • Max items: here, you can specify the maximum number of items to display (default setting: 10 items).
  • Category: select if you want to display the main category only, all categories, or don’t display categories at all.
  • Titles: this will specify either to display the titles or not (checked by default).
  • Link titles to: select where the titles should link to.
  • Attached pictures: select how you want to display attached images of each list item. Note: this parameter will work only for those posts that actually have any linked image. Available options are:
    • display all pictures for each list item
    • display only the first picture for each list item (default setting)
    • display the main category picture. See Category image setting in Category Edit Form.
    • don’t display any picture at all
  • First picture: select how to display the first picture of the post, separately before the title or with no special treatment.
  • Max pictures: how many pictures do you want to display.
  • Image size: this will define the size of the pictures.
  • Link picture: select where the images should link to.
  • Excerpt: check to display the excerpt of each list item.
  • Content teaser: check to display the content teaser of each item (checked by default)
  • Max words: specify the maximum number of words for the teasers.

Styling

If you are developing skins, you can prepare styles for many different usages of this widget as the widget will add classes to the evo_widget container depending on its settings. This allows you to apply different CSS styles depending on the widget settings.

Example: Get ad posts and display them as a clickable picture in the sidebar

Universal Item List Widget
Sample advertisement display in the sidebar of a collection
Universal Item List Widget
Settings of the widget to achieve the advertisement sample above
Tags: 7.1.3
Created by fplanque • Last edit by winskie on 2020-07-24 07:22 • •

No feedback yet

On this page

  • Settings
  • Styling
  • Example: Get ad posts and display them as a clickable picture in the sidebar

Search the Manual

Content Hierarchy

  • b2evolution CMS User Manual
  • User's Guide
  • Installation / Upgrade
  • Front-office Reference
    • Collection Types
    • Disp Reference
    • Widgets Reference
      • About Widgets
      • Basic blocks
      • Embedded contents
      • Menu Items / Buttons
      • Navigation
      • Listing Contents
        • Simple Post List
        • Content Hierarchy
        • Category Content List
        • Simple Page List
        • Featured Posts
        • Simple Related Posts List
        • Flagged Item List
        • Universal Item List
        • Tabbed Items
        • Photo Index
        • Comment List
        • Simple Sidebar Links List
        • Simple Linkblog Links List
        • Featured/Intro Post
        • Compare Item Fields
      • Displaying Contents
      • Item Details
      • Collection Details
      • User Details
      • User Related
      • Other
      • Helper CSS Classes
      • Embed Sub-Container
      • Columns (Sub-Containers)
    • The In-skin Edit Screen
    • Comments / Feedback Area
    • Social Media Meta Tags
    • Workflow Panel
    • Flagging Items
  • Back-office Reference
  • Developer Reference
  • Operations Reference
  • Advanced Topics
  • Glossary
  • Archives
CCMS

This online manual is powered by b2evolution CMS – A complete engine for your website.

About b2evolution

  • What is it?
  • Features
  • Getting Started
  • Screenshots
  • Online demo
  • Testimonials
  • Design philosophy
  • Free & open source
  • Terms of service

Downloads

  • Latest releases
  • Skins
  • Plugins
  • Language packs

About us

  • About us
  • Contact

Webhosting Guide

  • Web hosting blog
  • Best web hosting
  • Cheap web hosting
  • Green web hosting
  • Hosting with SSH
  • VPS hosting
  • Dedicated servers
  • Reseller hosting
  • Int'l: UK / France

Docs & Support

  • Online manual
  • Forums
  • Hire a pro !

Other

  • Adsense
  • Press room
  • Privacy policy

Stay in touch

  • GitHub
  • Twitter
  • Facebook
  • LinkedIn
  • News blog
  • RSS feed
  • Atom feed

Founded & Maintained by François Planque