Wskazówki dotyczące tworzenia zawartości

Dozwolone znaczniki HTML: <a> <cite> <code> <ul> <ol> <li> <dl> <dt> <dd>

Ta witryna pozwala na publikowanie zawartości w formacie HTML. Choć perspektywa nauki wszystkich znaczników HTML może onieśmielać, nauczenie się tylko kilku podstawowych jest bardzo proste. Tabela przedstawia przykładowe zastosowania dostępnych na tej stronie znaczników.

Więcej informacji uzyskać można na stronie specyfikacji HTML na serwerze W3C lub poprzez wyszukiwarkę internetową.

Opis znacznika	Wpisuje się	Otrzymuje się
Znaczniki zwane kotwicami służą do tworzenia odnośników do innych stron.	`<a href="http://www.spoldzielnie.org.pl">Agencja Rozwoju i Promocji Spółdzielczości ZLSP</a>`	Agencja Rozwoju i Promocji Spółdzielczości ZLSP
Zaakcentowanie	`<em>Zaakcentowanie</em>`	Zaakcentowanie
Silne zaakcentowanie	`<strong>Silne zaakcentowanie</strong>`	Silne zaakcentowanie
Cytat	`<cite>Cytat</cite>`	Cytat
Tekst zawierający kod programu	`<code>Kod</code>`	`Kod`
Lista punktorowana - znacznik <li> otwiera nowy element listy	`<ul> <li>Pierwszy element</li> <li>Drugi element</li> </ul>`	Pierwszy element Drugi element
Lista numerowana - znacznik <li> otwiera nowy element listy	`<ol> <li>Pierwszy element</li> <li>Drugi element</li> </ol>`	Pierwszy element Drugi element
Listy definicji są podobne do innych list HTML. Znacznik <dl> otwiera listę, <dt> otwiera termin definicji, a <dd> otwiera samą definicję.	`<dl> <dt>Pierwszy termin</dt> <dd>Pierwsza definicja</dd> <dt>Drugi termin</dt> <dd>Druga definicja</dd> </dl>`	Pierwszy termin Pierwsza definicja Drugi termin Druga definicja

Większość z bardziej egzotycznych znaków można wprowadzać bezpośrednio bez żadnych dodatkowych zabiegów.

W przypadku problemów należy wpisać odpowiednik znaku w postaci encji HTML. Na przykład zamiast cudzysłowu wpisać można ". Pełna lista niestandardowych znaków wraz z odpowiadającymi im encjami HTML znajduje się na stronie dotyczącej encji. Oto niektóre z dostępnych znaków:

Opis znaku	Wpisuje się	Otrzymuje się
Znak ampersand	`&`	&
Większy niż	`>`	>
Mniejszy niż	`<`	<
Cudzysłów	`"`	"

Końce linii i akapitów rozpoznawane są automatycznie. Znacznik końca linii , znacznik otwierający akapit i znacznik zamykający akapit są dopisywane automatycznie. Jeśli Drupal nie uwzględnił podziału na linie, należy po prostu dodać kilka nowych, pustych linii.
Korzystanie z kodu PHP
Napisany przez użytkownika kod PHP może być umieszczony wewnątrz niektórych elementów witryny, takich jak wpisy czy bloki. Daje to duże możliwości, jednak w niepowołanych rękach staje się niebezpieczne. Nawet niewielki błąd w kodzie może zaburzyć pracę witryny.
Należy unikać umieszczania kodu PHP we wpisach, jeśli nie posiada się wiedzy na temat języka PHP, SQL czy Drupala. Eksperymentowanie z PHP może doprowadzić do uszkodzenia bazy danych, zatrzymać pracę witryny lub narazić ją na ataki ze strony złośliwych użytkowników.
Uwagi:
- Przed zachowaniem wpisu należy zawsze gruntownie sprawdzać każdą linię kodu w poszukiwaniu błędów.
- Każda instrukcja musi być zakończona średnikiem.
- Zmienne globalne użyte w kodzie zachowują swe wartości po uruchomieniu skryptu.
- Dyrektywa register_globals jest wyłączona. Do tworzenia formularzy służy własne API Drupala (tzw. "Form API").
- Do zaprezentowania zawartości służą instrukcje print lub return.
- Przed uruchomieniem kodu w witrynie warto stworzyć testowy skrypt i przykładową bazę danych.
- Warto rozważyć umieszczenie kodu w nowym module witryny lub wewnątrz pliku template.php.
- Uruchamianie kodu PHP jest możliwe tylko, jeśli włączony jest moduł filtra PHP. Gdy moduł ten zostanie wyłączony lub usunięty, bloki i wpisy, w których zawarto kod, będą go wyświetlać zamiast uruchamiać.
Przykładowe zastosowanie: stworzenie bloku z powitaniem dla odwiedzających.
- Dodaj blok zatytułowany "Witamy". Format danych powinien być ustawiony na "Kod PHP". W treści bloku należy wpisać:
```
print t('Witamy! Dziękujemy, że tracisz swój czas na czytanie tego bezsensownego powitania!');
```
- Kod wyświetlający nazwę konta uwierzytelnionego użytkownika wygląda tak:
```
global $user;
if ($user->uid) {
  print t('Witamy, @name! Dziękujemy, że tracisz swój czas na czytanie tego bezsensownego powitania!', array('@name' => $user->name));
}
else {
  print t('Witamy! Dziękujemy, że tracisz swój czas na czytanie tego bezsensownego powitania!');
}
```
W witrynie drupal.org znajdują się przykładowe fragmenty kodu PHP. Kod PHP dla różnych zastosowań można też znaleźć wśród porad zamieszczonych w polskiej witrynie drupal.org.pl.
Adresy internetowe są automatycznie zamieniane w odnośniki, które można kliknąć.