IDZ DO

PRZYKADOWY ROZDZIA
SPIS TRECI

KATALOG KSIEK
KATALOG ONLINE
ZAMW DRUKOWANY KATALOG

osCommerce. Tworzenie
sklepw internetowych.
Wydanie dla pocztkujcych
Autor: David Mercer
Tumaczenie: Wojciech Moch
ISBN: 83-246-0650-5
Tytu oryginau: Building Online Stores
With Oscommerce: Beginner Edition
Format: B5, stron: 216

TWJ KOSZYK
DODAJ DO KOSZYKA

CENNIK I INFORMACJE
ZAMW INFORMACJE
O NOWOCIACH
ZAMW CENNIK

CZYTELNIA
FRAGMENTY KSIEK ONLINE

W dzisiejszym stechnicyzowanym wiecie handel przekroczy bariery czasoprzestrzenne.

Stanie w kolejkach to ju zamierzcha przeszo, co wicej nawet nie trzeba
wychodzi z domu, aby co kupi lub sprzeda! A e jak powszechnie wiadomo
czas to pienidz, internet wychodzi naprzeciw potrzebom klientw, proponujc
nowoczesn form robienia zakupw, czyli wirtualne sklepy. Czasochonne wycieczki
po centrach handlowych z powodzeniem zastpujemy surfowaniem po sieciowych
witrynach. Wystarczy jeden klik i jak za dotkniciem magicznej rdki
w wirtualnym koszyku pojawiaj si towary, w niczym nieustpujce tym, ktre
wasnorcznie zdejmujemy z pki.
Ksika osCommerce. Tworzenie sklepw internetowych. Wydanie dla pocztkujcych
to praktyczny przewodnik po tajnikach tworzenia handlowej witryny internetowej
i administrowania ni. Autor przedstawia innowacyjne narzdzie pakiet osCommerce
dziki niemu krok po kroku poznasz zasady dziaania sklepu internetowego, od
instalacji, poprzez konfiguracj, a po zabezpieczenia i sposoby usprawniania pakietu.
Ksika odkrywa i przyblia tajemn wiedz dotyczc poruszania si po meandrach
sklepowego e-biznesu. Po jej lekturze nic ju nie bdzie takie jak wczeniej wiat
internetowych transakcji stanie przed Tob otworem!
W ksice opisano midzy innymi:
Konfigurowanie pakietu OsCommerce
Administrowanie produktami w e-sklepie
Tworzenie atrakcyjnej szaty graficznej e-sklepu
Obsuga patnoci: PayPal i karty kredytowe
Sposoby zabezpieczania witryny OsCommerce

Wydawnictwo Helion
ul. Kociuszki 1c
44-100 Gliwice
tel. 032 230 98 63
e-mail: helion@helion.pl

Bd zawsze o jeden klik! przed konkurencj

O autorze

O recenzentach

Wprowadzenie

11

O czym jest ta ksika

Konwencje

Rozdzia 1. Wprowadzenie do sklepw internetowych i pakietu osCommerce

Czym jest e-commerce?
Kilka szczegw na temat pakietu osCommerce
Sieciowa spoeczno pakietu osCommerce
Dzia Contributions
Fora
Baza wiedzy
Dokumentacja
Raporty o bdach i postpach prac
Podsumowanie

12
13

15
17
18
20
20
21
22
23
23
24

Rozdzia 2. Konfigurowanie pakietu osCommerce

27

Podstawowe wymagania witryny

Pobieranie pakietu osCommerce
Przenoszenie pakietu osCommerce na swoj witryn
Obsuga protokou FTP metod przecignij i upu
Narzdzia FTP
Sprawdzanie, czy witryna jest gotowa
Instalowanie pakietu osCommerce
Konfigurowanie pakietu osCommerce
Polska wersja sklepu
Rozwizywanie problemw
Podsumowanie

28
29
30
31
32
33
35
39
41
43
44

osCommerce. Tworzenie sklepw internetowych

Rozdzia 3. Podstawowa konfiguracja

Panel administracyjny
My Store
Maximum Values (wartoci maksymalne) i Minimum Values (wartoci minimalne)
Images (obrazki)
Customer details (dane klienta)
Shipping/packaging (wysyki i pakowanie)
Product listing (listy produktw)
Stock (magazyn)
Logging (dziennik)
Cache (bufor)
Email options (opcje poczty)
Download (pobieranie)
GZip Compression (kompresja GZip)
Sesions (sesje)
Podsumowanie

Rozdzial 4. Praca z danymi

47
48
51
53
56
57
58
59
61
63
64
64
66
68
69
71

73

Przygotowania do dodania danych produktw

Sklep
Kategorie/Produkty

74
76
77

Dodawanie i usuwanie kategorii i produktw

Przenoszenie i kopiowanie kategorii i produktw

77
79

Cechy produktw
Producenci
Recenzje
Oferty specjalne
Oczekiwane produkty
Klienci
Zamwienia
Przegldanie raportw
Podsumowanie

80
85
87
87
88
89
90
92
93

Rozdzia 5. Poprawianie wygldu sklepu

95

Definicje jzykw
Plik polish.php
Plik index.php
Stosowanie jzyka HTML do formatowania
Praca z okienkami i kolumnami
Usuwanie okienka
Przenoszenie okienek
Modyfikowanie zawartoci okienka
Dodawanie okienka
Usuwanie kolumny

96
97
99
101
103
103
104
105
108
110

Spis treci

Obsuga obrazkw
Katalog images
Rozmiary i nazwy obrazkw
Grafika logo i ikony

111
113
114
115

Tworzenie i wstawianie nowej grafiki

Przenoszenie i usuwanie grafiki

