Listy / Wprowadzenie do OPT cz. 1 / Biblioteki / PHP / Artykuły / Wortal / Home

Listy

Open Power Template to nie tylko prymitywne umieszczanie danych w szablonie. Biblioteka udostępnia szereg narzędzi pozwalających na zaawansowaną manipulację informacjami. W praktyce po stronie szablonu mamy do swej dyspozycji całkiem niezły język programowania, z obsługą zmiennych, wyrażeń, pętli oraz instrukcji warunkowych. Jednak należy to traktować bardziej jako ciekawostkę, ponieważ wraz z nim dostajemy również instrukcje pozwalające choćby częściowo o programowaniu zapomnieć, które zautomatyzują wiele czynności. Jedną z nich są sekcje. Służą one do generowania wszelkiego rodzaju list za pomocą niezwykle prostej składni. Poniższy przykład pokazuje, jak stworzyć listę albumów muzycznych.

Zaczynamy od szablonu. Stworzenie sekcji polega po prostu na określeniu wyglądu pojedynczego elementu listy - resztą zajmuje się OPT:

<html>
<head>
  <title>Open Power Template: albumy muzyczne</title>
</head>
<body>
	<h3>Moja lista albumów</h3>
	
	<ul>
	{section=album}
	<li>{$album.tytul} - {$album.zespol} ({$album.rok})</li>	
	{/section}
	</ul>
</body>
</html>

Nasz element ograniczony jest znacznikami {section=album} (tu określamy też nazwę sekcji - musi być ona unikalna, abyśmy mogli podpiąć do niej później dane listy) oraz zamykającym {/section}. Aby wstawić w jakimś miejscu dane elementu, używamy specjalnego bloku sekcji, np. {$album.tytul}. Jak widać, zbudowany jest on z dwóch części oddzielonych kropką. Pierwsza to nazwa naszej sekcji, druga to nazwa jednego z bloków niesionych przez dany element.

Przejdźmy teraz do skryptu. Zaczniemy od utworzenia tabelki w bazie danych:

