From 654a9cae43358c7eecf3b522e9876aa7815e2453 Mon Sep 17 00:00:00 2001 From: Fabio Bas Date: Mon, 7 Dec 2015 15:57:51 +0100 Subject: Move urls from pradosoft.com to github's project page; drop unmaintained quickstart tutorial translations --- .../protected/pages/Day1/CreateContact.page | 18 +- .../blog-tutorial/protected/pages/Day1/Setup.page | 12 +- .../protected/pages/Day1/ShareLayout.page | 20 +- .../protected/pages/Day1/fr/CreateContact.page | 202 -------------------- .../protected/pages/Day1/fr/Setup.page | 160 ---------------- .../protected/pages/Day1/fr/ShareLayout.page | 180 ------------------ .../protected/pages/Day1/fr/directories.gif | Bin 3611 -> 0 bytes .../protected/pages/Day1/fr/directories2.gif | Bin 4147 -> 0 bytes .../protected/pages/Day1/fr/directories3.gif | Bin 3531 -> 0 bytes .../protected/pages/Day1/fr/output.gif | Bin 13379 -> 0 bytes .../protected/pages/Day1/id/CreateContact.page | 203 --------------------- .../protected/pages/Day1/id/Setup.page | 163 ----------------- .../protected/pages/Day1/id/ShareLayout.page | 178 ------------------ .../protected/pages/Day1/id/directories.gif | Bin 3611 -> 0 bytes .../protected/pages/Day1/id/directories2.gif | Bin 4147 -> 0 bytes .../protected/pages/Day1/id/directories3.gif | Bin 3531 -> 0 bytes .../protected/pages/Day1/id/output.gif | Bin 13379 -> 0 bytes 17 files changed, 25 insertions(+), 1111 deletions(-) delete mode 100755 demos/blog-tutorial/protected/pages/Day1/fr/CreateContact.page delete mode 100755 demos/blog-tutorial/protected/pages/Day1/fr/Setup.page delete mode 100755 demos/blog-tutorial/protected/pages/Day1/fr/ShareLayout.page delete mode 100755 demos/blog-tutorial/protected/pages/Day1/fr/directories.gif delete mode 100755 demos/blog-tutorial/protected/pages/Day1/fr/directories2.gif delete mode 100755 demos/blog-tutorial/protected/pages/Day1/fr/directories3.gif delete mode 100755 demos/blog-tutorial/protected/pages/Day1/fr/output.gif delete mode 100755 demos/blog-tutorial/protected/pages/Day1/id/CreateContact.page delete mode 100755 demos/blog-tutorial/protected/pages/Day1/id/Setup.page delete mode 100755 demos/blog-tutorial/protected/pages/Day1/id/ShareLayout.page delete mode 100755 demos/blog-tutorial/protected/pages/Day1/id/directories.gif delete mode 100755 demos/blog-tutorial/protected/pages/Day1/id/directories2.gif delete mode 100755 demos/blog-tutorial/protected/pages/Day1/id/directories3.gif delete mode 100755 demos/blog-tutorial/protected/pages/Day1/id/output.gif (limited to 'demos/blog-tutorial/protected/pages/Day1') diff --git a/demos/blog-tutorial/protected/pages/Day1/CreateContact.page b/demos/blog-tutorial/protected/pages/Day1/CreateContact.page index 0d9fc026..ea7b9253 100755 --- a/demos/blog-tutorial/protected/pages/Day1/CreateContact.page +++ b/demos/blog-tutorial/protected/pages/Day1/CreateContact.page @@ -3,7 +3,7 @@

Creating Contact Page

-We have created a default page Home.page using the PRADO command line tool. The page is relatively static because it does not containt dynamic content. In this section, we will create an interactive page named Contact. +We have created a default page Home.page using the PRADO command line tool. The page is relatively static because it does not containt dynamic content. In this section, we will create an interactive page named Contact.

@@ -17,7 +17,7 @@ To create the Contact page, we need two files under the pages -A page must have either a template file (extension .page) or a class file, or both: +A page must have either a template file (extension .page) or a class file, or both:

Contact

-We use template to organize the presentational layout of the feedback form. In the template, we use textboxes to collect user's name, email and feedback. And we use validators to ensure that the user provides all these information before submitting the feedback form. The whole template is as follows, +We use template to organize the presentational layout of the feedback form. In the template, we use textboxes to collect user's name, email and feedback. And we use validators to ensure that the user provides all these information before submitting the feedback form. The whole template is as follows,

@@ -86,11 +86,11 @@ We use template to organize the presentational layout of the feedback form. In t

-As we can see that the template looks very similar to a normal HTML page. The main difference is that the template contains a few <com:> tags. Each <com:> tag refers to a control whose properties are being initialized with name-value pairs in the tag. For example, the <com:TButton> refers to the TButton control which displays a button that users can click on to submit the feedback form. For complete template syntax, please refer to the Quickstart Tutorial. +As we can see that the template looks very similar to a normal HTML page. The main difference is that the template contains a few <com:> tags. Each <com:> tag refers to a control whose properties are being initialized with name-value pairs in the tag. For example, the <com:TButton> refers to the TButton control which displays a button that users can click on to submit the feedback form. For complete template syntax, please refer to the Quickstart Tutorial.

-PRADO provides a control for every type of HTML input. For example, TTextBox displays a text input field, TDropDownList displays a combobox. Each control is a component that may be accessed in code as an object with configurable properties. +PRADO provides a control for every type of HTML input. For example, TTextBox displays a text input field, TDropDownList displays a combobox. Each control is a component that may be accessed in code as an object with configurable properties.

@@ -117,10 +117,10 @@ Below we summarize the controls that are used in the page template:

TForm displays an HTML form. Any input control must be enclosed within it. And most importantly, at most one TForm may appear in a page.
TTextBox displays a text box to collect user text input.
TRequiredFieldValidator ensures that the associated text box is not empty when the feedback is submitted.
TEmailAddressValidator ensures that the textbox contains a valid email address when the feedback is submitted.
TForm displays an HTML form. Any input control must be enclosed within it. And most importantly, at most one TForm may appear in a page.
TTextBox displays a text box to collect user text input.
TRequiredFieldValidator ensures that the associated text box is not empty when the feedback is submitted.
TEmailAddressValidator ensures that the textbox contains a valid email address when the feedback is submitted.

diff --git a/demos/blog-tutorial/protected/pages/Day1/Setup.page b/demos/blog-tutorial/protected/pages/Day1/Setup.page index 582d0399..b8df0705 100755 --- a/demos/blog-tutorial/protected/pages/Day1/Setup.page +++ b/demos/blog-tutorial/protected/pages/Day1/Setup.page @@ -3,7 +3,7 @@

Initial Setup

-We start by setting up the directories and the files that are required by most PRADO applications. We use the PRADO command line tool to achieve this goal. +We start by setting up the directories and the files that are required by most PRADO applications. We use the PRADO command line tool to achieve this goal.

@@ -11,7 +11,7 @@ Assume blog is the name of the directory to hold the whole blog system,

-Under the blog directory, we run the PRADO command line tool with the following command (replace path/to with the actual path to the PRADO framework installation): +Under the blog directory, we run the PRADO command line tool with the following command (replace path/to with the actual path to the PRADO framework installation):

php path/to/prado-cli.php -c . @@ -60,7 +60,7 @@ The name of the entry script does not need to be index.php. It can be a

Application Configuration

-The optional XML file application.xml contains the application configuration. Its main purpose is to customize in a configurable fashion the application instance created in the entry script. For example, we may enable the logging feature for our blog system with the help of application configuration. +The optional XML file application.xml contains the application configuration. Its main purpose is to customize in a configurable fashion the application instance created in the entry script. For example, we may enable the logging feature for our blog system with the help of application configuration.

@@ -71,11 +71,11 @@ The file application.xml we have now is nearly empty. In fact, we may s

Homepage

-The homepage (also called default page) Home.page is the only page created by the PRADO command line tool. It is the content in this file that shows up in the browser when visiting the URL http://hostname/blog/index.php. +The homepage (also called default page) Home.page is the only page created by the PRADO command line tool. It is the content in this file that shows up in the browser when visiting the URL http://hostname/blog/index.php.