Obrazki w tle
Obrazki przyciskw
Modyfikowanie arkuszy stylw
Wstawianie obrazkw w to
Zmiana kolorw i czcionek
Inne zmiany wygldu stron
Zmiana wielkoci stron
Dodawanie stron
Wiadomoci pocztowe
Podsumowanie

Rozdzia 6. Podatki, patnoci i wysyki

Miejscowoci i podatki
Strefy podatkowe
Klasy i stawki podatkw
Patnoci PayPal
Przygotowanie pakietu osCommerce do obsugi patnoci PayPal
czenie pakietu osCommerce i serwerw PayPal
Praca z PayPal
Patnoci kartami kredytowymi
Modu Credit Card
Modu PSiGate
Inne rodzaje patnoci
Czeki i przekazy pienine
Opata za pobraniem
Wysyki
Stawki stae
Za sztuk
Tabela stawek
Poczta Polska Paczki
Stawki strefowe
Rozwizanie wysyek dla ksigarni Contechst Books
Podsumowanie

Rozdzia 7. Zagadnienia zaawansowane

Zabezpieczanie panelu administracyjnego
Tworzenie katalogw zabezpieczonych hasem
Zabezpieczanie katalogu admin protokoem SSL

116
118

121
122
123
124
125
128
128
130
133
134

135
136
137
138
139
141
142
145
149
151
154
156
158
158
158
159
160
161
162
163
164
166

167
168
168
171

osCommerce. Tworzenie sklepw internetowych

Zabezpieczanie patnoci
Interfejs sklepu
Mechanizm sklepu
Patnoci PayPal
Patnoci kart kredytow

173
174
175
175
178

Raporty o niskich stanach magazynowych

Praca z produktami do pobrania

182
183

Instalowanie moduu Download Controller

Praca z moduem Download Controller
Testowanie moduu Download Controller

184
186
187

Tworzenie podobnych przyciskw

Optymalizacje dla wyszukiwarek
Podsumowanie

Dodatek A Rozwizywanie problemw

Rodzaje bdw
Skuteczny proces usuwania bdw
Samodzielne debugowanie kodu
Podsumowanie

Skorowidz

188
189
192

193
193
194
196
205

207

Skoro moemy by spokojni, e caa spoeczno bdzie nas wspiera w naszych staraniach,
udostpniajc nam wszystkie potrzebne informacje i zasoby, moemy przystpi do pierwszych
prb pracy z pakietem osCommerce. To akurat nie powinno stanowi dla nas absolutnie adnego
problemu, poniewa pakiet osCommerce udostpniany jest w ramach wielu pakietw oferowanych przez firmy udostpniajce witryny w internecie. Jeeli kto nie wykupi jeszcze takiego
pakietu, to moe si teraz rozejrze i poszuka oferty, w ramach ktrej udostpniany jest te
pakiet osCommerce.
Oczywicie gdybym nie opisa procedury penej instalacji i konfiguracji pakietu, popenibym
wielki nietakt, dlatego wanie w tym rozdziale zajmiemy si nastpujcymi zagadnieniami:
n podstawowymi wymaganiami witryny;
n pobieraniem pakietu osCommerce;
n przenoszeniem pakietu na nasz witryn;
n upewnieniem si, e na witrynie wszystko jest gotowe;
n instalowaniem i konfigurowaniem pakietu osCommerce;
n rozwizywaniem problemw.

Oczywicie to do sporo materiau, ale bez obaw. Kady twrca oprogramowania zawsze stara
si, eby jego program by moliwie prosty do pobrania i zainstalowania. Jeeli kto nie zwraca
uwagi na te szczegy, to zawsze znajdzie si inna osoba, ktra to samo zadanie wykona troch
lepiej. Najlepszym sposobem na uproszczenie procedur instalacji jest przygotowanie jak najbardziej spjnego i logicznego sposobu pobierania i instalowania oprogramowania, dlatego
w przypadku wikszoci interesujcych nas programw (w tym rwnie w przypadku pakietu
osCommerce) przekonamy si, e jest to naprawd prosty proces.

osCommerce. Tworzenie sklepw internetowych

Trzeba tu te wspomnie, e w celu zademonstrowania najrniejszych koncepcji i zada

zwizanych z tworzeniem wasnego sklepu w niniejszej ksice zaoymy fikcyjn firm o nazwie
Contechst Books. Dziki temu, e wszystkie zmiany wprowadza bdziemy w takim przykadowym, ale dziaajcym sklepie, Czytelnik bdzie lepiej przygotowany do wprowadzania podobnych modyfikacji w konfiguracji swojej wasnej witryny. atwiej bdzie wtedy poprawia
witryn i administrowa elementami prezentowanymi uytkownikom oraz mechanizmami, za
pomoc ktrych uytkownicy powinni korzysta z naszego sklepu.
Z ca pewnoci samo uruchomienie sklepu nie zajmie wiele czasu, ale gdyby kto natkn si
na jakie problemy, to zachcam do przejrzenia podrozdziau z rozwizywaniem problemw
umieszczonego na kocu tego rozdziau. Mam nadziej, e bd w stanie skutecznie przeprowadzi Czytelnika przez cay proces, a do utworzenia ostatecznej postaci sklepu, mimo e nie
jestem w stanie zaprezentowa jedynej waciwej drogi. W takim razie moemy zaczyna

