DocumentatieCommerceInhoud en ontwerp

[Alleen PaaS]{class="badge informative" title="Is alleen van toepassing op Adobe Commerce op Cloud-projecten (door Adobe beheerde PaaS-infrastructuur) en op projecten in het veld."}

Layout-updates

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:
  • CMS

Gemaakt voor:

  • Beginner
  • tussenpersoon
  • Beheerder
  • Gebruiker

Alvorens u met de updates van de douanelay-out begint te werken, is het belangrijk om te begrijpen hoe de pagina's van uw opslag worden geconstrueerd, en het verschil tussen de termijnen lay-out en lay-outupdate. Layout verwijst naar de visuele en structurele samenstelling van de pagina. Layout bijwerken verwijst naar een specifieke set XML-instructies die de manier waarop de pagina wordt samengesteld kan overschrijven of aanpassen.

De XML-indeling van uw Commerce -winkel is een hiërarchische structuur van containers en blokken. Sommige elementen worden op elke pagina weergegeven en andere alleen op specifieke pagina's. Meer over lay-out, containers, en blokken leren, zie het ​ overzicht van Lay-outs ​ in de Voorste Gids van de Ontwikkelaar.

Het ​ hulpmiddel van Widget ​ is een gemakkelijke manier om een bestaand ​ inhoudsblok ​ aan de standaardlay-out van een pagina toe te voegen. Voor geavanceerdere updates moet u de updatecode van de XML-indeling opslaan op de server en het bestand vervolgens verwijzen als een aangepaste update van de layout van de beheerder. Voor een overzicht van het proces, zie {de Updates van de Lay-out van 0} Gebruik 🔗.

In het volgende diagram zijn de namen die naar containers verwijzen zwart en de bloktypen, of blokklassenpaden, blauw.

​ Standaard schema van de bloklay-out ​ {width="500" modal="regular"}

Bloktype
Beschrijving
page/html
De naam van dit blok is root en het is een van de weinige basisblokken in de layout. U kunt ook uw eigen blok maken en dit root noemen. Dit is de standaardnaam voor blokken van dit type. Er kan slechts één blok van dit type per pagina zijn.
page/html_head
De bloknaam is head en is een onderliggend element van het hoofdblok. Er kan slechts één blok van dit type per pagina zijn en het mag niet worden verwijderd.
page/html_notices
De bloknaam is global_notices en is een onderliggend element van het hoofdblok. Als dit blok uit de lay-out wordt verwijderd, verschijnen de globale berichten niet op de pagina. Er kan slechts één blok van dit type per pagina zijn.
page/html_header
De bloknaam is header en is een onderliggend element van het hoofdblok. Dit blok komt overeen met de visuele koptekst boven aan de pagina en bevat verschillende standaardblokken. Er kan slechts één blok van dit type per pagina zijn en het mag niet worden verwijderd.
page/html_wrapper
Hoewel dit blok is opgenomen in de standaardlay-out, is het afgekeurd en is het alleen opgenomen om achterwaartse compatibiliteit te garanderen. Gebruik geen blokken van dit type.
page/html_breadcrumbs
De naam van dit blok is breadcrumbs en het is een onderliggend element van het koptekstblok. In dit blok worden broodkruimels voor de huidige pagina weergegeven. Er kan slechts één blok van dit type per pagina zijn.
page/html_footer
De bloknaam is footer en is een onderliggend element van het hoofdblok. Het voettekstblok komt overeen met de visuele voettekst onder aan de pagina en bevat verschillende standaardblokken. Er kan slechts één blok van dit type per pagina zijn en het mag niet worden verwijderd.
page/template_links
De standaardlay-out bevat twee blokken van dit type. Het blok top.links is een onderliggend element van het koptekstblok en komt overeen met het bovenste navigatiemenu. Het blok footer_links is een onderliggend element van het voettekstblok en komt overeen met het onderste navigatiemenu.