-Content in the file Home.page uses the PRADO template format, which is mostly like HTML enhanced with a few PRADO-specific tags. For example, in Home.page we see the following pure HTML content: +Content in the file Home.page uses the PRADO template format, which is mostly like HTML enhanced with a few PRADO-specific tags. For example, in Home.page we see the following pure HTML content:

@@ -117,7 +117,7 @@ It is safe to remove files and directories under protected/runtime and

The `pages` Directory

-The pages directory is the root page directory holding all pages in a PRADO application. It bears an analogy to the htdocs directory for the Apache httpd Web server. +The pages directory is the root page directory holding all pages in a PRADO application. It bears an analogy to the htdocs directory for the Apache httpd Web server.

diff --git a/demos/blog-tutorial/protected/pages/Day1/ShareLayout.page b/demos/blog-tutorial/protected/pages/Day1/ShareLayout.page index 6115ef22..a8d4b5bd 100755 --- a/demos/blog-tutorial/protected/pages/Day1/ShareLayout.page +++ b/demos/blog-tutorial/protected/pages/Day1/ShareLayout.page @@ -3,11 +3,11 @@

Sharing Common Layout

-In this section, we will use the master/content feature of PRADO to share common layout among pages. Common layout refers to the area that is the same or largely the same for a set of pages. For example, in our blog system, all pages will share the same header, footer and side-bar containing shortcut links. A straightforward implementation is to repeat the common layout in every page. However, this approach is prone to error and is hard to maintain. The master/content feature allows us to treat the common layout as a control which centralizes the logic and presentation of the common layout for every page. +In this section, we will use the master/content feature of PRADO to share common layout among pages. Common layout refers to the area that is the same or largely the same for a set of pages. For example, in our blog system, all pages will share the same header, footer and side-bar containing shortcut links. A straightforward implementation is to repeat the common layout in every page. However, this approach is prone to error and is hard to maintain. The master/content feature allows us to treat the common layout as a control which centralizes the logic and presentation of the common layout for every page.

-It is also possible to share common layout via template inclusion, which is like PHP file inclusion. The drawback of template inclusion is that it is not self-contained and does not carry a class to contain the logic for the common layout. +It is also possible to share common layout via template inclusion, which is like PHP file inclusion. The drawback of template inclusion is that it is not self-contained and does not carry a class to contain the logic for the common layout. @@ -52,9 +52,9 @@ For the moment, MainLayout only contains a simple header and a footer, The above shows the content in the template file MainLayout.tpl. Three new tags are used:

<com:TContentPlaceHolder> represents TContentPlaceHolder control. It reserves the place in the template where content will be placed at. Here, the content comes from the pages who use this master control.
<com:THead> represents THead control which represents the <head> tag in HTML. It allows PRADO to manipulate the <head> tag as a component (e.g., setting page titles, adding custom CSS styles.)
<%= %> is an expression tag. It displays the evaluation result of the enclosed expression at the place where it appears.
<com:TContentPlaceHolder> represents TContentPlaceHolder control. It reserves the place in the template where content will be placed at. Here, the content comes from the pages who use this master control.
<com:THead> represents THead control which represents the <head> tag in HTML. It allows PRADO to manipulate the <head> tag as a component (e.g., setting page titles, adding custom CSS styles.)
<%= %> is an expression tag. It displays the evaluation result of the enclosed expression at the place where it appears.

@@ -69,7 +69,7 @@ class MainLayout extends TTemplateControl -The file extension name for page templates is .page, while for non-page templates it is .tpl. This is to differentiate pages from other controls. They both use the same template syntax. For pages, their class files are optional (default to TPage), while for non-page controls, their class files are mandatory. Similar to Java, the name of a class file must be the same as the class name. Be careful about the case-sensitivity on Linux/Unix systems. +The file extension name for page templates is .page, while for non-page templates it is .tpl. This is to differentiate pages from other controls. They both use the same template syntax. For pages, their class files are optional (default to TPage), while for non-page controls, their class files are mandatory. Similar to Java, the name of a class file must be the same as the class name. Be careful about the case-sensitivity on Linux/Unix systems. @@ -110,15 +110,15 @@ It is possible to have multiple TContentPlaceHolder's in a master templ

-Besides <com:TContent>, we also see another new tag <%@ %> in the above, which is called template control tag. It contains name-value pairs which are used to initialize the corresponding properties for the template owner, namely, the Contact page. +Besides <com:TContent>, we also see another new tag <%@ %> in the above, which is called template control tag. It contains name-value pairs which are used to initialize the corresponding properties for the template owner, namely, the Contact page.

-By setting MasterClass property as Application.layouts.MainLayout, we instruct the Contact page to use MainLayout as its master. Here, we are using the namespace format to refer to the MainLayout class. +By setting MasterClass property as Application.layouts.MainLayout, we instruct the Contact page to use MainLayout as its master. Here, we are using the namespace format to refer to the MainLayout class.

-Namespace format is widely used in PRADO programming. It is used together with path aliases. PRADO defines two path aliases: System refers to the framework directory of the PRADO installation, and Application refers to the protected directory. The namespace Application.layouts.MainLayout can thus be translated as protected/layouts/MainLayout which is exactly the file name (without the extension .php) for the MainLayout class. +Namespace format is widely used in PRADO programming. It is used together with path aliases. PRADO defines two path aliases: System refers to the framework directory of the PRADO installation, and Application refers to the protected directory. The namespace Application.layouts.MainLayout can thus be translated as protected/layouts/MainLayout which is exactly the file name (without the extension .php) for the MainLayout class. @@ -151,7 +151,7 @@ In the above, we specify MasterClass in the onPreInit() method

-We can also specify master in application configuration or page configuration. The following shows the updated application configuration for our blog system: +We can also specify master in application configuration or page configuration. The following shows the updated application configuration for our blog system:

diff --git a/demos/blog-tutorial/protected/pages/Day1/fr/CreateContact.page b/demos/blog-tutorial/protected/pages/Day1/fr/CreateContact.page deleted file mode 100755 index 0105f656..00000000 --- a/demos/blog-tutorial/protected/pages/Day1/fr/CreateContact.page +++ /dev/null @@ -1,202 +0,0 @@ - - -

Création de la page Contact

- -

-Nous avons créé une page par défaut Home.page en utilisant les outils en ligne de commande de PRADO. Cette page est relativement statique parce qu'elle ne contient que du contenu HTML. Dans cette session, nous allons créer une page dynamique dénommée Contact. -

- -

-Le but de cette page est de collecter les retours d'informations des utilisateurs Web concernant notre outil de blog. Pour atteindre ce but, nous envisageons d'utiliser un formulaire qui sera à remplir. Dans ce formulaire, nous demanderons le nom de l'utilisateur, son adresse email et son commentaire. Après que le formulaire ai été rempli et envoyé, un email avec le commentaire sera envoyé à l'administrateur. -

- -

-Pour créer la page Contact, nous avons besoin de 2 fichiers dans le dossier pages : le fichier de gabarit Contact.page et le fichier de classe PHP Contact.PHP. -

- -

- - -Une page doit avoir un fichier de gabarit (extension .page) ou un fichier de classe PHP, ou les deux : -

- -

Une page avec seulement un gabarit est généralement une page statique, comme la page d'accueil que nous avons déjà créée ;
Une page avec seulement un fichier de classe PHP produit le code HTML directement à partir de l'exécution du script. -
Une page avec un gabarit et un fichier de classe PHP combine les avantages des deux : un gabarit pour facilement organiser la présentation de la page et un fichier de classe PHP pour produire le contenu dynamique.

- - - -

Création de la page gabarit

- -

-Nous allons premièrement créer le fichier gabarit de la page Contact. -

- -

-Nous utilisons un fichier gabarit pour organiser la présentation de notre formulaire. Dans notre gabarit, nous utilisons des champs de saisie pour collecter le nom de l'utilisateur, son email et son commentaire. D'autre part, nous utilisons des validateurs pour nous assurer que l'utilisateur a bien fourni les éléments avant d'envoyer le formulaire. Le contenu complet du gabarit est le suivant, -

- - - -Mon Blog - Contact - -

Contact