CREATE TABLE `albumy` (
`id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY ,
`tytul` VARCHAR( 50 ) NOT NULL ,
`zespol` VARCHAR( 50 ) NOT NULL ,
`rok` SMALLINT NOT NULL 
) ENGINE = MYISAM;
 
INSERT INTO `albumy` VALUES (1, 'Nightflight to Venus', 'Boney M.', 1978);
INSERT INTO `albumy` VALUES (2, 'Take The Heat Off Me', 'Boney M.', 1976);
INSERT INTO `albumy` VALUES (3, 'Spirits Having Flown', 'Bee Gees', 1979);
INSERT INTO `albumy` VALUES (4, 'Saturday Night Fever', 'Bee Gees', 1977);

Kolejnym krokiem jest napisanie samego skryptu. Dane dla listy dostarczane są w postaci tablicy zawierającej poszczególne jej elementy. Są one również tablicami zawierającymi pojedyncze informacje, np. tytul czy zespol. Tak więc takie coś musimy generować.

<?php
	define('OPT_DIR', './lib/');
	require('./lib/opt.class.php');
 
	try
	{	
		$tpl = new optClass;
		$tpl -> root = './templates/';
		$tpl -> compile = './templates_c/';
		$tpl -> gzipCompression = true;
		$tpl -> httpHeaders(OPT_HTML);
		
		$pdo = new PDO('mysql:host=localhost;port=3305;dbname=test',
		 'root', 'root'); // 1
		
		$stmt = $pdo -> query('SELECT * FROM albumy ORDER BY rok');
		$result = array(); // 2
		
		while($row = $stmt -> fetch())
		{
			$result[] = array( // 3
				'tytul' => $row['tytul'],
				'zespol' => $row['zespol'],
				'rok' => $row['rok']			
			);
		}
		$stmt -> closeCursor();
		
		$tpl -> assign('album', $result); // 4	
		
		$tpl -> parse('szablon4.tpl'); 
	}
	catch(optException $exception)
	{ 
		optErrorHandler($exception); 
	}
?>

Jego działanie jest następujące:

Najpierw łączymy się z MySQL-em za pomocą biblioteki PHP Data Objects.
Przygotowujemy pustą tablicę.
Zapisujemy tablicę z danymi o każdym albumie do naszego zbiornika na elementy: $result jako kolejny jego element.
Korzystamy z metody assign(), aby przypisać wygenerowaną tablicę do naszej sekcji album.

To wszystko. Po uruchomieniu tego skryptu zobaczysz, że OPT wygenerował nam ładną listę albumów. Pójdźmy jednak dalej od strony szablonu, aby przekonać się nieco o możliwościach biblioteki. Na początek zastanówmy się, co będzie, jeśli w bazie albumów niczego nie będzie. Odpowiedź jest prosta: dostaniemy w kodzie puste znaczniki <ul></ul> i nic więcej. Istnieje kilka sposobów na powiadomienie internauty o kłopocie - co ważniejsze, żaden z nich nie wymaga zmieniania czegokolwiek w kodzie PHP! Możemy sprawdzić instrukcją warunkową, czy sekcja zawiera jakieś elementy, a jeśli nie, powiadomić go o tym:

<html>
<head>
  <title>Open Power Template: albumy muzyczne</title>
</head>
<body>
	<h3>Moja lista albumów</h3>
	
	{if count($album) > 0}
	<ul>
	{section=album}
	<li>{$album.tytul} - {$album.zespol} ({$album.rok})</li>
	{/section}
	</ul>
	{else}
	<p>Brak albumów!</p>
	{/if}
</body>
</html>

Jednak w tym przypadku zbliżamy się za bardzo do programowania. OPT udostępnia lepszy oraz nieco szybszy sposób polegający na rozbudowaniu sekcji o dodatkowe znaczniki: {show} oraz {/show}. Jeżeli zdecydujemy się na ich zastosowanie, to właśnie w nich ustalamy parametry sekcji, natomiast znacznik {section} pozostaje pusty:

<html>
<head>
  <title>Open Power Template: albumy muzyczne</title>
</head>
<body>
	<h3>Moja lista albumów</h3>
	
	{show=album}
		<ul>
		{section}
		<li>{$album.tytul} - {$album.zespol} ({$album.rok})</li>
		{/section}
		</ul>
	{showelse}
		<p>Brak albumów!</p>
	{/show}
</body>
</html>

Teraz OPT ma jasno określone: to jest otoczenie listy będące jej integralną częścią; to jest wygląd pojedynczego elementu listy; to jest tekst alternatywny, jeśli lista nie posiada elementów.

Sekcja umożliwia wykonywanie prostych manipulacji na danych. Spróbujmy teraz wyświetlić ją w odwrotnej kolejności (nadal nie ruszając nic w kodzie PHP!) oraz jakoś wyróżnić pierwszy element:

<html>
<head>
  <title>Open Power Template: albumy muzyczne</title>
</head>
<body>
	<h3>Moja lista albumów</h3>
	
	{show=album; reversed}
		<ul>
		{section}
		{if $opt.section.album.first}
		<li><strong>{$album.tytul}</strong> - 
			{$album.zespol} ({$album.rok})</li>
		{else}
		<li>{$album.tytul} - {$album.zespol} ({$album.rok})</li>
		{/if}
		{/section}
		</ul>
	{showelse}
		<p>Brak albumów!</p>
	{/show}
</body>
</html>

Jeśli chodzi o odwracanie kolejności, wystarczy w parametrach sekcji dopisać słowo "reversed". Wyróżnienie pierwszego elementu to sprawa nieco bardziej skomplikowana. Musimy skorzystać koniecznie z pomocy instrukcji warunkowej, lecz OPT w tym momencie pomaga automatycznie stworzyć odpowiedni warunek. Blok specjalny $opt daje dostęp do różnych ciekawych danych - w tym wypadku w postaci $opt.section.album.first zwraca on true, jeżeli aktualnie przetwarzany element sekcji album jest jej pierwszym elementem. Możemy z tego skorzystać do zdefiniowania dla niego alternatywnego wyświetlania.

Kategorie

Spis treści

O autorze

Podobne Artykuły

Nowe artykuły

Wprowadzenie do OPT cz. 1

Listy