Przede wszystkim potrzebna bdzie nam nazwa domeny, ktra pozwoli klientom na odwiedzenie
naszej witryny przez wpisanie w przegldarce odpowiedniego adresu URI (Universal Resource
Indicator). W sieci dostpnych jest wiele doskonaych pakietw udostpniania witryn (tzw. hosting), z ktrych moemy wybiera stosujc kryteria najlepiej dopasowane do wymaga naszej
firmy. Jeeli bdziemy wiedzieli, czego potrzeba do prowadzenia zaplanowanej witryny, to na
pewno znacznie atwiej przyjdzie nam wybra najwaciwszy pakiet.
Przy wybieraniu pakietu dobrze jest upewni si, e oferuje on dostp przez protok FTP, ktry
bardzo uatwia przenoszenie plikw na witryn. Nie jest to oczywicie absolutnie konieczne,
ale proponuj zajrze jeszcze do podrozdziau Przenoszenie pakietu osCommerce na swoj
witryn, ktry znale mona w dalszej czci tego rozdziau. W wikszoci przypadkw bdziemy mieli moliwo atwego zalogowania si na konto FTP, korzystajc ze swojej nazwy uytkownika i hasa. Jeeli kto nie ma pewnoci, to moe w przegldarce (zakadam, e obsuguje
ona protok FTP) wpisa nastpujcy adres URL: ftp://ftp.nazwa_domeny.pl.
Jeeli przegldarka poprosi o podanie hasa lub od razu wywietli zawarto gwnego katalogu
witryny, to mona sobie pogratulowa oznacza to, e mamy dostp do konta za porednictwem
protokou FTP. Jeeli jednak okae si, e takiego dostpu nie ma, to mona sprbowa postara
si o jego uzyskanie w firmie udostpniajcej nasz witryn w internecie. Co ciekawe, nazwy
uytkownika i hasa nie trzeba za kadym razem podawa w formularzu wywietlanym przez
przegldark. Dane te mona przesa te bezporednio w adresie URL, w odpowiednim formacie: ftp://nazwa_uytkownika:haso@ftp.nazwa_domeny.pl/.
Jeeli kto troszczy si o bezpieczestwo witryny (a to oznacza, e kady si o ni troszczy),
to lepiej bdzie w takim adresie wpisywa wycznie nazw uytkownika, ale pomija haso.
W przeciwnym wypadku naraamy si na kopoty, bo takie dane mona wzgldnie atwo przechwyci.

28

Rozdzia 2. Konfigurowanie pakietu osCommerce

W najwikszym skrcie wymagania, jakie musi speni pakiet usug udostpniania witryny
w internecie, mona streci w trzech punktach:
n Apache serwer stron WWW. Firma udostpniajca witryny w internecie musi

po prostu zdecydowa si na stosowanie serwera Apache. Niestety nie wchodzi

w gr aden inny serwer, taki jak na przykad Microsoft IIS.
n PHP oprcz tego firma musi pozwala na uywanie jzyka PHP,

poniewa to wanie w tym jzyku napisany zosta pakiet osCommerce.

n MySQL konieczny jest rwnie dostp do serwera baz danych MySQL. Pakiet

osCommerce korzysta z tego serwera do przechowywania wszystkich danych

zwizanych z nasz witryn.
Trzeba si te upewni, e na serwerze mamy do miejsca, eby spokojnie prowadzi ca
witryn. Musimy pamita, e witryna skada si bdzie z wielkiej iloci plikw dziennikw
oraz obrazkw, a oprcz tego w bazie danych te znajdzie si sporo informacji. Serwer powinien
te umoliwia obsug protokou SSL, poniewa nasza witryna powinna zapewnia uytkownikom odpowiedni poziom bezpieczestwa. Nie bez znaczenia s te ceny za takie pakiety, stabilno serwerw (koniecznie trzeba skontrolowa procentowy czas wyczenia), atwo korzystania z nich, a take zakres obsugi poczty.
Wiele firm domylnie instaluje na swoich serwerach wszystkie trzy wymienione elementy,
a zatem dostpne s one w ramach wikszoci pakietw udostpniania witryn. Oznacza to, e
bardzo prawdopodobne jest, e jedn z opcji takiej oferty jest szybkie i atwe wczenie pakietu
osCommerce (najczciej wystarczy tylko zaznaczy opcj pakietu osCommerce i poda nazw
uytkownika oraz haso o dostpie administratorskim). Trzeba tylko przestrzega instrukcji podawanych przez firm, a w przypadku jakichkolwiek pyta skontaktowa si z obsug kont.
Jeeli jednak w zakupionym pakiecie udostpniania witryn nie ma opcji wczenia pakietu
osCommerce, to konieczne jest pobranie wasnej kopii pakietu i przeniesienie go w caoci do
katalogw witryny.

Bez dodatkowych przygotowa mona od razu wej na witryn pakietu osCommerce i pobra jego kopi z adresu http://www.oscommerce.com/solutions/downloads. W czasie tworzenia tej ksiki dostpna bya wersja (milestone) 2.2 i wanie t wersj naley pobra, chyba
e w midzyczasie pojawia si nowsza. Uywana wersja pakietu nie bdzie miaa wielkiego
wpywu na aktualno danych podawanych w tej ksice.
Nalegam te, eby kady pobra sobie rwnie dokumentacj udostpnian na tej samej stronie, poniewa
mona w niej znale wiele cennych wskazwek i porad.

29

osCommerce. Tworzenie sklepw internetowych

Klikajc odpowiednie cze, mona wybra, czy kopi pakietu chcemy pobra z serwera znajdujcego si w Europie, czy te w Stanach Zjednoczonych, a pobierany plik naley zapisa
w katalogu Moje dokumenty (albo w dowolnym innym). Prosz zauway, e pobierany plik
ma zaledwie 1,4 MB, a wic raczej nie ma szans na przygotowanie sobie w midzyczasie tak
potrzebnego czasami kubka kawy (chyba e kto uywa powolnego cza modemowego).
Po pobraniu pliku naley rozpakowa go w tym samym katalogu. Wszystkie pliki zawiera si
bd w katalogu o nazwie osCommerce-2.2ms2 lub podobnym, zalenie od pobranej wersji
pakietu. Po wejciu do utworzonego wanie katalogu zauwaymy, e znajduje si w nim kolejny
katalog o nazwie catalog. Katalog ten naley spakowa do pliku .zip, ktremu nadamy nazw
catalog.zip. Po zakoczeniu kompresowania bdziemy gotowi do przeniesienia katalogu na
swoj witryn.