Veuillez remplir le formulaire suivant pour me laisser vos impressions au sujet de mon blog. Merci !

- -<com:TForm> - -Votre nom: -<com:TRequiredFieldValidator ControlToValidate="Name" - ErrorMessage="Veuillez indiquer votre nom." - Display="Dynamic" /> -
-<com:TTextBox ID="Name" /> - -
-Votre email: -<com:TRequiredFieldValidator ControlToValidate="Email" - ErrorMessage="Veuillez indiquer votre email." - Display="Dynamic" /> -<com:TEmailAddressValidator ControlToValidate="Email" - ErrorMessage="Vous avez saisi un email invalide." - Display="Dynamic" /> -
-<com:TTextBox ID="Email" /> - -
-Commentaires: -<com:TRequiredFieldValidator ControlToValidate="Feedback" - ErrorMessage="Veuillez saisir un commentaire." - Display="Dynamic" /> -
-<com:TTextBox ID="Feedback" - TextMode="MultiLine" - Rows="10" - Columns="40" /> - -
-<com:TButton Text="Envoyer" OnClick="submitButtonClicked" /> - -</com:TForm> - - - - - -

-Comme vous pouvez le voir, un fichier gabarit ressemble énormément à un fichier HTML classique. La principale différence concerne le fichier gabarit qui contient quelques balises <com:>. Chaque balise <com:> fait référence à un contrôle dont les propriétés sont initialisées grâce aux paires nom-valeur de la balise. Par exemple, la balise <com:TButton> fait référence au contrôle TButton qui affiche un bouton permettant à l'utilisateur de soumettre le formulaire. Pour une syntaxe complète, veuillez vous référer au Tutoriel de démarrage rapide. - - -PRADO fournit un contrôle pour chaque type de balise HTML. Par exemple, TTextBox affiche un champ de saisie, TDropDownList affiche une liste déroulante. Chaque contrôle est un composant auquel on peut accéder par code et dont les propriétés sont modifiables. - - - -

-Avant le contrôle TTextBox, le gabarit utilise aussi plusieurs validateurs qui permettent de s'assurer que les données saisies sont bien conformes à notre attente. Par exemple, pour nous assurer que l'adresse email est valide, nous utilisons les deux validateurs suivants, -

- - -Your Email: -<com:TRequiredFieldValidator - ControlToValidate="Email" - ErrorMessage="Veuillez indiquer votre email." - Display="Dynamic" /> -<com:TEmailAddressValidator - ControlToValidate="Email" - ErrorMessage="Vous avez saisi un email invalide." - Display="Dynamic" /> -
-<com:TTextBox ID="Email" /> -
- - -

-Ci-dessous, un résumé des contrôles utilisés dans le gabarit : -

- -

TForm affiche un formulaire HTML. Chaque contrôle de saisie doit être au sein d'un TForm. Et le plus important, au plus un TForm peut apparaitre dans une page.
TTextBox affiche un champ de saisie utilisateur.
TRequiredFieldValidator s'assure que le contrôle de saisie associé n'est pas vide quand le formulaire est envoyé.
TEmailAddressValidator s'assure que le champ de saisie contient une adresse email valide quand le formulaire est envoyé.

- - -Ecrire des gabarits seulement avec un éditeur de texte peut être pénible et pas vraiment intuitif pour les designers. Pour faciliter ceci, PRADO inclus dans cette version, une extension pour Dreamweaver qui permet la complétion automatique des balises PRADO (ceci inclut le nom des balises, le nom des propriétés, le nom des évènements, etc.). - - -

Création du fichier de classe PHP

- -

-Nous allons maintenant créer le fichier de classe PHP Contact.PHP. Ce fichier est nécessaire parce que nous devons agir après la soumission du formulaire. -

- -

-Notez les lignes dans le fichier gabarit. Elles indiquent que lorsque l'utilisateur soumet le formulaire, la méthode submitButtonClicked() doit être appelé. Ici, OnClick est le nom de l'évènement et la méthode correspondante doit être défini dans le fichier de classe PHP. -

- - - <com:TButton Text="Submit" OnClick="submitButtonClicked" /> - - -

-Nous écrirons donc le fichier de classe suivant : -

- - -IsValid) // vérifie que les validations sont Ok - { - // récupère le nom de l'utilisateur, son email et son commentaire - $name = $this->Name->Text; - $email = $this->Email->Text; - $feedback = $this->Feedback->Text; - - // envoie un email à l'administrateur avec les informations - $this->mailFeedback($name, $email, $feedback); - } - } - - protected function mailFeedback($name, $email, $feedback) - { - // implémentation de l'envoi de l'email - } -} - - -

-Le code précédent est largement explicite. En fait, nous avons juste montré le principe d'un gestionnaire d'évènement. Dans le gestionnaire d'évènement submitButtonClicked(), nous récupérons les éléments saisies par l'utilisateur. Par exemple, $this->Name->Text retourne la valeur de la propriété Text du contrôle Name qui est un contrôle permettant la saisie du nom de l'utilisateur. -

- - -Le nom de la classe héritant de TPage doit être le même que le nom du fichier. C'est aussi une nécessité pour écrire n'importe quelle classe de composant PRADO. - - -

Test

- -

-Notre nouvelle page Contact peut être testée en naviguant à l'URL http://hostname/blog/index.PHP?page=Contact. Si vous cliquez sur le bouton "envoyer" sans avoir saisi de données, vous verrez apparaitre des messages d'erreurs à côté des champs de saisie. Si vous entrez toutes les informations nécessaires, la méthode mailFeedback() sera appelée. -

- -

-Une amélioration possible à notre page serait d'afficher un message de confirmation après que l'utilisateur ai envoyé le formulaire. Il serait aussi envisageable de rediriger le navigateur vers une adresse différente si toutes les informations ont été saisies correctement. Nous laisserons aux lecteurs la mise en place de ces fonctionnalités. -

- - -Chaque validateur représente une règle de validation. Un champ de saisie unique peut être associé à un ou plusieurs validateurs. Les validateurs effectuent les vérifications aussi bien du côté client que du côté serveur. Côté client (navigateur), les validations sont effectuées grâce à du javascript, côté serveur, elles sont effectuées en PHP. Les validations côté client peuvent être désactivées tandis que celles côté serveur ne peuvent l'être. Ceci permet de s'assurer que les règles de validation sont toujours appliquées. - - - \ No newline at end of file diff --git a/demos/blog-tutorial/protected/pages/Day1/fr/Setup.page b/demos/blog-tutorial/protected/pages/Day1/fr/Setup.page deleted file mode 100755 index 0be1c1f0..00000000 --- a/demos/blog-tutorial/protected/pages/Day1/fr/Setup.page +++ /dev/null @@ -1,160 +0,0 @@ - - -

Installation

- -

-Nous commencerons par la mise en place de la structure des dossiers et fichiers requis par la plupart des applications développées avec PRADO. Nous allons utiliser les outils en ligne de commande pour atteindre ce but. -

- -

Nous partons du principe que le nom du dossier qui contiendra l'application est blog et que l'URL qui permet d'accéder à ce dossier est : http://hostname/blog/ (remplacer hostname par le nom de votre serveur). -

- -

A l'intérieur du dossier blog, nous utilisons les outils en ligne de commande avec comme commande (remplacer path/to par le chemin d'installation du framework PRADO): -

- -php path/to/prado-cli.php -c . - - -

-L'utilisation de cette commande permet de créer la structure de dossier et fichiers suivante: -

- -

-Nous avons dorénavant, un squellette d'application PRADO accessible par l'URL http://hostname/blog/index.php et qui affiche une page contenant le message "Welcome to PRADO". -

- -

-Il est de notre intérêt d'en apprendre plus à propos des dossiers et fichiers que nous venons de créer. -

- -

Les fichiers initiaux

- -

Le script principal de l'application

- -

-Toutes les applications PRADO ont un point d'entrée, habituellement nommé index.php. Dans la plupart des cas, c'est le seul script qui est directement accessible par les utilisateurs. Cela réduit les risques que les utilisateurs puissent lancer des scripts serveur auquels ils ne devraient pas avoir accès. -

- -

