0
Welcome Guest! Login
0 items Join Now

Ambrosia: Grav Content Particle

Your Guide to Using Particles in Ambrosia for Grav


Introduction

The Grav Content particle (Also known as contentarray) gives you the ability to directly list and pull in Grav posts directly from the CMS and present them in a clean, organized way. It's important to note this does not take the place of the Page Content particle which essentially displays any article content assigned to the page. This is a controlled, organized particle perfect for showcasing content.

Main Options

The particle's settings panel enables you to set exactly what content appears in the particle, and how it's presented. We have provided descriptions to the available options below.

Option Description
Categories Select the categories pages that appear in this particle should be sourced from.
Number of Pages Select the maximum number of pages to display.
Number of Columns Select the number of columns you wish to have the pages displayed in.
Start From Enter offset specifying the first article to return. The default is '0' (the first article).
Order By Select how the pages should be ordered. This includes Publish Date, Unpublish Date, Date, Last Modified Date, and Slug.
Ordering Direction Choose the direction ordered pages are displayed. You can choose: Ascending or Descending.
CSS Classes Enter any CSS classes you want to apply to the particle.
Tag Attributes Enables you to apply extra tag attributes to the particle.

Option Description
Image Select to Show or Hide the article's image in the particle.
Article Text Choose to display the Introduction, Full Article, or to Hide this content.
Text Limit Set a limit (in characters) for the article text.
Formatting Choose between Plain Text and HTML.
Title Select to Show or Hide the article's title in the particle.
Title Limit Enter the maximum number of characters in the title to display in the particle.
Date Select which date (if any) to show in the particle. You can choose: Hide, Created, Last Modified, and Published.
Date Format Select the format by which you want the date to appear.

Option Description
Read More Select to Show or Hide the read more link in the particle.
Read More Label Enter the text you want to appear as the read more link.
Button CSS Classes Enter any CSS classes you want to apply to the read more button.

Option Description
Author Select to Show or Hide the article's author in the particle.
Category Select to Show or Hide the article's category in the particle.
Category Route Enter the route to the category page.

Found errors? Think you can improve this documentation? Please edit this page. You can also view the history of this page.