W tym miejscu trzeba zaznaczy, e jeeli chcemy woy w swoj witryn naprawd duo pracy,
to najlepszym rozwizaniem bdzie praca na jej lokalnej kopii znajdujcej si na wasnym komputerze. W tym celu trzeba jednak na tym komputerze przygotowa co, co nazywane jest
rodowiskiem rozwojowym (Development Environment). W ten sposb cao prac bdziemy
mogli wykona lokalnie, a na witryn przenie ju tylko ostateczny produkt.
Oznacza to jednak, e na komputerze trzeba zainstalowa jzyk PHP oraz serwery Apache
i MySQL, a dopiero pniej przystpi do instalowania pakietu osCommerce. Co wicej, przed
przystpieniem do waciwych prac trzeba si jeszcze upewni, e wszystkie te elementy dziaaj
prawidowo i ze sob wsppracuj. Zadaniem tej ksiki ma by nauka zasad dziaania pakietu
osCommerce, a zatem nie bd opisywa tych wszystkich pocztkowych krokw. Wicej informacji na temat budowania takiego rodowiska rozwojowego podawanych jest w zaawansowanym
wydaniu niniejszej ksiki (Building Online Stores with osCommerce: Professional Edition,
ISBN 83-246-0649-1). Mona te skorzysta z wyszukiwarki Google i poszuka w sieci WWW
informacji na ten temat.
Najprostsz metod przeniesienia pakietu na witryn bdzie skorzystanie z domylnego protokou stosowanego przez firm udostpniajc t witryn w internecie. Jeeli moemy uy
tej metody, to naley za jej pomoc przenie przygotowane wczeniej archiwum na serwer.
Na rysunku 2.1 zosta przedstawiony sposb przenoszenia plikw za pomoc jednego z takich
rozwiza oferowanych przez firmy.
Aby szybko i bez kopotw przenie pliki na serwer, mona te uy po prostu konta FTP
(o ile mamy do takiego dostp) i skorzysta z przedstawionych poniej dwch metod.

30

Rozdzia 2. Konfigurowanie pakietu osCommerce

Rysunek 2.1

Obsuga protokou FTP metod przecignij i upu

Uytkownicy systemw Windows mog na serwerze otworzy konto FTP za pomoc Eksploratora
Windows lub Internet Explorera i metod przecignij i upu przenie plik catalog.zip z lokalnego katalogu do gwnego katalogu witryny, na przykad tak jak pokazano to na rysunku 2.2.

Rysunek 2.2

Trzeba te wspomnie o kilku szczegach dotyczcych rysunku 2.2. Po pierwsze, musiaem

zalogowa si na konto administratora witryny, podajc swoj nazw uytkownika oraz haso,
czego oczywicie na rysunku nie wida. Trzeba si te upewni, e zabronione jest anonimo-

31

osCommerce. Tworzenie sklepw internetowych

we logowanie si na konto witryny. Co wicej, po uruchomieniu caej witryny i dopracowaniu

wszystkich jej mechanizmw naleaoby cakowicie wyczy konto FTP do czasu, a bdzie
nam znowu potrzebne. Po drugie, na rysunku wida, e plik kopiowany jest do katalogu public_html. W ten sposb po rozpakowaniu pliku na serwerze nowo utworzony katalog catalog
bdzie dostpny w sieci pod adresem http://www.nazwa_domeny.pl/catalog.
W tym miejscu mog powiedzie, e przesanie pliku na witryn testow zajo mniej wicej
jedn minut. Plik przesyany by przez wzgldnie szybk lini ADSL i wanie dlatego pliki
zostay spakowane do archiwum .zip. Bez tego czas ich przesyania byby zdecydowanie duszy. Trzeba te pamita, e na czas przesyania plikw wpywa nie tylko prdko poczenia
z internetem, ale rwnie wydajno pracy narzdzia uywanego do obsugi protokou FTP.

Narzdzia FTP
Nie kady bdzie mg wykona operacje zaprezentowane w poprzednim punkcie, dlatego osoby
nieuywajce rozwiza typu przecignij i upu powinny zaopatrzy si w klienta FTP. Komputery dziaajce pod kontrol systemw Linux i Windows domylnie wyposaone s ju w takie
narzdzie, dlatego wystarczy w nich otworzy okno wiersza polece i wpisa ponisze polecenie
lub polecenie rwnowane:
C:\> ftp --help

Polecenie to powinno wywietli plik pomocy, w ktrym mona zapozna si z metodami pracy
z danym klientem. Trzeba jednak zaznaczy, e narzdzia tego typu dziaaj wzgldnie intuicyjnie. Najpierw trzeba ustanowi poczenie ze zdalnym komputerem, a nastpnie nakaza
programowi przesanie odpowiednich plikw na serwer. Operacje te mona wykona na kilka
rnych sposobw, zalenie od uywanego przez siebie klienta FTP niektre z nich wyposaone s w graficzny interfejs uytkownika, a inne dziaaj wycznie w wierszu polece. Na
potrzeby tego rozdziau wybraem program pracujcy w wierszu polece. W celu zalogowania si na konto w swojej witrynie wystarczy poda adres serwera, a nastpnie nazw uytkownika oraz haso, tak jak pokazano na rysunku 2.3.

Rysunek 2.3.

32

Rozdzia 2. Konfigurowanie pakietu osCommerce