-Le but principal de ce script est d'initialiser l'environnement PRADO et de gérer toutes les requêtes utilisateurs. Ce script contient habituellement les commandes PHP suivantes, -

- - -run(); - - - -Le nom du script ne doit pas être obligatoirement index.php. Il peut porter n'importe quel nom à partir du moment ou le serveur peut l'interpréter comme étant un script PHP5. Par exemple, sur certains hébergements mutualisés, le script devra porter le nom index.php5, ce qui permettra au serveur Web de le traiter correctement. - - -

Le fichier de configuration de l'application

-Le fichier optionnel XML application.xml contient la configuration de l'application. Son but principal est de permettre de configurer l'application qui sera créée par le script principal. Par exemple, nous pouvons activer le système de log pour notre application par le biais du fichier de configuration. -

- -

-Le fichier application.xml est pour le moment presque vide. De ce fait, nous pouvons le supprimer parce que l'application n'utilise pour le moment que des fonctionnalités de base. Au fur et à mesure que nous avancerons, nous ferons référence régulièrement au fichier application.xml et vous expliquerons comment configurer l'application. -

- - -

La page d'accueil

- -

-La page d'accueil Home.page (aussi dénommée page par défaut) est la seule page créée par les outils en ligne de commande de PRADO. C'est le contenu de ce fichier qui est affiché quand l'utilisateur navigue à l'adresse http://hostname/blog/index.php. -

- -

-Le contenu du fichier Home.page respecte le format de template qui pour la plupart du temps est du code HTML agrémenté de quelques balises spécifiques à PRADO. Par exemple, dans Home.page nous voyons du code HTML pur : -

- - - - - Welcome to PRADO - - -

Welcome to PRADO!

- - - - - -

Les dossiers initiaux

- -

Le dossier `protected`

- -

-Le dossier protected, aussi connu sous le nom chemin de base de l'application, est le dossier racine qui contient les pages, les gabarits, les fichiers de configuration, les données, etc. Le nom protected indique que ce dossier doit être masqué des personnes qui consultent le site, ceci parce que les fichiers dans ce dossier contiennent la plupart du temps des données sensibles. -

- -

-Les différents serveurs Web ont différents moyens de "protéger" un dossier. Pour Apache, le moyen le plus simple est de créer dans le dossier un fichier nommé .htaccess avec le contenu deny from all. -

- - -

Les dossiers `protected/runtime` et `assets`

- -

-Les dossiers protected/runtime et assets sont deux dossiers qui doivent avoir l'autorisation "en écriture" pour le serveur Web. Le dossier runtime contient des données sensibles (ie: fichier de configuration déjà analysé) générées à l'exécution de PRADO tandis que le dossier assets contient les ressources qui doivent être publiques (ie: les images, les fichiers javascript). -

- - -Il n'y a aucun souci à supprimer les dossiers et les fichiers contenus dans protected/runtime et assets. Il est recommandé aux développeurs de nettoyer ces dossiers lors d'une mise à jour de PRADO. - - - -

Le dossier `pages`

- -

-The pages directory is the root page directory holding all pages in a PRADO application. It bears an analogy to the htdocs directory for the Apache httpd Web server. -

- -

-Nous avons déjà vu comment accéder la page d'accueil. Pour accéder à n'importe quelle page situé dans le dossier pages, il faut utiliser l'URL suivante http://hostname/blog/index.php?page=chemin.vers.NomdelaPage. En fonction de cette URL, PRADO recherche une page dénommée NomdelaPage dans le dossier pages/chemin/vers. L'URL que nous avons utilisée précédemment pour accéder à la page d'accueil correspond à http://hostname/blog/index.php?page=Home. - - -

Personnalisation

- -

-Il est tout à fait possible de personnaliser le nom et l'emplacement des fichiers et dossiers décrit précédemment. -

- -

-Par exemple, pour améliorer la sécurité, certains pourraient désirer déplacer la totalité du dossier protected à un emplacement inaccessible par le Web. Pour faire cela, utilisez la commande PHP suivante pour initialiser l'instance de l'application PRADO dans le script principal : -

- - -$application = new TApplication( 'path/to/protected' ); - - -

-Pour changer l'emplacement du dossier racine des pages et le nom de la page d'accueil, il est possible de modifier le fichier de configuration application.xml de cette manière : -

- - - - - - - - - - - -

-En avançant dans l'apprentissage de PRADO, vous verrez que PRADO est très souple et qu'il est possible de personnaliser la plupart des comportements de base. Nous décrirons d'autres techniques au fur et à mesure de ce tutoriel. -

- - \ No newline at end of file diff --git a/demos/blog-tutorial/protected/pages/Day1/fr/ShareLayout.page b/demos/blog-tutorial/protected/pages/Day1/fr/ShareLayout.page deleted file mode 100755 index 539b8376..00000000 --- a/demos/blog-tutorial/protected/pages/Day1/fr/ShareLayout.page +++ /dev/null @@ -1,180 +0,0 @@ - - -

Partager les modèles de gabarit

- -

-Dans cette section, nous allons utiliser la fonctionnalité gabarit principal/contenu de PRADO pour partager une mise en page commune sur tout notre site. Les mises en page communes font référence aux parties qui sont identiques ou presque pour un ensemble de pages. Par exemple, dans notre outil de blog, toutes les pages partagent le même entête, pied de page et la même barre latérale contenant les liens. La solution la plus radicale est de répéter sur chaque page les parties communes. Par contre, cette approche est une source d'erreurs et difficile à maintenir. La fonctionnalité gabarit principal/contenu nous permets de traiter les parties communes comme un contrôle qui centralise la logique applicative et la présentation de chaque page. -

- - -Il est aussi possible de partager les parties communes grâce à l'inclusion de gabarits, un peu comme l'inclusion de fichier php. L'inconvénient de l'inclusion de gabarits est que l'on ne peut pas partager la logique applicative. - - - -

Création du gabarit principal

- -

-Nous allons maintenant créer le gabarit principal MainLayout qui représente les parties communes partagées par toutes nos pages. Le contrôle MainLayout est un contrôle de gabarit qui hérite de TTemplateControl. Il a besoin d'un fichier de gabarit MainLayout.tpl et d'un fichier de classe MainLayout.php situés dans le même dossier. Pour faciliter la maintenance, nous allons créer le nouveau dossier protected/layouts pour les accueillir. -

- -

-Pour le moment, MainLayout contient seulement un entête simple et un pied de page, comme décrit ci-après. Plus tard, nous ajouterons une barre latérale. Les lecteurs sont encouragés à ajouter des fonctionnalités. -

- - - -<com:THead /> - -<com:TForm> -

- - - -

-<com:TContentPlaceHolder ID="Main" /> -

- - - -

-</com:TForm> - - - - -

-Ci-dessus, le contenu du fichier de gabarit MainLayout.tpl. Trois nouvelles balises sont utilisées. -

- -

<com:TContentPlaceHolder> represente un contrôle TContentPlaceHolder. Il définit l'emplacement dans le gabarit où le contenu sera inséré. Dans notre cas, le contenu proviendra des pages qui utiliseront notre gabarit principal.
<com:THead> représente un contrôle THead qui correspond à la balise <head> d'un document HTML. Ceci permet à PRADO de manipuler la balise <head> comme un composant (ie: définir le titre de la page, ajouter des feuilles de styles CSS.)
<%= %> est une balise de configuration. Elle affiche le résultat de l'évaluation de l'expression à l'endroit où elle se situe.

- - -

-Le fichier de classe MainLayout.php est très simple : -

- - - - - -L'extension des fichiers de gabarit est .page, tandis que pour les gabarits autres que les pages c'est .tpl. Ceci permet de différencier les pages des autres contrôles. Les deux utilisent la même syntaxe de gabarit. Pour les pages, le fichier de classe est optionnel (par défaut hérite de TPage), tandis que pour les contrôles, les fichiers de classes sont obligatoires. Comme pour Java, le nom de la classe doit être le même que le nom du fichier de classe. Faites attention à la casse sur les systèmes Linux/Unix. - - -

Utilisation du gabarit principal

