Wytyczne dla koderów

Instrukcja instalacji nowego szablonu:

1.) Pobranie szablonu „default_new” z katalogu „themes” znajdującego się na serwerze FTP na którym zainstalowany jest sklep.

2.) Zmiana nazwy pobranego katalogu z szablonem na różną od „default_new” (np. „moj_szablon”).

3.) Wgranie szablonu o zmienionej nazwie do katalogu „themes” znajdującego się na serwerze FTP na którym zainstalowany jest sklep.

4.) W Panelu administracyjnym sklepu -> zakładka „Ustawienia” -> sekcja „Główne” -> tab „Graficzne” należy wybrać w polu „Szablon” nazwę katalogu wgranego na serwer oraz zapisać dane.

 Indywidualna zmiana szablonu dla przeglądarki:

W systemie cStore istnieje możliwość ‚podejrzenia’ wyglądu szablonu bez potrzeby zmiany globalnych ustawień o szablonie strony. Oznacza to, że dla użytkownika, który uruchomi odpowiedni link pojawi mu się strona z wybranym szablonem, a dla reszty użytkowników serwisu dalej będzie generowany szablon strony ustawiony w Panel Administratora.

1.) Wchodzimy na stronę sklepu z dodatkowym adresem ?__tplname=nazwa_szablonu gdzie ‚nazwa_szablonu’ jak nazwa wskazuje wskazuje na nazwę szablonu.

2.) Koder przegląda i ewentualnie wprowadza zmiany na wybranym szablonie, jakiekolwiek przechodzenie pomiędzy stronami nie powoduje powrotu do pierwotnych ustawień graficznych.

3.) Po zakończeniu prac aby powrócić do starego szablonu należy wejść na odpowiednio spreparowany link, np. demo.cstore.pl?__tplname=default_new lub usunąć ciasteczka przeglądarki dla danego serwisu.

 Procedura wykonywanych testów szablonu:

1.) Porównanie każdej wdrożonej podstrony z zaprojektowaną wizualizacją. Odwzorowanie projektu 1 do 1 za wykluczeniem przepisywania kategorii oraz danych o produktach.

2.) Zweryfikowanie pozostałych podstron czy są spójne wizualnie i kolorystycznie z podstawowym projektem graficznym.

3.) Przeprowadzenie testów między innymi w oparciu o przeglądarki: Chrome, Firefox, Internet Explorer oraz komórki z systemem Android oraz iOS w zakresie:
– rejestracja nowego konta użytkownika, logowanie
– składanie zamówienia: na koncie klienta zalogowanego oraz wylogowanego, z danymi do wysyłki oraz bez, jako firma oraz osoba prywatna
– wypełnienie formularza kontaktowego

 Struktura szablonu:

1. CSS

   1.1) lang – katalog z generowanymi automatycznie stylami dla danego języka

   a.) autocomplete.css – arkusz stylów dla szybkiej wyszukiwarki (lista pojawiająca się po wpisaniu 3ech liter)

   b.) print.css – arkusz stylów – media: print

   c.) style.css – główny arkusz stylów sklepu

2. EXT

   a.) addCart.php – plik ładujący box „Dodaj do koszyka” – produkt bez cech – edycja stanowczo odradzana
   

   b.) addCartAttr.php – plik ładujący box „Dodaj do koszyka” – produkt z cechami edycja stanowczo odradzana
   

   c.) ajaxCart.php – plik aktualizujący koszyki w czasie rzeczywistym edycja stanowczo odradzana
   

   d.) extra.php – dodatkowy kod PHP użyty ładowany na początku kodu – sugerujemy nie modyfikować już istniejącego kodu. Dodanie własnego w sposób zgodny ze składnią – nieszkodliwe
   

   e.) extra_end.php – dodatkowy plik PHP ładowany na końcu kod sugerujemy nie modyfikować już istniejącego kodu. Dodanie własnego w sposób zgodny ze składnią – nieszkodliwe

3. IMG

   Katalog z grafikami użytymi w obrębie szablonu