Po ustanowieniu poczenia mona atwo przesa plik na serwer, wydajc polecenia przedstawione na rysunku 2.4 (oczywicie szczegy polece mog si rni w poszczeglnych klientach
FTP).

Rysunek 2.4.

Jak wida, wykonalimy nastpujce operacje:

n zalogowalimy si na konto FTP, podajc nazw uytkownika i haso;
n zmienilimy zdalny katalog na public_html (to wanie do niego przesya bdziemy

plik z pakietem osCommerce);

n ustalilimy tryb przesyania danych na binarny, poniewa przesyany bdzie plik
.zip, a nie plik tekstowy (w takim wypadku odpowiedni byby tryb ascii).

Klient FTP poinformuje nas, czy przesyanie si powiodo. Na rysunku 2.4 wida komunikat
mwicy o udanym przesaniu pliku na serwer. Wszystkie pliki zostay przesane bez najmniejszych kopotw. Na razie wszystko idzie gadko

Po przesaniu na witryn wszystkich plikw pakietu osCommerce musimy jeszcze utworzy

baz danych i zabezpieczone hasem konto o dostpie administratorskim. Zadania te wykona
mona na wiele rnych sposobw, dlatego przedstawi tu tylko przykad tworzenia bazy
w demonstracyjnym pakiecie dostpu do internetu, jaki bdzie wykorzystywany w caej ksice.
Mam nadziej, e proces ten bdzie przebiega podobnie w pakiecie wykupionym przez Czytelnika. Jeeli jednak pojawi si jakie problemy, to naley zgosi si do pomocy technicznej
firmy udostpniajcej witryn. W kocu od tego ona jest.
Demonstracyjna witryna udostpnia specjalny interfejs pozwalajcy na tworzenie baz danych
MySQL, podobny do zaprezentowanego na rysunku 2.5 (inne firmy powinny udostpnia
podobne interfejsy).

33

osCommerce. Tworzenie sklepw internetowych

Rysunek 2.5

Po wprowadzeniu nazwy bazy danych i klikniciu przycisku Add Db wywoujemy stron

informacyjn. Teraz mamy ju gotow do pracy baz danych, a zatem moemy przystpi do
kolejnych prac. Oczywicie trzeba jeszcze utworzy konto specjalnego uytkownika, ktry bdzie
zajmowa si t wanie baz. Na rysunku 2.6 przedstawiony zosta proces tworzenia i dodawania uytkownika do bazy danych commercedb.

Rysunek 2.6

Na potrzeby instalowania bazy danych wykorzystamy uytkownika oscdb, ktrego wanie dodalimy do nowo utworzonej bazy danych. Mona te wybra dowoln inn nazw, lepiej dopasowan do wasnych konkretnych wymaga.
Na rysunku 2.6 mona zauway, e serwer automatycznie dopisuje do nazwy uytkownika i bazy danych
pewien przedrostek (w tym przypadku contechj_). Jeeli firma udostpniajca witryn uywa jednego
systemu obsugi baz danych do obsugi wielu rnych baz danych, to najprawdopodobniej spotkamy si
z podobnym zachowaniem. Jeeli tak bdzie, to naley zapisa ten przedrostek, bo bdzie nam potrzebny
w czasie konfigurowania pakietu osCommerce.

34

Rozdzia 2. Konfigurowanie pakietu osCommerce

Doskonale! Na serwerze wszystko jest ju skonfigurowane, a zatem moemy przyjrze si plikom

znajdujcym si na naszym komputerze roboczym i upewni si, e s gotowe do przesania
na serwer.

Na serwerze naley otworzy plik .zip i rozpakowa jego zawarto do katalogu public_html.
Po zakoczeniu rozpakowywania mona otworzy przegldark i wpisa w niej adres http://www.
nazwa_domeny.pl/catalog/index.php (naley pamita, e zapis nazwa_domeny zastpi trzeba
waciw nazw swojej domeny). W przegldarce powinna pojawi si strona prezentowana na
rysunku 2.7 (prosz zauway, e przegldarka zostaa przekierowana do troch innego adresu
i teraz znajdujemy si w katalogu install).

Rysunek 2.7.

Chcemy teraz zainstalowa pakiet od zera, a zatem z opcji prezentowanych w oknie przegldarki wybra trzeba lew (Install a new online store). Pojawi si wtedy nowa strona, na ktrej
otrzymamy kolejne dwie opcje. Zanim przejdziemy dalej, trzeba koniecznie zaznaczy obie,
tak jak zostao to zrobione na rysunku 2.8.

35

osCommerce. Tworzenie sklepw internetowych

Rysunek 2.8.

Jeeli ekran przegldarki wyglda tak jak na rysunku 2.8, to mona klikn przycisk Continue.
Kolejna strona (zobaczy j mona na rysunku 2.9) jest bardzo wana, poniewa podajemy na niej
ustawienia serwera MySQL, ktre ustalilimy w czasie instalowania bazy danych. Wszystkie
dane wprowadzane w formularzu trzeba wpisywa ostronie, upewniajc si, e s one zgodne
z ustawieniami serwera MySQL. Na rysunku 2.9 podane zostay przykadowe ustawienia naszego
demonstracyjnego serwera.
Jeeli przyjrzelibymy si ustawieniom wpisanym na rysunku 2.9, to zauwaylibymy, e jako
serwer baz danych wybrany zosta komputer localhost. (Jeeli z jakiego powodu takie ustawienie nie bdzie dziaao, to naley skontaktowa si z obsug techniczn i zapyta, co naley
wpisa w tym miejscu). Nastpnie poda trzeba nazw uytkownika oraz haso dostpu do bazy
danych. Oczywicie wpisywane tu informacje musz by zgodne z tymi, ktrych uywalimy
w poprzednim podrozdziale.
Na koniec jako nazw bazy danych, z ktrej korzysta bdzie pakiet osCommerce w czasie tworzenia tabel w serwerze MySQL, poda naley nazw contechj_commercedb. Trzeba pamita, e
musi by to dokadnie ta sama nazwa, ktrej uylimy w czasie tworzenia bazy danych w poprzednim podrozdziale.
W ramach upraszczania pracy z pakietem w opcji Session Storage wybierzemy warto database,
aby dane sesji przechowywane byy w bazie danych, a nie w plikach lokalnych. Oczywicie kada
z metod przechowywania danych sesji ma swoje wady i zalety, ale na nasze potrzeby cakowicie
wystarczajca bdzie baza danych.

