DokumentationHandelInnehåll och design

Layoutuppdateringar

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Nybörjare
  • Mellanliggande
  • Administratör
  • Användare

Innan du börjar arbeta med anpassade layoutuppdateringar är det viktigt att du förstår hur sidorna i din butik är uppbyggda och skillnaden mellan termerna layout och layoutuppdatering. Layout avser sidans visuella och strukturella komposition. Layoutuppdatering är en specifik uppsättning XML-instruktioner som kan åsidosätta eller anpassa hur sidan utformas.

XML-layouten för Commerce-arkivet är en hierarkisk struktur med behållare och block. Vissa element visas på varje sida och andra visas bara på specifika sidor. Mer information om layout, behållare och block finns i Översikt över layouter i Utvecklarhandbok för Edge.

Verktyget Widget är ett enkelt sätt att lägga till ett befintligt innehållsblock i standardlayouten för en sida. För mer avancerade uppdateringar måste du spara XML-layoutens uppdateringskod på servern och sedan referera filen som en anpassad layoutuppdatering från administratören. En översikt över processen finns i Använda layoutuppdateringar.

I följande diagram är namnen som refererar till behållare svarta och blocktyperna, eller blockklasssökvägarna, blå.

Standardlayoutdiagram för block

Blocktyp
Beskrivning
page/html
Blockets namn är root och det är ett av de få rotblocken i layouten. Du kan också skapa ett eget block och ge det namnet root, som är standardnamnet för block av den här typen. Det får bara finnas ett block av den här typen per sida.
page/html_head
Blocknamnet är head och är underordnat rotblocket. Det kan bara finnas ett block av den här typen per sida och det får inte tas bort.
page/html_notices
Blocknamnet är global_notices och är underordnat rotblocket. Om det här blocket tas bort från layouten visas inte de globala meddelandena på sidan. Det får bara finnas ett block av den här typen per sida.
page/html_header
Blocknamnet är header och är underordnat rotblocket. Det här blocket motsvarar sidhuvudet högst upp på sidan och innehåller flera standardblock. Det kan bara finnas ett block av den här typen per sida och det får inte tas bort.
page/html_wrapper
Även om det ingår i standardlayouten är det här blocket föråldrat och inkluderas endast för att säkerställa bakåtkompatibilitet. Använd inte block av den här typen.
page/html_breadcrumbs
Namnet på det här blocket är breadcrumbs och det är underordnat rubrikblocket. Detta block visar vägbeskrivningar för den aktuella sidan. Det får bara finnas ett block av den här typen per sida.
page/html_footer
Blocknamnet är footer och är underordnat rotblocket. Sidfotsblocket motsvarar den synliga sidfoten längst ned på sidan och innehåller flera standardblock. Det kan bara finnas ett block av den här typen per sida och det får inte tas bort.
page/template_links
Det finns två block av den här typen i standardlayouten. top.links-blocket är underordnat rubrikblocket och motsvarar den övre navigeringsmenyn. footer_links-blocket är underordnat sidfotsblocket och motsvarar den nedre navigeringsmenyn.

Obs! ​Det går att ändra malllänkarna, vilket visas i exemplen.
page/switch
Det finns två block av den här typen i en standardlayout. store_language-blocket är underordnat rubrikblocket och motsvarar den översta språkväljaren. Blocket store_switcher är underordnat sidfotsblocket och motsvarar väljaren för det nedre arkivet.
kärna/meddelanden
Det finns två block av den här typen i en standardlayout. Blocket global_messages visar globala meddelanden. Blocket messages används för att visa alla andra meddelanden. Om ni tar bort dessa block ser kunden inga meddelanden.
core/text_list
Den här typen av block används ofta i hela Commerce som platshållare för återgivning av underordnade block.
core/profiler
Det finns bara en instans av den här typen av block per sida. Den används för den interna profileraren Commerce och ska inte användas för något annat ändamål.

Montera ett block med layoutredigeringar

Med layoutuppdateringar kan du anpassa layouten för en sida. Layoutuppdateringar ger större flexibilitet än widget, men kräver åtkomst till servern och grundläggande kunskaper i XML.

Följande steg visar hur du använder en layoutuppdatering för att placera ett block på en sida. Specifika exempel och hjälp med syntaxen finns i Vanliga layoutanpassningsuppgifter i Utvecklarhandbok för Edge.

Steg 1: Skapa blocket

  1. Skapa det block som du vill montera.

  2. Observera block_id eftersom den används i instruktionerna för layoutuppdatering.

Steg 2: Skapa layoutuppdateringen i XML

  1. Disponera layoutinstruktionerna i XML till Referera till ett CMS-block.

  2. Spara layoutinstruktionerna på servern i layoutmappen där XML-filer sparas för temat.

    Exempel:

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

    Layouthandtaget är det filnamn som börjar med cms_page_view_selectable_, följt av URL-nyckeln för CMS-sidan, layoutredigeringsalternativet och filsuffixet xml. I följande exempel är customer-service sidans URL-nyckel och ChatTool är det alternativ som du väljer för att tillämpa layoutredigeringen på sidan.

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

    table 0-row-2 1-row-2 2-row-2 layout-auto
    Element Beskrivning
    CMS-sididentifierare Sidans URL-nyckel med ett snedstreck (/) ersatt med ett understreck (_).
    Namn på layoutuppdatering Det alternativ som visas för anpassad layoutuppdatering.

Steg 3: Referera layoutuppdateringen från sidan

  1. Gå till Content > Elements>Pages ​på sidofältet_ Admin _.

  2. Leta upp sidan där du vill placera blocket och öppna den i redigeringsläge.

  3. Bläddra nedåt och utöka Expansionsväljaren i avsnittet Design.

  4. Om du vill visa alla tillgängliga layoutuppdateringar som är kopplade till sidan klickar du på menyn Custom Layout Update.

    Listan med anpassad layoutuppdatering {width="400" modal="regular"}

  5. Välj den layoutredigering som du vill använda på sidan.

Steg 4: Spara och uppdatera cachen

  1. Klicka på Save & Close när du är klar.

  2. Klicka på Cache Management i meddelandet längst upp på arbetsytan och uppdatera alla ogiltiga cacheobjekt.

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