Are you enjoying the extensions? Did you like the support? Help others decide.

Leave a review
Information
Print

Blog view: item selection

Information
Latest News Enhanced

Pro v4+

Categories
Category filter
  • Include includes the selected categories
  • Exclude excludes the selected categories, therefore including all the other ones
Categories / K2 categories Select the Joomla! standard categories or K2 categories the articles are from (multiple select).
Auto will select all items related to the categories showing on the page or related to items of the same category.
Warning K2 In 'auto' mode, K2 is limited to showing items on one category page or item page
Sub-categories Automatically selects the next level(s) or all levels of a category.
  • No do not include children of the selected categories
  • Level include X levels of the selected categories
  • All levels include all subcategories of the selected categories
Maximum level depth The depth level (starting at 1) when selecting 'level' in subcategories
New v4.5 K2 K2 is no longer limited to level 1
Category order The order of the categories
  • Order by administration console order
  • Title by category name/title order
Tags
Tags filter
  • Include includes the selected tags
  • Exclude excludes the selected tags (irrelevant in the context of related by tags)
Tags / K2 tags Select which tags the items must have. 'All tags' will select all items having tags
Include children Include the children of the selected tags
Warning K2 K2 only has a flat representation of tags, therefore this option does not apply to K2 tags
Tags match type How tags need to match
  • All The item is selected if it has all of the tags
  • Any The item is selected if at least one tag is found

Warning All does not work with excluded tags.
Warning This parameter also applies to related tags. For instance, if the item on the page has tags X and Y and the value is 'All', the related items will need to have the exact same tags X and Y in order to be selected.
Custom fields
Custom fields A selection of custom fields one can filter with (articles only). Learn how to use fields as filters in this tutorial.
Use as many fields as needed, but be aware that multiplying the number of fields may have performance impact issues
Custom field The field used for filtering (showing here, custom fields of type list, checkboxes, radio and sql)
Filter Include or exclude the values that are set in the following parameter
Values The list of the values the items must have or not have to be selected, comma separated
Keywords
Meta keywords Keywords common to all articles
Authors
Author match The data to use to identify the article's author.
  • Created by the user who created the article
  • Created by AND Created by alias the user who created the article and the person who's alias is added to the article
  • Created by OR Created by alias the user who created the article or the person who's alias is added to the article
Using 'AND' ensures articles MUST HAVE 'created by' and 'created by alias' values to be selected.
Created by (previously named 'author') filter
  • Include includes the selected users
  • Exclude excludes the selected users
Created by (previously named 'authors') Select from which authors the articles are written from
  • Logged user from the logged user (was 'auto' before 6.7)
  • All authors from any user
  • [John Doe] from John Doe
Created by alias filter
  • Include includes the selected aliases
  • Exclude excludes the selected aliases
Created by alias Select which alias the articles must be written from
  • All alias from any article having an alias
  • [John Doe] from alias 'John Doe'
Author name The author's name representation
  • User Name the name of the user who created the article
  • Alias -> User Name (when the created by alias is missing, the name of the user is used instead)
  • Username the username of the user who created the article
Author order
  • None
  • Alphabetical Asc by alphabetical order, ascending
  • Alphabetical Desc by alphabetical order, descending
  • Not in K2 Contact sort field Asc by linked contact first/second/third sort fields, ascending
  • Not in K2 Contact sort field Desc by linked contact first/second/third sort fields, descending
Warning When sorting by contact sort field, you may end up with duplicates if authors are linked to more than one contact (except for the case where one user is linked to several contacts in distinct languages)
Dates
Date Which date should be applied
  • Created
  • Published
  • Modified
  • Finished
  • Finished with pending
  • Pending the published start date is in the future
  • Any custom field of type 'calendar' (no support for K2)
When no date What needs to be done when the date is missing (only for finished publishing date)
Apply range Narrows down the list of items to the dates selected
  • None
  • Relative dates select the items for the last 2 weeks for instance
  • Fixed dates select the items between fixed dates
From
(relative dates)
The relative from date
  • Now
  • X days
  • X weeks
  • X months
  • X years

Example To show articles from the last 2 weeks, select X weeks
Example To show articles from last month to 2 months in the future, select X months

From X
(relative dates)
The number representing ‘X’ in ‘From’ (can be negative)

Example To show articles from the last 2 weeks, type 2 or New standard -2
Example To show articles from last month to 2 months in the future, type -1

To
(relative dates)
The relative to date
  • Now
  • X days
  • X weeks
  • X months
  • X years

Example To show articles from the last 2 weeks, select Now
Example To show articles from last month to 2 months in the future, select X months

To X
(relative dates)
The number representing ‘X’ in ‘To’

Example To show articles from last month to 2 months in the future, type 2

Start date
(fixed dates)
The start date to use when selecting items between fixed dates
End date
(fixed dates)
The end date to use when selecting items between fixed dates
Exclude IDs Exclude articles from the list of selected ones

Example 20,34,47

Only IDs Restrict the list of items to the ones listed.
Use in conjunction with order 'Manual' to order the items in the way they are specified in this parameter
Unauthorized items Allow public visitors to have a glimpse at restricted content. Applies to categories and items.
The unauthorized links are encoded and require login to access the full content.
Warning K2 K2 has some limitations:
  • categories must be explicitly added to the list of categories if they are inaccessible to the general public (one level and all level options won't select them)
  • uncategorized categories won't be selected in auto mode
Include Featured Featured items filtering.
  • Yes include featured items
  • No do not include featured items
  • Only get only the featured items
  • First include featured items, showing first

Starting in v6.10, start and finish featured dates are taken into account for the visibility of featured articles. Note that a featured article that is no longer in the date range does not make it a non-featured article.
Order The order in which the articles are presented (per category if categories are ordered)
  • None no order specified
  • Order by administration console order
  • Added by created date
  • Modified by modified date
  • Published by published date
  • Touched if no modified date, use created date
  • Finished by published down date
  • Custom field date by the custom field of type 'calendar' selected as date (no support for K2)
  • Random (do not use with pagination or else you may end up with duplicates)
  • Popular by number of hits
  • Title by alphabetical order
  • Manual by ids specified in the Only IDs parameter
Enforce language On multi-lingual sites, allows you to select items with the same language as the language of the page or mix items of different languages

Joomla does not handle pending articles in the frontend (linking a pending article results in a 404 error). Therefore, even though you can show those articles in the view, you cannot link to them. This has been reported as a bug to Joomla, but has been closed and no fix is on the way.

There is a well-known order bug in Joomla when articles are copies of each other and the creation or publishing dates are identical. Modifying the dates fixes it.

Related tutorials and topics