docs.modx.pro
  1. Extras
  2. PageBuilder
  3. Section catalog
  4. Pro
  5. Product comparison

Product comparison ​

Pick several products in the inspector: the site renders a spec table with one column per product.

Product comparison

Информация

Requires PageBuilder Pro and miniShop3.

Comparison in PageBuilder ​

  • Optional highlight for differing cells
  • Pick products in inspector, not query strings

Where to show ​

  • Compare page in catalog
  • B2B alternative picker
  • Landing: two or three SKUs side by side

Page examples ​

Products and highlight ​

Products is a multirelation. Highlight differences marks differing values. The type is marked "cacheable": false.

Similar sections ​

Block parameters ​

ParameterValue
keyproduct_comparison
LayerPro
CategoryCommerce (commerce)
Chunkpagebuilderpro_product_comparison
Requirespro, minishop3

Inspector fields ​

Field types: field types reference.

Title (title) ​

Type text. Optional.

Products (products) ​

Type multirelation. Required. Pick multiple resources. JSON stores resource IDs.

Highlight differences (highlight_differences) ​

Type yesno. Optional. Yes/no toggle.

Site output ​

pb-product-comparison table.

Section data ​

Example payload after save:

json
{
  "title": "Section title",
  "products": [
    201,
    202,
    203
  ],
  "highlight_differences": true
}

Chunk template ​

Fenom chunk pagebuilderpro_product_comparison:

fenom
{set $productIds = $comparison_product_ids|default:''}
{set $listing = ''}
{if $productIds}
  {set $listing = $modx->runSnippet('msProducts', [
    'parents' => 0,
    'resources' => $productIds,
    'limit' => 4,
    'tpl' => 'pagebuilderpro_product_comparison_cell',
    'includeVendorFields' => '*',
    'includeOptions' => '*',
    'withCurrency' => 1,
    'showZeroPrice' => 1
  ])}
{/if}
<section
  class="pb-section pb-section--product-comparison pb-product-comparison{if $highlight_differences} pb-product-comparison--diff{/if}{if $cssClass} {$cssClass|escape}{/if}"
  data-pb-section="product_comparison"
  {if $id} id="pb-{$id|escape}"{/if}
>
  <div class="pb-section__inner pb-product-comparison__inner">
    {if $title}
      <h2 class="pb-heading pb-product-comparison__title">{$title|escape}</h2>
    {/if}
    {if $listing}
      <div class="pb-product-comparison__scroll" tabindex="0" role="region" aria-label="{$title|default:'Product comparison'|escape}">
        <div class="pb-product-comparison__grid">
          {$listing}
        </div>
      </div>
    {else}
      <div class="pb-listing__empty">
        <p>{'pagebuilder_fe_comparison_empty_lead' | lexicon}</p>
        <p>{'pagebuilder_fe_comparison_empty_hint' | lexicon}</p>
      </div>
    {/if}
  </div>
</section>

See also ​