Skapa och redigera moduler
Senast uppdaterad: juni 28, 2023
Tillgänglig med något av följande abonnemang, om inte annat anges:
Alla produkter och planer |
I designhanteringsverktyget kan du skapa anpassade kodade moduler för att lägga till avancerade funktioner till din blogg, sidor eller e-post. Anpassade moduler erbjuder ett brett utbud av funktioner så att innehållet kan anpassashelt och hållet i redigeringsverktyget för sidor, e-postmeddelanden eller bloggar.
Observera: För att skapa moduler krävs kunskap om HTML, CSS, HubL och HubSpot Design Manager. HubSpot rekommenderar att du samarbetar med en utvecklare för att skapa kodade moduler.
Skapa en ny modul
- I ditt HubSpot-konto navigerar du till Innehåll > Design Manager.
- Klicka på rullgardinsmenyn File (Fil) högst upp i sökaren och välj New file (Ny fil).
- I dialogrutan klickar du på rullgardinsmenyn Vad vill du bygga idag? ochväljer Modul.
- Klicka på Nästa.
- Markera kryssrutan bredvid varje typ av innehåll där modulen ska användas: sidor,blogginlägg, blogginlägg, blogglistor, e-post eller citat. Moduler som används i e-postmallar får inte innehålla CSS eller JavaScript.
Observera: anpassade moduler för användning i e-postmeddelanden kan endast skapas på konton med enprenumeration på Marketing Hub Professional eller Enterprise .
- Välj om den här modulen ska vara en lokal modul eller en global modul. Om du skapar englobal modul uppdateras innehållet i den här modulen på alla platser där modulen används.
- Ange ett filnamn för modulen och klicka sedan på Skapa.
Märk din modul
Som standard hänvisar innehållsredigeraren till en modul med det namn som den fick i designhanteraren. Om du vill att modulen ska använda ett annat namn i innehållsredigeraren kan du göra det genom att ange en etikett .
Lägg till fält i din modul
Lägg till fält i modulen för att ställa in modulens innehåll eller stil och göra den redigerbar i innehållsredigeraren. Läs mer om tillgängliga fälttyper i vår dokumentation för utvecklare.
- I modulinspektören till höger klickar du på
rullgardinsmenyn Lägg till fält i avsnittet Fält och väljer sedan ett fält som du vill lägga till i modulen.
- Redigera fältets namn genom att klicka påpennikonen redigera bredvid fältnamnet. Om du vill redigeraHubL-variabelnamnet gör du ändringarna i textfältet HubL-variabelnamn .
Lägg till fältets standardinnehåll
I avsnittet Innehållsalternativ kan du lägga till standardinnehåll som visas när modulen används i mallar och innehållsredigerare. Alternativen för standardinnehållet skiljer sig åt beroende på fälttyp.
I exemplet nedan är fälttypen ett bildfält, så alternativen för standardinnehåll är att välja en standardbild och dölja storleksreglerna.
Ange alternativ för fältredigeraren
I avsnittet Redigeringsalternativ kan du aktivera följande alternativ för hur användare kan redigera modulen i innehållsredigeraren:
- Gör det här fältet obligatoriskt:användaren kan inte lämna det här fältet tomt i innehållsredigeraren.
- Förhindra redigering i innehållsredigerare: fältinnehållet kan inte redigeras i innehållsredigeraren; det kan fortfarande redigeras på mallnivå. Det här alternativet är inte tillgängligt förglobala moduler, som inte kan redigeras på sidnivå.
- Hjälptext för Tooltip: Lägg till hjälptext i fältet för att ge användarna sammanhang eller instruktioner. Hjälptexten visas i en verktygstips när användaren håller muspekaren över fältet under redigeringen.
- Inline-hjälptext: Lägg till hjälptext i fältet för att ge användarna sammanhang eller instruktioner. Hjälptexten visas under fältet när en användare redigerar modulen.
Ställ in villkor för fältvisning
Du kan använda fältvisningsvillkor för att ställa in att ett modulfält endast ska visas om ett annat fält uppfyller vissa kriterier.
- I avsnittetVisningsvillkor klickar du på
rullgardinsmenyn HubL-variabel för att välja ett modulfält och klickar sedan på rullgardinsmenyn är inte tom för att välja villkoret för det fältet. - Om du väljer villkoret är lika med anger du ett värde eller en regex.
I exemplet nedan anges visningsvillkor för ett bildfält. Villkoret är att värdet i ett textfält som heter image_title måste vara lika med Headshot för att bildfältet ska visas i modulen.
Visningsvillkoren aktiveras automatiskt när du har ställt in ett villkor. Omdu vill inaktivera visningsvillkoren klickar du påväxelknappen till höger om Visningsvillkor.
Ställ in alternativ för fältförstärkare
Du kan ställa in repeateralternativ för ditt fält i avsnittet Repeateralternativ . Repeater är fält och grupper som kan skapa flera objekt och visa dem med hjälp av en for-slinga
.
- IavsnittetRepeater-alternativ väljer du ett lägsta och/eller
högsta antal nödvändiga instanser av detta fält. - Du kan också välja att ställa in ett standardobjektantal, vilket är det antal instanser av fältet som kommer att visas som standard i modulen.
I exemplet nedan är bildfältet konfigurerat som ett bildgalleri. Gränserna för antalet objekt är inställda
Repeateralternativen aktiveras automatiskt när du har ändrat ett av alternativen. Omdu vill inaktivera repeateralternativen klickar du påväxelknappen till höger om Repeateralternativ.
Gruppera modulens fält
När du har skapat fält kan du gruppera upp till fyra fält tillsammans för att hålla fälten organiserade efter relevans. Fältgrupper kan användas för att bygga upp anpassad fältlogik. Läs mer om modulfältgrupper.
Gruppera modulfält tillsammans:
- Klicka på Grupp i den högra sidofältet i modulredigeraren.
- Välj de fält som du vill gruppera tillsammans.
- Klicka på Skapa grupp.
Kopiera och klistra in dina fältutdrag
- När du är redo att infoga ett fält i modulen kopierar du fältutdraget och klistrar in det i modulens HTML + HubL-redigerare .
- Om du befinnerdig i fältinspektören klickar du påKopiera utdrag till höger om fältets HubL-variabelnamn.
- Om du befinner dig i modulinspektören, för du muspekaren över fältet och klickar på
rullgardinsmenyn Åtgärder och väljer sedan Kopiera utdrag.
- Klicka på den plats där du vill lägga till fältet i HTML + HubL-redigeraren och klistra sedan in utdraget genom att trycka på Ctrl+V eller Cmd+V.
Skriv din modulsyntax
När du redigerar din modul kan du skriva ytterligare modulsyntax i redigeringsrutorna HTML + HubL, CSS och JS . Läs mer om modulkodredigeraren och modulsyntaxreferensen i HubSpots designerdokumentation.Lägg till hjälptext till din modul
Lägg till hjälptext i avsnittet Redigeringsalternativ för att ge användarna sammanhang när de redigerar modulen. Hjälptexten får inte vara längre än 300 tecken.
När en användare redigerar modulen i en innehållsredigerare visas hjälptexten ovanför modulfälten.
Förhandsgranska din modul
Du kan förhandsgranska hur din modul kommer att se ut och fungera i innehållsredigeraren genom att klicka på knappen Förhandsgranska längst upp till höger i modulredigeraren. Förhandsgranskningen av din modul öppnas i en ny flik. Denna förhandsvisning synkroniseras med redigeraren och uppdateras automatiskt när du arbetar.
Publicera din modul
När du har lagt till fält och skrivit modulsyntaxen kan du publicera modulen. Klicka på Publicera ändringar uppe till höger.
Gör din modul tillgänglig för mallar
- Aktivera växelknappen Gör tillgänglig för mallar längst upp till höger i redigeringsverktyget för att göra den här modulen tillgänglig att lägga till i dina mallar.
- Stäng av denna omkopplare om du vill göra ändringar eller testa modulens funktionalitet. Om den här inställningen är inaktiverad kommer ditt team att få en varning om att den här modulen inte är tillgänglig för mallar.
Lägg till din modul i en mall
När du har publicerat en modul kan du använda den på alla dina sidor genom att lägga till den i en mall.
Lägg till en modul i en mall som du drar och släpper:
- Klicka på fliken Lägg till högst upp i layoutinspektören i malllayoutredigeraren och sök sedan efter modulen. Anpassade moduler som du har skapat kan identifieras med ikonen för anpassad modul: customModules.
- Dra och släpp modulen i mallen.
Om du vill lägga till en modul i en kodad mall kan du kopiera och klistra in modulutdraget i mallen:
- Om du vill kopiera modulutdraget från modulredigeraren klickar du på Kopiera utdrag längst ner i den högra sidofältet.
- Kopiera modulutdraget från designhanterarens vänstra sidofält:
- I den vänstra sidofältet hittar du den anpassade modulen.
- Högerklicka på modulen och välj sedan Kopiera utdrag. Alternativt kan du markera modulen, klicka på Åtgärder i övre vänstra hörnet och välja Kopiera utdrag.
- I den kodade mallen klistrar du in utdraget där det behövs.