Instalowanie nowych modułów

Po zainstalowaniu Drupala możesz doinstalować nowe, dodatkowe moduły, by rozszerzyć jego możliwości.

W skrócie

Pobierz moduł i rozpakuj jego pliki do podkatalogu modules instalacji Drupala (zwykle sites/all/modules). Następnie przeczytaj załączone instrukcje i włącz moduł na stronie Zarządzaj » Budowa witryny » Moduły.

Bardziej wprawni użytkownicy Drupala korzystają zwykle z narzędzi w rodzaju wget i drush. Jest też moduł Plug-in Manager, który pozwala instalować moduły za pomocą interfejsu Drupala.

Szczegółowe instrukcje

1. Pobierz nowy moduł. Upewnij się, że moduł jest kompatybilny z zainstalowaną wersją Drupala. Miej także na uwadze, że moduły w wersjach "deweloperskich" (dev) znajdują się w fazie rozwoju i powinno się do nich podchodzić ostrożnie.
2. Rozpakuj moduł. Pobrany plik będzie zapewne skompresowanym archiwum, takim jak np. tar.gz. Jeśli korzystasz z Windows, do rozpakowania archiwum możesz użyć m.in. programu 7-Zip. Jeśli pracujesz na komputerze Macintosh, możesz skorzystać ze Stuffit Expander. Pod systemem uniksowym, z polecenia tar -zxvf nazwamodulu-4.5.tar.gz
3. Wyślij rozpakowany folder. Po rozpakowaniu, wyślij folder na serwer FTP, do odpowiedniego folderu modules. Folder modules znajdujący się w głównym folderze Drupala jest przeznaczony dla standardowych modułów. Moduły dodatkowe należy umieszczać w folderach witryn, zazwyczaj w sites/all/modules (folder ten należy utworzyć). W przypadku instalacji wielowitrynowej istnieje możliwość instalacji modułów w odrębnych dla każdej z witryn folderach (np. sites/folder-witryny/modules).
4. Przeczytaj instrukcje. Jeśli moduł zawiera plik z objaśnieniami (zwykle INSTALL.txt i/lub README.txt), przeczytaj go - być może instalacja modułu wymaga dodatkowych zabiegów. Czasem plik taki nie posiada rozszerzenia, a system operacyjny nie wie jakiego programu użyć do jego otwarcia. W takim wypadku należy wskazać jakiś edytor tekstu.
5. Włącz moduł. Przejdź na stronę Zarządzaj » Budowa witryny » Moduły w swojej witrynie i zaznacz pole wyboru w kolumnie Włączony obok nazwy modułu. Następnie kliknij Zachowaj konfigurację na samym dole. Uwaga! Jeśli aktualizujesz zainstalowany już moduł, przejdź na stronę update.php swojej witryny (np. http://example.com/update.php) i uruchom proces aktualizacji.
6. Ustal uprawnienia. Do zapewnienia prawidłowego funkcjonowania niektórych modułów konieczne będzie dokonanie zmian w konfiguracji uprawnień. Informacje na temat wymaganych zmian mogą być dołączone do modułu. Zazwyczaj należy przejść na stronę Zarządzaj » Zarządzanie użytkownikami » Uprawnienia. Przewiń stronę, by sprawdzić czy znajdują się na niej uprawnienia związane z nowym modułem, a jeśli tak, nadaj odpowiednie uprawnienia wybranym rangom użytkowników.
7. Wprowadź ustawienia. Większość modułów wyposażonych jest w jakiegoś rodzaju stronę konfiguracyjną. Jeśli nie jest ona wymieniona w README.txt sprawdź na Zarządzaj » Budowa witryny lub Zarządzaj Konfiguracja witryny. Jeśli nie możesz znaleźć strony ustawień modułu, przejdź na admin/by-module i spróbuj odnaleźć swój moduł na liście. Jeśli i to nie pomoże, otwórz plik .module modułu i poszukaj funkcji nazwa-modulu_menu - może znajdziesz tam ścieżkę do strony ustawień modułu.
8. Jeśli nadal masz kłopoty z uruchomieniem modułu, przeszukaj fora drupal.org i listę zgłoszeń błędów modułu.

---

Powyższy tekst stanowi tłumaczenie fragmentu Drupal handbook i udostępniany jest na licencji Creative Commons License, Attribution-ShareAlike 2.0.

© Copyright 2000-2007 by the individual contributors
© Copyright 2006-2010 for the Polish translation by Arche Twist (Drupal Polska)

Aktualizowanie modułów

Okresowo sprawdzaj, czy nie pojawiły się nowe wersje zainstalowanych modułów. Mogą one wnosić istotne poprawki, także te z zakresu bezpieczeństwa witryny.

By zaktualizować moduł, pobierz nową wersję i umieść pliki na serwerze. Następnie odwiedź podstronę update.php swojej witryny, by sprawdzić, czy nie należy dokonać aktualizacji tabel bazy danych.

W przeważającej liczbie przypadków aktualizacja nie stanowi zagrożenia dla danych utworzonych przez moduł ani jego ustawień. Jeśli masz wątpliwości, czy dana wersja jest kompatybilna z wersjami poprzednimi, sprawdź release notes na stronie modułu.

<hr />

Powyższy tekst stanowi tłumaczenie fragmentu Drupal handbook i udostępniany jest na licencji Creative Commons License, Attribution-ShareAlike 2.0.

© Copyright 2000–2007 by the individual contributors
© Copyright 2006–2007 for the Polish translation by Arche Twist

Instalowanie nowych skórek

Tekst został zaktualizowany z uwzględnieniem zmian w Drupalu 5 i 6.

Kiedy już zapoznasz się z różnymi funkcjami Drupala, prawdopodobnie zechcesz zmienić jego wygląd. Celowi temu służą skórki – część z nich możesz pobrać ze strony Drupala, a następnie samemu zmodyfikować.

Instalacja nowej skórki jest niezwykle prosta:

1. Pobierz nową skórkę. Pamiętaj, że skórki przeznaczone dla danej wersji Drupala nie będą kompatybilne z inną. Skórki dla wersji 5 nie będą działać pod Drupalem 6 i odwrotnie.
2. Przeczytaj instrukcje zawarte w pliku README lub INSTALL (jeśli w ogóle istnieją), by dowiedzieć się, czy instalacja skórki wymaga jakichś szczególnych zabiegów.
3. Wyślij zawartość pobranej paczki ze skórką do katalogu sites/all/themes (jeśli jeszcze nie istnieje, utwórz go).
4. Przejdź do menu Zarządzaj, a następnie na stronę Skórki (adres /admin/build/the­mes) i włącz nową skórkę.
5. Zmień ustawienia swojego konta użytkownika, wybierając nową skórkę. Jeśli chcesz, by stała się ona skórką domyślną dla wszystkich użytkowników, zaznacz pole wyboru Domyślna na stronie zarządzania skórkami.

Zadania cron

Część modułów Drupala, w tym moduł subskrybenta kanałów informacyjnych i moduł wyszukiwarki, wymaga do poprawnej pracy regularnego wykonywania skryptu cron.php, a poprzez niego z kolei – czynności takich jak aktualizacja listy słów kluczowych czy wiadomości z kanałów.

Drupal wymaga także by skrypt był uruchamiany z zewnątrz, np. poprzez przeglądarkę.

W wypadku wątpliwości co do dostępności danych programów, zwróć się o pomoc do administratora swojego serwera.

Program cron

cron jest programem służącym do okresowego wykonywania zadań, uruchamianym z konsoli i dostępnym pod systemy uniksowe. Sprawdź czy Twój dostawca usług hostingowych dał Ci do niego dostęp i, jeśli tak – zapoznaj się z poniższym opisem konfiguracji. W przeciwnym wypadku skorzystaj z modułu Poormanscron.

Istnieją dwie podstawowe metody konfiguracji crona – z linii poleceń i panelu konfiguracyjnego.

Konfigurowanie zadań z linii poleceń

crontab

Jeśli posiadasz dostęp do linii poleceń serwera, na którym znajduje się Twoja strona (shell), zapoznaj się z dokumentacją programu crontab (polecenie man crontab) i dodaj poniższe zadanie:

45 * * * * /usr/bin/lynx -source http://przykladowy-adres.com/cron.php

Fragment przykladowy-adres.com musisz oczywiście zamienić na adres Twojej strony. Może się również zdarzyć, że przeglądarka lynx, z której usług korzystamy w tym przykładzie, znajduje się w innym katalogu (sprawdź to komendą whereis lynx), ma inną nazwę (np. /usr/bin/lynx2) lub w ogóle nie jest dostępna. W ostatnim przypadku skorzystaj z innego programu, np. wget. Zadanie będzie wtedy wyglądać mniej więcej tak:

45 * * * * /usr/bin/wget -O – -q http://przykladowy-adres.com/cron.php

skrypty cron-lynx.sh i cron-curl.sh

Alternatywnie, możesz skorzystać ze skryptu cron-lynx.sh lub cron-curl.sh (jeśli nie masz dostępu do lynx), znajdującego się w podkatalogu /scripts w paczce z Drupalem. Dostosuj skrypt i dodaj zadanie go uruchamiające do crontab:

45 * * * * /home/www/dru­pal/scripts/cron-lynx.sh

Fragment /home/www/drupal zamień na ścieżkę do Twojego katalogu z Drupalem (musi być to pełna ścieżka).

Bez dostępu do linii poleceń

Jeśli nie masz dostępu do linii poleceń, ale w panelu zarządzania Twoją stroną istnieje możliwość konfiguracji zadań cron, przejdź do niej, a Twoim oczom ukaże się zapewne jakiś formularz. W polu minut wprowadź liczbę 45, a w innych polach dotyczących czasu wykonania wprowadź gwiazdki. Jako polecenie wpisz np. /usr/bin/lynx -source http://przykladowy-adres.com/cron.php (patrz: przykłady wyżej).

<hr />

Powyższy tekst stanowi tłumaczenie fragmentu Drupal handbook. Udostępniany jest on na licencji Creative Commons Attribution-ShareAlike 2.0.

© Copyright 2000–2007 by the individual contributors
© Copyright 2005–2007 for the Polish translation by Arche Twist

Pamięć serwera dostępna dla PHP

Rdzeniowi Drupala wystarczy 8 MB pamięci, co jest domyślną wartością w konfiguracji PHP. Jednakże niektóre moduły dodatkowe – zwłaszcza te, które zajmują się przetwarzaniem dużych partii tekstu (Textile, Texy) – mogą się okazać bardziej wymagające. Informuje o tym komunikat

Fatal error: Allowed memory size of X bytes exhausted (tried to allocate Y bytes)

W takim wypadku należy zwiększyć ilość dostępnej pamięci, w jeden z opisanych niżej sposobów.

Jeśli masz dostęp do pliku konfiguracyjnego PHP php.ini (serwery dedykowane), dodaj do niego następującą linijkę:

memory_limit = 16M

Jeśli nie (tzw. "serwery wirtualne"), edytuj plik /sites/default/settings.php Drupala:

ini_set('memory_limit', '16M');

Możesz również edytować plik .htaccess z głównego katalogu Drupala:

php_value memory_limit 16M

Wartość 16M jest oczywiście sugerowana i powinna zostać dostosowana do wymagań konkretnej instalacji.

---

Powyższy tekst stanowi tłumaczenie fragmentu Drupal handbook. Udostępniany jest on na licencji Creative Commons Attribution-ShareAlike 2.0.

© Copyright 2000–2007 by the individual contributors
© Copyright 2005–2007 for the Polish translation by Arche Twist