-Pour utiliser notre gabarit principal nouvellement créé, nous allons modifier nos fichiers Home.page et Contact.page. En particulier, nous devons supprimer les entêtes et pied de page parce que le gabarit principal a la responsabilité de les afficher ; par ailleurs, nous devons indiquer aux deux pages que leur gabarit principal est MainLayout. -

- -

-Ci-dessous, le contenu de Contact.page après les modifications : -

- - -<%@ MasterClass="Application.layouts.MainLayout" Title="Mon blog - Contact" %> - -<com:TContent ID="Main"> - -

Contact

Veuillez remplir le formulaire suivant pour me laisser vos impressions au sujet de mon blog. Merci !

- -...champs de saisie et validateurs pour le nom d'utilisateur... - -...champs de saisie et validateurs pour l'email... - -...champs de saisie et validateurs pour le commentaire... - -<com:TButton Text="Envoyer" OnClick="submitButtonClicked" /> - -</com:TContent> - - -

-Le contenu entre les balises <com:TContent> sera inséré dans l'emplacement réservé par <com:TContentPlaceHolder> dans le gabarit principal. -

- - -Il est possible d'avoir plusieurs TContentPlaceHolder dans un gabarit principal et plusieurs TContent dans un fichier de contenu. Ils sont associés par leurs propriétés ID. Il est aussi possible de définir un contenu comme étant le gabarit principal d'un autre contenu, ceci en plaçant une balise TContentPlaceHolder à l'endroit désiré. Ceci est appelé gabarits principaux imbriqués - - -

-A côté de la balise <com:TContent>, nous avons vu une nouvelle balise <%@ %>, qui est dénommé une balise de contrôle de gabarit. Elle contient des paires nom-valeur utilisées pour initialiser les propriétés correspondantes du propriétaire de gabarit, dans notre cas, la page Contact. -

- -

-En définissant la propriété MasterClass comme étant de type Application.layouts.MainLayout, nous avons indiqué à la page Contact d'utiliser MainLayout comme gabarit principal. Ici, nous avons utilisé un espace de noms pour nous référer à la classe MainLayout. -

- - -Les espaces de noms sont largement utilisés en programmation PRADO. Ils sont utilisés conjointement avec les alias de chemins. PRADO définit deux alias de chemins: System fait référence au dossier framework de l'installation PRADO, et Application fait référence au dossier protected. -L'espace de noms Application.layouts.MainLayout peut ainsi être traduit par protected/layouts/MainLayout ce qui est précisément le nom du fichier (sans l'extension .php) de la classe MainLayout. - - - -

Autres possibilités pour spécifier le gabarit principal

- -

-Il y a plusieurs alternatives pour spécifier le gabarit principal. -

- -

-Vous pouvez définir le gabarit principal comme ci-dessous pour pouvoir en changer dynamiquement. -

- - -MasterClass='Path.To.NewLayout'; - } - - // ... -} - - -

-Ci-dessus, nous indiquons d'utiliser le gabarit principal MasterClass dans la méthode onPreInit() qui est héritée de TPage. Cette méthode est appelé par PRADO juste après que l'instance de la page soit créée. Nous pouvons ainsi déclarer au moment où la page est requise quel gabarit principal utiliser. Par exemple, quand la page est requise par un utilisateur enregistré, nous pouvons utiliser le gabarit A, et le gabarit B si l'utilisateur qui demande la page est un invité. -

- -

-Nous pouvons aussi spécifier quel gabarit principal utiliser dans le fichier de configuration de l'application ou encore dans le fichier de configuration de la page. Ci-dessous, le fichier de configuration de l'application modifié pour notre blog. -

- - - - - - - - - - - - - - -

-En faisant cela, nous évitons de définir le gabarit principal dans chaque page. Si nous décidons d'utiliser un autre gabarit principal, il nous suffit de changer le fichier de configuration de l'application. Pour cette raison, dans notre blog, nous utiliserons cette approche. -

- - -Il y a un ordre qui permet de savoir quel fichier gabarit principal utiliser s'il est spécifié à plusieurs endroits. En particulier onPreInit() est prioritaire au fichier de configuration de la page qui est lui même prioritaire au fichier de configuration de l'application. Ainsi, si vous spécifiez MainLayout dans le fichier de configuration de l'application/page et que vous spécifiez SpecialLayout dans Contact.page, ce sera le dernier qui sera pris en compte. - - - \ No newline at end of file diff --git a/demos/blog-tutorial/protected/pages/Day1/fr/directories.gif b/demos/blog-tutorial/protected/pages/Day1/fr/directories.gif deleted file mode 100755 index 884e15bc..00000000 Binary files a/demos/blog-tutorial/protected/pages/Day1/fr/directories.gif and /dev/null differ diff --git a/demos/blog-tutorial/protected/pages/Day1/fr/directories2.gif b/demos/blog-tutorial/protected/pages/Day1/fr/directories2.gif deleted file mode 100755 index edf264d0..00000000 Binary files a/demos/blog-tutorial/protected/pages/Day1/fr/directories2.gif and /dev/null differ diff --git a/demos/blog-tutorial/protected/pages/Day1/fr/directories3.gif b/demos/blog-tutorial/protected/pages/Day1/fr/directories3.gif deleted file mode 100755 index 3451935f..00000000 Binary files a/demos/blog-tutorial/protected/pages/Day1/fr/directories3.gif and /dev/null differ diff --git a/demos/blog-tutorial/protected/pages/Day1/fr/output.gif b/demos/blog-tutorial/protected/pages/Day1/fr/output.gif deleted file mode 100755 index 9ad2bfb8..00000000 Binary files a/demos/blog-tutorial/protected/pages/Day1/fr/output.gif and /dev/null differ diff --git a/demos/blog-tutorial/protected/pages/Day1/id/CreateContact.page b/demos/blog-tutorial/protected/pages/Day1/id/CreateContact.page deleted file mode 100755 index caee30d0..00000000 --- a/demos/blog-tutorial/protected/pages/Day1/id/CreateContact.page +++ /dev/null @@ -1,203 +0,0 @@ - - -

Membuat Halaman Kontak

- -

-Kita telah membuat halaman standar Home.page menggunakan piranti baris perintah PRADO. Halaman relatif statis karena ia tidak berisi konten dinamis. Dalam bagian ini, kita akan membuat halaman interaktif bernama Contact. -

- -

-Kegunaan dari halaman Contact adalah untuk mengumpulkan umpan balik dari para pengguna sistem blog kita. Untuk melaksanakan tujuan ini, kita merencanakan untuk menyajikan para pengguna dengan sebuah formulir umpan balik yang harus diisi. Dalam formulir ini, kita akan mengharuskan para pengguna untuk menyediakan namanya, alamat email, dan konten umpan balik. Setelah formulir diisi dan dikirimkan, email yang berisi umpan balik akan dikirimkan ke administrator situs. -

- -

-Untuk membuat halaman Contact, kita memerluka dua file di bawah direktori pages: file template halaman Contact.page dan file kelas halaman Contact.php. -

- -

- - -Halaman harus berupa file template (berekstensi .page) atau file kelas, atau keduanya: -

- -

Hanya template-halaman yang biasanya berupa sebuah halaman sengan konten statis, seperti homepage yang sudah kita buat;
Hanya file kelas halaman yang menghasilkan konten murni berdasarkan eksekusi metode kelas;
Sebuah halaman dengan template dan kelasnya mengkombinasikan keunggulan keduanya: ia menggunakan template untuk memudahkan mengatur tata letak halaman dan menggunakan kelas untuk menyertakan logika yang menghasilkan konten dinamis.

- - - -

Membuat Template Halaman

- -

-Pertama kita membuat file template untuk halaman Contact. -

- -

-Kita menggunakan template untuk menghatur tata letak penyajian terhadap formulir umpan balik. Dalam template, kita menggunakan kotak teks untuk mengumpulkan nama pengguna, email dan umpan balik. Dan kita menggunakan validator guna memastikan bahwa pengguna menyediakan semua informasi ini sebelum mengirimkan formulir umpan balik. Seluruh template adalah sebagai berikut, -

- - - -My Blog - Contact - -

Contact

Please fill out the following form to let me know your feedback on my blog. Thanks!

