Pobierz Drupala

Drupal, dodatkowe moduły oraz skórki dostępne są (na zasadach licencji GNU GPL, za darmo) na stronie projektu Drupal. Drupal, napisany w PHP i wykorzystujący bazę danych MySQL lub PostgreSQL, może zostać uruchomiony na wielu platformach, w tym na serwerze Apache i Microsoft IIS.

Główne założenia Drupala

Modularność i elastyczność

Drupal składa się z niewielkiego, ale oferującego duże możliwości "rdzenia", który może być w prosty sposób uzupełniony za pomocą dodatkowych modułów.

Wysokiej jakości kod

Drupal przedkłada dostarczenie wysokiej jakości, eleganckiego i dobrze udokumentowanego kodu nad multum niedopracowanych funkcji.

Zgodność ze standardami

Drupal stara się wspierać cenione i dopiero rozwijające się standardy, między innymi XHTML i CSS.

Niskie wymagania

By zapewnić świetną wydajność serwera, Drupal stawia na rozwiązania, które nie wykorzystują niepotrzebnie jego mocy (na przykład minimalizując liczbę zapytań do bazy danych).

Otwarty kod źródłowy

Drupal opiera się na filozofii wspólnego tworzenia darmowego oprogramowania. Wydawany jest na licencji GPL i jego kod źródłowy jest dostępny publicznie. Drupal wspiera i korzysta z innych projektów o otwartym kodzie, na przykład z PHP, MySQL i PostreSQL.

Łatwość korzystania

Drupal chce zapewnić twórcom, administratorom oraz użytkownikom komfort w korzystaniu z niego.

Współtworzenie

Drupal wspiera otwarte rozwiązania i systemy współdzielenia informacji.

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

Terminologia

Poniżej znajduje się objaśnienie najważniejszych terminów związanych z Drupalem.

blok

bloki to dodatkowe (względem samej treści - tekstów) elementy strony, zawierające odnośniki lub informacje. Zwykle wyświetlane są przy lewej lub prawej krawędzi strony (zależy to od ustawień skórki i samych bloków). Bloki nie są segmentami, są jedynie sposobem na umieszczenie danych na stronie. Ich wygląd może być zmieniany przez skórkę

silnik skórki

silnik skórki to zestaw skryptów, które interpretują kod Drupala i sprawiają, że tworzenie skórek (zmieniających wygląd stron) jest prostsze. Polega to na pobraniu tworzonej dynamicznie zawartości i wyświetleniu jej z użyciem języka HTML. Dostępnych jest kilka "silników", ale domyślnym jest PHPTemplate.

filtr

filtry umożliwiają zmianę sposobu wyświetlania wprowadzanych danych (np. znaczników)

moduł

moduł to kawałek kodu Drupala, który odpowiada za jakąś funkcję. Moduły "rdzenia" to moduły zawarte w standardowej paczce Drupala. Moduły dodatkowe to moduły dostępne do pobrania osobno

segment

prawie każda treść w Drupalu jest zapisywana jako segment. Segmentami są artykuły, ankiety, wątki na forum, strony drupalowych "książek" itd. Nie są nimi odpowiedzi dodawane przez użytkowników. Polska nazwa wyraża dwoistą naturę tych składników, będących zarówno osobnymi "przedmiotami" niosącymi podstawową treść, jak i elementami większej całości (Drupal to właściwie zbiór segmentów)

kontrola dostępu

kontrola dostępu posługuje się systemem uprawnień do decydowania, użytkownicy których rang mogą dodawać, modyfikować lub usuwać konkretne elementy strony. Pierwszy zarejestrowany użytkownik Drupala (z identyfikatorem nr 1) automatycznie otrzymuje wszystkie uprawnienia

rangi

rangi są zespołami uprawnień, które można przydzielać użytkownikom. Użytkownicy mogą posiadać jedną lub więcej rang. Dwie rangi, użytkownik autoryzowany (czyli zarejestrowany na stronie i zalogowany) oraz użytkownik anonimowy (niezalogowany), są rangami standardowymi, dostępnymi od razu po instalacji Drupala. Pierwszy użytkownik może tworzyć dodatkowe rangi i zmieniać ich uprawnienia

styl

plik (lub pliki) CSS, które zmieniają reguły zdefiniowane w standardowych plikach CSS skórki lub silnika skórek. Umieszczony w katalogu skórek, pojawia się na liście skórek w menu zarządzania stroną

taksonomia

taksonomia to, pierwotnie, nauka o klasyfikacji. W Drupalu taksonomia jest zbiorem kategorii, które możesz wykorzystać do klasyfikowania i organizowania zawartości strony. Więcej informacji znajdziesz w dokumentacji taksonomii

szablon

plik zawierający głównie kod HTML oraz fragmenty kodu powiązane z silnikiem skórek

skórka

skórka to plik lub (zazwyczaj) zbiór plików, które razem decydują o wyglądzie i sposobie działania strony. Pliki te zazwyczaj wykorzystywane są za pośrednictwem silnika, którego funkcje PHP zamieniają argumenty na HTML. Moduły Drupala definiują pewne funkcje jako możliwe do modyfikacji przez skórkę

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

Adresy stron w Drupalu

Przykładowe ścieżki

node/3
taxonomy/term/6
flexinode/7
user/login (znajomość ścieżki do tej strony jest bardzo przydatna, jeśli przypadkiem wyłączysz blok logowania)

Jak sprawdzić, jaki adres ma strona

By sprawdzić, jaki adres posiada dana strona, przejdź do działu zarządzania i dalej na podstronę zawartość. Ukaże Ci się lista wszystkich stron, które stworzyłeś. Najedź kursorem myszy na jeden z tytułów, a zobaczysz coś takiego:

