Uudessa design managerissa jotkin v1-kustomoidut moduulit on ehkä päivitettävä v2-moduulikehykseen, jotta niitä voidaan käyttää tulevan sisällön luomiseen. Uusi moduulikehys on tehokkaampi, luotettavampi ja luo paremman kokemuksen editorissa.
Vaikka voit edelleen käyttää useimpia v1-moduuleja v2-kehyksessä, moduulinHTML + HubL -merkintämuotoonupotettuja moduuleja ei enää tueta. V1:n mukautetuissa moduuleissa nämä sisäkkäiset moduulit renderöitiin ylimääräisinä muokattavina moduuleina sivueditorissa.
Uusi v2-moduulikehys sisältää entistä tehokkaammanmoduulikenttiäosoitteeseenlisätä moduuliin joustavia elementtejä, joita voidaan muokata sivutasolla. Tämä poistaa moduulien sisälle upotetuista moduuleista johtuvat tarpeettomuus- ja yhteensopivuusongelmat, mikä johtaa parempaan suunnittelukokemukseen kokonaisuutena.HubL-tunnisteettuetaan edelleen v2-moduulikehyksessä, mutta vain jos ne viittaavat tiettyyn moduulin kenttätyyppiin. Voit käyttää moduulieditoriin sisäänrakennettuakopiointisnippet-toimintoa varmistaaksesi, että HubL on muotoiltu oikein.
Jos jossakin malleissasi on sisäkkäinen moduuli, saatat nähdä seuraavaa odottamatonta käyttäytymistä:
Voit tarkistaa olemassa olevat v1-kohtaiset mukautetut moduulisi ennen niiden päivittämistä v2:een, jotta voit tunnistaa koodissa olevat sisäkkäiset moduulit ennakoivasti.Sisäkkäinen moduuli on voitu lisätä v1-moduuliin käyttämällä joko rivi- tai lohkosyntaksia.
Inline-syntaksi
{{ widget.my_awesome_field }}
{% rich_text "my_rich_text_nested_module" label='Tämä on sisäkkäin mukautetun moduulin sisällä, ja se renderöidään erillisenä ', html='<div>Minun oletussisältö menee tähän</div>' %}
Lohkon syntaksi
{{ widget.my_awesome_field }}
{% widget_block rich_text "my_rich_text_nested_module" %}
{% widget_attribute "html" %}
<div>
Oletussisältöni tulee tänne
</div>
{% end_widget_attribute "html" %}
{% end_widget_block %}
Aiemmin jompikumpi näistä esimerkeistä renderöi sisällönmuokkauksessa ylimääräisen muokattavan rikkaan tekstin moduulin, jota voitiin mukauttaa vasemmassa sivupalkissa.
Moduulikehyksen v2:ssa sisäkkäinen rikkaan tekstin moduuli ei näy sisältöeditorissa.
Mallin sisäkkäiset moduulit eivät enää ole muokattavissa v2-moduulikehyksessä.Näiden moduulien on oltavaluoda uudelleentyhjästä tai alkuperäisen moduulin kloonatusta ja muokatusta versiosta..
Huomaa: dHubL-tunnisteiden poistaminen moduuleistasi voi johtaa sisällön katoamiseen julkaistuilta sivuilta, blogikirjoituksista tai sähköposteista, joissa viitataan tähän moduuliin. Niin kauan kuin alkuperäinen sisäkkäinen moduuli pysyy v1-kehyksessä eikä sitä päivitetä, kaikki näissä moduuleissa oleva sisältö, joka on jo julkaistu, renderöityy odotetulla tavalla.
Jos haluat luoda uuden version v1-sisäkkäismoduulista käytettäväksi v2-moduulikehyksessä, voit kloonata v1-moduulisi japäivittää kloonin. Tätä päivitettyä kloonattua moduulia voidaan muokata sen varmistamiseksi, että moduuli toimii onnistuneesti uudessa kehyksessä. Vaihtoehtoisesti voitluoda moduulin uudelleen tyhjästä.
Voit kloonata v1-moduulin ja päivittää sen v2:een:
Kun olet luonut uuden moduulisi v2-kehyksessä, sinun on kloonattava ja muokattava kaikkia malleja, joita haluat käyttää tämän moduulin kanssa tulevan sisällön luomiseen.