Filtered HTML

• Adresy internetowe są automatycznie zamieniane w odnośniki, które można kliknąć.

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

  • W celu dodania bloku zawierającego powitanie należy użyć poniższego kodu:

    print t('Witaj wędrowcze! Miło, że wpadłeś.');
    

  • Aby w powitaniu skorzystać z nazwy zalogowanego użytkownika należy rozwinąć kod do postaci:

    global $user;
    if ($user->uid) {
      print t('Witaj @name! Miło, że wpadłeś.', array('@name' => format_username($user)));
    }
    else {
      print t('Witaj wędrowcze! Miło, że wpadłeś.');
    }
    

  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.

• Shortcodes usage