W skrócie display.php zawiera informacje o formatowaniu dla widgetów. Można zdefiniować wygląd dla poszczególnych widgetów również ze względu na miejsce umieszczenia (nazwa sidebar).

Oto przykładowy plik, który sformatuje widget „search” (jest to slug widgetu) w sidebarze o nazwie „right”:

<?php
$display['search']['right']['title'] = 'Szukaj';
$display['search']['right']['tylko_content'] = false;
$display['search']['right']['szablon'] = '';
?>

Omówienie:

Każda pozycja zaczyna się od „$display”.

W następnej pozycji podajemy którego widgetu formatowanie dotyczy, w naszym przypadku jest to „search” (również w nawiasach kwadratowych).

Następnie podajemy pozycję (nazwę sidebar) w nawiasie kwadratowym. W naszym przypadku jest to sidebar o nazwie „right”.

Następna pozycja to już nazwa danego elementu (w nawiasie kwadratowym). Nazwy tych elementów (jak i opisy) znajdziesz zawsze w ustawieniach danego widgetu w panelu CMS (nazwy podane są przy odpowiednim polu w nawiasach kwadratowych):

Po znaku równości podajemy wartość danego pola.

A co w przypadku, gdy chcemy zdefiniować formatowanie danego widgetu bez względu na jego położenie (czyli dla wszystkich sidebarów)? Wystarczy, że w miejsce nazwy sidebaru podamy dużymi literami „ALL”. Plik display.php dla wyszukiwarki bez względu na położenie widgetu będzie wyglądał tak:

<?php
$display['search']['ALL']['title'] = 'Szukaj';
$display['search']['ALL']['tylko_content'] = false;
$display['search']['ALL']['szablon'] = '';
?>

A co, jeśli chcemy zdefiniować formatowanie dla jednego rodzaju widgetu, ale osobne dla poszczególnych sidebarów (miejsc)? W takim przypadku wystarczy zamieścić w pliku display.php więcej definicji:

<?php
//ustawienia dla widgetu wyszukiwarki w sidebarze "right"
$display['search']['right']['title'] = 'Szukaj';
$display['search']['right']['tylko_content'] = false;
$display['search']['right']['szablon'] = '';
 
//ustawienia dla widgetu wyszukiwarki we wszystkich sidebarach z wyjątkiem "right", który został zdefiniowany w pliku
$display['search']['ALL']['title'] = '';
$display['search']['ALL']['tylko_content'] = true;
$display['search']['ALL']['szablon'] = '';
?>

Oczywiście schemat powyższy można powielić i zdefiniować na przykład osobny wygląd dla sidebar „right” i np. „left”, a dla pozostałych jeszcze inne:

<?php
$display['right']['search']['title'] = 'Szukaj';
$display['right']['search']['tylko_content'] = false;
$display['right']['search']['szablon'] = '';
 
$display['ALL']['search']['title'] = '';
$display['ALL']['search']['tylko_content'] = true;
$display['ALL']['search']['szablon'] = '';
 
$display['left']['search']['title'] = 'Wyszukaj';
$display['left']['search']['tylko_content'] = false;
$display['left']['search']['szablon'] = '<form method="POST" action="_STRONA_GLOWNA_"><input type="text" name="q" placeholder="wpisz frazę..."><button type="submit>OK</button></form>';
?>

W praktyce plik display.php może zawierać definicje dla różnych widgetów i różnych sidebarów.

Wystarczy zaznaczyć opcję w danym widgecie:

UWAGA! Elementy, które nie zostały podane w tablicy $display można nadal zmieniać w panelu (opcje widgetu) mimo braku zaznaczenia „Nie korzystaj z formatowania theme”.