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">
&lt;com:TContent ID="Main">

<h2>
&lt;com:TLiteral Text="&lt;%= $this->Post->title %>" />
</h2>

&lt;com:TControl Visible="&lt;%= $this->canEdit() %>">
        <a href="&lt;%= $this->Service->constructUrl('posts.EditPost',array('id'=>$this->Post->post_id))%>">Edit</a> |
        &lt;com:TLinkButton Text="Delete"
                OnClick="deletePost"
                Attributes.onclick="javascript:if(!confirm('Are you sure?')) return false;" />
&lt;/com:TControl>

<p>
Author:
&lt;com:TLiteral Text="&lt;%= $this->Post->author->username %>" /><br/>
Time:
&lt;com:TLiteral Text="&lt;%= date('m/d/Y h:m:sa', $this->Post->create_time) %>" />
</p>

<p>
&lt;com:TLiteral Text="&lt;%= $this->Post->content %>" />
</p>

&lt;/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>