Կառուցեք ձեր առաջին OpenCart 4 մոդուլը. քայլ առ քայլ
Կառուցեք ձեր առաջին OpenCart 4 մոդուլը. քայլ առ քայլ
OpenCart 4-ը բաց կոդով PHP/MySQL հարթակ է, որն օգտագործում է MVC-L ճարտարապետություն՝ Model, View, Controller և Language: Այս ուղեցույցում մենք կկառուցենք պարզ ընդարձակում (extension), որը ադմին կողմում ունի կարգավորումների ձև, իսկ խանութի կողմում ցուցադրում է ողջույնի հաղորդագրություն: Նպատակն է հասկանալ ֆայլերի կառուցվածքը, ոչ թե գրել բարդ կոդ:
MVC-L կառուցվածքը
OpenCart-ը հստակ բաժանում է ադմին (admin) և խանութ (catalog) կողմերը՝ առանձին կոնտրոլերներով: Յուրաքանչյուր մոդուլ սովորաբար ունի չորս տեսակի ֆայլ.
Հիմնական ֆայլերը
- Controller - տրամաբանությունը (admin/controller/extension/...)
- Model - տվյալների շերտը (admin/model/...)
- View/Template - Twig ձևանմուշ (admin/view/template/...twig)
- Language - տեքստերը (admin/language/en-gb/...)
Քայլ 1. Ադմին կոնտրոլեր և լեզվային ֆայլ
Ստեղծեք կոնտրোլեր admin/controller/extension/hello/module/hello.php ֆայլում: Կոնտրolերը կբեռնի լեզվային ֆայլը, կկարդա կարգավորումները կարգավորման մոդելից և կփոխանցի դրանք ձևանմուշին: Լեզվային ֆայլը՝ admin/language/en-gb/extension/hello/module/hello.php, պարունակում է բոլոր ինտերֆեյսի տեքստերը՝ առանց դրանք կոդում ֆիքսելու:
Քայլ 2. Ադմին ձևանմուշ (Twig)
Կարգավորումների ձևը գրվում է Twig ձևանմուշում՝ admin/view/template/extension/hello/module/hello.twig: Այստեղ դուք ստեղծում եք HTML ձև՝ դաշտերով (օրինակ՝ ողջույնի տեքստ և միացման ստատուս), որոնք պահվում են setting աղյուսակում OpenCart-ի ստանդարտ կարգավորման համակարգի միջոցով:
Քայլ 3. Կարգավորումների պահպանում
OpenCart 4-ում մոդուլների կարգավորումները սովորաբար պահվում են որպես կարգավորման բանալիներ (օրինակ՝ module_hello_status և module_hello_text): Ադմին կոնտրolերը մշակում է save գործողությունը, վավերացնում մուտքը և պահպանում արժեքները: Կարևոր է ստուգել օգտատիրոջ իրավունքները (permission) մինչ պահպանելը:
Քայլ 4. Խանութի (catalog) կողմ
Storefront-ում ստեղծեք առանձին կոնտրոլեր՝ catalog/controller/extension/hello/module/hello.php, որը կարդում է պահված կարգավորումը և render անում Twig ձևանմուշ՝ catalog/view/template/extension/hello/module/hello.twig: Այս ձևով նույն մոդուլը ունի առանձին տրամաբանություն ադմին և հանրային կողմերի համար:
Քայլ 5. Փաթեթավորում որպես OCMOD
OpenCart 4-ում ընդարձակումները բաշխվում են որպես OCMOD փաթեթ՝ ZIP արխիվ՝ install.json ֆայլով արմատում: install.json-ը նկարագրում է անունը, տարբերակը, հեղինակը և OpenCart-ի համատեղելի տարբերակը: Ֆայլերը տեղադրվում են համապատասխան թղթապանակներում արխիվի ներսում:
install.json-ի դաշտերը
- Անվանում և տարբերակ
- Հեղինակ և հղում
- Համատեղելի OpenCart-ի տարբերակ
Քայլ 6. Տեղադրում Extensions մենյուից
Մուտք գործեք ադմին վահանակ, անցեք Extensions բաժին, վերբեռնեք ZIP-ը Extension Installer-ով, ապա ակտիվացրեք մոդուլը Modules ցանկում: Այնուհետև կարող եք բացել կարգավորումների ձևը, լրացնել ողջույնի տեքստը և ստուգել արդյունքը խանութի էջում:
Եզրակացություն: Առաջին մոդուլ կառուցելը հիմնականում MVC-L կառուցվածքը հասկանալու և OCMOD-ով ճիշտ փաթեթավորելու հարց է: Երբ տիրապետեք այս օրինաչափությանը, կարող եք ստեղծել ավելի բարդ ընդարձակումներ նույն հիմքով:
