data:postrepeater
AJAX
ajax:delayedload ajax:event ajax:navigation ajax:region
Data
data:calendar data:column data:eventrepeater data:postrepeater
ATTRIBUTES
EXAMPLES
data:productbrandrepeater data:productcategoryrepeater data:productrepeater data:repeater data:table data:template data:tree
Forms
forms:address forms:captcha forms:checkbox forms:checkboxgroup forms:codeeditor forms:combobox forms:datepicker forms:dialogbox forms:editbox forms:fileupload forms:form forms:hidden forms:money forms:officeuseregion forms:option forms:password forms:paymentmethod forms:radiobutton forms:radiobuttongroup forms:row forms:searchbox forms:signature forms:slider forms:spinbox forms:submitbutton forms:submitimage forms:submitlink forms:successcontent forms:textarea forms:timepicker
Layout
layout:gallery layout:productgallery layout:rotator layout:stepper layout:stepperpanel layout:tablist layout:tablistitem
Logic
logic:dependency logic:else logic:if logic:include logic:parse logic:variable
Navigation
navigation:breadcrumbs navigation:item navigation:primary navigation:secondary
Personalisation
personalisation:firstname personalisation:fullname personalisation:lastname personalisation:other
Standard
standard:audio standard:embed standard:icon standard:image standard:link standard:script standard:tooltip standard:video
Templates
templates:button templates:card templates:column templates:fancybox templates:faq templates:flexlayout templates:header templates:row templates:section templates:styles templates:teammember templates:testimonial
Regions
regions:content regions:contentadditional regions:security regions:togglable
Third Party
thirdparty:googlemap thirdparty:googlemapmarker

<data:postrepeater> </...>

Repeats a Post template to show Posts in the specified Post Category.

Used in place of a <data:repeater>, to provide administrators with an improved page editing experience, by allowing the control attributes to be changed via options presented in the page editor left panel.

To edit the default template used to render Posts:
  • Navigate to Dashboard > Website > Designs
  • Click 'Dynamic Displays' located underneath a website design, followed by 'Posts List'

Attributes

dataFilter
array
A Filter Array which will be used to filter results from the datasource.
dataLimit
int
Data Limit defining the [strong]Maximum[/strong] number of templates to be displayed.
This value is superceeded by paging and pagingrows
dataOrder
array
Data Order
dataStart
int
The number of results to skip, if datasource is a function that supports a Query Array.
id
string
Give this control a unique id. Can be accessed in the client DOM (eg, document.getElementById('myid') or in the server DOM using [? $myid ?] or [? $('myid') ?]).
paging
bool
Whether to enable paging for this control. With paging enabled, the initial number of results will be limited to the value of pagingrows, and a 'Show More' button will appear.
Each click of the button will append pagingrows more rows. Default = false.
pagingRows
int
Use in conjunction with paging, to control the initial number of rows to be shown, and the number of rows loaded when 'Show More' is clicked. Default = 10.
postCategory
string
Integer or comma separated list of integers representing the Post Category ID/s.
templateRegionsShown
string|null
Template Regions Shown

Each template type defines a number of available regions which can be shown or hidden within a template.

Templates are populated with a $templateRegionsShown array which contains a key for each defined region, and a value representing whether that region should be shown.

The template may then use logic to show or hide regions based on the values in this array.

When the TemplateRegionsShown attribute is specified, it accepts a comma-separated list of region names. These regions will have their $templateRegionsShown['region_name'] value set to true, and all other region values will be set to false.

If this attribute is omitted, all regions $templateRegionsShown value will be set to true.

An empty string will be treated as if no regions were specified, so all $templateRegionsShown values will be set to false.

Regions defined for each templateType:
email
No template regions defined for email template type.
list
icon date shortcontent
templateType
string
(Required) The template type.

Possible Template Types: email list
variant
string
Template display variant

Variants defined for each templateType:
email
linear
list
bigpic card classic column featured gallant linear overlay portrait relative split tiny wide wrap

Examples

Display All Posts

HTML:

<data:postrepeater paging="true" pagingrows="10" templatetype="list" variant="card" />

DataStart and DataLimit Attributes

Allows you to show from a record, to a record. Behaves like the LIMIT clause in SQL.

HTML:

<h1>Show the First Three Posts</h1> <data:postrepeater templatetype="list" variant="card" datalimit="3" /> <h1>Show the Second and Third Post</h1> <data:postrepeater templatetype="list" variant="card" datastart="1" datalimit="2" /> <br /><br /> datastart="1" datalimit="2" behaves the same as SQL's LIMIT 1 2

DataFilter Attribute

Allows you to specify conditions in your query. Behaves like the WHERE clause in SQL.

HTML:

<h1>Filter posts by date</h1> <data:postrepeater templatetype="list" variant="card" datafilter="[? [['post_date', '&gt;', date('Y-m-d H:i:s', strtotime('-24 hours'))]] ?]" />

DataOrder Attribute

Allows you to specify conditions in your query. Behaves like the ORDER clause in SQL.

HTML:

<h1>Change the order posts are displayed</h1> <data:postrepeater templatetype="list" variant="card" datafilter="[? [['post_date', '&gt;', date('Y-m-d H:i:s', strtotime('-24 hours'))]] ?]" dataorder="[? [['post_date', 'asc']] ?]" />