docs.modx.pro
  1. Extras
  2. PageBuilder
  3. Section catalog
  4. Pro
  5. Related products

Related products ​

On a product page, shows other SKUs from the same (or chosen) category except the current resource.

Related products

Информация

Requires PageBuilder Pro and miniShop3.

Cross-sell on product page ​

  • Excludes current product from picks
  • Product page context, no extra snippet
  • Category and limit in inspector

Typical placement ​

  • Product page: "You may also like"
  • Cart: upsell
  • Thank-you page

Page examples ​

Category and exclude ​

Category, Exclude product (current), Limit. Best on product resource context.

Similar sections ​

Block parameters ​

ParameterValue
keyrelated_products
LayerPro
Categorycommerce (commerce)
Chunkpagebuilderpro_related_products
Requirespro, minishop3

Inspector fields ​

Fill these fields in the section inspector. Field types are documented in the field types reference.

Title (title) ​

Type text. Optional.

Catalog parent (parent) ​

Type relation. Required. Pick one MODX resource in a search modal.

Exclude product (product) ​

Type relation. Optional. Pick one MODX resource in a search modal.

Limit (limit) ​

Type number. Optional.

Sort (sortby) ​

Type select. Optional. Dropdown with predefined options.

Site output ​

pb-related-products grid via msProducts.

Section data ​

Example payload after save. Media, video, and map values may be enriched on output:

json
{
  "title": "Section title",
  "parent": 101,
  "product": 201,
  "limit": 6,
  "sortby": "menuindex"
}

Chunk template ​

Fenom chunk pagebuilderpro_related_products:

fenom
{set $catalogParent = $parent.id|default:($parent_id|default:0)}
{set $excludeId = $product.id|default:($product_id|default:0)}
{set $listing = ''}
{if $catalogParent}
  {set $listing = $modx->runSnippet('msProducts', [
    'parents' => $catalogParent,
    'depth' => 10,
    'limit' => $limit|default:4,
    'tpl' => 'pagebuilderpro_ms3_product_row',
    'includeVendorFields' => '*',
    'includeOptions' => 'color,size',
    'withCurrency' => 1,
    'showZeroPrice' => 1,
    'resources' => ($excludeId > 0) ? ('-' ~ $excludeId) : '',
    'sortby' => $ms_sortby|default:'msProduct.menuindex',
    'sortdir' => $ms_sortdir|default:'ASC'
  ])}
{/if}
<section class="pb-section pb-section--related-products pb-related-products pb-listing{if $cssClass} {$cssClass|escape}{/if}" data-pb-section="related_products"{if $id} id="pb-{$id|escape}"{/if}>
  <div class="pb-section__inner">
    {if $title}
      <h2 class="pb-heading">{$title|escape}</h2>
    {/if}
    {if $listing}
      <div class="pb-listing__grid">
        {$listing}
      </div>
    {else}
      <p class="pb-listing__empty">{'pagebuilder_fe_listing_empty_related' | lexicon}</p>
    {/if}
  </div>
</section>

See also ​