Subversion-Projekte lars-tiefland.prado

<com:TContent ID="Main">

<h1>Création de la page nouveau message <tt>NewPost</tt></h1>

<p>
La page <tt>NewPost</tt> permet aux utilisateurs authentifiés de créer des nouveaux messages. Elle doit afficher un formulaire permettant la saisie des informations du message.
</p>


<p>
Parce que la page <tt>NewPost</tt> ne peut être vue que par les utilisateurs authentifiés, nous ajoutons un fichier de configuration de page <tt>config.xml</tt> dans le dossier <tt>protected/pages/posts</tt>. Ce fichier indique que seuls les utilisateurs authentifiés peuvent voir les pages <tt>NewPost</tt> et <tt>EditPost</tt> qui sera implémentée dans la section suivante. Tous les autres utilisateurs n'ont accès qu'aux pages <tt>ListPost</tt> et <tt>ReadPost</tt>.
</p>


<com:TTextHighlighter CssClass="source" Language="xml">
<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <authorization>
    <allow pages="NewPost,EditPost" users="@" />
    <allow pages="ListPost,ReadPost" />
    <deny users="*" />
  </authorization>
</configuration>
</com:TTextHighlighter>

<com:TipBox>
        Il est souvent utile de démarrer les règles d'autorisation par un <tt>&lt;deny users="*"&gt;</tt>, puis, de le compléter en donnant pas à pas les accès aux différentes pages à l'aides de règles <tt>allow</tt> supplémentaires
</com:TipBox>
<p>
Vu le nombre grandissant de pages, nous allons modifier le pied de page de notre <tt>gabarit principal</tt> pour qu'il inclus des liens vers : la page d'accueil, la page nouvel utilisateur <a href="?page=Day3.CreateNewUser">NewUser</a> (visible seulement par les administrateurs), et la page à venir : nouveau message <tt>NewPost</tt> (visible seulement par les utilisateurs authentifiés).
</p>

<com:TTextHighlighter CssClass="source" Language="prado">
<div id="footer">
&lt;com:THyperLink Text="Accueil"
        NavigateUrl="&lt;%= $this->Service->DefaultPageUrl %>" />

&lt;com:THyperLink Text="Nouveau message"
        NavigateUrl="&lt;%= $this->Service->constructUrl('posts.NewPost') %>"
        Visible="&lt;%= !$this->User->IsGuest %>" />

&lt;com:THyperLink Text="Nouvel utilisateur"
        NavigateUrl="&lt;%= $this->Service->constructUrl('users.NewUser') %>"
        Visible="&lt;%= $this->User->IsAdmin %>" />
...autres liens...
</div>
</com:TTextHighlighter>

<p>
Nous allons maintenant créer deux fichiers <tt>protected/pages/posts/NewPost.page</tt> et <tt>protected/pages/posts/NewPost.php</tt> contenant respectivement le gabarit et la classe de notre page.
</p>


<h2>Création du gabarit</h2>
<p>
Le gabarit de <tt>NewPost</tt> contient une référence à un <a href="http://www.pradosoft.com/demos/quickstart/?page=Controls.TextBox">TTextBox</a> pour saisir le titre de notre message et à un <a href="http://www.pradosoft.com/demos/quickstart/?page=Controls.HtmlArea">THtmlArea</a> pour saisir le contenu. Ce dernier est un éditeur WYSIWYG HTML. Pour contrôler les valeurs saisies, nous associons des validateurs aux contrôles précédents.
</p>


<com:TTextHighlighter CssClass="source" Language="prado">
&lt;%@ Title="Mon Blog - Nouveau Message" %>

&lt;com:TContent ID="Main">

<h1>Création nouveau message</h1>

<span>Titre:</span>
&lt;com:TRequiredFieldValidator
        ControlToValidate="TitleEdit"
        ErrorMessage="Veuillez indiquer un titre."
        Display="Dynamic" />
<br/>
&lt;com:TTextBox ID="TitleEdit" Columns="50" />

<br/>
<span>Message:</span>
&lt;com:TRequiredFieldValidator
        ControlToValidate="ContentEdit"
        ErrorMessage="Veuillez indiquer le contenu du message."
        Display="Dynamic" />
<br/>
&lt;com:THtmlArea ID="ContentEdit" />

<br/>
&lt;com:TButton Text="Ajouter" OnClick="createButtonClicked" />

&lt;/com:TContent>
</com:TTextHighlighter>


<h2>Création du fichier de classe</h2>
<p>
Dans le gabarit précédent, nous voyons que la fonction principale de notre page est l'appel de la méthode <tt>createButtonClicked()</tt> implémenté par un évènement <tt>OnClick</tt> attaché au bouton <tt>Ajouter</tt>.
</p>

<com:TTextHighlighter CssClass="source" Language="php">
class NewPost extends TPage
{
        /**
         * création d'un nouveau message si toutes les données sont valides.
         * cette méthode est appelée par l'évènement OnClick du bouton "Ajouter".
         * @param mixed sender : celui qui a généré l'évènement
         * @param mixed param : paramètres de l'évènement
         */
        public function createButtonClicked($sender,$param)
        {
                if($this->IsValid)  // tous les validateurs sont Ok ?
                {
                        // créer un nouvel objet PostRecord avec les données du formulaire
                        $postRecord=new PostRecord;
                        // utiliser SafeText à la place de Text évite les attaques XSS
                        $postRecord->title=$this->TitleEdit->SafeText;
                        $postRecord->content=$this->ContentEdit->SafeText;
                        $postRecord->author_id=$this->User->Name;
                        $postRecord->create_time=time();
                        $postRecord->status=0;

                        // enregistre les données dans la BDD par la méthode save de l'Active Record
                        $postRecord->save();

                        // redirige le navigateur vers le message nouvellement créé
                        $url=$this->Service->constructUrl('posts.ReadPost',array('id'=>$postRecord->post_id));
                        $this->Response->redirect($url);
                }
        }
}
</com:TTextHighlighter>

<h2>Test</h2>
<p>
Pour tester notre page <tt>NewPost</tt>, identifiez-vous auparavant et cliquez sur le lien <tt>Nouveau message</tt> dans le pied de page. Le navigateur affiche le résultat suivant avec comme URL <tt>http://hostname/blog/index.php?page=NewPost</tt>.
</p>

<com:InfoBox>
Quand vous visitez la page <tt>NewPost</tt> pour la première fois, vous pourrez remarquer qu'elle mettra plusieurs secondes avant de s'afficher. Ceci est dû au fait que PRADO a besoin de décompresser et de publier le code javascript et les images pour l'éditeur WYSIWYG du contrôle <tt>THtmlArea</tt>. Ceci est fait une fois pour toutes.
</com:InfoBox>

<com:TipBox>
Pour tester la fonctionnalité de pagination que nous avons mise en place dans la page <a href="?page=Day4.CreateListPost">ListPost</a>, nous pouvons créer cinq messages ou plus et regardez ce qu'il se passe sur la page d'accueil. Le contrôle <tt>TPager</tt> de la page <tt>ListPost</tt> affiche cinq éléments par page.
</com:TipBox>

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

</com:TContent>