http://twojadomena.pl/?q=node/54

Ostatnia część adresu, znajdująca się po znakach /?q=, to ścieżka do segmentu - w tym przypadku node/54.

By poznać więcej ścieżek do podstron swojej witryny, obserwuj uważnie pasek stanu swojej przeglądarki, kiedy kursor znajduje się nad jednym z odnośników.

Inne miejsca

Ścieżki do stron terminów taksonomii możesz poznać przechodząc do działu zarządzania, a potem na podstronę kategorie. W tym celu najedź kursorem myszy nad tekst edytuj termin, znajdujący się przy interesującym Cię terminie. Ścieżka będzie wyglądać tak:

taxonomy/term/6

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

Wymagania

1. Serwer stron internetowych, który może uruchamiać skrypty PHP
• Zalecany: Apache. Drupala tworzono z wykorzystaniem wersji 1.3.x. Pomyślne testy przeprowadzono na wersji 2.0.x.
• Opcjonalny: IIS. Drupal powstaje także z myślą o IIS i wszystko wskazuje na to, że powinien działać pod IIS.
2. PHP
• Drupal 4.6 wymaga do pracy PHP w wersji 4.3.3 lub nowszej (PHP 5 jest także obsługiwany). Drupal od wersji 4.2 do 4.5.2 wymaga PHP w wersji 4.1 lub nowszej. Starsze wersje Drupala współpracować będą także z PHP 4.0.6. Zalecamy korzystanie z najnowszej podwersji PHP 4.x.
• Rozszerzenie XML dla PHP (wykorzystywane przez moduły bloggerapi, drupal, jabber i ping). Rozszerzenie to jest domyślnie włączone w standardowej instalacji PHP; PHP w wersji dla Windows posiada to rozszerzenie wbudowane.
• 8MB pamięci PHP dla samego rdzenia Drupala. Jeśli instalujesz dodatkowe moduły, możesz być zmuszony do zwiększenia ilości pamięci. Inne dystrybucje Drupala, takie jak dystrybucja z CivicSpace, mogą mieć wyższe wymagania co do ilości pamięci.
• By Drupal mógł działać PHP musi posiadać następujące dyrektywy konfiguracyjne:
• session.save_handler: user
• Zalecane są także:
• session.cache_limiter: none
• (wymieniamy tu jedynie te dyrektywy, które nie są domyślnie umieszczone w php.ini-dist / php.ini-recommended od PHP w wersji 4.0.6 wzwyż)
• Ustawienia te znajdują się w standardowym pliku .htaccess dołączonym do Drupala, więc nie powinieneś być zmuszony do ich samodzielnego wprowadzenia. Pamiętaj jednak, że modyfikacja konfiguracji PHP poprzez plik .htaccess działa jedynie
• w przypadku serwera Apache (lub kompatybilnego z nim),
• jeśli plik .htaccess jest rzeczywiście odczytywany, tzn. jeśli AllowOverride nie jest ustawione na None,
• jeśli PHP zainstalowane jest w postaci modułu serwera Apache.
• Przeczytaj informacje na tej stronie, aby dowiedzieć się jak zmienić ustawienia PHP w inny sposób.
• Korzystanie z bazy danych wykorzystującej PEAR (patrz niżej) możliwe jest oczywiście jedynie wtedy, gdy sam PEAR jest zainstalowany.
3. Baza danych współpracująca z PHP
• Zalecana: MySQL w wersji 3.23.17 lub nowszej (Drupal korzysta z INNER JOIN i join_condition). Obsługiwane jest także MySQL w wersji 4.
• Od wersji 4.7 Drupal dobrze współpracuje z bazą danych PostgreSQL w wersji 7.3 lub nowszej (będzie działać prawdopodobnie także pod wersją 7.2, możliwe jest jednak, że napotkasz pewne błędy, jeśli masz zamiar dokonać aktualizacji z Drupala 4.6).

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

Instalujemy Drupala

Baza danych

Przed rozpoczęciem właściwej instalacji Drupala należy najpierw przygotować bazę danych. Można ją utworzyć na przykład za pomocą panelu zarządzania witryną, który oferuje firma hostingowa (słowa-klucze: baza danych, database, MySQL, ewentualnie phpMyAdmin). Do bazy danych trzeba również przypisać konto użytkownika i ustalić dla niego hasło.

W trakcie tworzenia bazy warto zanotować wprowadzane dane, ponieważ będzie je jeszcze trzeba podać w trakcie instalacji Drupala.

Pliki

Kolejnym krokiem jest pobranie Drupala.

Pobraną paczkę należy rozpakować (użytkownicy Linuksa sami wiedzą, że tar -zxvf, a użytkownikom Windows polecić można darmowy dekompresor 7-Zip), a jej zawartość wysłać na serwer FTP, w miejsce dostępne dla odwiedzających (np. podkatalog public_html).

Instalacja

Skrypt instalacyjny ustali podstawowy adres URL witryny, połączy się z bazą danych i utworzy konieczne tabele.

By go uruchomić, wystarczy przejść pod adres witryny. Zostanie wyświetlona strona Database configuration (Konfiguracja bazy danych). Do pola oznaczonego Database name należy wpisać nazwę stworzonej w punkcie pierwszym bazy danych, do Database username – nazwę konta użytkownika bazy, a do Database password jego hasło.

W pewnych wypadkach należy również podać adres serwera bazy danych – służy do tego pole Database host znajdujące się w grupie ustawień Advanced options.

Ustawienia należy potwierdzić przyciskiem Save configuration.

Skrypt spróbuje ustawić plikowi settings.php atrybut „tylko do odczytu” (plik domyślnie znajduje się w katalogu sites/default). Jeśli będziesz w przyszłości dokonywać w nim jakichś zmian, pamiętaj by – ze względów bezpieczeństwa – po ich zakończeniu znów ustawić ten atrybut.

