Joomla123.lt

VirtueMart šablono struktūra. Pirma dalis

Ketvirtadienis, 10 kovas 2011 11:24 Parašė Rimvydas Peržiūrų: 1191

( 4 Balsai ) Kam teko dirbti su VirtueMart komponentu tas jau atkreipė dėmesį į tai, kad kiekvienas elementas ar tai būtų kategorijos puslapis, ar prekės ar prekių krepšelio ir .t.t yra saugomas atskirame faile kurie tarpusavyje atitinkama hierarchija “sujungiami” . Tokia struktūra turi savu pliusų ir minusų bet norint pakoreguoti VM šabloną iškyla nemažai klausimų : kuris failas už ką atsakingas. Tai ir yra pagrindinė problema bandant suieškoti ir koreguoti grafinę VirtueMart sąsają, todėl daugelis pradedančių tinklapių kūrėjų sunkiai “įkanda” VirtueMart struktūros ir dizaino pakeitimus. Šiame straipsnyje pabandysiu trumpai apžvelgti failų atsakingų už VirtueMart grafinę sąsają paskirtį.
VirtueMart šablonas susideda iš sekančių pagrindinių elementų:
1.    Prekių kategorijos šablonas (browse) – atvaizduoja prekių sąrašą tam tikroje kategorijoje
2.    Prekės atvaizdavimo šablonas (flypage) – atvaizduoja konkrečią prekę puslapyje.
3.    Prekių krepšelio šablonas (basket) – šablonas atsakingas už prekių krepšelio turinio atvaizdavimą . Kai paspaudžiame nuorodą  “rodyti krepšelį”.
4.    Užsakymo vykdymo (eigos) šablonas (checkout) – šablonas atsakingas už  puslapių atvaizdavimą kurios pasirodo vykdant komandas “Apmokėjimas” , “Pristatymas”.....
5.    Papildomi šablonai – pati didžiausia šablonų grupė kuri atsakinga už įvairias “smulkmenas”.

VirtueMart šablono redagavimas. Pagrindinis šablonas

Įdiegus Virtuemart komponentą pagal nutylėjimą (default) yra įdiegiamas tik vienas šablonas. Jis yra kataloge  components\com_virtuemart\themes\default.
Šis šablonas nesurištas su Virtuemart branduoliu, todėl jį redaguodami pačiame virtuemarte pakeitimų nepadarysime.
Standartinį šablonas susideda iš sekančių katalogų ir failų:
    images – katalogas kuriame patalpinti visi šablono paveikslėliai (bet ne pačių prekių ir kategorijų).
    templates- katalogas su visais puslapių šablonais.
    admin.css -  šis ir sekantys du failai yra šablono stilių failai. Juose aprašomi visi šablono CSS  stiliai.
    admin.styles.css
    theme.css
    theme.js, theme.prototype.js – šablono skriptai sukuriantys įvairius efektus
    theme.config.php – konfiguracinis šablono failas . jame saugomi kai kurie VirtueMart šablono nustatymai (panašiai kaip Joomloje   configuration.php failas)
    theme.php – šablono funkcijų failas . Leidžia pridėti įvairias papildomas funkcijas.
    theme.xml –xml šablono failas. Sukurtas analogiškai kaip ir Joomlos xml failas.

Iš visų išvardintų failų ir katalogų  reikalingas templates katalogas, nes jame saugomi visi "Default" šablono elementai.

Templates katalogą sudaro sekantys subkatalogai:
    basket – krepšelio su prekėmis išvaizda;
    browse -  prekių kategorijos išvaizda;
    checkout – užsakymo “eigos” išvaizda;
    common – šablonai bendri visai parduotuvei;
    order_emalis – laiškų šablonas ;
    pages- papildomų puslapių šablonas;
    product_details – prekės puslapio šablonas.;
Dabar apie juos visus atskirai ir smulkiau:

Katalogas "basket"

Jame yra keturi šablonai kurie naudojami priklausomai nuo parduotuvės konfiguracijos:
    b2b (business to business);
    b2c (buisness to customer);