4. JS

   a.) fancybox.js – skrypt wykorzystywany w całym systemie (odradzamy modyfikację)

   b.) autocomplete.js skrypt wykorzystywany w całym systemie (stanowczo odradzamy modyfikację)

   c.) cookie.js – skrypt wykorzystywany w całym systemie (stanowczo odradzamy modyfikację)

   d.) cstore.custom.js – plik przeznaczony w całości na dodatkowy kod javascript (jeśli kod ma być ładowany w obrębie całego mechanizmu winien zostać umieszczony właśnie w tym pliku).

   e.) cstore.js – plik systemowy, zawierający wiele używanych w mechanizmie funkcji (zalecamy ostrożność w modyfikowaniu)

   f.) cstore.legacy.js – skrypt wykorzystywany w całym systemie, zawierający wiele niezbędnych do prawidłowego funkcjonowania mechanizmu funckji (stanowczo odradzamy modyfikację)

   g.) jquery-2.1.3.min.js – skrypt wykorzystywany w całym systemie (stanowczo odradzamy modyfikację)

   h.) jquery-ui-1.8.16.custom.min.js – skrypt wykorzystywany w całym systemie (stanowczo odradzamy modyfikację)

   i.) jquery-workarounds.js – skrypt wykorzystywany w całym systemie (stanowczo odradzamy modyfikację)

   j.) jquery.cycle.all.js – skrypt wykorzystywany w całym systemie (odradzamy modyfikację)

   k.) jquery.flow.1.2.auto.js – skrypt wykorzystywany w całym systemie (stanowczo odradzamy modyfikację)

   l.) jquery.jcarousel.min.js – skrypt wykorzystywany w całym systemie (odradzamy modyfikację)

   m.) jquery.multiselect.min.js – skrypt wykorzystywany w całym systemie (odradzamy modyfikację)

   n.) jquery.validate.js – skrypt wykorzystywany w całym systemie (stanowczo odradzamy modyfikację)

   o.) nyroModal.js – skrypt wykorzystywany w całym systemie (odradzamy modyfikację)

   p.) product.js – plik javascript działający tylko w obrębie karty produktu (prosimy modyfikować ostrożnie)

   r.) ui.selectmenu.js – skrypt wykorzystywany w całym systemie (odradzamy modyfikację)

    

