Layout Update XML

Overview

If you wish to prepend or append text to your list and wish to translate your list, we suggest to create a dedicated content type. e.g: “List of news”, composed with a wysiwyg editor and the following layout xml. Otherwise, you can simply use a CMS → Pages and use the following layout xml in the corresponding textarea.

Information:

  • setTitle($title) -> $title: title of the ContentList
    • setCtType($identifier) $identifier: identifier of the ContentType
    • setCtId($id) $id: id of the ContentType
    • setPager($enable) $enable: boolean
    • setPagerPosition($position) $position: 0 (top), 1 (bottom), 2 (top & bottom)
    • setLimitPerPage($limit) $limit: integer
    • setLimitDisplay($limit) $limit: integer
    • setOrderField($order) $order: id of the attribute
    • setSortOrder($order) $order: ASC or DESC

  • addAttributeToShow($attribute, $params)

  • $attribute: identifiant de l’attribut

  • $params: tableau de paramètres, voir les clés suivantes:

  • label: 0 (hide label) 1 (show above) 2 (show belove) 3 (show inline)

  • label_type: tag html de l’élément

  • html_label_tag: tag html du label de l’élément

  • html_tag: tag html du conteneur de l’élément

  • html_id: id html du conteneur de l’élément

  • html_class: classe(s) html du conteneur de l’élément

  • has_link: boolean, définit si l’élément est transformé en lien cliquable

    Seulement pour le type de champs ‘file’:

    • type: file_filename_without (nom du fichier sans l’extension) file_filename_with (nom du fichier avec l’extension) file_custom_label (label personnalisé)

  • extra: si type vaut file_custom_label: label pour le fichier

    Seulement pour le type de champs ‘image’:

    • type: image_cropped (image cropé) image_original (image originale)

  • width: nombre entier (largeur de l’image)

  • height: nombre entier (hauteur de l’image)

  • link: boolean (liens vers l’image originale)

    Seulement pour le type de champs ‘date’:

    • type: date_short (date courte) date_medium (date standarde) date_long (date complète)

    Seulement pour le type de champs ‘datetime’:

    • type: date_time_short (date courte) date_time_medium (date standarde) date_time_long (date complète)

    Seulement pour le type de champs ‘product’:

    • type: product_name (nom du produit) product_name_image (image et nom du produit) product_name_price (nom et prix du produit) product_name_image_price (nom, image et prix du produit) product_all (affichage du produit comme dans le thème)

    Seulement pour le type de champs ‘category’:

    • type: category_name (affiche le nom de la catégorie)

    Seulement pour le type de champs ‘content’:

    • type: content_name_linked (affiche le titre avec lien des contents) content_name (affiche le titre des contents)

    Seulement pour le type de champs ‘attribute’:

    • type: attribute_list_values (affiche la valeur des attributs sous forme de liste) attribute_list_titles (affiche le titre des attributs sous forme de liste) attribute_comma_values (affiche la valeur des attributs à la suite) attribute_comma_titles (affiche le titre des attributs à la suite)

    Seulement pour le type de champs ‘checkbox’:

    • type: checkbox_list_values (affiche les valeurs sous forme de liste) checkbox_list_titles (affiche les titres sous forme de liste) checkbox_comma_values (affiche les valeurs à la suite) checkbox_comma_titles (affiche les titres à la suite)

    Seulement pour le type de champs ‘multiple’:

    • type: multiple_list_values (affiche les valeurs sous forme de liste) multiple_list_titles (affiche les titre sous forme de liste) multiple_comma_values (affiche les valeurs à la suite) multiple_comma_titles (affiche les titre à la suite)

    Seulement pour le type de champs ‘radio’:

    • type: radio_select_value (affiche la valeur) radio_select_title (affiche le titre)

    Seulement pour le type de champs ‘drop_down’:

    • type: drop_select_value (affiche la valeur) drop_select_title (affiche le titre)

  • addAttributeToFilter($attribute, $condition, $value)

  • $attribute: identifiant de l’attribut

  • $condition: opérateur de comparaison mathématique

  • $value: valeur à comparer

    addLink($label, $position) $label: intitulé $position: top ou bottom

Exemple