kuris iš šių būdų naudojamas priklauso ar Virtuemart konfigūracijoje įjungta funkcija “Rodyti "(įskaitant XX% mokesčius)", kai taikoma?”. Jeigu įjungta naudojamas b2c jei ne b2b
    basket_b2b.html.php  - šablonas prekių krepšelio kai naudojamas b2b
    basket_b2с.html.php - šablonas prekių krepšelio kai naudojamas b2c pvz:

    ro_basket_b2b.html.php – prekių krepšelio šablonas b2b tik skaitymui (read-only). Rodomas paskutiniame “žingsnyje” apiforminant pirkimą kur pirkėjas jau nebegali darytį pakeitimų.
    ro_basket_b2c.html.php- prekių krepšelio šablonas b2c tik skaitymui (read-only). Rodomas paskutiniame “žingsnyje” apiforminant pirkimą kur pirkėjas jau nebegali darytį pakeitimų. pvz:

Katalogas "browse"

Šiame kataloge yra šeši šablonai naudojami prekių kategorijų sąrašui atvaizduoti taip pat dar vienas papildomas katalogas.

    browse_1.php – šablonas atvaizduojantis prekių išsidėstymą kategorijoje vienu stulpeliu. Be to, reikia nurodyti atitinkamas kiekis prekių eilutėje.
    browse_2.php – šablonas atvaizduojantis prekių išsidėstymą kategorijoje dviem stulpeliais. Be to, reikia nurodyti atitinkamas kiekis prekių eilutėje:


    browse_3.php, browse_4.php, browse_5.php - atitinkamai 3,4,5 prekės eilutėje.

    browse_lite_pdf.php- šablonas konvertuoja  prekių sąrašą į PDF formatą.

Šiame kataloge dar yra subkatalogas includes. Jame esantys šablonai priskiriami puslapiui browse.

    addtocart_form.tpl.php – mygtuko “Pridėti į krepšelį” šablonas:


    browse_header_all.tpl.php – puslapio pavadinimo “visų prekių sąrašas” šablonas:

 

    browse_header_category.tpl.php- kategorijos pavadinimo + RSS ikonos kategorijų sąraše šablonas:

    browse_header_keyword.tpl.php – puslapio pavadinimo šablonas atvaizduojant paieškos rezultatus. Rodomas tik atliekant paprastą paiešką, bet ne išplėstinę:


      browse_header_manufacturer.tpl.php – Puslapio pavadinimo šablonas pasirinkus funkciją "Gamintojai"

      browse_layouttable.tpl.php (browse_listtable.tpl.php, browse_notables.tpl.php)- Prekių sąrašąs browse gali būti atvaizduojamas trimis būdais:
a)    lentelės tipo(listing with table):

b)    lentelės tipo sąrašo pavidalu po vieną prekę eilutėje (flat product list):

c)    be lentelių naudojant DIV (no table div-based)

    browse_orderbyfields.tpl.php – failas kuriame yra kodas su galimais rušiavimo variantais puslapyje browse;
    browse_orderbyform.tpl.php – rūšiavimo puslapio formos šablonas;
    browse_pagenav.tpl.php – puslapiavimo šablonas;

    browse_searchparameter_form.tpl.php- išplėstinės paieškos formos pavadinimo šablonas;

Katalogas "checkout"

Šiame kataloge esantys šablonai atsakingi už parduotuvės išvaizdą pirkimo eigos apiforminimą.

    checkout_bar.tpl.php – viršutinė grafinė dalis:


   customer_info.tpl.php – šablonas “Informacija apie pirkėją” :

   get_final_confirmation.tpl.php - finalinė užsakymo forminimo dalis:


    get_payment_method.tpl.php- antraštės “Prašome pasirinkti mokėjimo būdą” šablonas:

    get_shipping_address.tpl.php – pristatymo adreso atvaizdavimo šablonas:

    get_shipping_method.tpl.php – “Pristatymo būdai “ užrašo atvaizdavimo šablonas:



     list_payment_methods.tpl.php – “Apmokėjimo būdas” šablonas:

    list_shipping_methods.tpl.php- “Pristatymo būdas” šablonas:

    list_shipto_addresses.tpl.php – “Pristatymo adresų” sąrašo šablonas:

     login_registration.tpl.php -  šablonas puslapio kai neregistruotas vartotojas nori atlikti pirkimą.

Peržvelgėme tris iš septynių templates katalogo subkatalogus. Dabar baigiu šį straipsnį tęsinys bus truputi vėliau. Kas kur kam neaišku siūlau viską aptarti forume.