36

Rozdzia 2. Konfigurowanie pakietu osCommerce

Rysunek 2.9

Po klikniciu przycisku Continue powinnimy zobaczy poniszy komunikat informujcy o udanym poczeniu z baz danych:
A test connection made to the database was successful.

Na razie wszystko idzie jak po male. Ponownie mona klikn przycisk Continue i pozwoli
pakietowi osCommerce utworzy wszystkie potrzebne mu tabele. Po zakoczeniu tego procesu
otrzymamy komunikat potwierdzajcy zakoczenie, a po klikniciu przycisku Continue przejdziemy do kolejnego etapu instalacji, w ktrym wywietlane s wszystkie informacje na temat
naszego serwera (prosz spojrze na rysunek 2.10). Przed klikniciem przycisku Continue trzeba
si upewni, e wszystkie wypisane dane s prawidowe.
Prosz zauway, e na tym etapie nie potrzebujemy jeszcze aktywowania pocze SSL, wic
odpowiednia opcja (Enable SSL Connections) moe pozosta bez zaznaczenia. Szyfrowaniem
pocze zajmowa si bdziemy w momencie, gdy zajmiemy si odpowiednim zabezpieczaniem sklepu. Na razie sprawdzi trzeba poprawno zapisw w polach WWW Address i Webserver Root Directory (powinny wskazywa na umiejscowienie na serwerze katalogu catalog)
i klikn przycisk Continue. Odpowiednie informacje do kontroli poprawnoci znale mona
na pasku adresu w przegldarce (Web Address) oraz w systemie plikw (Webserver Root
Directory). Na kolejnych wywietlanych stronach mona po prostu klika przycisk Continue,
poniewa znajdujce si na nich opcje nie maj wielkiego znaczenia dla dziaania serwera.
Wana jest tylko ostatnia strona prezentowana na rysunku 2.11.

37

osCommerce. Tworzenie sklepw internetowych

Rysunek 2.10

Rysunek 2.11

38

Rozdzia 2. Konfigurowanie pakietu osCommerce

Na stronie z informacj o zakoczeniu instalacji mamy do wyboru dwie opcje (wida je na rysunku 2.11): pierwsza z nich pozwala przejrze katalog (Catalog), a druga umoliwia dostp do
narzdzi administracyjnych (Administration Tool). Przyjrzyjmy si zatem tym narzdziom

Mona sobie odetchn z ulg mamy ju zainstalowany pakiet osCommerce, podstawowa

konfiguracja zostaa wykonana i cay wiat stoi przed nami otworem. Proponuj jednak zej
na ziemi i na ostatniej stronie procesu instalacji klikn przycisk Catalog. Z ca pewnoci
przed wywietleniem czego podobnego do sklepu internetowego zobaczymy ca seri bardzo
gronie wygldajcych komunikatw, podobnych do tego z rysunku 2.12.

Rysunek 2.12.

Nie naley jednak wpada w panik. Omwi teraz kilka operacji, ktre sprawi, e wszystkie
te komunikaty pjd w zapomnienie.
Uwani Czytelnicy zauwa, e na rysunku 2.12 na pasku adresu nie ma dotychczasowego adresu
www.contechst.com, ale uyty zosta adres localhost. Dzieje si tak, poniewa na potrzeby prowadzonych testw wiele operacji wykonywanych byo na komputerze autora, a nie na witrynie udostpnionej
w internecie. Ta zmiana nie ma adnego wpywu na prace wykonywane przez Czytelnika, ktry moe
nadal pracowa nad wasn witryn.

Pierwszy z komunikatw informuje nas, e w katalogu catalog nadal istnieje katalog install i jednoczenie prosi o jego usunicie ze wzgldw bezpieczestwa. No dobrze, na pewno twrcy
pakietu wiedz co robi. Naley zatem przej w systemie plikw do katalogu catalog i usun
z niego katalog install.
Po wykonaniu tego zalecenia moemy przyjrze si drugiemu ostrzeeniu, ktre informuje nas
o kolejnym potencjalnym zagroeniu dla bezpieczestwa, polegajcym na moliwoci zapisywania w pliku konfiguracyjnym. Nie chcemy oczywicie, eby do tego pliku zapisywa mg
ktokolwiek inny ni tylko my, a wic na pewno trzeba zaj si zabezpieczeniem tej luki.

39

osCommerce. Tworzenie sklepw internetowych

W systemie plikw trzeba odnale plik configure.php; najatwiej odnajdziemy go, odczytujc
wskazwki zawarte w komunikacie z ostrzeeniem. Po odnalezieniu pliku trzeba zmieni do
niego uprawnienia, tak eby zablokowa moliwo zapisywania, na przykad tak jak pokazano
na rysunku 2.13.

Rysunek 2.13.

