Wymagania i instalacja

Aby skrypt działał poprawnie na Twoim serwerze, powinien on spełniać następujące wymagania:

• obsługa skryptów PHP (wersja PHP w wersji 5.6.x lub 7.0.x (znak "x" oznacza dowolną liczbę naturalną) - jak sprawdzić wersję php mojego serwera?).
• włączona funkcja mail() potrzebna do wysyłania e-maili. Jeśli wysyłanie nie będzie działo lub funkcja mail() będzie wyłączona to wyczyść pole "Email administratora" w konfiguracji.
• włączona opcja allow_url_fopen, potrzebna do poprawnego działania funkcji "Sprawdź poprawki" i "Dodatki". Ten punkt wymagania dotyczy tylko Quick.Cart.Ext

Podstawowe wymagania do poprawnego dodawania zdjęć:

• zainstalowana biblioteka gd2 (jak sprawdzić czy mam bibliotekę GD?),
• wgrywane zdjęcia nie powinny być szersze lub dłuższe niż 2000px.

Pobrany skrypt rozpakuj i wykonaj jedną z dwóch opcji:

1. Uruchom skrypt na Twoim komputerze używając do tego serwera XAMPP, WAMP lub EasyPHP. Zalecane do testowania skryptu i etapu przygotowywania strony.

   Nie wiesz jak stworzyć własny serwer lokalny? Przeczytaj instrukcję instalacji serwera lokalnego.

2. Uruchom skrypt na serwerze zewnętrznym np. kei.pl, home.pl, nazwa.pl, itp. Zalecane do testowania skryptu i wgrania gotowej strony.
   • ustaw w programie obsługującym połączenie FTP, opcję typ transferu na binarny,
   • nadaj prawa dostępu 777 (inaczej: rwxrwxrwx) dla katalogów:
     • "database" - oraz dla wszystkich plików i podkatalogów w tym katalogu,
     • "files" - oraz dla wszystkich plików i podkatalogów w tym katalogu.

   Dla większego bezpieczeństwa, zastosuj prawa 700 dla wymienionych wyżej katalogów i podkatalogów oraz 600 dla plików i sprawdź czy skrypt będzie działał poprawnie. W przeciwnym razie, przywróć poprzednie prawa dostępu. Przeczytaj instrukcję nadawania praw plikom.

Aby panel administracyjny skryptu funkcjonował poprawnie, poznaj minimalne wymagania związane z przeglądarką internetową. Minimalna szerokość okna: 1280 pikseli, minimalna wersja: FireFox 32, Chrome 37, Opera 12, Internet Explorer 11, włączona obsługa Java Script i ciastek (cookies). Nie zalecamy usuwania ciastek po każdym zamknięciu przeglądarki.

Jeśli Twój serwer spełnia powyższe wymagania i wgrałeś na niego wszystkie pliki znajdujące się w ściągniętej paczce:

• pod adresem Twojego serwera powinna wyświetlać się już strona główna,
• jeśli za adresem strony głównej dopiszesz admin.php (np. www.twoj-adres.pl/admin.php), znajdziesz się na stronie logowania do administracji Twojego Quick.Cart'a,
• domyślnie dane do zalogowania się do panelu administracyjnego:
  • login: admin
  • hasło: admin
  Uwaga! Po zalogowaniu koniecznie zmień login i hasło w konfiguracji.
• po uruchomieniu strony koniecznie zmień nazwę pliku "admin.php" na inny dla przykładu: "0a348e.php". Po tej zmianie panel administracyjny będzie wywoływany z przeglądarki pod adresem: www.twoj-adres.pl/0a348e.php. Nie udostępniaj tego adresu osobom trzecim, by znacznie utrudnić próbę włamania na Twoją stronę.
• w wersji v6.2 i wyższej, edytuj plik "database/config/general.php" i poszukaj zmiennej $config['admin_file'], a następnie zmień wartość "admin.php" na nową nazwę pliku czyli w tym przypadku "0a348e.php".

