Katalog główny i instalacyjny

Wszystkie niezbędne do działania Joomla skrypty umieszczane są w przeznaczonym na serwis katalogu. Poniżej przedstawiona jest struktura głównego katalogu Joomla:

/administrator          /* katalogi i skrypty zaplecza administracyjnego */
/cache                  /* katalog tymczasowy (pamięć podręczna, schowek) */
/components             /* katalogi i skrypty komponentów */
/editor                 /* skrypty wspierające obsługę edytorów */
/help                   /* katalogi i pliki systemu pomocy */
/images                 /* katalogi i pliki z grafikami */
/includes               /* katalogi i skrypty z podstawowymi funkcjami, itd. */
/installation           /* katalogi i skrypty instalatora. */
/language               /* pliki etykiet i komunikatów ekranowych */
/mambots                /* katalogi i pliki dodatków (botów) */
/media                  /* pliki uzupełniające - fonty dla PDF */
/modules                /* katalogi i pliki modułów */
/templates              /* katalogi i pliki szablonów */
 CHANGELOG.php          /* dziennik zmian */
 CHANGELOG_PL.php       /* dziennik zmian dystrybucji polskiej*/
 configuration.php      /* plik konfiguracyjny */
 configuration.php-dist /* wzorcowy plik konfiguracyjny */
 COPYRIGHT.php          /* uznanie autorstwa */
 globals.php            /* skrypt emulacji ustawień register_globals */
 htaccess.txt           /* plik modyfikujęcy ustawienia  */
 index.php              /* plik inicjujący uruchomienie serwisu */
 index2.php             /* plik inicjujący uruchomienie serwisu */
 INSTALL.php            /* instrukcja instalacji, wersja ang. */
 LICENSE.php            /* licencja, wersja ang. */
 mainbody.php           /* skrypt wywołujący funkcję mainbody() */
 offline.php            /* skrypt przełączający serwis w tryb offline  */
 offlinebar.php         /* skrypt z komunmikatami trybu offline  */
 pathway.php            /* skrypt wywołujący funkcję  mosPathWay();  */
 robots.txt             /* plik dołączany do sekcji META dokumentu HTML;  */

Lokalizacja katalogu głównego

Lokalizacja głównego katalogu Joomla zależy od systemu, na jakim serwis będzie instalowany.

Lokalnie - w Windows

Zalecamy zainstalowanie w Windows serwera Apache. Ale możliwe jest, że będziesz korzystać z Windowsowego serwera IIS [Internet Information Server]. Typową lokalizacją głównego katalogu dla Joomla jest:

• serwer Apache: C:\\apache\htdocs\katalog_twojego_joomla
• serwer IIS: C:\\Inetpub\wwwroot\katalog_twojego_joomla

Ale może to być również katalog na innym dysku, folder umieszczony np. w katalogu serwisy_joomla. Katalogowi możesz nadać dowolną nazwę, najlepiej skróconą nazwę serwisu.

Lokalnie - w Linuksie

W systemach Linux lokalizacja katalogów stron WWW może się nieco różnić, zależnie od dystrybucji. Typowymi lokalizacjami głównego katalogu dla Joomla są:

• var/www/katalog_twojego_joomla
• var/www/html/katalog_twojego_joomla
• var/www/public_html/katalog_twojego_joomla

Ale może to być również inny katalog. Jeśli masz działający serwer www, to zapewne wiesz, gdzie należy umieścić pliki dla Twojej witryny. Katalogowi możesz nadać dowolną nazwę.

Na zdalnym serwerze

Jeśli dzierżawisz miejsce na zdalnym serwerze, to klient FTP, którego używasz, połączy Cię z udostępnionym przez dostawcę Twoim katalogiem głównym.

Skrypty pakietu źródłowego możesz umieścić bezpośrednio w tym katalogu. Zwykle jednak w katalogu głównym istnieje już specjalny katalog przeznaczony na serwisy, nazwany po prostu html lub public_html.

Instalując Joomla na serwerze udostępnionym przez dostawcę usług internetowych, możesz się spotkać z różnymi rozwiązaniami i ułatwieniami, których tutaj ze zrozumiałych względów nie omawiamy.

Rozpakowanie pakietu źródłowego

Pakiety źródłowe to archiwa spakowane standardowymi programami. Do rozpakowania pakietu potrzebujesz np. programu 7-Zip, rozpowszechnianego na zasadach licencji GNU/LGPL. Możesz go pobrać bezpłatnie z polskiej lustrzanej strony projektu:

• Pobierz pakiet instalacyjny programu 7-Zip.

Rozpakowując pakiet, należy zachować istniejącą strukturę folderów.

Jeśli chcesz zainstalować Joomlę na swoim komputerze, to pakiet źródłowy należy rozpakować w jednym z wymienionych wcześniej katalogów

Sprawdzenie zawartości pakietu

Jeśli będziesz przesyłać źródła na zdalny serwer, rozpakuj archiwum w dowolnym katalogu na swoim komputerze.

Aby uniknąć niespodzianek, warto sprawdzić, czy nie zawiera błędów. Prostą metodą jest rozpakowanie skompresowanego archiwum na dysku lokalnym.

Użyj w tym celu programu do rozpakowywania skompresowanych plików. W systemie Windows możesz skorzystać np. TotalCommandera, WinZipa. W systemie Linux najpierw zdekompresuj plik poleceniem -gunzip, a następnie rozpakuj poleceniem tar. Zamiast polecenia -gunzip możesz użyć również gzip -d. Możesz również posłużyć się menedżerem Midnight Commander. Na przykład, korzystając z TotalCommander w Windows, wykonaj kolejne kroki:

• Załóż nowy folder, w nazwie folderu warto umieścić wersję Joomla i datę wydania, np. joomla_1.0.0_2005_09_20,
• Zaznacz w drugim panelu plik pakietu dystrybucyjnego,
• Kliknij menu programu opcję Rozpakuj,
• Przejrzyj katalogi. Zwróć uwagę, czy wszystkie pliki mają poprawne nazwy, czy nie ma plików, których rozmiar wynosi 0 bajtów. Oznacza to najpewniej, że archiwum Twojego pakietu było uszkodzone albo zdarzyły się jakieś błędy podczas rozpakowywania.

Po sprawdzeniu zawartości pakietu źródłowego możesz przesłać pliki do katalogu na zdalnym serwerze lub rozpocząć instalację Joomla na komputerze lokalnym.

Źródła na serwer

Skorzystaj z klienta FTP lub SSH, zależnie od udostępnionych Ci przez dostawcę usług internetowych możliwości.

Do przesłania plików źródłowych na zdalny serwer internetowy niezbędny jest program - klient FTP lub SSH, zależnie od udostępnionych Ci przez dostawcę usług internetowych możliwości. Może to być przykładowo:

• File Zilla - prosty w obsłudze, a przy tym darmowy i polskojęzyczny
• FlashFXP - wyposażony we wszelkie niezbędne funkcje, również z polską lokalizacją
• CuteFTP - jeden z najbardziej popularnych, wygodny w obsłudze, ale nie bezpłatny. Możesz jednak skorzystać z wersji trial.
• WinSCP - bardzo dobry graficzny klient SFTP dla Windows korzystający z SSH, służący przede wszystkim do bezpiecznego przesyłania plików pomiędzy lokalnym i zdalnym komputerem.

Kopiując źródła do katalogu głównego Joomla lub przesyłając je na serwer, nie zmieniaj struktury katalogów i rozmieszczenia plików źródłowych.