- -<com:TForm> - -Your Name: -<com:TRequiredFieldValidator ControlToValidate="Name" - ErrorMessage="Please provide your name." - Display="Dynamic" /> -
-<com:TTextBox ID="Name" /> - -
-Your Email: -<com:TRequiredFieldValidator ControlToValidate="Email" - ErrorMessage="Please provide your email address." - Display="Dynamic" /> -<com:TEmailAddressValidator ControlToValidate="Email" - ErrorMessage="You entered an invalid email address." - Display="Dynamic" /> -
-<com:TTextBox ID="Email" /> - -
-Feedback: -<com:TRequiredFieldValidator ControlToValidate="Feedback" - ErrorMessage="Please provide your feedback." - Display="Dynamic" /> -
-<com:TTextBox ID="Feedback" - TextMode="MultiLine" - Rows="10" - Columns="40" /> - -
-<com:TButton Text="Submit" OnClick="submitButtonClicked" /> - -</com:TForm> - - - - - -

-Seperti kita lihat bahwa template terlihat sangat mirip dengan halaman HTML normal. Perbedaan utamanya adalah bahwa template berisi beberapa tag <com:>. Setap tag <com:> merujuk ke sebuah kontrol yang propertinya diinisialisasi dengan pasangan nama-nilai dalam tag. Sebagai contoh, <com:TButton> merujuk ke kontrol TButton guna menampilkan sebuah tombol di mana pengguna dapat di klik pengguna untuk mengirimkan formulir umpan balik. Untuk sintaks lengkap template, silahkan rujuk Tutorial Cepat. -

- - -PRADO menyediakan kontrol untuk setiap tipe input HTML. Sebagai contoh, TTextBox menampilkan field input teks, TDropDownList menampilkan kotak kombo. Setiap kontrol adalah sebuah komponen yang dapat diakses dalam kode sebagai obyek dengan properti yang bisa dikonfigurasi. - - -

-Selain kontrol TTextBox, template juga menggunakan banyak kontrol validator yang memastikan input pengguna memuaskan aturan validasi spesifik. Sebagai contoh, untuk memastikan alamat email sah yang dilengkapi, kita menggunakan dua validator untuk memvalidasi kotak teks "email", seperti ditampilkan dalam kode berikut: -

- - -Your Email: -<com:TRequiredFieldValidator - ControlToValidate="Email" - ErrorMessage="Please provide your email address." - Display="Dynamic" /> -<com:TEmailAddressValidator - ControlToValidate="Email" - ErrorMessage="You entered an invalid email address." - Display="Dynamic" /> -
-<com:TTextBox ID="Email" /> -
- - -

-Di bawah ini kita meringkas kontrol yang dipakai dalam template halaman: -

- -

TForm menampilkan sebuah formulir HTML. Setiap kontrol input harus dikurung di dalamnya. Dan yang terpenting, paling banyak satu TForm boleh muncul dalam sebuah halaman.
TTextBox menampilkan kotak teks untuk mengumpulkan input teks pengguna.
TRequiredFieldValidator memastikan bahwa kotak teks terkait tidak kosong saat umpan balik dikirimkan.
TEmailAddressValidator memastikan bahwa kotak teks berisi alamat email yang benar saat umpan balik dikirimkan.

- - -Menulis template dengan editor teks biasa dapat membosankan dan tidak intuitif untuk para desainer. Untuk memudahkan situasi ini, PRADO telah menyertakan dalam rilis ekstensi Adobe Dreamweaver yang mendukung pelengkapan-otomatis tag PRADO (misalnya menyertakan nama kontrol, nama properti, nama event, dll) dalam Dreamweaver. - - - -

Membuat Kelas Halaman

- -

-Sekarang kita membuat kelas halaman Contact.php. Alasan kita membutuhkan kelas halaman adalah karena kita perlu merespon umpan balik yang dikirimkan oleh pengguna. - -

-Perhatikan dalam template kita mempunyai baris berikut. Template secara esensi menyatakan bahwa saat pengguna mengklik tombol, ia harus memanggil metode submitButtonClicked(). Di sini OnClick adalah nama dari event yang diklik pengguna, dan metode harus didefinisikan dalam kelas halaman. -

- - - <com:TButton Text="Submit" OnClick="submitButtonClicked" /> - - -

-Selanjutnya kita menuliskan kelas halaman seperti berikut: -

- - -IsValid) // memeriksa apakan validasi input berhasil - { - // mendapatkan nama pengguna, email, umpan balik dari kotak teks - $name = $this->Name->Text; - $email = $this->Email->Text; - $feedback = $this->Feedback->Text; - - // mengirimkan email ke administrator dengan informasi di atas - $this->mailFeedback($name, $email, $feedback); - } - } - - protected function mailFeedback($name, $email, $feedback) - { - // implementasi pengiriman email umpan balik - } -} - - -

-Kode di atas sebagian besar cukup jelas. Kenyataannya, kami hanya menampilkan skema pemrograman pengendalian-event. Dalam pengendali event submitButtonClicked(), kita mengambil input pengguna. Sebagai contoh, $this->Name->Text mengembalikan nilai properti Text dari kontrol Name yang merupakan kotak teks yang mengumpulkan informasi nama pengguna. -

- - -Nama kelas halaman harus sama seperti nama file. Ini juga persyaratan untuk penulisan komponen kelas PRADO. - - - -

Pengujian

- -

-Contact yang baru saja kita buat dapat kita uji dengan URL http://hostname/blog/index.php?page=Contact. Jika kita mengklik pada tombol submit tanpa memasukan informasi apapun, kita akan melihat pesan kesalahan muncil di sebelah kotak teks terkait. Jika kita memasukan semua informasi yang diperlukan, metode mailFeedback() akan dipanggil. -

- -

-Peningkatan berikutnya terhadap halaman ini adalah untuk menampilkan beberapa pesan konfirmasi pada halaman setelah pengguna mengirimkan umpan balik. Dan kemungkinan, browser akan dialihkan ke halaman lain jika pengiriman berhasil. Kita akan membiarkan tugas ini bagi para pembaca kita. -

- - -Setiap validator mewakili aturan validasi. Satu kontrol input dapat dikaitkan dengan satu atau multipel validator. Validator melakukan validasi pada sisi klien dan sisi server. Pada sisi klien, yaitu browser, validasi dikerjakan dmenggunakan javascript; pada sisi server, validasi dikerjakan dengan menggunakan kode PHP. Validasi sisi-klien dapat dimatikan, sementara validasi sisi-server tidak bisa. Ini memastikan input pengguna selalu diperiksa oleh aturan validasi yang dietapkan. - - - \ No newline at end of file diff --git a/demos/blog-tutorial/protected/pages/Day1/id/Setup.page b/demos/blog-tutorial/protected/pages/Day1/id/Setup.page deleted file mode 100755 index 45ae8cf5..00000000 --- a/demos/blog-tutorial/protected/pages/Day1/id/Setup.page +++ /dev/null @@ -1,163 +0,0 @@ - - -

Persiapan Awal

- -

-Kita mulai dengan menyiapkan direktori dan file yang diperlukan oleh kebanyakan aplikasi PRADO. Kita menggunakan piranti baris perintah PRADO untuk melaksanakan tujuan ini. -

- -

-Anggap blog adalah nama direktori untuk menampung seluruh sistem blog, dan URL untuk mengakses folder ini adalah http://hostname/blog/ (ganti hostname dengan nama host sebenarnya). -

- -

-Di bawah direktori blog, kita menjalankan piranti baris perintah PRADO dengan perintah berikut (ganti path/ke dengan path sebenarnya ke instalasi kerangka kerja PRADO): -

- -php path/ke/prado-cli.php -c . - - -

-Menjalankan perintah di atas akan membuat direktori dan file berikut: -

- -

-Sekarang kita mempunyai kerangka aplikasi PRADO yang dapat diakses melalui URL http://hostname/blog/index.php yang menampilkan halaman Web dengan tulisan "Welcome to PRADO". -

- -

-Sangat bermanfaat mempelajari lebih rinci mengenai direktori dan file yang baru saja kita buat. -

- - -

File Awal

- -

Naskah Entri

- -