Zapoznaj się także z działem "Kwestie bezpieczeństwa".

Skorzystaj ze specjalnie przygotowanej instrukcji obsługi z której dowiesz się jak krok po kroku zarządzać swoją stroną internetową.

Wyłączanie dodatków

$config['plugins']['plugins'] = true;

$config['plugins']['plugins'] = false;

$config['hide_theme'] = true;

Tryb deweloperski (developer mode)

$config['developer_mode_for_ip'] = '1.1.1.1'; // gdzie 1.1.1.1 to IP osoby, która ma mieć włączony tryb deweloperski

Instalacja dodatków

Na samym początku skorzystaj z menedżera dodatków w celu zainstalowania wymaganych opcji.

Uwaga! Nie warto instalować na zapas dodatków, które wydają się być w tej chwili zbędne, ale w przyszłości mogą się przydać. Zainstalowanie większej ilości opcji w stosunku do faktycznych potrzeb może wpłynąć negatywnie na wydajność skryptu, a także spowoduje, że administracja będzie mniej czytelna ze względu na większą ilość pól i opcji w formularzach.

Zmienne konfiguracyjne

W plikach "database/config/general.php" i "database/config/lang_pl.php" znajdują się niektóre zmienne konfiguracyjne, które nie są dostępne z panelu administracyjnym. Przed tworzeniem strony warto zastanowić się nad ustawieniem niektórych opcji. Będzie to miało wpływ na późniejsze funkcjonowanie skryptu, jego wydajność itp.

Zapoznaj się z najważniejszymi zmiennymi:

• $config['allowed_ips_admin_panel'] - zawierająca listę adresów IP z których można zalogować się do administracji. Aby dodać tą zmienną, należy edytować plik konfiguracyjny i wkleić kod:

  $config['allowed_ips_admin_panel'] = Array( '1.1.1.1', '2.2.2.2' ); // 1.1.1.1 i 2.2.2.2 to adresy IP, które mają mieć możliwość logowania do administracji

  Jeśli chcesz zdefiniować tylko jeden adres IP, zamień wartość zmiennej na Array( '1.1.1.1' ); Jeśli adresów IP ma być więcej niż dwa, dodaj po przecinku kolejny adres.