Pierwsze konto użytkownika

Jeśli wszystko przebiegło pomyślnie, będzie można utworzyć pierwsze konto użytkownika, posiadające całkowitą kontrolę nad witryną. W Drupalu 5 służy do tego odnośnik create the first account (utwórz pierwsze konto), znajdujący się na stronie powitalnej, do której można przejść po ukończeniu instalacji. Po zalogowaniu się jako administrator można też dokończyć konfigurację witryny.

W Drupalu 6 tworzenie pierwszego konta użytkownika jest częścią procesu instalacji i nie wymaga żadnych dodatkowych zabiegów.

Aktualizowanie Drupala

Co kilka miesięcy wydawana jest nowa „duża” wersja Drupala (pomniejsze częściej). Zaleca się regularne dokonywanie aktualizacji, co pomoże uniknąć potencjalnych problemów związanych z lukami bezpieczeństwa i zapewni dostęp do nowych funkcji.

Uwaga. Przed dokonaniem aktualizacji do nowej, „dużej” wersji Drupala (np. 5, 6 czy 7), należy sprawdzić, czy zainstalowane moduły dodatkowe oraz skórki są dostępne w wersjach kompatybilnych z nowym Drupalem (czy zostały zaktualizowane).

Kroki wstępne

Aktualizację witryny warto poprzedzić zalogowaniem się do konta administratora (pierwszego konta użytkownika) oraz aktywacją trybu przerwy technicznej: Zarządzaj → Konfiguracja witryny → Przerwa techniczna.

Następnie należy wyłączyć wszystkie moduły dodatkowe, czyli takie, które nie są standardowymi składnikami Drupala, a także zmienić skórkę witryny na domyślną (Garland w Drupalu 5 i 6): Zarządzaj → Budowa witryny → Moduły oraz Skórki.

Tworzenie kopii zapasowej istniejącej konfiguracji

Przed przystąpieniem do aktualizacji należy utworzyć zapasowe kopie istniejących plików i bazy danych. Aktualizacja bazy danych nie zawsze jest konieczna, mimo to i w takich wypadkach nie zaszkodzi skopiować ją w bezpieczne miejsce.

Do pobrania plików istniejącej instalacji Drupala można wykorzystać klienta FTP lub konsolę serwera. Następnie należy skopiować zawartość bazy danych przy pomocy narzędzia phpMyAdmin lub linii poleceń serwera MySQL.

phpMyAdmin

• zaloguj się do phpMyAdmin i wskaż odpowiednią bazę danych na liście po lewej>
• kliknij kartę Eksport
• kliknij Zaznacz wszystkie
• upewnij się, że zaznaczone są opcje Struktura i Dane
• zaznacz Zapisz jako plik
• kliknij przycisk Wykonaj i zapisz plik .sql na dysk

linia poleceń MySQL (alternatywnie)

Przed wykonaniem kolejnych czynności najlepiej jest wyłączyć wszelkie zadania cron.

Następnie należy przenieść się do katalogu instalacji Drupala i pobrać specjalny skrypt, który utworzy kopię zapasową bazy danych w pliku backup.sql:

wget -O drupalsqldump.sh "http://cvs.drupal.org/viewvc.py/drupal/contributions/sandbox/drumm/tools/drupalsqldump.sh?view=co"
chmod +x drupalsqldump.sh

Poniższa komenda spowoduje sprawdzenie ustawień w pliku settings.php, automatyczne połączenie z bazą danych i utworzenie jej kopii:

./drupalsqldump.sh sites/default/set­tings.php > backup/backup.sql

Pobranie i wysłanie na serwer nowych plików Drupala

Paczki z Drupalem znajdują się w dziale Downloads witryny oficjalnej. Za pomocą klienta FTP należy przenieść stare pliki do osobnego katalogu, np. o nazwie kopia. Najlepiej jest wysyłać pliki nowego Drupala do katalogu, w którym brak pozostałości po starym.

Następnie należy przystąpić do wysyłki nowych plików, rozpakowanych z pobranej wcześniej paczki, a po zakończeniu tego procesu – upewnić się, że możliwy jest zapis do podkatalogu files.

Na serwer trzeba także wysłać pliki wszelkich modułów dodatkowych, które mają działać w witrynie (lista dostępnych modułów). Muszą być one kompatybilne z nowym Drupalem. Podobnie należy postąpić z niestandardowymi skórkami.

Następujące pliki muszą zostać skopiowane z katalogu z kopią zapasową do katalogu instalacji Drupala:

• .htaccess
• sites/default/set­tings.php
• katalog files
• wszelkie inne pliki, które mogą okazać się potrzebne

Uruchomienie skryptu aktualizującego bazę danych

Przed wywołaniem skryptu należy się zalogować jako użytkownik nr 1, czyli administrator witryny, a jeśli jest to niemożliwe – wyedytować skrypt update.php, zmieniając ustawienie $access_check z TRUE na FALSE. Po dokonaniu aktualizacji bazy danych trzeba przywrócić poprzednią wartość! W przeciwnym razie każdy będzie w stanie uruchomiać skrypt aktualizujący.

Końcowym krokiem jest oczywiście uruchomienie skryptu, co czyni się za pomocą przeglądarki, przechodząc pod adres strony uzupełniony nazwą skryptu: http://example.com/update.php. Skrypt uruchama się jedynie raz. Gdy zakończy on pracę, warto sprawdzić, czy nie pojawiły się komunikaty o wystąpieniu błędów.

Po aktualizacji

Każda witryna jest inna

