Strona główna / Wskazówki dotyczące tworzenia zawartości

Wskazówki dotyczące tworzenia zawartości

Formaty tekstów

Zwykły

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

Filtered HTML

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

  • Dozwolone znaczniki HTML: <a> <em> <strong> <cite> <blockquote> <code> <ul> <ol> <li> <dl> <dt> <dd>

    Ten serwis pozwala na wprowadzanie zawartości w formacie HTML. Nauka tego języka może wydawać się skomplikowana, ale korzystanie z ograniczonego zestawu znaczników jest bardzo proste. Poniższa tabela pokazuje przykłady użycia każdego ze znaczników jaki jest dozwolony w serwisie.

    Dla uzyskania dalszych informacji należy przejrzeć specyfikację HTML na stronach organizacji W3C lub użyć wybranej wyszukiwarki w celu odszukania stron, na których objaśniono zasady korzystania z języka HTML.

    Opis znacznikaWpisuje sięOtrzymuje się
    Znaczniki zwane kotwicami służą do tworzenia odnośników do innych stron.<a href="https://oeeir.wckp.lodz.pl">OEEiR</a>OEEiR
    Zaakcentowanie<em>Zaakcentowanie</em>Zaakcentowanie
    Strong<strong>Strong</strong>Strong
    Cytat<cite>Cytat</cite>Cytat
    Cytat blokowy<blockquote>Cytat blokowy</blockquote>
    Cytat blokowy
    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>
    1. Pierwszy element
    2. Drugi element
    Brak objaśnienia dla znacznika li.
    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
    Brak objaśnienia dla znacznika dt.
    Brak objaśnienia dla znacznika dd.

    Większość nietypowych znaków może być wprowadzona bezpośrednio bez żadnych problemów.

    Jeśli podczas wprowadzania treści pojawią się problemy należy wypróbować encje HTML. Przykładowa encja to &amp; dla znaku &. Pełna lista encji HTML jest umieszczona na tej stronie. Przykładowe znaki możliwe do uzyskania to:

    Opis znakuWpisuje sięOtrzymuje się
    Znak ampersand&amp;&
    Większy niż&gt;>
    Mniejszy niż&lt;<
    Cudzysłów&quot;"
  • Końce linii i akapitów rozpoznawane są automatycznie. Znacznik końca linii <br />, znacznik otwierający akapit <p> i znacznik zamykający akapit </p> są dopisywane automatycznie. Jeśli Drupal nie uwzględnił podziału na linie, należy po prostu dodać kilka nowych, pustych linii.

Full HTML

  • Adresy internetowe są automatycznie zamieniane w odnośniki, które można kliknąć.
  • Końce linii i akapitów rozpoznawane są automatycznie. Znacznik końca linii <br />, znacznik otwierający akapit <p> i znacznik zamykający akapit </p> są dopisywane automatycznie. Jeśli Drupal nie uwzględnił podziału na linie, należy po prostu dodać kilka nowych, pustych linii.

Plain text

  • Znaczniki HTML niedozwolone.
  • Adresy internetowe są automatycznie zamieniane w odnośniki, które można kliknąć.
  • Końce linii i akapitów rozpoznawane są automatycznie. Znacznik końca linii <br />, znacznik otwierający akapit <p> i znacznik zamykający akapit </p> są dopisywane automatycznie. Jeśli Drupal nie uwzględnił podziału na linie, należy po prostu dodać kilka nowych, pustych linii.

PHP code

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