• define( 'DEVELOPER_MODE', true ); - gdy ta opcja jest aktywna, skrypt wyświetla wszystkie możliwe błędy, które znajdują się w kodzie PHP i niepoprawne ustawienia praw do plików. Po opublikowaniu strony wyłącz tą opcje zmieniając ją na //define( 'DEVELOPER_MODE', true );
• $config['language_in_url'] - jeśli planujesz stworzyć stronę wielojęzyczną, to zalecamy ustawić tą zmienną na wartość true.
• $config['products_full_description_to_file'] - jeśli planujesz stworzyć sklep zawierający duże ilości produktów (np. 1000 i więcej), to zalecamy ustawić tą zmienną na wartość true. Opisy pełne będą zapisywały się w plikach w katalogu "database/products/" co znacznie przyśpieszy działanie skryptu, jednak kosztem braku możliwości wyszukiwania produktów po opisach pełnych. W edycji EXT możliwe jest włączenie wyszukiwania po opisach, które znajdują się w katalogu "database/products/" przez ustawienie true dla zmiennej $config['search_in_files']. W tym przypadku jednak będzie to znacznie obciążało procesor serwera. Dlatego w razie problemów z obciążeniem serwera konieczne będzie wyłączenie opcji wyszukiwania po opisach.
• $config['pages_full_description_to_file'] - jeśli planujesz stworzyć stronę zawierającą duże ilości tekstów (np. 200 i więcej stron oraz podstron), to zalecamy ustawić tą zmienną na wartość true. Opisy pełne będą zapisywały się w plikach w katalogu "database/pages/" co znacznie przyśpieszy działanie skryptu, jednak kosztem braku możliwości wyszukiwania stron po opisach. W edycji EXT możliwe jest włączenie wyszukiwania po opisach, które znajdują się w katalogu "database/pages/" przez ustawienie true dla zmiennej $config['search_in_files']. W tym przypadku jednak będzie to znacznie obciążało procesor serwera. Dlatego w razie problemów z obciążeniem serwera konieczne będzie wyłączenie opcji wyszukiwania po opisach.
• $config['images_sizes'] - ustal wielkości miniaturek, które będą się wyświetlały w listach i szczegółach stron i produktów. Domyślnie skrypt posiada 3 rozmiary miniaturek: 100, 150 i 200 (wartości wyrażone w pikselach (px)). Skrypt w czasie generowania miniaturek pomniejsza zdjęcie tak by jego szerszy bok otrzymał wskazaną wartość. Przykładowo zdjęcie o wymiarach 800x600 dla którego zaznaczono miniaturkę 100 będzie pomniejszone do rozmiarów 100x75.
• $config['thumbs_ratios'] - ustal dodatkowe opcje kadrowania zdjęć. Przykładowo jeśli chcesz dodać kadrowanie 3:2 (czyli stosunek krótszego boku do dłuższego wynosi 0.666) to dopisz do zmiennej: , '0.666' => '3:2'
• $config['products_default_image_size_list'] - ustal domyślną wielkość miniatury 1 dla produktów (domyślnie wyświetlana w liście)
• $config['products_default_image_size_details'] - ustal domyślną wielkość miniatury 2 dla produktów (domyślnie wyświetlana w szczegółach)
• $config['products_default_image_location'] - ustal domyslną lokalizację zdjęcia
• $config['pages_default_image_size_list'] - ustal domyślną wielkość miniatury 1 dla stron (domyślnie wyświetlana w liście)
• $config['pages_default_image_size_details'] - ustal domyślną wielkość miniatury 2 dla stron (domyślnie wyświetlana w szczegółach)
• $config['pages_default_image_location'] - ustal domyslną lokalizację zdjęcia
• $config['default_subpages_show'] - ustal domyślny sposób wyświetlania podstron
• $config['promoted_products_elements'] - ustal elementy produktu, które mają się wyświetlać dla promowanych produktów. Kolejność elementów jest dowolna. Więcej informacji w elementy dla stron i produktów »
• $config['default_boxes_product_elements'] - ustal domyślne elementy produktu, które mają się wyświetlać w boksie o typie "wyświetl produkt". Kolejność elementów jest dowolna. Więcej informacji w elementy dla stron i produktów »
• $config['default_boxes_page_elements'] - ustal domyślne elementy strony, które mają się wyświetlać w boksie o typie "wyświetl stronę". Kolejność elementów jest dowolna. Więcej informacji w elementy dla stron i produktów »
• $config['max_dimension_of_image'] – ta zmienna przechowuje maksymalny rozmiar dłuższego boku dodawanego zdjęcia. Jeśli jego rozmiar jest większy niż wartość tej tablicy, to następuje jego pomniejszenie do wartości tablicy.
• $config['time_diff'] - jeśli pomiędzy czasem lokalnym, a czasem na serwerze jest różnica to podaj ją w minutach. Przykładowo jeśli serwer pokazuje o 1 godzinę później to wpisz "-60".
• $config['date_format_admin_default'], $config['date_format_admin_orders'], $config['date_format_customer_orders'], $config['date_format_customer_comments'] umożliwia zdefiniowanie formatu wyświetlanej daty w zależności od wartości zmiennej. Nazwa zmiennej precyzuje miejsce zastosowania jej przy wyświetlaniu daty. Format daty można zdefiniować w oparciu o parametry funkcji date().
• $config['image_preview_size'] - rozmiar większego boku podglądu zdjęcia w szczegółach produktu. Jeśli chcesz wyłączyć tą opcje to ustaw wartość null
• $config['max_product_quantity'] - maksymalna ilość danego produktu, który można zamówić w jednym zamówieniu
• $config['order_details_from_customer'] - gdy zmienna ustawiona jest na true to nadawcą emaila wysyłanego do administratora ze szczegółami zamówienia będzie klient
• $config['cache_bestsellers'] - jeśli zmienna ma wartość true to bestsellery będą zapisywane do pamięci podręcznej i odświeżane co 24h. Zmniejsza to obciążenie skryptu
• $config['show_vouchers_form'] - gdy wartość zmiennej jest ustawiona na true to pole do wpisywania kuponów rabatowych w koszyku będzie się wyświetlać
• $config['dir_*'] - w tablicy, której klucze zaczynają się na "dir_", przechowywane są informacje o katalogach, np.: bazy danych, czy plików. Przed uruchomieniem strony można zmienić ich nazwy w celu, np.: zabezpieczenia bazy danych przed intruzami.
• $config['style'] - zmienna przechowuje nazwę pliku styli css. Jesli chcesz opracować swoje style, to zmień wartość zmiennej.
• $config['gallery_columns'] - ilośc kolumn w wyświetlaniu zdjęć typu góra/dół lub podstron typu galeria zdjęć
• $config['related_columns'] - ilość kolumn w wyświetlaniu produktów powiązanych w szczegółach produktu
• $config['show_order_details_link'] - jeśli chcesz, by Twoi klienci po złożeniu zamówienia mieli podgląd do jego szczegółów przez prowadzący do niego specjalny link, to ustaw parametr na true
• $config['page_link_in_navigation_path'] - jeśli zmienna ma wartość false, nazwa bieżącej strony w ścieżce nawigacyjnej nie jest linkiem
• $config['change_language_to_polish'] - jeśli zmienna ma wartość true, język przeglądarki jest ustawiony na polski i język administracji nie został ustawiony przez administratora, wówczas język administracji zostanie automatycznie zmieniony na polski
• $config['hide_theme'] - ukrycie pola wyboru tematu strony. Wartość null przywraca pole.
• $config['hide_thumbnails_2'] - ukrycie pola wyboru rozmiaru miniatury 2. Wartość null przywraca pole.
• $config['display_lang_preview_link'] - jeśli wartość zmiennej ustawiona jest na true, wówczas link do podlądu strony znajdujący się obok nazwy strony w liście stron w administracji zawiera parametr językowy
• $config['display_homepage_name_title'] - wyświetlanie tytuły strony na stronie startowej
• $config['max_textarea_chars'] - ustal maksymalną ilość znaków przesyłanych przez pola typu "textarea" z formularzy
• $config['max_text_chars'] - maksymalna długość tekstu przesyłanego przez pola typu "text" z formularzy
• $config['allowed_extensions'] - lista akceptowanych rozszerzeń plików, które skrypt dopuści do wgrania na serwer. Zachowaj szczególną ostrożność przy dodawaniu kolejnych rozszerzeń.
• $config['display_editing_options'] - daje możliwość przejścia do edycji strony/produktu lub usunięcia z poziomu strony klienta. Jeśli chcesz wyłączyć tą opcję, ustaw ją na wartość null.
• $config['disable_pages_in_sitemap'] - dostępne od wersji v6.7 - lista id stron, które mają nie wyświetlać się w mapie strony. Jeśli chcesz, aby niektóre strony nie pojawiały się, to zapisz je w takim formacie Array( 7 => true, 32 => true ) do tej zmiennej. Ten przykład blokuje wyświetlanie stron o id 7 i 32, a także ich podstron.
• $config['disable_pages_in_sitemap_xml'] - dostępne od wersji v6.7 - ta zmienna zawiera listę id stron, które mają nie wyświetlać się w mapie strony dla google (sitemap.xml). Sposób ustawiania listy id stron jest taki sam jak dla zmiennej powyżej.

Pamiętaj także o:

• usunięciu języków, których nie używasz.