Tym jakże romantycznym hasłem autor chciał przekazać, że witryna może wymagać wykonania jakichś dodatkowych czynności, zależnie od jej konfiguracji. Większość problemów związanych z aktualizacją wynika stąd, że osoby je przeprowadzające nie pamiętają o specyficzności konfiguracji swoich witryn.

Włączenie modułów i skórek

Na stronach Zarządzaj → Budowa witryny → Moduły i Skórki należy włączyć wszelkie potrzebne moduły i skórki, a na Zarządzaj → Zarządzanie użytkownikami → Uprawnienia (lub Kontrola dostępu) nadać użytkownikom odpowiednie uprawnienia.

Usunięcie plików

Ostatnim krokiem jest usunięcie bądź przeniesienie w inne miejsce plików install.php, CHANGELOG.txt, INSTALL.txt, INSTALL.mysql­.txt, INSTALL.pgsql­.txt, LICENSE.txt, MAINTAINERS.txt oraz UPGRADE.txt, znajdujących się w głównym katalogu Drupala.

Testowanie zaktualizowanej witryny

Warto przeprowadzić test funkcjonowania zaktualizowanego Drupala, odwiedzając najpopularniejsze wśród odwiedzających strony. Które? Można się tego dowiedzieć obserwując dzienniki zdarzeń w dziale zarządzania.

Potem można już odwiedzić witrynę i wyłączyć tryb przerwy technicznej, udostępniając ją odwiedzającym.

<hr />

Fragmenty tego tekstu są tłumaczeniem stron Drupal handbook, który udostępniany jest na zasadach licencji Creative Commons Attribution-ShareAlike 2.0.

© Copyright 2000–2007 by the individual contributors (Drupal.org)
© Copyright 2006–2008 Arche Twist

Aktualizacja - łatanie i porównywanie plików

Artykuł został zaktualizowany 5 stycznia 2007 roku. Dodano opis skryptu ułatwiającego łatanie katalogów.

Nawet złowrogi Sith, przebywający na co dzień po ciemnej stronie mocy, musi sobie coś czasem załatać. Inaczej mówiąc: i użytkownik Windows musi (bądź chce) mieć czasem do czynienia z łatami (*.patch).

Omówione sytuacje

1. Co pewien czas pojawiają się nowe wersje Drupala, których wydanie podyktowane zostało wykryciem luk bezpieczeństwa. Czy nie znudziło się już Wam wysyłanie od nowa całej paczki z Drupalem?
2. Denerwuje Was jakiś mniej znany błąd lub chcecie skorzystać z łatki dodającej niestandardowe funkcje? Mozolnie ślęczycie nad edytorem, kopiując i wklejając odpowiednie linijki?
3. A może chcecie stworzyć własną łatkę, by móc później automatycznie dodawać poczynione przez siebie modyfikacje do oryginalnych plików?

1. Porównywanie katalogów przed aktualizacją Drupala

Korzystając z jednego z poniższych sposobów można wytypować pliki, które wymagają wysłania na serwer, a te, które nie uległy zmianie od ostatniej aktualizacji, pozostawić w spokoju.

WinMerge – tylko pod Windows

Porównywanie dwu archiwów z Drupalem w WinMerge

Dobrym darmowym windowsowym narzędziem do porównywania katalogów jest WinMerge.

Katalogi (lub nawet dwa archiwa .tar.gz) wybiera się za pomocą przycisku Porównaj. Na czerwono oznaczone zostaną pliki różniące się między sobą zawartością lub nieistniejące w jednym z katalogów.

By nie musieć wchodzić do każdego z podkatalogów po kolei, warto zaznaczyć opcję Domyślnie uwzględnij podkatalogi.

Vim – pod Unix/Linux i Windows

Za pomocą wszechstronnego edytora Vim, ze wsparciem DiffUtils w wersji dla Unix/Linux lub dla Windows, a także wtyczki DirDiff, możemy porównać zawartość dwu katalogów.

Ładne pokolorowanie różnic zapewni natomiast zestaw kolorów Twist.

Do porównania katalogów, po uprzednim zainstalowaniu wszystkich potrzebnych rzeczy, używamy poniższej komendy (którą wydajemy w gVimie):

:DirDiff <katalog A> <katalog B>

Okno gVima zostanie podzielone na 3 części – dwie pierwsze będą zajmować podglądy różnic w plikach, a w trzeciej znajdować się będzie lista plików, które okażą się nie być identycznymi. Umieszczając kursor nad linijką odnoszącą się do dwu takich plików i wciskając klawisz o, można otworzyć je na podglądzie.

2. Łatanie plików

Łaty zamieszczane na drupal.org tworzone są programem diff i zapisywane w tzw. „zunifikowanym formacie”. Podobne łaty możemy także uzyskać, tworząc je w programie WinMerge, korzystając z opisu znajdującego się pod koniec artykułu.

Patch Wizard

Patch Wizard to skrypt PHP, ułatwiający łatanie plików. Umieściwszy go na serwerze, w miejscu dostępnym z przeglądarki internetowej, możemy załatać cały wybrany katalog wprowadzoną w odpowiednim polu łatą (należy wkleić zawartość pliku z łatą – *.patch).

Fragment Patch Wizard

Strategia jest prosta. Gdy pojawia się nowa wersja Drupala, porównuję jej archiwum z zainstalowaną na serwerze, za pomocą WinMerge (widok z opcją Uwzględnij podkatalogi). WinMerge odfiltrowuje pliki, które wymagają szczególnego potraktowania (zmienione przeze mnie), a całą resztę zaznaczam i korzystam z Narzędzia → Generuj patch, gdzie wybieram opcję otwarcia w zewnętrznym edytorze. Kopiuję łatę i wklejam do przeznaczonego dla niej pola udostępnianego przez skrypt Patch Wizard. Odpalam i Drupal załatany.