Po wprowadzeniu tych dwch poprawek do konfiguracji pakietu osCommerce moemy powiedzie, e wszystko jest ju przygotowane do pracy naszego internetowego sklepu. Mona
teraz odwiey stron wywietlan w przegldarce, a jeeli w midzyczasie okno to zostao
zamknite, to naley ponownie wpisa w nim adres http://www.nazwa_domeny.pl/catalog/
index.php. Tym razem powinna pojawi si strona przykadowego sklepu bez jakichkolwiek
ostrzee (na razie). Jeeli wszystko zostao skonfigurowane prawidowo, to strona ta powinna
wyglda tak jak na rysunku 2.14.

Rysunek 2.14

Jeeli udao si dokadnie odtworzy wygld strony przedstawiony na rysunku 2.14, to moemy
by pewni, e cao jest w peni sprawna i gotowa do pracy. Pakiet osCommerce w wikszoci
przypadkw jest w stanie sam si skonfigurowa, wic nie bdziemy tutaj przeprowadza
wszystkich moliwych testw. Na kocu tego rozdziau dodany zosta podrozdzia o rozwizywaniu problemw, w ktrym opisywane s najczstsze problemy, jakie spotyka si przy instalowaniu pakietu.

40

Rozdzia 2. Konfigurowanie pakietu osCommerce

Zanim przejdziemy dalej, dobrze byoby jeszcze sprawdzi, jak wygldaj narzdzia do administrowania witryn. Jeeli kto ma ochot, to na ostatniej stronie procesu instalacji moe klikn
przycisk Administration Tool albo w przegldarce wpisa adres http://localhost/catalog/admin/
index.php. W obu przypadkach w przegldarce powinna pojawi si strona zaprezentowana
na rysunku 2.15.

Rysunek 2.15

W tym miejscu mona wykona praktycznie dowolne operacje zwizane z administracj witryn.
Wszystkie moliwoci zostay podzielone na kategorie o bardzo adnym i intuicyjnym ukadzie.
Zagadnieniami zwizanymi z poprawianiem rnych elementw witryny zajmiemy si w rozdziale 3., w ktrym przede wszystkim korzysta bdziemy z tego imponujcego narzdzia. Na
razie musimy tylko wiedzie, e mamy je w kadej chwili do dyspozycji.

W tym podrozdziale zajmiemy si przygotowaniem polskiej wersji zainstalowanego wanie

sklepu. Niestety wymaga to bdzie zainstalowania moduw jzykowych, czyli wykonania
kilku operacji, ktre tak naprawd opisywane bd dopiero w kolejnych rozdziaach.
Przede wszystkim naley pobra z witryny osCommerce pakiety, jakich uyjemy do przygotowania polskiej wersji witryny. Najpierw prosz wej na stron http://www.oscommerce.com/
community/contributions,1376, na ktrej znajduje si tumaczenie na jzyk polski tekstw

41

osCommerce. Tworzenie sklepw internetowych

i komunikatw wywietlanych przez pakiet osCommerce. Niestety tumaczenie to nie jest