Nota: ​Het is mogelijk om de malplaatjeverbindingen te manipuleren, zoals aangetoond in de voorbeelden.
page/switch
Een standaardlay-out bevat twee blokken van dit type. Het store_language -blok is een onderliggend element van het headerblok en komt overeen met de bovenste taalswitch. Het store_switcher -blok is een onderliggend element van het voettekstblok en komt overeen met de onderste winkelschakeloptie.
kern/berichten
Een standaardlay-out bevat twee blokken van dit type. In het blok global_messages worden algemene berichten weergegeven. Het blok messages wordt gebruikt om alle andere berichten te tonen. Als u deze blokken verwijdert, ziet de klant geen berichten.
core/text_list
Dit type blok wordt in Commerce op grote schaal gebruikt als plaatsaanduiding voor het renderen van onderliggende blokken.
core/profiler
Er is slechts één instantie van dit type blok per pagina. Deze wordt gebruikt voor de interne Commerce profiler en mag niet voor andere doeleinden worden gebruikt.

Een blok plaatsen met layoutupdates

​ de updates van de Lay-out ​ maken het mogelijk om de lay-out van een pagina aan te passen. De updates van de lay-out bieden meer flexibiliteit dan a ​ widget ​ aan, maar vereisen toegang tot de server en een basiskennis van XML.

In de volgende stappen wordt getoond hoe u een lay-outupdate kunt gebruiken om een blok op een pagina te plaatsen. Voor specifieke voorbeelden en hulp met syntaxis, zie ​ Gemeenschappelijke taken van de lay-outaanpassing ​ in de Voorste Gids van de Ontwikkelaar.

Stap 1: Maak het blok

  1. Creeer het ​ blok ​ dat u wilt plaatsen.

  2. Neem nota van block_id, omdat het in de instructies van de lay-outupdate wordt gebruikt.

Stap 2: De layout-update in XML samenstellen

  1. Stel de lay-outinstructies in XML samen aan ​ Verwijzing een Blok van CMS ​.

  2. Sparen de ​ lay-outinstructies ​ op de server in de lay-outomslag waar de dossiers van XML voor het thema worden bewaard.

    Bijvoorbeeld:

    <theme_dir>/<Namespace>_<Module>/layout

    De greep voor de layout is de bestandsnaam die begint met cms_page_view_selectable_ , gevolgd door de URL-sleutel van de CMS-pagina, de optie voor het bijwerken van de layout en het achtervoegsel van het bestand xml . In het volgende voorbeeld is customer-service de URL-sleutel van de pagina en is ChatTool de optie die u selecteert om de layout-update toe te passen op de pagina.

    cms_page_view_selectable_<customer-service> _< ChatTool> .xml

    table 0-row-2 1-row-2 2-row-2 layout-auto
    Element Beschrijving
    CMS-pagina-id De URL-sleutel van de pagina met een slash (/) die door een onderstrepingsteken (_) wordt vervangen.
    Naam van update layout De optie die voor Update van de Lay-out van de Douane verschijnt.

Stap 3: Verwijs naar de layout-update van de pagina

  1. Voor Admin sidebar, ga Content > Elements>Pages.

  2. Zoek de pagina waar u het blok wilt plaatsen en open het in uitgeven wijze.

  3. De rol neer en breidt selecteur van de Uitbreiding uit de Design sectie.

  4. Klik op het menu Custom Layout Update om alle beschikbare lay-outupdates weer te geven die aan de pagina zijn gekoppeld.

    ​ de lijst van de Update van de Lay-out van de Douane ​ {width="400" modal="regular"}

  5. Selecteer de layout-update die u op de pagina wilt toepassen.

Stap 4: De cache opslaan en vernieuwen

  1. Klik op Save & Close als de bewerking is voltooid.

  2. Klik in het bericht boven aan de werkruimte op Cache Management en vernieuw alle ongeldige cache-items.

recommendation-more-help
2b0136b4-ef75-405f-9734-60d741f198de