5. TEMPLATE

    

   5.1) account – katalog z plikami szablonów – sekcja „Panel Klienta”

   a.) change_points.html – szablon podstrony umożliwiającej wymianę zebranych przez klienta punktów

   b.) main.html – szablon strony głównej sekcji „Moje konto”

   c.) order.html – szablon podglądu pojedynczego, złożonego wcześniej zamówienia

   d.) orders.html – szablon widoku historii zamówień (lista)

   e.) password.html – szablon podstrony umożliwiającej zmianę hasła

   f.) survey.html – szablon podstrony umożliwiającej klientowi wypełnienie ankkiety
   5.2) box – katalog z plikami szablonów – sekcja „Boxy”

   a.) cartBox.html – szablon boxu koszyka (przyklejonego do prawej krawędzi przeglądarki)

   b.) contactBox.html – szablon boxu kontaktowego (przyklejonego do prawej krawędzi przeglądarki)

   c.) productAttrBox.html – szablon boxu pojawiającego się po dodaniu produktu do koszyka (produkt posiada cechy magazynowe)

   d.) productBox.html – szablon boxu pojawiającego się po dodaniu produktu do koszyka (produkt nie posiada cech magazynowych)

   5.3) cms – katalog z plikami szablonów – sekcja „Podstrony Tekstowe”

         5.3.1) sys – artykuły systemowe

   a.) contact.html – szablon systemowej podstrony tekstowej – „Kontakt”

   b.) faq.html – szablon systemowej podstrony tekstowej – „Często zadawane pytania”

   c.) privacy_policy.html – szablon systemowej podstrony tekstowej – „Polityka Prywatności”

   d.) terms_and_conditions.html – szablon systemowej podstrony tekstowej – „Regulamin”

   a.) article.html – szablon podstrony tekstowej – artykuł (dodany via PA sklepu)

   b.) articles.html – szablon podstrony wyświetlającej kategorie artykułów (lista)

   c.) homebanner.html – szablon slidera dla strony głównej

   d.) textpage.html – szablon podstrony tekstowej – podstrona (dodana via PA sklepu)
   5.4) dec – katalog z plikami szablonów – sekcja „Różne”

   a.) breadcrumbs.html – szablon breadcrumbów (ścieżki okruszków)

   b.) language_switcher – szablon bloku językowego

   c.) manufacturer.html – szablon podstrony pojedynczego producenta ( górna część zawartości, dół to lista produktów)
   5.5) menubox – katalog z plikami szablonów – sekcja „Menuboxy”

   a.) bestsellers.html – szablon menuboxa „”

   b.) compare.html – szablon menuboxa „Porównywarka”

   c.) last.html – szablon menuboxa „Ostatnio przeglądane”

   d.) nowosci.html – szablon menuboxa „Nowości”

   e.) ostatnio_dodane.html – szablon menuboxa „Ostatnio dodane”

   f.) producenci.html – szablon menuboxa „Producenci”

   g.) promotions.html – szablon menuboxa „Promocje”

   h.) recenzje.html – szablon menuboxa „Recenzje”

   i.) search.html – szablon menuboxa „Wyszukiwarka”

   j.) storage.html – szablon menuboxa „Przechowalnia”
   5.6) order – katalog z plikami szablonów – „Proces składania zamówienia”

   a.) details_1.html – szablon wysyłek i płatności (z uwagi na dużo zawartego w nim systemowego javascriptu odradzamy daleko posuniętą edycję)

   b.) summaryPageNew.html – szablon podstrony podsumowania zamówienia (po jego finalizacji w koszyku)
   5.7) popup – katalog z plikami szablonów – „Popupy”

   a.) comment.html – szablon popupu „Dodaj Komentarz”

   b.) header.html – szablon nagłówka popupów – edycja odradzana

   c.) negotiate.html – szablon popupu „Negocjuj cenę”

   d.) notify.html – szablon popupu „Powiadomienia mailowe”

   e.) question.html – szablon popupu „Zadaj pytanie o produkt”

   f.) reccomend.html – szablon popupu „Poleć znajomemu”

   5.8) products – katalog z plikami szablonów – „Listy produktów”

         5.8,1) list – listy dodatkowe

   a.) also.html – szablon listy produktów „Klienci którzy kupili ten produkt kupili także”

   b.) groups.html – szablon listy produktów „Produkty powiązane”

   c.) mainpage.html – szablon listy produktów „Strona Główna”

   d.) medium.html – szablon listy produktów „Lista Medium”

   e.) small.html – szablon listy produktów „Lista Small”

   f.) special.html – szablon listy produktów „Strona Główna – Wyróżnione”

   a.) list.html – szablon listy produktów „Lista Podstawowa”

   b.) search_form.html – szablon widoku „wyszukiwarka zaawansowana”
   a.) comment.html – szablon widoku listy komentarzy – zawartej w karcie danego produktu

   b.) comments_list.html – szablon widoku listy komentarzy – lista wszystkich dodanych w sklepie komentarzy

   c.) compare.html – szablon widoku porównywarki

   d.) footer_table.html – szablon bloku „tablica linków w stopce”

   e.) frames.html – szablon bloku „zawartość tekstowa – artykuły na stronie głównej oraz w kategoriach produktów”

   f.) header.html – GŁÓWNY PLIK SZABLONU ŁADUJĄCY NAGŁÓWEK, CONTENT I STOPKĘ

   g.) homepage.html – szablon bloku „Strona główna”

   h.) login.html – szablon podstrony „Logowanie”

   i.) manufacturer_list.html – szablon podstony „Lista producentów”

   j.) manufactures_list.html

   k.) menubox.html – szablon bloku „Wszystkie możliwe do użycia menuboxy” – Edycja nagłówków, klas samych boxów, ułożenia elementów

   l.) page_no.html – szablon bloku paginacji produktów

   m.) registerNew.html – szablon podstrony „Rejestracja” oraz formularza rejestracji w koszyku

   n.) shopcart.html – szablon podstrony „Koszyk”

   o.) show_categories.html – szablon bloku „Lista kategorii” (wyświetlane w przypadku włączenia takiej opcji w PA sklepu – widok zarówno dla strony głównej jak i list produktów).

   p.) show_product.html – szablon podstrony „Karta pojedynczego produktu”

   r.) sitemap.html – szablon podstrony „ Mapa Strony”

   s.) sort.html – szablon bloku „Sortowanie” na listach produktów

   t.) storage.html – szablon podstrony „Przechowalnia”