Podobnie postąpić można z gotowymi łatami, dostępnymi na drupal.org.

Skrypt umożliwia przekazywanie wartości ustawień poprzez URL (np. ?dir=/home/example w adresie), dzięki czemu mogę skorzystać z zakładek, które „pamiętają” za mnie większość ustawień, a moja rola sprowadza się do wciśnięcia przycisku. Jest to pomocne zwłaszcza, jeśli konieczne jest załatanie kilku witryn.

Dostępne argumenty URL to:

• dir – katalog do załatania
• p – P level
• unified – jeśli równa się 0, tzw. zunifikowany format nie jest wykorzystywany

Cały URL wyglądać więc będzie mniej więcej tak:

http://example.com/patch-wizard.php?dir=/home/example/example.com&p=0

Vim

By coś z pomocą Vima załatać, potrzebujemy programu Patch w wersji dla Windows lub dla Unix/Linux.

Przechodzimy do gVima i otwieramy w nim plik, który zamierzamy załatać. Następnie korzystamy z funkcji Podziel łatane przez (nie, nie mam pojęcia, kto ją tak przetłumaczył) i wskazujemy pobrany z drupal.org (albo innej strony) plik z roszerzeniem patch. Wyplute zostanie okienko linii poleceń z komunikatami programu Patch, które zamykamy wciskając Enter. O przebiegu łatania powiadomi nas też Vim – ponownie wciskamy Enter.

Okno gVim-a z zestawem kolorów Twist, podzielone między załatany, a oryginalny plik

Po lewej stronie okna gVima widoczny będzie nowy, jeszcze nie zapisany, plik będący wynikiem łatania pliku znajdującego się po stronie prawej. Sprawdzamy czy wszystko wygląda w porządku i – upewniwszy się, że kursor znajduje się w lewej części okna – zapisujemy plik, usuwając końcówkę .new. Można go teraz wysłać na serwer.

3. Tworzenie łat

Tworzenie łat ma sens z kilku powodów. Jeśli chcemy udostępnić nasze modyfikacje, oszczędzamy miejsce na serwerze i czas ewentualnych zainteresowanych. Poza tym przydają się w przypadku modyfikacji często aktualizowanych plików, bo nie musimy sami od nowa grzebać w plikach, które zmieniła centrala.

za pomocą WinMerge

Otwieramy do porównania oryginalny plik i jego kopię zmodyfikowaną przez nas oraz wchodzimy do menu Narzędzia → Generuj patch. W nowootwartm okienku Plikiem 1 będzie ten otwarty w lewej części okna, a Plikiem 2 – otwarty w prawej. Jeśli nie odpowiada nam ta kolejność, możemy kliknąć przycisk Zamień.

W polu Wynik wpisujemy ścieżkę i nazwę pliku oczekiwanej łatki (lub klikamy sąsiedni przycisk Przeglądaj). Z grupy opcji o nazwie Format, przy Styl wybieramy Zunifikowany. Przy Kontekst wybrać możemy ile linii sąsiadujących z linią zawierającą zmianę będzie umieszczanych w łacie – im więcej, tym mniejsze ryzyko późniejszego wprowadzenia zmiany w złym miejscu, ale i większe prawdopodobieństwo niedopasowania łaty do pliku, który bardzo się zmienił od czasu jej utworzenia.

za pomocą Patch

Wydajemy polecenie

diff -u plik1 plik2

Kapitanie, nie mam go na radarze!

W wypadku korzystania z Patch bądź DiffUtils pod Windows, konieczne jest dopisanie ścieżek do tych programów do listy zmiennych środowiskowych. Czynimy to poprzez Mój komputer → Właściwości → karta Zaawansowane → Zmienne środowiskowe → Zmienne systemowe. Tam, na liście odszukujemy zmienną Path i na końcu zawartości pola Wartość dodajemy:

• dla Patch: ;C:\Program Files\GNU\Patch\bin
• dla DiffUtils: ;C:\Program Files\GNU\DiffUtils\bin

Powyższe ścieżki są domyślnymi – jeśli programy zainstalowane są w niestandardowych katalogach, trzeba je oczywiście wskazać.

Wiele witryn, jeden Drupal (multisite)

Tytuł tego artykułu to nie propozycja nowego hasła reklamowego, a skrótowy opis funkcji multisite, o której wspomina się w dokumentacji dołączonej do Drupala, a dającej możliwość wykorzystania jednej instalacji Drupala do budowy wielu witryn.

Spis treści

• Zalety
• Wprowadzenie
  1. nazewnictwo katalogów
  2. tabele bazy danych
  3. współdzielenie tabel
• Instalacja
  1. settings.php
  2. dowiązanie/alias
  3. konfiguracja nowej witryny
  4. konfiguracja współdzielenia tabel (opcjonalnie)

Zalety

• oszczędność miejsca
  wszystkie strony korzystają z tych samych plików Drupala
• prostsza aktualizacja
  jednokrotna aktualizacja plików
• możliwość współdzielenia tabel bazy danych
  logowanie do wszystkich stron jednym loginem i hasłem, uproszczenie zarządzania wieloma witrynami

Wprowadzenie

Poniższy opis zakłada, że korzystasz z Drupala w wersji 5.0 lub wyższej!

Drupal przechowuje informacje o obsługiwanych witrynach w podkatalogu sites. Na początku znajduje się tam kolejny podkatalog, default, wraz z plikiem settings.php. W pliku tym instalator, bądź Ty sam, umieścił konfigurację witryny, między innymi informacje o bazie danych i adresie.

1. nazewnictwo katalogów

Każda dodatkowa drupalowa witryna powinna mieć własny podkatalog w sites, z własnym plikiem konfiguracyjnym settings.php. Nazwa podkatalogu powinna odpowiadać adresowi witryny. Rozważmy trzy możliwości:

