Subversion-Projekte lars-tiefland.prado

<com:TContent ID="Main">

<h1>Membuat Halaman <tt>ReadPost</tt></h1>

<p>

Halaman <tt>ReadPost</tt> menampilkan rincian konten tulisan blog. Untuk para pengguna yang diotorisasi, akan ditampilkan tombol link yang membolehkan mereka untuk mengedit atau menghapus tulisan.

</p>

<p>

Kita membuat dua file <tt>protected/pages/posts/ReadPost.page</tt> dan <tt>protected/pages/posts/ReadPost.php</tt> masing-masing untuk menyimpan template halaman dan kelas halaman.

</p>

<h2>Membuat Template Halaman</h2>

<p>

Template halaman <tt>ReadPost</tt> sangat mirip dengan template <tt>PostRenderer</tt>, keduanya menyajikan konten tulisan. Perbedaannya adalah bahwa <tt>ReadPost</tt> perlu menampilkan dua tombol link ketika pengguna saat ini diotorisasi untuk mengedit atau menghapus tulisan.

</p>

<com:TTextHighlighter CssClass="source" Language="prado">

<com:TContent ID="Main">

<h2>

<com:TLiteral Text="<%= $this->Post->title %>" />

</h2>

<com:TControl Visible="<%= $this->canEdit() %>">

	<a href="&lt;%= $this->Service->constructUrl('posts.EditPost',array('id'=>$this->Post->post_id))%>">Edit</a> |

	<com:TLinkButton Text="Delete"

		OnClick="deletePost"

		Attributes.onclick="javascript:if(!confirm('Are you sure?')) return false;" />

</com:TControl>

<p>

Author:

&lt;com:TLiteral Text="&lt;%= $this->Post->author->username %>" /><br/>

Time:

<com:TLiteral Text="<%= date('m/d/Y h:m:sa', $this->Post->create_time) %>" />

</p>

<p>

<com:TLiteral Text="<%= $this->Post->content %>" />

</p>

</com:TContent>

</com:TTextHighlighter>

<p>

Banyak ekspresi PHP dipakai dalam template di atas. Ekspresi <tt>$this->Post</tt> merujuk ke properti yang didefinisikan dalam kelas halaman <tt>ReadPost</tt>. Ia mewakili obyek <tt>PostRecord</tt> yang terkait dengan tulisan yang saat ini sedang dilihat.

</p>

<com:InfoBox>

Meskipun sebagian besar kita menggunakan ekspresi dalam template, we do not overuse them. A major guideline in determining whether we should use an expression in a template is that <i>the expression should be a property or a simple presentational transformation of the property</i>. By following this guideline, we ensure content and presentation are well separated without losing sufficient flexibility.

</com:InfoBox>

<p>

Kita juga mencatatan dalam template di atas bahwa dua link tombol dikurung di dalam <tt>TControl</tt> yang penampakannya ditentukan oleh ekspresi <tt>$this->canEdit()</tt>. Untuk link tombol <tt>Delete</tt>, kita menggunakan dialog konfirmasi javascript untuk memperoleh konfirmasi pengguna saat ia mengklik untuk menghapus tulisan.

</p>

<com:InfoBox>

Seluruh kontrol PRADO mempunyai properti yang sangat berguna bernama <tt>Attributes</tt> yang dapat menerima pasangan nama-nilai bebas. Kebanyakan kontrol PRADO akan menyajikan pasangan nama-nilai dalam <tt>Attributes</tt> secara literal terkait tag HTML. Sebagai contoh, daam link tombol <tt>Delete</tt> di atas, kita mendefinisikan sebuah <tt>onclick</tt> yang disajikan sebagai atribut <tt>onclick</tt> yang menghasilkan tag <tt>&lt;a&gt;</tt>.

</com:InfoBox>

<h2>Membuat Kelas Halaman</h2>

<p>

Dari template halaman di atas, kita melihat bahwa kita perlu menulis kelas halaman yang mengimplementasikan pengendali event: <tt>deletePost()</tt> (ditempelkan ke tombol <tt>Delete</tt> dalam event <tt>OnClick</tt>). Kita juga perlu untuk mengambil data tulisan yang ditetapkan oleh ID tulisan melalui parameter GET <tt>id</tt>. </p>

<com:InfoBox>

Kita mengimplementasikan fitur penghapusan tulisan dalam halaman <tt>ReadPost</tt> karena ini sangat alami untuk melakukannya di sini. Ketika pengguna mengklik pada tombol <tt>Delete</tt>, dialog konfirmasi javascript akan muncul. Jika pengguna mengkonfirmasinya, penghapusan akan dibawa dalam respon terhadap event <tt>OnClick</tt> dari tombol <tt>Delete</tt>.

</com:InfoBox>

<com:TTextHighlighter CssClass="source" Language="php">

class ReadPost extends TPage

{

	private $_post;

	/**

	 * Mengambil data tulisan.

	 * Metode ini dipanggil oleh kerangka kerja saat inisialisasi halaman

	 * @param mixed event parameter

	 */

	public function onInit($param)

	{

		parent::onInit($param);

		// id tulisan dikirimkan via parameter GET 'id'

		$postID=(int)$this->Request['id'];

		// mengambil PostRecord dengan informasi pembuat terisi dalam

		$this->_post=PostRecord::finder()->withAuthor()->findByPk($postID);

		if($this->_post===null)  // jika id tulisan tidak benar

			throw new THttpException(500,'Unable to find the specified post.');

		// setel judul halaman sebagai judul tulisan

		$this->Title=$this->_post->title;

	}

	/**

	 * @return PostRecord yang saat ini sedang dilihat

	 */

	public function getPost()

	{

		return $this->_post;

	}

	/**

	 * Menghapus tulisan yang saat ini sedang dilihat

	 * Metode ini dipanggil saat pengguna mengklik tombol "Delete"

	 */

	public function deletePost($sender,$param)

	{

		// hanya pembuat atau administrator bisa menghapus tulisan

		if(!$this->canEdit())

			throw new THttpException('You are not allowed to perform this action.');

		// hapus dari DB

		$this->_post->delete();

		// alihkan browser ke homepage

		$this->Response->redirect($this->Service->DefaultPageUrl);

	}

	/**

	 * @return boolean apakah pengguna saat ini bisa mengedit/menghapus tulisan yg sedang dilihat

	 */

	public function canEdit()

	{

		// hanya pembuat atau administrator bisa mengedi/menghapus tulisan

		return $this->User->Name===$this->Post->author_id || $this->User->IsAdmin;

	}

}

</com:TTextHighlighter>

<h2>Pengujian</h2>

<p>

Untuk menguji halaman <tt>ReadPost</tt>, kunjungi URL <tt>http://hostname/blog/index.php</tt> dan klik pada judul tulisan. Browser kita akan menampilkan hasil berikut dengan URL <tt>http://hostname/blog/index.php?page=ReadPost&id=1</tt>. Catatan, jika kita tidak masuk, dua tombol link tidak akan terlihat.

</p>

<img src="<%~ output2.gif %>" class="output" />

</com:TContent>