-Setiap aplikasi PRADO mempunyai naskah entri, sering dinamakan sebagai index.php. Dalam kebanyakan kasus, ia hanya naskah PHP yang secara langsung dapat diakses oleh pengguna Web. Ini mengurangi resiko terhadap ijin para pengguna Web untuk menjalankan naskah yang tidak diinginkan pada server. -

- -

-Kegunaan utama dari naskah entri adalah untuk mengawali aplikasi PRADO dan membiarkan ia menangani permintaan pengguna. Naskah entri biasanya berisi pernyataan PHP berikut, -

- - -run(); - - - -Nama naskah entri tidak harus index.php. Ia dapat berupa nama apa saja selama server Web dapat mengatakan bahwa naskah adalah naskah PHP 5. Sebagai contoh, pada beberapa lingkungan hosting berbagi, seseorang mungkin perlu untuk menamai naskah sebagai index.php5 agar ia bisa ditangani dengan benar oleh server the Web. - - -

Konfigurasi Aplikasi

-File XML opsional application.xml berisi konfigurasi aplikasi. Kegunaan utamanya adalah untuk mengkustomisasi dalam cara yang bisa mengkonfigurasi turunan aplikasi yang dibuat dalam naskah entri. Sevagai contoh, kita dapat menghidupkan fitur pencatatan untuk sistem blog kita dengan bantuan konfigurasi aplikasi. -

- -

-File application.xml yang sekarang kita miliki hampir kosong. Sebenarnya kita dapat menghapusnya dengan aman karena aplikasi pada saat ini hanya menggunakan seting standar PRADO. Seiring kita ke depan, kita akan merujuk kembali secara kontan dan menampilkan bagaimana untuk mengkonfigurasi aplikasi kita dalam application.xml. -

- - -

Homepage

- -

-Homepage (juga disebut halaman standar) Home.page adalah satu-satunya halaman yang dibuat oleh piranti baris perintah PRADO. Berisi konten dalam file ini yang muncul dalam browser saat mengunjungi URL http://hostname/blog/index.php. -

- -

-Konen dalam file Home.page menggunakan format template PRADO, yang kebanyakan mirip HTML dengan beberapa tag spesifik-PRADO. Sebagai contoh, dalam Home.page kita melihat konten murni HTML berikut: -

- - - - - Welcome to PRADO - - -

Welcome to PRADO!

- - - - - -

Direktori Awal

- -

Direktori `protected`

- -

-Direktori protected, juga dikenal sebagai path basis aplikasi, adalah direktori akar yang menampung halaman, template, konfigurasi, data, dll. Nama protected menunjukan bahwa direktori ini harus disembunyikan dari para pengguna Web, karena file di bawah direktori ini berisi data sensitif. -

- -

-Server Web berbeda mempunyai berbeda terhadap "melindungi" direktori. Untuk sever httpd Apache, cara termudah adalah untuk menempatkan file bernama .htaccess di bawah direktori dengan isi deny from all. -

- - -

Direktori `protected/runtime` dan `assets`

- -

-Direktori protected/runtime dan assets adalah dua direktori yang harus disetel bisa ditulisi oleh proses server Web. Direktori runtime menyimpan data sensitif (misalnya konfigurasi aplikasi yang diuraikan) yang dibuat saat menjalankan aplikasi PRADO, karena direktori assets menyimpan sumber daya yang dipublikasikan (misalnya file gambar, file javascript). -

- - -Aman untuk menghapus file dan direktori di bawah protected/runtime dan assets. Sebenarnya para pengembang direkomendasikan untuk melakukan pekerjaan pembersihan ini ketika mereka memutakhirkan instalasi PRADO. - - - -

Direktori `pages`

- -

-Direktori pages adalah akar direktori halaman yang menampung seluruh halaman dalam sebuah aplikasi PRADO. Ini mirip analogi terhadap direktori htdocs pada server Web httpd Apache. -

- -

-Kita sudah melihat bagaimana cara mengakses homepage. Untuk mengakses halaman yang ditempatkan di bawah pages, menggunakan URL http://hostname/blog/index.php?page=path.ke.NamaHalaman. Berdasarkan URL ini, PRADO akan melihar halaman bernama NamaHalaman di bawah direktori pages/path/ke. URL yang kita pakai untuk mengakses homepage sebelumnya sama dengan http://hostname/blog/index.php?page=Home. -

- - -

Kustomisasi

- -

-Dimungkinkan untuk mengkustomisasi nama dan lokasi terhadap file dan direktori yang dijelaskan di atas. -

- -

-Sebagai contoh, untuk meningkatkan keamanan, seseorang mungkin ingin memindahkan seluruh direktori protected ke tempat lain yang bukan folder Web. Untuk melakukannya, gunakan pernyataan PHP berikut untuk membuat turunan aplikasi dalam naskah entri: -

- - -$application = new TApplication( 'path/ke/protected' ); - - -

-Untuk membuat lokasi akar direktori halaman dan mengubah nama homepage, seseorang dapat menetapkannya dalam konfigurasi aplikasi application.xml sebagai berikut: -

- - - - - - - - - - -

-Setelah Anda mempelajari lebih jauh mengenai PRADO, Anda akan melihat bahwa PRADO adalah kerangka kerja fleksibel yang membolehkan Anda untuk mengkustomisasi hampir setiap aspeknya. Kami akan menjelaskan lebih lanjut teknik kustomisasi setelah kita melanjutkan tutorial kita. -

- - \ No newline at end of file diff --git a/demos/blog-tutorial/protected/pages/Day1/id/ShareLayout.page b/demos/blog-tutorial/protected/pages/Day1/id/ShareLayout.page deleted file mode 100755 index 0c40181b..00000000 --- a/demos/blog-tutorial/protected/pages/Day1/id/ShareLayout.page +++ /dev/null @@ -1,178 +0,0 @@ - - -

Berbagi Tata Letak Umum

- -

-Dalam bagian ini, kita akan menggunakan fitur master/content PRADO untuk membagi tata letak umum diantara halaman. Tata letak merujuk ke area yang sama atay sebagian besar sama untuk setelan halaman. Sebagai contoh, dalam sistem blog kita, semua halaman akan berbagi header yang sama, footer dan bar-samping yang berisi link jalan pintas. Implementasi langsung adalah untuk mengulang tata letak umum dalam setiap halaman. Akan tetapi, pendekatan ini adalah cenderung salah dan sulit untuk dipelihara. Fitur master/content membolehkan kita untuk menggunakan tata letak umum sebagai sebuah kontrol yang memusatkan logika dan penyajian tata letak umum untuk setiap halaman. -

- - -Ini juga memungkinkan untuk membagi tata letak umum melalui penyertaan template, yang mirip inklusi file PHP. Akibat dari penyertaan inklusi template ini adalah bahwa ia tidak berdiri sendiri dan tidak membawa kelas untuk mengisi logika untuk tata letak umum. - - - -

Membuat Kontrol Master

- -

-Sekarang kita membuat kontrol master MainLayout untuk mewakili tata letak umum berbagi dengan halaman blog kita. Kontrol MainLayout adalah kontrol template yang diperluas dari TTemplateControl. Ini mememerlukan file template MainLayout.tpl dan sebuah file kelas MainLayout.php yang ditempatkan di bawah direktori yang sama. Guna menjembatani pemeliharaan, kita membuat direktori baru protected/layouts untuk menampungnya. -

- -

-Untuk saat ini, MainLayout hanya berisi header dan footer sederhana, seperti ditampilkan berikut ini. Kedepan, kita akan menambahkan bar-samping. Para pembaca juga disarankan untuk meningkatkan tata letak dengan fitur yang lainnya. -

- - - -<com:THead /> - -<com:TForm> -

- - - -

-<com:TContentPlaceHolder ID="Main" /> -

- - - -

-</com:TForm> - - - - -

-Contoh di atas memperlihatkan konten dalam file template MainLayout.tpl. Tiga tag baru ini dipakai: -

<com:TContentPlaceHolder> mewakili kontrol TContentPlaceHolder. Ia menyimpan tempat dalam template di mana konten akan ditempatkan. Di sini, konten datang dari halaman yang menggunakan kontrol master ini.
<com:THead> mewakili kontrol THead yang menyajikan tag <head> dalam HTML. Ia membolehkan PRADO untuk memanipulasi tag <head> sebagai sebuah komponen (misalnya setelan judul halaman, menambahkan gaya CSS kustom.)
<%= %> adalah sebuah tag ekspresi. Ia menampilkan hasil evaluasi daru ekspresi yang dikurung di tempat di mana ia muncul.