witryna w podkatalogu

adres witryny: przykładowy-adres.pl/strona

nazwa katalogu: przykładowy-adres.pl.strona

witryna jako subdomena

adres witryny: strona.przykładowy-adres.pl

nazwa katalogu: strona.przykładowy-adres.pl

witryna z własną domeną

adres witrny: przykładowy-adres.pl

nazwa katalogu: przykładowy-adres.pl

2. tabele bazy danych

Musisz podjąć decyzję, czy chcesz umieścić tabele bazy danych nowej strony wewnątrz obecnej bazy, czy w nowej bazie:

wewnątrz obecnej bazy

tabele nowej bazy będą się różnić od starych prefiksem, np. prefiks_node zamiast node

w nowej bazie

konieczne utworzenie nowej bazy o tej samej nazwie użytkownika i haśle co stara!

3. współdzielenie tabel

Jeśli zamierzasz stworzyć zupełnie niezależną witrynę, pomiń ten punkt i wszystkie kolejne dotyczące współdzielenia tabel.

Jeśli natomiast chciałbyś zapewnić użytkownikom możliwość logowania się do kilku Twoich witryn za pomocą jednego loginu i hasła lub uchronić się od konieczności instalowania tłumaczenia osobno dla każdej witryny, powinieneś rozważyć współdzielenie niektórych tabel między witrynami.

Instalacja

1. settings.php

Załóżmy, że Twoja nowa strona będzie się znajdować pod adresem strona.pl. Wyślij więc na serwer, do utworzonego przez Ciebie podkatalogu sites/strona.pl, plik settings.php z paczki Drupala. Następnie nadaj innym, już na serwerze, uprawnienia do zapisu do niego (chmod 666).

2. dowiązanie/alias

Teraz musisz spowodować by podkatalog, subdomena lub nowa domena kierowały do plików starej strony.

Uwaga, w większości przypadków przy tworzeniu subdomeny tworzony jest także podkatalog o odpowiadającej jej nazwie. Należy go usunąć!

To bardzo istotny punkt. Do jego realizacji potrzebujesz dostępu do linii poleceń serwera lub demona cron lub tworzenia wskaźników domen z opcją "alias".

W pierwszym i drugim przypadku chodzi o wydanie polecenia:

ln -s /katalog/głównej/witryny /katalog/nowej/witryny

Katalog nowej strony tak naprawdę nie istnieje fizycznie na serwerze, a zamiast niego tworzymy tak zwane dowiązanie symboliczne. Ścieżki muszą być pełne, to znaczy, rozpoczynać się muszą od głównego katalogu serwera (np. /home/użytkownik/public_html/strona).

W trzecim przypadku wykorzystujemy dostępną w panelu zarządzania stroną opcję "wskaźników domen" i tworzymy nową domenę lub subdomenę wskazującą na starą.

Zanim alias zacznie działać, może upłynąć trochę czasu.

3. konfiguracja nowej witryny

Jeśli adres Twojej nowej witryny jest już dostępny, uruchom skrypt instalacyjny, przechodząc na stronę strona.pl/install.php (adres przykładowy). Wprowadź potrzebne dane, takie jak nazwa i hasło użytkownika bazy danych, nazwa samej bazy, itd.

Jeśli nowa witryna ma korzystać z tej samej bazy danych, co poprzednia, ustal prefiks dla tabel bazy, pod Advanced options, w polu Table prefix.

Instalator utworzy tabele w bazie danych i wstępnie skonfiguruje witrynę. Jeżeli nie masz zamiaru współdzielić żadnych z nich, jest to już dla Ciebie koniec instalacji. Gratulacje! W przeciwnym wypadku wykonaj jeszcze czynności opisane w kolejnym punkcie.

4. konfiguracja współdzielenia tabel (opcjonalnie)

Każda z tabel bazy danych Drupala odpowiada za inną funkcję. To, które tabele Drupal ma współdzielić pomiędzy witrynami, ustala się w pliku settings.php nowoutworzonej witryny. Pobierz go z odpowiedniego dla Twojej nowej witryny podkatalogu na serwerze i otwórz. Instalator zapisał tam dane, więc edycja innego pliku byłaby błędem.

Zwróć uwagę na zmienną $db_prefix. To jej wartość będziesz musiał zmienić, zależnie od tego, które z tabel chcesz współdzielić, oraz tego, czy będziesz korzystać z jednej bazy danych z różnymi prefiksami tabel, czy większej ilości baz.

jedna baza danych

'default' => 'prefiks_'

dwie lub więcej baz

'default' => 'baza.'

Przykładowa konfiguracja dla witryn korzystających z jednej bazy, umożliwiająca pojedynczą rejestrację użytkowników:

$db_prefix = array(
'default' => 'prefiks_',
'authmap' => '',
'permission' => '',
'profile_fields' => '',
'profile_values' => '',
'role' => '',
'sequences' => '',
'sessions' => '',
'users' => '',
'users_roles' => ''
);

Wyróżnione tabele będą współdzielone, natomiast w przypadku innych, wyszukiwane będą te poprzedzone prefiksem prefiks_.

Uwaga! Jeśli korzystasz z Drupala 5 lub starszego i zamierzasz współdzielić konta użytkowników (a więc tabele users i sequences), koniecznie przeczytaj o problemie związanym z nadpisywaniem danych kont użytkowników. Nie dotyczy on Drupala 6.

Możesz współdzielić także inne tabele, jednak wskazana jest tutaj daleko idąca ostrożność. Współdzielenie części z nich może powodować błędy w działaniu stron. Oto inne "bezpieczne" ustawienia:

'filter_formats' => '',
'filters' => '',
'locales_meta' => '',
'locales_source' => '',
'locales_target' => '',

