The categories-pages component (Vvveb\Component\Categories\Pages) lists taxonomy categories together with their posts (pages). It behaves like the categories component but additionally loads a page of posts per category, which makes it suitable for sitemap-style or magazine index pages.
Activate the component by adding:
data-v-component-categories-pages
Component Options
Add options as HTML attributes using the data-v-* syntax.
| Option | Attribute | Description | Default |
|---|---|---|---|
| start | data-v-start |
Starting category offset | 0 |
| limit | data-v-limit |
Number of categories to display | 7 |
| posts_start | data-v-posts_start |
Starting post offset inside each category | 0 |
| posts_limit | data-v-posts_limit |
Number of posts per category | null |
| type | data-v-type |
Taxonomy type | categories |
| post_type | data-v-post_type |
Post type loaded per category | post |
| site_id | data-v-site_id |
Site ID | Current site |
| order | data-v-order |
Sorting rules, overridable from URL | url fallback price asc |
| taxonomy_item_id | data-v-taxonomy_item_id |
Load a single category branch | null |
| page | data-v-page |
Page number for pagination | 1 |
| parent_id | data-v-parent_id |
Filter by parent category (0 = top-level) |
null |
| levels | data-v-levels |
Depth of category tree to load | null |
Component Properties
Categories render inside data-v-cats / data-v-cat repeatables (same fields as the categories component: name, slug, url, image, count, …). Each category additionally carries its posts list for nested data-v-post rendering.
HTML Example
<div data-v-component-categories-pages data-v-limit="7" data-v-posts_limit="5">
<div data-v-cats>
<div data-v-cat>
<a href="" data-v-cat-url><span data-v-cat-name></span></a>
</div>
</div>
</div>