jeszcze cakowicie kompletne, dlatego czasami mog pojawia si w nim nieprzetumaczone
fragmenty w takiej sytuacji w ksice bdzie widniaa angielska nazwa opcji wraz z jej polskim
tumaczeniem.
Zajmijmy si zatem dodaniem do sklepu polskiej wersji jzykowej. Po rozpakowaniu pobranego
archiwum znajdziemy w nim ca struktur katalogw. Struktur t naley odtworzy w katalogu
naszego sklepu, czyli najpierw przej do katalogu catalog/includes/languages i skopiowa do
niego zawarto tego samego katalogu ze struktury archiwum. Powinnimy w ten sposb otrzyma plik polish.php i katalog polish zawierajcy pliki i katalogi skopiowane z archiwum. W ten
sposb dodalimy do naszego sklepu polsk wersj jzykow (za chwil trzeba bdzie j jeszcze
skonfigurowa).
Teraz trzeba podobnie postpi z katalogiem admin. Prosz przej w katalogach sklepu do
katalogu catalog/admin/includes/languages i skopiowa do niego zawarto katalogu admin/
includes/languages z pobranego archiwum. Tutaj rwnie powinien powsta plik polish.php
i katalog polish zawierajcy wszystkie pliki przeniesione z archiwum. Dodalimy wanie polsk wersj panelu administracyjnego.
Oprcz tego potrzebne bd nam jeszcze zestawy przyciskw dla panelu administracyjnego
i samego sklepu. Odpowiednie pakiety pobra mona ze stron: http://www.oscommerce.com/
community/contributions,3741 (przyciski dla panelu administracyjnego) i http://www.oscommerce.
com/community/contributions,2051 (przyciski dla sklepu). Po przygotowaniu wszystkich potrzebnych pakietw mona przystpi do ich zainstalowania.
Zawarto obu archiww naley przenie do odpowiednich katalogw w strukturze sklepu.
I tak dla panelu administracyjnego bdzie to katalog catalog/admin/includes/languages/polish/
images/buttons. Tam wanie umieci naley wszystkie pliki obrazkw wydobyte z archiwum.
Podczas kopiowania zauwaymy, e w ten sposb nadpisywane s oryginalne pliki przyciskw,
wic dobrze byoby przygotowa sobie wczeniej ich zapasow kopi. Jeeli chodzi o przyciski
dla sklepu, to pliki wydobyte z archiwum naley umieci w katalogu catalog/includes/languages/
polish/images/buttons. Tutaj rwnie nadpisywane bd oryginalne pliki, wic dobrze byoby
uprzednio wykona ich kopi bezpieczestwa.
Gotowe? Niezupenie. Na razie umiecilimy tylko pliki we waciwych miejscach. Teraz musimy
jeszcze poinformowa pakiet osCommerce, eby zacz z nich korzysta. W tym celu trzeba
przej do panelu administracyjnego swojego sklepu (najczciej bdzie trzeba wpisa w przegldarce adres http://<adres_witryny>/catalog/admin). Po otwarciu panelu naley klikn cze
kategorii Localization, a nastpnie cze sekcji Languages. Na otwartej stronie klikn naley
przycisk new language, a nastpnie w polach edycyjnych wprowadzi nastpujce dane:
n pole Name Polski;
n pole Code pl;
n pole Image pozostawi domylny tekst icon.gif;
n pole Directory polish;
n pole Sort order 0.

42

Rozdzia 2. Konfigurowanie pakietu osCommerce

Nie mona te zapomnie o zaznaczeniu opcji Set as default w ten sposb jzyk polski stanie si domylnym jzykiem pakietu. Na koniec trzeba jeszcze klikn przycisk insert. Jeeli
wszystko wykonalimy poprawnie, to na wywietlonej licie jzykw pakietu na pierwszej pozycji
powinien pojawi si jzyk polski oznaczony jako jzyk domylny.
Na zakoczenie wystarczy ju tylko ponownie otworzy strony sklepu lub klikn cze Administration i na nastpnej stronie z listy jzykw wybra jzyk Polski. Wszystkie (no, prawie wszystkie) elementy sklepu powinny by ju przetumaczone na jzyk polski.

W czasie opisywanego w tym rozdziale procesu instalacji praktycznie nie da si zrobi czego
le. Nie mona jednak wykluczy, e co moe pj niezgodnie z zaoeniami. Mona mie tylko
nadziej, e chodzi tu o co tak mao wanego jak literwka popeniona przy wprowadzaniu
danych. Jeden z najbardziej irytujcych problemw pojawi si moe w ostatnich krokach
konfigurowania pakietu osCommerce. Na przykad mona natkn si na komunikat podobny
do prezentowanego na rysunku 2.16.

Rysunek 2.16

43

osCommerce. Tworzenie sklepw internetowych

W takiej sytuacji naley klikn najpierw przycisk Back, sprawdzi ponownie wszystkie wprowadzone ustawienia i jeszcze raz sprbowa ustanowi poczenie z serwerem baz danych. Jeeli
problem bdzie si powtarza mimo naszej cakowitej pewnoci co do poprawnoci wprowadzonych danych, to mona jeszcze odwiey okno przegldarki i sprbowa ponownie.
Jeeli i tym razem nie uda si nawiza cznoci z serwerem, to trzeba wrci do podrozdziau
Sprawdzanie, czy witryna jest gotowa i postpowa zgodnie z zawartymi tam instrukcjami.
Szczegln uwag zwrci naley na tworzenie uytkownika bazy danych, nadawanie mu hasa
oraz przydzielanie uprawnie do korzystania z waciwej bazy danych.
Jeeli oprcz tego w czasie instalowania pakietu pojawi si jeszcze inne problemy mae lub
due, to mona rozwizywa je, stosujc nastpujcy proces postpowania:
n Skonsultowa si z dokumentacj pakietu.
n Odwiedzi witryn pakietu osCommerce, przejrze baz wiedzy
(http://www.oscommerce.info) oraz fora dyskusyjne (http://forums.oscommerce.com
lub http://www.oscommerce.pl/), poszukujc w nich informacji zwizanych z danym
problemem.
n Przejrze list bdw znalezionych w pakiecie (http://www.oscommerce.com/
community/bugs) i sprawdzi, czy trapicy nas problem nie jest czasem wynikiem
jakiego bdu.
n Jeeli w aden sposb nie moemy znale opisu podobnego problemu, to mona
wysa na forum prob o pomoc w jego rozwizaniu.
n Jeeli mimo to nie uda si uzyska pozytywnych rezultatw, to mona skontaktowa si
ze swoim dostawc internetu i poprosi go o pomoc przy instalowaniu pakietu.
By moe w ten sposb uda si odnale przyczyn problemu.
n W kadej sytuacji mona korzysta te z wyszukiwarki Google, podajc jej odpowiedni
zestaw sw kluczowych. By moe w ten sposb uda si odnale opis podobnego
problemu i jego rozwizanie.
W pierwszej chwili podawanie tylko wskazwek dotyczcych szukania rozwizania problemu,
a nie listy moliwych problemw i ich rozwiza moe wydawa si pewnym nietaktem, ale
znajomo porzdnej metody szukania rozwiza na dusz met z ca pewnoci jest bardziej
wartociowa od ograniczonej listy rozwiza problemw. Podane punkty tworz metodologi
pozwalajc rozwiza dowolne problemy z pakietem osCommerce, a nie tylko te, ktre mog
pojawi si w czasie jego instalowania.

Na tym etapie mamy ju w peni sprawny sklep internetowy, ktry tylko czeka na prace, jakie
musimy wykona w nadchodzcych dniach, tygodniach i miesicach. Po upewnieniu si, e
pakiet jest nie tylko zainstalowany, ale i dziaa zgodnie z zaoeniami, moemy mie pewno,
e po rozpoczciu dalszych prac nie natkniemy si na adne nieprzyjemne niespodzianki.

44

Rozdzia 2. Konfigurowanie pakietu osCommerce

Opisane zostay te rne problemy, jakie mog pojawi si w trakcie instalowania pakietu. Jeeli
chodzi o rozwizywanie takich problemw, to najlepiej bdzie zapamita punkty prezentowane
w podrozdziale Rozwizywanie problemw. Stanow one bardzo solidn podstaw dla szukajcych rozwizania problemu i ich zastosowanie nie ogranicza si tylko do procesu instalacji
i wstpnej konfiguracji.
No dobrze. Jestemy zatem gotowi do kolejnego etapu prac nad przystosowaniem witryny do
naszych wymaga.

45