Powodują one współdzielenie filtrów i tłumaczeń.

To już wszystko.

$array['uid'] = db_next_id('{users}_uid');

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ć.

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

Tworzenie własnych skórek

Jeśli chcesz stworzyć własną skórkę, możesz albo zmodyfikować istniejącą lub zacząć od podstaw.

By zmodyfikować istniejącą skórkę, po prostu skopiuj ją do nowego katalogu i nadaj jej inną nazwę (skórki nie powinny posiadać nazw istniających modułów). Następnie zmień skórkę tak jak Ci się podoba.

Jeśli zamierzasz zaprojektować skórkę od podstaw, możesz albo stworzyć ją bezpośrednio w PHP, albo wykorzystać jeden z dostępnych silników skórek. W Drupalu 4.7 standardowym silnikiem jest PHPTemplate i jest to narzędzie polecane - większość gotowych skryptów dodających nowe funkcje jest przygotowywana właśnie z myślą o PHPTemplate.

Rozmieszczenie elementów strony

Od wersji 4.7 Drupal pozwala twórcom skórek na definiowanie i implementowanie dowolnej liczby tzw. "obszarów" (ang. regions) zawartości, pozwalających kontrolować rozmieszczenie elementów na stronie.

Obszary są bardzo interesującą funkcją Drupala, ponieważ pozwalają na prawie dowolne zaprojektowanie layoutu strony. Można je także wykorzystać do budowania odmiennych layoutów dla różnych działów witryny.

W skórkach nie opartych na silnikach, dostępne obszary definiowane są przez funkcję themename_regions() w pliku .theme. Skórki wykorzystujące silniki, korzystają z ich obszarów (zdefiniowanych w plikach .engine), ale także mogą definiować własne.

Zawartość jest umieszczana w obszarach poprzez system tzw. bloków (odpowiada za to moduł block) i wywołania drupal_set_content(). Na przykład kod drupal_set_content('left','Cześć wam.') sprawiłby, że tekst "Cześć wam" zostałby umieszczony w obszarze o nazwie "left" (zazwyczaj jest to tzw. lewy pasek boczny). Wszystkie dostępne obszary znajdują się na liście na stronie konfiguracji bloków w menu zarządzania.

Pierwszy obszar zdefiniowany w pliku .theme skórki lub pliku .engine silnika staje się obszarem "domyślnym".

Więcej praktycznych informacji, uwzględniających szablony PHPTemplate, znajduje się na stronie Obszary bloków i segmentów w PHPTemplate.

Tworzenie nowego szablonu PHPTemplate

PHPTemplate to tzw. silnik skórek, napisany przez Adriana Rossouwa. Wykorzystuje on pliki o nazwach kończących się na .tpl.php do modyfikacji wbudowanych w Drupala funkcji theme_costam(). Listę dostępnych funkcji można znaleźć na stronie Development Plumbing. Każdy ze wspomianych plików zawiera szkielet HTML oraz jakiś prosty kod PHP służący do prezentowania dynamicznych danych. PHPTemplate jest więc świetnym wyborem jeśli znasz trochę PHP. Korzystając z prostych "ściągawek" możesz w łatwy sposób stworzyć rozbudowane skórki.

Jeśli natomiast nie znasz PHP, PHPTemplate i tak może być odpowiednim wyborem, ponieważ naprawdę niewielkie fragmenty kodu skórek wymagają jego użycia. Możesz po prostu skorzystać ze wspomianych już ściągawek, które użytkownicy umieszczają na drupal.org, i wkleić je do swojej skórki.

Instalowanie PHPTemplate

Jeśli posiadasz wersję 4.7 (lub późniejszą) Drupala, PHPTemplate jest już w nim zawarty. W przypadku starszych wersji, musisz go najpierw pobrać i zainstalować poprzez wysłanie na serwer, do podkatalogu /themes/engines.

Tworzenie nowego szablonu PHPTemplate

Utwórz nowy podkatalog wewnątrz katalogu themes. Następnie utwórz w nim plik page.tpl.php. Jest to jedyny plik, który jest absolutnie wymagany. Jego zadanie polega na nadpisywaniu (zastępowaniu) funkcji theme('page') Drupala, która odpowiada za generowanie stron, wraz z takimi ich elementami jak nagłówek, stopka, karty czy paski boczne.

Możesz utworzyć pliki zastępujące następujące funkcje (kliknij w nazwę pliku by przejść do strony z jego objaśnieniem):

• theme('page') - plik page.tpl.php
  wygląd całej strony
• theme('block') - plik block.tpl.php
  wygląd tzw. bloków, znajdujących się w paskach bocznych
• theme('box') - plik box.tpl.php
  wygląd głównego bloku, w którym umieszcona jest główna część strony
• theme('node') - plik node.tpl.php
  wygląd segmentów (artykułów, książek itp.)
• theme('comment') - plik comment.tpl.php
  wygląd odpowiedzi dodawanych do segmentów

PHPTemplate zawiera przykładowe pliki szablonów - sprawdź w katalogu skórki box_grey. Możesz skopiować znajdujący się tam plik page.tpl.php do katalogu swojej skórki i tak zacząć jej tworzenie. Pamiętaj, że aby Drupal "dowiedział się" o istnieniu nowej skórki, będziesz musiał odwiedzić stronę zarządzaj » skórki.

Jeśli chcesz zastąpić jakieś inne, niewymienione tutaj funkcje, musisz postarać się o to sam.

Pliki .tpl.php

Objaśnienie wszystkich standardowych zmiennych występujących w plikach szablonów oraz przykłady tych plików można znaleźć na stronie PHPTemplete theme engine na drupal.org.

<?php print $header; ?>