referenceContainer <span>name=</span><span class="string">"content"</span><span>></span>
<span>    </span>block <span>class=</span><span class="string">"Blackbird\ContentManager\Block\Content\Widget\ContentList"</span> <span>name=</span><span class="string">"content_type_identifier_list"</span> <span>></span>
<span>        </span>action <span>method=</span><span class="string">"setTitle"</span><span>></span>
<span>            </span>argument <span>name=</span><span class="string">"title"</span> <span>xsi:type=</span><span class="string">"string"</span><span>></span><span>My Title</span><span class="keyword">argument></span>
<span>        </span><span class="keyword">action></span>
<span>        </span>action <span>method=</span><span class="string">"setCtType"</span><span>></span>
<span>            </span>argument <span>name=</span><span class="string">"type"</span> <span>xsi:type=</span><span class="string">"string"</span><span>></span><span>content_type_identifier</span><span class="keyword">argument></span>
<span>        </span><span class="keyword">action></span>
<span>        </span>action <span>method=</span><span class="string">"setPager"</span><span>></span>
<span>            </span>argument <span>name=</span><span class="string">"pager"</span> <span>xsi:type=</span><span class="string">"boolean"</span><span>></span><span>true</span><span class="keyword">argument></span>
<span>        </span><span class="keyword">action></span>
<span>        </span>action <span>method=</span><span class="string">"setPagerPosition"</span><span>></span>
<span>            </span>argument <span>name=</span><span class="string">"pager"</span> <span>xsi:type=</span><span class="string">"string"</span><span>></span><span>1</span><span class="keyword">argument></span>
<span>        </span><span class="keyword">action></span>
<span>        </span>action <span>method=</span><span class="string">"setLimitPerPage"</span><span>></span>
<span>            </span>argument <span>name=</span><span class="string">"limit_per_page"</span> <span>xsi:type=</span><span class="string">"string"</span><span>></span><span>5</span><span class="keyword">argument></span>
<span>        </span><span class="keyword">action></span>
<span>        </span>action <span>method=</span><span class="string">"setLimitDisplay"</span><span>></span>
<span>            </span>argument <span>name=</span><span class="string">"limit_display"</span> <span>xsi:type=</span><span class="string">"string"</span><span>></span><span>10</span><span class="keyword">argument></span>
<span>        </span><span class="keyword">action></span>
<span>        </span>action <span>method=</span><span class="string">"setOrderField"</span><span>></span>
<span>            </span>argument <span>name=</span><span class="string">"order_field"</span> <span>xsi:type=</span><span class="string">"string"</span><span>></span><span>attribute_code</span><span class="keyword">argument></span>
<span>        </span><span class="keyword">action></span>
<span>        </span>action <span>method=</span><span class="string">"setSortOrder"</span><span>></span>
<span>            </span>argument <span>name=</span><span class="string">"sort_order"</span> <span>xsi:type=</span><span class="string">"string"</span><span>></span><span>ASC</span><span class="keyword">argument></span>
<span>        </span><span class="keyword">action></span>
<span>        </span>action <span>method=</span><span class="string">"addAttributeToShow"</span><span>></span>
<span>            </span>argument <span>name=</span><span class="string">"attribute"</span> <span>xsi:type=</span><span class="string">"string"</span><span>></span><span>title</span><span class="keyword">argument></span>
<span>            </span>argument <span>name=</span><span class="string">"params"</span> <span>xsi:type=</span><span class="string">"array"</span><span>></span>
<span>                </span>item <span>name=</span><span class="string">"has_link"</span> <span>xsi:type=</span><span class="string">"string"</span><span>></span><span>1</span><span class="keyword">item></span>
<span>            </span><span class="keyword">argument></span>
<span>        </span><span class="keyword">action></span>
<span>        </span>action <span>method=</span><span class="string">"addAttributeToShow"</span><span>></span>
<span>            </span>argument <span>name=</span><span class="string">"attribute"</span> <span>xsi:type=</span><span class="string">"string"</span><span>></span><span>description</span><span class="keyword">argument></span>
<span>        </span><span class="keyword">action></span> 
<span>        </span>action <span>method=</span><span class="string">"addAttributeToShow"</span><span>></span>
<span>            </span>argument <span>name=</span><span class="string">"attribute"</span> <span>xsi:type=</span><span class="string">"string"</span><span>></span><span>image</span><span class="keyword">argument></span>
<span>            </span>argument <span>name=</span><span class="string">"params"</span> <span>xsi:type=</span><span class="string">"array"</span><span>></span>
<span>                </span>item <span>name=</span><span class="string">"width"</span> <span>xsi:type=</span><span class="string">"string"</span><span>></span><span>100</span><span class="keyword">item></span>
<span>                </span>item <span>name=</span><span class="string">"height"</span> <span>xsi:type=</span><span class="string">"string"</span><span>></span><span>100</span><span class="keyword">item></span>
<span>                </span>item <span>name=</span><span class="string">"has_link"</span> <span>xsi:type=</span><span class="string">"string"</span><span>></span><span>1</span><span class="keyword">item></span>
<span>            </span><span class="keyword">argument></span>
<span>        </span><span class="keyword">action></span>
<span>        </span>
<span>        </span>action <span>method=</span><span class="string">"addAttributeToFilter"</span><span>></span>
<span>            </span>argument <span>name=</span><span class="string">"attribute"</span> <span>xsi:type=</span><span class="string">"string"</span><span>>promote<span class="keyword">argument</span>></span>
<span>            </span>argument <span>name=</span><span class="string">"condition"</span> <span>xsi:type=</span><span class="string">"string"</span><span>>eq<span class="keyword">argument</span>></span>
<span>            </span>
<span>            </span>argument <span>name=</span><span class="string">"value"</span> <span>xsi:type=</span><span class="string">"string"</span><span>>1<span class="keyword">argument</span>></span>
<span>        </span><span class="keyword">action></span>
<span>        </span>action <span>method=</span><span class="string">"addLink"</span><span>></span>
<span>            </span>argument <span>name=</span><span class="string">"label"</span> <span>xsi:type=</span><span class="string">"string"</span><span>></span><span>Read more</span><span class="keyword">argument></span>
<span>            </span>argument <span>name=</span><span class="string">"position"</span> <span>xsi:type=</span><span class="string">"string"</span><span>></span><span>bottom</span><span class="keyword">argument></span>
<span>        </span><span class="keyword">action></span>
<span>    </span><span class="keyword">block></span>
<span class="keyword">referenceContainer></span>
Loading...