+Ma première application PRADO
+
+
+Dans cette partie, nous allons vous guider afin de créer votre première application PRADO, la fameuse application "Hello World".
+
+
+"Hello World" est peut-être l'application PRADO la plus simple et interactive que vous pouvez créer. Cela affiche une page avec un bouton où il est affiché Click Me. Lorsque l'utilisateur clicke sur la bouton, il est affiché Hello World.
+
+
+Il y a plusieurs approches afin d'arriver au but ci-dessus. On peut envoyer la page au serveur, vérifier le contenu de la variable POST, et générer une nouvelle page avec le texte du bouton modifié. On peut également simplement utiliser du javascript afin de mettre à jour le libellé du bouton après l'évènement onclick.
+
+
+PRADO privilégie une programmation évènementielle basée sur des composants. Le bouton est représenté par un objet TButton. Celui-ci comprend le libellé du bouton en tant que propriété Text et associe l'évènement "click" avec un évènement serveur OnClick. Afin de répondre à l'action de l'utilisateur sur le click du bouton, il suffit simplement d'attacher une fonction à l'évènement OnClick du bouton. Dans cette fonction, la propriété Text est modifiée en "Hello World". Le diagramme suivant image la séquence ci-dessus :
+
+
+
+Notre application PRADO sera composée de trois fichiers, index.php, Home.page et Home.php, qui sont organisés de la façon suivante :
+
+
+où chaque répertoire est expliqué comme suit. Notez que la structure des répertoire peut être personnalisée. Par example, le dossier protected peut se trouver hors du répertoire Web public. Vous saurez comment faire à la suite de ce tutorial.
+
+
+- assets - dossier de stockage des fichiers publiés privés. Voir la partie "assets" pour plus de détails. Le processus du serveur Web doit avoir les droits d'écriture sur ce répertoire.
+- protected - répertoire de base de l'application comprenant les données et fichiers privés. Ce répertoire se doit de ne pas être accessible au public.
+- runtime - répertoire de stockage des fichiers d'éxecution de l'application, comme des données de cache, etc. Le processus du serveur Web doit avoir les droits d'écriture sur ce répertoire.
+- pages - répertoire de base des pages PRADO.
+
+
+
+
Astuce :Vous pouvez également utiliser le script
framework/prado-cli.php
+
en ligne de commande
+afin de créer la structure de votre projet PRADO. Par exemple, tapez la commande
+
php path/to/prado-cli.php -c helloworld dans le dossier où vous souhaitez créer votre projet
helloworld.
+
+Les trois fichiers dont nous avons besoin sont expliqués comme suit.
+
+
+- index.php - script d'entrée de notre application PRADO. Ce fichier est requis par toutes les applications PRADO et il s'agit du seul script accessible par les utilisateurs finaux. Le contenu du fichier index.php consiste principalement aux trois lignes suivantes :
+
+require_once('path/to/prado.php'); // include du script prado
+$application=new TApplication; // création de l'instance de l'application PRADO
+$application->run(); // démarrage de l'application
+
+
+- Home.page - template de la page par défaut retournée lorsque les utilisateurs ne spécifient pas de façon explicite la page demandée. Un template désigne la présentation des composants. Dans cet exemple, nous utiliserons deux composants,TForm et TButton, qui correspondent respectivement aux tags HTML <form> et <input>. Le fichier template contient le contenu suivant :
+
+
+
+ <com:TForm>
+ <com:TButton Text="Click me" OnClick="buttonClicked" />
+ </com:TForm>
+
+
+
+
+- Home.php - fichier de classe pour la page Home page. Celui-ci contient principalement la méthode répondant à l'évènement OnClick du bouton.
+
+class Home extends TPage
+{
+ public function buttonClicked($sender,$param)
+ {
+ // $sender se rapporte au composant bouton
+ $sender->Text="Hello World!";
+ }
+}
+
+
+
+
+
+L'application is maintenant prête et est accesible à l'adresse
+The application is now ready and can be accessed via: http://Web-server-address/helloworld/index.php, en supposant que helloworld soit directement sous la racine de votre serveur. Essayez de modifier le TButton de la page Home.page en TLinkButton et voyez ce qui se produit.
+
+
+Le code source complet de cette démonstration peut être téléchargé dans la release de PRADO. Vous pouvez également essayer la démonstration en ligne.
+
+
$Id: HelloWorld.page 1712 2007-02-18 18:55:32Z mickymax $
\ No newline at end of file
diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/Upgrading.page b/demos/quickstart/protected/pages/GettingStarted/fr/Upgrading.page
new file mode 100644
index 00000000..1a4e5690
--- /dev/null
+++ b/demos/quickstart/protected/pages/GettingStarted/fr/Upgrading.page
@@ -0,0 +1,63 @@
+
+
+Mise à jour à partir des versions v2.x et v1.x
+
+
+
+PRADO v3.0 n'est pas rétro-compatible avec les versions précédents de PRADO.
+
+
+La bonne nouvelle est que les propriétés et que les évènements de la plupart des contrôles restent identiques ainsi que la syntaxe des templates qui reste largement inchangée. Par conséquent, les connaissances des développeurs des anciennes versions restent applicables dans la v3.0.
+
+
+Nous résumons ci-dessous les changements les plus significatifs de la v3.0 afin d'aider les développeurs à migrer leurs applications v2.x et v1.x plus facilement, si besoin est.
+
+
Définition des composants
+
+La version 3.0 a complètement changé de besoin de fichiers de spécifications des composants. Il se fonde davantage sur des conventions pour définir les propriétés et les événements des composants . En particulié, une propriété est définit par la présence d'une méthode getter et/ou setter, tandis qu'un évènement est définit par l'existance d'une méthode on... .Les noms des propriétés et évènements dans la v3.0 sont tous les deux case-insensitive. Par conséquence, les développeurs sont désormais obligés de faire attention aux conversions de type lorsque la propriété d'un composant est définie. Par example, le code suivant est utilisé afin de définir la propriété Enabled propriétaire d'un TControl, qui est un type booléen,
+
+
+public function setEnabled($value)
+{
+ $value=TPropertyValue::ensureBoolean($value);
+ $this->setViewState('Enabled',$value,true);
+}
+
+
+où la fonction TPropertyValue::ensureBoolean() est utilisée afin de s'assurer que la variable est bien un booléen. Ceci car lorsque la propriété est configurée dans un template, une chaîne de caractère est passée au setter. Dans les versions précédentes, PRADO connaissait le type de chaque propriété des composants grâce aux fichiers de spécifications et se chargeait de la conversion de type pour vous.
+
+
+Contrôleur de l'application
+
+Le contrôleur de l'application implémente désormais une architecture modulaire. Les modules peuvent être ajoutés et configurés dans la configuration de l'application. Chaque module assure une fonction particulière et ils peuvent être coordonnés entre eux par le cycle de vie de l'application. Le concept des modules de la version 2.x a été replacé dans la v3.0 par les répertoires des pages. En conséquence, le format de configuration de l'application de la v3.0 est très différent des versions précédentes.
+
+
+Pages
+
+Les pages dans la version 3.0 sont organisés dans des répertoires qui peuvent être comparés au concept des modules de la v2.x. Les pages sont demandées selon leur structure. Par exemple, une URL index.php?page=Controls.Samples.Sample1 sera utilisée pour servir une page nommée Sample1 se trouvant dans le répertoire [BasePath]/Controls/Samples, où [BasePath] se réfère au répertoire racine des pages. Le nom d'un fichier template d'une page doit avoir comme extension .page, principalement pour différencier les templates des pages des templates des contrôles qui se termineront par l'extension .tpl.
+
+
+Relation des contrôles
+
+La version 3.0 redéfinit les relations entre les contrôles. En particulier, la relation parent-enfant se réfère désormais à la relation entre les contrôles et la présentation. Un nouveau nom de relation est introduit afin d'aider la gestion des identifiants des contrôles. Pour plus de détails, voir la section concernant les contrôles.
+
+
+Syntaxe des Templates
+
+
+La syntaxe des contrôles dans les templates de la v3.0 est très similaire à celle des versions précédentes avec beaucoup d'améliorations. Un changement important est au sujet des expression dans le databinding. Dans la v3.0, cela est fait de la façon suivante,
+
+<com:MyComponent PropertyName=<%# PHP expression %> .../>
+
+
+Les expressions et les tags d'états ont aussi changé. Pour plus de détails, voir la section concernant la définition des templates.
+
+
Syntaxe des Thèmes
+
+Les thèmes dans la v3.0 sont définis comme les contrôles des templates avec quelques restrictions.
+
+
+$Id: Upgrading.page 1712 2007-02-18 18:55:32Z mickymax $
\ No newline at end of file
--
cgit v1.2.3