<?php
function moja-skórka_regions() {
  return array(
      'left' => t('left sidebar'), /* to lewy pasek boczny */
      'right' => t('right sidebar'), /* a to prawy */
      'header' => t('header'), /* to nagłówek strony */
      'top' => t('góra'), /* a to nasz nowy obszar! */
      'content' => t('content'), /* dalej zawartość */
      'footer' => t('footer') /* i stopka */
  );
}
?>

<?php print $top; ?>

Alternatywne szablony w zależności od rodzaju strony

Zawarte tu informacje dotyczą modyfikacji wyglądu segmentów i całej strony w zależności od typu wyświetlanego segmentu (artykuł, wątek, książka). Mogą być one przydatne np. gdy chcesz w inny sposób zaprezentować użytkownikom statyczne strony typu „o nas” czy „regulamin korzystania” (pozbyć się informacji o dacie dodania itp.).

Drupal i PHPTemplate oferują dwie podstawowe możliwości:

• nadanie innego wyglądu segmentowi (tytuł, informacje o autorze, dacie dodania, odnośniki kontekstowe itp.)
• nadanie innego wyglądu całej stronie

poprzez stworzenie alternatywnych szablonów PHPTemplate.

Wygląd segmentów

Skopiuj swój plik node.tpl.php, odpowiadający za wygląd segmentu i nadaj mu nową nazwę, zgodnie ze schematem node-rodzaj_zawartości.tpl.php, gdzie rodzaj_zawartości to np. page czy story.

Następnie zmodyfikuj zawartość tego pliku zgodnie z Twoimi wymaganiami. Możesz usunąć pewne fragmenty albo dodać nowe. Zwróć uwagę, że – korzystając z funkcji Clean URLs – możesz zamieścić swoją stronę pod adresem typu /o-nas czy /pomoc.

Wygląd całej strony

Alternatywne szablony modyfikujące wygląd całej strony osiągnąć można na wiele sposobów. Tutaj przedstawiony zostanie jeden z najprostszych, a zarazem najbardziej wygodnych.

Mechanizm tego rozwiązania polega na wywołaniu z głównego pliku szablonu całej strony innych szablonów, w zależności od rodzaju segmentu.

Skopiuj swój plik page.tpl.php w bezpieczne miejsce oraz do pliku page-default.tpl.php. Zawartość page.tpl.php zastąp poniższym kodem, którego autorem jest PhilK:

<?php
switch ($node->type) {
  case 'book': $inc = 'page-book.tpl.php'; break;
  case 'blog': $inc = 'page-blog.tpl.php'; break;
  case 'image': $inc = 'page-image.tpl.php'; break;
  case 'forum': $inc = 'page-forum.tpl.php'; break;
  default: $inc = 'page-default.tpl.php';  break;
}
include ($inc);
?>

Działanie kodu:

• jeśli rodzaj segmentu to książka – odczytanie pliku page-book.tpl.php
• jeśli blog – page-blog.tpl.php
• jeśli grafika dodana przez moduł image – page-image.tpl.php
• jeśli wątek na forum – page-forum.tpl.php
• w innych przypadkach – page-default.tpl.php

Możesz usunąć wybrane linijki rozpoczynające się od case albo dodać własne, wywołujące szablony wyglądu innych rodzajów segmentów.

Następnie powinieneś oczywiście wyedytować każdy z potrzebnych plików .tpl.php i odpowiednio dostosować wygląd.

W ten sposób zmienić możesz nie tylko strukturę stron (HTML), ale i ich ostylowanie. W sekcji <head> danego szablonu umieść wywołanie alternatywnego arkusza stylów CSS, np. tak:

<style type="text/css" media="all">@import "/katalog_skórki/image.css";</style>

Możesz także sprawić by pierwsza, główna strona witryny posiadała inny wygląd. W tym celu stwórz szablon page-front.tpl.php i dodaj następującą linijkę na początek kodu w pliku page.tpl.php:

if ($is_front) {include 'page-front.tpl.php'; return; }

Inne możliwości

Jest wiele innych sposób na zmianę wyglądu w zależności od typu segmentu, włączają w to uzależnienie wyglądu od kategorii, w której umieszczony został dany segment. Więcej informacji znajdziesz na poniższych stronach:

• Customising full page layouts and sections
• Customising node layouts
• Customising flexinode layouts – dla użytkowników modułu flexinode
• moduł taxonomy_theme, umożliwiający zmianę wyglądu w zależności od słownika lub terminu taksonomii, do którego należy segment

Zastępowanie funkcji theme_

Jeśli chciałbyś zastąpić (nadpisać) funkcję inną niż block, box, comment, node czy page, musisz poinformować o tym PHPTemplate.

By to uczynić, w katalogu swojej skórki musisz stworzyć plik template.php. Plik ten powinien rozpoczynać się znacznikiem <?php a kończyć znacznikiem ?>, a w jego treści winny się znajdować nadpisane funkcje. Decydują one o wykorzystaniu danego szablonu albo zmiennych.

Po pierwsze zacząć musisz od zlokalizowania funkcji, którą chcesz zastąpić. Ich lista znajduje się na stronie API documentation.

Przykładem takiego nadpisania funkcji jest zmiana sposobu wyświetlania odnośników nawigacyjnych na stronach książek, opisana w artykule Nawigacja w książkach po staremu.

Funkcje nadpisuje się poprzez stworzenie w pliku template.php nowej funkcji o takiej samej nazwie, jednak z tą różnicą, że przedrostek theme zamienia się na phptemplate. Na przykład funkcja odpowiadająca za wyświetlanie elementów list theme_item_list będzie teraz nosić nazwę phptemplate_item_list.

Najwygodniej jest po prostu skopiować oryginalną funkcję Drupala i zmodyfikować ją.