Szkoła deweloperów Drupala. Część II: wpinanie się w formularz

Plan działania

Interesuje nas formularz dodawania artykułów. Znajdziesz go pod adresem http://localhost/drupal7/node/add/article. Przyjrzyjmy się mu przez chwilę.

Dwa pierwsze pola pozwalają podać nam tytuł i przypisać obrazek. Później tekst, tagi itd. Zauważ, że większość pól w formularzu posiada nagłówek oraz krótki opis, umieszczony pod spodem.

Każde pole posiada swój tytuł oraz krótki opis definiujący jego przeznaczenie.

Naszym zadaniem jest dodanie do oglądanego formularza pola typu select "Stopień zmęczenia" i wprowadzimy cztery wartości do wyboru: Wypoczęty, Niewypoczęty, Zmęczony oraz Wykończony. Pole będzie znajdowało się tuż pod "Tags" w osobnej sekcji "Stan psychofizyczny".

Teoria budowania formularzy w Drupalu

Na początku zapoznajmy się z teorią budowania formularzy w Drupalu. Formularze w Drupalu to zwykłe tablice (ang. array). Zawarte w nich informacje przekazywane są do funkcji drupal_get_form(), która na ich podstawie buduje odpowiedni kod HTML.

Sekcja dotycząca naszej wtyczki składać się będzie z pola typu fieldset i zawartego w nim selecta.

 $form['disposition'] = array(
 '#type' => 'fieldset',
'#title' => 'Stan psychofizyczny',
'#weight' => 10,
'feeling' => array(
'#type' => 'select',
'#title' => 'Stopień zmęczenia',
'#description' => 'Określ swój poziom zmęczenia 
na podstawie cztero-stopniowej skali',
'#default_value' => 'Wypoczęty',
'#options' => array(
'Wypoczęty' => 'Wypoczęty',
'Niewypoczęty' => 'Niewypoczęty',
'Zmęczony' => 'Zmęczony',
'Wykończony' => 'Wykończony'
)
)
);

Co oznacza powyższy kod? Zaczynamy od dodania elementu "disposition". Podajemy jego typ (#type) "fieldset" oraz tytuł (#title). Wewnątrz tworzymy nowe pole "feeling" - tym razem typu (#type) "select".

Tytuł i opis pola (#title, #description) to kolejno "Stopień zmęczenia" i "Określ swój poziom zmęczenia na podstawie cztero-stopniowej skali".