- -

-File kelas MainLayout.php sangat sederhana: -

- - - - - -Nama ekstensi file untuk template halaman .page, sementara untuk template non-halaman yaitu .tpl. Ini untuk membedakan halaman dari kontrol lain. Keduanya menggunakan sintaks template yang sama. Untuk halaman, file kelasnya adalah opsional (standarnya TPage), sementara untuk kontrol non-halaman, file kelasnya adalah mandatori. Mirip dengan Java, nama file kelas harus sama seperti nama kelas. Harap berhati-hati mengenai sensitifitas-huruf pada sistem Linux/Unix. - - - -

Menggunakan Kontrol Master

-Untuk menggunakan kontrol master yang baru saja dibuat, kita akan memodifikasi Home.page dan Contact.page. Dalam keadaan tertentu, kita perlu untuk menghapus header dan footer darinya karena kontrol master akan bertanggung jawab untuk menampilkannya; dan kita perlu memberitahu dua halaman di mana mereka harus menggunakan MainLayout sebagai masternya. -

- -

-Kode berikut memperlihatkan konten dalam Contact.page setelah perubahan: -

- - -<%@ MasterClass="Application.layouts.MainLayout" Title="My Blog - Contact" %> - -<com:TContent ID="Main"> - -

Contact

Please fill out the following form to let me know your feedback on my blog. Thanks!

- -...kotak teks dan validator untuk nama pengguna... - -...kotak teks dan validator untuk emali pengguna... - -...kotak teks dan validator untuk konten umpan balik... - -<com:TButton Text="Submit" OnClick="submitButtonClicked" /> - -</com:TContent> - - -

-Konten yang dikurung di dalam tag <com:TContent> tag akan disisipkan ke dalam tempat yang disiapkan oleh <com:TContentPlaceHolder> pada template master. -

- - -Dimungkinkan untuk memiliki multipel TContentPlaceHolder dalam sebuah template master dan multipel TContent dakan tenokate konten. Mereka saling dipasangkan dengan nilai ID-nya. Juga dimungkinkan untuk membuat template konten menjadi master template konten lainnya dengan menempatkan TContentPlaceHolder di pembentuk. Ini disebut master berulang. - - -

-Selain <com:TContent>, kita juga melihat tag baru lain <%@ %> di atas, yang disebut tag kontrol template. Ia berisi pasangan nama-nilai yang dipakai untuk menginisialisasi properti terkait bagi pemilik template, yaitu, halaman Contact. -

- -

-Dengan menyetel properti MasterClass sebagai Application.layouts.MainLayout, kita menginstruksikan halaman Contact untuk menggunakan MainLayout sebagai masternya. Di sini, kita sedang menggunakan format namespace untuk merujuk ke kelas MainLayout. -

- - -Format namespace sebagian besar dipakai dalam pemrograman PRADO. Dipakai bersama dengan alias path. PRADO mendefinisikan dua alias path: System merujuk ke direktori framework pada instalasi PRADO, dan Application merujuk ke direktori protected. Namespace Application.layouts.MainLayout selanjutnya bisa diterjemahkan sebagai protected/layouts/MainLayout yang tepatnya adalah nama file (tanpa ekstensi .php) untuk kelas MainLayout. - - - -

Cara Alternatif Menetapkan Master

- -

-Ada beberapa cara tambahan untuk menetapkan kelas master untuk sebuah halaman. -

- -

-Kita dapat menetapkan master dalam kode seperti berikut untuk menghidupkan perubahan dinamis terhadap tata letak: -

- - -MasterClass='Path.To.NewLayout'; - } - - // ... -} - - -

-Dalam contoh di atas, kita menetapkan MasterClass dalam metode onPreInit() yang diturunkan dari TPage. Metode dipanggil oleh PRADO langsung setelah turunan halaman dibuat. Selanjutnya kita dapat menentukan secara dinamis tata letak yang dipakai saat halaman diminta. Sebagai contoh, ketika halaman yang diminta oleh pengguna terdaftar kita memakai tata letak A, dan tata letak B dipakai jika pengguna tamu yang meminta halaman. -

- -

-Kita juga dapat menetapkan master dalam konfigurasi aplikasi atau konfigurasi halaman. Kode berikut memperlihatkan konfigurasi aplikasi yang dimutakhirkan untuk sistem blog kita: -

- - - - - - - - - - - - - - -

-Dengan melakukan demikian, kita menghindari kesulitan pada penetapan master dalam setiap template halaman. Jika kita memutuskan untuk menggunakan master yang berbeda untuk halaman, kita hanya perlu mengubah konfigurasi aplikasi. Untuk alasan ini, dalam sistem blog kita, kita akan menggunakan pendekatan untuk menetapkan master. -

- - -Ada urutan yang menentukan master yang mana yang sebenarnya diterapkan ketika ia ditetapkan dalam tempat multipel. Dalam keadaan tertentu, onPreInit() diambil lebih dulu di atas template halaman di atas konfigurasi aplikasi/halaman. Oleh karena itu, jika kita menetapkan MainLayout dalam konfigurasi aplikasi/halaman dan kita menetapkan SpecialLayout dalam Contact.page, master yang efektif adalah yang terakhir. - - - \ No newline at end of file diff --git a/demos/blog-tutorial/protected/pages/Day1/id/directories.gif b/demos/blog-tutorial/protected/pages/Day1/id/directories.gif deleted file mode 100755 index 884e15bc..00000000 Binary files a/demos/blog-tutorial/protected/pages/Day1/id/directories.gif and /dev/null differ diff --git a/demos/blog-tutorial/protected/pages/Day1/id/directories2.gif b/demos/blog-tutorial/protected/pages/Day1/id/directories2.gif deleted file mode 100755 index edf264d0..00000000 Binary files a/demos/blog-tutorial/protected/pages/Day1/id/directories2.gif and /dev/null differ diff --git a/demos/blog-tutorial/protected/pages/Day1/id/directories3.gif b/demos/blog-tutorial/protected/pages/Day1/id/directories3.gif deleted file mode 100755 index 3451935f..00000000 Binary files a/demos/blog-tutorial/protected/pages/Day1/id/directories3.gif and /dev/null differ diff --git a/demos/blog-tutorial/protected/pages/Day1/id/output.gif b/demos/blog-tutorial/protected/pages/Day1/id/output.gif deleted file mode 100755 index 9ad2bfb8..00000000 Binary files a/demos/blog-tutorial/protected/pages/Day1/id/output.gif and /dev/null differ -- cgit v1.2.3

Creating Contact Page

Initial Setup

Application Configuration

Homepage

The pages Directory

Sharing Common Layout

Création de la page Contact

Création de la page gabarit

Contact

Création du fichier de classe PHP

Test

Installation

Les fichiers initiaux

Le script principal de l'application

Le fichier de configuration de l'application

La page d'accueil

Welcome to PRADO!

Les dossiers initiaux

Le dossier protected

Les dossiers protected/runtime et assets

Le dossier pages

Personnalisation

Partager les modèles de gabarit

Création du gabarit principal

Mon blog PRADO

Utilisation du gabarit principal

Contact

Autres possibilités pour spécifier le gabarit principal

Membuat Halaman Kontak

Membuat Template Halaman

Contact

Membuat Kelas Halaman

Pengujian

Persiapan Awal

File Awal

Naskah Entri

Konfigurasi Aplikasi

Homepage

Welcome to PRADO!

Direktori Awal

Direktori protected

Direktori protected/runtime dan assets

Direktori pages

Kustomisasi

Berbagi Tata Letak Umum

Membuat Kontrol Master

My PRADO Blog

Menggunakan Kontrol Master

Contact

Cara Alternatif Menetapkan Master

The `pages` Directory

Le dossier `protected`

Les dossiers `protected/runtime` et `assets`

Le dossier `pages`

Direktori `protected`

Direktori `protected/runtime` dan `assets`

Direktori `pages`