OpenCart 4 Twig ձևանմուշների ճիշտ հարմարեցումը
OpenCart 4 Twig ձևանմուշների ճիշտ հարմարեցումը
OpenCart 4-ը storefront-ի ձևանմուշների համար օգտագործում է Twig ձևանմուշային շարժիչը: Ձևանմուշները ճիշտ հարմարեցնելը նշանակում է փոխել տեսքը՝ առանց հիմնական (core) ֆայլերը խմբագրելու, որպեսզի թարմացումները չջնջեն ձեր աշխատանքը: Այս հոդվածում կդիտարկենք ճիշտ մոտեցումը:
Որտեղ են գտնվում ձևանմուշները
Storefront-ի Twig ֆայլերը գտնվում են catalog/view/template/ թղթապանակում՝ կազմակերպված ըստ բաժինների (օրինակ՝ common, product, checkout): Ադմին կողմի ձևանմուշները առանձին են՝ admin/view/template/: Յուրաքանչyուր .twig ֆայլ համապատասխանում է կոնկրետ էջի կամ բաղադրիչի:
Ինչպես է աշխատում թեմաների համակարգը
OpenCart 4-ն ունի թեմաների համակարգ, որը թույլ է տալիս ստեղծել ձեր սեփական թեման՝ լռելյայն թեման որպես հիմք օգտագործելով: Երբ էջը render է լինում, համակարգը նախ փնտրում է ձևանմուշը ձեր ակտիվ թեմայում, և եթե այնտեղ չկա, օգտագործում է լռելյայն (default) տարբերակը: Սա հնարավորություն է տալիս վերագրել (override) միայն այն ֆայլերը, որոնք իրականում փոխում եք:
Ոսկե կանոնը
- Երբեք մի խմբագրեք լռելյայն թեմայի core ֆայլերը
- Ստեղծեք սեփական թեմա և վերագրեք միայն անհրաժեշտ ձևանմուշները
- Պահպանեք բնորիգինալ ֆայլերը անփոփոխ թարմացման համար
Ձևանմուշների վերագրումը սեփական թեմայով
Ճիշտ մոտեցումն է ստեղծել նոր թեմա և դրա մեջ պատճենել միայն այն .twig ֆայլը, որը ուզում եք փոխել՝ պահպանելով նույն ֆայլի ուղին: Այսպիսով ձեր փոփոխությունները մեկուսացված են, և OpenCart-ի թարմացումը, որը փոխում է core ֆայլերը, չի վերագրի ձեր աշխատանքը:
OCMOD-ի օգտագործումը markup-ը անվտանգ փոխելու համար
Երբ պետք է փոխել ձևանմուշի փոքր հատված շատ տեղերում կամ բաշխել փոփոխությունը որպես ընդարձակում, OCMOD-ը ավելի հարմար է: OCMOD-ը թույլ է տալիս որոնել ձևանմուշի կոնկրետ տող և փոխարինել կամ ավելացնել markup՝ առանց բուն ֆայլը խմբագրելու: Փոփոխությունները կիրառվում են դինամիկ, ինչը դարձնում է դրանք ավելի թարմացման-անվտանգ:
Ե՞րբ օգտագործել ինչ
- Սեփական թեմա - ամբողջ ձևանմուßի վերաձևավորման համար
- OCMOD - նպատակային, փոքր markup փոփոխությունների և բաշխվող ընդարձակումների համար
Twig-ի տարածված փոփոխականներն ու շարահյուսությունը
Twig-ում փոփոխականները դուրս են բերվում {{ variable }} շարահյուսությամբ, պայմանները՝ {% if %} բլոկներով, իսկ ցիկլերը՝ {% for %} բլոկներով: OpenCart-ի կոնտրոլերը փոխանցում է տվյալները ձևանմուßին որպես փոփոխականներ (օրինակ՝ ապրանքների ցանկ կամ տեքստային բանալիներ լեզվային ֆայլից): Փոփոխականները փոխելու փոխարեն շատ դեպքերում բավական է փոխել միայն դրանց ցուցադրումը:
Փոփոխությունները թարմացման-անվտանգ պահելը
Հիմնական սկզբունքը մեկն է. տարանջատեք ձեր հարմարեցումները core-ից: Օգտագործեք սե{ theme override կամ OCMOD, փաստագրեք ձեր փոփոխությունները և թեստավորեք նոր տարբերակ թարմացնելուց առաջ՝ staging միջավայրում:
Եզրակացություն: Twig ձևանմուշները ճիշտ հարմարեցնելու բանալին core ֆայլերը անձեռնմխելի պահելն է՝ օգտագործելով սեփական թեմա կամ OCMOD: Այս կարգապահությունը ապահովում է, որ ձեր դիզայնը գոյատևի հարթակի թարմացումներին:
