diff options
Diffstat (limited to 'demos/quickstart/protected')
288 files changed, 104 insertions, 17151 deletions
diff --git a/demos/quickstart/protected/controls/Comments/CommentBlock.tpl b/demos/quickstart/protected/controls/Comments/CommentBlock.tpl index 56f5cb7a..c3ff1f01 100755 --- a/demos/quickstart/protected/controls/Comments/CommentBlock.tpl +++ b/demos/quickstart/protected/controls/Comments/CommentBlock.tpl @@ -25,7 +25,6 @@ <div class="username">
<div>
<com:TLabel ForControl="username" Text="Username/Password:" />
- <span class="hint">(must have 5 or more posts in <a href="http://www.pradosoft.com/forum/" title="Prado Forums">forum</a>)</span>
<com:TRequiredFieldValidator
Style="font-weight: bold"
ValidationGroup="comment-group"
diff --git a/demos/quickstart/protected/controls/DocLink.php b/demos/quickstart/protected/controls/DocLink.php index 758a1645..542db179 100755 --- a/demos/quickstart/protected/controls/DocLink.php +++ b/demos/quickstart/protected/controls/DocLink.php @@ -2,7 +2,7 @@ class DocLink extends THyperLink { - const BASE_URL='http://www.pradosoft.com/docs/manual'; + const BASE_URL='http://pradosoft.github.io/docs/manual'; public function getClassPath() { diff --git a/demos/quickstart/protected/controls/Layout.php b/demos/quickstart/protected/controls/Layout.php index 868b10b4..065cf1fb 100755 --- a/demos/quickstart/protected/controls/Layout.php +++ b/demos/quickstart/protected/controls/Layout.php @@ -24,9 +24,10 @@ class Layout extends TTemplateControl $this->MainMenu->Visible=false; $this->TopicPanel->Visible=false; } - + /* $this->languages->DataSource = TPropertyValue::ensureArray($this->Application->Parameters['languages']); $this->languages->dataBind(); + */ } public function languageLinkCreated($sender, $param) diff --git a/demos/quickstart/protected/controls/Layout.tpl b/demos/quickstart/protected/controls/Layout.tpl index c3e67272..54846a32 100755 --- a/demos/quickstart/protected/controls/Layout.tpl +++ b/demos/quickstart/protected/controls/Layout.tpl @@ -1,4 +1,4 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" >
<com:THead Title="PRADO QuickStart Tutorial">
@@ -18,7 +18,7 @@ <com:SearchBox />
</div>
<a href="?">Home</a> |
-<a href="http://www.pradosoft.com">PradoSoft.com</a> |
+<a href="https://github.com/pradosoft/prado">Prado framework</a> |
<a href="../../docs/quickstart.pdf">PDF Version</a> |
<com:THyperLink ID="PrinterLink" Text="Printer-friendly Version" />
</com:TPanel>
@@ -29,7 +29,7 @@ <com:TopicList ID="TopicPanel" />
</td>
<td valign="top">
-
+<!---
<com:TRepeater ID="languages" OnItemCreated="languageLinkCreated">
<prop:HeaderTemplate>
<div class="languages">Available Languages: <ul>
@@ -41,6 +41,7 @@ </ul></div>
</prop:FooterTemplate>
</com:TRepeater>
+--->
<div id="content">
<p class="block-content" id="top-content" style="border-color: transparent; height:1px; margin: 0; padding: 0; background-color: transparent"></p>
<com:TContentPlaceHolder ID="body" />
@@ -50,7 +51,7 @@ </table>
<div id="footer">
-Copyright © 2005-2014 <a href="http://www.pradosoft.com">PradoSoft</a>.
+Copyright © 2006-2015 <a href="https://github.com/pradosoft">The PRADO Group</a>.
<br/><br/>
<%= Prado::poweredByPrado() %>
<a href="http://validator.w3.org/check?uri=referer"><img border="0" src="http://www.w3.org/Icons/valid-xhtml10" alt="Valid XHTML 1.0 Transitional" height="31" width="88" /></a>
diff --git a/demos/quickstart/protected/controls/SampleLayout.tpl b/demos/quickstart/protected/controls/SampleLayout.tpl index ba286f0f..8acc57c0 100755 --- a/demos/quickstart/protected/controls/SampleLayout.tpl +++ b/demos/quickstart/protected/controls/SampleLayout.tpl @@ -19,7 +19,7 @@ </div>
<div class="samplemenu">
<div class="copyright">
- Copyright © 2005-2014 <a href="http://www.pradosoft.com">PradoSoft</a>
+ Copyright © 2006-2015 <a href="https://github.com/pradosoft">The PRADO Group</a>
</div>
</div>
diff --git a/demos/quickstart/protected/controls/TopicList.tpl b/demos/quickstart/protected/controls/TopicList.tpl index ed57a4b0..c23bd2be 100644 --- a/demos/quickstart/protected/controls/TopicList.tpl +++ b/demos/quickstart/protected/controls/TopicList.tpl @@ -106,8 +106,6 @@ <div>Client-side Scripting</div>
<ul>
<li><a href="?page=Advanced.Scripts">Introduction to Javascript</a></li>
- <li><a href="?page=Advanced.Scripts1">Prototype Library Part I</a></li>
- <li><a href="?page=Advanced.Scripts2">Prototype Library Part II</a></li>
<li><a href="?page=Advanced.Scripts3">Javascript Cookbook</a></li>
</ul>
</div>
diff --git a/demos/quickstart/protected/controls/de/Layout.tpl b/demos/quickstart/protected/controls/de/Layout.tpl deleted file mode 100755 index 45e87ef8..00000000 --- a/demos/quickstart/protected/controls/de/Layout.tpl +++ /dev/null @@ -1,61 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" > - -<com:THead Title="PRADO QuickStart Tutorial"> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> -<meta http-equiv="content-language" content="de"/> -</com:THead> - -<body> -<com:TForm> -<div id="header"> -<div class="title">Prado QuickStart Tutorial</div> -<div class="image"></div> -</div> - -<com:TPanel ID="MainMenu" CssClass="mainmenu"> -<div style="float:left; color:black; margin-top:-5px"> - <com:SearchBox /> -</div> -<a href="?">Home</a> | -<a href="http://www.pradosoft.com">PradoSoft.com</a> | -<a href="../../docs/quickstart.pdf">PDF Version</a> | -<com:THyperLink ID="PrinterLink" Text="Druckversion" /> -</com:TPanel> - -<table width="100%" border="0" cellspacing="0" cellpadding="0"> -<tr> -<td valign="top" width="1"> -<com:TopicList ID="TopicPanel" /> -</td> -<td valign="top"> - -<com:TRepeater ID="languages" OnItemCreated="languageLinkCreated"> - <prop:HeaderTemplate> - <div class="languages">Verfügbare Sprachen: <ul> - </prop:HeaderTemplate> - <prop:ItemTemplate> - <li><com:THyperLink ID="link" Text=<%# $this->DataItem %> /></li> - </prop:ItemTemplate> - <prop:FooterTemplate> - </ul></div> - </prop:FooterTemplate> -</com:TRepeater> -<div id="content"> -<p class="block-content" id="top-content" style="border-color: transparent; height:1px; margin: 0; padding: 0; background-color: transparent"></p> -<com:TContentPlaceHolder ID="body" /> -</div> -</td> -</tr> -</table> - -<div id="footer"> -Copyright © 2005-2014 <a href="http://www.pradosoft.com">PradoSoft</a>. -<br/><br/> -<%= Prado::poweredByPrado() %> -<a href="http://validator.w3.org/check?uri=referer"><img border="0" src="http://www.w3.org/Icons/valid-xhtml10" alt="Valid XHTML 1.0 Transitional" height="31" width="88" /></a> -</div> - -</com:TForm> -</body> -</html> diff --git a/demos/quickstart/protected/controls/de/RequiresVersion.tpl b/demos/quickstart/protected/controls/de/RequiresVersion.tpl deleted file mode 100755 index 586cab02..00000000 --- a/demos/quickstart/protected/controls/de/RequiresVersion.tpl +++ /dev/null @@ -1 +0,0 @@ -<p class="requires-version">Benötigt Prado Version <strong><%= $this->Version %></strong> oder neuer.</p> diff --git a/demos/quickstart/protected/controls/de/RunBar.tpl b/demos/quickstart/protected/controls/de/RunBar.tpl deleted file mode 100755 index b507fed8..00000000 --- a/demos/quickstart/protected/controls/de/RunBar.tpl +++ /dev/null @@ -1,4 +0,0 @@ -<div class="runbar"> -<com:THyperLink ID="RunButton" Target="_blank" Text="Beispiel ausführen" /> -<com:THyperLink ID="ViewSourceButton" Target="_blank" Text="Quelltext anzeigen" /> -</div> diff --git a/demos/quickstart/protected/controls/de/SearchBox.tpl b/demos/quickstart/protected/controls/de/SearchBox.tpl deleted file mode 100755 index 45173f18..00000000 --- a/demos/quickstart/protected/controls/de/SearchBox.tpl +++ /dev/null @@ -1,3 +0,0 @@ -<com:TLabel ForControl="search" Text="Suche:" CssClass="searchLabel"/> -<com:TTextBox ID="search" OnTextChanged="doSearch" CssClass="searchBox"/> -<com:TButton ID="find" Text="Suchen" OnClick="doSearch" CssClass="searchButton"/> diff --git a/demos/quickstart/protected/controls/de/TopicList.tpl b/demos/quickstart/protected/controls/de/TopicList.tpl deleted file mode 100755 index 470927da..00000000 --- a/demos/quickstart/protected/controls/de/TopicList.tpl +++ /dev/null @@ -1,115 +0,0 @@ -<div id="toc"> - -<div class="topic"> -<div>Einführung</div> -<ul> - <li><a href="?page=GettingStarted.Introduction">Übersicht</a></li> - <li><a href="?page=GettingStarted.AboutPrado">Was ist PRADO?</a></li> - <li><a href="?page=GettingStarted.Installation">Installation</a></li> - <li><a href="?page=GettingStarted.NewFeatures">Neue Features</a></li> - <li><a href="?page=GettingStarted.Upgrading">Upgrade von v2.x und v1.x</a></li> - <li><a href="?page=GettingStarted.Upgrading32">Upgrate von v3.2</a></li> - <li><a href="?page=GettingStarted.Wsat">Webeseiten Administrations-Tool</a></li> - <li><a href="?page=GettingStarted.CommandLine">Kommandozeilen-Tool</a></li> -</ul> -</div> - -<div class="topic"> -<div>Tutorials</div> -<ul> - <li><a href="?page=GettingStarted.HelloWorld">Erstellen der ersten PRADO Anwendung</a></li> - <li><a href="?page=Fundamentals.Hangman">Beispiel: Galgenmännchen</a></li> - <li><a href="?page=Tutorial.CurrencyConverter">Währungsrechner</a></li> - <li><a href="?page=Tutorial.AjaxChat">AJAX Chat Client</a></li> -</ul> -</div> - -<div class="topic"> -<div>Grundlagen</div> -<ul> - <li><a href="?page=Fundamentals.Architecture">Architektur</a></li> - <li><a href="?page=Fundamentals.Components1">Komponenten: Teil I</a></li> - <li><a href="?page=Fundamentals.Components2">Komponenten: Teil II</a></li> - <li><a href="?page=Fundamentals.Controls">Steuerelemente</a></li> - <li><a href="?page=Fundamentals.Pages">Seiten</a></li> - <li><a href="?page=Fundamentals.Modules">Module</a></li> - <li><a href="?page=Fundamentals.Services">Dienste</a></li> - <li><a href="?page=Fundamentals.Applications">Applikationen</a></li> -</ul> -</div> - -<div class="topic"> -<div>Konfiguration</div> -<ul> - <li><a href="?page=Configurations.Overview">Übersicht</a></li> - <li><a href="?page=Configurations.Templates1">Templates: Teil I</a></li> - <li><a href="?page=Configurations.Templates2">Templates: Teil II</a></li> - <li><a href="?page=Configurations.Templates3">Templates: Teil III</a></li> - <li><a href="?page=Configurations.AppConfig">Anwendungskonfiguration</a></li> - <li><a href="?page=Configurations.PageConfig">Seitenkonfiguration</a></li> - <li><a href="?page=Configurations.UrlMapping">URL Mapping (lesbare URLs)</a></li> -</ul> -</div> - -<div class="topic"> -<div>Steuerelement-Referenz</div> -<ul> - <li><a href="?page=Controls.Standard">Standard Controls</a></li> - <li><a href="?page=Controls.Validation">Validation Controls</a></li> - <li><a href="?page=Controls.List">List Controls</a></li> - <li><a href="?page=Controls.Data">Data Controls</a></li> - <li><a href="?page=ActiveControls.Introduction">AJAX: Einführung</a></li> - <li><a href="?page=ActiveControls.Home">Active Controls (AJAX)</a></li> - <li><a href="?page=JuiControls.Home">Jui Controls (jQuery UI)</a></li> - <li><a href="?page=Controls.NewControl">Entwicklung neuer Steuerelemente</a></li> -</ul> -</div> - -<div class="topic"> -<div>Dienst-Referenz</div> -<ul> - <li><a href="?page=Fundamentals.Services">Page Service</a></li> - <li><a href="?page=Services.SoapService">SOAP Service</a></li> - <li><a href="?page=Services.RpcService">RPC Service</a></li> -</ul> -</div> - -<div class="topic"> -<div>Anbindung an Datenbanken</div> -<ul> - <li><a href="?page=Database.DAO">Data Access Objects</a></li> - <li><a href="?page=Database.ActiveRecord">Active Record</a></li> - <li><a href="?page=Database.Scaffold">Active Record Scaffold</a></li> - <li><a href="?page=Database.SqlMap">SqlMap Data Mapper</a></li> - <li><a href="?page=Database.ViewsArUpdate">Ansichten - AR-Klassen-Update</a></li> -</ul> -</div> - -<div class="topic"> -<div>Fortgeschrittene Themen</div> -<ul> - <li><a href="?page=Advanced.Collections">Collections</a></li> - <li><a href="?page=Advanced.Auth">Authentifizierung und Authorisierung</a></li> - <li><a href="?page=Advanced.Security">Sicherheit</a></li> - <li><a href="?page=Advanced.Assets">Assets</a></li> - <li><a href="?page=Advanced.MasterContent">Master and Content</a></li> - <li><a href="?page=Advanced.Themes">Themes and Skins</a></li> - <li><a href="?page=Advanced.State">Persistent State</a></li> - <li><a href="?page=Advanced.Logging">Logging</a></li> - <li><a href="?page=Advanced.Error">Fehlerbehandlung und Reporting</a></li> - <li><a href="?page=Advanced.I18N">Internationalisierung</a></li> - <li><a href="?page=Advanced.Performance">Performanzsteigerung</a></li> -</ul> -</div> - -<div class="topic"> -<div>Client-side Scripting</div> -<ul> - <li><a href="?page=Advanced.Scripts">Einführung in Javascript</a></li> - <li><a href="?page=Advanced.Scripts1">Prototype Library Teil I</a></li> - <li><a href="?page=Advanced.Scripts2">Prototype Library Teil II</a></li> - <li><a href="?page=Advanced.Scripts3">Javascript Kochbuch</a></li> -</ul> -</div> - -</div> diff --git a/demos/quickstart/protected/controls/es/Layout.tpl b/demos/quickstart/protected/controls/es/Layout.tpl deleted file mode 100755 index f08aef68..00000000 --- a/demos/quickstart/protected/controls/es/Layout.tpl +++ /dev/null @@ -1,61 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="es">
-
-<com:THead Title="Guía de comienzo rápida con PRADO">
-<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<meta http-equiv="content-language" content="es"/>
-</com:THead>
-
-<body>
-<com:TForm>
-<div id="header">
-<div class="title">Guía de comienzo rápida con PRADO</div>
-<div class="image"></div>
-</div>
-
-<com:TPanel ID="MainMenu" CssClass="mainmenu">
-<div style="float:left; color:black; margin-top:-5px">
- <com:SearchBox />
-</div>
-<a href="?">Home</a> |
-<a href="http://www.pradosoft.com">PradoSoft.com</a> |
-<a href="../../../docs/quickstart.pdf">Versión en PDF</a> |
-<com:THyperLink ID="PrinterLink" Text="Versión en para imprimir" />
-</com:TPanel>
-
-<table width="100%" border="0" cellspacing="0" cellpadding="0">
-<tr>
-<td valign="top" width="1">
-<com:TopicList ID="TopicPanel" />
-</td>
-<td valign="top">
-
-<com:TRepeater ID="languages" OnItemCreated="languageLinkCreated">
- <prop:HeaderTemplate>
- <div class="languages">Idiomas disponibles: <ul>
- </prop:HeaderTemplate>
- <prop:ItemTemplate>
- <li><com:THyperLink ID="link" Text=<%# $this->DataItem %> /></li>
- </prop:ItemTemplate>
- <prop:FooterTemplate>
- </ul></div>
- </prop:FooterTemplate>
-</com:TRepeater>
-<div id="content">
-<p class="block-content" id="top-content" style="border-color: transparent; height:1px; margin: 0; padding: 0; background-color: transparent"></p>
-<com:TContentPlaceHolder ID="body" />
-</div>
-</td>
-</tr>
-</table>
-
-<div id="footer">
-Copyright © 2005-2007 <a href="http://www.pradosoft.com">PradoSoft</a>.
-<br/><br/>
-<%= Prado::poweredByPrado() %>
-<a href="http://validator.w3.org/check?uri=referer"><img border="0" src="http://www.w3.org/Icons/valid-xhtml10" alt="Valid XHTML 1.0 Transitional" height="31" width="88" /></a>
-</div>
-
-</com:TForm>
-</body>
-</html>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/es/RequiresVersion.tpl b/demos/quickstart/protected/controls/es/RequiresVersion.tpl deleted file mode 100755 index 6df71306..00000000 --- a/demos/quickstart/protected/controls/es/RequiresVersion.tpl +++ /dev/null @@ -1 +0,0 @@ -<p class="requires-version">Se requiere la versión de PRADO <strong><%= $this->Version %></strong> o superior.</p>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/es/RunBar.tpl b/demos/quickstart/protected/controls/es/RunBar.tpl deleted file mode 100755 index 74458c68..00000000 --- a/demos/quickstart/protected/controls/es/RunBar.tpl +++ /dev/null @@ -1,4 +0,0 @@ -<div class="runbar">
-<com:THyperLink ID="RunButton" Target="_blank" Text="Ver ejemplo" />
-<com:THyperLink ID="ViewSourceButton" Target="_blank" Text="Ver código fuente" />
-</div>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/es/SampleLayout.tpl b/demos/quickstart/protected/controls/es/SampleLayout.tpl deleted file mode 100755 index d6d4d9b4..00000000 --- a/demos/quickstart/protected/controls/es/SampleLayout.tpl +++ /dev/null @@ -1,32 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="es">
-
-<com:THead Title="PRADO QuickStart Sample">
-<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<meta http-equiv="content-language" content="es"/>
-</com:THead>
-
-<body>
-<com:TForm>
-
-<div class="sampleheader">
-
-<div class="title">
-<a href="?">Guía de comienzo rápida con PRADO</a> Ejemplo
-</div>
-<div class="image"></div>
-
-</div>
-<div class="samplemenu">
- <div class="copyright">
- Copyright © 2005-2014 <a href="http://www.pradosoft.com">PradoSoft</a>
- </div>
-</div>
-
-<div style="margin:15px;">
-<com:TContentPlaceHolder ID="body" />
-</div>
-
-</com:TForm>
-</body>
-</html>
diff --git a/demos/quickstart/protected/controls/es/SearchBox.tpl b/demos/quickstart/protected/controls/es/SearchBox.tpl deleted file mode 100755 index dade4094..00000000 --- a/demos/quickstart/protected/controls/es/SearchBox.tpl +++ /dev/null @@ -1,3 +0,0 @@ -<com:TLabel ForControl="search" Text="Buscar:" CssClass="searchLabel"/>
-<com:TTextBox ID="search" OnTextChanged="doSearch" CssClass="searchBox"/>
-<com:TButton ID="find" Text="Encontrar" OnClick="doSearch" CssClass="searchButton"/>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/es/SinceVersion.tpl b/demos/quickstart/protected/controls/es/SinceVersion.tpl deleted file mode 100755 index d4ee4d63..00000000 --- a/demos/quickstart/protected/controls/es/SinceVersion.tpl +++ /dev/null @@ -1 +0,0 @@ -<p class="since-version">Disponible desde la versión de PRADO <strong><%= $this->Version %></strong>en adelante.</p>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/es/TopicList.tpl b/demos/quickstart/protected/controls/es/TopicList.tpl deleted file mode 100644 index 62451700..00000000 --- a/demos/quickstart/protected/controls/es/TopicList.tpl +++ /dev/null @@ -1,112 +0,0 @@ -<div id="toc">
-
-<div class="topic">
-<div>Comenzar</div>
-<ul>
- <li><a href="?page=GettingStarted.Introduction">Introducción</a></li>
- <li><a href="?page=GettingStarted.AboutPrado">¿Que es PRADO?</a></li>
- <li><a href="?page=GettingStarted.Installation">Instalación</a></li>
- <li><a href="?page=GettingStarted.NewFeatures">Nuevas Funcionalidades</a></li>
- <li><a href="?page=GettingStarted.Upgrading">Actualizar desde la version v2.x y v1.x</a></li>
- <li><a href="?page=GettingStarted.Wsat">Web Site Administration Tool</a></li>
- <li><a href="?page=GettingStarted.CommandLine">Command Line Tool</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Tutoriales</div>
-<ul>
- <li><a href="?page=GettingStarted.HelloWorld">Crear la primera aplicacion en PRADO</a></li>
- <li><a href="?page=Fundamentals.Hangman">Ejemplo: El ahorcado</a></li>
- <li><a href="?page=Tutorial.CurrencyConverter">Convertidor de Monedas</a></li>
- <li><a href="?page=Tutorial.AddressBook">Libreta de direcciones</a></li>
- <li><a href="?page=Tutorial.AjaxChat">Cliente Chat en AJAX </a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Básicos</div>
-<ul>
- <li><a href="?page=Fundamentals.Architecture">Arquitectura</a></li>
- <li><a href="?page=Fundamentals.Components1">Componentes</a></li>
- <li><a href="?page=Fundamentals.Controls">Controles</a></li>
- <li><a href="?page=Fundamentals.Pages">Páginas</a></li>
- <li><a href="?page=Fundamentals.Modules">Mádulos</a></li>
- <li><a href="?page=Fundamentals.Services">Servicios</a></li>
- <li><a href="?page=Fundamentals.Applications">Aplicaciones</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Configuración</div>
-<ul>
- <li><a href="?page=Configurations.Overview">Perspectiva General</a></li>
- <li><a href="?page=Configurations.Templates1">Plantillas: Parte I</a></li>
- <li><a href="?page=Configurations.Templates2">Plantillas: Parte II</a></li>
- <li><a href="?page=Configurations.Templates3">Plantillas: Parte III</a></li>
- <li><a href="?page=Configurations.AppConfig">Configuraciones de Aplicación</a></li>
- <li><a href="?page=Configurations.PageConfig">Configuraciones de Página</a></li>
- <li><a href="?page=Configurations.UrlMapping">Mapeo URL (URLs amigables)</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Referencia de controles</div>
-<ul>
- <li><a href="?page=Controls.Standard">Controles Clásicos</a></li>
- <li><a href="?page=Controls.Validation">Controles de Validación</a></li>
- <li><a href="?page=Controls.List">Controles de Lista</a></li>
- <li><a href="?page=Controls.Data">Controles de Datos</a></li>
- <li><a href="?page=ActiveControls.Home">Controles Activos(AJAX)</a></li>
- <li><a href="?page=Controls.NewControl">Escribir nuevos Controles</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Referencia de Servicios</div>
-<ul>
- <li><a href="?page=Fundamentals.Services">Servicio Page</a></li>
- <li><a href="?page=Services.SoapService">Servicio SOAP</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Trabajando con Bases de datos</div>
-<ul>
- <li><a href="?page=Database.DAO">Objetos de acceso a datos (DAO)</a></li>
- <li><a href="?page=Database.ActiveRecord">Active Record</a></li>
- <li><a href="?page=Database.Scaffold">Active Record Scaffold</a></li>
- <li><a href="?page=Database.SqlMap">SqlMap Data Mapper</a></li>
- <li><a href="?page=Database.ViewsArUpdate">Actualización de vistas y clases AR</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Temas avanzados</div>
-<ul>
- <li><a href="?page=Advanced.Collections">Colecciones</a></li>
- <li><a href="?page=Advanced.Auth">Autenticación y Autorización</a></li>
- <li><a href="?page=Advanced.Security">Seguridad</a></li>
- <li><a href="?page=Advanced.Assets">Assets</a></li>
- <li><a href="?page=Advanced.MasterContent">Master and Content</a></li>
- <li><a href="?page=Advanced.Themes">Temas y Apariencias (Skins)</a></li>
- <li><a href="?page=Advanced.State">Estado Persisntent</a></li>
- <li><a href="?page=Advanced.Logging">Logging</a></li>
- <li><a href="?page=Advanced.Error">Manipulación y Reportes de errores</a></li>
-
- <li><a href="?page=Advanced.I18N">Internacionalización</a></li>
- <li><a href="?page=Advanced.Performance">Puesta a punto y rendimiento(Performance Tuning)</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Scripts del lado del cliente (Client-side Scripting)</div>
-<ul>
- <li><a href="?page=Advanced.Scripts">Introducción a Javascript</a></li>
- <li><a href="?page=Advanced.Scripts1">Librería Prototipo Parte I</a></li>
- <li><a href="?page=Advanced.Scripts2">Librería Prototipo Parte II</a></li>
- <li><a href="?page=Advanced.Scripts3">Recetario de Javascript (Cookbook)</a></li>
-</ul>
-</div>
-
-</div>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/fr/Layout.tpl b/demos/quickstart/protected/controls/fr/Layout.tpl deleted file mode 100755 index 4882916e..00000000 --- a/demos/quickstart/protected/controls/fr/Layout.tpl +++ /dev/null @@ -1,61 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" >
-
-<com:THead Title="PRADO Tutorial de démarrage rapide">
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
-<meta http-equiv="content-language" content="fr"/>
-</com:THead>
-
-<body>
-<com:TForm>
-<div id="header">
-<div class="title">PRADO Tutorial de démarrage rapide</div>
-<div class="image"></div>
-</div>
-
-<com:TPanel ID="MainMenu" CssClass="mainmenu">
-<div style="float:left; color:black; margin-top:-5px">
- <com:SearchBox />
-</div>
-<a href="?">Accueil</a> |
-<a href="http://www.pradosoft.com">PradoSoft.com</a> |
-<a href="../../docs/quickstart.pdf">Version PDF</a> |
-<com:THyperLink ID="PrinterLink" Text="Version imprimable" />
-</com:TPanel>
-
-<table width="100%" border="0" cellspacing="0" cellpadding="0">
-<tr>
-<td valign="top" width="1">
-<com:TopicList ID="TopicPanel" />
-</td>
-<td valign="top">
-
-<com:TRepeater ID="languages" OnItemCreated="languageLinkCreated">
- <prop:HeaderTemplate>
- <div class="languages">Langues disponibles :<ul>
- </prop:HeaderTemplate>
- <prop:ItemTemplate>
- <li><com:THyperLink ID="link" Text=<%# $this->DataItem %> /></li>
- </prop:ItemTemplate>
- <prop:FooterTemplate>
- </ul></div>
- </prop:FooterTemplate>
-</com:TRepeater>
-<div id="content">
-<p class="block-content" id="top-content" style="border-color: transparent; height:1px; margin: 0; padding: 0; background-color: transparent"></p>
-<com:TContentPlaceHolder ID="body" />
-</div>
-</td>
-</tr>
-</table>
-
-<div id="footer">
-Copyright © 2005-2007 <a href="http://www.pradosoft.com">PradoSoft</a>.
-<br/><br/>
-<%= Prado::poweredByPrado() %>
-<a href="http://validator.w3.org/check?uri=referer"><img border="0" src="http://www.w3.org/Icons/valid-xhtml10" alt="XHTML 1.0 Transitionnel Valide" height="31" width="88" /></a>
-</div>
-
-</com:TForm>
-</body>
-</html>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/fr/RunBar.tpl b/demos/quickstart/protected/controls/fr/RunBar.tpl deleted file mode 100755 index 4ad1ce03..00000000 --- a/demos/quickstart/protected/controls/fr/RunBar.tpl +++ /dev/null @@ -1,4 +0,0 @@ -<div class="runbar">
-<com:THyperLink ID="RunButton" Target="_blank" Text="Executer l'exemple" />
-<com:THyperLink ID="ViewSourceButton" Target="_blank" Text="Voir la source" />
-</div>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/fr/SampleLayout.tpl b/demos/quickstart/protected/controls/fr/SampleLayout.tpl deleted file mode 100755 index e6fd2347..00000000 --- a/demos/quickstart/protected/controls/fr/SampleLayout.tpl +++ /dev/null @@ -1,32 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" >
-
-<com:THead Title="PRADO Tutorial de démarrage rapide">
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
-<meta http-equiv="content-language" content="fr"/>
-</com:THead>
-
-<body>
-<com:TForm>
-
-<div class="sampleheader">
-
-<div class="title">
-<a href="?">PRADO Tutorial de démarrage rapide</a> : Exemple
-</div>
-<div class="image"></div>
-
-</div>
-<div class="samplemenu">
- <div class="copyright">
- Copyright © 2005-2014 <a href="http://www.pradosoft.com">PradoSoft</a>
- </div>
-</div>
-
-<div style="margin:15px;">
-<com:TContentPlaceHolder ID="body" />
-</div>
-
-</com:TForm>
-</body>
-</html>
diff --git a/demos/quickstart/protected/controls/fr/SearchBox.tpl b/demos/quickstart/protected/controls/fr/SearchBox.tpl deleted file mode 100755 index 9eaccd7a..00000000 --- a/demos/quickstart/protected/controls/fr/SearchBox.tpl +++ /dev/null @@ -1,3 +0,0 @@ -<com:TLabel ForControl="search" Text="Recherche :" CssClass="searchLabel"/>
-<com:TTextBox ID="search" OnTextChanged="doSearch" CssClass="searchBox"/>
-<com:TButton ID="find" Text="Trouver" OnClick="doSearch" CssClass="searchButton"/>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/fr/TopicList.tpl b/demos/quickstart/protected/controls/fr/TopicList.tpl deleted file mode 100644 index c37609ab..00000000 --- a/demos/quickstart/protected/controls/fr/TopicList.tpl +++ /dev/null @@ -1,110 +0,0 @@ -<div id="toc">
-
-<div class="topic">
-<div>Démarrage rapide</div>
-<ul>
- <li><a href="?page=GettingStarted.Introduction">Introduction</a></li>
- <li><a href="?page=GettingStarted.AboutPrado">Qu'est-ce que PRADO ?</a></li>
- <li><a href="?page=GettingStarted.Installation">Installation</a></li>
- <li><a href="?page=GettingStarted.NewFeatures">Nouvelles fonctionnalités</a></li>
- <li><a href="?page=GettingStarted.Upgrading">Mise à jour de v2.x et v1.x</a></li>
- <li><a href="?page=GettingStarted.Wsat">Web Site Administration Tool</a></li>
- <li><a href="?page=GettingStarted.CommandLine">Command Line Tool</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Tutoriaux</div>
-<ul>
- <li><a href="?page=GettingStarted.HelloWorld">Créer sa première application PRADO</a></li>
- <li><a href="?page=Fundamentals.Hangman">Exemple : Jeu du pendu</a></li>
- <li><a href="?page=Tutorial.CurrencyConverter">Convertisseur monétaire</a></li>
- <li><a href="?page=Tutorial.AjaxChat">Chat AJAX</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Fundamentaux</div>
-<ul>
- <li><a href="?page=Fundamentals.Architecture">Architecture</a></li>
- <li><a href="?page=Fundamentals.Components1">Composants</a></li>
- <li><a href="?page=Fundamentals.Controls">Contrôles</a></li>
- <li><a href="?page=Fundamentals.Pages">Pages</a></li>
- <li><a href="?page=Fundamentals.Modules">Modules</a></li>
- <li><a href="?page=Fundamentals.Services">Services</a></li>
- <li><a href="?page=Fundamentals.Applications">Applications</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Configurations</div>
-<ul>
- <li><a href="?page=Configurations.Overview">Vue d'ensemble</a></li>
- <li><a href="?page=Configurations.Templates1">Templates : Partie I</a></li>
- <li><a href="?page=Configurations.Templates2">Templates : Partie II</a></li>
- <li><a href="?page=Configurations.Templates3">Templates : Partie III</a></li>
- <li><a href="?page=Configurations.AppConfig">Configuration de l'application</a></li>
- <li><a href="?page=Configurations.PageConfig">Configuration des pages</a></li>
- <li><a href="?page=Configurations.UrlMapping">URL Mapping (Friendly URLs)</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Réference des contrôles</div>
-<ul>
- <li><a href="?page=Controls.Standard">Contrôles standards</a></li>
- <li><a href="?page=Controls.Validation">Contrôles de validation</a></li>
- <li><a href="?page=Controls.List">Contrôles de listes</a></li>
- <li><a href="?page=Controls.Data">Contrôles de données</a></li>
- <li><a href="?page=ActiveControls.Home">Active Controls (AJAX)</a></li>
- <li><a href="?page=Controls.NewControl">Ecrire de nouveaux contrôles</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Réference des services</div>
-<ul>
- <li><a href="?page=Fundamentals.Services">Page Service</a></li>
- <li><a href="?page=Services.SoapService">SOAP Service</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Travailler avec les BDD</div>
-<ul>
- <li><a href="?page=Database.DAO">Data Access Objects</a></li>
- <li><a href="?page=Database.ActiveRecord">Active Record</a></li>
- <li><a href="?page=Database.Scaffold">Active Record Scaffold</a></li>
- <li><a href="?page=Database.SqlMap">SqlMap Data Mapper</a></li>
- <li><a href="?page=Database.ViewsArUpdate">Vues - Mise à jour des classes AR</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Thèmes avancés</div>
-<ul>
- <li><a href="?page=Advanced.Collections">Collections</a></li>
- <li><a href="?page=Advanced.Auth">Authentication et Authorisation</a></li>
- <li><a href="?page=Advanced.Security">Securité</a></li>
- <li><a href="?page=Advanced.Assets">Assets</a></li>
- <li><a href="?page=Advanced.MasterContent">Master et Content</a></li>
- <li><a href="?page=Advanced.Themes">Thèmes et Skins</a></li>
- <li><a href="?page=Advanced.State">Etat Persistent</a></li>
- <li><a href="?page=Advanced.Logging">Logging</a></li>
- <li><a href="?page=Advanced.Error">Gestion d'erreurs et rapports</a></li>
- <li><a href="?page=Advanced.I18N">Internationalisation</a></li>
- <li><a href="?page=Advanced.Performance">Amélioration des performances</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Script côté client</div>
-<ul>
- <li><a href="?page=Advanced.Scripts">Introduction au Javascript</a></li>
- <li><a href="?page=Advanced.Scripts1">Librairie Prototype Partie I</a></li>
- <li><a href="?page=Advanced.Scripts2">Librairie Prototype Partie II</a></li>
- <li><a href="?page=Advanced.Scripts3">Javascript Cookbook</a></li>
-</ul>
-</div>
-
-</div>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/id/Layout.tpl b/demos/quickstart/protected/controls/id/Layout.tpl deleted file mode 100755 index aa210d67..00000000 --- a/demos/quickstart/protected/controls/id/Layout.tpl +++ /dev/null @@ -1,61 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" >
-
-<com:THead Title="Tutorial Cepat PRADO">
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
-<meta http-equiv="content-language" content="en"/>
-</com:THead>
-
-<body>
-<com:TForm>
-<div id="header">
-<div class="title">Tutorial Cepat Prado</div>
-<div class="image"></div>
-</div>
-
-<com:TPanel ID="MainMenu" CssClass="mainmenu">
-<div style="float:left; color:black; margin-top:-5px">
- <com:SearchBox />
-</div>
-<a href="?">Home</a> |
-<a href="http://www.pradosoft.com">PradoSoft.com</a> |
-<a href="../../../docs/quickstart.pdf">PDF Version</a> |
-<com:THyperLink ID="PrinterLink" Text="Versi Tercetak" />
-</com:TPanel>
-
-<table width="100%" border="0" cellspacing="0" cellpadding="0">
-<tr>
-<td valign="top" width="1">
-<com:TopicList ID="TopicPanel" />
-</td>
-<td valign="top">
-
-<com:TRepeater ID="languages" OnItemCreated="languageLinkCreated">
- <prop:HeaderTemplate>
- <div class="languages">Bahasa Tersedia: <ul>
- </prop:HeaderTemplate>
- <prop:ItemTemplate>
- <li><com:THyperLink ID="link" Text=<%# $this->DataItem %> /></li>
- </prop:ItemTemplate>
- <prop:FooterTemplate>
- </ul></div>
- </prop:FooterTemplate>
-</com:TRepeater>
-<div id="content">
-<p class="block-content" id="top-content" style="border-color: transparent; height:1px; margin: 0; padding: 0; background-color: transparent"></p>
-<com:TContentPlaceHolder ID="body" />
-</div>
-</td>
-</tr>
-</table>
-
-<div id="footer">
-Hak Cipta © 2005-2007 <a href="http://www.pradosoft.com">PradoSoft</a>.
-<br/><br/>
-<%= Prado::poweredByPrado() %>
-<a href="http://validator.w3.org/check?uri=referer"><img border="0" src="http://www.w3.org/Icons/valid-xhtml10" alt="Valid XHTML 1.0 Transitional" height="31" width="88" /></a>
-</div>
-
-</com:TForm>
-</body>
-</html>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/id/RequiresVersion.tpl b/demos/quickstart/protected/controls/id/RequiresVersion.tpl deleted file mode 100755 index f703512b..00000000 --- a/demos/quickstart/protected/controls/id/RequiresVersion.tpl +++ /dev/null @@ -1 +0,0 @@ -<p class="requires-version">Memerlukan Prado versi <strong><%= $this->Version %></strong> atau lebih baru.</p>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/id/RunBar.tpl b/demos/quickstart/protected/controls/id/RunBar.tpl deleted file mode 100755 index ef1e76c8..00000000 --- a/demos/quickstart/protected/controls/id/RunBar.tpl +++ /dev/null @@ -1,4 +0,0 @@ -<div class="runbar">
-<com:THyperLink ID="RunButton" Target="_blank" Text="Jalankan Contoh" />
-<com:THyperLink ID="ViewSourceButton" Target="_blank" Text="Lihat Sumber" />
-</div>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/id/SampleLayout.tpl b/demos/quickstart/protected/controls/id/SampleLayout.tpl deleted file mode 100755 index 6d990598..00000000 --- a/demos/quickstart/protected/controls/id/SampleLayout.tpl +++ /dev/null @@ -1,32 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" >
-
-<com:THead Title="Contoh Tutorial Cepat PRADO">
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
-<meta http-equiv="content-language" content="en"/>
-</com:THead>
-
-<body>
-<com:TForm>
-
-<div class="sampleheader">
-
-<div class="title">
-<a href="?">Tutorial Cepat PRADO</a> Contoh
-</div>
-<div class="image"></div>
-
-</div>
-<div class="samplemenu">
- <div class="copyright">
- Hak Cipta © 2005-2007 <a href="http://www.pradosoft.com">PradoSoft</a>
- </div>
-</div>
-
-<div style="margin:15px;">
-<com:TContentPlaceHolder ID="body" />
-</div>
-
-</com:TForm>
-</body>
-</html>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/id/SearchBox.tpl b/demos/quickstart/protected/controls/id/SearchBox.tpl deleted file mode 100755 index 11e9cf7a..00000000 --- a/demos/quickstart/protected/controls/id/SearchBox.tpl +++ /dev/null @@ -1,3 +0,0 @@ -<com:TLabel ForControl="search" Text="Cari:" CssClass="searchLabel"/>
-<com:TTextBox ID="search" OnTextChanged="doSearch" CssClass="searchBox"/>
-<com:TButton ID="find" Text="Ayo" OnClick="doSearch" CssClass="searchButton"/>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/id/SinceVersion.tpl b/demos/quickstart/protected/controls/id/SinceVersion.tpl deleted file mode 100755 index 767674c0..00000000 --- a/demos/quickstart/protected/controls/id/SinceVersion.tpl +++ /dev/null @@ -1 +0,0 @@ -<p class="since-version">Tersedia mulai dari Prado versi <strong><%= $this->Version %></strong> dan selanjutnya.</p>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/id/TopicList.tpl b/demos/quickstart/protected/controls/id/TopicList.tpl deleted file mode 100644 index a35db55d..00000000 --- a/demos/quickstart/protected/controls/id/TopicList.tpl +++ /dev/null @@ -1,111 +0,0 @@ -<div id="toc">
-
-<div class="topic">
-<div>Memulai</div>
-<ul>
- <li><a href="?page=GettingStarted.Introduction">Pengenalan</a></li>
- <li><a href="?page=GettingStarted.AboutPrado">Apa itu PRADO?</a></li>
- <li><a href="?page=GettingStarted.Installation">Instalasi</a></li>
- <li><a href="?page=GettingStarted.NewFeatures">Fitur Baru</a></li>
- <li><a href="?page=GettingStarted.Upgrading">Meningkatkan dari v2.x dan v1.x</a></li>
- <li><a href="?page=GettingStarted.Wsat">Web Site Administration Tool</a></li>
- <li><a href="?page=GettingStarted.CommandLine">Command Line Tool</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Tutorial</div>
-<ul>
- <li><a href="?page=GettingStarted.HelloWorld">Membuat Aplikasi PRADO Pertama</a></li>
- <li><a href="?page=Fundamentals.Hangman">Contoh: Permainan Hangman</a></li>
- <li><a href="?page=Tutorial.CurrencyConverter">Pengubah Kurs</a></li>
- <li><a href="?page=Tutorial.AddressBook">Buku Alamat</a></li>
- <li><a href="?page=Tutorial.AjaxChat">Klient Obrolan AJAX</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Fundamental</div>
-<ul>
- <li><a href="?page=Fundamentals.Architecture">Arsitektur</a></li>
- <li><a href="?page=Fundamentals.Components1">Komponen</a></li>
- <li><a href="?page=Fundamentals.Controls">Kontrol</a></li>
- <li><a href="?page=Fundamentals.Pages">Halaman</a></li>
- <li><a href="?page=Fundamentals.Modules">Modul</a></li>
- <li><a href="?page=Fundamentals.Services">Layanan</a></li>
- <li><a href="?page=Fundamentals.Applications">Aplikasi</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Konfigurasi</div>
-<ul>
- <li><a href="?page=Configurations.Overview">Tinjauan</a></li>
- <li><a href="?page=Configurations.Templates1">Template: Bagian I</a></li>
- <li><a href="?page=Configurations.Templates2">Template: Bagian II</a></li>
- <li><a href="?page=Configurations.Templates3">Template: Bagian III</a></li>
- <li><a href="?page=Configurations.AppConfig">Konfigurasi Aplikasi</a></li>
- <li><a href="?page=Configurations.PageConfig">Konfigurasi Halaman</a></li>
- <li><a href="?page=Configurations.UrlMapping">Pemetaan URL (URL bersahabat)</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Referensi Kontrol</div>
-<ul>
- <li><a href="?page=Controls.Standard">Kontrol Standar</a></li>
- <li><a href="?page=Controls.Validation">Kontrol Validasi</a></li>
- <li><a href="?page=Controls.List">Kontrol Daftar</a></li>
- <li><a href="?page=Controls.Data">Kontrol Data</a></li>
- <li><a href="?page=ActiveControls.Home">Kontrol Aktif (AJAX)</a></li>
- <li><a href="?page=Controls.NewControl">Menulis Kontrol Baru</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Referensi Layanan</div>
-<ul>
- <li><a href="?page=Fundamentals.Services">Layanan Halaman</a></li>
- <li><a href="?page=Services.SoapService">Layanan SOAP</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Bekerja dengan Databases</div>
-<ul>
- <li><a href="?page=Database.DAO">Data Access Objects</a></li>
- <li><a href="?page=Database.ActiveRecord">Rekaman Aktf</a></li>
- <li><a href="?page=Database.Scaffold">Kerangka Rekaman Aktif</a></li>
- <li><a href="?page=Database.SqlMap">Pemeta Data SqlMap</a></li>
- <li><a href="?page=Database.ViewsArUpdate">Views - AR Kelas Perbarui</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Topik Lanjutan</div>
-<ul>
- <li><a href="?page=Advanced.Collections">Koleksi</a></li>
- <li><a href="?page=Advanced.Auth">Otentikasi dan Otorisasi</a></li>
- <li><a href="?page=Advanced.Security">Keamanan</a></li>
- <li><a href="?page=Advanced.Assets">Asset</a></li>
- <li><a href="?page=Advanced.MasterContent">Master dan Konten</a></li>
- <li><a href="?page=Advanced.Themes">Tema dan Skin</a></li>
- <li><a href="?page=Advanced.State">Kondisi Persisten</a></li>
- <li><a href="?page=Advanced.Logging">Pencatatan</a></li>
- <li><a href="?page=Advanced.Error">Penanganan Kesalahan dan Laporan</a></li>
- <li><a href="?page=Advanced.I18N">Internasionalisasi</a></li>
- <li><a href="?page=Advanced.Performance">Penyesuaian Performansi</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Penaskahan sisi-Klien</div>
-<ul>
- <li><a href="?page=Advanced.Scripts">Pengenalan Javascript</a></li>
- <li><a href="?page=Advanced.Scripts1">Librari Prototipe Bagian I</a></li>
- <li><a href="?page=Advanced.Scripts2">Librari Prototipe Bagian II</a></li>
- <li><a href="?page=Advanced.Scripts3">Buku Lengkap Javascript</a></li>
-</ul>
-</div>
-
-</div>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/ja/Layout.tpl b/demos/quickstart/protected/controls/ja/Layout.tpl deleted file mode 100755 index 54cf14cb..00000000 --- a/demos/quickstart/protected/controls/ja/Layout.tpl +++ /dev/null @@ -1,61 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" >
-
-<com:THead Title="PRADO クイックスタートチュートリアル">
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
-<meta http-equiv="content-language" content="ja" />
-</com:THead>
-
-<body>
-<com:TForm>
-<div id="header">
-<div class="title">Prado クイックスタートチュートリアル</div>
-<div class="image"></div>
-</div>
-
-<com:TPanel ID="MainMenu" CssClass="mainmenu">
-<div style="float:left; color:black; margin-top:-5px">
- <com:SearchBox />
-</div>
-<a href="?">ホーム</a> |
-<a href="http://www.pradosoft.com">本家サイト</a> |
-<a href="../../docs/quickstart.pdf">PDF バージョン</a> |
-<com:THyperLink ID="PrinterLink" Text="プリントバージョン" />
-</com:TPanel>
-
-<table width="100%" border="0" cellspacing="0" cellpadding="0">
-<tr>
-<td valign="top" width="1">
-<com:TopicList ID="TopicPanel" />
-</td>
-<td valign="top">
-
-<com:TRepeater ID="languages" OnItemCreated="languageLinkCreated">
- <prop:HeaderTemplate>
- <div class="languages">利用可能な言語: <ul>
- </prop:HeaderTemplate>
- <prop:ItemTemplate>
- <li><com:THyperLink ID="link" Text=<%# $this->DataItem %> /></li>
- </prop:ItemTemplate>
- <prop:FooterTemplate>
- </ul></div>
- </prop:FooterTemplate>
-</com:TRepeater>
-<div id="content">
-<p class="block-content" id="top-content" style="border-color: transparent; height:1px; margin: 0; padding: 0; background-color: transparent"></p>
-<com:TContentPlaceHolder ID="body" />
-</div>
-</td>
-</tr>
-</table>
-
-<div id="footer">
-Copyright © 2005-2007 <a href="http://www.pradosoft.com">PradoSoft</a>.
-<br/><br/>
-<%= Prado::poweredByPrado() %>
-<a href="http://validator.w3.org/check?uri=referer"><img border="0" src="http://www.w3.org/Icons/valid-xhtml10" alt="Valid XHTML 1.0 Transitional" height="31" width="88" /></a>
-</div>
-
-</com:TForm>
-</body>
-</html>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/ja/RunBar.tpl b/demos/quickstart/protected/controls/ja/RunBar.tpl deleted file mode 100755 index c8015514..00000000 --- a/demos/quickstart/protected/controls/ja/RunBar.tpl +++ /dev/null @@ -1,4 +0,0 @@ -<div class="runbar">
-<com:THyperLink ID="RunButton" Target="_blank" Text="サンプルの実行" />
-<com:THyperLink ID="ViewSourceButton" Target="_blank" Text="ソースの表示" />
-</div>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/ja/SearchBox.tpl b/demos/quickstart/protected/controls/ja/SearchBox.tpl deleted file mode 100755 index 092c8d4b..00000000 --- a/demos/quickstart/protected/controls/ja/SearchBox.tpl +++ /dev/null @@ -1,3 +0,0 @@ -<com:TLabel ForControl="search" Text="検索:" CssClass="searchLabel"/>
-<com:TTextBox ID="search" OnTextChanged="doSearch" CssClass="searchBox"/>
-<com:TButton ID="find" Text="検索" OnClick="doSearch" CssClass="searchButton"/>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/ja/TopicList.tpl b/demos/quickstart/protected/controls/ja/TopicList.tpl deleted file mode 100644 index f24994e0..00000000 --- a/demos/quickstart/protected/controls/ja/TopicList.tpl +++ /dev/null @@ -1,111 +0,0 @@ -<div id="toc">
-
-<div class="topic">
-<div>ご利用の前に</div>
-<ul>
- <li><a href="?page=GettingStarted.Introduction">はじめに</a></li>
- <li><a href="?page=GettingStarted.AboutPrado">PRADO とは？</a></li>
- <li><a href="?page=GettingStarted.Installation">インストール</a></li>
- <li><a href="?page=GettingStarted.NewFeatures">新機能</a></li>
- <li><a href="?page=GettingStarted.Upgrading">v2.x v1.x からのバージョンアップ</a></li>
- <li><a href="?page=GettingStarted.Wsat">Web Site Administration Tool</a></li>
- <li><a href="?page=GettingStarted.CommandLine">Command Line Tool</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>チュートリアル</div>
-<ul>
- <li><a href="?page=GettingStarted.HelloWorld">初めての PRADO アプリケーション</a></li>
- <li><a href="?page=Fundamentals.Hangman">Hangman ゲームサンプル</a></li>
- <li><a href="?page=Tutorial.CurrencyConverter">通貨コンバーター</a></li>
- <li><a href="?page=Tutorial.AddressBook">アドレス帳</a></li>
- <li><a href="?page=Tutorial.AjaxChat">Ajax チャット</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>動作原理</div>
-<ul>
- <li><a href="?page=Fundamentals.Architecture">アーキテクチャ</a></li>
- <li><a href="?page=Fundamentals.Components1">コンポーネント</a></li>
- <li><a href="?page=Fundamentals.Controls">コントロール</a></li>
- <li><a href="?page=Fundamentals.Pages">ページ</a></li>
- <li><a href="?page=Fundamentals.Modules">モジュール</a></li>
- <li><a href="?page=Fundamentals.Services">サービス</a></li>
- <li><a href="?page=Fundamentals.Applications">アプリケーション</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>設定</div>
-<ul>
- <li><a href="?page=Configurations.Overview">概観</a></li>
- <li><a href="?page=Configurations.Templates1">テンプレート: パート I</a></li>
- <li><a href="?page=Configurations.Templates2">テンプレート: パート II</a></li>
- <li><a href="?page=Configurations.Templates3">テンプレート: パート III</a></li>
- <li><a href="?page=Configurations.AppConfig">アプリケーション設定</a></li>
- <li><a href="?page=Configurations.PageConfig">ページ設定</a></li>
- <li><a href="?page=Configurations.UrlMapping">URL マッピング (Friendly URLs)</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>コントロールリファレンス</div>
-<ul>
- <li><a href="?page=Controls.Standard">通常コントロール</a></li>
- <li><a href="?page=Controls.Validation">バリデーションコントロール</a></li>
- <li><a href="?page=Controls.List">リストコントロール</a></li>
- <li><a href="?page=Controls.Data">データコントロール</a></li>
- <li><a href="?page=ActiveControls.Home">アクティブコントロール (AJAX)</a></li>
- <li><a href="?page=Controls.NewControl">独自のコントロールを作成する</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>サービスリファレンス</div>
-<ul>
- <li><a href="?page=Fundamentals.Services">ページサービス</a></li>
- <li><a href="?page=Services.SoapService">SOAP サービス</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>データベース連携</div>
-<ul>
- <li><a href="?page=Database.DAO">データアクセスオブジェクト</a></li>
- <li><a href="?page=Database.ActiveRecord">アクティブレコード</a></li>
- <li><a href="?page=Database.Scaffold">アクティブレコードScaffold</a></li>
- <li><a href="?page=Database.SqlMap">SqlMapデータマッパー</a></li>
- <li><a href="?page=Database.ViewsArUpdate">ビュー - ARクラスのアップデート</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>上級者向けトピック</div>
-<ul>
- <li><a href="?page=Advanced.Collections">コレクション</a></li>
- <li><a href="?page=Advanced.Auth">認証と承認</a></li>
- <li><a href="?page=Advanced.Security">セキュリティ</a></li>
- <li><a href="?page=Advanced.Assets">アセット</a></li>
- <li><a href="?page=Advanced.MasterContent">マスター/コンテンツ</a></li>
- <li><a href="?page=Advanced.Themes">テーマとスキン</a></li>
- <li><a href="?page=Advanced.State">状態の保存</a></li>
- <li><a href="?page=Advanced.Logging">ロギング</a></li>
- <li><a href="?page=Advanced.Error">エラーハンドリングとエラーレポート</a></li>
- <li><a href="?page=Advanced.I18N">国際化対応</a></li>
- <li><a href="?page=Advanced.Performance">パフォーマンスチューニング</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>クライアントサイドスクリプト</div>
-<ul>
- <li><a href="?page=Advanced.Scripts">Javascript 使用方法</a></li>
- <li><a href="?page=Advanced.Scripts1">Prototype ライブラリ パート I</a></li>
- <li><a href="?page=Advanced.Scripts2">Prototype ライブラリ パート II</a></li>
- <li><a href="?page=Advanced.Scripts3">Javascript クックブック</a></li>
-</ul>
-</div>
-
-</div>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/pl/Layout.tpl b/demos/quickstart/protected/controls/pl/Layout.tpl deleted file mode 100755 index 7fd86713..00000000 --- a/demos/quickstart/protected/controls/pl/Layout.tpl +++ /dev/null @@ -1,61 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" >
-
-<com:THead Title="PRADO QuickStart Tutorial">
-<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
-<meta http-equiv="content-language" content="en"/>
-</com:THead>
-
-<body>
-<com:TForm>
-<div id="header">
-<div class="title">Prado QuickStart Tutorial</div>
-<div class="image"></div>
-</div>
-
-<com:TPanel ID="MainMenu" CssClass="mainmenu">
-<div style="float:left; color:black; margin-top:-5px">
- <com:SearchBox />
-</div>
-<a href="?">Główna</a> |
-<a href="http://www.pradosoft.com">PradoSoft.com</a> |
-<a href="../../docs/quickstart.pdf">wersja PDF</a> |
-<com:THyperLink ID="PrinterLink" Text="wersja do druku" />
-</com:TPanel>
-
-<table width="100%" border="0" cellspacing="0" cellpadding="0">
-<tr>
-<td valign="top" width="1">
-<com:TopicList ID="TopicPanel" />
-</td>
-<td valign="top">
-
-<com:TRepeater ID="languages" OnItemCreated="languageLinkCreated">
- <prop:HeaderTemplate>
- <div class="languages">Dostępne języki: <ul>
- </prop:HeaderTemplate>
- <prop:ItemTemplate>
- <li><com:THyperLink ID="link" Text=<%# $this->DataItem %> /></li>
- </prop:ItemTemplate>
- <prop:FooterTemplate>
- </ul></div>
- </prop:FooterTemplate>
-</com:TRepeater>
-<div id="content">
-<p class="block-content" id="top-content" style="border-color: transparent; height:1px; margin: 0; padding: 0; background-color: transparent"></p>
-<com:TContentPlaceHolder ID="body" />
-</div>
-</td>
-</tr>
-</table>
-
-<div id="footer">
-Copyright © 2005-2007 <a href="http://www.pradosoft.com">PradoSoft</a>.
-<br/><br/>
-<%= Prado::poweredByPrado() %>
-<a href="http://validator.w3.org/check?uri=referer"><img border="0" src="http://www.w3.org/Icons/valid-xhtml10" alt="Valid XHTML 1.0 Transitional" height="31" width="88" /></a>
-</div>
-
-</com:TForm>
-</body>
-</html>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/pl/RequiresVersion.tpl b/demos/quickstart/protected/controls/pl/RequiresVersion.tpl deleted file mode 100755 index 01e70c43..00000000 --- a/demos/quickstart/protected/controls/pl/RequiresVersion.tpl +++ /dev/null @@ -1 +0,0 @@ -<p class="requires-version">Wymaga PRADO w wersji <strong><%= $this->Version %></strong> lub wyższej.</p>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/pl/SearchBox.tpl b/demos/quickstart/protected/controls/pl/SearchBox.tpl deleted file mode 100755 index a00cbd72..00000000 --- a/demos/quickstart/protected/controls/pl/SearchBox.tpl +++ /dev/null @@ -1,3 +0,0 @@ -<com:TLabel ForControl="search" Text="Szukaj:" CssClass="searchLabel"/>
-<com:TTextBox ID="search" OnTextChanged="doSearch" CssClass="searchBox"/>
-<com:TButton ID="find" Text="Znajdź" OnClick="doSearch" CssClass="searchButton"/>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/pl/SinceVersion.tpl b/demos/quickstart/protected/controls/pl/SinceVersion.tpl deleted file mode 100755 index 46cc1211..00000000 --- a/demos/quickstart/protected/controls/pl/SinceVersion.tpl +++ /dev/null @@ -1 +0,0 @@ -<p class="since-version">Dostępny(a) w PRADO od wersji <strong><%= $this->Version %></strong> i dalej.</p>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/pl/TopicList.tpl b/demos/quickstart/protected/controls/pl/TopicList.tpl deleted file mode 100644 index a494d94e..00000000 --- a/demos/quickstart/protected/controls/pl/TopicList.tpl +++ /dev/null @@ -1,111 +0,0 @@ -<div id="toc">
-
-<div class="topic">
-<div>Rozpoczynamy</div>
-<ul>
- <li><a href="?page=GettingStarted.Introduction">Wprowadzenie</a></li>
- <li><a href="?page=GettingStarted.AboutPrado">Czym jest PRADO?</a></li>
- <li><a href="?page=GettingStarted.Installation">Instalacja</a></li>
- <li><a href="?page=GettingStarted.NewFeatures">Nowe możliwości</a></li>
- <li><a href="?page=GettingStarted.Upgrading">Aktualizacja z wersji 2.x oraz 1.x</a></li>
- <li><a href="?page=GettingStarted.Wsat">Web Site Administration Tool</a></li>
- <li><a href="?page=GettingStarted.CommandLine">Command Line Tool</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Tutoriale</div>
-<ul>
- <li><a href="?page=GettingStarted.HelloWorld">Tworzenie pierwszej aplikacji PRADO</a></li>
- <li><a href="?page=Fundamentals.Hangman">Przykład: gra wisielec</a></li>
- <li><a href="?page=Tutorial.CurrencyConverter">Konwenter walut</a></li>
- <li><a href="?page=Tutorial.AddressBook">Książka adresowa</a></li>
- <li><a href="?page=Tutorial.AjaxChat">AJAX-owy klient czat</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Postawy</div>
-<ul>
- <li><a href="?page=Fundamentals.Architecture">Architektura</a></li>
- <li><a href="?page=Fundamentals.Components1">Komponenty</a></li>
- <li><a href="?page=Fundamentals.Controls">Kontrolki</a></li>
- <li><a href="?page=Fundamentals.Pages">Strony</a></li>
- <li><a href="?page=Fundamentals.Modules">Moduły</a></li>
- <li><a href="?page=Fundamentals.Services">Serwisy</a></li>
- <li><a href="?page=Fundamentals.Applications">Applicacje</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Konfiguracja</div>
-<ul>
- <li><a href="?page=Configurations.Overview">Przegląd</a></li>
- <li><a href="?page=Configurations.Templates1">Szablony: część I</a></li>
- <li><a href="?page=Configurations.Templates2">Szablony: część II</a></li>
- <li><a href="?page=Configurations.Templates3">Szablony: część III</a></li>
- <li><a href="?page=Configurations.AppConfig">Konfiguracja aplikacji</a></li>
- <li><a href="?page=Configurations.PageConfig">Konfiguracja strony</a></li>
- <li><a href="?page=Configurations.UrlMapping">Mapowanie adresów URL (Przyjazne URL-e)</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Informacje o kontrolkach</div>
-<ul>
- <li><a href="?page=Controls.Standard">Kontrolki standardowe</a></li>
- <li><a href="?page=Controls.Validation">Kontrolki walidujące</a></li>
- <li><a href="?page=Controls.List">Kontrolki listujące</a></li>
- <li><a href="?page=Controls.Data">Kontrolki danych</a></li>
- <li><a href="?page=ActiveControls.Home">Kontrolki aktywne (AJAX)</a></li>
- <li><a href="?page=Controls.NewControl">Tworzenie nowych kontrolek</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Informacje o usługach</div>
-<ul>
- <li><a href="?page=Fundamentals.Services">Usługa strony [Page Service]</a></li>
- <li><a href="?page=Services.SoapService">Usługa SOAP [SOAP Service]</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Operacje na bazach dancyh</div>
-<ul>
- <li><a href="?page=Database.DAO">Data Access Objects</a></li>
- <li><a href="?page=Database.ActiveRecord">Rekord aktywny (Active Record)</a></li>
- <li><a href="?page=Database.Scaffold">Szkielet rekordu aktywnego (Scafold)</a></li>
- <li><a href="?page=Database.SqlMap">Mapa danych SqlMap</a></li>
- <li><a href="?page=Database.ViewsArUpdate">Widoki - Zajęcia AR Aktualizacja</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Zaawansowane tematy</div>
-<ul>
- <li><a href="?page=Advanced.Collections">Kolekcje</a></li>
- <li><a href="?page=Advanced.Auth">Autentykacja i autoryzacja</a></li>
- <li><a href="?page=Advanced.Security">Bezpieczeńswo</a></li>
- <li><a href="?page=Advanced.Assets">Assets</a></li>
- <li><a href="?page=Advanced.MasterContent">Master and Content</a></li>
- <li><a href="?page=Advanced.Themes">Tematy oraz skórki</a></li>
- <li><a href="?page=Advanced.State">Stan ustalony [Persistent State]</a></li>
- <li><a href="?page=Advanced.Logging">Wpisywanie do dziennika [logging]</a></li>
- <li><a href="?page=Advanced.Error">Obsługa i raportowanie błędów</a></li>
- <li><a href="?page=Advanced.I18N">Internationalizacja</a></li>
- <li><a href="?page=Advanced.Performance">Zwiększanie wydajności</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>Skrypty po stronie klienta</div>
-<ul>
- <li><a href="?page=Advanced.Scripts">Wprowadznie do Javascript</a></li>
- <li><a href="?page=Advanced.Scripts1">Biblioteka Prototype część I</a></li>
- <li><a href="?page=Advanced.Scripts2">Biblioteka Prototype część II</a></li>
- <li><a href="?page=Advanced.Scripts3">Książka z przepisami Javascript</a></li>
-</ul>
-</div>
-
-</div>
\ No newline at end of file diff --git a/demos/quickstart/protected/controls/zh/TopicList.tpl b/demos/quickstart/protected/controls/zh/TopicList.tpl deleted file mode 100644 index 73e1d5a8..00000000 --- a/demos/quickstart/protected/controls/zh/TopicList.tpl +++ /dev/null @@ -1,110 +0,0 @@ -<div id="toc">
-
-<div class="topic">
-<div>PRADO初步</div>
-<ul>
- <li><a href="?page=GettingStarted.Introduction">概况</a></li>
- <li><a href="?page=GettingStarted.AboutPrado">什么是PRADO？</a></li>
- <li><a href="?page=GettingStarted.Installation">安装</a></li>
- <li><a href="?page=GettingStarted.NewFeatures">版本新功能</a></li>
- <li><a href="?page=GettingStarted.Upgrading">从v2.x和v1.x升级</a></li>
- <li><a href="?page=GettingStarted.Wsat">Web Site Administration Tool</a></li>
- <li><a href="?page=GettingStarted.CommandLine">Command Line Tool</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>范例教程</div>
-<ul>
- <li><a href="?page=GettingStarted.HelloWorld">创建第一个PRADO应用</a></li>
- <li><a href="?page=Fundamentals.Hangman">Hangman游戏</a></li>
- <li><a href="?page=Tutorial.CurrencyConverter">货币转换程序</a></li>
- <li><a href="?page=Tutorial.AjaxChat">AJAX聊天程序</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>基础概念</div>
-<ul>
- <li><a href="?page=Fundamentals.Architecture">框架结构</a></li>
- <li><a href="?page=Fundamentals.Components1">部件</a></li>
- <li><a href="?page=Fundamentals.Controls">控件</a></li>
- <li><a href="?page=Fundamentals.Pages">页面</a></li>
- <li><a href="?page=Fundamentals.Modules">模块</a></li>
- <li><a href="?page=Fundamentals.Services">服务</a></li>
- <li><a href="?page=Fundamentals.Applications">应用</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>各种配置</div>
-<ul>
- <li><a href="?page=Configurations.Overview">概况</a></li>
- <li><a href="?page=Configurations.Templates1">模板（1）</a></li>
- <li><a href="?page=Configurations.Templates2">模板（2）</a></li>
- <li><a href="?page=Configurations.Templates3">模板（3）</a></li>
- <li><a href="?page=Configurations.AppConfig">应用配置</a></li>
- <li><a href="?page=Configurations.PageConfig">页面配置</a></li>
- <li><a href="?page=Configurations.UrlMapping">URL映射</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>控件使用参考</div>
-<ul>
- <li><a href="?page=Controls.Standard">基本控件</a></li>
- <li><a href="?page=Controls.Validation">验证控件</a></li>
- <li><a href="?page=Controls.List">列表控件</a></li>
- <li><a href="?page=Controls.Data">数据控件</a></li>
- <li><a href="?page=ActiveControls.Home">Active控件（AJAX)</a></li>
- <li><a href="?page=Controls.NewControl">创建新控件</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>服务使用参考</div>
-<ul>
- <li><a href="?page=Fundamentals.Services">页面服务</a></li>
- <li><a href="?page=Services.SoapService">SOAP服务</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>使用数据库</div>
-<ul>
- <li><a href="?page=Database.DAO">数据存取对象（DAO）</a></li>
- <li><a href="?page=Database.ActiveRecord">Active Record</a></li>
- <li><a href="?page=Database.Scaffold">Active Record Scaffold</a></li>
- <li><a href="?page=Database.SqlMap">SqlMap Data Mapper</a></li>
- <li><a href="?page=Database.ViewsArUpdate">意見 - AR類更新</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>高级教程</div>
-<ul>
- <li><a href="?page=Advanced.Collections">Collections</a></li>
- <li><a href="?page=Advanced.Auth">验证和授权</a></li>
- <li><a href="?page=Advanced.Security">安全</a></li>
- <li><a href="?page=Advanced.Assets">资源</a></li>
- <li><a href="?page=Advanced.MasterContent">Master and Content</a></li>
- <li><a href="?page=Advanced.Themes">Themes and Skins</a></li>
- <li><a href="?page=Advanced.State">Persistent State</a></li>
- <li><a href="?page=Advanced.Logging">日志</a></li>
- <li><a href="?page=Advanced.Error">错误处理</a></li>
- <li><a href="?page=Advanced.I18N">多语言支持</a></li>
- <li><a href="?page=Advanced.Performance">Performance Tuning</a></li>
-</ul>
-</div>
-
-<div class="topic">
-<div>客户端编程</div>
-<ul>
- <li><a href="?page=Advanced.Scripts">JavaScript介绍</a></li>
- <li><a href="?page=Advanced.Scripts1">Prototype Library Part I</a></li>
- <li><a href="?page=Advanced.Scripts2">Prototype Library Part II</a></li>
- <li><a href="?page=Advanced.Scripts3">Javascript Cookbook</a></li>
-</ul>
-</div>
-
-</div>
\ No newline at end of file diff --git a/demos/quickstart/protected/pages/ActiveControls/ActiveRatingList.page b/demos/quickstart/protected/pages/ActiveControls/ActiveRatingList.page index 7b6fb83d..fa0e25c4 100644 --- a/demos/quickstart/protected/pages/ActiveControls/ActiveRatingList.page +++ b/demos/quickstart/protected/pages/ActiveControls/ActiveRatingList.page @@ -1,6 +1,6 @@ <com:TContent ID="body" > -<h1>TActiveRatingList</h1> +<h1 id="192015">TActiveRatingList</h1> <com:DocLink ClassPath="System.Web.UI.ActiveControls.TActiveRatingList" /> <p class="block-content"> diff --git a/demos/quickstart/protected/pages/ActiveControls/Introduction.page b/demos/quickstart/protected/pages/ActiveControls/Introduction.page index edc0b5bc..275da737 100755 --- a/demos/quickstart/protected/pages/ActiveControls/Introduction.page +++ b/demos/quickstart/protected/pages/ActiveControls/Introduction.page @@ -9,7 +9,7 @@ A classic webpage can only transfer data back to the server using an http postba A common solution to this problem is the use of AJAX (Asynchronous JavaScript and XML) callbacks. After the first full page load, the web application can make subsequents requests using javascript. The callback requests are asynchronous, so the user can continue to interact with the page while the response is loading. The response contains a list of changes that will be applied to the page "on the fly", like replacing existing elements with new content or add some css style to an existing element.
</p>
-<h2>Interacting with a page on callback</h2>
+<h2 id="222017">Interacting with a page on callback</h2>
<p class="block-content">
PRADO has builtin support for AJAX callbacks in the form of <i>Active Controls</i>. These controls can trigger a callback request and have their properties (value, css style, attributes, ..) updated during a callback.
@@ -28,7 +28,7 @@ public function onClick($sender, $param) }
</com:TTextHighlighter>
-<h1>Active Controls (AJAX enabled Controls)</h1>
+<h1 id="222016">Active Controls (AJAX enabled Controls)</h1>
<p class="block-content">
Active controls extends standard PRADO controls adding the ability to automatically update themselves on callbacks without the need of ad-hoc javascript calls. Active controls are reliant on a collection of javascript classes that gets added to the page automatically when needed.
</p>
diff --git a/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveHyperLink/Home.page b/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveHyperLink/Home.page index a7767e2d..f0328316 100755 --- a/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveHyperLink/Home.page +++ b/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveHyperLink/Home.page @@ -10,8 +10,8 @@ A regular hyperlink: Welcome to
<com:TActiveHyperLink
ID="link1"
- NavigateUrl="http://www.pradosoft.com/"
- Text="PradoSoft.com"
+ NavigateUrl="https://github.com/pradosoft/prado"
+ Text="Prado framework"
Target="_blank" />.
</td>
<td class="sampleaction">
@@ -25,8 +25,8 @@ A text hyperlink with css style: Welcome to
<com:TActiveHyperLink
ID="link2"
- NavigateUrl="http://www.pradosoft.com/"
- Text="PradoSoft.com"
+ NavigateUrl="https://github.com/pradosoft/prado"
+ Text="Prado framework"
Target="_blank"
BackColor="silver"
Font.Italic="true" />.
@@ -41,7 +41,7 @@ An image hyperlink: </td><td class="sampleaction">
<com:TActiveHyperLink
ID="link3"
- NavigateUrl="http://www.pradosoft.com/"
+ NavigateUrl="https://github.com/pradosoft/prado"
ImageUrl=<%~hello_world.gif%>
Text="Hello World" />.
</td>
@@ -55,7 +55,7 @@ A hyerplink with body contents as link text: </td><td class="sampleaction">
<com:TActiveHyperLink
ID="link4"
- NavigateUrl="http://www.pradosoft.com/"
+ NavigateUrl="https://github.com/pradosoft/prado"
Target="_blank">
Body contents
</com:TActiveHyperLink>
diff --git a/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveHyperLink/Home.php b/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveHyperLink/Home.php index f70c89b4..6596dca6 100755 --- a/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveHyperLink/Home.php +++ b/demos/quickstart/protected/pages/ActiveControls/Samples/TActiveHyperLink/Home.php @@ -14,7 +14,7 @@ class Home extends TPage function button3_clicked($sender, $param) { - $this->link3->Text = 'PradoSoft.com'; + $this->link3->Text = 'Prado framework'; } function button4_clicked($sender, $param) diff --git a/demos/quickstart/protected/pages/ActiveControls/id/ActiveButton.page b/demos/quickstart/protected/pages/ActiveControls/id/ActiveButton.page deleted file mode 100755 index 60e80bdb..00000000 --- a/demos/quickstart/protected/pages/ActiveControls/id/ActiveButton.page +++ /dev/null @@ -1,77 +0,0 @@ -<com:TContent ID="body"> -<h1 id="122026">TActiveButton</h1> -<com:DocLink ClassPath="System.Web.UI.ActiveControls.TActiveButton" /> - -<p id="610410" class="block-content"><tt>TActiveButton</tt> adalah kontrol aktif selain -<a href="?page=Controls.Button">TButton</a>. -Ketika <tt>TActiveButton</tt> diklik pada permintaan postback normal, permintaan callback yang diinisiasi. Event <tt>OnCallback</tt> dimunculkan selama permintaan callback dan dimunculkan <strong>setelah</strong> event <tt>OnClick</tt>. -</p> - -<p id="610411" class="block-content">Ketika properti <tt>ActiveControl.EnableUpdate</tt> adalah true, -mengubah properti <tt>Text</tt> selama permintaan callback akan memutakhirkan -judul tombol pada sisi-klien.</p> - -<p id="610412" class="block-content">Karena event <tt>OnCallback</tt> hanya dimunculkan selama permintaan callback, pengendali event <tt>OnCallback</tt> bisa dipakai untuk menangani logika terutama yang terkait dengan permintaan callback. Pengendali event <tt>OnClick</tt> dimunculkan kapan saja tombol diklik, meskipun javascript dimatikan.</p> - -<p id="610413" class="block-content">Contoh berikut menggunakan kedua event <tt>OnClick</tt> dan <tt>OnCallback</tt> dari <tt>TActiveButton</tt>.</p> - -<com:RunBar PagePath="ActiveControls.Samples.TActiveButton.Home" /> - -<h2 id="122027">Diagram Kelas TActiveButton</h2> -<p id="610414" class="block-content">Diagram kelas untuk <tt>TActiveButton</tt> diilustrasikan dalam gambar berikut. -Banyak kontrol aktif yang melakukan permintaan callback mempunyai struktur yang mirip. -</p> - -<img src=<%~ TActiveButtonClass.png %> class="figure" - alt="TActiveButton class diagram" title="Diagram kelas TActiveButton" /> - -<p id="610415" class="block-content"><tt>TActiveButton</tt> adalah ekstensi dari <a href="?page=Controls.Button">TButton</a> dan mengimplementasikan dua antarmuka tambahan <tt>ICallbackEventHandler</tt> dan -<tt>IActiveControl</tt>. <tt>TActiveButton</tt> berisi turunan dari -<a href="?page=ActiveControls.BaseActiveControl">TBaseActiveCallbackControl</a> -yang tersedia melalui properti <tt>ActiveControl</tt> dari <tt>TActiveButton</tt>. -Contoh berikut menyetel parameter callback atas <tt>TActiveButton</tt> saat -permintaan callback ditampung. -</p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code1"> -<com:TActiveButton - Text="Click Me" - OnCallback="button_callback" - ActiveControl.CallbackParameter="value" /> -</com:TTextHighlighter> -<p id="610416" class="block-content">Dalam metode pengendali event <tt>OnCallback</tt>, <tt>CallbackParameter</tt> tersedua di dalam obyek <tt>$param</tt>.</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code2"> -public function button_callback($sender, $param) -{ - echo $param->CallbackParameter; //mengeluarkan "value" -} -</com:TTextHighlighter> - -<h2 id="122028">Menambah Perilaku Sisi Klien</h2> - -<p id="610417" class="block-content">Di dalam properti <tt>ActiveControl</tt> adalah turunan dari -<a href="?page=ActiveControls.CallbackClientSide">TCallbackClientSide</a> yang tersedia sebagai <tt>ClientSide</tt> dari <tt>TActiveButton</tt>. -Properti <tt>ClientSide</tt> berisi sub-properti, serperti <tt>RequestTimeOut</tt>, dan pengendali event javascript sisi-klien, seperti <tt>OnLoading</tt>, dipakai oleh sisi-klien saat membuat permitaan callback. -Contoh berikut mendemonstrasikan menghidup matikan indikator "loading" saat sisi-klien -membuat permintaan callback. -</p> - -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code3"> -<com:TClientScript PradoScripts="effects" /> -<span id="callback_status">Loading...</span> - -<com:TActiveButton - Text="Click Me" - OnCallback="button_callback" - ActiveControl.CallbackParameter="value" > - <prop:ClientSide - OnLoading="Element.show('callback_status')" - OnComplete="Element.hide('callback_status')" /> -</com:TActiveButton> -</com:TTextHighlighter> - -<p id="610418" class="block-content">Contoh ini mengambil librari javascript "effects" menggunakan komponen -<a href="?page=Controls.ClientScript">TClientScript</a>. -Nilai properti <tt>ClientSide.OnLoading</tt> berisi pernyataan javascript yang menggunakan librari "effects" untuk menampilkan tag span "Loading...". Hal yang mirip, nilai properti <tt>ClientSide.OnComplete</tt> berisi pernyataan javascript yang menyembunyikan tag span "Loading...". -Lihat <a href="?page=ActiveControls.CallbackClientSide">TCallbackClientSide</a> untuk rincian lebih jelas pada detil properti sisi-klien. -</p> -</com:TContent> diff --git a/demos/quickstart/protected/pages/ActiveControls/id/ActiveCheckBox.page b/demos/quickstart/protected/pages/ActiveControls/id/ActiveCheckBox.page deleted file mode 100755 index e1f11e99..00000000 --- a/demos/quickstart/protected/pages/ActiveControls/id/ActiveCheckBox.page +++ /dev/null @@ -1,21 +0,0 @@ -<com:TContent ID="body"> -<h1 id="124029">TActiveCheckBox</h1> -<com:DocLink ClassPath="System.Web.UI.ActiveControls.TActiveCheckBox" /> - -<p id="620419" class="block-content"> -<tt>TActiveCheckBox</tt> adalah kontrol aktif selain -<a href="?page=Controls.CheckBox">TCheckbox</a>. Properti <tt>AutoPostBack</tt> - dari <tt>TActiveCheckBox</tt> standarnya disetel true. - Selanjutnya, saat kotak centang diklik, event <tt>OnCallback</tt> muncul setelah event <tt>OnCheckedChanged</tt>. - </p> - - <p id="620420" class="block-content"> - Properti <tt>Text</tt> dan <tt>Checked</tt> dari <tt>TActiveCheckBox</tt> - bisa diubah selama permintaan callback. Properti <tt>TextAlign</tt> dari - <tt>TActiveCheckBox</tt> <strong>tidak bisa</strong> diubah saat permintaan - callback. -</p> - -<com:RunBar PagePath="ActiveControls.Samples.TActiveCheckBox.Home" /> - -</com:TContent> diff --git a/demos/quickstart/protected/pages/ActiveControls/id/ActiveCustomValidator.page b/demos/quickstart/protected/pages/ActiveControls/id/ActiveCustomValidator.page deleted file mode 100755 index cc089757..00000000 --- a/demos/quickstart/protected/pages/ActiveControls/id/ActiveCustomValidator.page +++ /dev/null @@ -1,22 +0,0 @@ -<com:TContent ID="body"> -<h1 id="126030">TActiveCustomValidator</h1> -<com:DocLink ClassPath="System.Web.UI.ActiveControls.TActiveCustomValidator" /> - -<p id="630421" class="block-content">Melakukan validasi kustom hanya menggunakan event validasi <tt>OnServerValidate</tt> - sisi-server. Sisi-klien menggunakan callback untuk memunculkan event - <tt>onServerValidate</tt>. Properti <tt>ClientValidationFunction</tt> dimatikan - dan akan mengeluarkan eksepsi jika mencoba untuk menyetel properti ini. -</p> - -<p id="630422" class="block-content"> Harap berhati-hati <tt>onServerValidate</tt> dapat -dimunculkan saat kontrol yang divalidasi pada sisi klien mengubah nilai, -yaitu validasi server mungkin dipanggil berkali-kali. - -Setelah callback atau postback, {@link onServerValidate onServerValidate} -dimunculkan hanya sekali. Properti <tt>IsCallback</tt> dari kelas <tt>TPage</tt> -menjadi true ketika validasi dibuat selama permintaan callback. -</p> - -<com:RunBar PagePath="ActiveControls.Samples.TActiveCustomValidator.Home" /> - -</com:TContent> diff --git a/demos/quickstart/protected/pages/ActiveControls/id/ActiveHyperLink.page b/demos/quickstart/protected/pages/ActiveControls/id/ActiveHyperLink.page deleted file mode 100755 index 5fe3f84a..00000000 --- a/demos/quickstart/protected/pages/ActiveControls/id/ActiveHyperLink.page +++ /dev/null @@ -1,14 +0,0 @@ -<com:TContent ID="body">
-<h1 id="ActiveHyperLink">TActiveHyperLink</h1>
-<com:DocLink ClassPath="System.Web.UI.ActiveControls.TActiveHyperLink" />
-
-<p>
-Kontrol aktif selain komponen <a href="?page=Controls.HyperLink">THyperLink</a>.
-Saat permintaan callback, perubahan terhadap properti <tt>Text</tt>, <tt>ImageUrl</tt>,
-<tt>NavigateUrl</tt> dan <tt>Target</tt> pada sisi server juga akan
-mengubah atribut serta konten terkait di sisi-klien.
-</p>
-
-<com:RunBar PagePath="ActiveControls.Samples.TActiveHyperLink.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/ActiveControls/id/ActivePager.page b/demos/quickstart/protected/pages/ActiveControls/id/ActivePager.page deleted file mode 100755 index f61701f2..00000000 --- a/demos/quickstart/protected/pages/ActiveControls/id/ActivePager.page +++ /dev/null @@ -1,40 +0,0 @@ -<com:TContent ID="body" > - -<h1 id="3901">TActivePager</h1> -<com:DocLink ClassPath="System.Web.UI.WebControls.TPager" /> - -<p id="450300" class="block-content"> -<tt>TActivePager</tt> membuat halaman yang menyediakan UI untuk pengguna-akhir secara interaktif menetapkan halaman data mana yang di render dalam kontrol turunan <tt>TDataBoundControl</tt>, seperti <tt>TDataList</tt>, <tt>TRepeater</tt>, <tt>TCheckBoxList</tt>, dll. -Target kontrol data-bound ditetapkan dengan properti <tt>ControlToPaginate</tt>, yang harus berupa path ID dari kontrol target yang diambil dari kontainer penamaan halaman. Target-databound harus berada di dalam <tt>TActivePanel</tt> agar dapat di render ulang selama callback -</p> - -<p id="450301" class="block-content"> -Catatan, kontrol target data-bound harus disetel true pada <tt>AllowPaging</tt>. Sebaliknya halaman tidak akan terlihat. Juga, dalam hal ketika hanya satu halaman data yang tersedia, halaman juga tidak akan terlihat. -</p> - -<p id="450302" class="block-content"> -<tt>TActivePager</tt> dapat menampilkan salah satu dari tiga jenis antarmuka, ditetapkan melalui properti <tt>Mode</tt>: -</p> -<ul id="u1" class="block-content"> -<li><tt>NextPrev</tt> - tombol halaman berikutnya dan sebelumnya yang dihasilkan pada setiap halaman.</li> -<li><tt>Numeric</tt> - daftar tombol indeks halaman yang dihasilkan.</li> -<li><tt>DropDownList</tt> - daftar dropdown indeks halaman yang dihasilkan.</li> -</ul> -<p id="450303" class="block-content"> -Antar muka pengguna ini selanjutnya dikustomisasi dengan mengkonfigurasi properti berikut -</p> -<ul id="u2" class="block-content"> -<li><tt>NextPageText</tt> dan <tt>PrevPageText</tt> - label tombol halaman berikutnya/sebelumnya. Properti ini dipakai saat <tt>Mode</tt> halaman adalah <tt>NextPrev</tt> atau <tt>Numeric</tt>.</li> -<li><tt>FirstPageText</tt> dan <tt>LastPageText</tt> - label tombol halaman pertama/terakhir. Jika kosong, tombol terkait tidak akan ditampilkan. Properti ini dipakai saat <tt>Mode</tt> halaman adalah <tt>NextPrev</tt> atau <tt>Numeric</tt>.</li> -<li><tt>PageButtonCount</tt> - jumlah maksimum tombol indeks pada halaman. Properti ini dipakai saat <tt>Mode</tt> halaman adalah <tt>Numeric</tt>.</li> -<li><tt>ButtonType</tt> - jenis tombol halaman, baik <tt>PushButton</tt> yang berarti tombol submisi formulir normal, ataupun <tt>LinkButton</tt> yang berarti tombol hiperlink.</li> -</ul> - -<p id="450304" class="block-content"> -<tt>TActivePager</tt> memunculkan event <tt>OnPageIndexChanged</tt> ketika pengguna-akhir berinteraksi dengannya dan menetapkan halaman baru (misalnya dengan mengklik pada tombol halaman berikutnya yang akan membawa ke halaman berikutnya.) Para pengembang dapat menulis pengendali untuk merespon indeks halaman baru ini dan mendapatkan indeks halaman baru yang diinginkan dari properti parameter event <tt>NewPageIndex</tt>. Menggunakan indeks halaman baru ini, seseorang dapat memask halaman baru data ke kontrol data-bound terkait. -Sebagai tambahan, <tt>TActivePager</tt> memunculkan <tt>OnCallback</tt> setelah <tt>OnPageIndexChanged</tt>. -</p> - -<com:RunBar PagePath="ActiveControls.Samples.TActivePager.Home" /> - -</com:TContent> diff --git a/demos/quickstart/protected/pages/ActiveControls/id/Home.page b/demos/quickstart/protected/pages/ActiveControls/id/Home.page deleted file mode 100755 index af449d7a..00000000 --- a/demos/quickstart/protected/pages/ActiveControls/id/Home.page +++ /dev/null @@ -1,347 +0,0 @@ -<com:TContent ID="body" > -<h1 id="128031">Kontrol Aktif (kontrol AJAX-dihidupkan)</h1> -<p id="640423" class="block-content">Lihat <a href="?page=ActiveControls.Introduction">Pengenalan</a> -untuk tinjauan cepat terhadap konsep di belakang kontrol aktif (kontrol AJAX-dihidupkan). -Banyak kontrol aktif memiliki properti -<a href="?page=ActiveControls.BaseActiveControl">ActiveControl</a> dan -sub-properti <a href="?page=ActiveControls.CallbackClientSide">ClientSide</a> -yang menyediakan banyak properti untuk mengkustomisasi kontrol. Properti -<a href="?page=TCallbackClientScript">CallbackClient</a> dari kelas -<tt>TPage</tt> menyediakan metode untuk memutakhirkan dan mengubah konten sisi-klien -saat permintaan callback. Kontrol aktif bergantung pada koleksi -<a href="?page=ActiveControl.ClientSideJavascript">kelas javascript</a>. -</p> - -<p id="640424" class="block-content">Untuk demo cepat atas kontrol aktif, coba kontrol <a href="?page=ActiveControls.ActiveButton"> -TActiveButton</a>. Lihat juga bagian akhir dari tutorial <a href="?page=Tutorial.CurrencyConverter">Pengubah Kurs</a> untuk contoh lebih mendalam. -</p> - -<p id="640425" class="block-content">* tutorial untuk kontrol ini belum lengkap.</p> - -<h2 id="128032">Kontrol Aktif Standar</h2> -<ul id="u1" class="block-content"> - <li> - <a href="?page=ActiveControls.ActiveButton">TActiveButton</a> - mewakili tombol klik pada halaman Web. Ia dapat dipakai untuk memicu permintaan callback. - </li> - - <li> - <a href="?page=ActiveControls.ActiveCheckBox">TActiveCheckBox</a> - mewakili kotak centang pada halaman Web. Ia dapat dipakai untuk mengoleksi input dua-kondisi pengguna - serta memicu permintaan callback. - </li> - - <li> - <a href="?page=ActiveControls.ActiveCustomValidator">TActiveCustomValidator</a> - memvalidasi kontrol tertentu menggunakan permintaan callback. - </li> - - <li> - <a href="?page=ActiveControls.ActiveHyperLink">TActiveHyperLink</a> - mewakili hiperlink pada halaman Web. - </li> - - <li> - <a href="?page=ActiveControls.ActiveImage">TActiveImage</a> - mewakili gambar pada halaman Web. - </li> - - <li> - <a href="?page=ActiveControls.ActiveImageButton">TActiveImageButton</a> - mewakili tombol klik yang mempunyai gambar sebagai latar belakangnya. - Ia bisa dipakai untuk memicu permintaan callback. - </li> - - <li> - <a href="?page=ActiveControls.ActiveLabel">TActiveLabel</a> - mewakili label pada halam Web. - Label dapat dikustomisasi melalui berbagai atribut CSS. - </li> - - <li> - <a href="?page=ActiveControls.ActiveLinkButton">TActiveLinkButton</a> - mewakili hiperlink yang bisa melalukan permintaan callback. - </li> - - <li> - <a href="?page=ActiveControls.ActivePanel">TActivePanel</a> - mewakili penampung untuk kontrol lain pada halaman Web. Dalam HTML, - ia ditampilkan sebagai elemen <div>. Kontrol pabel dapat - diganti selama permintaan callback. - </li> - - <li> - <a href="?page=ActiveControls.ActiveRadioButton">TActiveRadioButton</a> - mewakili tombol radio pada halaman Web. - Dipakai terutama dalam sebuah grup di mana pengguna bisa memilih. Ini - dapat digunakan untuk melakukan permintaan callback. - </li> - - <li> - <a href="?page=ActiveControls.ActiveTextBox">TActiveTextBox</a> - mewakili field input teks pada halaman Web. - Ia bisa mengoleksi satu-baris, multi-baris atau input teks sandi dari pengguna. - Ia bisa dipakai untuk melakukan permintaan callback. - </li> - - <li> - <a href="?page=ActiveControls.CallbackOptions">TCallbackOptions</a> - opsi callback seperti pengendali event sisi-klien <tt>OnLoading</tt>. - </li> - -</ul> - -<h2 id="128033">Kontrol List Aktif</h2> -<ul id="u2" class="block-content"> - <li> - <a href="?page=ActiveControls.ActiveCheckBoxList">TActiveCheckBoxList</a> - menampilkan daftar kotak centang pada halaman Web dan setiap kotak centang - dapat memicu permintaan callback. - </li> - - <li> - <a href="?page=ActiveControls.ActiveDropDownList">TActiveDropDownList</a> - menampilkan kotak daftar dropdown yang membolehkan para pengguna untuk memilih - satu opsi dari beberapa yang telah ditetapkan. Dapat dipakai untuk melakukan - permintaan callback. - </li> - - <li> - <a href="?page=ActiveControls.ActiveListBox">TActiveListBox</a> - menampilkan kotak daftar yang membolehkan satu pilihan atau multipel. Dapat - dipakai untuk melakukan permintaan callback. - </li> - - <li> - <a href="?page=ActiveControls.ActiveRadioButtonList">TActiveRadioButtonList</a> - mirip dengan TActiveCheckBoxList dalam setiap aspek kecuali bahwa setiap - TActiveRadioButtonList menampilkan sebuah grup tombol radio. Setiap tombol radio - dapat melakukan permintaan callback. - </li> -</ul> - -<h2 id="128034">Kontrol Aktif Diperluas</h2> - - -<ul id="u3" class="block-content"> - <li> - <a href="?page=ActiveControls.AutoComplete">TAutoComplete</a> - memperluas TActiveTextBox untuk menawarkan saran pelengkapan teks. - </li> - - <li> - <a href="?page=ActiveControls.Callback">TCallback</a> - kontrol generik yang dapat melakukan permintaan callback. - </li> - - <li> - <a href="?page=ActiveControls.EventTriggeredCallback">TEventTriggeredCallback</a> - memicu permintaan callback berdasarkan event DOM HTML. - </li> - - <li> - <a href="?page=ActiveControls.InPlaceTextBox">TInPlaceTextBox</a> - mewakili label yang dapat diedit dengen mengklik. - </li> - - <li> - * <a href="?page=ActiveControls.TimeTriggeredCallback">TTimeTriggeredCallback</a> - memicu permintaan callback berdasarkan waktu yang belalu. - </li> - - <li> - * <a href="?page=ActiveControls.ValueTriggeredCallback">TValueTriggeredCallback</a> - mengawasi (menggunakan timer) atribut elemen HTML dan memicu permintaan callback - ketika nilai atribut berubah. - </li> - -</ul> - -<h2 id="128035">Kemampuan Kontrol Aktif</h2> -<p id="640426" class="block-content">Tabel berikut memperlihatkan Kontrol Aktif yang dapat memicu event callback dan menentukan apakah kontrol akan memunculkan event PostBack atau tidak jika Javascript dimatikan pada browser sisi-klien.</p> -<!-- tabular: align=|l|l|l|, width=(0.35 0.25 0.25) --> -<table class="tabular"> - <tr> - <th>Nama Kontrol</th> - <th>Memicu Callback</th> - <th>Kembali ke PostBack</th> - </tr> - <tr><td> - <a href="?page=ActiveControls.ActiveButton">TActiveButton</a> - </td> - <td>Ya</td> - <td>Ya</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.ActiveCheckBox">TActiveCheckBox</a> - </td> - <td>Ya</td> - <td>Ya</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.ActiveCustomValidator">TActiveCustomValidator</a> - </td> - <td>Ya</td> - <td>Ya</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.ActiveHyperLink">TActiveHyperLink</a> - </td> - <td>Tidak</td><td>Ya</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.ActiveImage">TActiveImage</a> - </td> - <td>Tidak</td><td>Ya</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.ActiveImageButton">TActiveImageButton</a> - </td> - <td>Ya</td><td>Ya</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.ActiveLabel">TActiveLabel</a> - </td> - <td>Tidak</td><td>Ya</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.ActiveLinkButton">TActiveLinkButton</a> - </td> - <td>Ya</td><td>Tidak</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.ActivePanel">TActivePanel</a> - </td> - <td>Tidak</td><td>Ya</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.ActiveRadioButton">TActiveRadioButton</a> - </td> - <td>Ya</td><td>Ya</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.ActiveTextBox">TActiveTextBox</a> - </td> - <td>Ya</td><td>Ya</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.CallbackOptions">TCallbackOptions</a> - </td> - <td>Tidak</td><td>N/A</td> - </tr> - - - <tr><td> - <a href="?page=ActiveControls.ActiveCheckBoxList">TActiveCheckBoxList</a> - </td> - <td>Ya</td><td>Ya</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.ActiveDropDownList">TActiveDropDownList</a> - </td> - <td>Ya</td><td>Ya</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.ActiveListBox">TActiveListBox</a> - </td> - <td>Ya</td><td>Ya</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.ActiveRadioButtonList">TActiveRadioButtonList</a> - </td> - <td>Ya</td><td>Ya</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.AutoComplete">TAutoComplete</a> - </td> - <td>Ya</td> - <td>Tidak</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.Callback">TCallback</a> - </td> - <td>Ya</td><td>Tidak</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.EventTriggeredCallback">TEventTriggeredCallback</a> - </td> - <td>Ya</td><td>Tidak</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.InPlaceTextBox">TInPlaceTextBox</a> - </td> - <td>Ya</td><td>Tidak</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.TimeTriggeredCallback">TTimeTriggeredCallback</a> - </td> - <td>Ya</td><td>Tidak</td> - </tr> - - <tr><td> - <a href="?page=ActiveControls.ValueTriggeredCallback">TValueTriggeredCallback</a> - </td> - <td>Ya</td><td>Tidak</td> - </tr> -</table> - -<h2 id="128036">Kelas Infrastruktur Kontrol Aktif</h2> -<p id="640427" class="block-content">Kelas berikut menyediakan kelas infrastruktur dasar yang diperlukan guna merealisasikan kontrol aktif.</p> -<ul id="u4" class="block-content"> - <li> - <a href="?page=ActiveControls.ActiveControlAdapter">TActiveControlAdapter</a> - melacak nilai viewstate dari kontrol dan memutakhirkan perbedaan pada atribut elemen HTML sisi-klien. - </li> - - <li> - <a href="?page=ActiveControls.ActiveListControlAdapter">TActiveListControlAdapter</a> - membolehkan kontrol list yang diadaptasi untuk mengubah pilihan pada sisi-klien selama permintaan callback. - </li> - - <li> - <a href="?page=ActiveControls.ActivePageAdapter">TActivePageAdapter</a> - memroses masa-hidup halaman untuk permintaan callback. - </li> - - <li> - <a href="?page=ActiveControls.BaseActiveControl">TBaseActiveControl</a> - metode dan opsi kontrol aktif umum. - </li> - - <li> - <a href="?page=ActiveControls.CallbackClientScript">TCallbackClientScript</a> - metode untuk memanipulasi elemen HTML sisi-klien, juga termasuk metode untuk memanggil Efek javascript pada elemen HTML. - </li> - - <li> - <a href="?page=ActiveControls.CallbackClientSide">TCallbackClientSide</a> - opsi permintaan callback sisi-klien, dan pengendali event sisi-klien. - </li> - - <li> - <a href="?page=ActiveControls.CallbackResponseAdapter">TCallbackResponseAdapter</a> - respon HTTP untuk permintaan callback. - </li> - -</ul> - -</com:TContent> diff --git a/demos/quickstart/protected/pages/ActiveControls/id/TActiveButtonClass.png b/demos/quickstart/protected/pages/ActiveControls/id/TActiveButtonClass.png Binary files differdeleted file mode 100755 index 632d9a45..00000000 --- a/demos/quickstart/protected/pages/ActiveControls/id/TActiveButtonClass.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/ActiveControls/id/postback-callback.png b/demos/quickstart/protected/pages/ActiveControls/id/postback-callback.png Binary files differdeleted file mode 100755 index 031dcde3..00000000 --- a/demos/quickstart/protected/pages/ActiveControls/id/postback-callback.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Advanced/Samples/I18N/id/Home.page b/demos/quickstart/protected/pages/Advanced/Samples/I18N/id/Home.page deleted file mode 100755 index a490abce..00000000 --- a/demos/quickstart/protected/pages/Advanced/Samples/I18N/id/Home.page +++ /dev/null @@ -1,161 +0,0 @@ -<%@ Title="Internasionlisasi dalam PRADO"
- Page.Application.Globalization.TranslationCatalogue="index" %>
-<com:TContent ID="body">
-
-<h1>Internasionlisasi dalam PRADO</h1>
-<p>Demo ini memperlihatkan komponen dasar yang tersedia dalam PRADO untuk memproses Internasionalisasi dan Lokalisasi aplikasi web. Halam ini memanfaatkan template siap multipel lokal (atau kultur) untuk memperlihatkan halaman terlokalisasi yang tersedia. Untuk melihat versi dilokalisasi yang berbeda, silahkan ganti setelan bahasa dalam browser Anda.</p>
-
-<p>
-Saat ini kultur Anda adalah <%= $this->Page->CurrentCulture %>.
-<div class="links">
- Versi lokalisasi tersedia:
- <com:LanguageList />
-</div>
-</p>
-
-<p>
- Sebagai tambahan ke template siap kultur. Teks dapat dilokalisasi menggunakan banyak sumber terjemanan yang berbeda. PRADO menyediakan wadah gettext, XML, SQLite, dan MySQL untuk menyimpan terjemahan pesan. Contoh dalam link berikut mendemonstrasikan bagaimana teks dapat dilokalisasi menggunakan komponen TTranslate.
-</p>
-<hr />
-<h2>Pengenalan</h2>
-<p> Mengembangkan dan memelihara situs multi-bahasa adalah masalah umum bagi para pengembang web. </p>
-<dl>
-<dt><strong>Internasionalisasi (I18N)</strong></dt>
-<dd>Proses pengembangan sebuah produk dalam cara yang bekerja dengan data dalam bahasa berbeda dan dapat diadaptasi ke berbagai target pasar tanpa melakukan perubahan. </dd>
-<dt><strong>Lokalisasi (L10N)</strong></dt>
-<dd>Proses selanjutnya dari menterjemahkan dan mengadaptasi sebuah produk untuk pasar konvensi kultural yang tersedia.</dd>
-</dl>
-<p>Fitur berikut didukung oleh PRADO: </p>
-<ul id="u1" class="block-content">
- <li>Terjemahan teks</li>
- <li>Terjemahan atribut</li>
- <li>Substitusi parameter (dengan terjemahan bila diperlukan) </li>
- <li>Format tanggal, angka dan kurs </li>
-</ul>
-<h2>Contoh</h2>
-<h3>Tanggal: pola lengkap, kultur en_GB</h3>
-<h4>Contoh:</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TDateFormat ID="Time1" Pattern="full" Culture="en_GB"/>
-</com:TTextHighlighter>
-<h4>Hasil:</h4>
-<com:TDateFormat ID="Time1" Pattern="full" Culture="en_GB"/> <br />
-<hr />
-
-<h3>Tanggal: pola pendek</h3>
-<h4>Contoh:</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TDateFormat ID="Time2" Pattern="short" />
-</com:TTextHighlighter>
-
-<h4>Hasil:</h4>
-<com:TDateFormat ID="Time2" Pattern="short" /> <br />
-<hr />
-
-<h3>Pola standar tanggal dari <%= $this->Page->CurrentCulture %> </h3>
-<h4>Contoh:</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TDateFormat ID="Time3" Value="2004/12/06" />
-</com:TTextHighlighter>
-
-<h4>Hasil:</h4>
-<com:TDateFormat ID="Time3" Value="2004/12/06" /> <br />
-<hr />
-
-<h3>Format standar kurs</h3>
-<h4>Contoh:</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TNumberFormat Type="currency" Value="12.4" />
-</com:TTextHighlighter>
-
-<h4>Hasil:</h4>
-<com:TNumberFormat Type="currency" Value="12.4" /> <br />
-<hr />
-<h3>Currency, de_DE culture with Euro</h3>
-<h4>Contoh:</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TNumberFormat ID="Number2" Type="currency" Culture="de_DE" Currency="EUR"/>
-</com:TTextHighlighter>
-
-<h4>Hasil:</h4>
-<com:TNumberFormat ID="Number2" Type="currency" Culture="de_DE" Currency="EUR"/> <br />
-
-<hr />
-
-<h3>Kurs, format US dengan Euro</h3>
-<h4>Contoh:</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TNumberFormat Type="currency" Culture="en_US" Currency="EUR" Value="100" />
-</com:TTextHighlighter>
-
-<h4>Hasil</h4>
-<com:TNumberFormat Type="currency" Culture="en_US" Currency="EUR" Value="100" /> <br />
-<hr />
-
-<h3>Contoh terjemahan</h3>
-<h4>ContohExample:</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TTranslate>Hello</com:TTranslate>
-</com:TTextHighlighter>
-
-<h4>Hasil:</h4>
-<com:TTranslate>Hello</com:TTranslate> <br />
-<h4>Contoh:</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TTranslate Text="Goodbye" />
-</com:TTextHighlighter>
-
-<h4>Hasil:</h4>
-<com:TTranslate Text="Goodbye" /> <br />
-
-<hr />
-<h3>Menggunakan tag lokalisasi</h3>
-<h4>Contoh:</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<%[ Goodbye ]%>
-</com:TTextHighlighter>
-
-<h4>Hasil:</h4>
-<%[ Goodbye ]%>
-<br />
-
-
-<hr />
-<h3>Menterjemahkan menggunakan katalog berbeda </h3>
-<h4>Contoh:</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TTranslate Text="Goodbye" Catalogue="tests" />
-</com:TTextHighlighter>
-
-<h4>Hasil:</h4>
-<com:TTranslate Text="Goodbye" Catalogue="tests" />
-<br />
-
-
-<hr />
-<h3>Translasi dengan substitusi parameter</h3>
-<h4>Contoh:</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TTranslate>
- {greeting} {name}!, The unix-time is "{time}".
- <com:TTranslateParameter Key="name">
- <com:TTranslate Catalogue="tests" Text="World" />
- </com:TTranslateParameter>
- <com:TTranslateParameter Key="greeting" Value="Hello" />
- <com:TTranslateParameter Key="time" Value="<%= Time() %>" />
-</com:TTranslate>
-</com:TTextHighlighter>
-
-
-<h4>Hasil:</h4>
-
-<com:TTranslate>
- {greeting} {name}!, The unix-time is "{time}".
- <com:TTranslateParameter Key="name">
- <com:TTranslate Catalogue="tests" Text="World" />
- </com:TTranslateParameter>
- <com:TTranslateParameter Key="greeting" Value="Hello" />
- <com:TTranslateParameter Key="time" Value="<%= Time() %>" />
-</com:TTranslate>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/Samples/I18N/zh_TW/Home.page b/demos/quickstart/protected/pages/Advanced/Samples/I18N/zh_TW/Home.page deleted file mode 100755 index 7629e7bb..00000000 --- a/demos/quickstart/protected/pages/Advanced/Samples/I18N/zh_TW/Home.page +++ /dev/null @@ -1,155 +0,0 @@ -<%@ Title="PRADO 國際化"
- Page.Application.Globalization.TranslationCatalogue="index" %>
-<com:TContent ID="body">
-<h1>PRADO 國際化</h1>
- <p>本演示將介紹如何用PRADO中的一些部件對您的Web應用進行國際化和本地化。
- 本网頁的顯示是根据您的當地設置從多個不同語言的模板中選擇進行的。
- 如果你想查看其它語言版本，請更改瀏覽器的語言設置。</p>
-
- <p>
- 您目前的語言設置是
- <%= $this->Page->CurrentCulture %>.
- <div class="links">
- 可查看的語言版本包括：
- <com:LanguageList />
- </div>
- </p>
-
- <p>
- 除了能自動偵知語言設置的模板外，文本也可以使用不同的翻譯源進行本地化。
- PRADO提供了gettext，XML，SQLite以及MySQL等手段用于存放消息的各种翻譯。
- 下面連接所指向的例子展示了如何使用TTranslate部件對文本進行本地化。
- <hr />
- <h2>簡介</h2>
- <p>開發和維護多語言的站點對Web開發者而言是一個很常見的問題。</p>
- <dl>
- <dt><strong>國際化（I18N）</strong></dt>
- <dd>產品開發的一個步驟，它使得產品能接受不同語言的數据，并且在沒有更改設計
- 的情況下使產品能用于不同的市場。</dd>
- <dt><strong>L本地化（L10N）</strong></dt>
- <dd>國際化的一個細節步驟，它針對某個特定的市場文化對產品進行翻譯和調整。</dd>
- </dl>
- <p>PRADO支持以下功能：</p>
- <ul id="u1" class="block-content">
- <li>文本翻譯</li>
- <li>屬性翻譯（尚未完成）</li>
- <li>參數替換（如需要可進行翻譯）</li>
- <li>日期，數字和貨幣的格式化</li>
- </ul>
- <h2>例子</h2>
- <h3>日期：完整格式，en_GB語言設置</h3>
- <h4>例: </h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TDateFormat ID="Time1" Pattern="full" Culture="en_GB"/>
-</com:TTextHighlighter>
- <h4>結果: </h4>
- <com:TDateFormat ID="Time1" Pattern="full" Culture="en_GB"/> <br />
- <hr />
-
- <h3>日期：短格式</h3>
- <h4>例：</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TDateFormat ID="Time2" Pattern="short" />
-</com:TTextHighlighter>
- <h4>結果：</h4>
- <com:TDateFormat ID="Time2" Pattern="short" /> <br />
- <hr />
-
- <h3>日期：<%= $this->Page->CurrentCulture %>的缺省模式</h3>
- <h4>例：</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TDateFormat ID="Time3" Value="2004/12/06" />
-</com:TTextHighlighter>
- <h4>結果：</h4>
-<com:TDateFormat ID="Time3" Value="2004/12/06" /> <br />
- <hr />
-
- <h3>貨幣，缺省格式</h3>
- <h4>例：</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TNumberFormat Type="currency" Value="12.4" />
-</com:TTextHighlighter>
- <h4>結果：</h4>
-<com:TNumberFormat Type="currency" Value="12.4" /> <br />
- <hr />
- <h3>貨幣，de_DE語言以及歐幣</h3>
- <h4>例：</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TNumberFormat ID="Number2" Type="currency" Culture="de_DE" Currency="EUR"/>
-</com:TTextHighlighter>
- <h4>結果：</h4>
- <com:TNumberFormat ID="Number2" Type="currency" Culture="de_DE" Currency="EUR"/> <br />
-
- <hr />
-
- <h3>貨幣, 美國格式以及歐幣</h3>
- <h4>例：</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TNumberFormat Type="currency" Culture="en_US" Currency="EUR" Value="100" />
-</com:TTextHighlighter>
- <h4>結果：</h4>
- <com:TNumberFormat Type="currency" Culture="en_US" Currency="EUR" Value="100" /> <br />
- <hr />
-
- <h3>翻譯實例</h3>
- <h4>例：</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TTranslate>Hello</com:TTranslate>
-</com:TTextHighlighter>
- <h4>結果：</h4>
- <com:TTranslate>Hello</com:TTranslate> <br />
- <h4>例：</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TTranslate Text="Goodbye" />
-</com:TTextHighlighter>
- <h4>結果：</h4>
- <com:TTranslate Text="Goodbye" /> <br />
-
-<hr />
-<h3>Using localization tag</h3>
-<h4>Example:</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<%[ Goodbye ]%>
-</com:TTextHighlighter>
-
-<h4>Result:</h4>
-<%[ Goodbye ]%>
-<br />
-
- <hr />
- <h3>用不同目錄進行翻譯</h3>
- <h4>例：</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TTranslate Text="Goodbye" Catalogue="tests" />
-</com:TTextHighlighter>
- <h4>結果：</h4>
-<com:TTranslate Text="Goodbye" Catalogue="tests" />
- <br />
-
-
- <hr />
- <h3>用參數替換進行翻譯</h3>
- <h4>例：</h4>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TTranslate>
- {greeting} {name}!, The unix-time is "{time}".
- <com:TTranslateParameter Key="name">
- <com:TTranslate Catalogue="tests" Text="World" />
- </com:TTranslateParameter>
- <com:TTranslateParameter Key="greeting" Value="Hello" />
- <com:TTranslateParameter Key="time" Value="<%= Time() %>" />
-</com:TTranslate>
-</com:TTextHighlighter>
-
- <h4>結果：</h4>
-
-<com:TTranslate>
- {greeting} {name}!, The unix-time is "{time}".
- <com:TTranslateParameter Key="name">
- <com:TTranslate Catalogue="tests" Text="World" />
- </com:TTranslateParameter>
- <com:TTranslateParameter Key="greeting" Value="Hello" />
- <com:TTranslateParameter Key="time" Value="<%= Time() %>" />
-</com:TTranslate>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/Scripts1.page b/demos/quickstart/protected/pages/Advanced/Scripts1.page deleted file mode 100755 index 96ab7760..00000000 --- a/demos/quickstart/protected/pages/Advanced/Scripts1.page +++ /dev/null @@ -1,96 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="6601">Developer Notes for prototype.js</h1>
-This guide is based on the <a href="http://www.sergiopereira.com/articles/prototype.js.html">
-Developer Notes for prototype.js</a> by Sergio Pereira.
-
-<h2 id="6603">What is that?</h2>
-<p id="830726" class="block-content">
-In case you haven't already used it, <a href="http://prototype.conio.net">prototype.js</a> is a
- JavaScript library written by <a href="http://www.conio.net">Sam Stephenson</a>.
- This amazingly well thought and well written piece of <b>standards-compliant</b> code takes a lot of
- the burden associated with creating rich, highly interactive web pages that characterize the Web 2.0 off your back.
-</p>
-
-<p id="830727" class="block-content">
- If you tried to use this library recently, you probably noticed that documentation is not one
- of its strongest points. As many other developers before me, I got my head around prototype.js by
- reading the source code and experimenting with it. I thought it would be nice to take notes while
- I learned and share with everybody else.
-</p>
-<p id="830728" class="block-content">
- As you read the examples and the reference, developers familiar with the Ruby
- programming language will notice an intentional similarity between Ruby's
- built-in classes and many of the extensions implemented by this library.
-</p>
-
-
-<h2 id="6604">Using the <tt>$()</tt> function</h2>
-<p id="830729" class="block-content">
- The <tt>$()</tt> function is a handy shortcut to the all-too-frequent <tt>document.getElementById()</tt> function
- of the DOM. Like the DOM function, this one returns the element that has the id passed as an argument.
-</p>
-
-<p id="830730" class="block-content">
- Unlike the DOM function, though, this one goes further. You can pass more than one id and
- <tt>$()</tt> will return an <tt>Array</tt> object with
- all the requested elements. The example below should illustrate this.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_830252">
-<com:TClientScript UsingClientScripts="prado" />
-<div id="myDiv">
- <p id="830731" class="block-content">This is a paragraph</p>
-</div>
-
-<div id="myOtherDiv">
- <p id="830732" class="block-content">This is another paragraph</p>
-</div>
-
-<input type="button" value=Test1 onclick="test1();" />
-<input type="button" value=Test2 onclick="test2();" />
-
-<script type="text/javascript">
-/*<![CDATA[*/
-function test1()
-{
- var d = $('myDiv');
- alert(d.innerHTML);
-}
-
-function test2()
-{
- var divs = $('myDiv','myOtherDiv');
- for(i=0; i<divs.length; i++)
- {
- alert(divs[i].innerHTML);
- }
-}
-/*]]>*/
-</script>
-</com:TTextHighlighter>
-<p id="830733" class="block-content">
- Another nice thing about this function is that you can pass either the <tt>id</tt> string or the element object itself,
- which makes this function very useful when creating other functions that can also take either form of argument.
-</p>
-
-<h2 id="6605">Using the <tt>$F()</tt> function</h2>
-
-<p id="830734" class="block-content">
- The <tt>$F()</tt> function is a another welcome shortcut. It returns the value of any field input control,
- like text boxes or drop-down lists. The function can take as argument either the element <tt>id</tt> or the element object itself.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_830253">
-<input type="text" id="userName" value="Joe Doe" />
-<input type="button" value=Test3 onclick="test3();" />
-
-<script type="text/javascript">
-/*<![CDATA[*/
-function test3()
-{
- alert($F('userName'));
-}
-/*]]>*/
-</script>
-</com:TTextHighlighter>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/Scripts2.page b/demos/quickstart/protected/pages/Advanced/Scripts2.page deleted file mode 100755 index 5d88b065..00000000 --- a/demos/quickstart/protected/pages/Advanced/Scripts2.page +++ /dev/null @@ -1,253 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="6701">DOM Events and Javascript</h1>
-
-<h2 id="6702">Basic event handling</h2>
-
-<p id="840735" class="block-content">The syntax for working with events looks like the code below.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840254">
-Event.observe(element, name, observer, [useCapture]);
-</com:TTextHighlighter>
-
-<p id="840736" class="block-content">Assuming for a moment that we want to observe when a link was clicked,
-we could do the following:</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840255">
-// <a id="clicker" href="http://foo.com">Click me</a>
-Event.observe('clicker', 'click', function(event)
-{
- alert('clicked!');
-});
-</com:TTextHighlighter>
-
-<p id="840737" class="block-content">If we wanted to get the element that fired the event, we'd do this:</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840256">
-Event.observe('clicker', 'click', function(event)
-{
- alert(Event.element(event));
-});
-</com:TTextHighlighter>
-
-<h2 id="6703">Observing keystrokes</h2>
-
-<p id="840738" class="block-content">If we wanted to observe keystrokes for the entire document, we could do the following:</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840257">
-Event.observe(document, 'keypress', function(event)
-{
- if(Event.keyCode(event) == Event.KEY_TAB)
- alert('Tab Pressed');
-});
-</com:TTextHighlighter>
-
-<p id="840739" class="block-content">And lets say we wanted to keep track of what has been typed :</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840258">
-Event.observe('search', 'keypress', function(event)
-{
- Element.update('search-results', $F(Event.element(event)));
-});
-</com:TTextHighlighter>
-
-<p id="840740" class="block-content">Prototype defines properties inside the event object for some
-of the more common keys, so feel free to dig around in Prototype to
-see which ones those are.</p>
-
-<p id="840741" class="block-content">A final note on keypress events; If you'd like to detect a
-left click you can use <tt>Event.isLeftClick(event)</tt>.</p>
-
-<h2 id="6704">Getting the coordinates of the mouse pointer</h2>
-
-<p id="840742" class="block-content">Drag and drop, dynamic element resizing, games, and
-much more all require the ability to track the X and Y location of
-the mouse. Prototype makes this fairly simple. The code below tracks
-the X and Y position of the mouse and spits out those values into
-an input box named mouse.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840259">
-Event.observe(document, 'mousemove', function(event)
-{
- $('mouse').value = "X: " + Event.pointerX(event) +
- "px Y: " + Event.pointerY(event) + "px";
-});
-</com:TTextHighlighter>
-
-<p id="840743" class="block-content">If we wanted to observe the mouse location when it was
-hovering over a certain element, we'd just change the document argument to
-the id or element that was relevant.</p>
-
-<h2 id="6705">Stopping Propagation</h2>
-
-<p id="840744" class="block-content"><tt>Event.stop(event)</tt> will stop the propagation of an event .</p>
-
-<h2 id="6706">Events, Binding, and Objects</h2>
-
-<p id="840745" class="block-content">Everything has been fairly straight forward so far, but things
-start getting a little trickier when you need to work with events in
-and object-oriented environment. You have to deal with binding and funky
-looking syntax that might take a moment to get your head around.</p>
-
-<p id="840746" class="block-content">Lets look at some code so you can get a better understanding of what I'm talking about.</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840260">
-EventDispenser = Class.create();
-EventDispenser.prototype =
-{
- initialize: function(list)
- {
- this.list = list;
-
- // Observe clicks on our list items
- $$(this.list + " li").each(function(item)
- {
- Event.observe(item, 'click', this.showTagName.bindEvent(this));
- }.bind(this));
-
- // Observe when a key on the keyboard is pressed.
- // In the observer, we check for
- // the tab key and alert a message if it is pressed.
- Event.observe(document, 'keypress', this.onKeyPress.bindEvent(this));
-
- // Observe our fake live search box. When a user types
- // something into the box, the observer will take that
- // value(-1) and update our search-results div with it.
- Event.observe('search', 'keypress', this.onSearch.bindEvent(this));
-
- Event.observe(document, 'mousemove', this.onMouseMove.bindEvent(this));
- },
-
- // Arbitrary functions to respond to events
- showTagName: function(event)
- {
- alert(Event.element(event).tagName);
- },
-
- onKeyPress: function(event)
- {
- var code = event.keyCode;
- if(code == Event.KEY_TAB)
- alert('Tab key was pressed');
- },
-
- onSearch: function(event)
- {
- Element.update('search-results', $F(Event.element(event)));
- },
-
- onMouseMove: function(event)
- {
- $('mouse').value = "X: " + Event.pointerX(event) +
- "px Y: " + Event.pointerY(event) + "px";
- }
-}
-</com:TTextHighlighter>
-<p id="840747" class="block-content">Whoa! What's going on here? Well, we've defined our a
-custom class <tt>EventDispenser</tt>. We're going to be using this class
-to setup events for our document. Most of this code is a
-rewrite of the code we looked at earlier except this time, we
-are working from inside an object.</p>
-
-<p id="840748" class="block-content">Looking at the <tt>initialize</tt> method, we can really see how
-things are different now. Take a look at the code below:</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840261">
-// Observe clicks on our list items
-$$(this.list + " li").each(function(item)
-{
- Event.observe(item, 'click', this.showTagName.bindEvent(this));
-}.bind(this));
-</com:TTextHighlighter>
-
-<p id="840749" class="block-content">We've got iterators, binding and all sorts of stuff going on.
-Lets break down what this chunk of code is doing.</p>
-
-<p id="840750" class="block-content">First we are hunting for a collection of elements based on
-it's CSS selector. This uses the Prototype selector function <tt>$$()</tt>.
-After we've found the list items we are dealing with we send
-those into an each iteration where we will add our observers.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840262">
-Event.observe(item, 'click', this.showTagName.bindEvent(this));
-</com:TTextHighlighter>
-
-<p id="840751" class="block-content">Now looking at the code above, you'll notice the <tt>bindEvent</tt> function.
-This takes the method before it <tt>showTagName</tt> and treats it as the
-method that will be triggered when, in this case,
-someone clicks one of our list items.</p>
-
-<p id="840752" class="block-content">You'll also notice we pass this as an argument to the <tt>bindEvent</tt> function.
-This simply allows us to reference the object in context <tt>EventDispenser</tt>
-inside our function <tt>showTagName(event)</tt>. If the <tt>showTagName</tt> function
-requires additional parameters, you can attach them to the later parameters of <tt>bindEvent</tt>. For example</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840263">
-this.showTagName.bindEvent(this, param1, param2);
-
-//where the showTagName function is defined as
-showTime : function (event, param1, param2) { ... }
-</com:TTextHighlighter>
-
-<p id="840753" class="block-content">Moving on, you'll see <tt>bind(this)</tt> attached to our iterator function.
-This really has nothing to do with events, it is only here to allow me to
-use <tt>this</tt> inside the iterator. If we did not use <tt>bind(this)</tt>, I could not
-reference the method <tt>showTagName</tt> inside the iterator.</p>
-
-<p id="840754" class="block-content">Ok, so we'll move on to looking at our methods that actually get
-called when an event occurs. Since we've been dealing with <tt>showTagName</tt>, lets look at it.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840264">
-showTagName: function(event)
-{
- alert(Event.element(event).tagName);
-}
-</com:TTextHighlighter>
-
-<p id="840755" class="block-content">As you can see, this function accepts one argument--the event.
-In order for us to get the element which fired the event we need to
-pass that argument to <tt>Event.element</tt>. Now we can manipulate it at will.</p>
-
-<p id="840756" class="block-content">This covers the most confusing parts of our code. The text above is also
-relevant to the remaining parts of our code. If there is anything about
-this you don't understand, feel free to ask questions in the forum.</p>
-
-<h2 id="6707">Removing Event Listeners</h2>
-
-<p id="840757" class="block-content">This one threw me for a loop the first time I tried to use it.
-I tried something similar to what I did in the <tt>Event.observe</tt>
-call with the exception of using <tt>stopObserving</tt>, but nothing seemed
-to change. In other words, the code below does <b>NOT</b> work.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840265">
-$$(this.list + " li").each(function(item)
-{
- Event.stopObserving(item, 'click', this.showTagName);
-}.bind(this));
-</com:TTextHighlighter>
-
-<p id="840758" class="block-content">What's the deal here? The reason this does not work is because there
-is no pointer to the observer. This means that when we passed <tt>this.showTagName</tt>
-in the <tt>Event.observe</tt> method before hand, we passed it as an
-anonymous function. We can't reference an anonymous function
-because it simply does not have a pointer.</p>
-
-<p id="840759" class="block-content">So how do we get the job done? All we need to do is give the
-observing function a pointer, or the jargon free version: Set a variable
-that points to <tt>this.showTagName</tt>. Ok, lets change our code a bit.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840266">
-this.showTagObserver = this.showTagName.bindEvent(this);
-
-// Observe clicks on our list items
-$$(this.list + " li").each(function(item)
-{
- Event.observe(item, 'click', this.showTagObserver);
-}.bind(this));
-</com:TTextHighlighter>
-
-<p id="840760" class="block-content">Now we can remove the event listeners from our list like this:</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840267">
-$$(this.list + " li").each(function(item)
-{
- Event.stopObserving(item, 'click', this.showTagObserver);
-}.bind(this));
-</com:TTextHighlighter>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/Scripts3.page b/demos/quickstart/protected/pages/Advanced/Scripts3.page index 3f41abe1..b937e274 100755 --- a/demos/quickstart/protected/pages/Advanced/Scripts3.page +++ b/demos/quickstart/protected/pages/Advanced/Scripts3.page @@ -19,22 +19,31 @@ $this->getPage()->getClientScript()->registerPradoScript("effects"); </ul>
The available packaged libraries included in Prado are
<ul id="u2" class="block-content">
- <li><tt>prado</tt> : basic PRADO javascript framework based on Prototype</li>
- <li><tt>effects</tt> : visual effects from script.aculo.us</li>
- <li><tt>ajax</tt> : ajax and callback related based on Prototype</li>
- <li><tt>validator</tt> : validation</li>
+ <li><tt>jquery</tt> : <a href="https://jquery.com/">jQuery</a> javascript framework</li>
+ <li><tt>prado</tt> : basic PRADO javascript framework based on jQuery</li>
+ <li><tt>bootstrap</tt> : <a href="http://getbootstrap.com/">Bootstrap</a> front-end framework</li>
+ <li><tt>effects</tt> : visual effects based on <a href="https://jqueryui.com/">jQueryUI</a></li>
+ <li><tt>ajax</tt> : ajax and callback related based on jQuery</li>
+ <li><tt>validator</tt> : widgets validation</li>
<li><tt>logger</tt> : javascript logger and object browser</li>
- <li><tt>datepicker</tt> : datepicker control</li>
- <li><tt>colorpicker</tt> : colorpicker control</li>
+ <li><tt>datepicker</tt> : TDatepicker control</li>
+ <li><tt>colorpicker</tt> : TColorPicker control</li>
<li><tt>dragdrop</tt> : basic support for "drag and drop" control</li>
<li><tt>dragdropextra</tt> : extra support for "drag and drop" controls</li>
- <li><tt>slider</tt> : slider control</li>
+ <li><tt>slider</tt> : TSlider control</li>
<li><tt>keyboard</tt> : software keyboard control</li>
- <li><tt>tabpanel</tt> : tabpanel control</li>
+ <li><tt>tabpanel</tt> : TTabPanel control</li>
+ <li><tt>inlineeditor</tt> : TInPlaceTextBox. control</li>
<li><tt>activedatepicker</tt> : ajax version of the datepicker control</li>
<li><tt>activefileupload</tt> : ajax version of the fileupload control</li>
- <li><tt>accordion</tt> : accordion control</li>
- <li><tt>htmlarea</tt> : tinymce control</li>
+ <li><tt>accordion</tt> : TAccordion control</li>
+ <li><tt>ratings</tt> : TRatingList control</li>
+ <li><tt>htmlarea</tt> : <a href="http://www.tinymce.com/">tinyMCE</a> version 3 editor</li>
+ <li><tt>htmlarea4</tt> : <a href="http://www.tinymce.com/">tinyMCE</a> version 4 editor</li>
+ <li><tt>prototype</tt> : <a href="http://prototypejs.org/">prototype</a> javascript framework (only for compatibility with old custom controls)</li>
+ <li><tt>dragdrop</tt> : compatibility package for old, prototype-based drag&drop controls</li>
+ <li><tt>dragdropextra</tt> : compatiblity package for old, prototype-based drag&drop controls</li>
+ <li><tt>autocomplete</tt> : compatibility package for prototype-based TAutoComplete control</li>
</ul>
<p id="850761" class="block-content">The dependencies for each library are automatically resolved. Components
diff --git a/demos/quickstart/protected/pages/Advanced/es/Assets.page b/demos/quickstart/protected/pages/Advanced/es/Assets.page deleted file mode 100755 index fc40b561..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/Assets.page +++ /dev/null @@ -1,69 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5701">Assets</h1>
-<p id="740577" class="block-content">
-Assets are resource files (such as images, sounds, videos, CSS stylesheets, javascripts, etc.) that belong to specific component classes. Assets are meant to be provided to Web users. For better reusability and easier deployment of the corresponding component classes, assets should reside together with the component class files . For example, a toggle button may use two images, stored in file <tt>down.gif</tt> and <tt>up.gif</tt>, to show different toggle states. If we require the image files be stored under <tt>images</tt> directory under the Web server document root, it would be inconvenient for the users of the toggle button component, because each time they develop or deploy a new application, they would have to manually copy the image files to that specific directory. To eliminate this requirement, a directory relative to the component class file should be used for storing the image files. A common strategy is to use the directory containing the component class file to store the asset files.
-</p>
-<p id="740578" class="block-content">
-Because directories containing component class files are normally inaccessible by Web users, PRADO implements an asset publishing scheme to make available the assets to Web users. An asset, after being published, will have a URL by which Web users can retrieve the asset file.
-</p>
-
-<h2 id="5702">Asset Publishing</h2>
-<p id="740579" class="block-content">
-PRADO provides several methods for publishing assets or directories containing assets:
-</p>
-<ul id="u1" class="block-content">
-<li>In a template file, you can use <a href="?page=Configurations.Templates2#at">asset tags</a> to publish assets and obtain their URLs. Note, the assets must be relative to the directory containing the template file.</li>
-<li>In PHP code, you can call <tt>$object->publishAsset($assetPath)</tt> to publish an asset and obtain its URL. Here, <tt>$object</tt> refers to an instance of <tt>TApplicationComponent</tt> or derived class, and <tt>$assetPath</tt> is a file or directory relative to the directory containing the class file.</li>
-<li>If you want to publish an arbitrary asset, you need to call <tt>TAssetManager::publishFilePath($path)</tt>.</li>
-</ul>
-<p id="740580" class="block-content">
-BE AWARE: Be very careful with assets publishing, because it gives Web users access to files that were previously inaccessible to them. Make sure that you do not publish files that do not want Web users to see.
-</p>
-
-<h2 id="5703">Customization</h2>
-<p id="740581" class="block-content">
-Asset publishing is managed by the <tt>System.Web.TAssetManager</tt> module. By default, all published asset files are stored under the <tt>[AppEntryPath]/assets</tt> directory, where <tt>AppEntryPath</tt> refers to the directory containing the application entry script. Make sure the <tt>assets</tt> directory is writable by the Web server process. You may change this directory to another by configuring the <tt>BasePath</tt> and <tt>BaseUrl</tt> properties of the <tt>TAssetManager</tt> module in application configuration,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code1">
-<modules>
- <module id="asset"
- class="System.Web.TAssetManager"
- BasePath="Web.images"
- BaseUrl="images" />
-</modules>
-</com:TTextHighlighter>
-
-<h2 id="5704">Performance</h2>
-<p id="740582" class="block-content">
-PRADO uses caching techniques to ensure the efficiency of asset publishing. Publishing an asset essentially requires file copy operation, which is expensive. To save unnecessary file copy operations, <tt>System.Web.TAssetManager</tt> only publishes an asset when it has a newer file modification time than the published file. When an application runs under the <tt>Performance</tt> mode, such timestamp checking is also omitted.
-</p>
-<p id="740583" class="block-content">
-ADVISORY: Do not overuse asset publishing. The asset concept is mainly used to help better reuse and redistribute component classes. Normally, you should not use asset publishing for resources that are not bound to any component in an application. For example, you should not use asset publishing for images that are mainly used as design elements (e.g. logos, background images, etc.) Let Web server to directly serve these images will help improve the performance of your application.
-</p>
-
-<h2 id="5705">A Toggle Button Example</h2>
-<p id="740584" class="block-content">
-We now use the toggle button example to explain the usage of assets. The control uses two image files <tt>up.gif</tt> and <tt>down.gif</tt>, which are stored under the directory containing the control class file. When the button is in <tt>Up</tt> state, we would like to show the <tt>up.gif</tt> image. This can be done as follows,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code2">
-class ToggleButton extends TWebControl {
- ...
- protected function addAttributesToRender($writer) {
- ...
- if($this->getState()==='Up') {
- $url=$this->getAsset('up.gif');
- $writer->addAttribute('src',$url);
- }
- ...
- }
- ...
-}
-</com:TTextHighlighter>
-<p id="740585" class="block-content">
-In the above, the call <tt>$this->getAsset('up.gif')</tt> will publish the <tt>up.gif</tt> image file and return a URL for the published image file. The URL is then rendered as the <tt>src</tt> attribute of the HTML image tag.
-</p>
-<p id="740586" class="block-content">
-To redistribute <tt>ToggleButton</tt>, simply pack together the class file and the image files. Users of <tt>ToggleButton</tt> merely need to unpack the file, and they can use it right away, without worrying about where to copy the image files to.
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/es/Auth.page b/demos/quickstart/protected/pages/Advanced/es/Auth.page deleted file mode 100755 index 82af40bb..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/Auth.page +++ /dev/null @@ -1,171 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5501">Autenticación y Autorizacion</h1>
-<p id="720549" class="block-content">
-Autenticación es un proceso de verificacion de alguna persona cuando esta dice ser quien es. Usualmente se utiliza para esto un nombre de usuario y un contraseña, pero podría incluir otros métodos para demostrar su identidad, tales como tarjetas inteligentes, huellas digitales, etc.
-</p>
-<p id="720550" class="block-content">
-Autorización es el proceso de saber si la persona, una vez indetificada, esta permitida a manipular recursos especificos. Esto es comunmente determinado conociendo si la persona tiene un rol especifico que le da acceso a los recursos solicitados.
-</p>
-
-<h2 id="5502">Funcionamiento de la Autenticación y Autorizacion en PRADO</h2>
-<p id="720551" class="block-content">
-PRADO proporciona una capa extensible de autenticacion/autirizacion. Como esta descrito en el <a href="">Ciclo de vida de una aplicacion PRADO</a>, <tt>TApplication</tt> reserva diversos modulos del ciclo de vida, responsables de la autenticacion y la autorizacion. PRADO proporciona el modulo <tt>TAuthManager</tt> para este propósito. Los desarrolladores pueden incorporar sus propios modulos de autenticacion/autorizacion (auth) facilmente.
-<tt>TAuthManager</tt> esta diseñado para ser usado en conjunto con el modulo <tt>TUserManager</tt>, el cual implementa una base de datos de usuarios de solo lectura (read-only).
-</p>
-<p id="720552" class="block-content">
-When a page request occurs, <tt>TAuthManager</tt> will try to restore user information from session. If no user information is found, the user is considered as an anonymous or guest user. To facilitate user identity verification, <tt>TAuthManager</tt> provides two commonly used methods: <tt>login()</tt> and <tt>logout()</tt>. A user is logged in (verified) if his username and password entries match a record in the user database managed by <tt>TUserManager</tt>. A user is logged out if his user information is cleared from session and he needs to re-login if he makes new page requests.
-</p>
-<p id="720553" class="block-content">
-During <tt>Authorization</tt> application lifecycle, which occurs after <tt>Autenticación</tt> lifecycle, <tt>TAuthManager</tt> will verify if the current user has access to the requested page according to a set of authorization rules. The authorization is role-based, i.e., a user has access to a page if 1) the page explicitly states that the user has access; 2) or the user is of a particular role that has access to the page. If the user does not have access to the page, <tt>TAuthManager</tt> will redirect user browser to the login page which is specified by <tt>LoginPage</tt> property.
-</p>
-
-<h2 id="5503">Using PRADO Auth Framework</h2>
-<p id="720554" class="block-content">
-To enable PRADO auth framework, add the <tt>TAuthManager</tt> module and <tt>TUserManager</tt> module to <a href="">application configuration</a>,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code1">
-<service id="page" class="TPageService">
- <modules>
- <module id="auth" class="System.Security.TAuthManager"
- UserManager="users" LoginPage="UserLogin" />
- <module id="users" class="System.Security.TUserManager"
- PasswordMode="Clear">
- <user name="demo" password="demo" />
- <user name="admin" password="admin" />
- </module>
- </modules>
-</service>
-</com:TTextHighlighter>
-<p id="720555" class="block-content">
-In the above, the <tt>UserManager</tt> property of <tt>TAuthManager</tt> is set to the <tt>users</tt> module which is <tt>TUserManager</tt>. Developers may replace it with a different user management module that is derived from <tt>TUserManager</tt>.
-</p>
-<p id="720556" class="block-content">
-Authorization rules for pages are specified in <a href="">page configurations</a> as follows,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code2">
-<authorization>
- <allow pages="PageID1,PageID2"
- users="User1,User2"
- roles="Role1" />
- <deny pages="PageID1,PageID2"
- users="?"
- verb="post" />
-</authorization>
-</com:TTextHighlighter>
-<p id="720557" class="block-content">
-An authorization rule can be either an <tt>allow</tt> rule or a <tt>deny</tt> rule. Each rule consists of four optional properties:
-</p>
-<ul id="u1" class="block-content">
-<li><tt>pages</tt> - list of comma-separated page names that this rule applies to. If empty, not set or wildcard '*', this rule will apply to all pages under the current directory and all its subdirectories recursively.</li>
-<li><tt>users</tt> - list of comma-separated user names that this rule applies to. If empty, not set or wildcard '*', this rule will apply to all users including anonymous/guest user. A character ? refers to anonymous/guest user. And a character @ refers to authenticated users (available since v3.1).</li>
-<li><tt>roles</tt> - list of comma-separated user roles that this rule applies to. If empty, not set or wildcard '*', this rule will apply to all user roles.</li>
-<li><tt>verb</tt> - page access method that this rule applies to. It can be either <tt>get</tt> or <tt>post</tt>. If empty, not set or wildcard '*', the rule will apply to both methods.</li>
-</ul>
-
-<p id="720558" class="block-content">
-When a page request is being processed, a list of authorization rules may be available. However, only the <i>first effective</i> rule <i>matching</i> the current user will render the authorization result.
-</p>
-<ul id="u2" class="block-content">
-<li>Rules are ordered bottom-up, i.e., the rules contained in the configuration of current page folder go first. Rules in configurations of parent page folders go after.</li>
-<li>A rule is effective if the current page is in the listed pages of the rule AND the current user action (<tt>get</tt> or <tt>post</tt>) is in the listed actions.</li>
-<li>A rule matching occurs if the current user name is in the listed user names of an <i>effective</i> rule OR if the user's role is in the listed roles of that rule.</li>
-<li>If no rule matches, the user is authorized.</li>
-</ul>
-<p id="720559" class="block-content">
-In the above example, anonymous users will be denied from posting to <tt>PageID1</tt> and <tt>PageID2</tt>, while <tt>User1</tt> and <tt>User2</tt> and all users of role <tt>Role1</tt> can access the two pages (in both <tt>get</tt> and <tt>post</tt> methods).
-</p>
-<com:SinceVersion Version="3.1.1" />
-<p class="block-content">
-Since version 3.1.1, the <tt>pages</tt> attribute in the authorization rules can take relative page paths with wildcard '*'. For example, <tt>pages="admin.Home"</tt> refers to the <tt>Home</tt> page under the <tt>admin</tt> directory, and <tt>pages="admin.*"</tt> would refer to all pages under the <tt>admin</tt> directory and subdirectories.
-</p>
-
-<p class="block-content">
-Also introduced in version 3.1.1 are IP rules. They are specified by a new attribute <tt>ips</tt> in authorization rules. The IP rules are used to determine if an authorization rule aplies to an end-user according to his IP address. One can list a few IPs together, separated by comma ','. Wildcard '*' can be used in the rules. For example, <tt>ips="192.168.0.2, 192.168.1.*"</tt> means the rule applies to users whose IP address is 192.168.0.2 or 192.168.1.*. The latter matches any host in the subnet 192.168.1. If the attribute 'ips' is empty, not set or wildcard '*', the corresponding rule will apply to requests coming from any host address.
-</p>
-
-<h2 id="5504">Using <tt>TUserManager</tt></h2>
-<p id="720560" class="block-content">
-As aforementioned, <tt>TUserManager</tt> implements a read-only user database. The user information are specified in either application configuration or an external XML file.
-</p>
-<p id="720561" class="block-content">
-We have seen in the above example that two users are specified in the application configuration. Complete syntax of specifying the user and role information is as follows,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code3">
-<user name="demo" password="demo" roles="demo,admin" />
-<role name="admin" users="demo,demo2" />
-</com:TTextHighlighter>
-<p id="720562" class="block-content">
-where the <tt>roles</tt> attribute in <tt>user</tt> element is optional. User roles can be specified in either the <tt>user</tt> element or in a separate <tt>role</tt> element.
-</p>
-
-<h2 id="5505">Using <tt>TDbUserManager</tt></h2>
-<p id="720563" class="block-content">
-<tt>TDbUserManager</tt> is introduced in v3.1.0. Its main purpose is to simplify the task of managing user accounts that are stored in a database. It requires developers to write a user class that represents the necessary information for a user account. The user class must extend from <tt>TDbUser</tt>.
-</p>
-<p id="720564" class="block-content">
-To use <tt>TDbUserManager</tt>, configure it in the application configuration like following:
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code4">
-<module id="db"
- class="System.Data.TDataSourceConfig" ..../>
-<module id="users"
- class="System.Security.TDbUserManager"
- UserClass="Path.To.MyUserClass"
- ConnectionID="db" />
-<module id="auth"
- class="System.Security.TAuthManager"
- UserManager="users" LoginPage="Path.To.LoginPage" />
-</com:TTextHighlighter>
-
-</p>
-<p id="720565" class="block-content">
-In the above, <tt>UserClass</tt> specifies what class will be used to create user instance. The class must extend from <tt>TDbUser</tt>. <tt>ConnectionID</tt> refers to the ID of a <tt>TDataSourceConfig</tt> module which specifies how to establish database connection to retrieve user information.
-</p>
-<p id="720566" class="block-content">
-The user class has to implement the two abstract methods in <tt>TDbUser</tt>: <tt>validateUser()</tt> and <tt>createUser()</tt>. Since user account information is stored in a database, the user class may make use of its <tt>DbConnection</tt> property to reach the database.
-</p>
-<com:SinceVersion Version="3.1.1" />
-<p id="720567" class="block-content">
-Since 3.1.1, <tt>TAuthManager</tt> provides support to allow remembering login by setting <tt>AllowAutoLogin</tt> to true. Accordingly, <tt>TDbUser</tt> adds two methods to facilitate the implementation of this feature. In particular, two new methods are introduced: <tt>createUserFromCookie()</tt> and <tt>saveUserToCookie()</tt>. Developers should implement these two methods if remembering login is needed. Below is a sample implementation:
-</p>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code5">
-public function createUserFromCookie($cookie)
-{
- if(($data=$cookie->Value)!=='')
- {
- $application=Prado::getApplication();
- if(($data=$application->SecurityManager->validateData($data))!==false)
- {
- $data=unserialize($data);
- if(is_array($data) && count($data)===3)
- {
- list($username,$address,$token)=$data;
- $sql='SELECT passcode FROM user WHERE LOWER(username)=:username';
- $command=$this->DbConnection->createCommand($sql);
- $command->bindValue(':username',strtolower($username));
- if($token===$command->queryScalar() && $token!==false && $address=$application->Request->UserHostAddress)
- return $this->createUser($username);
- }
- }
- }
- return null;
-}
-
-public function saveUserToCookie($cookie)
-{
- $application=Prado::getApplication();
- $username=strtolower($this->Name);
- $address=$application->Request->UserHostAddress;
- $sql='SELECT passcode FROM user WHERE LOWER(username)=:username';
- $command=$this->DbConnection->createCommand($sql);
- $command->bindValue(':username',strtolower($username));
- $token=$command->queryScalar();
- $data=array($username,$address,$token);
- $data=serialize($data);
- $data=$application->SecurityManager->hashData($data);
- $cookie->setValue($data);
-}
-</com:TTextHighlighter>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/es/Collections.page b/demos/quickstart/protected/pages/Advanced/es/Collections.page deleted file mode 100755 index 55f0d554..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/Collections.page +++ /dev/null @@ -1,135 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5501">Collections</h1>
-<p id="710529" class="block-content">
-Collection is a basic data structure in programming. In traditional PHP programming, array is used widely to represent collection data structure. A PHP array is a mix of cardinal-indexed array and hash table.
-</p>
-<p id="710530" class="block-content">
-To enable object-oriented manipulation of collections, PRADO provides a set of powerful collection classes. Among them, the <tt>TList</tt> and <tt>TMap</tt> are the most fundamental and usually serve as the base classes for other collection classes. Since many PRADO components have properties that are of collection type, it is very important for developers to master the usage of PRADO collection classes.
-</p>
-
-<h2 id="5502">Using <tt>TList</tt></h2>
-<p id="710531" class="block-content">
-A <tt>TList</tt> object represents a cardinal-indexed array, i.e., an array (object) with the index 0, 1, 2, ...
-</p>
-<p id="710532" class="block-content">
-<tt>TList</tt> may be used like a PHP array. For example,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code1">
-$list=new TList; // create a list object
-...
-$item=$list[$index]; // read the item at the specified index
-$list[]=$item; // append the item at the end
-$list[$index]=$item; // replace the item at the specified index
-unset($list[$index]); // remove the item at $index
-if(isset($list[$index])) // test if the list has an item at $index
-foreach($list as $index=>$item) // traverse each item in the list
-</com:TTextHighlighter>
-
-<p id="710533" class="block-content">
-To obtain the number of items in the list, use the <tt>Count</tt> property. Note, do not use <tt>count($list)</tt>, as it always returns 1.
-</p>
-
-<p id="710534" class="block-content">
-In addition, <tt>TList</tt> implements a few commonly used convenient methods for manipulating the data in a list. These include
-</p>
-<ul id="u1" class="block-content">
- <li><tt>clear()</tt>: removes all items in the list.</li>
- <li><tt>contains()</tt>: tests if the list contains the specified item.</li>
- <li><tt>indexOf()</tt>: obtains the zero-based index of the specified item in the list.</li>
- <li><tt>toArray()</tt>: returns an array representation of the items in the list.</li>
- <li><tt>copyFrom()</tt>: populates the list with data from an array or traversable object (including <tt>TList</tt>). Existing items will be removed first.</li>
- <li><tt>mergeWith()</tt>: appends the list with data from an array or traversable object (including <tt>TList</tt>).</li>
-</ul>
-
-<h3 id="5504">Using <tt>TList</tt>-based component properties</h3>
-<p id="710535" class="block-content">
-As aforementioned, many PRADO component properties are based on <tt>TList</tt> or <tt>TList</tt>-derived collection classes. These properties all share the above usages.
-</p>
-<p id="710536" class="block-content">
-For example, <tt>TControl</tt> (the base class for all PRADO controls) has a property called <tt>Controls</tt> which represents the collection of child controls. The type of <tt>Controls</tt> is <tt>TControlCollection</tt> which extends <tt>TList</tt>. Therefore, to append a new child control, we can use the following,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code2">
-$control->Controls[]=$newControl;
-</com:TTextHighlighter>
-<p id="710537" class="block-content">
-To traverse through the child controls, we can use,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code3">
-foreach($control->Controls as $childControl) ...
-</com:TTextHighlighter>
-<p id="710538" class="block-content">
-Another example is the <tt>Items</tt> property, available in list controls, <tt>TRepeater</tt>, <tt>TDataList</tt> and <tt>TDataGrid</tt>. In these controls, the ancestor class of <tt>Items</tt> is <tt>TList</tt>.
-</p>
-
-<h3 id="5505">Extending <tt>TList</tt></h3>
-<p id="710539" class="block-content">
-Often, we want to extend <tt>TList</tt> to perform additional operations for each addition or removal of an item. The only methods that the child class needs to override are <tt>insertAt()</tt> and <tt>removeAt()</tt>. For example, to ensure the list only contains items that are of <tt>TControl</tt> type, we can override <tt>insertAt()</tt> as follows,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code4">
-public function insertAt($index,$item)
-{
- if($item instanceof TControl)
- parent::insertAt($index,$item)
- else
- throw new Exception('TControl required.');
-}
-</com:TTextHighlighter>
-
-
-<h2 id="5503">Using <tt>TMap</tt></h2>
-<p id="710540" class="block-content">
-A <tt>TMap</tt> object represents a hash table (or we say string-indexed array).
-</p>
-<p id="710541" class="block-content">
-Similar to <tt>TList</tt>, <tt>TMap</tt> may be used like an array,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code5">
-$map=new TMap; // create a map object
-...
-$map[$key]=$value; // add a key-value pair
-unset($map[$key]); // remove the value with the specified key
-if(isset($map[$key])) // if the map contains the key
-foreach($map as $key=>$value) // traverse the items in the map
-</com:TTextHighlighter>
-<p id="710542" class="block-content">
-The <tt>Count</tt> property gives the number of items in the map while the <tt>Keys</tt> property returns a list of keys used in the map.
-</p>
-
-<p id="710543" class="block-content">
-The following methods are provided by <tt>TMap</tt> for convenience,
-</p>
-<ul id="u2" class="block-content">
- <li><tt>clear()</tt>: removes all items in the map.</li>
- <li><tt>contains()</tt>: tests if the map contains the specified key.</li>
- <li><tt>toArray()</tt>: returns an array representation of the items in the map.</li>
- <li><tt>copyFrom()</tt>: populates the map with data from an array or traversable object (including <tt>TMap</tt>). Existing items will be removed first.</li>
- <li><tt>mergeWith()</tt>: appends the map with data from an array or traversable object (including <tt>TMap</tt>).</li>
-</ul>
-
-<h3 id="5506">Using of <tt>TAttributeCollection</tt></h3>
-<p id="710544" class="block-content">
-<tt>TAttributeCollection</tt> is a special class extending from <tt>TMap</tt>. It is mainly used by the <tt>Attributes</tt> property of <tt>TControl</tt>.
-</p>
-Besides the normal functionalities provided by <tt>TMap</tt>, <tt>TAttributeCollection</tt> allows you to get and set collection items like getting and setting properties. For example,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code6">
-$collection->Label='value'; // equivalent to: $collection['Label']='value';
-echo $collection->Label; // equivalent to: echo $collection['Label'];
-</com:TTextHighlighter>
-<p id="710545" class="block-content">
-Note, in the above <tt>$collection</tt> does NOT have a <tt>Label</tt> property.
-</p>
-<p id="710546" class="block-content">
-Unlike <tt>TMap</tt>, keys in <tt>TAttributeCollection</tt> are case-insensitive. Therefore, <tt>$collection->Label</tt> is equivalent to <tt>$collection->LABEL</tt>.
-</p>
-<p id="710547" class="block-content">
-Because of the above new features, when dealing with the <tt>Attributes</tt> property of controls, we may take advantage of the subproperty concept and configure control attribute values in a template as follows,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code7">
-<com:TButton Attributes.onclick="if(!confirm('Are you sure?')) return false;" .../>
-</com:TTextHighlighter>
-<p id="710548" class="block-content">
-which adds an attribute named <tt>onclick</tt> to the <tt>TButton</tt> control.
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/es/Error.page b/demos/quickstart/protected/pages/Advanced/es/Error.page deleted file mode 100755 index 24c7ead0..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/Error.page +++ /dev/null @@ -1,77 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="6301">Error Handling and Reporting</h1>
-<p id="800666" class="block-content">
-PRADO provides a complete error handling and reporting framework based on the PHP 5 exception mechanism.
-</p>
-
-<h2 id="6302">Exception Classes</h2>
-<p id="800667" class="block-content">
-Errors occur in a PRADO application may be classified into three categories: those caused by PHP script parsing, those caused by wrong code (such as calling an undefined function, setting an unknown property), and those caused by improper use of the Web application by client users (such as attempting to access restricted pages). PRADO is unable to deal with the first category of errors because they cannot be caught in PHP code. PRADO provides an exception hierarchy to deal with the second and third categories.
-</p>
-<p id="800668" class="block-content">
-All errors in PRADO applications are represented as exceptions. The base class for all PRADO exceptions is <tt>TException</tt>. It provides the message internationalization functionality to all system exceptions. An error message may be translated into different languages according to the user browser's language preference.
-</p>
-<p id="800669" class="block-content">
-Exceptions raised due to improper usage of the PRADO framework inherit from <tt>TSystemException</tt>, which can be one of the following exception classes:
-</p>
-<ul id="u1" class="block-content">
-<li><tt>TConfigurationException</tt> - improper configuration, such as error in application configuration, control templates, etc.</li>
-<li><tt>TInvalidDataValueException</tt> - data value is incorrect or unexpected.</li>
-<li><tt>TInvalidDataTypeException</tt> - data type is incorrect or unexpected.</li>
-<li><tt>TInvalidDataFormatException</tt> - format of data is incorrect.</li>
-<li><tt>TInvalidOperationException</tt> - invalid operation request.</li>
-<li><tt>TPhpErrorException</tt> - catchable PHP errors, warnings, notices, etc.</li>
-<li><tt>TSecurityException</tt> - errors related with security.</li>
-<li><tt>TIOException</tt> - IO operation error, such as file open failure.</li>
-<li><tt>TDBException</tt> - errors related with database operations.</li>
-<li><tt>TNotSupportedException</tt> - errors caused by requesting for unsupported feature.</li>
-<li><tt>THttpException</tt> - errors to be displayed to Web client users.</li>
-</ul>
-<p id="800670" class="block-content">
-Errors due to improper usage of the Web application by client users inherit from <tt>TApplicationException</tt>.
-</p>
-
-<h2 id="6303">Raising Exceptions</h2>
-<p id="800671" class="block-content">
-Raising exceptions in PRADO has no difference than raising a normal PHP exception. The only thing matters is to raise the right exception. In general, exceptions meant to be shown to application users should use <tt>THttpException</tt>, while exceptions shown to developers should use other exception classes.
-</p>
-
-<h2 id="6304">Error Capturing and Reporting</h2>
-<p id="800672" class="block-content">
-Exceptions raised during the runtime of PRADO applications are captured by <tt>System.Exceptions.TErrorHandler</tt> module. Different output templates are used to display the captured exceptions. <tt>THttpException</tt> is assumed to contain error messages that are meant for application end users and thus uses a specific group of templates. For all other exceptions, a common template shown as follows is used for presenting the exceptions.
-</p>
-<a href="<%~ exception2.gif %>" target="_blank"><img src="<%~ exception.gif %>" alt="exception page" style="border:0px"/></a>
-
-<h2 id="6305">Customizing Error Display</h2>
-<p id="800673" class="block-content">
-Developers can customize the presentation of exception messages. By default, all error output templates are stored under <tt>framework/Exceptions/templates</tt>. The location can be changed by configuring <tt>TErrorHandler</tt> in application configuration,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_800226">
-<module id="error"
- class="TErrorHandler"
- ErrorTemplatePath="Application.ErrorTemplates" />
-</com:TTextHighlighter>
-<p id="800674" class="block-content">
-<tt>THttpException</tt> uses a set of templates that are differentiated according to different <tt>StatusCode</tt> property value of <tt>THttpException</tt>. <tt>StatusCode</tt> has the same meaning as the status code in HTTP protocol. For example, a status code equal to 404 means the requested URL is not found on the server. The <tt>StatusCode</tt> value is used to select which output template to use. The output template files use the following naming convention:
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_800227">
- error<status code>-<language code>.html
-</com:TTextHighlighter>
-<p id="800675" class="block-content">
-where <tt>status code</tt> refers to the <tt>StatusCode</tt> property value of <tt>THttpException</tt>, and <tt>language code</tt> must be a valid language such as <tt>en</tt>, <tt>zh</tt>, <tt>fr</tt>, etc. When a <tt>THttpException</tt> is raised, PRADO will select an appropriate template for displaying the exception message. PRADO will first locate a template file whose name contains the status code and whose language is preferred by the client browser window. If such a template is not present, it will look for a template that has the same status code but without language code.
-</p>
-<p id="800676" class="block-content">
-The naming convention for the template files used for all other exceptions is as follows,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_800228">
- exception-<language code>.html
-</com:TTextHighlighter>
-<p id="800677" class="block-content">
-Again, if the preferred language is not found, PRADO will try to use <tt>exception.html</tt>, instead.
-</p>
-<div class="note">
-<b class="tip">CAUTION:</b> When saving a template file, please make sure the file is saved using UTF-8 encoding. On Windows, you may use <tt>Notepad.exe</tt> to accomplish such saving.
-</div>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/es/I18N.page b/demos/quickstart/protected/pages/Advanced/es/I18N.page deleted file mode 100755 index 1a559036..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/I18N.page +++ /dev/null @@ -1,360 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="6201">Internationalization (I18N) and Localization (L10N)</h1>
-<p id="790625" class="block-content">Many web application built with PHP will not have internationalization in mind when it was first written. It may be that it was not intended for use in languages and cultures. Internationalization is an important aspect due to the increase adoption of the Internet in many non-English speaking countries. The process of internationalization and localization will contain difficulties. Below are some general guidelines to internationalize an existing application.</p>
-
-<h2 id="6203">Separate culture/locale sensitive data</h2>
-
-<p id="790626" class="block-content">Identify and separate data that varies with culture. The most obvious are text/string/message. Other type of data should also be considered. The following list categorize some examples of culture sensitive data
-</p>
-
-<ul id="u1" class="block-content">
- <li> Strings, Messages, Text, in relatively small units (e.g. phrases, sentences, paragraphs, but not the full text of a book).</li>
- <li> Labels on buttons.</li>
- <li> Help files, large units of text, static text.</li>
- <li> Sounds.</li>
- <li> Colors.</li>
- <li> Graphics,Icons.</li>
- <li> Dates, Times.</li>
- <li> Numbers, Currency, Measurements.</li>
- <li> Phone numbers.</li>
- <li> Honorific and personal titles.</li>
- <li> Postal address.</li>
- <li> Page layout.</li>
-</ul>
-
-<p id="790627" class="block-content">If possible all manner of text should be isolated and store in a persistence format. These text include, application error messages, hard coded strings in PHP files, emails, static HTML text, and text on form elements (e.g. buttons).</p>
-
-<h2 id="6204">Configuration</h2>
-<p id="790628" class="block-content">To enable the localization features in PRADO, you need to add a few configuration options in your <a href="?page=Configurations.AppConfig">application configuration</a>.
-First you need to include the <tt>System.I18N.*</tt> namespace to your paths.
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_790203">
-<paths>
- <using namespace="System.I18N.*" />
-</paths>
-</com:TTextHighlighter>
-
-<p id="790629" class="block-content">Then, if you wish to translate some text in your application, you need to add one translation message data source.</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_790204">
-<module id="globalization" class="TGlobalization">
- <translation type="XLIFF"
- source="MyApp.messages"
- marker="@@"
- autosave="true" cache="true" />
-</module>
-</com:TTextHighlighter>
-
-<p id="790630" class="block-content">Where <tt>source</tt> in <tt>translation</tt> is the dot path to a directory
-where you are going to store your translate message catalogue. The <tt>autosave</tt>
-attribute if enabled, saves untranslated messages back into the message catalogue.
-With <tt>cache</tt> enabled, translated messages are saved in the application <tt>runtime/i18n</tt> directory.
-The <tt>marker</tt> value is used to surround any untranslated text.
-</p>
-
-<p id="790631" class="block-content">With the configuration complete, we can now start to localize your application. If you have <tt>autosave</tt> enabled, after running your application with some localization activity (i.e. translating some text), you will see a directory and a <tt>messages.xml</tt> created within your <tt>source</tt> directory.</p>
-
-<h2 id="6205">What to do with <tt>messages.xml</tt>?</h2>
-<p id="790632" class="block-content">The translation message catalogue file, if using <tt>type="XLIFF"</tt>, is a standardized translation message interchange XML format. You can edit the XML file using any UTF-8 aware editor. The format of the XML is something like the following.</p>
-
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_790205">
-<?xml version="1.0"?>
-<xliff version="1.0">
- <file original="I18N Example IndexPage"
- source-language="EN"
- datatype="plaintext"
- date="2005-01-24T11:07:53Z">
- <body>
-
-<trans-unit id="1">
-<source>Hello world.</source>
-<target>Hi World!!!</target>
-</trans-unit>
-
- </body>
- </file>
-</xliff>
-</com:TTextHighlighter>
-
-Each translation message is wrapped within a <tt>trans-unit</tt> tag, where <tt>source</tt> is the original message, and <tt>target</tt> is the translated message. Editors such as <a href="http://www.heartsome.net/EN/xlfedit.html">Heartsome XLIFF Translation Editor</a> can help in editing these XML files.
-
-
-<h2 id="6206">Setting and Changing Culture</h2>
-<p id="790633" class="block-content">Once globalization is enabled, you can access the globalization settings, such as, <tt>Culture</tt>, <tt>Charset</tt>, etc, using </p>
-<com:TTextHighlighter CssClass="source block-content" id="code_790206">
-$globalization = $this->getApplication()->getGlobalization();
-echo $globalization->Culture;
-$globalization->Charset= "GB-2312"; //change the charset
-</com:TTextHighlighter>
-
-<p id="790634" class="block-content">You also change the way the culture is determined by changing the <tt>class</tt> attribute in the module configuration. For example, to set the culture that depends on the browser settings, you can use the <tt>TGlobalizationAutoDetect</tt> class.
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_790207">
-<module id="globalization" class="TGlobalizationAutoDetect">
- ...
-</module>
-</com:TTextHighlighter>
-
-<p id="790635" class="block-content">You may also provide your own globalization class to change how the application culture is set.
-Lastly, you can change the globalization settings on page by page basis using <a href="?page=Configurations.Templates1#tct">template control tags</a>. For example, changing the <tt>Culture</tt> to "zh".</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790208">
-<%@ Application.Globalization.Culture="zh" %>
-</com:TTextHighlighter>
-
-<h2 id="6207">Localizing your PRADO application</h2>
-There are two areas in your application that may need message or string localization, in PHP code and in the templates. To localize strings within PHP, use the <tt>localize</tt> function detailed below. To localize text in the template, use the <a href="#ttranslate">TTranslate</a> component.
-<h2 id="6208">Using <tt>localize</tt> function to translate text within PHP</h2>
-
-<p id="790636" class="block-content">The <tt>localize</tt> function searches for a translated string that matches original from your translation source. First, you need to locate all the hard coded text in PHP that are displayed or sent to the end user. The following example localizes the text of the <tt>$sender</tt> (assuming, say, the sender is a button). The original code before localization is as follows.
-<com:TTextHighlighter CssClass="source block-content" id="code_790209">
-function clickMe($sender,$param)
-{
- $sender->Text="Hello, world!";
-}
-</com:TTextHighlighter>
-
-<p id="790637" class="block-content">The hard coded message "Hello, world!" is to be localized using the <tt>localize</tt> function. </p>
-<com:TTextHighlighter CssClass="source block-content" id="code_790210">
-function clickMe($sender,$param)
-{
- $sender->Text=Prado::localize("Hello, world!");
-}
-</com:TTextHighlighter>
-
-<h2 id="6209">Compound Messages</h2>
-
-<p id="790638" class="block-content">Compound messages can contain variable data. For example, in the message "There are 12 users online.", the integer 12 may change depending on some data in your application. This is difficult to translate because the position of the variable data may be difference for different languages. In addition, different languages have their own rules for plurals (if any) and/or quantifiers. The following example can not be easily translated, because the sentence structure is fixed by hard coding the variable data within message.</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_790211">
-$num_users = 12;
-$message = "There are " . $num_users . " users online.";
-</com:TTextHighlighter>
-
-This problem can be solved using the <tt>localize</tt> function with string substitution. For example, the <tt>$message</tt> string above can be constructed as follows.
-<com:TTextHighlighter CssClass="source block-content" id="code_790212">
-$num_users = 12;
-$message = Prado::localize("There are {num_users} users online.", array('num_users'=>$num_users));
-</com:TTextHighlighter>
-<p id="790639" class="block-content">Where the second parameter in <tt>localize</tt> takes an associative array with the key as the substitution to find in the text and replaced it with the associated value.
-The <tt>localize</tt> function does not solve the problem of localizing languages that have plural forms, the solution is to use <a href="#choice-format">TChoiceFormat</a>.</p>
-
-<p id="790640" class="block-content">The following sample demonstrates the basics of localization in PRADO.</p>
-<com:RunBar PagePath="Advanced.Samples.I18N.Home" />
-
-<h1 id="6202">I18N Components</h1>
-<a name="ttranslate"></a>
-<h2 id="6210">TTranslate</h2>
-<p id="790641" class="block-content">Messages and strings can be localized in PHP or in templates.
-To translate a message or string in the template, use <tt>TTranslate</tt>.</p>
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790213">
-<com:TTranslate>Hello World</com:TTranslate>
-<com:TTranslate Text="Goodbye" />
-</com:TTextHighlighter>
-
-<p id="790642" class="block-content"><tt>TTranslate</tt> can also perform string substitution.
-The <tt>Parameters</tt> property can be use to add name values pairs for substitution. Substrings in the translation enclosed with "{" and "}" are consider as the
- parameter names during substitution lookup. The following example will substitute the substring "{time}" with the value of the parameter attribute "<tt>Parameters.time=<%= time() %></tt>".
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790214">
-<com:TTranslate Parameters.time=<%= time() %> >
-The time is {time}.
-</com:TTranslate>
-</com:TTextHighlighter>
-
-<p id="790643" class="block-content">A short for <tt>TTranslate</tt> is also provided using the following syntax.</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790215">
-<%[string]%>
-</com:TTextHighlighter>
-<p id="790644" class="block-content">where string will be translated to different languages according to the end-user's language preference. This syntax can be used with attribute values as well.</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790216">
-<com:TLabel Text="<%[ Hello World! ]%>" />
-</com:TTextHighlighter>
-
-<h2 id="6211">TDateFormat</h2>
-<p id="790645" class="block-content">Formatting localized date and time is straight forward.</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790217">
-<com:TDateFormat Value="12/01/2005" />
-</com:TTextHighlighter>
-
-<p id="790646" class="block-content">The <tt>Pattern</tt> property accepts 4 predefined localized date patterns and 4 predefined localized time patterns.</p>
-<ul id="u2" class="block-content">
- <li><tt>fulldate</tt></li>
- <li><tt>longdate</tt></li>
- <li><tt>mediumdate</tt></li>
- <li><tt>shortdate</tt></li>
- <li><tt>fulltime</tt></li>
- <li><tt>longtime</tt></li>
- <li><tt>mediumtime</tt></li>
- <li><tt>shorttime</tt></li>
-</ul>
-<p id="p1" class="block-content">
-The predefined can be used in any combination. If using a combined predefined pattern,
-the first pattern must be the date, followed by a space, and lastly the time pattern.
-For example, full date pattern with short time pattern. The actual ordering of the
-date-time and the actual pattern will be determine automatically from locale data specified
-by the <tt>Culture</tt> property.</p>
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790218">
-<com:TDateFormat Pattern="fulldate shorttime" />
-</com:TTextHighlighter>
-
-<p id="790647" class="block-content">You can also specify a custom pattern using the following sub-patterns.
-The date/time format is specified by means of a string time pattern. In this pattern, all ASCII letters are reserved as pattern letters, which are defined as the following:
-<com:TTextHighlighter Language="text" CssClass="source block-content" id="code_790219">
- Symbol Meaning Presentation Example
- ------ ------- ------------ -------
- G era designator (Text) AD
- y year (Number) 1996
- M month in year (Text & Number) July & 07
- d day in month (Number) 10
- h hour in am/pm (1~12) (Number) 12
- H hour in day (0~23) (Number) 0
- m minute in hour (Number) 30
- s second in minute (Number) 55
- E day of week (Text) Tuesday
- D day in year (Number) 189
- F day of week in month (Number) 2 (2nd Wed in July)
- w week in year (Number) 27
- W week in month (Number) 2
- a am/pm marker (Text) PM
- k hour in day (1~24) (Number) 24
- K hour in am/pm (0~11) (Number) 0
- z time zone (Time) Pacific Standard Time
- ' escape for text (Delimiter) 'Date='
- '' single quote (Literal) 'o''clock'
-</com:TTextHighlighter>
-</p>
-
-<p id="790648" class="block-content">The count of pattern letters determine the format.</p>
-
-<p id="790649" class="block-content">(Text): 4 letters uses full form, less than 4, use short or abbreviated form
-if it exists. (e.g., "EEEE" produces "Monday", "EEE" produces "Mon")</p>
-
-<p id="790650" class="block-content">(Number): the minimum number of digits. Shorter numbers are zero-padded
- to this amount (e.g. if "m" produces "6", "mm" produces "06"). Year is
- handled specially; that is, if the count of 'y' is 2, the Year will be
- truncated to 2 digits. (e.g., if "yyyy" produces "1997", "yy" produces "97".)
- Unlike other fields, fractional seconds are padded on the right with zero.</p>
-
-<p id="790651" class="block-content">(Text and Number): 3 or over, use text, otherwise use number. (e.g.,
-"M" produces "1", "MM" produces "01", "MMM" produces "Jan", and "MMMM"
-produces "January".)</p>
-
-<p id="790652" class="block-content">Any characters in the pattern that are not in the ranges of ['a'..'z']
-and ['A'..'Z'] will be treated as quoted text. For instance, characters
-like ':', '.', ' ', and '@' will appear in the resulting time text
-even they are not embraced within single quotes.</p>
-
-<p id="790653" class="block-content">Examples using the US locale:
-
-<com:TTextHighlighter Language="text" CssClass="source block-content" id="code_790220">
-Format Pattern Result
--------------- -------
-"yyyy.MM.dd G 'at' HH:mm:ss" ->> 1996.07.10 AD at 15:08:56
-"EEE, MMM d, ''yy" ->> Wed, Jul 10, '96
-"h:mm a" ->> 12:08 PM
-"hh 'o''clock' a, z" ->> 12 o'clock PM, Pacific Daylight Time
-"K:mm a" ->> 0:00 PM
-"yyyy.MMMM.dd G hh:mm a" ->> 1996.July.10 AD 12:08 PM
-</com:TTextHighlighter>
-</p>
-
-<p id="790654" class="block-content">If the <tt>Value</tt> property is not specified, the current date and time is used.</p>
-
-<h2 id="6212">TNumberFormat</h2>
-<p id="790655" class="block-content">PRADO's Internationalization framework provide localized currency formatting and number formatting. Please note that the <tt>TNumberFormat</tt> component provides formatting only, it does not perform current conversion or exchange.</p>
-
-<p id="790656" class="block-content">Numbers can be formatted as currency, percentage, decimal or scientific
-numbers by specifying the <tt>Type</tt> attribute. The valid types are:</p>
-<ul id="u3" class="block-content">
- <li><tt>currency</tt></li>
- <li><tt>percentage</tt></li>
- <li><tt>decimal</tt></li>
- <li><tt>scientific</tt></li>
-</ul>
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790221">
-<com:TNumberFormat Type="currency" Value="100" />
-</com:TTextHighlighter>
-
-<p id="790657" class="block-content"><tt>Culture</tt> and <tt>Currency</tt> properties may be specified to format locale specific numbers. </p>
-
-<p id="790658" class="block-content">If someone from US want to see sales figures from a store in
-Germany (say using the EURO currency), formatted using the german
- currency, you would need to use the attribute <tt>Culture="de_DE"</tt> to get
-the currency right, e.g. 100,00$. The decimal and grouping separator is
-then also from the <tt>de_DE</tt> locale. This may lead to some confusion because
-people from US uses the "," (comma) as thousand separator. Therefore a <tt>Currency</tt>
-attribute is available, so that the output from the following example results in $100.00
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790222">
-<com:TNumberFormat Type="currency"
- Culture="en_US" Currency="EUR" Value="100" />
-</com:TTextHighlighter>
-</p>
-
-<p id="790659" class="block-content">The <tt>Pattern</tt> property determines the number of digits, thousand grouping
-positions, the number of decimal points and the decimal position. The actual characters that
-are used to represent the decimal points and thousand points are culture specific
-and will change automatically according to the <tt>Culture</tt> property. The valid
-<tt>Pattern</tt> characters are:</p>
-<ul id="u6" class="block-content">
- <li><tt># (hash)</tt> - represents the optional digits</li>
- <li><tt>0 (zero)</tt> - represents the mandatory digits, zero left filled</li>
- <li><tt>. (full stop)</tt> - the position of the decimal point (only 1 decimal point is allowed)</li>
- <li><tt>, (comma)</tt> - thousand point separation (up to 2 commas are allowed)</li>
-</ul>
-<p id="p2" class="block-content">
-For example, consider the <tt>Value="1234567.12345"</tt> and
-with <tt>Culture="en_US"</tt> (which uses "," for thousand point separator and "." for decimal separators).
-</p>
-<com:TTextHighlighter Language="text" CssClass="source block-content" id="code_790223">
-Pattern Output
-------- ------
-##,###.00 ->> 1,234,567.12
-##,###.## ->> 1,234,567.12345
-##,##.0000 ->> 1,23,45,67.1235
-##,###,##.0 ->> 12,345,67.1
-000,000,000.0 ->> 001,234,567.1
-</com:TTextHighlighter>
-</p>
-
-<h2 id="6213">TTranslateParameter</h2>
-<p id="790660" class="block-content">Compound messages, i.e., string substitution, can be accomplished with <tt>TTranslateParameter</tt>.
-In the following example, the strings "{greeting}" and "{name}" will be replace
-with the values of "Hello" and "World", respectively.The substitution string must be enclose with "{" and "}". The parameters can be further translated by using <tt>TTranslate</tt>.
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790224">
-<com:TTranslate>
- {greeting} {name}!
- <com:TTranslateParameter Key="name">World</com:TTranslateParameter>
- <com:TTranslateParameter Key="greeting">Hello</com:TTranslateParameter>
-</com:TTranslate>
-</com:TTextHighlighter>
-
-
-<a name="choice-format"></a>
-<h2 id="6214">TChoiceFormat</h2>
-
-<p id="790661" class="block-content">Using the <tt>localize</tt> function or <tt>TTranslate</tt> component to translate messages does not inform the translator the cardinality of the data required to determine the correct plural structure to use. It only informs them that there is a variable data, the data could be anything. Thus, the translator will be unable to determine with respect to the substitution data the correct plural, language structure or phrase to use . E.g. in English, to translate the sentence, "There are {number} of apples.", the resulting translation should be different depending on the <tt>number</tt> of apples.</p>
-
-<p id="790662" class="block-content">The <tt>TChoiceFormat</tt> component performs message/string choice translation. The following example demonstrated a simple 2 choice message translation.</p>
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790225">
-<com:TChoiceFormat Value="1"/>[1] One Apple. |[2] Two Apples</com:TChoiceFormat>
-</com:TTextHighlighter>
-
-<p id="790663" class="block-content">In the above example, the <tt>Value</tt> "1" (one), thus the translated string
-is "One Apple". If the <tt>Value</tt> was "2", then it will show "Two Apples".</p>
-
-<p id="790664" class="block-content">The message/string choices are separated by the pipe "|" followed by a set notation of the form.</p>
-<ul id="u7" class="block-content">
- <li><tt>[1,2]</tt> -- accepts values between 1 and 2, inclusive.</li>
- <li><tt>(1,2)</tt> -- accepts values between 1 and 2, excluding 1 and 2.</li>
- <li><tt>{1,2,3,4}</tt> -- only values defined in the set are accepted.</li>
- <li><tt>[-Inf,0)</tt> -- accepts value greater or equal to negative infinity
- and strictly less than 0</li>
-</ul>
-
-<p id="790665" class="block-content">Any non-empty combinations of the delimiters of square and round brackets are acceptable.
-The string chosen for display depends on the <tt>Value</tt> property. The <tt>Value</tt> is evaluated for each set until the <tt>Value</tt> is found to belong to a particular set.</p>
-
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/es/Logging.page b/demos/quickstart/protected/pages/Advanced/es/Logging.page deleted file mode 100755 index de67b5f6..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/Logging.page +++ /dev/null @@ -1,61 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="6101">Logging</h1>
-<p id="780615" class="block-content">
-PRADO provides a highly flexible and extensible logging functionality. Messages logged can be classified according to log levels and message categories. Using level and category filters, the messages can be further routed to different destinations, such as files, emails, browser windows, etc. The following diagram shows the basic architecture of PRADO logging mechanism,
-</p>
-<img src="<%~ logrouter.gif %>" alt="Log router" />
-
-<h2 id="6102">Using Logging Functions</h2>
-<p id="780616" class="block-content">
-The following two methods are provided for logging messages in PRADO,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_780201">
-Prado::log($message, $logLevel, $category);
-Prado::trace($message, $category);
-</com:TTextHighlighter>
-<p id="780617" class="block-content">
-The difference between <tt>Prado::log()</tt> and <tt>Prado::trace()</tt> is that the latter automatically selects the log level according to the application mode. If the application is in <tt>Debug</tt> mode, stack trace information is appended to the messages. <tt>Prado::trace()</tt> is widely used in the core code of the PRADO framework.
-</p>
-
-<h2 id="6103">Message Routing</h2>
-<p id="780618" class="block-content">
-Messages logged using the above two functions are kept in memory. To make use of the messages, developers need to route them to specific destinations, such as files, emails, or browser windows. The message routing is managed by <tt>System.Util.TLogRouter</tt> module. When plugged into an application, it can route the messages to different destination in parallel. Currently, PRADO provides three types of routes:
-</p>
-<ul id="u1" class="block-content">
- <li><tt>TFileLogRoute</tt> - filtered messages are stored in a specified log file. By default, this file is named <tt>prado.log</tt> under the runtime directory of the application. File rotation is provided.</li>
- <li><tt>TEmailLogRoute</tt> - filtered messages are sent to pre-specified email addresses.</li>
- <li><tt>TBrowserLogRoute</tt> - filtered messages are appended to the end of the current page output.</li>
-</ul>
-<p id="780619" class="block-content">
-To enable message routing, plug in and configure the <tt>TLogRouter</tt> module in application configuration,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_780202">
-<module id="log" class="System.Util.TLogRouter">
- <route class="TBrowserLogRoute"
- Levels="Info"
- Categories="System.Web.UI.TPage, System.Web.UI.WebControls" />
- <route class="TFileLogRoute"
- Levels="Warning, Error"
- Categories="System.Web" />
-</module>
-</com:TTextHighlighter>
-<p id="780620" class="block-content">
-In the above, the <tt>Levels</tt> and <tt>Categories</tt> specify the log and category filters to selectively retrieve the messages to the corresponding destinations.
-</p>
-
-<h2 id="6104">Message Filtering</h2>
-<p id="780621" class="block-content">
-Messages can be filtered according to their log levels and categories. Each log message is associated with a log level and a category. With levels and categories, developers can selectively retrieve messages that they are interested on.
-</p>
-<p id="780622" class="block-content">
-Log levels defined in <tt>System.Util.TLogger</tt> include : <tt>DEBUG</tt>, <tt>INFO</tt>, <tt>NOTICE</tt>, <tt>WARNING</tt>, <tt>ERROR</tt>, <tt>ALERT</tt>, <tt>FATAL</tt>. Messages can be filtered according log level criteria. For example, if a filter specifies <tt>WARNING</tt> and <tt>ERROR</tt> levels, then only those messages that are of <tt>WARNING</tt> and <tt>ERROR</tt> will be returned.
-</p>
-<p id="780623" class="block-content">
-Message categories are hierarchical. A category whose name is the prefix of another is said to be the ancestor category of the other category. For example, <tt>System.Web</tt> category is the ancestor of <tt>System.Web.UI</tt> and <tt>System.Web.UI.WebControls</tt> categories. Messages can be selectively retrieved using such hierarchical category filters. For example, if the category filter is <tt>System.Web</tt>, then all messages in the <tt>System.Web</tt> are returned. In addition, messages in the child categories, such as <tt>System.Web.UI.WebControls</tt>, are also returned.
-</p>
-<p id="780624" class="block-content">
-By convention, the messages logged in the core code of PRADO are categorized according to the namespace of the corresponding classes. For example, messages logged in <tt>TPage</tt> will be of category <tt>System.Web.UI.TPage</tt>.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/es/MasterContent.page b/demos/quickstart/protected/pages/Advanced/es/MasterContent.page deleted file mode 100755 index f99a64dc..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/MasterContent.page +++ /dev/null @@ -1,57 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5801">Master and Content</h1>
-<p id="750587" class="block-content">
-Pages in a Web application often share common portions. For example, all pages of this tutorial application share the same header and footer portions. If we repeatedly put header and footer in every page source file, it will be a maintenance headache if in future we want to something in the header or footer. To solve this problem, PRADO introduces the concept of master and content. It is essentially a decorator pattern, with content being decorated by master.
-</p>
-<p id="750588" class="block-content">
-Master and content only apply to template controls (controls extending <tt>TTemplateControl</tt> or its child classes). A template control can have at most one master control and one or several contents (each represented by a <tt>TContent</tt> control). Contents will be inserted into the master control at places reserved by <tt>TContentPlaceHolder</tt> controls. And the presentation of the template control is that of the master control with <tt>TContentPlaceHolder</tt> replaced by <tt>TContent</tt>.
-</p>
-<p id="750589" class="block-content">
-For example, assume a template control has the following template:
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_750192">
-<%@ MasterClass="MasterControl" %>
-<com:TContent ID="A" >
-content A
-</com:TContent >
-<com:TContent ID="B" >
-content B
-</com:TContent >
-<com:TContent ID="B" >
-content B
-</com:TContent >
-</com:TTextHighlighter>
-<p id="750590" class="block-content">
-which uses <tt>MasterControl</tt> as its master control. The master control has the following template,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_750193">
-other stuff
-<com:TContentPlaceHolder ID="A" />
-other stuff
-<com:TContentPlaceHolder ID="B" />
-other stuff
-<com:TContentPlaceHolder ID="C" />
-other stuff
-</com:TTextHighlighter>
-<p id="750591" class="block-content">
-Then, the contents are inserted into the master control according to the following diagram, while the resulting parent-child relationship can be shown in the next diagram. Note, the template control discards everything in the template other than the contents, while the master control keeps everything and replaces the content placeholders with the contents according to ID matching.
-</p>
-<img src=<%~ mastercontent.gif %> alt="Master and Content" />
-<img src=<%~ pcrelation.gif %> alt="Parent-child relationship between master and content" />
-
-<h2 id="6301">Master vs. External Template</h2>
-<p id="750592" class="block-content">
-Master is very similar to external templates which are introduced since version 3.0.5. A special <a href="?page=Configurations.Templates1">include tag</a> is used to include an external template file into a base template.
-</p>
-<p id="750593" class="block-content">
-Both master and external template can be used to share common contents among pages. A master is a template control whose template contains the common content and whose class file contains the logic associated with the master. An external template, on the other hand, is a pure template file without any class files.
-</p>
-<p id="750594" class="block-content">
-Therefore, use master control if the common content has to be associated with some logic, such as a page header with search box or login box. A master control allows you to specify how the common content should interact with end users. If you use external templates, you will have to put the needed logic in the page or control class who owns the base template.
-</p>
-<p id="750595" class="block-content">
-Performancewise, external template is lighter than master as the latter is a self-contained control participating the page lifecycles, while the former is used only when the template is being parsed.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/es/Performance.page b/demos/quickstart/protected/pages/Advanced/es/Performance.page deleted file mode 100755 index 7bdd4589..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/Performance.page +++ /dev/null @@ -1,88 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="6401">Performance Tuning</h1>
-<p id="810678" class="block-content">
-Performance of Web applications is affected by many factors. Database access, file system operations, network bandwidth are all potential affecting factors. PRADO tries in every effort to reduce the performance impact caused by the framework.
-</p>
-
-<h2 id="6402">Caching</h2>
-<p id="810679" class="block-content">
-PRADO provides a generic caching technique used by in several core parts of the framework. For example, when caching is enabled, <tt>TTemplateManager</tt> will save parsed templates in cache and reuse them in the following requests, which saves time for parsing templates. The <tt>TThemeManager</tt> adopts the similar strategy to deal with theme parsing.
-</p>
-<p id="810680" class="block-content">
-Enabling caching is very easy. Simply add the cache module in the application configuration, and PRADO takes care of the rest.
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_810229">
-<modules>
- <module id="cache" class="System.Caching.TSqliteCache" />
-</modules>
-</com:TTextHighlighter>
-
-<p id="810681" class="block-content">
-Developers can also take advantage of the caching technique in their applications. The <tt>Cache</tt> property of <tt>TApplication</tt> returns the plugged-in cache module when it is available. To save and retrieve a data item in cache, use the following commands,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_810230">
-if($application->Cache) {
- // saves data item in cache
- $application->Cache->set($keyName,$dataItem);
- // retrieves data item from cache
- $dataItem=$application->Cache->get($keyName);
-}
-</com:TTextHighlighter>
-<p id="810682" class="block-content">
-where <tt>$keyName</tt> should be a string that uniquely identifies the data item stored in cache.
-</p>
-
-<p id="840059" class="block-content">
-Since v3.1.0, a new control called <a href="?page=Controls.OutputCache">TOutputCache</a> has been introduced. This control allows users to selectively cache parts of a page's output. When used appropriately, this technique can significant improve pages' performance because the underlying controls are not created at all if the cached versions are hit.
-</p>
-
-<h2 id="6403">Using <tt>pradolite.php</tt></h2>
-<p id="810683" class="block-content">
-Including many PHP script files may impact application performance significantly. PRADO classes are stored in different files and when processing a page request, it may require including tens of class files.To alleviate this problem, in each PRADO release, a file named <tt>pradolite.php</tt> is also included. The file is a merge of all core PRADO class files with comments being stripped off and message logging removed.
-</p>
-<p id="810684" class="block-content">
-To use <tt>pradolite.php</tt>, in your application entry script, replace the inclusion of <tt>prado.php</tt> with <tt>pradolite.php</tt>.
-</p>
-
-<h2 id="6404">Changing Application Mode</h2>
-<p id="810685" class="block-content">
-Application mode also affects application performance. A PRADO application can be in one of the following modes: <tt>Off</tt>, <tt>Debug</tt>, <tt>Normal</tt> and <tt>Performance</tt>. The <tt>Debug</tt> mode should mainly be used during application development, while <tt>Normal</tt> mode is usually used in early stage after an application is deployed to ensure everything works correctly. After the application is proved to work stably for some period, the mode can be switched to <tt>Performance</tt> to further improve the performance.
-</p>
-<p id="810686" class="block-content">
-The difference between <tt>Debug</tt>, <tt>Normal</tt> and <tt>Performance</tt> modes is that under <tt>Debug</tt> mode, application logs will contain debug information, and under <tt>Performance</tt> mode, timestamp checking is not performed for cached templates and published assets. Therefore, under <tt>Performance</tt> mode, application may not run properly if templates or assets are modified. Since <tt>Performance</tt> mode is mainly used when an application is stable, change of templates or assets are not likely.
-</p>
-<p id="810687" class="block-content">
-To switch application mode, configure it in application configuration:
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_810231">
-<application Mode="Performance" >
- ......
-</application >
-</com:TTextHighlighter>
-
-<h2 id="6405">Reducing Page Size</h2>
-<p id="810688" class="block-content">
-By default, PRADO stores page state in hidden fields of the HTML output. The page state could be very large in size if complex controls, such as <tt>TDataGrid</tt>, is used. To reduce the size of the network transmitted page size, two strategies can be used.
-</p>
-<p id="810689" class="block-content">
-First, you may disable viewstate by setting <tt>EnableViewState</tt> to false for the page or some controls on the page if they do not need user interactions. Viewstate is mainly used to keep track of page state when a user interacts with that page/control.
-</p>
-<p id="810690" class="block-content">
-Second, you may use a different page state storage. For example, page state may be stored in session, which essentially stores page state on the server side and thus saves the network transmission time. The <tt>StatePersisterClass</tt> property of the page determines which state persistence class to use. By default, it uses <tt>System.Web.UI.TPageStatePersister</tt> to store persistent state in hidden fields. You may modify this property to a persister class of your own, as long as the new persister class implements the <tt>IPageStatePersister</tt> interface. You may configure this property in several places, such as application configuration or page configuration using <pages> or <page> tags,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_810232">
-<pages StatePersisterClass="MyPersister1" ... >
- <page ID="SpecialPage" StatePersisterClass="MyPersister2" ... />
-</pages>
-</com:TTextHighlighter>
-<p id="810691" class="block-content">
-Note, in the above the <tt>SpecialPage</tt> will use <tt>MyPersister2</tt> as its persister class, while the rest pages will use <tt>MyPersister1</tt>. Therefore, you can have different state persister strategies for different pages.
-</p>
-
-<h2 id="6406">Other Techniques</h2>
-<p id="810692" class="block-content">
-Server caching techniques are proven to be very effective in improving the performance of PRADO applications. For example, we have observed that by using Zend Optimizer, the RPS (request per second) of a PRADO application can be increased by more than ten times. Of course, this is at the cost of stale output, while PRADO's caching techniques always ensure the correctness of the output.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/es/Scripts.page b/demos/quickstart/protected/pages/Advanced/es/Scripts.page deleted file mode 100755 index cca6530e..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/Scripts.page +++ /dev/null @@ -1,397 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="6501">Introduction to Javascript</h1>
-This guide is based on the <a href="http://www.sergiopereira.com/articles/advjs.html">
-Quick guide to somewhat advanced JavaScript tour of some OO features</a> by Sergio Pereira.
-
-<h2 id="6502">Hey, I didn't know you could do that</h2>
-<p id="820693" class="block-content">
- If you are a web developer and come from the same place I do, you have probably
- used quite a bit of Javascript in your web pages, mostly as UI glue.
-</p>
-<p id="820694" class="block-content">
-
- Until recently, I knew that Javascript had more OO capabilities than I was employing,
- but I did not feel like I needed to use it. As the browsers started to support a more
- standardized featureset of Javascript and the DOM, it became viable to write more
- complex and functional code to run on the client. That helped giving birth to the
- AJAX phenomena.
-</p>
-<p id="820695" class="block-content">
- As we all start to learn what it takes to write our cool, AJAX applications, we begin
- to notice that the Javascript we used to know was really just the tip of the iceberg.
- We now see Javascript being used beyond simple UI chores like input validation and frivolous
- tasks. The client code now is far more advanced and layered, much like a real desktop
- application or a client-server thick client. We see class libraries, object models,
- hierarchies, patterns, and many other things we got used to seeing only in our server
- side code.
-</p>
-<p id="820696" class="block-content">
- In many ways we can say that suddenly the bar was put much higher than before. It takes
- a heck lot more proficiency to write applications for the new Web and we need to improve
- our Javascript skills to get there.
- If you try to use many of the existing javascript libraries out there, like
- <a href="http://prototype.conio.net/">Prototype.js</a>,
- <a href="http://script.aculo.us/">Scriptaculous</a>,
- <a href="http://moofx.mad4milk.net/">moo.fx</a>,
- <a href="http://bennolan.com/behaviour/">Behaviour</a>,
- <a href="http://developer.yahoo.net/yui/">YUI</a>,
- etc you'll eventually find yourself reading the JS code. Maybe because you want
- to learn how they do it, or because you're curious, or more often because that's the
- only way to figure out how to use it, since documentation does not seem to be highly
- regarded with most of these libraries. Whatever the case may be, you'll face some
- kung-fu techniques that will be foreign and scary if you haven't seen anything like
- that before.
-</p>
-
-<p id="820697" class="block-content">
- The purpose of this article is precisely explaining the types of constructs that
- many of us are not familiar with yet.
-</p>
-
-
-<h2 id="6503">JSON (JavaScript Object Notation)</h2>
-<p id="820698" class="block-content">
- JavaScript Object Notation (<a href="http://www.json.org/">JSON</a>,) is one of the new
- buzzwords popping up around the AJAX theme. JSON, simply put, is a way of
- declaring an object in Javascript. Let's see an example right away and note
- how simple it is.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820233">
-var myPet = { color: 'black', leg_count: 4, communicate: function(repeatCount){
-for(i=0;i<repeatCount;i++) alert('Woof!');} };
-</com:TTextHighlighter>
-
-<p id="820699" class="block-content">
- Let's just add little bit of formatting so it looks more like how we usually find out there:
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820234">
-var myPet =
-{
- color: 'black',
- legCount: 4,
- communicate: function(repeatCount)
- {
- for(i=0;i<repeatCount;i++)
- alert('Woof!');
- }
-};
-</com:TTextHighlighter>
-<p id="820700" class="block-content">
- Here we created a reference to an object with two properties (<tt>color</tt>
- and <tt>legCount</tt>) and a method (<tt>communicate</tt>.)
- It's not hard to figure out that the object's properties and methods
- are defined as a comma delimited list. Each of the members is introduced by name, followed
- by a colon and then the definition. In the case of the properties it is easy, just the value
- of the property. The methods are created by assigning an anonymous function, which we will
- explain better down the line.
- After the object is created and assigned to the variable <tt>myPet</tt>,
- we can use it like this:
-</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820235">
-alert('my pet is ' + myPet.color);
-alert('my pet has ' + myPet.legCount + ' legs');
-//if you are a dog, bark three times:
-myPet.communicate(3);
-</com:TTextHighlighter>
-<p id="820701" class="block-content">
- You'll see JSON used pretty much everywhere in JS these days, as arguments to functions,
- as return values, as server responses (in strings,) etc.
-</p>
-
-<h2 id="6504">What do you mean? A function is an object too?</h2>
-<p id="820702" class="block-content">
- This might be unusual to developers that never thought about that, but in JS a function is
- also an object. You can pass a function around as an argument to another function just like
- you can pass a string, for example. This is extensively used and very handy.
-</p>
-
-<p id="820703" class="block-content">
- Take a look at this example. We will pass functions to another function that will use them.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820236">
-var myDog =
-{
- bark: function()
- {
- alert('Woof!');
- }
-};
-
-var myCat =
-{
- meow: function()
- {
- alert('I am a lazy cat. I will not meow for you.');
- }
-};
-
-function annoyThePet(petFunction)
-{
- //let's see what the pet can do
- petFunction();
-}
-
-//annoy the dog:
-annoyThePet(myDog.bark);
-//annoy the cat:
-annoyThePet(myCat.meow);
-</com:TTextHighlighter>
-<p id="820704" class="block-content">
- Note that we pass myDog.bark and myCat.meow without appending parenthesis
- <tt>"()"</tt> to them. If we did that we would not be passing
- the function, rather we would be calling the method and passing the return value,
- <tt>undefined</tt> in both cases here.
-</p>
-
-<p id="820705" class="block-content">
- If you want to make my lazy cat start barking, you can easily do this:
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820237">
-myCat.meow = myDog.bark;
-myCat.meow(); //alerts 'Woof!'
-</com:TTextHighlighter>
-
-<h2 id="6505">Arrays, items, and object members</h2>
-<p id="820706" class="block-content">
- The following two lines in JS do the same thing.
-</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820238">
-var a = new Array();
-var b = [];
-</com:TTextHighlighter>
-<p id="820707" class="block-content">
- As I'm sure you already know, you can access individual items in an array
- by using the square brackets:
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820239">
-var a = ['first', 'second', 'third'];
-var v1 = a[0];
-var v2 = a[1];
-var v3 = a[2];
-</com:TTextHighlighter>
-<p id="820708" class="block-content">
-
- But you are not limited to numeric indices. You can access any member of a JS
- object by using its name, in a string. The following example creates an empty
- object, and adds some members by name.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820240">
-var obj = {}; //new, empty object
-obj['member_1'] = 'this is the member value';
-obj['flag_2'] = false;
-obj['some_function'] = function(){ /* do something */};
-</com:TTextHighlighter>
-<p id="820709" class="block-content">
- The above code has identical effect as the following:
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820241">
-var obj =
-{
- member_1:'this is the member value',
- flag_2: false,
- some_function: function(){ /* do something */}
-};
-</com:TTextHighlighter>
-
-<p id="820710" class="block-content">
- In many ways, the idea of objects and associative arrays (hashes) in JS are not
- distiguishable. The following two lines do the same thing too.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820242">
-obj.some_function();
-obj['some_function']();
-</com:TTextHighlighter>
-
-
-<h2 id="6506">Enough about objects, may I have a class now?</h2>
-<p id="820711" class="block-content">
-
- The great power of object oriented programming languages derive from the use
- of classes. I don't think I would have guessed how classes are defined in JS
- using only my previous experience with other languages. Judge for yourself.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820243">
-//defining a new class called Pet
-var Pet = function(petName, age)
-{
- this.name = petName;
- this.age = age;
-};
-
-//let's create an object of the Pet class
-var famousDog = new Pet('Santa\'s Little Helper', 15);
-alert('This pet is called ' + famousDog.name);
-</com:TTextHighlighter>
-<p id="820712" class="block-content">
- Let's see how we add a method to our <tt>Pet</tt> class. We will be using the
- <tt>prototype</tt> property that all classes have. The <tt>prototype</tt>
- property is an object that contains all the members that any object of the class will have.
- Even the default JS classes, like <tt>String</tt>, <tt>Number</tt>,
- and <tt>Date</tt> have a <tt>prototype</tt> object that we
- can add methods and properties to and make any object of that class automatically gain this new member.
-</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820244">
-Pet.prototype.communicate = function()
-{
- alert('I do not know what I should say, but my name is ' + this.name);
-};
-</com:TTextHighlighter>
-<p id="820713" class="block-content">
- That's when a library like <a href="http://www.sergiopereira.com/articles/prototype.js.html">prototype.js</a> comes in
- handy. If we are using prototype.js, we can make our code look cleaner (at least in my opinion.)
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820245">
-var Pet = Class.create();
-Pet.prototype =
-{
- //our 'constructor'
- initialize: function(petName, age)
- {
- this.name = petName;
- this.age = age;
- },
-
- communicate: function()
- {
- alert('I do not know what I should say, but my name is ' + this.name);
- }
-};
-</com:TTextHighlighter>
-
-<h2 id="6507">Functions as arguments, an interesting pattern</h2>
-<p id="820714" class="block-content">
- If you have never worked with languages that support closures
- you may find the following idiom too funky.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820246">
-var myArray = ['first', 'second', 'third'];
-myArray.each( function(item, index)
-{
- alert('The item in the position #' + index + ' is:' + item);
-});
-</com:TTextHighlighter>
-<p id="820715" class="block-content">
-
- Whoa! Let's explain what is going on here before you decide I've gone too
- far and navigate to a better article than this one.
-</p>
-<p id="820716" class="block-content">
- First of all, in the above example we are using the prototype.js library, which
- adds the each function to the Array class. The each function accepts one
- argument that is a function object. This function, in turn, will be called once
- for each item in the array, passing two arguments when called, the item and the index
- for the current item. Let's call this function our iterator function.
- We could have also written the code like this.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820247">
-function myIterator(item, index)
-{
- alert('The item in the position #' + index + ' is:' + item);
-}
-
-var myArray = ['first', 'second', 'third'];
-myArray.each( myIterator );
-</com:TTextHighlighter>
-<p id="820717" class="block-content">
- But then we would not be doing like all the cool kids in school, right?
- More seriously, though, this last format is simpler to understand but causes
- us to jump around in the code looking for the myIterator function. It's nice
- to have the logic of the iterator function right there in the same place
- it's called. Also, in this case, we will not need the iterator function anywhere
- else in our code, so we can transform it into an anonymous function without penalty.
-</p>
-
-<h2 id="6508">This is <tt>this</tt> but sometimes <tt>this</tt> is also that</h2>
-<p id="820718" class="block-content">
-
- One of the most common troubles we have with JS when we start writing our code
- it the use of the <tt>this</tt> keyword. It could be a real
- tripwire.
-</p>
-<p id="820719" class="block-content">
- As we mentioned before, a function is also an object in JS, and sometimes we
- do not notice that we are passing a function around.
-</p>
-<p id="820720" class="block-content">
- Take this code snippet as an example.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820248">
-function buttonClicked()
-{
- alert('button ' + this.id + ' was clicked');
-}
-
-var myButton = document.getElementById('someButtonID');
-var myButton2 = document.getElementById('someOtherButtonID');
-myButton.onclick = buttonClicked;
-myButton2.onclick = buttonClicked;
-</com:TTextHighlighter>
-<p id="820721" class="block-content">
- Because the buttonClicked function is defined outside any object we may tend to
- think the <tt>this</tt> keyword will contain a reference to
- the <tt>window</tt> or <tt>document</tt>
- object (assuming this code is in the middle of an HTML page viewed in a browser.)
-</p>
-
-<p id="820722" class="block-content">
- But when we run this code we see that it works as intended and displays the <tt>id</tt> of
- the clicked button. What happened here is that we made the onclick method of each button contain the
- <tt>buttonClicked</tt> object reference, replacing whatever was there before. Now
- whenever the button is clicked, the browser will execute something similar to the following line.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820249">
-myButton.onclick();
-</com:TTextHighlighter>
-<p id="820723" class="block-content">
-
- That isn't so confusing afterall, is it? But see what happens you start having other
- objects to deal with and you want to act on these object upon events like the button's click.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820250">
-var myHelper =
-{
- formFields: [ ],
- emptyAllFields: function()
- {
- for(i=0; i < this.formFields.length; i++)
- {
- var elementID = this.formFields[i];
- var field = document.getElementById(elementID);
- field.value = '';
- }
- }
-};
-
-//tell which form fields we want to work with
-myHelper.formFields.push('txtName');
-myHelper.formFields.push('txtEmail');
-myHelper.formFields.push('txtAddress');
-
-//clearing the text boxes:
-myHelper.emptyAllFields();
-
-var clearButton = document.getElementById('btnClear');
-clearButton.onclick = myHelper.emptyAllFields;
-</com:TTextHighlighter>
-<p id="820724" class="block-content">
- So you think, nice, now I can click the Clear button on my page and those three text boxes
- will be emptied. Then you try clicking the button only to get a runtime error. The error
- will be related to (guess what?) the <tt>this</tt> keyword.
- The problem is that <tt>this.formFields</tt> is not defined if
- <tt>this</tt> contains a referece to the button, which is
- precisely what's happening. One quick solution would be to rewrite our last line of code.
-</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820251">
-clearButton.onclick = function()
-{
- myHelper.emptyAllFields();
-};
-</com:TTextHighlighter>
-<p id="820725" class="block-content">
- That way we create a brand new function that calls our helper method within the helper object's context.
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/es/Scripts1.page b/demos/quickstart/protected/pages/Advanced/es/Scripts1.page deleted file mode 100755 index 96ab7760..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/Scripts1.page +++ /dev/null @@ -1,96 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="6601">Developer Notes for prototype.js</h1>
-This guide is based on the <a href="http://www.sergiopereira.com/articles/prototype.js.html">
-Developer Notes for prototype.js</a> by Sergio Pereira.
-
-<h2 id="6603">What is that?</h2>
-<p id="830726" class="block-content">
-In case you haven't already used it, <a href="http://prototype.conio.net">prototype.js</a> is a
- JavaScript library written by <a href="http://www.conio.net">Sam Stephenson</a>.
- This amazingly well thought and well written piece of <b>standards-compliant</b> code takes a lot of
- the burden associated with creating rich, highly interactive web pages that characterize the Web 2.0 off your back.
-</p>
-
-<p id="830727" class="block-content">
- If you tried to use this library recently, you probably noticed that documentation is not one
- of its strongest points. As many other developers before me, I got my head around prototype.js by
- reading the source code and experimenting with it. I thought it would be nice to take notes while
- I learned and share with everybody else.
-</p>
-<p id="830728" class="block-content">
- As you read the examples and the reference, developers familiar with the Ruby
- programming language will notice an intentional similarity between Ruby's
- built-in classes and many of the extensions implemented by this library.
-</p>
-
-
-<h2 id="6604">Using the <tt>$()</tt> function</h2>
-<p id="830729" class="block-content">
- The <tt>$()</tt> function is a handy shortcut to the all-too-frequent <tt>document.getElementById()</tt> function
- of the DOM. Like the DOM function, this one returns the element that has the id passed as an argument.
-</p>
-
-<p id="830730" class="block-content">
- Unlike the DOM function, though, this one goes further. You can pass more than one id and
- <tt>$()</tt> will return an <tt>Array</tt> object with
- all the requested elements. The example below should illustrate this.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_830252">
-<com:TClientScript UsingClientScripts="prado" />
-<div id="myDiv">
- <p id="830731" class="block-content">This is a paragraph</p>
-</div>
-
-<div id="myOtherDiv">
- <p id="830732" class="block-content">This is another paragraph</p>
-</div>
-
-<input type="button" value=Test1 onclick="test1();" />
-<input type="button" value=Test2 onclick="test2();" />
-
-<script type="text/javascript">
-/*<![CDATA[*/
-function test1()
-{
- var d = $('myDiv');
- alert(d.innerHTML);
-}
-
-function test2()
-{
- var divs = $('myDiv','myOtherDiv');
- for(i=0; i<divs.length; i++)
- {
- alert(divs[i].innerHTML);
- }
-}
-/*]]>*/
-</script>
-</com:TTextHighlighter>
-<p id="830733" class="block-content">
- Another nice thing about this function is that you can pass either the <tt>id</tt> string or the element object itself,
- which makes this function very useful when creating other functions that can also take either form of argument.
-</p>
-
-<h2 id="6605">Using the <tt>$F()</tt> function</h2>
-
-<p id="830734" class="block-content">
- The <tt>$F()</tt> function is a another welcome shortcut. It returns the value of any field input control,
- like text boxes or drop-down lists. The function can take as argument either the element <tt>id</tt> or the element object itself.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_830253">
-<input type="text" id="userName" value="Joe Doe" />
-<input type="button" value=Test3 onclick="test3();" />
-
-<script type="text/javascript">
-/*<![CDATA[*/
-function test3()
-{
- alert($F('userName'));
-}
-/*]]>*/
-</script>
-</com:TTextHighlighter>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/es/Scripts2.page b/demos/quickstart/protected/pages/Advanced/es/Scripts2.page deleted file mode 100755 index 5d88b065..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/Scripts2.page +++ /dev/null @@ -1,253 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="6701">DOM Events and Javascript</h1>
-
-<h2 id="6702">Basic event handling</h2>
-
-<p id="840735" class="block-content">The syntax for working with events looks like the code below.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840254">
-Event.observe(element, name, observer, [useCapture]);
-</com:TTextHighlighter>
-
-<p id="840736" class="block-content">Assuming for a moment that we want to observe when a link was clicked,
-we could do the following:</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840255">
-// <a id="clicker" href="http://foo.com">Click me</a>
-Event.observe('clicker', 'click', function(event)
-{
- alert('clicked!');
-});
-</com:TTextHighlighter>
-
-<p id="840737" class="block-content">If we wanted to get the element that fired the event, we'd do this:</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840256">
-Event.observe('clicker', 'click', function(event)
-{
- alert(Event.element(event));
-});
-</com:TTextHighlighter>
-
-<h2 id="6703">Observing keystrokes</h2>
-
-<p id="840738" class="block-content">If we wanted to observe keystrokes for the entire document, we could do the following:</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840257">
-Event.observe(document, 'keypress', function(event)
-{
- if(Event.keyCode(event) == Event.KEY_TAB)
- alert('Tab Pressed');
-});
-</com:TTextHighlighter>
-
-<p id="840739" class="block-content">And lets say we wanted to keep track of what has been typed :</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840258">
-Event.observe('search', 'keypress', function(event)
-{
- Element.update('search-results', $F(Event.element(event)));
-});
-</com:TTextHighlighter>
-
-<p id="840740" class="block-content">Prototype defines properties inside the event object for some
-of the more common keys, so feel free to dig around in Prototype to
-see which ones those are.</p>
-
-<p id="840741" class="block-content">A final note on keypress events; If you'd like to detect a
-left click you can use <tt>Event.isLeftClick(event)</tt>.</p>
-
-<h2 id="6704">Getting the coordinates of the mouse pointer</h2>
-
-<p id="840742" class="block-content">Drag and drop, dynamic element resizing, games, and
-much more all require the ability to track the X and Y location of
-the mouse. Prototype makes this fairly simple. The code below tracks
-the X and Y position of the mouse and spits out those values into
-an input box named mouse.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840259">
-Event.observe(document, 'mousemove', function(event)
-{
- $('mouse').value = "X: " + Event.pointerX(event) +
- "px Y: " + Event.pointerY(event) + "px";
-});
-</com:TTextHighlighter>
-
-<p id="840743" class="block-content">If we wanted to observe the mouse location when it was
-hovering over a certain element, we'd just change the document argument to
-the id or element that was relevant.</p>
-
-<h2 id="6705">Stopping Propagation</h2>
-
-<p id="840744" class="block-content"><tt>Event.stop(event)</tt> will stop the propagation of an event .</p>
-
-<h2 id="6706">Events, Binding, and Objects</h2>
-
-<p id="840745" class="block-content">Everything has been fairly straight forward so far, but things
-start getting a little trickier when you need to work with events in
-and object-oriented environment. You have to deal with binding and funky
-looking syntax that might take a moment to get your head around.</p>
-
-<p id="840746" class="block-content">Lets look at some code so you can get a better understanding of what I'm talking about.</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840260">
-EventDispenser = Class.create();
-EventDispenser.prototype =
-{
- initialize: function(list)
- {
- this.list = list;
-
- // Observe clicks on our list items
- $$(this.list + " li").each(function(item)
- {
- Event.observe(item, 'click', this.showTagName.bindEvent(this));
- }.bind(this));
-
- // Observe when a key on the keyboard is pressed.
- // In the observer, we check for
- // the tab key and alert a message if it is pressed.
- Event.observe(document, 'keypress', this.onKeyPress.bindEvent(this));
-
- // Observe our fake live search box. When a user types
- // something into the box, the observer will take that
- // value(-1) and update our search-results div with it.
- Event.observe('search', 'keypress', this.onSearch.bindEvent(this));
-
- Event.observe(document, 'mousemove', this.onMouseMove.bindEvent(this));
- },
-
- // Arbitrary functions to respond to events
- showTagName: function(event)
- {
- alert(Event.element(event).tagName);
- },
-
- onKeyPress: function(event)
- {
- var code = event.keyCode;
- if(code == Event.KEY_TAB)
- alert('Tab key was pressed');
- },
-
- onSearch: function(event)
- {
- Element.update('search-results', $F(Event.element(event)));
- },
-
- onMouseMove: function(event)
- {
- $('mouse').value = "X: " + Event.pointerX(event) +
- "px Y: " + Event.pointerY(event) + "px";
- }
-}
-</com:TTextHighlighter>
-<p id="840747" class="block-content">Whoa! What's going on here? Well, we've defined our a
-custom class <tt>EventDispenser</tt>. We're going to be using this class
-to setup events for our document. Most of this code is a
-rewrite of the code we looked at earlier except this time, we
-are working from inside an object.</p>
-
-<p id="840748" class="block-content">Looking at the <tt>initialize</tt> method, we can really see how
-things are different now. Take a look at the code below:</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840261">
-// Observe clicks on our list items
-$$(this.list + " li").each(function(item)
-{
- Event.observe(item, 'click', this.showTagName.bindEvent(this));
-}.bind(this));
-</com:TTextHighlighter>
-
-<p id="840749" class="block-content">We've got iterators, binding and all sorts of stuff going on.
-Lets break down what this chunk of code is doing.</p>
-
-<p id="840750" class="block-content">First we are hunting for a collection of elements based on
-it's CSS selector. This uses the Prototype selector function <tt>$$()</tt>.
-After we've found the list items we are dealing with we send
-those into an each iteration where we will add our observers.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840262">
-Event.observe(item, 'click', this.showTagName.bindEvent(this));
-</com:TTextHighlighter>
-
-<p id="840751" class="block-content">Now looking at the code above, you'll notice the <tt>bindEvent</tt> function.
-This takes the method before it <tt>showTagName</tt> and treats it as the
-method that will be triggered when, in this case,
-someone clicks one of our list items.</p>
-
-<p id="840752" class="block-content">You'll also notice we pass this as an argument to the <tt>bindEvent</tt> function.
-This simply allows us to reference the object in context <tt>EventDispenser</tt>
-inside our function <tt>showTagName(event)</tt>. If the <tt>showTagName</tt> function
-requires additional parameters, you can attach them to the later parameters of <tt>bindEvent</tt>. For example</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840263">
-this.showTagName.bindEvent(this, param1, param2);
-
-//where the showTagName function is defined as
-showTime : function (event, param1, param2) { ... }
-</com:TTextHighlighter>
-
-<p id="840753" class="block-content">Moving on, you'll see <tt>bind(this)</tt> attached to our iterator function.
-This really has nothing to do with events, it is only here to allow me to
-use <tt>this</tt> inside the iterator. If we did not use <tt>bind(this)</tt>, I could not
-reference the method <tt>showTagName</tt> inside the iterator.</p>
-
-<p id="840754" class="block-content">Ok, so we'll move on to looking at our methods that actually get
-called when an event occurs. Since we've been dealing with <tt>showTagName</tt>, lets look at it.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840264">
-showTagName: function(event)
-{
- alert(Event.element(event).tagName);
-}
-</com:TTextHighlighter>
-
-<p id="840755" class="block-content">As you can see, this function accepts one argument--the event.
-In order for us to get the element which fired the event we need to
-pass that argument to <tt>Event.element</tt>. Now we can manipulate it at will.</p>
-
-<p id="840756" class="block-content">This covers the most confusing parts of our code. The text above is also
-relevant to the remaining parts of our code. If there is anything about
-this you don't understand, feel free to ask questions in the forum.</p>
-
-<h2 id="6707">Removing Event Listeners</h2>
-
-<p id="840757" class="block-content">This one threw me for a loop the first time I tried to use it.
-I tried something similar to what I did in the <tt>Event.observe</tt>
-call with the exception of using <tt>stopObserving</tt>, but nothing seemed
-to change. In other words, the code below does <b>NOT</b> work.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840265">
-$$(this.list + " li").each(function(item)
-{
- Event.stopObserving(item, 'click', this.showTagName);
-}.bind(this));
-</com:TTextHighlighter>
-
-<p id="840758" class="block-content">What's the deal here? The reason this does not work is because there
-is no pointer to the observer. This means that when we passed <tt>this.showTagName</tt>
-in the <tt>Event.observe</tt> method before hand, we passed it as an
-anonymous function. We can't reference an anonymous function
-because it simply does not have a pointer.</p>
-
-<p id="840759" class="block-content">So how do we get the job done? All we need to do is give the
-observing function a pointer, or the jargon free version: Set a variable
-that points to <tt>this.showTagName</tt>. Ok, lets change our code a bit.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840266">
-this.showTagObserver = this.showTagName.bindEvent(this);
-
-// Observe clicks on our list items
-$$(this.list + " li").each(function(item)
-{
- Event.observe(item, 'click', this.showTagObserver);
-}.bind(this));
-</com:TTextHighlighter>
-
-<p id="840760" class="block-content">Now we can remove the event listeners from our list like this:</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840267">
-$$(this.list + " li").each(function(item)
-{
- Event.stopObserving(item, 'click', this.showTagObserver);
-}.bind(this));
-</com:TTextHighlighter>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/es/Scripts3.page b/demos/quickstart/protected/pages/Advanced/es/Scripts3.page deleted file mode 100755 index 37885abb..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/Scripts3.page +++ /dev/null @@ -1,39 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="6801">Javascript in PRADO, Questions and Answers</h1>
-<h2 id="6802">How do I include the Javascript libraries distributed with Prado?</h2>
-<p id="880060" class="block-content">The javascript libraries distributed with Prado can be found in the
-<tt>framework/Web/Javascripts/source</tt> directory. The <tt>packages.php</tt>
-file in that directory defines a list of available package names available
-to be loaded. They can be loaded as follows.
-</p>
-<ul id="u1" class="block-content"><li>Adding libraries in the template
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_850268">
-<com:TClientScript PradoScripts="effects" />
-</com:TTextHighlighter>
- </li>
- <li>Adding libraries in PHP code
- <com:TTextHighlighter Language="php" CssClass="source block-content" id="code_850269">
-$this->getPage()->getClientScript()->registerPradoScript("effects");
- </com:TTextHighlighter>
- </li>
-</ul>
-The available packaged libraries included in Prado are
-<ul id="u2" class="block-content">
- <li><tt>prado</tt> : basic PRADO javascript framework based on Prototype</li>
- <li><tt>effects</tt> : visual effects from script.aculo.us</li>
- <li><tt>ajax</tt> : ajax and callback related based on Prototype</li>
- <li><tt>validator</tt> : validation</li>
- <li><tt>logger</tt> : javascript logger and object browser</li>
- <li><tt>datepicker</tt> : datepicker</li>
- <li><tt>colorpicker</tt> : colorpicker</li>
-</ul>
-
-<p id="850761" class="block-content">The dependencies for each library are automatically resolved. Components
-that require a particular library will also automatically load the necessary libraries.
-For example, if you add a <tt>TDatePicker</tt> component on the page, the <tt>datepicker</tt>
-and its dependencies will be automatically included on the page.</p>
-
-<p id="850762" class="block-content">See <a href="?page=Controls.ClientScript">TClientScript</a> for options of adding
- your custom Javascript code to the page.</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/es/Security.page b/demos/quickstart/protected/pages/Advanced/es/Security.page deleted file mode 100755 index c3d0b511..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/Security.page +++ /dev/null @@ -1,79 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5601">Security</h1>
-
-<h2 id="5602">Viewstate Protection</h2>
-<p id="730563" class="block-content">
-Viewstate lies at the heart of PRADO. Viewstate represents data that can be used to restore pages to the state that is last seen by end users before making the current request. By default, PRADO uses hidden fields to store viewstate information.
-</p>
-<p id="730564" class="block-content">
-It is extremely important to ensure that viewstate is not tampered by end users. Without protection, malicious users may inject harmful code into viewstate and unwanted instructions may be performed when page state is being restored on server side.
-</p>
-<p id="730565" class="block-content">
-To prevent viewstate from being tampered, PRADO enforces viewstate HMAC (Keyed-Hashing for Message Authentication) check before restoring viewstate. Such a check can detect if the viewstate has been tampered or not by end users. Should the viewstate is modified, PRADO will stop restoring the viewstate and return an error message.
-</p>
-<p id="730566" class="block-content">
-HMAC check requires a private key that should be secret to end users. Developers can either manually specify a key or let PRADO automatically generate a key. Manually specified key is useful when the application runs on a server farm. To do so, configure <tt>TSecurityManager</tt> in application configuration,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_730186">
-<modules>
- <module id="security"
- class="TSecurityManager"
- ValidationKey="my private key" />
-</modules>
-</com:TTextHighlighter>
-<p id="730567" class="block-content">
-HMAC check does not prevent end users from reading the viewstate content. An added security measure is to encrypt the viewstate information so that end users cannot decipher it. To enable viewstate encryption, set the <tt>EnableStateEncryption</tt> of pages to true. This can be done in <a href="?page=Configurations.PageConfig">page configurations</a> or in page code. Note, encrypting viewstate may degrade the application performance. A better strategy is to store viewstate on the server side, rather than the default hidden field.
-</p>
-
-<h2 id="5603">Cross Site Scripting Prevention</h2>
-<p id="730568" class="block-content">
-Cross site scripting (also known as XSS) occurs when a web application gathers malicious data from a user. Often attackers will inject JavaScript, VBScript, ActiveX, HTML, or Flash into a vulnerable application to fool other application users and gather data from them. For example, a poorly design forum system may display user input in forum posts without any checking. An attacker can then inject a piece of malicious JavaScript code into a post so that when other users read this post, the JavaScript runs unexpectedly on their computers.
-</p>
-<p id="730569" class="block-content">
-One of the most important measures to prevent XSS attacks is to check user input before displaying them. One can do HTML-encoding with the user input to achieve this goal. However, in some situations, HTML-encoding may not be preferable because it disables all HTML tags.
-</p>
-<p id="730570" class="block-content">
-PRADO incorporates the work of <a href="http://pixel-apes.com/safehtml/">SafeHTML</a> and provides developers with a useful component called <tt>TSafeHtml</tt>. By enclosing content within a <tt>TSafeHtml</tt> component tag, the enclosed content are ensured to be safe to end users. In addition, the commonly used <tt>TTextBox</tt> has a <tt>SafeText</tt> property which contains user input that are ensured to be safe if displayed directly to end users.
-</p>
-
-<h2 id="5604">Cookie Attack Prevention</h2>
-<p id="730571" class="block-content">
-Protecting cookies from being attacked is of extreme important, as session IDs are commonly stored in cookies. If one gets hold of a session ID, he essentially owns all relevant session information.
-</p>
-<p id="730572" class="block-content">
-There are several countermeasures to prevent cookies from being attacked.
-</p>
-<ul id="u1" class="block-content">
- <li>An application can use SSL to create a secure communication channel and only pass the authentication cookie over an HTTPS connection. Attackers are thus unable to decipher the contents in the transferred cookies.</li>
- <li>Expire sessions appropriately, including all cookies and session tokens, to reduce the likelihood of being attacked.</li>
- <li>Prevent cross-site scripting (XSS) which causes arbitrary code to run in a user's browser and expose his cookies.</li>
- <li>Validate cookie data and detect if they are altered.</li>
-</ul>
-<p id="730573" class="block-content">
-PRADO implements a cookie validation scheme that prevents cookies from being modified. In particular, it does HMAC check for the cookie values if cookie validation is enable.
-</p>
-<p id="730574" class="block-content">
-Cookie validation is disabled by default. To enable it, configure the <tt>THttpRequest</tt> module as follows,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_730187">
-<modules>
- <module id="request" class="THttpRequest" EnableCookieValidation="true" />
-</modules>
-</com:TTextHighlighter>
-<p id="730575" class="block-content">
-To make use of cookie validation scheme provided by PRADO, you also need to retrieve cookies through the <tt>Cookies</tt> collection of <tt>THttpRequest</tt> by using the following PHP statements,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_730188">
-foreach($this->Request->Cookies as $cookie)
- // $cookie is of type THttpCookie
-</com:TTextHighlighter>
-<p id="730576" class="block-content">
-To send cookie data encoded with validation information, create new <tt>THttpCookie</tt> objects and add them to the <tt>Cookies</tt> collection of <tt>THttpResponse</tt>,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_730189">
-$cookie=new THttpCookie($name,$value);
-$this->Response->Cookies[]=$cookie;
-</com:TTextHighlighter>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/es/State.page b/demos/quickstart/protected/pages/Advanced/es/State.page deleted file mode 100755 index c43a9dff..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/State.page +++ /dev/null @@ -1,54 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="6001">Persistent State</h1>
-<p id="770606" class="block-content">
-Web applications often need to remember what an end user has done in previous page requests so that the new page request can be served accordingly. State persistence is to address this problem. Traditionally, if a page needs to keep track of user interactions, it will resort to session, cookie, or hidden fields. PRADO provides a new line of state persistence schemes, including view state, control state, and application state.
-</p>
-
-<h2 id="6002">View State</h2>
-<p id="770607" class="block-content">
-View state lies at the heart of PRADO. With view state, Web pages become stateful and are capable of restoring pages to the state that end users interacted with before the current page request. Web programming thus resembles to Windows GUI programming, and developers can think continuously without worrying about the round trips between end users and the Web server. For example, with view state, a textbox control is able to detect if the user input changes the content in the textbox.
-</p>
-<p id="770608" class="block-content">
-View state is only available to controls. View state of a control can be disabled by setting its <tt>EnableViewState</tt> property to false. To store a variable in view state, call the following,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_770197">
-$this->setViewState('Caption',$caption);
-</com:TTextHighlighter>
-<p id="770609" class="block-content">
-where <tt>$this</tt> refers to the control object, <tt>Caption</tt> is a unique key identifying the <tt>$caption</tt> variable stored in viewstate. To retrieve the variable back from view state, call the following,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_770198">
-$caption = $this->getViewState('Caption');
-</com:TTextHighlighter>
-
-<h2 id="6003">Control State</h2>
-<p id="770610" class="block-content">
-Control state is like view state in every aspect except that control state cannot be disabled. Control state is intended to be used for storing crucial state information without which a page or control may not work properly.
-</p>
-<p id="770611" class="block-content">
-To store and retrieve a variable in control state, use the following commands,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_770199">
-$this->setControlState('Caption',$caption);
-$caption = $this->getControlState('Caption');
-</com:TTextHighlighter>
-
-<h2 id="6004">Application State</h2>
-<p id="770612" class="block-content">
-Application state refers to data that is persistent across user sessions and page requests. A typical example of application state is the user visit counter. The counter value is persistent even if the current user session terminates. Note, view state and control state are lost if the user requests for a different page, while session state is lost if the user session terminates.
-</p>
-<p id="770613" class="block-content">
-To store and retrieve a variable in application state, use the following commands,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_770200">
-$application->setGlobalState('Caption',$caption);
-$caption = $application->getGlobalState('Caption');
-</com:TTextHighlighter>
-
-<h2 id="6005">Session State</h2>
-<p id="770614" class="block-content">
-PRADO encapsulates the traditional session management in <tt>THttpSession</tt> module. The module can be accessed from within any component by using <tt>$this->Session</tt>, where <tt>$this</tt> refers to the component object.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/es/Themes.page b/demos/quickstart/protected/pages/Advanced/es/Themes.page deleted file mode 100755 index 4e440ce5..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/Themes.page +++ /dev/null @@ -1,60 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5901">Themes and Skins</h1>
-
-<h2 id="5902">Introduction</h2>
-<p id="760596" class="block-content">
-Themes in PRADO provide a way for developers to provide a consistent look-and-feel across an entire web application. A theme contains a list of initial values for properties of various control types. When applying a theme to a page, all controls on that page will receive the corresponding initial property values from the theme. This allows themes to interact with the rich property sets of the various PRADO controls, meaning that themes can be used to specify a large range of presentational properties that other theming methods (e.g. CSS) cannot. For example, themes could be used to specify the default page size of all data grids across an application by specifying a default value for the <tt>PageSize</tt> property of the <tt>TDataGrid</tt> control.
-</p>
-
-<h2 id="5903">Understanding Themes</h2>
-<p id="760597" class="block-content">
-A theme is a directory consists of skin files, javascript files and CSS files. Any javascript or CSS files contained in a theme will be registered with the page that the theme is applied to. A skin is a set of initial property values for a particular control type. A control type may have one or several skins, each identified by a unique <tt>SkinID</tt>. When applying a theme to a page, a skin is applied to a control if the control type and the <tt>SkinID</tt> value both match to those of the skin. Note, if a skin has an empty <tt>SkinID</tt> value, it will apply to all controls of the particular type whose <tt>SkinID</tt> is not set or empty. A skin file consists of one or several skins, for one or several control types. A theme is the union of skins defined in all skin files.
-</p>
-
-<h2 id="5904">Using Themes</h2>
-<p id="760598" class="block-content">
-To use a theme, you need to set the <tt>Theme</tt> property of the page with the theme name, which is the theme directory name. You may set it in either <a href="?page=Configurations.PageConfig">page configurations</a> or in the constructor or <tt>onPreInit()</tt> method of the page. You cannot set the property after <tt>onPreInit()</tt> because by that time, child controls of the page are already created (skins must be applied to controls right after they are created.)
-</p>
-<p id="760599" class="block-content">
-To use a particular skin in the theme for a control, set <tt>SkinID</tt> property of the control in template like following,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_760194">
-<com:TButton SkinID="Blue" ... />
-</com:TTextHighlighter>
-<p id="760600" class="block-content">
-This will apply the 'Blue' skin to the button. Note, the initial property values specified by the 'Blue' skin will overwrite any existing property values of the button. Use stylesheet theme if you do not want them to be overwritten. To use stylesheet theme, set the <tt>StyleSheetTheme</tt> property of the page instead of <tt>Theme</tt> (you can have both <tt>StyleSheetTheme</tt> and <tt>Theme</tt>).
-</p>
-<p id="760601" class="block-content">
-To use the Javascript files and CSS files contained in a theme, a <tt>THead</tt> control must be placed on the page template. This is because the theme will register those files with the page and <tt>THead</tt> is the right place to load those files.
-</p>
-<p id="760602" class="block-content">
-It is possible to specify media types of CSS files contained in a theme. By default, a CSS file applies to all media types. If the CSS file is named like <tt>mystyle.print.css</tt>, it will be applied only to <tt>print</tt> media type. As another example, <tt>mystyle.screen.css</tt> applies to <tt>screen</tt> media only, and <tt>mystyle.css</tt> applies to all media types.
-</p>
-
-<h2 id="5905">Theme Storage</h2>
-<p id="760603" class="block-content">
-All themes by default must be placed under the <tt>[AppEntryPath]/themes</tt> directory, where <tt>AppEntryPath</tt> refers to the directory containing the application entry script. If you want to use a different directory, configure the <tt>BasePath</tt> and <tt>BaseUrl</tt> properties of the <tt>System.Web.UI.TThemeManager</tt> module in application configuration,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_760195">
-<service id="page" class="TPageService">
- <modules>
- <module id="theme"
- class="System.Web.UI.TThemeManager"
- BasePath="mythemes"
- BaseUrl="mythemes" />
- </modules>
-</service>
-</com:TTextHighlighter>
-
-<h2 id="5906">Creating Themes</h2>
-<p id="760604" class="block-content">
-Creating a theme involves creating the theme directory and writing skin files (and possibly Javascript and CSS files). The name of skin files must be terminated with <tt>.skin</tt>. The format of skin files are the same as that of control template files. Since skin files do not define parent-child presentational relationship among controls, you cannot place a component tag within another. And any static texts between component tags are discarded. To define the aforementioned 'Blue' skin for <tt>TButton</tt>, write the following in a skin file,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_760196">
-<com:TButton SkinID="Blue" BackColor="blue" />
-</com:TTextHighlighter>
-<p id="760605" class="block-content">
-As aforementioned, you can put several skins within a single skin file, or split them into several files. A commonly used strategy is that each skin file only contains skins for one type of controls. For example, <tt>Button.skin</tt> would contain skins only for the <tt>TButton</tt> control type.
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/es/exception.gif b/demos/quickstart/protected/pages/Advanced/es/exception.gif Binary files differdeleted file mode 100755 index 93b1a07f..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/exception.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Advanced/es/exception2.gif b/demos/quickstart/protected/pages/Advanced/es/exception2.gif Binary files differdeleted file mode 100755 index 5fe0e625..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/exception2.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Advanced/es/logrouter.gif b/demos/quickstart/protected/pages/Advanced/es/logrouter.gif Binary files differdeleted file mode 100755 index 5a74dfe1..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/logrouter.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Advanced/es/mastercontent.gif b/demos/quickstart/protected/pages/Advanced/es/mastercontent.gif Binary files differdeleted file mode 100755 index 9354d65c..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/mastercontent.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Advanced/es/pcrelation.gif b/demos/quickstart/protected/pages/Advanced/es/pcrelation.gif Binary files differdeleted file mode 100755 index c1960d74..00000000 --- a/demos/quickstart/protected/pages/Advanced/es/pcrelation.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Advanced/id/Assets.page b/demos/quickstart/protected/pages/Advanced/id/Assets.page deleted file mode 100755 index b34426ea..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/Assets.page +++ /dev/null @@ -1,69 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5701">Assets</h1>
-<p id="740577" class="block-content">
-Asset adalah file sumber daya (seperti gambar, suara, video, CSS stylesheet, javascript, dll.) yang dimiliki oleh kelas komponen tertentu. Assets disediakan bagi para pengguna Web. Untuk kegunaan dan kemudahan penyebaran kelas komponen terkait, asset harus berada bersama dengan file kelas komponen. Sebagai contoh, tombol toggle dapat memakai dua gambar, disimpan dalam file <tt>down.gif</tt> dan <tt>up.gif</tt>, untuk menampilkan kondisi toggle berbeda. Jika kita ingin file gambar disimpan di bawah direktori <tt>images</tt> di bawah akar dokumen server Web, tidak akan memembuat nyaman bagi para pengguna komponen tombol toggle, karena setiap kali mereka mengembangkan atau menyebarkan aplikasi baru, mereka harus meng-copy file gambar ke direktori tertentu itu secara manual. Untuk mengeliminir persyaratan ini, direktori relatif ke file kelas komponen harus digunakan untuk menyimpan file gambar. Strategi umum adalah menggunakan direktori yang berisi file kelas komponen untuk menyimpan file asset.
-</p>
-<p id="740578" class="block-content">
-Karena direktori yang berisi file kelas komponen biasanya tidak bisa diakses oleh pengguna Web, PRADO menerapkan skema penerbitan asset untuk menjadikan assets tersedia bagi para pengguna Web. Sebuah asset, setelah diterbitkan, akan mempunyai URL di mana para pengguna bisa mengambil file asset.
-</p>
-
-<h2 id="5702">Penerbitan Asset</h2>
-<p id="740579" class="block-content">
-PRADO menyediakan beberapa metode untuk penerbitan asset atau direktori yang berisi asset:
-</p>
-<ul id="u1" class="block-content">
-<li>Dalam file template, Anda dapat menggunakan <a href="?page=Configurations.Templates2#at">tag asset</a> guna menerbitkan asset dan mendapatkan URL-nya. Catatan, asset harus relatif ke direktori yang berisi file template.</li>
-<li>Dalam kode PHP, Anda dapat memanggil <tt>$object->publishAsset($assetPath)</tt> untuk menerbitkan asset dan mendapatkan URL-nya. <tt>$object</tt> di sini merujuk ke turunan <tt>TApplicationComponent</tt> atau kelas asalnya, dan <tt>$assetPath</tt> adalah file atau direktori relatif ke direktori yang berisi file kelas.</li>
-<li>Jika Anda ingin menerbitkan asset sesuka hati, Anda perlu memanggil <tt>TAssetManager::publishFilePath($path)</tt>.</li>
-</ul>
-<p id="740580" class="block-content">
-HATI-HATI: Berhati-hatilah dengan penerbitan asset, karena ia memberikan para pengguna Web mengakses ke file yang sebelumnya tidak dapat diakses. Pastikan bahwa Anda tidak menerbitkan file yang tidak ingin dilihat pengguna lain.
-</p>
-
-<h2 id="5703">Kustomisasi</h2>
-<p id="740581" class="block-content">
-Penerbitan asset diatur oleh modul <tt>System.Web.TAssetManager</tt>. Standarnya, semua file asset yang diterbitkan disimpan di bawah direktori <tt>[AppEntryPath]/assets</tt>, di mana <tt>AppEntryPath</tt> merujuk ke direktori yang berisi naskah entri aplikasi. Pastikan direktori <tt>assets</tt> bisa ditulisi oleh proses server Web. Anda dapat mengubah direktorinya ke direktori lain dengan mengkonfigurasi properti <tt>BasePath</tt> dan <tt>BaseUrl</tt> pada modul <tt>TAssetManager</tt> dalam konfigurasi aplikasi,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code1">
-<modules>
- <module id="asset"
- class="System.Web.TAssetManager"
- BasePath="Web.images"
- BaseUrl="images" />
-</modules>
-</com:TTextHighlighter>
-
-<h2 id="5704">Performansi</h2>
-<p id="740582" class="block-content">
-PRADO menggunakan teknik cache guna memastikan efisiensi penerbitan asset. Menerbitkan asset intinya memerlukan operasi copy file, yang mahal. Untuk menyimpan operasi copy file yang tidak diperlukan, <tt>System.Web.TAssetManager</tt> hanya menerbitkan asset saat ia memiliki waktu modifikasi file lebih baru daripada file yang pernah diterbitkan. Ketika aplikasi dijalankan dengan mode <tt>Performance</tt>, pemeriksaan cap waktu tersebut juga diabaikan.
-</p>
-<p id="740583" class="block-content">
-SARAN: Jangan menggunakan penerbitan asset secara berlebihan. Konsep asset dipakai terutama untuk membantu pemakaian ulang dan redistribusi kelas komponen agar lebih baik. Normalnya, Anda tidak akan menggunakan penerbitan asset untuk sumberdaya yang tidak terikat ke komponen mana pun dalam aplikasi. Sebagai contoh, Anda jangan menggunakan penerbitan asset untuk gambar yang digunakan terutama sebagai elemen desain (misalnya logo, gambar latar belakang, dll). Biarkan server Web melayani gambar ini secara langsung yang akan membantu meningkatkan performansi aplikasi Anda.
-</p>
-
-<h2 id="5705">Contoh Tombol Toggle</h2>
-<p id="740584" class="block-content">
-Sekarang kita menggunakan contoh tombol toggle untuk menjelaskan penggunaan asset. Kontrol menggunakan dua file gambar <tt>up.gif</tt> dan <tt>down.gif</tt>, yang disimpan di bawah direktori yang berisi file kelas. Ketika tombol dalam kondisi <tt>Up</tt>, kita ingin menampilkan gambar <tt>up.gif</tt>. Ini dapat dikerjakan seperti berikut,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code2">
-class ToggleButton extends TWebControl {
- ...
- protected function addAttributesToRender($writer) {
- ...
- if($this->getState()==='Up') {
- $url=$this->getAsset('up.gif');
- $writer->addAttribute('src',$url);
- }
- ...
- }
- ...
-}
-</com:TTextHighlighter>
-<p id="740585" class="block-content">
-Dalam contoh di atas, pemanggilan <tt>$this->getAsset('up.gif')</tt> akan menerbitkan file gambar <tt>up.gif</tt> dan mengembalikan URL untuk file gambar yang diterbitkan. URL kemudian disajikan sebagai atribut dari tag gambar HTML.
-</p>
-<p id="740586" class="block-content">
-Untuk meredistribusi <tt>ToggleButton</tt>, cukup paketkan bersama file kelas dan file gambar. Para pengguna <tt>ToggleButton</tt> cuma perlu untuk mengurai file, dan mereka bisa menggunakannya secara langsung tanpa mencemaskan mengenai ke mana meng-copy file gambar itu.
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/id/Auth.page b/demos/quickstart/protected/pages/Advanced/id/Auth.page deleted file mode 100755 index eb7ab026..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/Auth.page +++ /dev/null @@ -1,170 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5501">Otentikasi dan Otorisasi</h1>
-<p id="720549" class="block-content">
-Otentikasi adalah proses verifikasi apakah seseorang yang mengaku siapa dirinya. Biasanya menyangkut nama pengguna dan kata sandi, tapi bisa menyertakan metode lain dari mendemonstrasikan identitas, seperti kartu pintar, sidik jari, dll.
-</p>
-<p id="720550" class="block-content">
-Otorisasi adalah mendapatkan keterangan jika orang yang sekali teridentifikasi, diijinkan untuk memanipulasi sumber daya tertentu. Ini biasanya ditentukan dengan menyelidiki apakah orang itu memiliki aturan akses tertentu terhadap sumber daya atau tidak.
-</p>
-
-<h2 id="5502">Bagaimana Kerangka Kerja Otentikasi PRADO Bekerja</h2>
-<p id="720551" class="block-content">
-PRADO menyediakan kerangka kerja otentikasi/otorisasi yang dapat diperluas. Seperti dijelaskan dalam <a href="?page=Fundamentals.Applications">masa hidup aplikasi</a>, <tt>TApplication</tt> menyimpan beberapa masa hidup untuk modul yang bertanggung jawab terhadap otentikasi dan otorisasi. PRADO menyediakan modul <tt>TAuthManager</tt> untuk keperluan tersebut. Para pengembang dapat memasukan modul otentikasinya sendiri dengan mudah. <tt>TAuthManager</tt> didesain untuk dipakai bersama dengan modul <tt>TUserManager</tt>, yang menerapkan datbase pengguna hanya-baca.
-</p>
-<p id="720552" class="block-content">
-Ketika sebuah permintaan halaman terjadi, <tt>TAuthManager</tt> akan mencoba untuk mengembalikan informasi pengguna dari sesi. Jika tidak ada informasi pengguna yang ditemukan, pengguna dianggap sebagai pengguna anonim atau tamu. Guna menjembatani verifikasi identitas pengguna, <tt>TAuthManager</tt> menyediakan dua metode yang umum dipakai: <tt>login()</tt> dan <tt>logout()</tt>. Pengguna dimasukan (diverifikasi) jika entitas nama pengguna serta kata sandinya sama dengan rekaman dalam database pengguna yang diatur oleh <tt>TUserManager</tt>. Pengguna dikeluarkan jika informasi pengguna dihapus dari sesi dan dia perlu masuk lagi jika dia membuat permintaan baru terhadap halaman.
-</p>
-<p id="720553" class="block-content">
-Selama masa hidup aplikasi <tt>Otorisasi</tt>, yang terjadi setelah masa hidup <tt>Otentikasi</tt>, <tt>TAuthManager</tt> akan memverifikasi apakah pengguna saat ini mempunyai akses ke halaman yang diminta berdasarkan set aturan otorisasi. Otorisasi adalah berbasis-aturan, misalnya seorang pengguna memiliki akses ke sebuah halaman jika 1) halaman secara ekplisit menyatakan bahwa pengguna mempunyai akses; 2) atau pengguna adalah aturan tertentu yang memiliki akses ke halaman. Jika pengguna tidak mempunyai akses ke halaman, <tt>TAuthManager</tt> akan mengalihkan browser pengguna ke halaman masuk yang ditetapkan oleh properti <tt>LoginPage</tt>.
-</p>
-
-<h2 id="5503">Menggunakan Kerangka Kerja Otentikasi PRADO</h2>
-<p id="720554" class="block-content">
-Untuk menghidupkan kerangka kerja otentikasi PRADO, tambahkan modul <tt>TAuthManager</tt> dan modul <tt>TUserManager</tt> ke <a href="?page=Configurations.AppConfig">konfigurasi aplikasi</a>,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code1">
-<service id="page" class="TPageService">
- <modules>
- <module id="auth" class="System.Security.TAuthManager"
- UserManager="users" LoginPage="UserLogin" />
- <module id="users" class="System.Security.TUserManager"
- PasswordMode="Clear">
- <user name="demo" password="demo" />
- <user name="admin" password="admin" />
- </module>
- </modules>
-</service>
-</com:TTextHighlighter>
-<p id="720555" class="block-content">
-Di atas, properti <tt>UserManager</tt> dari <tt>TAuthManager</tt> disetel ke modul <tt>users</tt> yang adalah <tt>TUserManager</tt>. Para pengembang dapat menggantinya dengan modul manajemen pengguna yang berasal dari <tt>TUserManager</tt>.
-</p>
-<p id="720556" class="block-content">
-Aturan otorisasi untuk halaman ditetapkan dalam <a href="?page=Configurations.PageConfig">konfigurasi halaman</a> seperti berikut,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code2">
-<authorization>
- <allow pages="PageID1,PageID2"
- users="User1,User2"
- roles="Role1" />
- <deny pages="PageID1,PageID2"
- users="?"
- verb="post" />
-</authorization>
-</com:TTextHighlighter>
-<p id="720557" class="block-content">
-Aturan otorisasi bisa berupa aturan <tt>allow</tt> atau aturan <tt>deny</tt>. Setiap aturan terdiri dari empat properti opsional:
-</p>
-<ul id="u1" class="block-content">
-<li><tt>pages</tt> - daftar nama halaman dipisahkan koma yang menerapkan aturan ini. Jika kosong atau tidak disetel, aturan ini akan berlaku ke semua halaman di bawah direktori saat ini dan seluruh subdirektorinya secara rekursif.</li>
-<li><tt>users</tt> - daftar nama pengguna yang menerapkan aturan dipisahkan koma di mana aturan ini berlaku. Karakter * menunjukan semua pengguna termasuk pengguna anonim/tamu. Karakter ? menunjukan pengguna anonim/tamu . Dan karakter @ menunjukan pengguna terotentikasi (tersedia sejak v3.1).</li>
-<li><tt>roles</tt> - daftar aturan pengguna yang menerapkan aturan ini.</li>
-<li><tt>verb</tt> - metode akses halaman yang memberlakukan aturan ini. Ia bisa berupa <tt>get</tt> atau <tt>post</tt>. Jika kosong atau tidak disetel, aturan berlaku untuk kedua metode tersebut.</li>
-</ul>
-
-<p id="720558" class="block-content">
-Ketika permintaan halaman sedang diproses, daftar aturan otorisassi menjadi tersedia. Akan tetapi, hanya aturan <i>efektif yang pertama</i> <i>menyamai</i> pengguna saat ini akan menyajikan hasil otorisasi.
-</p>
-<ul id="u2" class="block-content">
-<li>Aturan diurut dari bawah-ke atas, misalnya aturan yang berisi dalam konfigurasi dari folder halaman saat ini menjadi yang pertama. Aturan dalam konfigurasi dari folder halaman leluhurnya menjadi yang berikutnya.</li>
-<li>Sebuah aturan efektif jika halaman saat ini dalam halaman yang didaftarkan pada aturan DAN aksi pengguna saat ini (<tt>get</tt> atau <tt>post</tt>) dalam aksi terdaftar.</li>
-<li>Sebuah aturan sama terjadi jika nama pengguna saat ini ada dalam daftar nama pengguna pada aturan <i>efektif</i> ATAU jika aturan pengguna ada dalam aturan terdaftar yang mengaturnya.</li>
-<li>Jika tidak ada aturan yang sama, pengguna diotorisasi.</li>
-</ul>
-<p id="720559" class="block-content">
-Dalam contoh di atas, pengguna anonim akan ditolak atas penulisan ke <tt>PageID1</tt> dan <tt>PageID2</tt>, sementara <tt>User1</tt> dan <tt>User2</tt> dan semua pengguna aturan <tt>Role1</tt> bisa mengakses dua halaman (baik metode <tt>get</tt> maupun <tt>post</tt>).
-</p>
-<com:SinceVersion Version="3.1.1" />
-<p class="block-content">
-Sejak versi 3.1.1, atribut <tt>pages</tt> dalam aturan otorisasi dapat mengambil path halaman relatif dengan '*'. Sebagai contoh, <tt>pages="admin.Home"</tt> merujuk ke halaman <tt>Home</tt> di bawah direktori <tt>admin</tt>, dan <tt>pages="admin.*"</tt> akan merujuk ke seluruh halaman di bawah direktori <tt>admin</tt> dan subdirektorinya.
-</p>
-
-<p class="block-content">
-Juga diperkenalkan dalam versi 3.1.1 adalah aturan IP. Ini ditetapkan oleh atribut baru <tt>ip</tt> dalam aturan otorisasi. Aturan IP dipakai untuk menentukan apakah aturan otorisasi berlaku ke pengguna-akhir berdasarkan alamat IP-nya. Seseorang dapat mendaftar beberapa IP sekaligus, dipisahkan dengan koma ','. Wildcard '*' dapat dipakai dalam aturan. Sebagai contoh, <tt>ip="192.168.0.2, 192.168.1.*"</tt> berarti aturan berlaku untuk para pengguna yang alamat IP-nya 192.168.0.2 atau 192.168.1.*. Yang kedua sama dengan setiap host dalam subnet 192.168.1.
-</p>
-
-<h2 id="5504">Menggunakan <tt>TUserManager</tt></h2>
-<p id="720560" class="block-content">
-Seperti telah disebutkan di atas, <tt>TUserManager</tt> menerapkan database pengguna hanya-baca. Informasi pengguna ditetapkan baik dalam konfigurasi aplikasi ataupun file XML eksternal.
-</p>
-<p id="720561" class="block-content">
-Kita telah melihat contoh di atas yang menggunakan dua pengguna ditetapkan dalam konfigurasi aplikasi. Sintaks lengkap atas penetapan pengguna dan informasi aturan adalah sebagai berikut,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code3">
-<user name="demo" password="demo" roles="demo,admin" />
-<role name="admin" users="demo,demo2" />
-</com:TTextHighlighter>
-<p id="720562" class="block-content">
-di mana atribut <tt>roles</tt> dalam elemen <tt>user</tt> adalah opsional. Aturan pengguna dapat ditetapkan baik dalam elemen <tt>user</tt> ataupun dalam elemen <tt>role</tt> terpisah.
-</p>
-
-<h2 id="5505">Menggunakan <tt>TDbUserManager</tt></h2>
-<p id="720563" class="block-content">
-<tt>TDbUserManager</tt> diperkenalkan dalam v3.1.0. Tujuan utamanya adalah untuk menyederhanakan tugas pengaturan akun pengguna yang disimpan dalam sebuah database. Ini membutuhkan para pengembang untuk menulis kelas pengguna yang mewakili informasi yang diperlukan untuk akun pengguna. Kelas pengguna harus diperluas dari <tt>TDbUser</tt>.
-</p>
-<p id="720564" class="block-content">
-Untuk menggunakan <tt>TDbUserManager</tt>, konfigurasi itu dalam konfigurasi aplikasi seperti berikut:
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code4">
-<module id="db"
- class="System.Data.TDataSourceConfig" ..../>
-<module id="users"
- class="System.Security.TDbUserManager"
- UserClass="Path.To.MyUserClass"
- ConnectionID="db" />
-<module id="auth"
- class="System.Security.TAuthManager"
- UserManager="users" LoginPage="Path.To.LoginPage" />
-</com:TTextHighlighter>
-
-</p>
-<p id="720565" class="block-content">
-Dalam contoh di atas, <tt>UserClass</tt> menetapkan bahwa kelas akan dipakai untuk membuat turunan pengguna. Kelas harus diperluas dari <tt>TDbUser</tt>. <tt>ConnectionID</tt> merujuk ke ID dari modul <tt>TDataSourceConfig</tt> yang menetapkan bagaimana untuk melakukan koneksi database guna mendapatkan informasi penggunanya.
-</p>
-<p id="720566" class="block-content">
-Kelas pengguna harus menerapkan dua metode abstrak dalam <tt>TDbUser</tt>: <tt>validateUser()</tt> dan <tt>createUser()</tt>. Karena informasi akun pengguna disimpan dalam sebuah database, kelas pengguna dapat menggunakan properti <tt>DbConnection</tt>-nya untuk menjangkau database.
-</p>
-<com:SinceVersion Version="3.1.1" />
-<p id="720567" class="block-content">
-Sejak versi 3.1.1, <tt>TAuthManager</tt> menyediakan dukungan guna membolehkan mengingat yang masuk dengan menyetel <tt>AllowAutoLogin</tt> menjadi true. Oleh karena itu, <tt>TDbUser</tt> menambahkan dua metode untuk memfasilitasi implementasi fitur ini. Dalam keadaan tertentu, dua metode baru diperkenalkan: <tt>createUserFromCookie()</tt> dan <tt>saveUserToCookie()</tt>. Para pengembang harus mengimplementasikan dua metode ini jika mengingat yang sudah masuk diperlukan. Di bawah ini adalah contoh implementasi:
-</p>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code5">
-public function createUserFromCookie($cookie)
-{
- if(($data=$cookie->Value)!=='')
- {
- $application=Prado::getApplication();
- if(($data=$application->SecurityManager->validateData($data))!==false)
- {
- $data=unserialize($data);
- if(is_array($data) && count($data)===3)
- {
- list($username,$address,$token)=$data;
- $sql='SELECT passcode FROM user WHERE LOWER(username)=:username';
- $command=$this->DbConnection->createCommand($sql);
- $command->bindValue(':username',strtolower($username));
- if($token===$command->queryScalar() && $token!==false && $address=$application->Request->UserHostAddress)
- return $this->createUser($username);
- }
- }
- }
- return null;
-}
-
-public function saveUserToCookie($cookie)
-{
- $application=Prado::getApplication();
- $username=strtolower($this->Name);
- $address=$application->Request->UserHostAddress;
- $sql='SELECT passcode FROM user WHERE LOWER(username)=:username';
- $command=$this->DbConnection->createCommand($sql);
- $command->bindValue(':username',strtolower($username));
- $token=$command->queryScalar();
- $data=array($username,$address,$token);
- $data=serialize($data);
- $data=$application->SecurityManager->hashData($data);
- $cookie->setValue($data);
-}
-</com:TTextHighlighter>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/id/Collections.page b/demos/quickstart/protected/pages/Advanced/id/Collections.page deleted file mode 100755 index e79da29c..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/Collections.page +++ /dev/null @@ -1,135 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5501">Koleksi</h1>
-<p id="710529" class="block-content">
-Koleksi adalah struktur data dasar dalam pemrograman. Sebagai tambahan pada pemrograman PHP, array dipakai secara luas untuk mewakili koleksi struktur data. Array PHP adalah campuran dari array berindeks-kardinal dan tabel campuran.
-</p>
-<p id="710530" class="block-content">
-Untuk menghidupkan manipulasi obyek-terorientasi atas koleksi, PRADO menyediakan kelas koleksi yang bertenaga. Diantaranya, <tt>TList</tt> dan <tt>TMap</tt> adalah yang paling mendasar dan biasanya melayani sebagai basis kelas untuk kelas koleksi lainnya. Karena banyak komponen PRADO memiliki properti yang bertipe koleksi, penting bagi para pengembang untuk menguasai pemakaian kelas koleksi PRADO.
-</p>
-
-<h2 id="5502">Menggunakan <tt>TList</tt></h2>
-<p id="710531" class="block-content">
-Obyek <tt>TList</tt> mewakili array berindeks-kardinal, misalnya array (obyek) dengan indeks 0, 1, 2, ...
-</p>
-<p id="710532" class="block-content">
-<tt>TList</tt> bisa dipakai seperti array PHP. Sebagai contoh,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code1">
-$list=new TList; // buat obyek list
-...
-$item=$list[$index]; // baca item pada indeks yang ditetapkan
-$list[]=$item; // tambah item di akhir
-$list[$index]=$item; // ganti item pada indeks yang ditetapkan
-unset($list[$index]); // hapus item di posisi $index
-if(isset($list[$index])) // uji apakah daftar memiliki item di posisi $index
-foreach($list as $index=>$item) // jelajahi setiap item dalam daftar
-</com:TTextHighlighter>
-
-<p id="710533" class="block-content">
-Untuk memperoleh jumlah item dalam daftar, gunakan properti <tt>Count</tt>. Catatan, jangan gunakan <tt>count($list)</tt>, karena ia selalu mengembalikan 1.
-</p>
-
-<p id="710534" class="block-content">
-Sebagai tambahan, <tt>TList</tt> menerapkan beberapa metode yang nyaman untuk dipakai secara umum guna memanipulasi data dalam sebuah daftar. Ini termasuk
-</p>
-<ul id="u1" class="block-content">
- <li><tt>clear()</tt>: membersihkan seluruh item dalam daftar.</li>
- <li><tt>contains()</tt>: menguji apakah daftar berisi item yang ditetapkan.</li>
- <li><tt>indexOf()</tt>: mendapatkan indeks berbasis-nol dari item yang ditetapkan dalam daftar.</li>
- <li><tt>toArray()</tt>: mengembalikan perwakilan array atas item dalam daftar.</li>
- <li><tt>copyFrom()</tt>: mempopulasikan daftar dengan data dari array atau obyek yang bisa dijelajahi (termasuk <tt>TList</tt>). Item yang sudah ada akan dihapus terlebih dahulu.</li>
- <li><tt>mergeWith()</tt>: menambahkan daftar dengan data dari array atau obyek yang bisa dijelajahi (termasuk <tt>TList</tt>).</li>
-</ul>
-
-<h3 id="5504">Menggunakan properti komponen berbasis-<tt>TList</tt></h3>
-<p id="710535" class="block-content">
-Seperti telah disebutkan di atas, banyak properti komponen PRADO didasarkan pada <tt>TList</tt> atau kelas koleksi berasal dari <tt>TList</tt>. Properti ini semuanya berbagi pemakaian tersebut di atas.
-</p>
-<p id="710536" class="block-content">
-Sebagai contoh, <tt>TControl</tt> (basis kelas untuk semua kontrol PRADO) mempunyai properti yang disebut <tt>Controls</tt> yang mewakili koleksi dari kontrol anak. Tipe <tt>Controls</tt> adalah <tt>TControlCollection</tt> yang memperluas <tt>TList</tt>. Oleh karena itu, untuk menambahkan kontrol anak baru, kita dapat menggunakan cara berikut,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code2">
-$control->Controls[]=$newControl;
-</com:TTextHighlighter>
-<p id="710537" class="block-content">
-Untuk menjelajahi melalui kontrol anak, kita bisa menggunakan,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code3">
-foreach($control->Controls as $childControl) ...
-</com:TTextHighlighter>
-<p id="710538" class="block-content">
-Controh lain adalah properti <tt>Items</tt>, tersedia dalam kontrol list, <tt>TRepeater</tt>, <tt>TDataList</tt> dan <tt>TDataGrid</tt>. Dalam kontrol ini, kelas leluhur dari <tt>Items</tt> adalah <tt>TList</tt>.
-</p>
-
-<h3 id="5505">Memperluas <tt>TList</tt></h3>
-<p id="710539" class="block-content">
-Seringkali kita ingin memperluas <tt>TList</tt> untuk melakukan operasi tambahan untuk setiap penambahan atau penghapusan sebuah item. Satu-satunya metode yang diperlukan kelas anak untuk mengganti adalah <tt>insertAt()</tt> dan <tt>removeAt()</tt>. Sebagai contoh, guna memastikan daftar hanya berisi item yang bertipe <tt>TControl</tt>, kita dapat mengganti <tt>insertAt()</tt> sebagai berikut,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code4">
-public function insertAt($index,$item)
-{
- if($item instanceof TControl)
- parent::insertAt($index,$item)
- else
- throw new Exception('TControl required.');
-}
-</com:TTextHighlighter>
-
-
-<h2 id="5503">Menggunakan <tt>TMap</tt></h2>
-<p id="710540" class="block-content">
-Obyek <tt>TMap</tt> mewakili tabel campuran (atau kami katakan array berindeks-string).
-</p>
-<p id="710541" class="block-content">
-Mirip dengan <tt>TList</tt>, <tt>TMap</tt> bisa dipakai layaknya sebuah array,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code5">
-$map=new TMap; // buat obyek map
-...
-$map[$key]=$value; // tambah pasangan kunci-nilai
-unset($map[$key]); // hapus nilai dengan kunci yang ditetapkan
-if(isset($map[$key])) // apakah map berisi kunci
-foreach($map as $key=>$value) // jelajahi item dalam map
-</com:TTextHighlighter>
-<p id="710542" class="block-content">
-Properti <tt>Count</tt> memberikan jumlah item dalam map sementara properti <tt>Keys</tt> mengembalikan daftar kunci yang dipakai dalam map.
-</p>
-
-<p id="710543" class="block-content">
-Metode berikut disediakan oleh <tt>TMap</tt> demi kenyamanan,
-</p>
-<ul id="u2" class="block-content">
- <li><tt>clear()</tt>: menghapus semua item dalam map.</li>
- <li><tt>contains()</tt>: menguji apakah map berisi kunci yang ditetapkan.</li>
- <li><tt>toArray()</tt>: mengembalikan perwakilan array dari item dalam map.</li>
- <li><tt>copyFrom()</tt>: mempopulasikan map dengan data dari array atau obyek yang bisa dijelajahi (termasuk <tt>TMap</tt>). Item yang sudah ada akan dihapus terlebih dulu.</li>
- <li><tt>mergeWith()</tt>: menambahkan map dengan data dari array atau obyek yang bisa dijelajahi (termasuk <tt>TMap</tt>).</li>
-</ul>
-
-<h3 id="5506">Penggunaan <tt>TAttributeCollection</tt></h3>
-<p id="710544" class="block-content">
-<tt>TAttributeCollection</tt> adalah kelas khusus yang diperluas dari <tt>TMap</tt>. Ia dipakai terutama oleh properti <tt>Attributes</tt> dari <tt>TControl</tt>.
-</p>
-Selain fungsionalitas normal yang disediakan oleh <tt>TMap</tt>, <tt>TAttributeCollection</tt> membolehkan anda untuk mendapatkan dan menyetel item koleksi seperti mendapatkan dan menyetel properti. Sebagai contoh,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code6">
-$collection->Label='value'; // sama dengan: $collection['Label']='value';
-echo $collection->Label; // sama dengan: echo $collection['Label'];
-</com:TTextHighlighter>
-<p id="710545" class="block-content">
-Catatan, dalam <tt>$collection</tt> di atas TIDAK mempunyai properti <tt>Label</tt>.
-</p>
-<p id="710546" class="block-content">
-Tidak seperti <tt>TMap</tt>, kunci dalam <tt>TAttributeCollection</tt> tidak sensitif huruf. Oleh karena itu <tt>$collection->Label</tt> sama dengan <tt>$collection->LABEL</tt>.
-</p>
-<p id="710547" class="block-content">
-Karena fitur baru di atas, ketika berhadapan dengan properti <tt>Attributes</tt> dari kontrol, kita dapat mengambil keuntungan dari konsep subproperti dan mengkonfigurasi nilai atribut kontrol dalam sebuah template seperti berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code7">
-<com:TButton Attributes.onclick="if(!confirm('Are you sure?')) return false;" .../>
-</com:TTextHighlighter>
-<p id="710548" class="block-content">
-yang menambahkan atribut bernama <tt>onclick</tt> ke kontrol <tt>TButton</tt>.
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/id/Error.page b/demos/quickstart/protected/pages/Advanced/id/Error.page deleted file mode 100755 index 419b390f..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/Error.page +++ /dev/null @@ -1,77 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="6301">Penanganan Kesalahan dan Laporan</h1>
-<p id="800666" class="block-content">
-PRADO menyediakan kerangka kerja penanganan kesalahan dan laporan lengkap berdasarkan pada mekanisme eksepsi dari PHP 5.
-</p>
-
-<h2 id="6302">Kelas Eksepsi</h2>
-<p id="800667" class="block-content">
-Kesalahan yang terjadi dalam aplikasi PRADO dapat diklasifikasikan ke dalam tiga kategori: kesalahan yang disebabkan oleh penguraian naskah PHP, kode yang salah (seperti memanggil fungsi yang tidak didefinisikan, menyetel properti yang tidak dikenal), dan yang disebabkan oleh pemakaian yang tidak benar pada aplikasi Web oleh pengguna klien (seperti mencoba untuk mengakses halaman terbatas). PRADO tidak dapat berhadapan dengan kesalahan kategori pertama karena tidak dapat ditangkap dalam kode PHP. PRADO menyediakan sebuah hirarki eksepsi untuk berhadapan dengan kategori kedua dan ketiga.
-</p>
-<p id="800668" class="block-content">
-Semua kesalahan dalam aplikasi PRADO digambarkan sebagai eksepsi. Basis kelas untuk seluruh eksepsi PRADO adalah <tt>TException</tt>. Ia menyediakan fungsionalitas internasionalisasi pesan bagi semua eksepsi sistem. Pesan kesalahan dapat diterjemahkan ke dalam bahasa yang berbeda tergantung pada preferensi bahasa browser pengguna.
-</p>
-<p id="800669" class="block-content">
-Eksepsi muncul karena pemakaian yang tidak benar dari kerangka kerja PRADO yang diturunkan dari <tt>TSystemException</tt>, yang bisa berupa salah satu dari kelas eksepsi berikut:
-</p>
-<ul id="u1" class="block-content">
-<li><tt>TConfigurationException</tt> - konfigurasi salah, seperti kesalahan dalam konfigurasi aplikasi, template kontrol, dll.</li>
-<li><tt>TInvalidDataValueException</tt> - nilai data tidak benar atau tidak diharapkan.</li>
-<li><tt>TInvalidDataTypeException</tt> - tipe data tidak benar atau tidak diharapkan.</li>
-<li><tt>TInvalidDataFormatException</tt> - format data tidak benar.</li>
-<li><tt>TInvalidOperationException</tt> - permintaan operasi tidak benar.</li>
-<li><tt>TPhpErrorException</tt> - kesalahan PHP dapat ditangkap, peringatan, perhatian, dll.</li>
-<li><tt>TSecurityException</tt> - kesalahan terkait dengan keamanan.</li>
-<li><tt>TIOException</tt> - kesalahan operasi IO, seperti kegagalan membuka file.</li>
-<li><tt>TDBException</tt> - kesalahan terkait dengan operasi database.</li>
-<li><tt>TNotSupportedException</tt> - kesalahan disebabkan oleh permintaan dari fitur yang tidak didukung.</li>
-<li><tt>THttpException</tt> - kesalahan untuk ditampilkan ke pengguna klien Web.</li>
-</ul>
-<p id="800670" class="block-content">
-Kesalahan karena pemakaian yang salah dari aplikasi Web oleh pengguna klien diturunkan dari <tt>TApplicationException</tt>.
-</p>
-
-<h2 id="6303">Memunculkan Eksepsi</h2>
-<p id="800671" class="block-content">
-Memunculkan eksepsi dalam PRADO tidak berbeda dengan memunculkan eksepsi normal PJHP. Satu hal yang sama adalah untuk memunculkan eksepsi yang benar. Secara umum, eksepsi yang ditujukan untuk ditampilkan ke pengguna aplikasi harus menggunakan <tt>THttpException</tt>, sementara eksepsi yang ditampilkan bagi para pengembang harus menggunakan kelas eksepsi lain.
-</p>
-
-<h2 id="6304">Penangkapan Kesalahan dan Pelaporan</h2>
-<p id="800672" class="block-content">
-Eksepsi muncul selama menjalankan aplikasi PRADO ditangkap oleh modul <tt>System.Exceptions.TErrorHandler</tt>. Template output berbeda dipakai untuk menampilkan eksepsi yang ditangkap. <tt>THttpException</tt> dianggap berisi pesan kesalahan yang ditujukan untuk aplikasi pengguna akhir dan kemudian menggunakan grup template khusus. Untuk semua eksepsi lainnya, template umum ditampilkan seperti berikut dipakai untuk menyajikan eksepsi.
-</p>
-<a href="<%~ exception2.gif %>" target="_blank"><img src="<%~ exception.gif %>" alt="exception page" style="border:0px"/></a>
-
-<h2 id="6305">Mengkustomisasi Tampilan Kesalahan</h2>
-<p id="800673" class="block-content">
-Para pengembang dapat mengkustomisasi penyajian pesan kesalahan. Standarnya, semua template output kesalahan disimpan dalam <tt>framework/Exceptions/templates</tt>. Lokasi dapat diubah dengan mengkonfigurasi <tt>TErrorHandler</tt> dalam konfigurasi aplikasi,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_800226">
-<module id="error"
- class="TErrorHandler"
- ErrorTemplatePath="Application.ErrorTemplates" />
-</com:TTextHighlighter>
-<p id="800674" class="block-content">
-<tt>THttpException</tt> menggunakan satu set template yang dibedakan berdasarkan pada nilai properti <tt>StatusCode</tt> yang berbeda dari <tt>THttpException</tt>. <tt>StatusCode</tt> memiliki arti yang sama seperti kode status dalam protokol HTTP. Sebagai contoh, kode status yang sama dengan 404 berarti URL yang diminta tidak ditemukan pada server. File template output menggunakan konvensi penamaan berikut:
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_800227">
- error<status code>-<language code>.html
-</com:TTextHighlighter>
-<p id="800675" class="block-content">
-di mana <tt>status code</tt> merujuk ke nilai properti <tt>StatusCode</tt> dari <tt>THttpException</tt>, dan <tt>kode bahasa</tt> harus bahasa yang benar seperti misalnya <tt>en</tt>, <tt>zh</tt>, <tt>fr</tt>, dll. Ketika <tt>THttpException</tt> muncul, PRADO akan memilih template yang sesuai untuk menampilkan pesan eksepsi. Pertama PRADO akan mencari file template yang namanya berisi kode status dan yang bahasanya lebih disukai oleh jendela browser klien. Jika template seperti itu tidak ada, ia akan mencari template yang memiliki kode status yang sama tapi tanpa kode bahasa.
-</p>
-<p id="800676" class="block-content">
-Konvensi penamaan untuk file template yang dipakai bagi semua eksepsi adalah sebagai berikut,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_800228">
- exception-<language code>.html
-</com:TTextHighlighter>
-<p id="800677" class="block-content">
-Sekali lagi, jika bahasa yang diinginkan tidak ditemukan, sebaliknya PRADO akan mencoba menggunakan <tt>exception.html</tt>.
-</p>
-<div class="note">
-<b class="tip">PERHATIAN:</b> Ketika menyimpan file template, pastikan file disimpan menggunakan pengkodean UTF-8. Pada Windows, Anda bisa menggunakan <tt>Notepad.exe</tt> untuk melakukan penyimpanan tersebut.
-</div>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/id/I18N.page b/demos/quickstart/protected/pages/Advanced/id/I18N.page deleted file mode 100755 index 16c234f6..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/I18N.page +++ /dev/null @@ -1,336 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="6201">Internasionalisasi (I18N) dan Lokalisasi (L10N)</h1>
-<p id="790625" class="block-content">Banyak aplikasi web dibangun dengan PHP tidak memikirkan internasionlisasi saat ia pertama kali ditulis. Itu mungkin dikarenakan tidak dimaksudkan untuk digunakan dalam bahasa dan kultur. Internasionalisasi adalah aspek penting karena meningkatkan adopsi Internet dalam banyak negara yang berbicara non-Ingris. Proses internasionalisasi dan lokalisasi akan menghadapi kesulitan. Di bawah adalah beberapa petunjuk umum untuk menginternasionalisasi aplikasi yang sudah ada.</p>
-
-<h2 id="6203">Pisahkan data sensitif kultur/lokal</h2>
-
-<p id="790626" class="block-content">Identifikasi dan pisahkan data yang beragam dengan kultur. Yang paling jelas adalah teks/string/pesan. Tipe lain dari data juga harus dipertimbangkan. Daftar berikut mengkategorikan beberapa contoh data sensitif kultur
-</p>
-
-<ul id="u1" class="block-content">
- <li> String, Pesan, Teks, dalam unit relatif kecil (misalnya prasa, kalimat, paragraf, tapi tidak teks lengkap dari buku).</li>
- <li> Label pada tombol.</li>
- <li> File bantuan, unit besar teks, teks statis.</li>
- <li> Suara.</li>
- <li> Warna.</li>
- <li> Grafik,Ikon.</li>
- <li> Tanggal, Jam.</li>
- <li> Angka, Kurs, Pengukuran.</li>
- <li> Nomor Telepon.</li>
- <li> Penghargaan dan titel personal.</li>
- <li> Alamat pos.</li>
- <li> Tata letak halaman.</li>
-</ul>
-
-<p id="790627" class="block-content">Bila memungkinkan semua ragam teks harus diisolasi dan disimpan dalam format persisten. Teks ini termasuk, pesan kesalahan aplikasi, string ditulis tangan dalam file PHP, email, teks statis HTML, dan teks pada elemen formulir (misalnya tombol).</p>
-
-<h2 id="6204">Konfigurasi</h2>
-<p id="790628" class="block-content">Untuk menghidupkan fitur lokalisasi dalam PRADO, Anda perlu menambahkan beberapa opsi konfigurasi dalam <a href="?page=Configurations.AppConfig">konfigurasi aplikasi</a> Anda.
-Pertama Anda perlu menyertakan namespace <tt>System.I18N.*</tt> ke path Anda.
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_790203">
-<paths>
- <using namespace="System.I18N.*" />
-</paths>
-</com:TTextHighlighter>
-
-<p id="790629" class="block-content">Kemudian, jika Anda ingin menerjemahkan beberapa teks dalam aplikasi Anda, perlu ditambahkan sumber data pesan terjemahan.</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_790204">
-<module id="globalization" class="TGlobalization">
- <translation type="XLIFF"
- source="MyApp.messages"
- marker="@@"
- autosave="true" cache="true" />
-</module>
-</com:TTextHighlighter>
-
-<p id="790630" class="block-content">Di mana <tt>source</tt> dalam <tt>translation</tt> adalah path titik ke direktori di mana Anda akan menyimpan katalog pesan terjemahan. Atribut <tt>autosave</tt> jika dihidupkan, menyimpan pesan tidak diterjemahkan kembali ke dalam katalog pesasn.
-Dengan menghidupkan <tt>cache</tt>, pesan yang diterjemahkan disimpan dalam direktori aplikasi <tt>runtime/i18n</tt>.
-Nilai <tt>marker</tt> dipakai untuk mengelilingi teks yang tidak diterjemahkan.
-</p>
-
-<p id="790631" class="block-content">Dengan konfigurasi lengkap, sekarang kita dapat mulai melokalisasi aplikasi Anda. Jika Anda menghidupkan <tt>autosave</tt>, setelah menjalankan aplikasi Anda dengan beberapa aktivitas lokalisasi (misalnya menterjemahkan beberapa teks), Anda akan melihat sebuah direktori dan <tt>messages.xml</tt> dibuat di dalam direktori <tt>source</tt>.</p>
-
-<h2 id="6205">Apa yang harus dilakukan dengan <tt>messages.xml</tt>?</h2>
-<p id="790632" class="block-content">File katalog pesan terjemahan, jika menggunakan <tt>type="XLIFF"</tt>, adalah format intechange XML pesan terjemahan distandarisasi. Anda bisa mengedit file XML menggunakan editor yang mampu menangani UTF-8. Format dari XML adalah sesuatu mirip seperti berikut ini.</p>
-
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_790205">
-<?xml version="1.0"?>
-<xliff version="1.0">
- <file original="I18N Example IndexPage"
- source-language="EN"
- datatype="plaintext"
- date="2005-01-24T11:07:53Z">
- <body>
-
-<trans-unit id="1">
-<source>Hello world.</source>
-<target>Hi World!!!</target>
-</trans-unit>
-
- </body>
- </file>
-</xliff>
-</com:TTextHighlighter>
-
-Setiap pesan terjemahan dilapisi dengan tag <tt>trans-unit</tt>, di mana <tt>source</tt> adalah pesan asli, dan <tt>target</tt> adalah pesan yang diterjemahkan. Editor seperti <a href="http://www.heartsome.net/EN/xlfedit.html">Heartsome XLIFF Translation Editor</a> dapat membantu mengedit file XML ini.
-
-
-<h2 id="6206">Menyetel dan Mengubah Kultur</h2>
-<p id="790633" class="block-content">Sekali globalisasi dihidupkan, Anda dapat mengakses setelan globalisasi, seperti <tt>Culture</tt>, <tt>Charset</tt>, dll, menggunakan </p>
-<com:TTextHighlighter CssClass="source block-content" id="code_790206">
-$globalization = $this->getApplication()->getGlobalization();
-echo $globalization->Culture;
-$globalization->Charset= "GB-2312"; //ubah charset
-</com:TTextHighlighter>
-
-<p id="790634" class="block-content">Anda juga mengubah cara kultur ditentukan dengan mengubah atribut <tt>class</tt> dalam konfigurasi modul. Sebagai contoh, untuk menyetel kultur yang tergantung pada setelan browser, Anda bisa menggunakan kelas <tt>TGlobalizationAutoDetect</tt>.
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_790207">
-<module id="globalization" class="TGlobalizationAutoDetect">
- ...
-</module>
-</com:TTextHighlighter>
-
-<p id="790635" class="block-content">Anda juga bisa menyediakan kelas globalisasi sendiri untuk mengubah bagaimana kultur aplikasi ditetapkan.
-Terakhir, Anda dapat mengubah setelan globalisasi dengan basis halaman demi halaman menggunakan <a href="?page=Configurations.Templates1#tct">tag kontrol template</a>. Sebagai contoh, mengubah <tt>Culture</tt> ke "zh".</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790208">
-<%@ Application.Globalization.Culture="zh" %>
-</com:TTextHighlighter>
-
-<h2 id="6207">Melokalisir aplikasi PRADO Anda</h2>
-Ada dua area dalam aplikasi Anda yang mungkin membutuhkan lokalisasi pesan atau string, dalam kode PHP dan dalam template. Untuk melokalisasi string di dalam PHP, gunakan fungsi <tt>localize</tt> yang dijelaskan di bawah. Untuk melokalisasi teks dalam template, gunakan komponen <a href="#ttranslate">TTranslate</a>.
-<h2 id="6208">Menggunakan fungsi <tt>localize</tt> untuk mennerjemahkan teks dalam PHP</h2>
-
-<p id="790636" class="block-content">Fungsi <tt>localize</tt> mencari string yang diterjemahkan yang sama dengan aslinya dari sumber terjemahan Anda. Pertama, Anda perlu mencari semua teks dikode langsung dalam PHP yang ditampilkan atau dikirimkan ke pengguna akhir. Contoh berikut melokalisasi teks <tt>$sender</tt> (menganggap, katakanlah, sender adalah sebuah tombol). Kode asli sebelum lokalisasi adalah sebagai berikut.
-<com:TTextHighlighter CssClass="source block-content" id="code_790209">
-function clickMe($sender,$param)
-{
- $sender->Text="Hello, world!";
-}
-</com:TTextHighlighter>
-
-<p id="790637" class="block-content">Pesan dikodekan langsung "Hello, world!" dilokalisasi menggunakan fungsi <tt>localize</tt>. </p>
-<com:TTextHighlighter CssClass="source block-content" id="code_790210">
-function clickMe($sender,$param)
-{
- $sender->Text=Prado::localize("Hello, world!");
-}
-</com:TTextHighlighter>
-
-<h2 id="6209">Pesan Gabungan</h2>
-
-<p id="790638" class="block-content">Pesan gabungan dapat berisi data variabel. Sebagai contoh, dalam pesan "There are 12 users online.", integer 12 dapat berubah tergantung pada beberapa data dalam aplikasi Anda. Ini sulit diterjemahkan karena posisi dari data variabel mungkin berbeda untuk bahasa yang berbeda. Seabgai tambahan, bahasa yang berbeda memiliki aturannya sendiri untuk bentuk jamak (jika ada) dan/atau pembilang. Contoh berikut tidak mudah untuk diterjemahkan, karena struktur kalimat sudah tetap dengan dikodekan langsung data variabel dengan pesan.</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_790211">
-$num_users = 12;
-$message = "There are " . $num_users . " users online.";
-</com:TTextHighlighter>
-
-Masalah ini bisa dipecahkan menggunakan fungsi <tt>localize</tt> dengan penempatan string. Sebagai contoh, string <tt>$message</tt> di atas dapat dibentuk seperti berikut.
-<com:TTextHighlighter CssClass="source block-content" id="code_790212">
-$num_users = 12;
-$message = Prado::localize("There are {num_users} users online.", array('num_users'=>$num_users));
-</com:TTextHighlighter>
-<p id="790639" class="block-content">Di mana parameter kedua dalam <tt>localize</tt> mengambil array asosiatif dengan kunci sebagai penempatan yang dicari dalam teks dan menggantinya dengan nilai terkait.
-Fungsi <tt>localize</tt> tidak memecahkan masalah lokalisasi bahasa yang memiliki bentuk jamak, solusinya adalah menggunakan <a href="#choice-format">TChoiceFormat</a>.</p>
-
-<p id="790640" class="block-content">The following sample demonstrates the basics of localization in PRADO.</p>
-<com:RunBar PagePath="Advanced.Samples.I18N.Home" />
-
-<h1 id="6202">Komponen I18N</h1>
-<a name="ttranslate"></a>
-<h2 id="6210">TTranslate</h2>
-<p id="790641" class="block-content">Pesan dan string bisa dilokalisasi dalam PHP atau dalam template.
-Untuk menerjemahkan pesan atau string dalam template, gunakan <tt>TTranslate</tt>.</p>
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790213">
-<com:TTranslate>Hello World</com:TTranslate>
-<com:TTranslate Text="Goodbye" />
-</com:TTextHighlighter>
-
-<p id="790642" class="block-content"><tt>TTranslate</tt> juga dapat melakukan penempatan string. Properti <tt>Parameters</tt> bisa digunakan untuk menambah pasangan nama nilai untuk penempatan. Substring dalam terjemahan dikurung dengan "{" dan "}" yang dianggap sebagai nama parameter selama pencarian penempatan. Contoh berikut akan menempatkan substring "{time}" dengan nilai atribut parameter "<tt>Parameters.time=<%= time() %></tt>".
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790214">
-<com:TTranslate Parameters.time=<%= time() %> >
-The time is {time}.
-</com:TTranslate>
-</com:TTextHighlighter>
-
-<p id="790643" class="block-content">Kependekan dari <tt>TTranslate</tt> juga disediakan menggunakan sintaks berikut.</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790215">
-<%[string]%>
-</com:TTextHighlighter>
-<p id="790644" class="block-content">di mana string akan diterjemahkan ke bahasa berbeda berdasarkan preferensi bahasa pengguna akhir. Sintaks ini bisa dipakai dengan nilai atribut juga.</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790216">
-<com:TLabel Text="<%[ Hello World! ]%>" />
-</com:TTextHighlighter>
-
-<h2 id="6211">TDateFormat</h2>
-<p id="790645" class="block-content">Memformat tanggal dan jam dilokalisasi adalah pekerjaan langsung.</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790217">
-<com:TDateFormat Value="12/01/2005" />
-</com:TTextHighlighter>
-
-<p id="790646" class="block-content">Properti <tt>Pattern</tt> menerima 4 predefininisi pola tanggal dilokalisasi dan 4 predefininisi pola jam dilokalisasi.</p>
-<ul id="u2" class="block-content">
- <li><tt>fulldate</tt></li>
- <li><tt>longdate</tt></li>
- <li><tt>mediumdate</tt></li>
- <li><tt>shortdate</tt></li>
- <li><tt>fulltime</tt></li>
- <li><tt>longtime</tt></li>
- <li><tt>mediumtime</tt></li>
- <li><tt>shorttime</tt></li>
-</ul>
-<p id="p1" class="block-content">
-Predefinisi bisa dipakai dalam setiap kombinasi. Jika menggunakan pola predefinisi gabungan, pola pertama harus tanggal, diikuti oleh spasi, dan terakhir pola jam. Sebagai contoh, pola tanggal lengkap dengan pola jam pendek. Aktual uruta dari tanggal-jam dan pola aktual akan ditentukan secara otomatis dari data lokal yang ditetapkan oleh properti <tt>Culture</tt>.</p>
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790218">
-<com:TDateFormat Pattern="fulldate shorttime" />
-</com:TTextHighlighter>
-
-<p id="790647" class="block-content">Anda dapat menetapkan pola kustom menggunakan sub-pola berikut.
-Format tanggal/jam ditetapkan dalam arti pola waktu string. Dalam pola ini, semua huruf ASCII disimpan sebagai huruf pola, yang ditetapkan sebagai berikut:
-<com:TTextHighlighter Language="text" CssClass="source block-content" id="code_790219">
- Simbol Arti Penyajian Contoh
------- ---- --------- ------
- G tanda abad (Teks) AD
- y tahun (Angka) 1996
- M bulan dalam tahun (Teks & Angka) July & 07
- d hari dalam bulan (Angka) 10
- h jam dalam am/pm (1~12) (Angka) 12
- H jam dalam hari (0~23) (Angka) 0
- m menit dalam jam (Angka) 30
- s detik dalam menit (Angka) 55
- E hari dalam minggu (Teks) Tuesday
- D hari dalam tahun (Angka) 189
- F hari minggu dalam bulan (Angka) 2 (2nd Wed in July)
- w minggu dalam tahun (Angka) 27
- W minggu dalam bulan (Angka) 2
- a tanda am/pm (Teks) PM
- k jam dalam hari (1~24) (Angka) 24
- K jam dalam am/pm (0~11) (Angka) 0
- z zona waktu (Jam) Pacific Standard Time
- ' tanda kutip teks (Delimiter) 'Date='
- '' tanda kutip tunggal (Literal) 'o''clock'
-</com:TTextHighlighter>
-</p>
-
-<p id="790648" class="block-content">Jumlah pola huruf menentukan format.</p>
-
-<p id="790649" class="block-content">(Teks): 4 huruf menggunakan bentuk lengkap, kurang dari 4 menggunakan bentuk pendek atau singkatan
-jika ada. (misalnya "EEEE" menghasilkan "Monday", "EEE" menghasilkan "Mon")</p>
-
-<p id="790650" class="block-content">(Angka): jumlah digit minimum. Angka lebih pendek adalah diisi-nol ke jumlah ini (misalnya jika "m" menghasilkan "6", "mm" menghasilkan "06"). Tahun ditangani secara khusus; yakni jika jumlah 'y' adalah 2, Tahun akan dipotong 2 digit. (misalnya jika "yyyy" menghasilkan "1997", "yy" menghasilkan "97".)
- Tidak seperti field lain, pecahan detik dipadatkan pada sisi kanan dengan nol.</p>
-
-<p id="790651" class="block-content">(Teks dan Angka): 3 atau lebih, pakai teks, sebaliknya pakai angka. (misalnya
-"M" menghasilkan "1", "MM" menghasilkan "01", "MMM" menghasilkan "Jan", and "MMMM"
-menghasilkan "January".)</p>
-
-<p id="790652" class="block-content">Setiap karakter dalam pola yang tidak dalam jangkauan ['a'..'z']
-dan ['A'..'Z'] akan diperlakukan sebagai teks bertanda kutip. Contohnya, karakter seperti
-':', '.', ' ', dan '@' akan muncul dalam hasil teks waktu
-meskipun tidak dikurung dalam tanda kutip tunggal.</p>
-
-<p id="790653" class="block-content">Contoh menggunakan lokal US:
-
-<com:TTextHighlighter Language="text" CssClass="source block-content" id="code_790220">
-Pola Formasi Hasil
------------- -----
-"yyyy.MM.dd G 'at' HH:mm:ss" ->> 1996.07.10 AD at 15:08:56
-"EEE, MMM d, ''yy" ->> Wed, Jul 10, '96
-"h:mm a" ->> 12:08 PM
-"hh 'o''clock' a, z" ->> 12 o'clock PM, Pacific Daylight Time
-"K:mm a" ->> 0:00 PM
-"yyyy.MMMM.dd G hh:mm a" ->> 1996.July.10 AD 12:08 PM
-</com:TTextHighlighter>
-</p>
-
-<p id="790654" class="block-content">Jika properti <tt>Value</tt> tidak ditetapkan, tanggal dan jam saat ini yang dipakai.</p>
-
-<h2 id="6212">TNumberFormat</h2>
-<p id="790655" class="block-content">Kerangka kerja Internasionalisasi PRADO menyediakan pembentukan kurs lokal dan pembentukan angka. Harap dicatat bahwa komponen <tt>TNumberFormat</tt> hanya menyediakan pembentukan, saat ini ia tidak melakukan konversi atau pertukaran.</p>
-
-<p id="790656" class="block-content">Numbers can be formatted as currency, percentage, decimal or scientific
-numbers by specifying the <tt>Type</tt> attribute. The valid types are:</p>
-<ul id="u3" class="block-content">
- <li><tt>currency</tt></li>
- <li><tt>percentage</tt></li>
- <li><tt>decimal</tt></li>
- <li><tt>scientific</tt></li>
-</ul>
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790221">
-<com:TNumberFormat Type="currency" Value="100" />
-</com:TTextHighlighter>
-
-<p id="790657" class="block-content">Properti <tt>Culture</tt> dan <tt>Currency</tt> dapat ditetapkan untuk membentuk angka spesifik lokal. </p>
-
-<p id="790658" class="block-content">Jika seseorang dari US ingin melihat gambar penjualan dari sebuah toko dalam bahasa Jerman (katakanlah menggunakan kurs EURO), diformat menggunakan kurs jerman, Anda perlu untuk menggunakan atribut <tt>Culture="de_DE"</tt> guna memperoleh kurs yang benar, misalnya 100,00$. Pemisah desimal dan pengelompokan kemudian juga dari lokal <tt>de_DE</tt>. Ini dapat menimbulkan beberapa kebingungan karena orang dari US memakai "," (koma) sebagai pemisah ribuan. Oleh karena itu, atribut <tt>Currency</tt> tersedia agar output dari hasil contoh berikut menghasilkan $100.00
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790222">
-<com:TNumberFormat Type="currency"
- Culture="en_US" Currency="EUR" Value="100" />
-</com:TTextHighlighter>
-</p>
-
-<p id="790659" class="block-content">Properti <tt>Pattern</tt> menetapkan jumlah digit, posisi pengelompokan ribuan, jumlah titik desimal dan posisi desimal. Karakter aktual yang dipakai untuk menyajikan titik desimal dan titik ribuan adalah spesifik kultur dan akan berubah secara otomatis berdasarkan properti <tt>Culture</tt>. Karakter <tt>Pattern</tt> yang benar adalah:</p>
-<ul id="u6" class="block-content">
- <li><tt># (kris)</tt> - mewakili digit opsional</li>
- <li><tt>0 (nol)</tt> - mewakili digit mandatori, nol di kiri terisi</li>
- <li><tt>. (berhenti)</tt> - posisi titik desimal (hanya 1 titik desimal dibolehkan)</li>
- <li><tt>, (koma)</tt> - pemisahan titik ribuan (sampai 2 koma dibolehkan)</li>
-</ul>
-<p id="p2" class="block-content">
-Sebagai contoh, anggap <tt>Value="1234567.12345"</tt> dan dengan
-<tt>Culture="en_US"</tt> (yang menggunakan "," untuk titik pemisah ribuan dan "." untuk pemisah desimal).
-</p>
-<com:TTextHighlighter Language="text" CssClass="source block-content" id="code_790223">
-Pola Output
----- ------
-##,###.00 ->> 1,234,567.12
-##,###.## ->> 1,234,567.12345
-##,##.0000 ->> 1,23,45,67.1235
-##,###,##.0 ->> 12,345,67.1
-000,000,000.0 ->> 001,234,567.1
-</com:TTextHighlighter>
-</p>
-
-<h2 id="6213">TTranslateParameter</h2>
-<p id="790660" class="block-content">Pesan gabungan, misalnya penempatan string, bisa dilakukan dengan <tt>TTranslateParameter</tt>.
-Dalam contoh berikut, string "{greeting}" dan "{name}" masing-masing akan diganti dengan nilai "Hello" dan "World". Penempatan string harus dikurung dengan "{" dan "}". Parameter selanjutnya diterjemahkan dengan menggunakans <tt>TTranslate</tt>.
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790224">
-<com:TTranslate>
- {greeting} {name}!
- <com:TTranslateParameter Key="name">World</com:TTranslateParameter>
- <com:TTranslateParameter Key="greeting">Hello</com:TTranslateParameter>
-</com:TTranslate>
-</com:TTextHighlighter>
-
-
-<a name="choice-format"></a>
-<h2 id="6214">TChoiceFormat</h2>
-
-<p id="790661" class="block-content">Menggunakan fungsi <tt>localize</tt> atau komponen <tt>TTranslate</tt> untuk menerjemahkan pesan tidak memberitahu penerjemah kardinalitas dari data yang diminta untuk menentukan struktur jamak yang benar yang dipakai. Ia hanya memberitahunya bahwa ada data tersedia, data dapat berupa apa saja. Selanjutnya, penerjemah tidak akan bisa menentukan dengan memperhatikan penempatan data plural yang benar, struktur bahasa atau prasa yang dipakai. Misalnya dalam bahasa Inggris, untuk menerjemahkan kalimat, "There are {number} of apples.", hasil terjemahan akan berbeda tergantung pada <tt>jumlah</tt> apel.</p>
-
-<p id="790662" class="block-content">Komponen <tt>TChoiceFormat</tt> melakukan pilihan terjemahan pesan/string. Contoh berikut mendemonstrasikan terjemahan pesan 2 pilihan sederhana.</p>
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_790225">
-<com:TChoiceFormat Value="1"/>[1] One Apple. |[2] Two Apples</com:TChoiceFormat>
-</com:TTextHighlighter>
-
-<p id="790663" class="block-content">Dalam contoh di atas, <tt>Value</tt> "1" (satu), kemudian string yang diterjemahkan adalah "One Apple". Jika <tt>Value</tt> adalah "2", maka ia akan menampilkan "Two Apples".</p>
-
-<p id="790664" class="block-content">Pilihan pesan/string dipisashkan oleh pipa "|" diikuti oleh set notasi dari formulir.</p>
-<ul id="u7" class="block-content">
- <li><tt>[1,2]</tt> -- menerima nilai antara 1 dan 2, inklusif.</li>
- <li><tt>(1,2)</tt> -- menerima nilai antara 1 dan 2, kecuali 1 dan 2.</li>
- <li><tt>{1,2,3,4}</tt> -- hanya nilai yang didefinisikan dalam set yang diterima.</li>
- <li><tt>[-Inf,0)</tt> -- menerima nilai lebih besar dari atau sama dengan infinitif negatif dan kurang dari 0</li>
-</ul>
-
-<p id="790665" class="block-content">Setiap kombinasi tidak-kosong dari kurung kotak dan bulat dapat diterima.
-String yang dipilih untuk tampilan tergantung pada properti <tt>Value</tt>. <tt>Value</tt> dievaluiasi untuk setiap set-nya sampai <tt>Value</tt> ditemukan milik set tertentu.</p>
-
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/id/Logging.page b/demos/quickstart/protected/pages/Advanced/id/Logging.page deleted file mode 100755 index 169329a0..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/Logging.page +++ /dev/null @@ -1,61 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="6101">Pencatatan</h1>
-<p id="780615" class="block-content">
-PRADO menyediakan fungsionalitas sangat fleksibel dan bisa diperluas. Pesan yang dicatat dapat diklasifikasikan berdasarkan tingkat catatan dan kategori pesan. Menggunakan tingkat dan katkegori filter, pesan selanjutnya bisa dialihkan ke tujuan yang berbeda, seperti file, email, jendela browser, dll. Diagram berikut memperlihatkan arsitektur dasar dari mekanisme pencatatan PRADO,
-</p>
-<img src="<%~ logrouter.gif %>" alt="Pengalih catatan" />
-
-<h2 id="6102">Menggunakan Fungsi Pencatatan</h2>
-<p id="780616" class="block-content">
-Dua metode berikut disediakan untuk mencatat pesan dalam PRADO,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_780201">
-Prado::log($message, $logLevel, $category);
-Prado::trace($message, $category);
-</com:TTextHighlighter>
-<p id="780617" class="block-content">
-Perbedaan antara <tt>Prado::log()</tt> dan <tt>Prado::trace()</tt> adalah bahwa yang kedua memilih secara otomatis tingkat catatan berdasarkan mode aplikasi. Jika aplikasi dalam mode <tt>Debug</tt>, informasi pelacakan stack ditambahkan ke pesan. <tt>Prado::trace()</tt> dipakai secara luas dalam kode inti kerangka kerja PRADO.
-</p>
-
-<h2 id="6103">Pengalihan Pesan</h2>
-<p id="780618" class="block-content">
-Pesan yang dicatat menggunakan dua fungsi di atas dipelihara dalam memori. Untuk menggunakan pesan, para pengembang perlu mengalihkannya ke tujuan tertentu seperti file, email, atau jendela browser. Pengalihan pesan diatur oleh modul <tt>System.Util.TLogRouter</tt>. Ketika dimasukan ke dalam aplikasi, ia bisa mengalihkan pesan ke tujuan yang berbeda secara paralel. Saat ini PRADO menyediakan tiga jenis rute:
-</p>
-<ul id="u1" class="block-content">
- <li><tt>TFileLogRoute</tt> - pesan yang disaring disimpan dalam file log yang ditetapkan. Standarnya, file ini bernama <tt>prado.log</tt> di bawah direktori dari aplikasi. Perputaran file disediakan.</li>
- <li><tt>TEmailLogRoute</tt> - pesan yang disaring dikirimkan ke alamat email yang ditetapkan sebelumnya.</li>
- <li><tt>TBrowserLogRoute</tt> - pesan yang disaring ditambahkan ke akhir output halaman saat ini.</li>
-</ul>
-<p id="780619" class="block-content">
-Untuk menghidupkan pengalihan pesan, masukan dan konfigurasi modul <tt>TLogRouter</tt> dalam konfigurasi aplikasi,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_780202">
-<module id="log" class="System.Util.TLogRouter">
- <route class="TBrowserLogRoute"
- Levels="Info"
- Categories="System.Web.UI.TPage, System.Web.UI.WebControls" />
- <route class="TFileLogRoute"
- Levels="Warning, Error"
- Categories="System.Web" />
-</module>
-</com:TTextHighlighter>
-<p id="780620" class="block-content">
-Dalam contoh di atas, <tt>Levels</tt> dan <tt>Categories</tt> menetapkan log dan filter kategori untuk mengambil secara selektif pesan ke tujuan terkait.
-</p>
-
-<h2 id="6104">Penyaringan Pesan</h2>
-<p id="780621" class="block-content">
-Pesan bisa disaring berdasarkan tingkat catatan serta kategorinya. Setiap catatan pesan dikaitkan dengan tingkat dan kategori catatan. Dengan tingkat dan kategori, para pengembang dapat mengambil pesan secara selektif yang menarik bagi mereka.
-</p>
-<p id="780622" class="block-content">
-Tingkat catatan didefinisikan dalam <tt>System.Util.TLogger</tt> termasuk: <tt>DEBUG</tt>, <tt>INFO</tt>, <tt>NOTICE</tt>, <tt>WARNING</tt>, <tt>ERROR</tt>, <tt>ALERT</tt>, <tt>FATAL</tt>. Pesan bisa disaring berdasarkan kriteria tingkat catatan. Sebagai contoh, jika sebuah filter menetapkan tingkat <tt>WARNING</tt> dan <tt>ERROR</tt>, maka hanya pesan tersebut yakni <tt>WARNING</tt> and <tt>ERROR</tt> yang akan dikembalikan.
-</p>
-<p id="780623" class="block-content">
-Kategori pesan adalah hirarkis. Kategori yang namanya awalan dari yang lain disebut leluhur kategori atas kategori lainnya. Sebagai contoh, kategori <tt>System.Web</tt> adalah leluhur dari kategori <tt>System.Web.UI</tt> dan <tt>System.Web.UI.WebControls</tt>. Pesan bisa diambil secara selektif menggunakan filter kategori hirarkis tersebut. Sebagai contoh, jika filter kategori adalah <tt>System.Web</tt>, maka semua pesan dalam <tt>System.Web</tt> dikembalikan. Sebagai tambahan, pesan dalam kategori anak seperti <tt>System.Web.UI.WebControls</tt>, juga dikembalikan.
-</p>
-<p id="780624" class="block-content">
-Dengan ketentuan, pesan yang dicatat dalam kode inti PRADO dikategorikan berdasarkan namespace dari kelas terkait. Sebagai contoh, pesan yang dicatat dalam <tt>TPage</tt> akan menjadi kategori <tt>System.Web.UI.TPage</tt>.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/id/MasterContent.page b/demos/quickstart/protected/pages/Advanced/id/MasterContent.page deleted file mode 100755 index a5480ce3..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/MasterContent.page +++ /dev/null @@ -1,57 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5801">Master dan Konten</h1>
-<p id="750587" class="block-content">
-Halaman dalam aplikasi Web sering berbagi bagian yang sama. Sebagai contoh, semua halaman dari aplikasi tutorial berbagi bagian header dan footer yang sama. Jika kita menyimpan header dan footer secara berulang dalam setiap file sumber halaman, ia akan memusingkan pemeliharaan jika suatu saat kita menginginkan sesuatu pada header atau footer. Untuk memecahkan masalah ini, PRADO memperkenalkan konsep master dan konten. Ini terutama pola dekorator, dengan konten didekorasi oleh master.
-</p>
-<p id="750588" class="block-content">
-Master dan konten hanya berlaku ke kontrol template (kontrol memperluas <tt>TTemplateControl</tt> atau kelas anaknya). Kontrol template dapat mempunyai paling banyak satu kontrol master dan satu atau beberapa konten (masing-masing diwakili oleh kontrol <tt>TContent</tt>). Konten akan disisipkan ke dalam kontrol master di tempat yang disiapkan oleh kontrol <tt>TContentPlaceHolder</tt>. Dan penyajian kontrol template adalah <tt>TContentPlaceHolder</tt> yang disiapkan kontrol master diganti dengan <tt>TContent</tt>.
-</p>
-<p id="750589" class="block-content">
-Sebagai contoh, anggap kontrol template mempunyai template berikut:
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_750192">
-<%@ MasterClass="MasterControl" %>
-<com:TContent ID="A" >
-content A
-</com:TContent >
-<com:TContent ID="B" >
-content B
-</com:TContent >
-<com:TContent ID="B" >
-content B
-</com:TContent >
-</com:TTextHighlighter>
-<p id="750590" class="block-content">
-yang menggunakan <tt>MasterControl</tt> sebagai kontrol masternya. Kontrol master mempunyai template berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_750193">
-other stuff
-<com:TContentPlaceHolder ID="A" />
-other stuff
-<com:TContentPlaceHolder ID="B" />
-other stuff
-<com:TContentPlaceHolder ID="C" />
-other stuff
-</com:TTextHighlighter>
-<p id="750591" class="block-content">
-Kemudian, konten disisipkan ke dalam kontrol master berdasarkan diagram berikut, sementara hubungan leluhur-anak dapat dilihat dalam berikutnya. Catatan, kontrol template mengabaikan apapun dalam template selain konten, sementara kontrol master memelihara apapun dan mengganti tempat konten dengan konten berdasarkan ID yang sama.
-</p>
-<img src=<%~ mastercontent.gif %> alt="Master dan Konten" />
-<img src=<%~ pcrelation.gif %> alt="Hubungan leluhur-anak antara master dan konten" />
-
-<h2 id="6301">Master vs. Template Eksternal</h2>
-<p id="750592" class="block-content">
-Master sangat mirip dengan template eksternal yang diperkenalkan sejak versi 3.0.5. <a href="?page=Configurations.Templates1">Tag include</a> khusus dipakai untuk menyertakan file template eksternal ke dalam basis template.
-</p>
-<p id="750593" class="block-content">
-Baik template master maupun eksternal bisa dipakai untuk berbagi konten yang sama diantara halaman. Master adalah kontrol template yang berisi konten umum dan file kelasnya berisi logika terkait dengan master. Dilain pihak, template eksternal adalah file template murni tanpa file kelas apapun.
-</p>
-<p id="750594" class="block-content">
-Oleh karena itu, gunakan kontrol master jika konten umum harus dikaitkan dengan beberapa logika, seperti header halaman dengan kotak pencarian atau kotak login. Kontrol master membolehkan Anda untuk menetapkan bagaimana konten umum harus berinteraksi dengan pengguna akhir. Jika Anda menggunakan template eksternal, Anda harus menyimpan logika yang diperlukan dalam halaman atau kelas kontrol yang memiliki basis template.
-</p>
-<p id="750595" class="block-content">
-Performansinya, template eksternal lebih ringan daripada master seperti berisi kontrol sendiri yang berparisipasi dalam masa hidup halaman, karena pembentuk hanya dipakai saat template sedang diuraikan.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/id/Performance.page b/demos/quickstart/protected/pages/Advanced/id/Performance.page deleted file mode 100755 index 68c88bf0..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/Performance.page +++ /dev/null @@ -1,88 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="6401">Penyesuaian Performansi</h1>
-<p id="810678" class="block-content">
-Performansi aplikasi Web dipengaruhi oleh banyak faktor. Akses database, operasi sistem file, bandwidth jaringan adalah faktor pengaruh potensial. PRADO mencoba dalam setiap usaha untuk mengurangi akibat performansi yang disebabkan oleh kerangka kerja.
-</p>
-
-<h2 id="6402">Caching</h2>
-<p id="810679" class="block-content">
-PRADO menyediakan teknik cache generik yang dipakai oleh beberapa bagian inti kerangka kerja. Sebagai contoh, ketika cache dihidupkan, <tt>TTemplateManager</tt> akan menyimpan template yang diurai dalam cache dan menggunakannya kembali dalam permintaan berikut, yang menghemat waktu penguraian template. <tt>TThemeManager</tt> mengadopsi strategi yang mirip untuk berhadapan dengan penguraian tema.
-</p>
-<p id="810680" class="block-content">
-Menghidupkan cache sangat mudah. Cukup tambahkan modul cache dalam konfigurasi aplikasi, dan PRADO memelihara semuanya.
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_810229">
-<modules>
- <module id="cache" class="System.Caching.TSqliteCache" />
-</modules>
-</com:TTextHighlighter>
-
-<p id="810681" class="block-content">
-Para pengembang juga bisa mengambil keuntungan dari teknik cache dalam aplikasinya. Properti <tt>Cache</tt> dari <tt>TApplication</tt> mengembalikan modul cache yang dimasukan bila ia tersedia. Untuk menyimpan dan mengambil item data dari dalam cache, gunakan perintah berikut,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_810230">
-if($application->Cache) {
- // menyimpan item data ke cache
- $application->Cache->set($keyName,$dataItem);
- // mengambil item data dari cache
- $dataItem=$application->Cache->get($keyName);
-}
-</com:TTextHighlighter>
-<p id="810682" class="block-content">
-di mana <tt>$keyName</tt> harus berupa string yang secara unik mengidentifikasi item data yang disimpan dalam cache.
-</p>
-
-<p id="840059" class="block-content">
-Sejak v3.1.0, kontrol baru bernama <a href="?page=Controls.OutputCache">TOutputCache</a> telah diperkenalkan. Kontrol ini membolehkan para pengguna untuk men-cache bagian-bagian dari output halaman. Bila dipakai dengan benar, teknik ini bisa meningkatkan performansi halaman secara signifikan karena kontrol di dalamnya tidak dibuat sama sekali jika versi yang di-cache diminta.
-</p>
-
-<h2 id="6403">Menggunakan <tt>pradolite.php</tt></h2>
-<p id="810683" class="block-content">
-Banyak file naskah PHP yang disertakan dapat mempengaruhi performansi aplikasi secara signifikan. Kelas PRADO disimpan dalam file berbeda dan ketika memproses sebuah permintaan halaman, ia bisa menyertakan puluhan file kelas. Untuk mengurangi masalah ini, setiap rilis PRADO, sebuah file bernama <tt>pradolite.php</tt> juga disertakan. File ini adalah gabungan dari seluruh file kelas inti PRADO dengan komentar dan pencatatan pesannya yang sudah dibuang.
-</p>
-<p id="810684" class="block-content">
-Untuk menggunakan <tt>pradolite.php</tt> dalam naskah entri aplikasi, ganti penyertaan <tt>prado.php</tt> dengan <tt>pradolite.php</tt>.
-</p>
-
-<h2 id="6404">Mengubah Mode Aplikasi</h2>
-<p id="810685" class="block-content">
-Mode aplikasi juga mempengaruhi performansi aplikasi. Aplikasi PRADO dapat berupa salah satu dari mode berikut: <tt>Off</tt>, <tt>Debug</tt>, <tt>Normal</tt> dan <tt>Performance</tt>. Mode <tt>Debug</tt> harus dipakai terutama selama pengembangan aplikasi, sementara mode <tt>Normal</tt> biasanya dipakai dalam tahap berikutnya setelah aplikasi disebarkan guna memastikan semuanya berjalan dengan baik. Setelah aplikasi terbukti bekerja stabil, selanjutnya mode bisa dialihkan ke <tt>Performance</tt> untuk meningkatkan performansi.
-</p>
-<p id="810686" class="block-content">
-Perbedaan antara mode <tt>Debug</tt>, <tt>Normal</tt> dan <tt>Performance</tt> yaitu di bawah mode <tt>Debug</tt>, catatan aplikasi akan berisi informasi debug, dan di bawah mode <tt>Performance</tt>, pemeriksaan cap waktu tidak dilakukan untuk template yang di-cache dan asset yang dipublikasikan. Oleh karena itu, di bawah mode <tt>Performance</tt>, aplikasi mungkin tidak berjalan dengan baik jika template atau asset dimodifikasi. Karena mode <tt>Performance</tt> dipakai terutama saat aplikasi sudah stabil, mengubah template atau asset tidak disukai.
-</p>
-<p id="810687" class="block-content">
-Untuk berganti mode aplikasi, konfigurasi itu dalam konfigurasi aplikasi:
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_810231">
-<application Mode="Performance" >
- ......
-</application >
-</com:TTextHighlighter>
-
-<h2 id="6405">Mengurangi Ukuran Halaman</h2>
-<p id="810688" class="block-content">
-Standarnya PRADO menyimpan kondisi halaman dalam field tersembunyi dari output HTML. Kondisi halaman bisa berukuran sangat besar jika menggunakan kontrol yang kompleks, seperti <tt>TDataGrid</tt>. Guna mengurangi ukuran besarnya halaman yang dikirimkan melalui jaringan, dua strategi dapat dipakai.
-</p>
-<p id="810689" class="block-content">
-Pertama, Anda dapat mematikan kondisi tampilan dengan menyetel <tt>EnableViewState</tt> menjadi false untuk halaman atau beberapa kontrol pada halaman jika pengguna tidak perlu berinteraksi dengan halaman/kontrol.
-</p>
-<p id="810690" class="block-content">
-Kedua, Anda bisa menggunakan penyimpanan kondisi halaman berbeda. Sebagai contoh, kondisi halaman bisa disimpan dalam sesi, yang menyimpan kondisi halamaa terutama pada sisi server dan menghemat waktu transmisi jaringan. Properti <tt>StatePersisterClass</tt> dari halaman menentukan kelas persisten kondisi yang dipakai. Standarnya menggunakan <tt>System.Web.UI.TPageStatePersister</tt> untuk menyimpan kondisi persisten dalam field tersembunyi. Anda bisa mengubah properti ini ke kelas persisten Anda sendiri, selama kelas persister menerapkan antarmuka <tt>IPageStatePersister</tt>. Anda dapat mengkonfigurasi properti ini dalam beberapa tempat, seperti konfigurasi aplikasi atau konfigurasi halaman menggunakan tag <pages> or <page>,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_810232">
-<pages StatePersisterClass="MyPersister1" ... >
- <page ID="SpecialPage" StatePersisterClass="MyPersister2" ... />
-</pages>
-</com:TTextHighlighter>
-<p id="810691" class="block-content">
-Catatan, dalam <tt>SpecialPage</tt> di atas akan menggunakan <tt>MyPersister2</tt> sebagai kelas persisternya, sementara halaman lainnya akan menggunakan <tt>MyPersister1</tt>. Oleh karena itu, Anda dapat memiliki strategi perister kondisi untuk halaman yang berbeda.
-</p>
-
-<h2 id="6406">Teknik Lainnya</h2>
-<p id="810692" class="block-content">
-Teknik cache server terbukti sangat efektif meningkatkan performansi aplikasi PRADO. Sebagai contoh, kita telah mengamati bahwa dengan menggunakan Zend Optimizer, RPS (request per second) dari aplikasi PRADO bisa meningkat lebih dari sepuluh kali. Tentunya, ini merupakan harga dari output yang stabil, sementara teknik cache PRADO selalu memastikan kebenaran output.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/id/Scripts.page b/demos/quickstart/protected/pages/Advanced/id/Scripts.page deleted file mode 100755 index 714678ab..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/Scripts.page +++ /dev/null @@ -1,334 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="6501">Pengenalan Javascript</h1>
-Bimbingan ini berdasarkan pada <a href="http://www.sergiopereira.com/articles/advjs.html">
-Bimbingan cepat bagi tur JavaScript tingkat lanjut dengan beberapa fitur OO</a> oleh Sergio Pereira.
-
-<h2 id="6502">Hey, Saya tidak tahu Anda bisa melakukannya</h2>
-<p id="820693" class="block-content">
- Jika Anda adalah seorang pengembang web developer dan datang dari tempat yang sama seperti saya, Anda mungkin telah mengenal sedikit Javascript dalam halaman web Anda, terutama sebagai perekat UI.
-</p>
-<p id="820694" class="block-content">
-
- Sampai saat ini, saya tahu bahwa Javascript mempunyai kemampuan OO daripada ketika saya dipekerjakan, tetapi saya tidak merasa perlu menggunakannya. Karena browser mulai mendukung set fitur Javascript dan DOM lebih distandarisasikan, itu menjadi semangat untuk menulis kode yang lebih fungsional dan kompleks untuk dijalankan pada klien. Itu membantu kelahiran fenomena AJAX.
-</p>
-<p id="820695" class="block-content">
- Saat kita mulai mempelajari apa yang diperlukan untuk menulis aplikasi AJAX yang baik, kita mulai memperhatikan bahwa Javascript yang kita pakai benar-benar berada di puncak gunung es.
- Sekarang kita melihat Javascript dipakai melampaui pekerjaan UI sehari-hari yang sederhana seperti validasi input dan tugas-tugas kecil. Kode klien sekarang jauh lebih maju dan berlapis, lebih mirip aplikasi desktop sebenarnya atau klien tebal dari klien-server. Kita melihat librari kelas, model obyek, hirarki, pola, dan banyak hal lain yang dapat kita pakai hanya dalam kode di dalam server.
-</p>
-<p id="820696" class="block-content">
- Dalam banyak cata kita dapat mengatakan bahwa dengan tiba-tiba palang ditaruh lebih tinggi dari sebelumnya. Ia mengambil palang pintu lebih ahli menulis aplikasi untuk Web baru dan kita perlu mengingkatkan keahlian Javascript kita agar bisa sampai ke sana.
- Jika Anda mencoba untuk menggunakan banyak librari javascript yang ada di luar sana, seperti
- <a href="http://prototype.conio.net/">Prototipe.js</a>,
- <a href="http://script.aculo.us/">Scriptaculous</a>,
- <a href="http://moofx.mad4milk.net/">moo.fx</a>,
- <a href="http://bennolan.com/behaviour/">Perilaku</a>,
- <a href="http://developer.yahoo.net/yui/">YUI</a>,
- dan lain-lain, Anda secara kebetulan akan menemukan diri Anda sendiri sedang membaca kode JS. Mungkin dikarenakan Anda ingin mempelajari bagaimana mereka melakukannya, atau karena Anda penasaran, atau lebih sering karena itulah satu-satunya cara untuk memahami bagaimana untuk memakainya, karena dokumentasi nampaknya tidak banyak ditujukan terutama terhadap librari ini. Apapun kasusnya, Anda akan menghadapi teknik kung-fu yang akan menjadi asing dan menakutkan jika Anda belum melihat itu sebelumnya.
-</p>
-
-<p id="820697" class="block-content">
- Kegunaan dari artikel ini tepatnya menjelaskan tipe konstruksi yang banyak dari kita belum terbiasa dengannya.
-</p>
-
-
-<h2 id="6503">JSON (JavaScript Object Notation)</h2>
-<p id="820698" class="block-content">
- JavaScript Object Notation (<a href="http://www.json.org/">JSON</a>,) adalah salah satu dari isu baru yang muncul sekitar tema AJAX. JSON, cukup dikatakan suatu cara mendeklarasikan obyek dalam Javascript. Mari kita lihat contoh segera dan perhatikan bagaimana kemudahannya.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820233">
-var myPet = { color: 'black', leg_count: 4, communicate: function(repeatCount){
-for(i=0;i<repeatCount;i++) alert('Woof!');} };
-</com:TTextHighlighter>
-
-<p id="820699" class="block-content">
- Mari kita tambahkan sedikit pembentukan agar terlihat lebih mirip bagaimana kita biasa menemukannya di sana:
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820234">
-var myPet =
-{
- color: 'black',
- legCount: 4,
- communicate: function(repeatCount)
- {
- for(i=0;i<repeatCount;i++)
- alert('Woof!');
- }
-};
-</com:TTextHighlighter>
-<p id="820700" class="block-content">
- Di sini kita membuat referensi ke obyek dengan dua properti (<tt>color</tt>
- dan <tt>legCount</tt>) serta metode (<tt>communicate</tt>.)
- Tidak sulit untuk memahami bahwa properti obyek dan metode didefinisikan sebagai daftar dipisahkan koma. Masing-masing anggota diperkenalkan dengan nama, diikuti oleh titik dua dan kemudian definisi. Dalam hal properti, ini cukup mudah, hanya nilai properti. Metode yang dibuat dengan penempatan fungsi anonim, yang akan kami jelaskan lebih baik di bawah baris.
- Setelah obyek dibuat dan ditempatkan ke variabel <tt>myPet</tt>, kita dapat menggunakanya seperti ini:
-</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820235">
-alert('my pet is ' + myPet.color);
-alert('my pet has ' + myPet.legCount + ' legs');
-//jika Anda anjing, mengonggong tiga kali:
-myPet.communicate(3);
-</com:TTextHighlighter>
-<p id="820701" class="block-content">
- Anda akan melihat JSON banyak dipakai di mana saja dalam JS baru-baru ini, sebagai argumen bagi fungsi, sebagai nilai hasil, sebagai respon server (dalam string,) dll.
-</p>
-
-<h2 id="6504">Apa yang Anda maksud? Fungsi juga adalah sebuah obyek?</h2>
-<p id="820702" class="block-content">
- Ini mungkin tidak biasa bagi para pengembang yang tidak pernah memikirkan tentang itu, tapi dalam fungsi JS adalah sebuah obyek. Anda bisa mengirimkan sebuah fungsi sebagai argumen terhadap fungsi lain sama seperti Anda mengirimkan sebuah string, misalnya. Ini sering dipakai dan siap digunakan.
-</p>
-
-<p id="820703" class="block-content">
- Lihat pada contoh ini. Kami akan mengirimkan fungsi ke fungsi lain yang akan memakainya.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820236">
-var myDog =
-{
- bark: function()
- {
- alert('Woof!');
- }
-};
-
-var myCat =
-{
- meow: function()
- {
- alert('I am a lazy cat. I will not meow for you.');
- }
-};
-
-function annoyThePet(petFunction)
-{
- //let's see what the pet can do
- petFunction();
-}
-
-//ganggu anjing:
-annoyThePet(myDog.bark);
-//ganggu kucing:
-annoyThePet(myCat.meow);
-</com:TTextHighlighter>
-<p id="820704" class="block-content">
- Catatan bahwa kami mengirimkan myDog.bark dan myCat.meow tanpa menambahkan tanda kurung <tt>"()"</tt> kepadanya. Jika kita melakukan itu kita tidak mengirimkan fungsi, sebaliknya kita akan memanggil metode dan mengirimkan nilai hasilnya, <tt>tidak terdefinisi</tt> dalam kedua kasus di sini.
-</p>
-
-<p id="820705" class="block-content">
- Jika Anda ingin membuat kucing malas mulai mengeong, Anda dapat dengan mudah melakukan ini:
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820237">
-myCat.meow = myDog.bark;
-myCat.meow(); //alerts 'Woof!'
-</com:TTextHighlighter>
-
-<h2 id="6505">Arrays, items, and object members</h2>
-<p id="820706" class="block-content">
- Dua baris berikut dalam JS melakukan hal yang sama.
-</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820238">
-var a = new Array();
-var b = [];
-</com:TTextHighlighter>
-<p id="820707" class="block-content">
- Karena saya yakin Anda sudah mengetahuinya, anda dapat mengakses item individual dalam sebuah array menggunakan tanda kurung kotak:
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820239">
-var a = ['first', 'second', 'third'];
-var v1 = a[0];
-var v2 = a[1];
-var v3 = a[2];
-</com:TTextHighlighter>
-<p id="820708" class="block-content">
-
- Tetapi Anda tidak dibatasi pada indeks numerik. Anda bisa mengakses banyak obyek JS dengan menggunakan namanya, dalam sebuah string. Contoh berikut membuat obyek kosong, dan menambah beberapa anggotanya dengan nama.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820240">
-var obj = {}; //baru, obyek kosong
-obj['member_1'] = 'this is the member value';
-obj['flag_2'] = false;
-obj['some_function'] = function(){ /* lakukan sesuatu */};
-</com:TTextHighlighter>
-<p id="820709" class="block-content">
- Kode di atas mempunyai pengaruh yang sama seperti berikut:
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820241">
-var obj =
-{
- member_1:'this is the member value',
- flag_2: false,
- some_function: function(){ /* lakukan sesuatu */}
-};
-</com:TTextHighlighter>
-
-<p id="820710" class="block-content">
- Dalam banyak cara, ide obyek dan array asosiatif (hashes) dalam JS tidak dibedakan. Dua baris berikut melakukan hal yang sama juga.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820242">
-obj.some_function();
-obj['some_function']();
-</com:TTextHighlighter>
-
-
-<h2 id="6506">Cukup tentang obyek, boleh saya memiliki kelas sekarang?</h2>
-<p id="820711" class="block-content">
-
- Kekuatan besar dari bahasa pemrograman obyek berasal dari pemakaian kelas. Saya tidak berpikir telah menebak bagaimana kelas didefinisikan dalam JS hanya menggunakan pengalaman saya sebelumnya dengan bahasa lainnya. Nilailah bagi diri Anda sendiri.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820243">
-//mendefinisikan kelas baru bernama Pet
-var Pet = function(petName, age)
-{
- this.name = petName;
- this.age = age;
-};
-
-//mari kita membuat obyek dari kelas Pet
-var famousDog = new Pet('Santa\'s Little Helper', 15);
-alert('This pet is called ' + famousDog.name);
-</com:TTextHighlighter>
-<p id="820712" class="block-content">
- Mari kita lihat bagaimana kita menambahkan metode pada kelas <tt>Pet</tt> kita. Kita akan menggunakan properti <tt>prototype</tt> yang dimiliki oleh semua kelas. Properti <tt>prototype</tt> adalah sebuah obyek yang berisi semua anggota yang merupakan obyek yang akan dimiliki oleh kelas.
- Bahkan kelas JS standarnya, seperti <tt>String</tt>, <tt>Number</tt>,
- dan <tt>Date</tt> mempunyai obyek <tt>prototype</tt> yang bisa kita tambah metode serta propertinya dan menjadikan setiap obyek dari kelas itu secara otomatis mendapatkan anggota baru ini.
-</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820244">
-Pet.prototype.communicate = function()
-{
- alert('I do not know what I should say, but my name is ' + this.name);
-};
-</com:TTextHighlighter>
-<p id="820713" class="block-content">
- Itulah saatnya librari seperti <a href="http://www.sergiopereira.com/articles/prototype.js.html">prototype.js</a> siap digunakan. Jika kita menggunakan prototype.js, kita dapat membuat kode kita lebih bersih (setidaknya menurut saya.)
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820245">
-var Pet = Class.create();
-Pet.prototype =
-{
- //'constructor' kita
- initialize: function(petName, age)
- {
- this.name = petName;
- this.age = age;
- },
-
- communicate: function()
- {
- alert('I do not know what I should say, but my name is ' + this.name);
- }
-};
-</com:TTextHighlighter>
-
-<h2 id="6507">Fungsi sebagai argumen, pola yang menarik</h2>
-<p id="820714" class="block-content">
- Jika Anda tidak pernah bekerja dengan bahasa yang mendukung klosur Anda akan mendapatkan idion berikut terlalu busuk.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820246">
-var myArray = ['first', 'second', 'third'];
-myArray.each( function(item, index)
-{
- alert('The item in the position #' + index + ' is:' + item);
-});
-</com:TTextHighlighter>
-<p id="820715" class="block-content">
-
- Wah! Mari kita jelaskan apa yang terjadi di sini sebelum Anda memutuskan saya telah pergi terlalu jauh dan beralih ke artikel yang lebih baik dari yang ini.
-</p>
-<p id="820716" class="block-content">
- Pertama, dalam contoh di atas kita menggunakan librari prototype.js, yang menambahkan setiap fungsi ke kelas array. Setiap fungsi menerima satu argumen yang adalah obyek fungsi. Fungsi ini, silah berganti akan dipanggil sekali untuk setiap item dalam array, mengirimkan dua argumen saat dipanggil, item dan indeks untuk item saat ini. Mari kita panggil fungsi ini sebagai fungsi pengulang kita.
- Kita juga dapat menulis kode seperti ini.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820247">
-function myIterator(item, index)
-{
- alert('The item in the position #' + index + ' is:' + item);
-}
-
-var myArray = ['first', 'second', 'third'];
-myArray.each( myIterator );
-</com:TTextHighlighter>
-<p id="820717" class="block-content">
- Tapi ketika kita tidak ingin melakukan seperti semua anak sekolah, bukan?
- Lebih serius, bagaimanapun juga, format terakhir ini lebih sederhana untuk dimengerti karena kita memasuki kode mencari fungsi myIterator. Adalah baik untuk memiliki logaika fungsi iterator di sana dalam tempat yang sama ia dipanggil. Juga, dalam hal ini, kitak tidak memerlukan fungsi iterator di manapun juga dalam kode kita, maka kita dapat mengubahnya ke dalam fungsi anonim tanpa hukuman.
-</p>
-
-<h2 id="6508"><tt>this</tt> ini tapi kadang-kadang juga <tt>this</tt> itu</h2>
-<p id="820718" class="block-content">
-
- Salah satu masalah yang paling umum yang kita miliki dengan JS adalah saat kita mulai menulis kode kita, itulah kegunaan dari kata kunci <tt>this</tt>. Ini benar-benar menjadi tripwire.
-</p>
-<p id="820719" class="block-content">
- Seperti disebutkan sebelumnya, sebuah fungsi juga adalah sebuah obyek dalam JS, dan adakalanya kita tidak memperhatikan bahwa kita mengirimkan sebuah fungsi.
-</p>
-<p id="820720" class="block-content">
- Ambil potongan kode ini sebagai contoh.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820248">
-function buttonClicked()
-{
- alert('button ' + this.id + ' was clicked');
-}
-
-var myButton = document.getElementById('someButtonID');
-var myButton2 = document.getElementById('someOtherButtonID');
-myButton.onclick = buttonClicked;
-myButton2.onclick = buttonClicked;
-</com:TTextHighlighter>
-<p id="820721" class="block-content">
- Karena fungsi buttonClicked didefinisikan di luar obyek manapun kita cenderung berpikir kata kunci <tt>this</tt> akan berisi referensi ke
- obyek <tt>window</tt> atau <tt>document</tt> (menganggap kode ini ada di tengah halaman HTML yang dilihat dalam browser.)
-</p>
-
-<p id="820722" class="block-content">
- Tapi saat kita menjalankan kode ini kita melihat ia bekerja seperti yang dimaksudkan dan menampilkan <tt>id</tt> dari tombol yang diklik. Apa yang terjadi di sini adalah bahwa kita membuat metode onclick dari setiap tombol yang berisi referensi obyek <tt>buttonClicked</tt>, mengganti apapun yang ada di sana sebelumnya. Sekarang kapan saja tombol diklik, browser akan menjalankan sesuatu mirip dengan baris berikut.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820249">
-myButton.onclick();
-</com:TTextHighlighter>
-<p id="820723" class="block-content">
-
- Itu tidak membingungkan sama sekali bukan? Tapi lihat apa yang terjadi, Anda mulai memiliki obyek lain yang berhadapan dengannya dan Anda ingin betindak pada obyek ini terhadap event seperti klik tombol.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820250">
-var myHelper =
-{
- formFields: [ ],
- emptyAllFields: function()
- {
- for(i=0; i < this.formFields.length; i++)
- {
- var elementID = this.formFields[i];
- var field = document.getElementById(elementID);
- field.value = '';
- }
- }
-};
-
-//beritahu kita ingin bekerja dengan field formulir yang mana
-myHelper.formFields.push('txtName');
-myHelper.formFields.push('txtEmail');
-myHelper.formFields.push('txtAddress');
-
-//membersihkan kotak teks:
-myHelper.emptyAllFields();
-
-var clearButton = document.getElementById('btnClear');
-clearButton.onclick = myHelper.emptyAllFields;
-</com:TTextHighlighter>
-<p id="820724" class="block-content">
- Anda pikir bagus, sekarang saya dapat mengklik tombol Clear pada halaman saya dan tiga kotak teks itu akan dikosongkan. Kemudian Anda mencoba mengklik tombol hanya untuk mendapatkan kesalahan runtime. Kesalahan akan terkait dengan
- (tebak apa?) kata kunci <tt>this</tt>.
- Masalahnya adalah bahwa <tt>this.formFields</tt> tidak didefinisikan jika
- <tt>this</tt> berisi sebuah referensi ke tombol, tepatnya itulah apa yang terjadi. Satu solusi cepat adalah menulis ulang baris kode terakhir.
-</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_820251">
-clearButton.onclick = function()
-{
- myHelper.emptyAllFields();
-};
-</com:TTextHighlighter>
-<p id="820725" class="block-content">
- Cara itu kita membuat fungsi baru yang memanggil metode penolong di dalam konteks obyek penolong.
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/id/Scripts1.page b/demos/quickstart/protected/pages/Advanced/id/Scripts1.page deleted file mode 100755 index 51535de1..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/Scripts1.page +++ /dev/null @@ -1,86 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="6601">Catatan Pengembang untuk prototype.js</h1>
-Bimbingan ini didasarkan pada <a href="http://www.sergiopereira.com/articles/prototype.js.html">
-Catatan Pengembang untuk prototype.js</a> oleh Sergio Pereira.
-
-<h2 id="6603">Apa itu?</h2>
-<p id="830726" class="block-content">
-Dalam hal Anda tidak pernah menggunakannya, <a href="http://prototype.conio.net">prototype.js</a> adalah librari
- JavaScript yang ditulis oleh <a href="http://www.conio.net">Sam Stephenson</a>.
- Pemikiran yang hebat ini dan kode <b>sesuai-standar</b> yang ditulis dengan baik mengambil banyak beban terkait dengan pembuatan halaman web sangat interaktif dan kaya yang mengkarakterkan Web 2.0 di belakang Anda.
-</p>
-
-<p id="830727" class="block-content">
- Jika Anda baru saja mencoba menggunakan librari ini, Anda mungkin mencatat bahwa dokumentasi bukanlah salah satu titik yang terkuat. Seperti banyak pengembang lain sebelum saya, saya mempelajari prototype.js dengan membaca kode sumber dan melakukan percobaan denganya. Saya pikir akan baik jika mengambil catatan selama saya mempelajari dan berbagi dengan orang lain.
-</p>
-<p id="830728" class="block-content">
- Setelah Anda membaca contoh dan referensi, para pengembang yang terbiasa dengan bahasa pemrograman Ruby akan mencatat kesamaan maksud antara kelas built-in Ruby dan banyak ekstensi diimplementasikan oleh librari ini.
-</p>
-
-
-<h2 id="6604">Menggunakan fungsi <tt>$()</tt></h2>
-<p id="830729" class="block-content">
- Fungsi <tt>$()</tt> adalah jalan pintas yang siap digunakan untuk fungsi yang semua-terlalu-sering <tt>document.getElementById()</tt> terhadap DOM. Seperti fungsi DOM, fungsi ini mengembalikan elemen yang id-nya dikirimkan sebagai sebuah argumen.
-</p>
-
-<p id="830730" class="block-content">
- Tidak seperti fungsi DOM, bagaimanapun juga, yang satu ini melampauinya. Anda dapat mengirimkan lebih dari satu id dan
- <tt>$()</tt> akan mengembalikan obyek <tt>Array</tt> dengan semua elemen yang diminta. Contoh di bawah seharunya menggambarkan ini.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_830252">
-<com:TClientScript UsingClientScripts="prado" />
-<div id="myDiv">
- <p id="830731" class="block-content">This is a paragraph</p>
-</div>
-
-<div id="myOtherDiv">
- <p id="830732" class="block-content">This is another paragraph</p>
-</div>
-
-<input type="button" value=Test1 onclick="test1();" />
-<input type="button" value=Test2 onclick="test2();" />
-
-<script type="text/javascript">
-/*<![CDATA[*/
-function test1()
-{
- var d = $('myDiv');
- alert(d.innerHTML);
-}
-
-function test2()
-{
- var divs = $('myDiv','myOtherDiv');
- for(i=0; i<divs.length; i++)
- {
- alert(divs[i].innerHTML);
- }
-}
-/*]]>*/
-</script>
-</com:TTextHighlighter>
-<p id="830733" class="block-content">
- Hal baik lainnya dari fungsi ini adalah bahwa Anda bisa mengirimkan baik string <tt>id</tt> ataupun elemen obyek itu sendiri, yang menjadikan fungsi ini sangat berguna ketika membuat fungsi lain yang juga mengambil bentuk argumen.
-</p>
-
-<h2 id="6605">Menggunakan fungsi <tt>$F()</tt></h2>
-
-<p id="830734" class="block-content">
- Fungsi <tt>$F()</tt> adalah jalan pintas penyambutan lainnya. Ia mengembalikan nilai dari setiap kontrol input field, seperti kotak teks atau daftar drop-down. Fungsi bisa diambil sebagai argumen baik elemen <tt>id</tt> ataupun elemen obyek itu sendiri.
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_830253">
-<input type="text" id="userName" value="Joe Doe" />
-<input type="button" value=Test3 onclick="test3();" />
-
-<script type="text/javascript">
-/*<![CDATA[*/
-function test3()
-{
- alert($F('userName'));
-}
-/*]]>*/
-</script>
-</com:TTextHighlighter>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/id/Scripts2.page b/demos/quickstart/protected/pages/Advanced/id/Scripts2.page deleted file mode 100755 index 80277628..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/Scripts2.page +++ /dev/null @@ -1,214 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="6701">Event DOM dan Javascript</h1>
-
-<h2 id="6702">Penanganan event dasar</h2>
-
-<p id="840735" class="block-content">Sintaks untuk bekerja dengan event terlihat seperti kode di bawah.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840254">
-Event.observe(element, name, observer, [useCapture]);
-</com:TTextHighlighter>
-
-<p id="840736" class="block-content">Menganggap untuk saat ini kita ingin mengamati sebuah link yang diklik, kita dapat melakukan yang berikut:</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840255">
-// <a id="clicker" href="http://foo.com">Click me</a>
-Event.observe('clicker', 'click', function(event)
-{
- alert('clicked!');
-});
-</com:TTextHighlighter>
-
-<p id="840737" class="block-content">Jika kita menginginkan untuk mendapatkan elemen yang memicu event, kita melakukan ini:</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840256">
-Event.observe('clicker', 'click', function(event)
-{
- alert(Event.element(event));
-});
-</com:TTextHighlighter>
-
-<h2 id="6703">Mengamati tekanan tombol</h2>
-
-<p id="840738" class="block-content">Jika kita ingin mengamati tekanan tombol untuk seluruh dokumen, kita dapat melakukan yang berikut:</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840257">
-Event.observe(document, 'keypress', function(event)
-{
- if(Event.keyCode(event) == Event.KEY_TAB)
- alert('Tab Pressed');
-});
-</com:TTextHighlighter>
-
-<p id="840739" class="block-content">Dan katakanlah kita ingin melacak apa yang telak diketikan:</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840258">
-Event.observe('search', 'keypress', function(event)
-{
- Element.update('search-results', $F(Event.element(event)));
-});
-</com:TTextHighlighter>
-
-<p id="840740" class="block-content">Prototipe mendefinisikan properti di dalam obyek event untuk beberapa dari tombol yang lebih umum, maka jangan ragu-ragu untuk mencari di sekitar Prototype guna melihat yang mana saja itu.</p>
-
-<p id="840741" class="block-content">Catatan terakhir pada event tekanan tombol; Jika Anda ingin mendeteksi klik kiri, Anda bisa menggunakan <tt>Event.isLeftClick(event)</tt>.</p>
-
-<h2 id="6704">Mendapatkan koordinat dari penunjuk mouse</h2>
-
-<p id="840742" class="block-content">Tarik dan jatuhkan, pengukuran ulang elemen dinamis, permainan, dan lebih banyak lagi, semuanya memerlukan kemampuan untuk melacak lokasi X dan Y dari mouse. Prototipe menjadikan hal ini cukup sederhana. Kode di bawah melacak posisi X dan Y dari mouse dan memindahkan nilainya ke dalam kotak input bernama mouse.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840259">
-Event.observe(document, 'mousemove', function(event)
-{
- $('mouse').value = "X: " + Event.pointerX(event) +
- "px Y: " + Event.pointerY(event) + "px";
-});
-</com:TTextHighlighter>
-
-<p id="840743" class="block-content">Jika kita ingin mengamati lokasi mouse saat ia melewati elemen tertentu, cukup ubah argumen dokumen ke id atau elemen yang relevan.</p>
-
-<h2 id="6705">Menghentikan Propagasi</h2>
-
-<p id="840744" class="block-content"><tt>Event.stop(event)</tt> akan menghentikan propagasi sebuah event .</p>
-
-<h2 id="6706">Event, Penyatuan, dan Obyek</h2>
-
-<p id="840745" class="block-content">Sejauh ini semuanya sudah jelas, tapi sesuatu mulai menjadi sedikit lebih rumit ketika Anda perlu bekerja dengan event dalam lingkungan obyek-terorientasi. Anda harus berhadapan dengan penyatuan dan sintaks yang terlihat aneh yang memerlukan beberapa waktu bagi Anda untuk mengetahuinya.</p>
-
-<p id="840746" class="block-content">Mari kita lihat pada beberapa kode agar Anda bisa mendapatkan pengertian yang lebih baik atas apa yang sedang saya bicarakan.</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840260">
-EventDispenser = Class.create();
-EventDispenser.prototype =
-{
- initialize: function(list)
- {
- this.list = list;
-
- // Amati klik pada item list kita
- $$(this.list + " li").each(function(item)
- {
- Event.observe(item, 'click', this.showTagName.bindEvent(this));
- }.bind(this));
-
- // Amati saat tombol pada keyboard ditekan.
- // Dalam pengamat, kita memeriksa
- // tombol tab dan memunculkan pesan jika ditekan.
- Event.observe(document, 'keypress', this.onKeyPress.bindEvent(this));
-
- // Amati kotak pencarian kita yang palsu. Ketika pengguna mengetik
- // sesuatu ke dalam kotak, pengamat akan mengambil nilai (-1) itu
- // dan memutakhirkan hasil pencarian div dengannya.
- Event.observe('search', 'keypress', this.onSearch.bindEvent(this));
-
- Event.observe(document, 'mousemove', this.onMouseMove.bindEvent(this));
- },
-
- // Fungsi bebas untuk merespon event
- showTagName: function(event)
- {
- alert(Event.element(event).tagName);
- },
-
- onKeyPress: function(event)
- {
- var code = event.keyCode;
- if(code == Event.KEY_TAB)
- alert('Tab key was pressed');
- },
-
- onSearch: function(event)
- {
- Element.update('search-results', $F(Event.element(event)));
- },
-
- onMouseMove: function(event)
- {
- $('mouse').value = "X: " + Event.pointerX(event) +
- "px Y: " + Event.pointerY(event) + "px";
- }
-}
-</com:TTextHighlighter>
-<p id="840747" class="block-content">Wah! Apa yang terjadi di sini? Kita telah mendefinisikan kelas kustom kita <tt>EventDispenser</tt>. Kita akan menggunakan kelas ini untuk menyiapkan event untuk dokumenkita. Banyak dari kode ini ditulis ulang yang kita lihat di awal kecuali kali ini, kita bekerja dari dalam sebuah obyek.</p>
-
-<p id="840748" class="block-content">Melihat metode <tt>initialize</tt>, sebenarnya kita dapat melihat bagaimana sesuatu menjadi berbeda sekarang. Lihat kode di bawah ini:</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840261">
-// Observe clicks on our list items
-$$(this.list + " li").each(function(item)
-{
- Event.observe(item, 'click', this.showTagName.bindEvent(this));
-}.bind(this));
-</com:TTextHighlighter>
-
-<p id="840749" class="block-content">Kita mendapatkan iterator, penyatuan dan semua hal lainnya. Mari kita rinci apa yang dikerjakan kode ini.</p>
-
-<p id="840750" class="block-content">Pertama kita memburu koleksi elemen berdasarkan selektor CSS. Ini menggunakan fungsi selektor Prototipe <tt>$$()</tt>.
-Setelah kita menemukan daftar item kita berhadapan dengan apa yang kita kirim ke dalam setiap iterasi di mana kita akan menambahkan pengamat kita.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840262">
-Event.observe(item, 'click', this.showTagName.bindEvent(this));
-</com:TTextHighlighter>
-
-<p id="840751" class="block-content">Sekarang, melihat kode di atas, Anda akan mencatat fungsi <tt>bindEvent</tt>. Ini mengambil metode sebelumnya <tt>showTagName</tt> dan memperlakukannya sebagai metode yang akan dipicu ketika seseorang mengklik salah satu dari item daftar kita.</p>
-
-<p id="840752" class="block-content">Anda juga akan mencatat bahwa kita mengirimkan ini sebagai argumen ke fungsi <tt>bindEvent</tt>.
-Ini membolehkan kita untuk mereferensi obyek dalam konteks <tt>EventDispenser</tt>
-di dalam fungsi <tt>showTagName(event)</tt> kita. Jika fungsi <tt>showTagName</tt> memerlukan parameter tambahan, Anda melampirkannya ke parameter terakhir dari <tt>bindEvent</tt>. Sebagai contoh</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840263">
-this.showTagName.bindEvent(this, param1, param2);
-
-//di mana fungsi showTagName didefinisikan seperti
-showTime : function (event, param1, param2) { ... }
-</com:TTextHighlighter>
-
-<p id="840753" class="block-content">Selanjutnya, Anda akan melihat <tt>bind(this)</tt> yang dilampirkan ke fungsi iterator.
-Ini sama sekali tidak berkaitan dengan event, ia berada di sini untuk membolehkan saya menggunakan <tt>this</tt> di dalam iterator. Jika kita tidak menggunakan <tt>bind(this)</tt>, saya tidak bisa mereferensi metode <tt>showTagName</tt> di dalam iterator.</p>
-
-<p id="840754" class="block-content">Ok, kita berlanjut untuk melihat metode kita yang sebenarnya dipanggil saat terjadi event. Karena kita sudah berhadapan dengan <tt>showTagName</tt>, mari kita lihat itu.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840264">
-showTagName: function(event)
-{
- alert(Event.element(event).tagName);
-}
-</com:TTextHighlighter>
-
-<p id="840755" class="block-content">Seperti yang Anda lihat, fungsi ini menerima satu argumen--event.
-Agar kita mendapatkan elemen yang memicu event kita perlu mengirimkan argumen ke <tt>Event.element</tt>. Sekarang kita dapat memanipulasinya kapan saja.</p>
-
-<p id="840756" class="block-content">Ini mencakup bagian yang paling membingungkan dari kode kita. Teks di atas juga relevan untuk bagian sisa dari kode kita. Jika ada sesuatu mengenai ini yang tidak Anda mengerti, jangan ragu-ragu untuk mengajukan pertanyaan dalam forum.</p>
-
-<h2 id="6707">Menghapus Pendengar Event</h2>
-
-<p id="840757" class="block-content">Yang satu ini melontarkan saya dari lingkaran untuk pertama kali saya mencoba menggunakannya.
-Saya mencoba sesuatu yang mirip dengan apa yang saya lakukan dalam pemanggilan <tt>Event.observe</tt> dengan kekecualian penggunaan <tt>stopObserving</tt>, tapi tidak ada yang berubah. Dengan kata lain, kode di bawah ini <b>TIDAK</b> bekerja.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840265">
-$$(this.list + " li").each(function(item)
-{
- Event.stopObserving(item, 'click', this.showTagName);
-}.bind(this));
-</com:TTextHighlighter>
-
-<p id="840758" class="block-content">Apa yang terjadi di sini? Alasan ini tidak bekerja karena tidak ada penunjuk ke pengamat. Ini berarti bahwa ketika kita mengirimkan <tt>this.showTagName</tt> dalam metode <tt>Event.observe</tt> sebelumnya, kita mengirimkannya sebagai fungsi anonim. Kita tidak bisa mereferensi fungsi anonim karena ia tidak mempunyai penunjuk.</p>
-
-<p id="840759" class="block-content">Lalu bagaimana kita yakin pekerjaan diselesaikan? Semua yang kita perlukan adalah memberikan fungsi mengamati penunjuk, atau kelompok versi bebas: Setel variabel yang mengarah ke <tt>this.showTagName</tt>. Ok, mari kita ubah kode kita sedikit.</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840266">
-this.showTagObserver = this.showTagName.bindEvent(this);
-
-// Amati klik pada item list kita
-$$(this.list + " li").each(function(item)
-{
- Event.observe(item, 'click', this.showTagObserver);
-}.bind(this));
-</com:TTextHighlighter>
-
-<p id="840760" class="block-content">Sekarang kita bisa menghapus pendengar event dari daftar kita seperti ini:</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_840267">
-$$(this.list + " li").each(function(item)
-{
- Event.stopObserving(item, 'click', this.showTagObserver);
-}.bind(this));
-</com:TTextHighlighter>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/id/Scripts3.page b/demos/quickstart/protected/pages/Advanced/id/Scripts3.page deleted file mode 100755 index b313e7fc..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/Scripts3.page +++ /dev/null @@ -1,35 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="6801">Javascript dalam PRADO, Pertanyaan dan Jawaban</h1>
-<h2 id="6802">Bagaimana saya menyertakan librari Javascript yang didistribusikan dengan Prado?</h2>
-<p id="880060" class="block-content">Librari javascript yang didistribusikan dengan Prado dapat ditemukan dalam direktori
-<tt>framework/Web/Javascripts/source</tt>. File <tt>packages.php</tt>
-dalam direktori itu mendefinisikan daftar nama paket yang tersedia yang diambil. Itu bisa diambil seperti berikut.
-</p>
-<ul id="u1" class="block-content"><li>Menambahkan librari dalam template
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_850268">
-<com:TClientScript PradoScripts="effects" />
-</com:TTextHighlighter>
- </li>
- <li>Menambahkan librari dalam kode PHP
- <com:TTextHighlighter Language="php" CssClass="source block-content" id="code_850269">
-$this->getPage()->getClientScript()->registerPradoScript("effects");
- </com:TTextHighlighter>
- </li>
-</ul>
-Paket librari yang tersedia disertakan dalam Prado adalah
-<ul id="u2" class="block-content">
- <li><tt>prado</tt> : javascript dasar kerangka kerja PRADO berdasarkan Prototype</li>
- <li><tt>effects</tt> : efek visual dari script.aculo.us</li>
- <li><tt>ajax</tt> : terkait ajax dan callback bedasarkan Prototype</li>
- <li><tt>validator</tt> : validasi</li>
- <li><tt>logger</tt> : pencatat javascript dan browser obyek</li>
- <li><tt>datepicker</tt> : datepicker</li>
- <li><tt>colorpicker</tt> : colorpicker</li>
-</ul>
-
-<p id="850761" class="block-content">Ketergantungan masing-masing librari secara otomatis dipecahkan. Komponen yang memerlukan libari tertentu juga akan secara otomatis mengambil librari yang diperlukan.
-Sebagai contoh, jika Anda menambah komponen <tt>TDatePicker</tt> pada halaman, <tt>datepicker</tt> dan dependensinya akan secara otomatis disertakan pada halaman.</p>
-
-<p id="850762" class="block-content">Lihat <a href="?page=Controls.ClientScript">TClientScript</a> untuk opsi penambahan kode Javascript kustom Anda ke halaman.</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/id/Security.page b/demos/quickstart/protected/pages/Advanced/id/Security.page deleted file mode 100755 index 5e6a8602..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/Security.page +++ /dev/null @@ -1,79 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5601">Keamanan</h1>
-
-<h2 id="5602">Perlindungan Kondisi Tampilan</h2>
-<p id="730563" class="block-content">
-Kondisi tampilan berada di jantung PRADO. Kondisi tampilan menggambarkan data yang bisa dipakai untuk menyimpan kembali halaman ke kondisi terakhir kali dilihat oleh pengguna akhir sebelum membuat permintaan saat ini. Standarnya, PRADO menggunakan field tersembunyi untuk menyimpan informasi kondisi tampilan.
-</p>
-<p id="730564" class="block-content">
-Sangat penting untuk memastikan bahwa kondisi tampilan tidak dirusak oleh pengguna akhir. Tanpa perlindungan, pengguna yang jahat bisa menginjeksi kode berbahaya ke dalam kondisi tampilan dan instruksi yang tidak diinginkan yang mungkin dilakukan ketika kondisi halaman sedang dikembalikan pada sisi server.
-</p>
-<p id="730565" class="block-content">
-Untuk mencegah kondisi tampilan dari perusakan, PRADO memaksa kondisi tampilan memeriksa HMAC (Keyed-Hashing for Message Authentication) sebelum menyimpan kembali kondisi tampilan. Pemeriksaan itu bisa mendeteksi apakah kondisi tampilan sudah dirusak atau tidak oleh pengguna akhir. Seandainya kondisi tampilan dimodifikasi, PRADO akan berhenti mengembalikan kondisi tampilan dan mengembalikan pesan kesalahan.
-</p>
-<p id="730566" class="block-content">
-Pemeriksaan HMAC memerlukan kunci pribadi yang harus menjadi rahasia bagi pengguna akhir. Para pengembang dapat menetapkan kunci ataupun membiarkan PRADO membuat kunci secara otomatis. Menetapkan kunci secara manual berguna saat aplikasi berjalan pada taman server. Untuk melakukannya, konfigurasi <tt>TSecurityManager</tt> dalam konfigurasi aplikasi,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_730186">
-<modules>
- <module id="security"
- class="TSecurityManager"
- ValidationKey="my private key" />
-</modules>
-</com:TTextHighlighter>
-<p id="730567" class="block-content">
-Pemeriksaan HMAC tidak mencegah pengguna akhir dari pembacaan konten kondisi tampilan. Ukuran keamanan yang ditambahkanadalah untuk mengenkripsi informasi kondisi tampilan agar pengguna akhir tidak bisa mengurainya. Untuk menghidupkan enkripsi kondisi tampilan, setel <tt>EnableStateEncryption</tt> dari halaman menjadi true. Ini dapat dilakukan dalam <a href="?page=Configurations.PageConfig">konfigurasi halaman</a> atau dalam kode halaman. Catatan, mengenkripsi kondisi tampilan dapat menurunkan performansi aplikasi. Strategi yang lebih baik adalah dengan menyimpan kondisi tampilan pada sisi server daripada field tersembunyi.
-</p>
-
-<h2 id="5603">Pencegahan Penaskahan Situs Silang</h2>
-<p id="730568" class="block-content">
-Penaskahan situs silang (juga dikenal sebagai XSS) terjadi saat aplikasi web mengumpulkan data dari pengguna. Penyerang akan sering menyuntikan JavaScript, VBScript, ActiveX, HTML, atau Flash menjadi aplikasi yang mudah diserang guna mengelabui pengguna aplikasi lain dan mengumpulkan data darinya. Sebagai contoh, Sistem forum yang didesain dengan buruk dapat menampilkan input pengguna dalam tulisan forum tanpa pemeriksaan apapun. Kemudian penyerang bisa menyuntikan beberapa kode jahat JavaScript ke dalam sebuah tulisan agar pengguna lain membaca tulisan ini, JavaScript berjalan tidak seperti yang diharapkan pada komputernya.
-</p>
-<p id="730569" class="block-content">
-Salah satu ukuran paling penting guna mencegah penyerangan XSS adalah memeriksa input pengguna sebelum menampilkannya. Seseorang dapat melakukan pengkodean-HTML dengan input pengguna untuk mencapai tujuan ini. Akan tetapi, dalam beberapa situasi, pengkodean-HTML mungkin tidak disukai karena ia mematikan seluruh tag HTML.
-</p>
-<p id="730570" class="block-content">
-PRADO menyertakan pekerjaan <a href="http://pixel-apes.com/safehtml/">SafeHTML</a> dan menyediakan bagi para pengembang komponen berguna yang disebut <tt>TSafeHtml</tt>. Dengan mengurung konten di dalam tag komponen <tt>TSafeHtml</tt>, konten yang dikurung dipastikan amab bagi pengguna akhir. Sebagai tambahan, <tt>TTextBox</tt> yang umum dipakai memiliki properti <tt>SafeText</tt> yang berisi input pengguna yang dipastikan aman bila ditampilkan secara langsung ke pengguna akhir.
-</p>
-
-<h2 id="5604">Pencegahan Serangan Cookie</h2>
-<p id="730571" class="block-content">
-Melindungi cookie dari serangan adalah sangat penting, karena ID sesi umumnya disimpan dalam cookie. Jika seseorang memegang ID sesi, intinya ia mempunyai semua informasi sesi relevan.
-</p>
-<p id="730572" class="block-content">
-Ada beberapa pengukur guna mencegah cookie dari serangan.
-</p>
-<ul id="u1" class="block-content">
- <li>Aplikasi dapat menggunakan SSL untuk membuat kanal komunikasi aman dan hanya mengirimkan cookie otentikasi melalui sambungan HTTPS. Para penyerang selanjutnya melakukan decipher isi dalam cookie yang dikirimkan.</li>
- <li>Sesi berakhir secara tidak benar, termasuk semua token cookie dan sesi, untuk mengurangi kemungkinan penyerangan.</li>
- <li>Mencegah penaskahan situs-silang (XSS) yang menyebabkan kode sesukanya berjalan dalam browser pengguna dan memunculkan cookie-nya.</li>
- <li>Memvalidasi data cookie dan mendeteksi apakah cookie diubah atau tidak.</li>
-</ul>
-<p id="730573" class="block-content">
-PRADO menertapkan skema validasi cookie yang mencegah cookie dimodifikasi. Dalam keadaan tertentu, ia melakukan pemeriksaan HMAC untuk nilai cookie jika validasi cookie dihidupkan.
-</p>
-<p id="730574" class="block-content">
-Validasi cookie standarnya dimatikan. Untuk menghidupkannya, konfigurasi modul <tt>THttpRequest</tt> seperti berikut,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_730187">
-<modules>
- <module id="request" class="THttpRequest" EnableCookieValidation="true" />
-</modules>
-</com:TTextHighlighter>
-<p id="730575" class="block-content">
-Untuk menggunakan skema validasi cookie yang disediakan oleh PRADO, Anda juga perlu mengambil cookie melalui koleksi <tt>Cookies</tt> dari <tt>THttpRequest</tt> dengan menggunakan pernyataan PHP berikut,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_730188">
-foreach($this->Request->Cookies as $cookie)
- // $cookie adalah tipe THttpCookie
-</com:TTextHighlighter>
-<p id="730576" class="block-content">
-Untuk mengirimkan data cookie yang dikode dengan informasi validasi, buat obyek <tt>THttpCookie</tt> baru dan menambahkannya ke koleksi <tt>Cookies</tt> dari <tt>THttpResponse</tt>,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_730189">
-$cookie=new THttpCookie($name,$value);
-$this->Response->Cookies[]=$cookie;
-</com:TTextHighlighter>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/id/State.page b/demos/quickstart/protected/pages/Advanced/id/State.page deleted file mode 100755 index 42c5a0c4..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/State.page +++ /dev/null @@ -1,54 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="6001">Kondisi Persisten</h1>
-<p id="770606" class="block-content">
-Aplikasi Web sering memerlukan untuk mengingat apa yang pengguna akhir kerjakan dalam permintaan halaman sebelumnya agar permintaan halaman baru bisa dilayani sesuai dengan itu. Persisten kondisi untuk menangani masalah ini. Secara tradisional, jika halaman perlu memelihara interaksi pengguna, ia akan mengurut ulang sesi, cookie, atau field tersembunyi. PRADO menyediakan baris baru skema kondisi persisten, termasuk kondisi tampilan, kondisi kontrol, dan kondisi aplikasi.
-</p>
-
-<h2 id="6002">Kondisi Tampilan</h2>
-<p id="770607" class="block-content">
-Kondisi tampilan berada di jantung PRADO. Dengan kondisi tampilan, halaman Web menjadi tangguh dan mampu menyimpan kembali halaman ke kondisi terakhir kali pengguna akhir berinteraksi sebelum permintaan halaman saat ini. Pemrograman Web mirip dengan pemrograman GUI Windows, dan para pengembang dapat berpikir secara kontinyu tanpa mencemaskan mengenai perjalanan pulang pergi antara pengguna akhir dan server web. Sebagai contoh, dengan kondisi tampilan, sebuah kontrol kotak centang dapat mendeteksi apakah input pengguna mengubah konten dalam kotak centang atau tidak.
-</p>
-<p id="770608" class="block-content">
-Kondisi tampilan hanya tersedia untuk kontrol. Kondisi tampilan dari kontrol bisa dimatikan dengan menyetel properti <tt>EnableViewState</tt> menjadi false. Untuk menyimpan variabel dalam kondisi tampilan, panggil yang berikut,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_770197">
-$this->setViewState('Caption',$caption);
-</com:TTextHighlighter>
-<p id="770609" class="block-content">
-di mana <tt>$this</tt> merujuk ke obyek kontrol, <tt>Caption</tt> adalah kunci unik yang mengidentifikasi variabel <tt>$caption</tt> yang disimpan dalam kondisi tampilan. Untuk mengambil variabel kembali dari kondisi tampilan, panggil yang berikut,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_770198">
-$caption = $this->getViewState('Caption');
-</com:TTextHighlighter>
-
-<h2 id="6003">Kondisi Kontrol</h2>
-<p id="770610" class="block-content">
-Kondisi kontrol mirip dengan kondisi tampilan dalam setiap aspek kecuali bahwa kondisi kontrol tidak bisa dimatikan. Kondisi kontrol bertujuan dipakai untuk menyimpan informasi kondisi krusial halaman atau kontrol mana yang tidak bekerja dengan baik.
-</p>
-<p id="770611" class="block-content">
-Untuk menyimpan dan mengambil variabel dalam kondisi kontrol, gunakan perintah berikut,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_770199">
-$this->setControlState('Caption',$caption);
-$caption = $this->getControlState('Caption');
-</com:TTextHighlighter>
-
-<h2 id="6004">Kondisi Aplikasi</h2>
-<p id="770612" class="block-content">
-Kondisi aplikasi merujuk ke data yang persisten melalui sesi pengguna dan permintaan halaman. Contoh umum dari kondisi aplikasi adalah penghitung kunjungan pengguna. Nilai penghitung adalah persisten meskipun sesi pengguna saat ini berakhir. Catatan, kondisi tampilan dan kondisi kontrol hilang jika permintaan pengguna untuk halaman yang berbeda, karena kondisi sesi hilang jika sesi pengguna berakhir.
-</p>
-<p id="770613" class="block-content">
-Untuk menyimpan dan mengambil variabel dalam kondisi aplikasi, gunakan perintah berikut,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_770200">
-$application->setGlobalState('Caption',$caption);
-$caption = $application->getGlobalState('Caption');
-</com:TTextHighlighter>
-
-<h2 id="6005">Kondisi Sesi</h2>
-<p id="770614" class="block-content">
-PRADO melapisi manajemen sesi tradisional dalam modul <tt>THttpSession</tt>. Modul dapat diakses dari dalam setiap komponen dengan menggunakan <tt>$this->Session</tt>, di mana <tt>$this</tt> merujuk ke obyek komponen.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/id/Themes.page b/demos/quickstart/protected/pages/Advanced/id/Themes.page deleted file mode 100755 index 5a917484..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/Themes.page +++ /dev/null @@ -1,60 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5901">Tema dan Skin</h1>
-
-<h2 id="5902">Pengenalan</h2>
-<p id="760596" class="block-content">
-Tema dalam PRADO menyediakan cara bagi para pengembang untuk menyediakan tampilan konsisten melintasi seluruh aplikasi web. Tema berisi daftar nilai awal untuk properti dari berbagai tipe kontrol. Ketika menerapkan tema ke sebuah halaman, semua kontrol dalam halaman tersebut akan menerima nilai properti awal terkait dari tema. Ini membolehkan tema untuk berinteraksi dengan seti properti yang banyak dari berbagai kontrol PRADO, berarti bahwa tema bisa dipakai untuk menetapkan jangkauan besar dari properti penyajian yang tidak bisa dilakukan metode tema lain (misaslnya CSS). Sebagai contoh, tema bisa dipakai untuk menetapkan ukuran standar halaman dari semua grid data melintasi aplikasi dengan menetapkan nilai standar untuk properti <tt>PageSize</tt> dari kontrol <tt>TDataGrid</tt>.
-</p>
-
-<h2 id="5903">Memahami Tema</h2>
-<p id="760597" class="block-content">
-Tema adalah sebuah direktori yang terdiri dari file skin, file javascript dan file CSS. Setiap file javascript atau CSS yang berada dalam tema akan diregistrasi dengan halaman yang menerapkan tema. Skin adalah set nilai properti awal untuk tipe kontrol tertentu. Tipe kontrol dapat memiliki satu atau beberapa skin, masing-masing diidentifikasi dengan <tt>SkinID</tt> unik. Ketika menerapkan tema ke sebuah halaman, skin diterapkan ke kontrol jika tipe kontrol dan nilai <tt>SkinID</tt> keduanya sama dengan ada dalam skin. Catatan, jika skin memiliki nilai <tt>SkinID</tt> kosong, ia akan menerapkannya ke semua kontrol dari tipe tertentu yang <tt>SkinID</tt>-nya tidak disetel atau kosong. File skin terdiri dari satu atau beberapa skin, untuk satu atau beberapa tipe kontrol. Tema adalah gabungan dari skin yang didefinisikan dalam semua file skin.
-</p>
-
-<h2 id="5904">Menggunakan Tema</h2>
-<p id="760598" class="block-content">
-Untuk menggunakan sebuah tema, Anda perlu menyetel properti <tt>Theme</tt> dari halaman dengan nama tema, yaitu nama direktori tema. Anda dapat menyetelnya dalam <a href="?page=Configurations.PageConfig">konfigurasi halaman</a> atau dalam konstruktor atau metode <tt>onPreInit()</tt> dari halaman. Anda tidak bisa menyetel properti setelah <tt>onPreInit()</tt> karena saat itu, kontrol anak dari halaman sudah dibuat (skin harus diterapkan ke kontrol setelah kontrol tersebut dibuat.)
-</p>
-<p id="760599" class="block-content">
-Untuk menggunakan skin tertentu dalam tema untuk sebuah kontrol, setel properti <tt>SkinID</tt> dari kontrol dalam template seperti berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_760194">
-<com:TButton SkinID="Blue" ... />
-</com:TTextHighlighter>
-<p id="760600" class="block-content">
-Ini akan menerapkan skin 'Blue' ke tombol. Catatan, nilai properti awal yang ditetapkan oleh skin 'Blue' akan mengganti setiap nilai properti tombol. Gunakan tema stylesheet jika Anda tidak ingi diganti. Untuk menggunakan tema stylesheet, setel properti <tt>StyleSheetTheme</tt> dari halaman daripada <tt>Theme</tt> (Anda bisa memiliki keduanya <tt>StyleSheetTheme</tt> dan <tt>Theme</tt>).
-</p>
-<p id="760601" class="block-content">
-Untuk menggunakan file Javascript dan file CSS yang berada dalam sebuah tema, kontrol <tt>THead</tt> harus ditempatkan pada template halaman. Ini dikarenakan tema akan meregistrasi file itu dengan halaman dan <tt>THead</tt> adalah tempat yang tepat untuk menempatkan mengambil file tersebut.
-</p>
-<p id="760602" class="block-content">
-Dimungkinkan untuk menetapkan tipe media dari file CSS yang berisikan sebuah tema. Standarnya, file CSS berlaku untuk semua tipe media. Jika file CSS bernama seperti <tt>mystyle.print.css</tt>, ia akan diterapkan hanya pada tipe media <tt>print</tt>. Sebagai contoh lain, <tt>mystyle.screen.css</tt> hanya berlaku untuk media <tt>screen</tt>, dan <tt>mystyle.css</tt> berlaku bagi semua tipe media.
-</p>
-
-<h2 id="5905">Penyimpanan Tema</h2>
-<p id="760603" class="block-content">
-Semua tema standarnya harus ditempatkan di bawah direktori <tt>[AppEntryPath]/themes</tt>, di mana <tt>AppEntryPath</tt> merujuk ke direktori yang berisi naskah entri aplikasi. Jika Anda ingin menggunakan direktori berbeda, konfigurasi properti <tt>BasePath</tt> dan <tt>BaseUrl</tt> dari modul <tt>System.Web.UI.TThemeManager</tt> dalam konfigurasi aplikasi,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_760195">
-<service id="page" class="TPageService">
- <modules>
- <module id="theme"
- class="System.Web.UI.TThemeManager"
- BasePath="mythemes"
- BaseUrl="mythemes" />
- </modules>
-</service>
-</com:TTextHighlighter>
-
-<h2 id="5906">Membuat Tema</h2>
-<p id="760604" class="block-content">
-Membuat sebuah tema melibatkan pembuatan direktori tema dan penulisan file skin (dan kemungkinan file Javascript serta CSS). Nama file skin harus diakhiri dengan <tt>.skin</tt>. Format file skin adalah sama seperti file template kontrol. Karena file skin tidak mendefinisikan penyajian hubungan leluhur-aak diantara kontrolnya, Anda tidak bisa menempatkan tag komponen di dalam yang lainnya. Dan setiap teks statis antara tag komponen diabaikan. Untuk mendefinisikan skin 'Blue' seperti telah disebutkan di atas untuk <tt>TButton</tt>, tulis yang berikut dalam file skin,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_760196">
-<com:TButton SkinID="Blue" BackColor="blue" />
-</com:TTextHighlighter>
-<p id="760605" class="block-content">
-Seperti sudah disebutan di atas, Anda dapat menyimpan beberapa skin dalam satu file skin, atau memisahkannya ke dalam beberapa file. Strategi yang umum digunakan adalah bahwa setiap file skin hanya berisi skin untuk satu tipe kontrol. Sebagai contoh, <tt>Button.skin</tt> akan berisi skin hanya untuk tipe kontrol <tt>TButton</tt>.
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Advanced/id/exception.gif b/demos/quickstart/protected/pages/Advanced/id/exception.gif Binary files differdeleted file mode 100755 index 93b1a07f..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/exception.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Advanced/id/exception2.gif b/demos/quickstart/protected/pages/Advanced/id/exception2.gif Binary files differdeleted file mode 100755 index 5fe0e625..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/exception2.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Advanced/id/logrouter.gif b/demos/quickstart/protected/pages/Advanced/id/logrouter.gif Binary files differdeleted file mode 100755 index 5a74dfe1..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/logrouter.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Advanced/id/mastercontent.gif b/demos/quickstart/protected/pages/Advanced/id/mastercontent.gif Binary files differdeleted file mode 100755 index 9354d65c..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/mastercontent.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Advanced/id/pcrelation.gif b/demos/quickstart/protected/pages/Advanced/id/pcrelation.gif Binary files differdeleted file mode 100755 index c1960d74..00000000 --- a/demos/quickstart/protected/pages/Advanced/id/pcrelation.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Configurations/id/AppConfig.page b/demos/quickstart/protected/pages/Configurations/id/AppConfig.page deleted file mode 100755 index c73ddd6f..00000000 --- a/demos/quickstart/protected/pages/Configurations/id/AppConfig.page +++ /dev/null @@ -1,59 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="1801">Konfigurasi Aplikasi</h1>
-<p id="210213" class="block-content">
-Konfigurasi aplikasi digunakan untuk menetapkan perilaku global atas aplikasi. Ini terrmasuk spesifikasi alias path, pemakaian namespace, konfigurasi modul dan dan layanan, serta parameter.
-</p>
-<p id="210214" class="block-content">
-Konfigurasi untuk aplikasi disimpan dalam sebuah file XML bernama <tt>application.xml</tt>, yang harus ditempatkan di bawah path basis aplikasi. Formatnya ditampilkan berikut ini. Spesifikasi lengkap dari konfigurasi aplikasi dapat ditemukan dalam file <a href="<%~../../../../../../docs/specs/application.dtd%>">DTD</a> dan <a href="<%~../../../../../../docs/specs/application.xsd%>">XSD</a>.
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_210095">
-<application PropertyName="PropertyValue" ...>
- <paths>
- <alias id="AliasID" path="AliasPath" />
- <using namespace="Namespace" />
- </paths>
- <modules>
- <module id="ModuleID" class="ModuleClass" PropertyName="PropertyValue" ... />
- </modules>
- <parameters>
- <parameter id="ParameterID" class="ParameterClass" PropertyName="PropertyValue" ... />
- </parameters>
- <include file="path.to.extconfig" when="PHP expression" />
- <services>
- <service id="ServiceID" class="ServiceClass" PropertyName="PropertyValue" ... />
- </services>
-</application>
-</com:TTextHighlighter>
-
-<ul id="u1" class="block-content">
-
-<li>Elemen paling luar <tt><application></tt> berkaitan dengan turunan <tt>TApplication</tt>. Pasangan <tt>PropertyName="PropertyValue"</tt> menetapkan nilai awal untuk properti <tt>TApplication</tt>.</li>
-
-<li>Elemen <tt><paths></tt> berisi definisi alias path dan path penyertaan PHP untuk aplikasi. Setiap alias path ditetapkan melalui <tt><alias></tt> yang mana atribut <tt>path</tt> mengambil path absolut atau path relatif ke direktori yang berisi file konfigurasi aplikasi. Elemen <tt><using></tt> menetapkan path tertentu (dalam batasan namespace) akan ditambahkan ke path include PHP saat aplikasi dijalankan. PRADO mendefinisikan dua alias standar: <tt>System</tt> dan <tt>Application</tt>. Pembentuk merujuk ke direktori akar framework PRADO, dan yang terakhir merujuk ke direktori berisi file konfigurasi aplikasi.</li>
-
-<li>Elemen <tt><modules></tt> berisi konfigurasi untuk daftar modul. Setiap modul ditetapkan dengan elemen <tt><module></tt>. Setiap modul diidentifikasi secara unik oleh atribut <tt>id</tt> dan tipe <tt>class</tt>. Pasangan <tt>PropertyName="PropertyValue"</tt> menetapkan nilai awal untuk properti modul.</li>
-
-<li>Elemen <tt><parameters></tt> berisi daftar parameter level-aplikasi yang dapat diakses dari mana saja dalam aplikasi. Anda bisa menetapkan parameter tipe-komponen seperti menetapkan modul, atau Anda bisa menetapkan parameter tipe-string yang merupakan format lebih sederhana seperti berikut,
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_210096">
-<parameter id="ParameterID" value="ParameterValue" />
-</com:TTextHighlighter>
-Catatan, jika atribut <tt>value</tt> tidak ditetapkan, seluruh parameter XML node (dari tipe <tt>TXmlElement</tt>) akan dikembalikan sebagai nilai parameter. Sebagai tambahan, modul <tt>System.Util.TParameterModule</tt> menyediakan satu cara untuk mengambil parameter dari file XML eksternal. Lihat lebih jelasnya dalam dokumentasi API.
-</li>
-
-<li>Elemen <tt><include></tt> membolehkan seseorang menyertakan file konfigurasi eksternal. Sudah diperkenalkan sejak v3.1.0. Atribut <tt>file</tt> menetapkan file konfigurasi eksternal dalam format namespace. Nama ekstensi dari file harus <tt>.xml</tt>. Atribut <tt>when</tt> berisi ekspresi PHP dan opsional (standarnya true). Hanya ketika ekspresi mengevaluasi true, file konfigurasi eksternal akan disertakan. Konteks ekspresi adalah aplikasi, misalnya <tt>$this</tt> dalam ekspresi akan merujuk ke obyek aplikasi.
-</li>
-
-<li>Elemen <tt><services></tt> mirip dengan elemen <tt><modules></tt>. Ia sebagian besar menetapkan layanan yang disediakan oleh aplikasi. Di dalam elemen <tt><service></tt>, seseorang dapat memiliki salah satu elemen di atas. Ini akan efektif hanya ketika layanan terkait sedang diminta.</li>
-
-</ul>
-
-<p id="210215" class="block-content">
-File konfigurasi eksternal mempunyai format yang sama seperti dijelaskan di atas. Meskipun nama elemen akar tidak menjadi masalah, direkomendasikan adalah <tt><configuration></tt>. Konfigurasi eksternal akan menambah konfigurasi utama. Sebagai contoh, jika alias path ditetapkan dalam konfigurasi eksternal, ia akan menjadi tersedia sebagai tambahan terhadap alias yang ditetapkan dalam konfigurasi utama.
-</p>
-
-<p id="210216" class="block-content">
-Standarnya tanpa konfigurasi eksplisit, aplikasi PRADO akan mengambil beberapa modul inti, seperti <tt>THttpRequest</tt>, <tt>THttpResponse</tt>, dll. Ia juga akan menyediakan <tt>TPageService</tt> sebagai layanan standar. Konfigurasi dan penggunaan modul serta layanan ini tercakup dalam seksi individual pada tutorial ini. Catatan, jika aplikasi Anda mengambil setelan standar untuk modul dan layanan ini, Anda tidak perlu menyediakan konfigurasi aplikasi. Akan tetapi, jika modul atau layanan ini tidak mencukupi, atau Anda ingin menghubah perilakunya dengan mengkonfigurasi nilai propertinya, Anda memerlukan konfigurasi aplikasi.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Configurations/id/Overview.page b/demos/quickstart/protected/pages/Configurations/id/Overview.page deleted file mode 100755 index 480eab84..00000000 --- a/demos/quickstart/protected/pages/Configurations/id/Overview.page +++ /dev/null @@ -1,10 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="1401">Tinjauan Konfigurasi</h1>
-<p id="170164" class="block-content">
-PRADO menggunakan konfigurasi untuk merekat komponen bersama ke dalam halaman dan aplikasi. Ada <a href="?page=Configurations.AppConfig">konfigurasi aplikasi</a>, <a href="?page=Configurations.PageConfig">konfigurasi halaman</a>, dan <a href="?page=Configurations.Templates1">template</a>.
-</p>
-<p id="170165" class="block-content">
-Konfigurasi aplikasi dan halaman adalah opsional jika nilai standar yang dipakai. Template sebagian besar digunakan oleh halaman dan kontrol template. Ini juga opsional.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Configurations/id/PageConfig.page b/demos/quickstart/protected/pages/Configurations/id/PageConfig.page deleted file mode 100755 index 2a05b3dc..00000000 --- a/demos/quickstart/protected/pages/Configurations/id/PageConfig.page +++ /dev/null @@ -1,47 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="1901">Konfigurasi Halaman</h1>
-<p id="220217" class="block-content">
-Konfigurasi halaman sebagian besar dipakai oleh <tt>TPageService</tt> untuk memodifikasi atau menambahkan konfigurasi aplikasi. Seperti ditunjukan oleh namanya, konfigurasi halaman dikaitkan dengan direktori yang menyimpan beberapa file halaman. Ia disimpan sebagai file XML bernama <tt>config.xml</tt>.
-</p>
-<p id="220218" class="block-content">
-Ketika pengguna meminta halaman yang disimpan di bawah <tt><BasePath>/dir1/dir2</tt>, <tt>TPageService</tt> akan mencoba untuk mengurai dan mengambil file <tt>config.xml</tt> di bawah <tt><BasePath></tt>, <tt><BasePath>/dir1</tt> dan <tt><BasePath>/dir1/dir2</tt>. Path, modul, dan parameter yang ditetapkan dalam file konfigurasi ini akan ditambahkan atau digabungkan ke dalam konfigurasi aplikasi yang sudah ada. Di sini <tt><BasePath></tt> seperti yang didefinisikan dalam <a href="?page=Fundamentals.Services">layanan halaman</a>.
-</p>
-<p id="220219" class="block-content">
-Format file konfigurasi halaman adalah sebagai berikut,
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_220097">
-<configuration>
- <paths>
- <alias id="AliasID" path="AliasPath" />
- <using namespace="Namespace" />
- </paths>
- <modules>
- <module id="ModuleID" class="ModuleClass" PropertyName="PropertyValue" ... />
- </modules>
- <parameters>
- <parameter id="ParameterID" class="ParameterClass" PropertyName="PropertyValue" ... />
- </parameters>
- <include file="path.to.extconfig" when="PHP expression" />
- <authorization>
- <allow pages="PageID1,PageID2" users="User1,User2" roles="Role1,Role2" verb="get" />
- <deny pages="PageID1,PageID2" users="User1,User2" roles="Role1,Role2" verb="post" />
- </authorization>
- <pages PropertyName="PropertyValue" ...>
- <page id="PageID" PropertyName="PropertyValue" ... />
- </pages>
-</configuration>
-</com:TTextHighlighter>
-<p id="220220" class="block-content">
-<tt><paths></tt>, <tt><modules></tt>, <tt><parameters></tt> dan <tt><include></tt> mirip dengan itu dalam konfigurasi aplikasi. Elemen <tt><authorization></tt> menetapkan aturan otorisasi yang berlaku pada direktori halaman saat ini dan seluruh subdirektorinya. Untuk lebih jelasnya, lihat seksi <a href="?page=Advanced.Auth">otentikasi dan otorisasi</a>. Elemen <tt><pages></tt> menetapkan nilai awal untuk properti halaman. Setiap elemen <tt><page></tt> menetapkan nilai awal untuk halaman tertentu yang diidentifikasi oleh atribut <tt>id</tt>. Nilai properti awal yang diberikan dalam elemen <tt><pages></tt> element berlaku untuk semua halaman dalam direktori dan subdirektori saat ini.
-</p>
-<p id="220221" class="block-content">
-Spesifikasi lengkap dari konfigurasi halaman dapat ditemukan dalam file <a href="<%~../../../../../../docs/specs/config.dtd%>">DTD</a> dan <a href="<%~../../../../../../docs/specs/config.xsd%>">XSD</a>.
-</p>
-
-<com:SinceVersion Version="3.1.1" />
-<p class="block-content">
-Sejak versi 3.1.1, atribut <tt>id</tt> dalam elemen <page> bisa berupa path halaman relatif yang mengarah ke halaman di dalam subdirektori pada direktori yang berisi konfigurasi halaman. Sebagai contoh, <tt>id="admin.Home"</tt> merujuk ke halaman <tt>Home</tt> di bawah direktori <tt>admin</tt>. Atribut <tt>id</tt> juga bisa berisi wildcard '*' untuk menemukan seluruh halaman di bawah direktori yang ditetapkan. Sebagai contoh, <tt>id="admin.*"</tt> merujuk ke seluruh halaman di bawah direktori <tt>admin</tt> dan subdirektorinya. Peningkatan ini membolehkan para pengembang untuk memusatkan konfigurasi halamannya (misalnya menyimpan semua inisialisasi semua halaman dalam konfigurasi aplikasi atau konfigurasi akar halaman.)
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Configurations/id/Templates1.page b/demos/quickstart/protected/pages/Configurations/id/Templates1.page deleted file mode 100755 index fa2a3405..00000000 --- a/demos/quickstart/protected/pages/Configurations/id/Templates1.page +++ /dev/null @@ -1,103 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="1501">Template: Bagian I</h1>
-<p id="180166" class="block-content">
-Template dipakai untuk menetapkan penyajian tata letak kontrol. Sebuah template dapat berisi teks statis, komponen, atau kontrol yang membantu penyajian kontrol terkait. Standarnya, turunan <tt>TTemplateControl</tt> atau subkelasnya secara otomatis mengambil dan menurunkan template dari sebuah file yang namanya sama dengan nama kelas kontrol. Untuk template halaman, nama file harus berakhiran <tt>.page</tt>; untuk kontrol template reguler lainnya, akhirannya adalah <tt>.tpl</tt>.
-</p>
-<p id="180167" class="block-content">Format template mirrip HTML, dengan beberapa tag spesifik-PRADO, termasuk <a href="#ct">tag komponen</a>, <a href="#tct">tag kontrol template</a>, <a href="#cot">tag komentar</a>, <a href="?page=Configurations.Templates2#dct">tag konten dinamis</a>, and <a href="?page=Configurations.Templates3#dpt">tag properti dinamis</a>. .
-</p>
-
-<a name="ct"></a>
-<h2 id="1502">Tag Komponen</h2>
-<p id="180168" class="block-content">
-Tag komponen menetapkan komponen sebagai bagian dari konten body pada kontrol template. Jika komponen adalah sebuah kontrol, biasanya akan menjadi anak atau cucu dari kontrol template, dan hasil penyajiannya akan disisipkan di tempat di mana ia terlihat dalam template.
-</p>
-<p id="180169" class="block-content">
-Format dari tag komponen adalah sebagai berikut,
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_180072">
-<com:ComponentType PropertyName="PropertyValue" ... EventName="EventHandler" ...>
-body content
-</com:ComponentType>
-</com:TTextHighlighter>
-<tt>ComponentType</tt> berupa nama kelas atau nama tipe bertitik (contoh <tt>System.Web.UI.TControl</tt>) pada komponen. <tt>PropertyName</tt> dan <tt>EventName</tt> keduanya tidak sensitif-huruf. <tt>PropertyName</tt> bisa berupa nama properti atau subproperti (contoh <tt>Font.Name</tt>). Catatan, <tt>PropertyValue</tt> menjadi dekode HTML saat ditempatkan ke properti terkait. Konten dikurung diantara tag komponen pembuka dan penutup biasanya diperlakukan sebagai badan komponen.
-</p>
-<p id="180170" class="block-content">
-Diperlukan bahwa tag properti komponen saling mengumpulkan dan tag komponen pembuka dipasangkan dengan tag penutup, mirip dengan apa yang ada dalam XML.
-</p>
-<p id="180171" class="block-content">
-Template berikut memperlihatkan sebuah tag komponen yang menetapkan properti <tt>Text</tt> dan event <tt>OnClick</tt> dari kontrol tombol,
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_180073">
-<com:TButton Text="Register" OnClick="registerUser" />
-</com:TTextHighlighter>
-Catatan, nama properti dan nama event semuanya tidak sensitif-huruf, sementara nama tipe komponen adalah sensitif-huruf. Nama event selalu diawali dengan <tt>On</tt>.
-</p>
-<p id="180172" class="block-content">
-Juga diperhatikan, nilai awal untuk properti yang namanya diakhiri dengan <tt>Template</tt> diproses secara khusus. Dalam keadaan tertentu, nilai awal diurai sebagai obyek <tt>TTemplate</tt>. Properti <tt>ItemTemplate</tt> dari kontrol <tt>TRepeater</tt> dalam contoh tersebut.
-</p>
-<p id="180173" class="block-content">
-Untuk menjembatani properti dengan tempat data besar, tag inisialisasi properti berikut diperkenalkan. Ini sama dengan <tt>...PropertyName="PropertyValue"...</tt> pada setiap aspeknya. Tag inisialisasi properti harus secara langsung dikurung diantara tag pembuka dan penutup komponen.
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_180074">
-<prop:PropertyName>
-PropertyValue
-</prop:PropertyName>
-</com:TTextHighlighter>
-<p id="200007" class="block-content">
-Sejak versi 3.1.0, inisialisasi tag properti dapat juga dipakai untuk menginisialisasi set subproperti yang berbagi properti leluhur yang sama. Sebagai contoh, yang berikut adalah sama <tt>HeaderStyle.BackColor="black"</tt> dan <tt>HeaderStyle.ForeColor="red"</tt>.
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_180075">
-<prop:HeaderStyle BackColor="black" ForeColor="red" />
-</com:TTextHighlighter>
-
-<h3 id="1505">ID Komponen</h3>
-<p id="180174" class="block-content">
-Ketika ditetapkan dalam template, properti <tt>ID</tt> komponen mempunyai arti khusus sebagai tambahan terhadap definisi properti normalnya. Tag komponen yang ditetapkan dengan nilai ID dalam template akan meregistrasi komponen terkait ke dalam kontrol pemilik template. Selanjutnya komponen dapat diakses secara langsung dari kontrol template dengan nilai ID-nya. Sebagai contoh, dalam template halaman <tt>Home</tt>, tag komponen berikut
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_180076">
-<com:TTextBox ID="TextBox" Text="First Name" />
-</com:TTextHighlighter>
-memungkinkan untuk memperoleh obyek kotak teks dalam kode menggunakan <tt>$page->TextBox</tt>.
-</p>
-
-<a name="tct"></a>
-<h2 id="1503">Tag Kontrol Template</h2>
-Tag kontrol template digunakan untuk mengkonfigurasi nilai properti awal dari kontrol yang memiliki template. Formatnya adalah sebagai berikut,
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_180077">
-<%@ PropertyName="PropertyValue" ... %>
-</com:TTextHighlighter>
-Seperti dalam tag komponen, <tt>PropertyName</tt> adalah tidak sensitif-huruf dan bisa berupa nama properti atau subproperti.
-</p>
-<p id="180175" class="block-content">
-Nilai awal yang ditetapkan melalui tag kontrol template ditempatkan ke properti terkait saat kontrol template dibentuk. Oleh karena itu, Anda dapat mengganti nilai properti ini dalam langkah berikutnya, seperti tahap <tt>Init</tt> dari kontrol.
-</p>
-<p id="180176" class="block-content">
-Tag kontrol template adalah opsional dalam sebuah template. Setiap template dapat berisi paling banyak satu tag kontrol template. Anda dapat menempatkan tag kontrol template di mana saja di dalam template. Direkomendasikan bahwa Anda menempatkannya di awal template untuk visibilitas lebih baik.
-</p>
-
-<a name="cot"></a>
-<h2 id="1504">Tag Komentar</h2>
-<p id="180177" class="block-content">
-Tag komentar dipakai untuk menyimpan komentar pengembang dalam template yang tidak akan ditampilkan ke pengguna-akhir. Isi dikurung di dalam tag komentar akan diperlakukan sebagai teks tring biasa dan PRADO tidak akan mencoba untuk menguraikannya. Tag komentar tidak bisa dipakai di dalam nilai properti. Format tag komentar adalah sebagai berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_180078">
-<!---
-Komentar TIDAK TERLIHAT bagi pengguna-akhir
---->
-</com:TTextHighlighter>
-<div class="note"><b class="tip">Catatan:</b>
-Tag komentar baru <tt><!--- ... ---></tt> diperkenalkan sejak PRADO versi 3.1. Sebelumnya adalah <tt><!-- ... --!></tt> yang tidak dipakai lagi karena beberapa editor mempunyai masalah dalam penerangan-sintaks tag seperti itu. </div>
-
-<h2 id="1601">Tag Include</h2>
-<p id="180178" class="block-content">
-Sejak versi 3.0.5, PRADO mulai mendukung penyertaan template eksternal. Ini dilakukan melalui tag include, di mana file template eksternal ditetapkan dalam format namespace dan nama filenya harus diakhiri dengan <tt>.tpl</tt>.
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_180079">
-<%include path.to.templateFile %>
-</com:TTextHighlighter>
-
-<p id="180179" class="block-content">
-Template eksternal akan disisipkan di tempat di mana tag include terjadi dalam basis template.
-</p>
-<p id="180180" class="block-content">
-Catatan, pengulangan penyertaan template tidak didukung, misalnya Anda tidak dapat mempunyai tag include di dalam template eksternal.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Configurations/id/Templates2.page b/demos/quickstart/protected/pages/Configurations/id/Templates2.page deleted file mode 100755 index 41bae6d3..00000000 --- a/demos/quickstart/protected/pages/Configurations/id/Templates2.page +++ /dev/null @@ -1,99 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="1601">Template: Bagian II</h1>
-
-<a name="dct"></a>
-<h2 id="1602">Tag Konten Dinamis</h2>
-<p id="190181" class="block-content">
-Tag konten dinamis diperkenalkan sebagai jalan pintas ke beberapa <a href="?page=Configurations.Templates1#ct">tag komponen</a> yang umum dipakai. Tag-tag ini sebagian besar dipakai untuk menyajikan konten yang dihasilkan dari evaluasi beberapa ekspresi atau pernyataan PHP. Ini termasuk <a href="#et">tag ekspresi</a>, <a href="#st">tag pernyataan</a>, <a href="#dt">tag databind</a>, <a href="#pt">parameter tags</a>, <a href="#at">tag asset</a> dan <a href="#lot">tag lokalisasi</a>.
-</p>
-
-<a name="et"></a>
-<h3 id="1603">Tag Ekspresi</h3>
-<p id="190182" class="block-content">
-Tag ekspresi mewakili ekspresi PHP yang dievaluasi saat kontrol template dalam tahap <tt>PreRender</tt>. Hasil evaluasi ekspresi disisipkan di tempat di mana tag berada dalam template. Konteks (yaitu <tt>$this</tt>) dari ekspresi adalah kontrol yang memilik template.
-</p>
-<p id="190183" class="block-content">
-Format tag ekspresi adalah sebagai berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_190079">
-<%= PhpExpression %>
-</com:TTextHighlighter>
-<p id="190184" class="block-content">
-Sebagai contoh, tag ekspresi berikut akan menampilkan judul halaman saat ini di tempat,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_190080">
-<%= $this->Title %>
-</com:TTextHighlighter>
-
-<a name="st"></a>
-<h3 id="1604">Tag Pernyataan</h3>
-<p id="190185" class="block-content">
-Tag pernyataan mirip dengan tag ekspresi, kecuali bahwa tag pernyataan berisi pernyataan PHP daripada ekspresi. Output dari pernyataan PHP (menggunakan contoh <tt>echo</tt> atau <tt>print</tt> dalam PHP) ditampilkan di tempat di mana tag pernyataan berada dalam template. Konteks (yaitu <tt>$this</tt>) dari pernyataan adalah kontrol yang memiliki template. Format tag pernyataan adalah sebagai berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_190081">
-<%%
-Pernyataan PHP
-%>
-</com:TTextHighlighter>
-<p id="190186" class="block-content">
-Contoh berikut menampilkan waktu saat ini dalam bahasa Belanda di tempat,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_190082">
-<%%
-setlocale(LC_ALL, 'nl_NL');
-echo strftime("%A %e %B %Y",time());
-%>
-</com:TTextHighlighter>
-
-<a name="dt"></a>
-<h3 id="1605">Tag Databind</h3>
-<p id="190187" class="block-content">
-Tag databind mirip dengan tag ekspresi, kecuali bahwa ekspresi dievaluasi hanya ketika panggilan <tt>dataBind()</tt> diterapkan pada kontrol yang mewakili tag databind. Konteks (yaitu <tt>$this</tt>) dari ekspresi databind adalah kontrol yang memiliki template. Format tag databind adalah sebagai berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_190083">
-<%# PhpExpression %>
-</com:TTextHighlighter>
-
-<a name="pt"></a>
-<h3 id="1606">Tag Parameter</h3>
-<p id="190188" class="block-content">
-Tag parameter dipakai untuk menyisipkan parameter aplikasi di tempat di mana ia muncul dalam template. Format tag parameter adalah sebagai berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_190084">
-<%$ ParameterName %>
-</com:TTextHighlighter>
-<p id="190189" class="block-content">
-Catatan, parameter aplikasi biasanya didefinisikan konfigurasi aplikasi atau konfigurasi direktori halaman. Parameter dievaluasi saat template diberi contoh.
-</p>
-
-<a name="at"></a>
-<h3 id="1607">Tag Asset</h3>
-<p id="190190" class="block-content">
-Tag asset dipakai untuk mempublikasikan file pribadi dan menampilkan URL terkait. Sebagai contoh, jika Anda mempunyai file gambar yang tidak bisa diakses Web dan Anda ingin menjadikannya terlihat bagi pengguna-akhir, Anda dapat menggunakan tag asset untuk mempublikasikan file ini dan menampilkan URL ke pengguna-akhir agar mereka dapat mengambil gambar yang dipublikasikan.
-</p>
-<p id="190191" class="block-content">
-Format tag asset adalah sebagai berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_190085">
-<%~ LocalFileName %>
-</com:TTextHighlighter>
-<p id="190192" class="block-content">
-di mana <tt>LocalFileName</tt> merujuk ke path file yang relatif ke direktori yang berisi file template saat ini. Path file bisa berupa file tunggal atau sebuah direktori. Jika direktori, konten dalam seluruh direktori akan dibuat dapat diakses oleh pengguna-akhir.
-</p>
-<p id="190193" class="block-content">
-HARAP SANGAT BERHATI-HATI ketika Anda menggunakan tag asset karena ia dapat memperlihatkan ke pengguna-akhir file yang tidak ingin Anda perlihatkan kepada mereka.
-</p>
-
-<a name="lot"></a>
-<h3 id="1608">Tag Lokalisasi</h3>
-<p id="190194" class="block-content">
-Tag lokalisasi mewakili teks yang dilokalisasi. Formatnya adalah sebagai berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_190086">
-<%[string]%>
-</com:TTextHighlighter>
-<p id="190195" class="block-content">
-di mana <tt>string</tt> akan diterjemahkan ke bahasa berbeda tergantung pada preferensi bahasa pengguna-akhir. Tag lokalisasi sebenarnya adalah jalan pintas ke fungsi panggil <tt>Prado::localize(string)</tt>.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Configurations/id/Templates3.page b/demos/quickstart/protected/pages/Configurations/id/Templates3.page deleted file mode 100755 index e53d3384..00000000 --- a/demos/quickstart/protected/pages/Configurations/id/Templates3.page +++ /dev/null @@ -1,104 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="1701">Template: Bagian III</h1>
-
-<a name="dpt"></a>
-<h2 id="1702">Tag Properti Dinamis</h2>
-<p id="200196" class="block-content">
-Tag properti dinamis sangat mirip dengan tag konten dinamis, kecuali bahwa ia berlaku untuk properti komponen. Kegunaan tag properti dinamis adalah untuk membolehkan konfigurasi properti komponen lebih serba guna. Catatan, Anda tidak perlu memakai tag properti dinamis karena apa yang bisa dikerjakan oleh tag properti dinamis juga bisa dilakukan dalam kode PHP. Akan tetapi, menggunakan tag properti dinamis membawa Anda jauh lebih nyaman saat menyempurnakan tugas yang sama. Pemakaian dasar dari tag properti dinamis adalah sebagai berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_200087">
-<com:ComponentType PropertyName=DynamicPropertyTag ...>
-body content
-</com:ComponentType>
-</com:TTextHighlighter>
-<p id="200197" class="block-content">
-di mana Anda dapat mengurung <tt>DynamicPropertyTag</tt> di dalam tanda kutip tunggal atau dua agar pembacaannya lebih baik.
-</p>
-<p id="200198" class="block-content">
-Seperti tag konten dinamis, kami mempunyai <a href="#et">tag ekspresi</a>, <a href="#dt">tag databind</a>, <a href="#pt">tag parameter</a>, <a href="#at">tag asset</a> dan <a href="#lot">tag lokalisasi</a>. (Catatan, tidak ada tag pernyataan di sini.)
-</p>
-
-<a name="et"></a>
-<h3 id="1703">Tag Ekspresi</h3>
-<p id="200199" class="block-content">
-Tag ekspresi mewakili ekspresi PHP yang dievaluasi saat kontrol template dalam tahap <tt>PreRender</tt>. Hasil evaluasi ekspresi disisipkan di tempatkan ke properti komponen terkait. Format tag ekspresi adalah sebagai berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_200088">
-<%= PhpExpression %>
-</com:TTextHighlighter>
-<p id="200200" class="block-content">
-Dalam ekspresi, <tt>$this</tt> merujuk ke kontrol yang memiliki template. Contoh berikut menetapkan kontrol <tt>TLabel</tt> di mana properti <tt>Text</tt> diberi contoh seperti judul halaman saat ini saat kontrol <tt>TLabel</tt> sedang dibentuk,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_200089">
-<com:TLabel Text=<%= $this->Page->Title %> />
-</com:TTextHighlighter>
-
-<a name="dt"></a>
-<h3 id="1704">Tag Databind</h3>
-<p id="200201" class="block-content">
-Tag databind mirip dengan tag ekspresi, kecuali bahwa ekspresi dievaluasi hanya ketika panggilan <tt>dataBind()</tt> diterapkan pada kontrol yang mewakili tag databind. Konteks (yaitu <tt>$this</tt>) dari ekspresi databind adalah kontrol yang memiliki template. Tag databind tidak berlaku bagi seluruh komponen. Ia hanya digunakan untuk kontrol.
-</p>
-<p id="200202" class="block-content">
-Format tag databind adalah sebagai berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_200090">
-<%# PhpExpression %>
-</com:TTextHighlighter>
-<p id="200203" class="block-content">
-Sejak v3.0.2, tag ekspresi dan tag databind dapat direkatkan di dalam string statis. Sebagai contoh, Anda bisa menulis yang berikut dalam template,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_200091">
-<com:TLabel>
- <prop:Text>
- Today is <%= date('F d, Y',time()) %>.
- The page class is <%= get_class($this) %>.
- </prop:Text>
-</com:TLabel>
-</com:TTextHighlighter>
-<p id="200204" class="block-content">
-Sebelumnya, Anda harus menggunakan ekspresi tunggal dengan penggabungan string untuk mendapatkan efek yang sama.
-</p>
-
-<a name="pt"></a>
-<h3 id="1705">Tag Parameter</h3>
-<p id="200205" class="block-content">
-Tag parameter dipakai untuk menyisipkan parameter aplikasi di tempat di mana ia muncul dalam template. Format tag parameter adalah sebagai berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_200092">
-<%$ ParameterName %>
-</com:TTextHighlighter>
-<p id="200206" class="block-content">
-Catatan, parameter aplikasi biasanya didefinisikan konfigurasi aplikasi atau konfigurasi direktori halaman. Parameter dievaluasi saat template diberi contoh.
-</p>
-
-<a name="at"></a>
-<h3 id="1706">Tag Asset</h3>
-<p id="200207" class="block-content">
-Tag asset dipakai untuk mempublikasikan file pribadi dan menampilkan URL terkait. Sebagai contoh, jika Anda mempunyai file gambar yang tidak bisa diakses Web dan Anda ingin menjadikannya terlihat bagi pengguna-akhir, Anda dapat menggunakan tag asset untuk mempublikasikan file ini dan menampilkan URL ke pengguna-akhir agar mereka dapat mengambil gambar yang dipublikasikan. Tag asset dievaluasi ketika template diberi contoh.
-</p>
-<p id="200208" class="block-content">
-Format tag asset adalah sebagai berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_200093">
-<%~ LocalFileName %>
-</com:TTextHighlighter>
-<p id="200209" class="block-content">
-di mana <tt>LocalFileName</tt> merujuk ke path file yang relatif ke direktori yang berisi file template saat ini. Path file bisa berupa file tunggal atau sebuah direktori. Jika direktori, konten dalam seluruh direktori akan dibuat dapat diakses oleh pengguna-akhir.
-</p>
-<p id="200210" class="block-content">
-HARAP SANGAT BERHATI-HATI ketika Anda menggunakan tag asset karena ia dapat memperlihatkan ke pengguna-akhir file yang tidak ingin Anda perlihatkan kepada mereka.
-</p>
-
-<a name="lot"></a>
-<h3 id="1707">Tag Lokalisasi</h3>
-<p id="200211" class="block-content">
-Tag lokalisasi mewakili teks yang dilokalisir. Formatnya adalah sebagai berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_200094">
-<%[string]%>
-</com:TTextHighlighter>
-<p id="200212" class="block-content">
-di mana <tt>string</tt> akan diterjemahkan ke bahasa berbeda tergantung pada preferensi bahasa pengguna-akhir. Tag lokalisasi sebenarnya adalah jalan pintas ke fungsi panggil <tt>Prado::localize(string)</tt>.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Configurations/id/UrlMapping.page b/demos/quickstart/protected/pages/Configurations/id/UrlMapping.page deleted file mode 100755 index 46e7bdd4..00000000 --- a/demos/quickstart/protected/pages/Configurations/id/UrlMapping.page +++ /dev/null @@ -1,106 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="2101">Pemetaan URL (URL bersahabat)</h1>
-
-<com:DocLink ClassPath="System.Web.TUrlMapping" />
-
-<p id="230222" class="block-content">
-Modul TUrlMapping membolehkan PRADO membentuk dan mengenali URL bersahabat berdasarkan pada pola spesifik.
-</p>
-
-<p id="230223" class="block-content">
-TUrlMapping terdiri dari daftar pola URL yang dipakai untuk menyamakan terhadap URL yang saat ini sedang diminta. Pola pertama yang sama kemudian akan dipakai untuk mendekomposisi URL ke dalam parameter request (dapat diakses melalui
-<tt>$this->Request['paramname']</tt>). Pola juga dipakai untuk membentuk URL yang dikustomisasi. Dalam hal ini, parameter dalam pola yang diterapkan akan diganti dengan nilai variabel GET terkait.
-</p>
-
-<p id="230224" class="block-content">
-Untuk menggunakan <tt>TUrlMapping</tt>, seseorang harus menyetel properti <tt>UrlManager</tt> dari modul <tt>THttpRequest</tt> sebagai ID modul <tt>TUrlMapping</tt>. Lihat contoh berikut,
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_230098">
-<modules>
- <module id="request" class="THttpRequest" UrlManager="friendly-url" />
- <module id="friendly-url" class="System.Web.TUrlMapping">
- <url ServiceParameter="Posts.ViewPost" pattern="post/{id}/?" parameters.id="\d+" />
- <url ServiceParameter="Posts.ListPost" pattern="archive/{time}/?" parameters.time="\d{6}" />
- <url ServiceParameter="Posts.ListPost" pattern="category/{cat}/?" parameters.cat="\d+" />
- </module>
-</modules>
-</com:TTextHighlighter>
-</p>
-
-<p id="230225" class="block-content">
-Contoh di atas adalah bagian dari konfigurasi aplikasi dari demo <tt>blog</tt> dalam rilis PRADO. Ia menghidupkan pengakuan format URL berikut:
-</p>
-<ul id="u1" class="block-content">
- <li><tt>/index.php/post/123</tt> diakui sebagai <tt>/index.php?page=Posts.ViewPost&id=123</tt></li>
- <li><tt>/index.php/archive/200605</tt> diakui sebagai <tt>/index.php?page=Posts.ListPost&time=200605</tt></li>
- <li><tt>/index.php/category/2</tt> diakui sebagai <tt>/index.php?page=Posts.ListPost&cat=2</tt></li>
-</ul>
-
-<p id="230226" class="block-content">
-<tt>ServiceParameter</tt> dan <tt>ServiceID</tt> (ID standarnya adalah 'page') masing-masing menyetel parameter layanan dan ID layanan terhadap <a href="?page=Fundamentals.Modules">modul Request</a>. Parameter layanan untuk layanan <tt>TPageService</tt> adalah nama kelas Page, contohnya untuk URL "index.php?page=Home", "page" adalah ID layanan dan parameter layanan adalah "Home". Layanan lain dapat menggunakan parameter layanan dan ID secara berbeda. Lihat <a href="?page=Fundamentals.Services">Layanan</a> untuk lebih jelasnya.
-</p>
-
-<div class="info"><b class="tip">Info:</b>
-<tt>TUrlMapping</tt> harus dikonfigurasi sebelum
-<a href="?page=Fundamentals.Modules">modul Request</a> mengatasi permintaan.
-Ini biasanya berarti mendeklarasikan modul <tt>TUrlMapping</tt> sebelum tag
-<tt><services></tt> dalam <a href="?page=Configurations.AppConfig">konfigurasi aplikasi</a>.
-Menetapkan pemetaan dalam direktori <tt>config.xml</tt> tidak didukung.
-</div>
-
-<h2 id="46023">Menetapkan Pola URL</h2>
-<p id="230227" class="block-content">
-<tt>TUrlMapping</tt> menghidupkan pengakuan terhadap format URL yang dikustomisasi berdasarkan pada daftar pola URL yang ditetapkan sebelumnya. Setiap pola ditetapkan dalam tag <tt><url></tt>.
-</p>
-
-<p id="230228" class="block-content">
-Nilai atribut <tt>Pattern</tt> dan <tt>Parameters</tt> adalah pola ekspresi reguler yang menentukan kriteria pemetaan. Properti <tt>Pattern</tt> mengambil ekspresi reguler dengan nama parameter dikurung antara kurung kurawal kiri '<tt>{</tt>' dan kurung kurawal kanan '<tt>}</tt>'. Pola untuk setiap parameter dapat disetel menggunakan koleksi atribut <tt>Parameters</tt>.
-Sebagai contoh,
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_230099">
-<url ServiceParameter="ArticleView" pattern="articles/{year}/{month}/{day}"
- parameters.year="\d{4}" parameters.month="\d{2}" parameters.day="\d+" />
-</com:TTextHighlighter>
-</p>
-Contoh mirip dengan ekspresi reguler berikut (ia memakai fitur "named group" dalam ekspresi reguler yang tersedia dalam PHP):
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_230100">
-<url ServiceParmaeter="ArticleView">
- RegularExpression="/articles\/(?P<year>\d{4})\/(?P<month>\d{2})\/(?P<day>\d+)/u"</url>
-</com:TTextHighlighter>
-<p id="230229" class="block-content">
-Dalam contoh di atas, pola berisi 3 parameter bernama "<tt>year</tt>",
-"<tt>month</tt>" dan "<tt>day</tt>". Pola untuk parameter ini masing-masing adalah, "<tt>\d{4}</tt>" (4 digit), "<tt>\d{2}</tt>" (2 digit)
-dan "<tt>\d+</tt>" (1 atau lebih digit).
-Intinya, nama dan nilai atribut <tt>Parameters</tt> digunakan sebagai substrings dalam penggantian tempat pada string <tt>Pattern</tt> untuk membentuk string ekspresi reguler lengkap.
-</p>
-
-<div class="note"><b class="tip">Catatan:</b> Jika Anda bermaksud untuk menggunakan properti <tt>RegularExpression</tt> Anda perlu mengulang garis miring dalam ekspresi reguler.
-</div>
-
-<p id="230230" class="block-content">Berikut dari contoh pola di atas,
-sebuah URL "<tt>http://example.com/index.php/articles/2006/07/21</tt>" akan disamakan dan benar. Akan tetapi, "<tt>http://example.com/index.php/articles/2006/07/hello</tt>" tidak benar karena pola parameter "<tt>day</tt>" tidak memuaskan.
- Dalam kelas <tt>TUrlMappingPattern</tt> standarnya, pola disamakan dengan properti <b>path</b> dari hanya URL. Sebagai contoh, hanya bagian
-"<tt>/index.php/articles/2006/07/21</tt>" dari URL yang ditetapkan.
- </p>
-
-<p id="230231" class="block-content">
-URL permintaan yang dipetakan mirip dengan <tt>index.php?page=ArticleView&year=2006&month=07&day=21</tt>.
-Nilai parameter tersedia melalui obyek standar <tt>Request</tt>. Sebagai contoh, <tt>$this->Request['year']</tt>.
-</p>
-
-<p id="230232" class="block-content">Pemetaan URL dievaluasi agar ia ditempatkan dan hanya pemetaan pertama yang menyamai URL akan dipakai. Pemetaan beruntun dapat dicapat dengan menempatkan pemetaan URL dalam urutan tertentu. Sebagai contoh, menempatkan pemetaan paling spesifik terlebih dahulu.
-</p>
-
-<h2 id="46024">Membentuk URL Dikustomisasi</h2>
-<p id="230233" class="block-content">
-Sejak versi 3.1.1, <tt>TUrlMapping</tt> mulai mendukung pembentukan format URL terkustomisasi berdasarkan pola yang disediakan. Untuk menghidupkan fitur ini, setel <tt>TUrlMapping.EnableCustomUrl</tt> menjadi true. Saat <tt>THttpRequest.constrcutUrl()</tt> dipanggil, pembantukan kerja URL aktual akan didelegasikan ke turunan <tt>TUrlMappingPattern</tt> yang sama. Ia mengganti parameter dalam pola dengan variabel GET terkait dikirimkan ke <tt>constructUrl()</tt>.
-</p>
-
-<p id="230234" class="block-content">
-Pola yang sama adalah propreti <tt>ServiceID</tt> dan <tt>ServiceParameter</tt> yang sama seperti yang dikirimkan ke <tt>constructUrl()</tt> dan parameter yang diberi nama ditemukan dalam variabel GET. Sebagai contoh, <tt>constructUrl('Posts.ListPost',array('cat'=>2))</tt> akan menggunakan pola pihak ketiga dalam contoh di atas.
-<p>
-
-<p id="230235" class="block-content">
-Standarnya <tt>TUrlMapping</tt> akan membentuk URL yang diawali dengan yang saat ini meminta path naskah PHP, seperti <tt><b>/path/to/index.php</b>/article/3</tt>. Para pengguna dapat mengubah perilaku ini dengan menetapkan prefiks URL secara spesifik melalui properti <tt>UrlPrefix</tt>-nya. Sebagai contoh, jika konfigurasi server Web memperlakukan <tt>index.php</tt> sebagai naskah standar, kita bisa menyetel <tt>UrlPrefix</tt> sebagai <tt>/path/to</tt> dan URL yang dibentuk akan terlihat seperti <tt>/path/to/article/3</tt>.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/HtmlArea4.page b/demos/quickstart/protected/pages/Controls/HtmlArea4.page index 1fa33424..17c87e18 100755 --- a/demos/quickstart/protected/pages/Controls/HtmlArea4.page +++ b/demos/quickstart/protected/pages/Controls/HtmlArea4.page @@ -1,6 +1,6 @@ <com:TContent ID="body" > -<h1>THtmlArea4</h1> +<h1 id="86013">THtmlArea4</h1> <com:DocLink ClassPath="System.Web.UI.WebControls.THtmlArea4" /> <p class="block-content"> diff --git a/demos/quickstart/protected/pages/Controls/Markdown.page b/demos/quickstart/protected/pages/Controls/Markdown.page index d7cc00c6..0285ed32 100644 --- a/demos/quickstart/protected/pages/Controls/Markdown.page +++ b/demos/quickstart/protected/pages/Controls/Markdown.page @@ -1,6 +1,6 @@ <com:TContent ID="body" > -<h1>TMarkdown</h1> +<h1 id="108014">TMarkdown</h1> <com:DocLink ClassPath="System.Web.UI.WebControls.TMarkdown" /> <p class="block-content"> diff --git a/demos/quickstart/protected/pages/Controls/Samples/THyperLink/Home.page b/demos/quickstart/protected/pages/Controls/Samples/THyperLink/Home.page index 8d3f6853..901aa0f0 100755 --- a/demos/quickstart/protected/pages/Controls/Samples/THyperLink/Home.page +++ b/demos/quickstart/protected/pages/Controls/Samples/THyperLink/Home.page @@ -9,8 +9,8 @@ A regular hyperlink: </td><td class="sampleaction">
Welcome to
<com:THyperLink
- NavigateUrl="http://www.pradosoft.com/"
- Text="PradoSoft.com"
+ NavigateUrl="https://github.com/pradosoft/prado"
+ Text="Prado framework"
Target="_blank" />.
</td></tr>
@@ -19,8 +19,8 @@ A text hyperlink with css style: </td><td class="sampleaction">
Welcome to
<com:THyperLink
- NavigateUrl="http://www.pradosoft.com/"
- Text="PradoSoft.com"
+ NavigateUrl="https://github.com/pradosoft/prado"
+ Text="Prado framework"
Target="_blank"
BackColor="silver"
Font.Italic="true" />.
@@ -30,7 +30,7 @@ Welcome to An image hyperlink:
</td><td class="sampleaction">
<com:THyperLink
- NavigateUrl="http://www.pradosoft.com/"
+ NavigateUrl="https://github.com/pradosoft/prado"
ImageUrl=<%~hello_world.gif%>
Text="Hello World" />.
</td></tr>
@@ -39,7 +39,7 @@ An image hyperlink: A hyerplink with body contents as link text:
</td><td class="sampleaction">
<com:THyperLink
- NavigateUrl="http://www.pradosoft.com/"
+ NavigateUrl="https://github.com/pradosoft/prado"
Target="_blank">
Body contents
</com:THyperLink>
diff --git a/demos/quickstart/protected/pages/Controls/Samples/TImageMap/Home.page b/demos/quickstart/protected/pages/Controls/Samples/TImageMap/Home.page index 5e56aefd..99ba48aa 100755 --- a/demos/quickstart/protected/pages/Controls/Samples/TImageMap/Home.page +++ b/demos/quickstart/protected/pages/Controls/Samples/TImageMap/Home.page @@ -9,8 +9,8 @@ <com:TCircleHotSpot
HotspotMode="Navigate"
- NavigateUrl="http://www.pradosoft.com"
- AlternateText="Navigate to pradosoft.com"
+ NavigateUrl="https://github.com/pradosoft/prado"
+ AlternateText="Navigate to Prado framework project page"
Target="_blank"
X="80"
Y="80"
diff --git a/demos/quickstart/protected/pages/Controls/Samples/TInlineFrame/Home.page b/demos/quickstart/protected/pages/Controls/Samples/TInlineFrame/Home.page index eea7f1e3..853f6d6d 100755 --- a/demos/quickstart/protected/pages/Controls/Samples/TInlineFrame/Home.page +++ b/demos/quickstart/protected/pages/Controls/Samples/TInlineFrame/Home.page @@ -7,7 +7,7 @@ <tr><td class="samplenote">
Inline frame with default settings:
</td><td class="sampleaction">
-<com:TInlineFrame FrameUrl="http://www.pradosoft.com/" />
+<com:TInlineFrame FrameUrl="https://github.com/pradosoft/prado" />
</td></tr>
<tr><td class="samplenote">
@@ -17,7 +17,7 @@ Inline frame customized with margins and align: MarginWidth="100"
MarginHeight="100"
Align="Right"
- FrameUrl="http://www.pradosoft.com/" />
+ FrameUrl="https://github.com/pradosoft/prado" />
</td></tr>
<tr><td class="samplenote">
@@ -26,7 +26,7 @@ Inline frame without scrollbars and border: <com:TInlineFrame
ScrollBars="None"
ShowBorder="false"
- FrameUrl="http://www.pradosoft.com/" />
+ FrameUrl="https://github.com/pradosoft/prado" />
</td></tr>
</table>
diff --git a/demos/quickstart/protected/pages/Controls/id/Button.page b/demos/quickstart/protected/pages/Controls/id/Button.page deleted file mode 100755 index 942b607f..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Button.page +++ /dev/null @@ -1,16 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="2001">TButton</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TButton" />
-
-<p id="240234" class="block-content">
-<tt>TButton</tt> membuat tombol klik pada halaman Web. judul tombol ditetapkan dengan properti <tt>Text</tt>. Tombol digunakan untuk mengirimkan data ke sebuah halaman. <tt>TButton</tt> memunculkan dua event sisi-server, <tt>OnClick</tt> dan <tt>OnCommand</tt>, ketika diklik pada sisi-klien. Perbedaan diantara event <tt>OnClick</tt> dan <tt>OnCommand</tt> adalah bahwa event kedua meneruskan ke leluhur kontrol tombol. Pengendali event <tt>OnCommand</tt> bisa menggunakan <tt>CommandName</tt> dan <tt>CommandParameter</tt> terkait dengan event guna melakukan aksi spesifik.
-</p>
-<p id="240235" class="block-content">
-Mengklik tombol dapat memicu formulir validasi, jika <tt>CausesValidation</tt> adalah true. Dan validasi mungkin dibatasi di dalam grup tertentu dari kontrol validator menurut <tt>ValidationGroup</tt>.
-</p>
-<com:RunBar PagePath="Controls.Samples.TButton.Home" />
-
-UNTUK DIKERJAKAN: atribut kustom
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Captcha.page b/demos/quickstart/protected/pages/Controls/id/Captcha.page deleted file mode 100755 index 27ffb6dc..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Captcha.page +++ /dev/null @@ -1,43 +0,0 @@ -<com:TContent ID="body" >
-
-<h1>TCaptcha</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TCaptcha" />
-
-<p>
-<tt>TCaptcha</tt> menampilkan <a href="http://en.wikipedia.org/wiki/Captcha">CAPTCHA</a> yang bisa dipakai untuk menentukan apakah input dimasukan oleh pengguna asli ataukah beberapa program. <tt>TCaptcha</tt> menampilkan sebuah token (string terdiri dari karakter alfanumerik) sebagai sebuah gambar dan pengguna diharapkan untuk mengulang token dalam kotak teks. Gambar token dibuat dalam cara tertentu yang bisa dikenali oleh manusia, tapi tidak oleh sebuah program.
-</p>
-
-<p>
-Untuk menggunakan <tt>TCaptcha</tt>, anda hrus menghidupkan ekstensi PHP GD2 dengan dukungan font TrueType. Tidak seperti naskah CAPTCHA lain, <tt>TCaptcha</tt> tidak memerlukan sesi atau cookie.
-</p>
-
-<p>
-Token yang dibuat oleh <tt>TCaptcha</tt> dapat dikonfigurasi dalam beberapa cara. Untuk menetapkan panjang karakter dalam token, setel <tt>MinTokenLength</tt> dan <tt>MaxTokenLength</tt>. Untuk menggunakan perbandingan huruf tidak sensitif-huruf dan hanya membuat token huruf-besar, setel <tt>CaseSensitive</tt> ke false. Para pengguna tingkat lanjut dapat mencoba untuk menyetel <tt>TokenAlphabet</tt> guna menetapkan karakter mana yang akan muncul dalam token yang dibuatnya.
-</p>
-
-<p>
-Validasi token terkait dengan dua properti: <tt>TestLimit</tt> (standarnya 5 kali) dan <tt>TokenExpiry</tt> (standarnya 600 detik). Pembentuk menetapkan berapa kali token bisa diuji pada sisi-server, dan yang terakhir mengatakan kapan token yang dibuat akan berakhir. Jika validasi gagal dalam salah satu dari dua skenario, token baru akan secara otomatis dibuat.
-</p>
-
-<p>
-Untuk menetapkan tampilan dari gambar token yang dibuat, setel <tt>TokenImageTheme</tt> ke integer antara 0 dan 31. Ada bisa mencoba contoh berikut untuk melihat bagaimana nilai ini mempengaruhi gambar token yang dihasilkan. Ukuran gambar token ditentukan oleh <tt>TokenFontSize</tt>. Dalam keadaan tertentu, panjang gambar adalah proporsional bagi ukuran font. Anda juga bisa menyetel <tt>Width</tt> untuk mengubah gambar yang dihasilkan ke ukuran yang anda inginkan, gambar yang diskala mungkin tidak terlihat baik.
-</p>
-
-<p>
-Setelah postback, input pengguna dapat di validasi dengan memanggil metode <tt>TCaptcha.validate()</tt>. Jauh lebih mudah, anda dapat menggunakan <tt>TCaptchaValidator</tt> untuk mengotomasi pekerjaan validasi bagi anda. <tt>TCaptchaValidator</tt> mempunyai keuntungan tambahan dari kemampuan untuk memvalidasi input pengguna pada sisi-klien. Standarnya, token yang dihasilkan akan tetap tidak berubah selama postbacks. Token baru dapat dibuat dengan memanggil <tt>TCaptcha.regenerateToken()</tt> secara manual.
-</p>
-
-<p>
-Template berikut memperlihatkan penggunaan umum dari kontrol <tt>TCaptcha</tt>:
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TCaptcha ID="Captcha" />
-<com:TTextBox ID="Input" />
-<com:TCaptchaValidator CaptchaControl="Captcha"
- ControlToValidate="Input"
- ErrorMessage="You are challenged!" />
-</com:TTextHighlighter>
-
-<com:RunBar PagePath="Controls.Samples.TCaptcha.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/CheckBox.page b/demos/quickstart/protected/pages/Controls/id/CheckBox.page deleted file mode 100755 index cc6976a1..00000000 --- a/demos/quickstart/protected/pages/Controls/id/CheckBox.page +++ /dev/null @@ -1,14 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="2101">TCheckBox</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TCheckBox" />
-
-<p id="250236" class="block-content">
-<tt>TCheckBox</tt> menampilkan kotak centang pada halaman Web. Judul bisa ditetapkan melalui <tt>Text</tt> dan ditampilkan disamping kotak centang. Ia bisa muncul baik di sisi kanan atau kiri kotak centang, yang ditentukan oleh <tt>TextAlign</tt>. Selanjutnya anda dapat menetapkan atribut yang diterapkan ke teks dengan menggunakan <tt>LabelAttributes</tt>.
-</p>
-<p id="250237" class="block-content">
-Untuk menentukan apakah kotak centang dicentang atau tidak, uji properti <tt>Checked</tt>. Event <tt>CheckedChanged</tt> dimunculkan jika kondisi <tt>Checked</tt> berubah diantara pengiriman ke server. Jika <tt>AutoPostBack</tt> adalah true, mengubah kotak centang akan menyebabkan aksi postback. Dan jika <tt>CausesValidation</tt> juga true, setelah postback validasi akan dilakukan bagi validator di dalam <tt>ValidationGroup</tt> yang ditetapkan.
-</p>
-<com:RunBar PagePath="Controls.Samples.TCheckBox.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/ClientScript.page b/demos/quickstart/protected/pages/Controls/id/ClientScript.page deleted file mode 100755 index 2142e65a..00000000 --- a/demos/quickstart/protected/pages/Controls/id/ClientScript.page +++ /dev/null @@ -1,42 +0,0 @@ -<com:TContent ID="body" > - -<h1 id="2201">TClientScript</h1> -<com:DocLink ClassPath="System.Web.UI.WebControls.TClientScript" /> -<h2 id="2202">Menyertakan Bundel Librari Javascript dalam Prado</h2> -<p id="260238" class="block-content"> -<tt>TClientScript</tt> membolehkan kode Javascript disisipkan atau di-link ke template halaman. PRADO dibundel dengan fungsionalitas librari besar Javascript termasuk efek, AJAX, pengendali event dasar, dan masih banyak lagi. Librari Javascript yang dibundel bisa di-link ke template halaman saat ini menggunakan properti <tt>PradoScripts</tt>. Multipel librari Javascript yang dibundel bisa ditetapkan menggunakan string nama librari Javascript dipisahkan koma untuk disertakan pada halaman. Contoh berikut akan menggunakan librari "ajax" dan "effects". -</p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_260101"> -<com:TClientScript PradoScripts="ajax, effects" /> -</com:TTextHighlighter> - -<p id="260239" class="block-content"> - Bundel librari yang disertakan dalam Prado adalah</p> - <ul id="u1" class="block-content"> - <li><tt>prado</tt> : kerangka kerja javascript prado dasar berdasarkan Prototype</li> - <li><tt>effects</tt> : efek visual dari script.aculo.us</li> - <li><tt>ajax</tt> : terkait ajax dan callback berdasarkan Prototype</li> - <li><tt>validator</tt> : validasi</li> - <li><tt>logger</tt> : javascript pencatat dan browser obyek</li> - <li><tt>datepicker</tt> : datepicker</li> - <li><tt>colorpicker</tt> : colorpicker</li> - </ul> -<p id="260240" class="block-content"> -Banyak dari librari, seperti <tt>validator</tt> dan <tt>datepicker</tt> akan secara otomatis ketika kontrol yang menggunakan librari ini terlihat pada halaman. Sebagai contoh, semua <a href="?page=Controls.Validation">validator</a> -jika <tt>EnableClientScript</tt> disetel true akan menyertakan librari javascript <tt>prado</tt> dan <tt>validator</tt>. -Ketergantungan dari setiap librari secara otomatis dipecahkan. Yakni, menetapkan, katakanlah "ajax", juga akan menyertakan librari "prado".</p> - -<h2 id="2203">Menyertakan File Javascript Kustom</h2> -<p id="260241" class="block-content">File Javascript kustom dapat diregistrasi menggunakan properti <tt>ScriptUrl</tt>. Contoh berikut menyertakan file Javascript "test.js" ke halaman. Dalam hal ini, file "test.js" relatif ke template saat ini yang sedang anda gunakan. Karena nilai properti adalah -<a href="?page=Configurations.Templates3">tag asset dinamis</a>, file "test.js" akan dipublikasikan secara otomatis, yaitu file akan di-copy ke direktori asset bila perlu. -</p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_260102"> -<com:TClientScript ScriptUrl=<%~ test.js %> /> -</com:TTextHighlighter> -<p id="260242" class="block-content">You can include Javascript files from other servers by specifying the full URL string in - the <tt>ScriptUrl</tt> property.</p> - -<h2 id="2204">Menyertakan Blok Kode Javascript Kustom</h2> -<p id="260243" class="block-content"> Setiap konten di dalam tag kontrol <tt>TClientScript</tt> akan dianggap sebagai kode Javascript dan akan disajikan di mana ia dideklarasikan.</p> - -</com:TContent> diff --git a/demos/quickstart/protected/pages/Controls/id/ColorPicker.page b/demos/quickstart/protected/pages/Controls/id/ColorPicker.page deleted file mode 100755 index bac8a96e..00000000 --- a/demos/quickstart/protected/pages/Controls/id/ColorPicker.page +++ /dev/null @@ -1,10 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="2201">TColorPicker</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TColorPicker" />
-
-<p id="270244" class="block-content">
-TBD
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Conditional.page b/demos/quickstart/protected/pages/Controls/id/Conditional.page deleted file mode 100755 index e17ba4cd..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Conditional.page +++ /dev/null @@ -1,36 +0,0 @@ -<com:TContent ID="body" >
-
-<h1>TConditional</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TConditional" />
-
-<p class="block-content">
-<tt>TConditional</tt> menampilkan konten terkai berdasarkan hasil evaluasi ekspresi PHP yang ditetapkan via <tt>Kondisi</tt>.
-Jika hasil adalah true, ia menurunkan template <tt>TrueTemplate</tt>;
-sebaliknua, template <tt>FalseTemplate</tt> yang diturunkan.
-Ekspresi PHP dievaluasi sebelum tahap <tt>onInit</tt> atas masa hidup kontrol.
-</p>
-
-<p class="block-content">
-Karena <tt>TConditional</tt> mengevaluasi <tt>Kondisi</tt> di tahap awal, direkomendasikan anda menyetel <tt>Condition</tt> hanya dalam template dan ekspresi tidak boleh merujuk ke obyek yang tersedia nanti atau setelah masa hidup <tt>onInit</tt>.
-</p>
-
-<p>
-<tt>TConditional</tt> sangat ringan. Ia menurunkan <tt>TrueTemplate</tt>
-<tt>FalseTemplate</tt>, tapi tidak keduanya sekaligus. Dan kondisi dievaluasi hanya sekali.
-Penggunaan umum dari TConditional diperlihatkan seperti berikut:
-</p>
-
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TConditional Condition="$this->User->IsGuest">
- <prop:TrueTemplate>
- <a href="path/to/login">Login</a>
- </prop:TrueTemplate>
- <prop:FalseTemplate>
- <a href="path/to/logout">Logout</a>
- </prop:FalseTemplate>
-</com:TConditional>
-</com:TTextHighlighter>
-
-<com:RunBar PagePath="Controls.Samples.TConditional.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Data.page b/demos/quickstart/protected/pages/Controls/id/Data.page deleted file mode 100755 index 8516880a..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Data.page +++ /dev/null @@ -1,19 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5001">Kontrol Data</h1>
-
-<ul id="u1" class="block-content">
- <li>
- <a href="?page=Controls.DataList">TDataList</a> dipakai untuk menampilkan atau memodifikasi daftar dari item data.
- </li>
-
- <li>
- <a href="?page=Controls.DataGrid">TDataGrid</a> menampilkan data dalam format tabel dengan baris serta kolom.
- </li>
-
- <li>
- <a href="?page=Controls.Repeater">TRepeater</a> menampilkan kontennya yang didefinisikan dalam template secara berulang berdasarkan pada data yang berikan.
- </li>
-</ul>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/DataGrid.page b/demos/quickstart/protected/pages/Controls/id/DataGrid.page deleted file mode 100755 index 419fa552..00000000 --- a/demos/quickstart/protected/pages/Controls/id/DataGrid.page +++ /dev/null @@ -1,185 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5201">TDataGrid</h1>
-
-<p id="590373" class="block-content">
-TDatagrid adalah kontrol penting dalam membangun aplikasi Web yang kompleks. Ia menampilkan data dalam format tabular dengan baris (juga disebut item) dan kolom. Baris dibuat dengan sel, sementara kolom mengatur bagaimana sel harus ditampilkan berdasarkan kaitannya dengan kolom. Data yang ditetapkan melalui <tt>DataSource</tt> atau <tt>DataSourceID</tt> terikat pada baris dan mengisi kontek ke sel.
-</p>
-<p id="590374" class="block-content">
-TDataGrid sangat interaktif. Para pengguna dapat mengurut data sepanjang kolom yang ditetapkan, mengendalikannya melalui halaman data yang berbeda, dan melakukan aksi, seperti mengedit dan menghapus, pada baris data.
-</p>
-<p id="590375" class="block-content">
-Baris TDataGrid dapat diakses melalui properti <tt>Items</tt>. Baris (item) bisa berupa salah satu dari beberapa mode: browse, mengedit dab memilih, yang mempengaruhi bagaimana sel dalam bariis ditampilkan. Untuk mengubah mode item, modifikasi <tt>EditItemIndex</tt> atau <tt>SelectedItemIndex</tt>. Catatan, jika item dalam mode edit, maka memilih item ini tidak terpengaruh.
-</p>
-
-<h2 id="5202">Kolom</h2>
-<p id="590376" class="block-content">
-Kolom pada data grid menentukan bagaimana sel terkait ditampilkan. Sebagai contoh, sel yang dikaitkan dengan <tt>TBoundColumn</tt> ditampilkan secara berbeda tergantung dari modenya. Sebuah sel ditampilkan sebagai teks statis jika sel dalam mode browse, kotak teks jika dalam mode edit, dan seterusnya.
-</p>
-<p id="590377" class="block-content">
-PRADO menyediakan lima tipe kolom:
-</p>
-<ul id="u1" class="block-content">
- <li><tt>TBoundColumn</tt> menghubungkan sel dengan field data dan menampilkan sel berdasarkan modenya.</li>
- <li><tt>TLiteralColumn</tt> menghubungkan sel dengan field data spesifik dan menampilkan sel dengan teks statis.</li>
- <li><tt>TCheckBoxColumn</tt> menghubungkan sel dengan field data spesifik dan menampilkan kotak centang dalam setiap sel yang kondisi centangnya ditentukan oleh nilai field data.</li>
- <li><tt>TDropDownListColumn</tt> menghubungkan sel dengan field data spesifik dan menampilkan sel berdasarkan modenya. Jika dalam mode edit, sel akan ditampilkan dengan <tt>TDropDownList</tt>.</li>
- <li><tt>THyperLinkColumn</tt> menampilkan hiperlink dalam sel yang URL dan judulnya bisa berupa secara statis ditetapkan atau terikat ke beberapa field data.</li>
- <li><tt>TEditCommandColumn</tt> menampilkan tombol perintah edit/update/cancel dalam sel untuk menyatakan item yang berada di dalamnya.</li>
- <li><tt>TButtonColumn</tt> menampilkan tombol perintah dalam sel.</li>
- <li><tt>TTemplateColumn</tt> menampilkan sel berdasarkan pada template berbeda yang didefinisikan untuknya.</li>
-</ul>
-
-<h2 id="5203">Gaya Item</h2>
-<p id="590378" class="block-content">
-TDataGrid mendefinisikan gaya yang diterapkan pada itemnya. Sebagai contoh, <tt>AlternatingItemStyle</tt> diterapkan untuk mengganti item (item 2, 4, 6, dll.) Melalui properti ini, seseorang dapat menyetel field gaya CSS atau kelas CSS untuk item-item tersebut.
-</p>
-<p id="590379" class="block-content">
-Gaya item diterapkan dalam cara hirarkis. Gaya dalam hirarki lebih tinggi akan diturunkan dari gaya dalam hirarki lebih rendah. Mulai dari hirarki terendah, gaya item termasuk gaya item itu sendiri, <tt>ItemStyle</tt>, <tt>AlternatingItemStyle</tt>, <tt>SelectedItemStyle</tt>, dan <tt>EditItemStyle</tt>. Oleh karena itu, jika warna latar belakang disetel merah dalam <tt>ItemStyle</tt>, <tt>EditItemStyle</tt> juga akan memiliki warna latar belakang merah, kecuali dinyatakan secara eksplisit ke nilai yang berbeda.
-</p>
-
-<h2 id="5204">Event</h2>
-<p id="590380" class="block-content">
-TDataGrid menyediakan beberapa event untuk menjembatani manipulasi item datanya,
-</p>
-<ul id="u2" class="block-content">
- <li><tt>OnItemCreated</tt> - muncul setiap kali item baru saja dibuat. Ketika event muncul, data dan kontrol anak keduanya tersedia bagi item baru.</li>
- <li><tt>OnItemDataBound</tt> - muncul setiap kali item selesai menyatukan data. Ketika event muncul, data dan kontrol anak keduanya tersedia untuk item, dan item telah selesai menyatukan data dari dirinya sendiri dan seluruh kontrol anaknya.</li>
- <li><tt>OnItemCommand</tt> - muncul ketika kontrol anak pada beberapa item (seperti <tt>TButton</tt>) memunculkan event <tt>OnCommand</tt>.</li>
- <li>command events - muncul saat event kontrol anak <tt>OnCommand</tt> mempunyai nama perintah spesifik,
- <ul>
- <li><tt>OnSelectedIndexChanged</tt> - jika nama perintah adalah <tt>select</tt>.</li>
- <li><tt>OnEditCommand</tt> - jika nama perintah adalah <tt>edit</tt>.</li>
- <li><tt>OnDeleteCommand</tt> - jika nama perintah adalah <tt>delete</tt>.</li>
- <li><tt>OnUpdateCommand</tt> - jika nama perintah adalah <tt>update</tt>.</li>
- <li><tt>OnCancelCommand</tt> - jika nama perintah adalah <tt>cancel</tt>.</li>
- <li><tt>OnSortCommand</tt> - jika nama perintah adalah <tt>sort</tt>.</li>
- <li><tt>OnPageIndexChanged</tt> - jika nama perintah adalah <tt>page</tt>.</li>
- </ul>
- </li>
-</ul>
-
-<h2 id="5205">Menggunakan TDataGrid</h2>
-
-<h3 id="5210">Kolom yang Dibuat Secara Otomatis</h3>
-<p id="590381" class="block-content">
-TDataGrid standarnya akan membuat sebuah daftar kolom berdasarkan struktur data terikat. TDataGrid akan membaca baris pertama data, menguraikan nama field dari baris, dan mengkonstruksi kolom untuks setiap field. Setiap field adalah tipe <tt>TBoundColumn</tt>.
-</p>
-<p id="590382" class="block-content">
-Contoh berikut menampilkan daftar informasi produk komputer menggunakan TDataGrid. Kolom secara otomatis dibuat. Perhatikan bagaimana gaya item ditetapkan dan diturunkan. Data dipopulasi ke dalam datagrid menggunakan kode berikut yang umum diantara kebanyakan aplikasi datagrid,
-</p>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_590121">
-public function onLoad($param) {
- parent::onLoad($param);
- if(!$this->IsPostBack) {
- $this->DataGrid->DataSource=$this->Data;
- $this->DataGrid->dataBind();
- }
-}
-</com:TTextHighlighter>
-<com:RunBar PagePath="Controls.Samples.TDataGrid.Sample1" />
-
-<h3 id="5211">Kolom Ditetapkan secara Manual</h3>
-<p id="590383" class="block-content">
-Menggunakan kolom yang dibuat secara otomatis memberikan cara cepat melihat data tabular. Dalam aplikasi sebenarnya, kolom yang dibuat secara otomatis sering tidak mencukupi karena para pengembang tidak memiliki cara mengkustomisasi penampilannya. Kolom yang dibuat secara manual jauh lebih diinginkan.
-</p>
-<p id="590384" class="block-content">
-Untuk menetapkan kolom secara manual, setel <tt>AutoGenerateColumns</tt> ke false, dan tetapkan kolom dalam template seperti berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_590122">
-<com:TDataGrid ...>
- <com:TBoundColumn DataField="name" .../>
- <com:TBoundColumn DataField="price" .../>
- <com:TEditCommandColumn ...>
- ...
-</com:TDataGrid>
-</com:TTextHighlighter>
-<p id="590385" class="block-content">
-Catatan, jika <tt>AutoGenerateColumns</tt> adalah true dan di sana ditetapkan kolom secara manual, kolom yang dibuat secara otomatis akan diterapkan ke kolom yang ditetapkan secara manual. Catat juga, properti <tt>Columns</tt> datagrid hanya berisi kolom yang ditetapkan secara manual dan bukan yang secara otomatis dibuat.
-</p>
-<p id="590386" class="block-content">
-Contoh berikut menggunakan kolom yang ditetapkan secara manual untuk memperlihatkan daftar informasi buku,
-</p>
-<ul id="u4" class="block-content">
- <li>Book title - ditampilkan sebagai hiperlink mengarah ke halaman buku amazon.com terkait. <tt>THyperLinkColumn</tt> dipakai.</li>
- <li>Publisher - ditampilkan sebagai bagian teks menggunakan <tt>TBoundColumn</tt>.</li>
- <li>Price - ditampilkan sebagai bagian teks menggunakan <tt>TBoundColumn</tt> dengan output berformat string dan gaya dikustomisasi.</li>
- <li>In-stock or not - ditampilkan sebagai kotak centang menggunakan <tt>TCheckBoxColumn</tt>.</li>
- <li>Rating - ditampilkan sebagai gambar menggunakan <tt>TTemplateColumn</tt> yang membolehkan kebebasan maksimum dalam menetapkan konten sel.</li>
-</ul>
-<p id="590387" class="block-content">Perhatikan bagaimana gaya item (baris) dan kolom bekerja sama untuk mempengaruhi penampilan sel dalam datagrid.</p>
-<com:RunBar PagePath="Controls.Samples.TDataGrid.Sample2" />
-
-
-<h2 id="5206">Berinteraksi dengan TDataGrid</h2>
-<p id="590388" class="block-content">
-Selain kaya fungsionalitas penyajian data seperti didemonstrasikan dalam bagian sebelumnya, TDataGrid juga sangat interaktif bagi pengguna. Pemakaian impor TDataGrid adalah mengedit atau menghapus baris data. <tt>TBoundColumn</tt> dapat menyesuaikan penyajian sel terkait berdasarkan mode item datagrid. Ketika item dalam mode browse, sel ditampilkan dengan teks statis; ketika item ditampilkan dalam mode edit, kotak teks ditampilkan untuk menampung input pengguna. TDataGrid menyediakan <tt>TEditCommandColumn</tt> untuk mengalihkan mode item. Sebagai tambahan, <tt>TButtonColumn</tt> menawarkan kepada para pengembang fleksibilitas dari pembuatan tombol bebas untuk berbagai interaksi pengguna.
-</p>
-<p id="590389" class="block-content">
-Contoh berikut memperlihatkan bagaimana untuk membuat tabel informasi buku sebelumnya menjadi interaktif. Ia membolehkan pengguna untuk mengedit dan menghapus item buku dari tabel. Dua kolom tambahan dipakai dalam contoh untuk membolehkan interaksi para penggunak dengan datagrid: <tt>TEditCommandColumn</tt> dan <tt>TButtonColumn</tt>. Sebagai tambahan,
-<tt>TDropDownListColumn</tt> mengganti <tt>TTemplateColumn</tt> sebelumnya untuk membolehkan pengguna memilih peringkat dari daftar dropdown. Catatan, Ini juga memungkinkan untuk menggunakan <tt>TTemplateColumn</tt> guna menyelesaikan tugas yang sama.
-</p>
-<com:RunBar PagePath="Controls.Samples.TDataGrid.Sample3" />
-
-<h2 id="5207">Pengurutan</h2>
-<p id="590390" class="block-content">
-TDataGrid mendukung pengurutan itemnya yang terkait dengan kolom tertentu. Untuk menghidupkan pengurutan, setel <tt>AllowSorting</tt> ke true. Ini akan mengubah header kolom menjadi tombol yang bisa diklik jika properti <tt>SortExpression</tt> tidak kosong. Ketika para pengguna mengklik pada tombol header, event <tt>OnSortCommand</tt> akan dimunculkan. Para pengembang dapat menulis pengendali guna merespon perintah pengurutan dan mengurut data berdasarkan <tt>SortExpression</tt> yang ditetapkan dalam kolom terkait.
-</p>
-<p id="590391" class="block-content">
-Contoh berikut mengubah datagrid dalam <a href="?page=Controls.Samples.TDataGrid.Sample2">Contoh 2</a> menjadi yang bisa diurutkan. Para pengguna dapat mengklik pada tombol link yang ditampilkan dalam setiap kolom, dan data akan diurut dalam urutan membesar sepanjang kolom tersebut.
-</p>
-<com:RunBar PagePath="Controls.Samples.TDataGrid.Sample4" />
-
-<h2 id="5208">Lembaran</h2>
-<p id="590392" class="block-content">
-Ketika berhadapan dengan dataset besar, lembaran sangat membantu dalam mengurangi ukuran halaman dan kompleksitasnya. TDataGrid disertai lembaran yang membolehkan para pengguna menetapkan di halaman mana data ingin mereka lihat. Lembaran bisa dikustomisasi melalui <tt>PagerStyle</tt>. Sebagai contoh, <tt>PagerStyle.Visible</tt> menentukan apakah lembaran terlihat atau tidak; <tt>PagerStyle.Position</tt> menunjukan di mana lembaran ditampilkan; dan <tt>PagerStyle.Mode</tt> menetapkan tipe lembaran apa yang ditampilkan, numerik atau kata berikutnya-sebelumnya.
-</p>
-<p id="590393" class="block-content">
-Untuk menghidupkan lembaran, setel <tt>AllowPaging</tt> ke true. Jumlah baris data yang ditampilkan dalam halaman ditetapkan oleh <tt>PageSize</tt>, sementara indeks (berbasis-nol) pada halaman yang saat ini terlihat bagi para pengguna adalah dengan <tt>CurrentPageIndex</tt>. Ketika para pengguna mengklik pada tombol lembar, TDataGrid memunculkan event <tt>OnPageIndexChanged</tt>. Biasanya, pengendali event ditulis seperti berikut,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_590123">
-public function pageIndexChanged($sender,$param) {
- $this->DataGrid->CurrentPageIndex=$param->NewPageIndex;
- $this->DataGrid->DataSource=$this->Data;
- $this->DataGrid->dataBind();
-}
-</com:TTextHighlighter>
-<p id="590394" class="block-content">
-Contoh berikut menghidupkan fungsionalitas lembar dari datagrid yang ditampilkan dalam <a href="?page=Controls.Samples.TDataGrid.Sample1">Contoh 1</a>. Dalam contoh ini, anda dapat menyetel berbagai gaya lembar secara interaktif untuk melihat bagaimana pengaruh tampilan lembar halaman.
-</p>
-<com:RunBar PagePath="Controls.Samples.TDataGrid.Sample5" />
-
-<h3 id="5212">Lembar Kustom</h3>
-<p id="590395" class="block-content">
-Fungsionalitas lembar halaman yang ditampilkan di atas memerlukan pengambilan seluruh data ke dalam memori, meskipun hanya sebagian darinya ditampilkan dalam sebuah halaman. Untuk dataset besar, ini tidak efisien dan mungkin tidak selalu layak. TDataGrid menyediakan lembar kustom untuk memecahkan masalah ini. Lembar kustom hanya memerlukan sebagian data untuk ditampilkan kepada pengguna akhir.
-</p>
-<p id="590396" class="block-content">
-Untuk menghidupkan lembat kustom, setel <tt>AllowPaging</tt> dan <tt>AllowCustomPaging</tt> ke true. Beritahu TDataGrid jumlah item data (baris) yang tersedia dengan menyetel <tt>VirtualItemCount</tt>. Dan merespon ke event <tt>OnPageIndexChanged</tt>. Dalam pengendali event, gunakan properti <tt>NewPageIndex</tt> atas parameter event untuk megnambil lembar baru data dari sumber data. Untuk MySQL database, ini bisa dikerjakan dengan menggunakan klausul <tt>LIMIT</tt> dalam pernyataan SQL select.
-</p>
-<com:RunBar PagePath="Controls.Samples.TDataGrid.Sample6" />
-
-<h2 id="5209">Memperluas TDataGrid</h2>
-<p id="590397" class="block-content">
-Selain turunan kelas tradisional, kemampuan diperluas TDataGrid dikembangkan terutama melalui komponen kolom datagrid. Sebagai contoh, seseorang mungkin ingin menampilkan sebuah kolom bergambar. Dia dapat menggunakan <tt>TTemplateColumn</tt> untuk menyelesaikan tugas ini. Solusi yang lebih baik adalah mengembangkan komponen kolom gambar pekerjaan tersebut bisa dipakai ulang dengan mudah dalam proyek lain.
-</p>
-<p id="590398" class="block-content">
-Semua komponen kolom datagrid harus diturunkan dari <tt>TDataGridColumn</tt>. Metode utama yang perlu diganti adalah <tt>initializeCell()</tt> yang membuat konten untuk sel dalam kolom terkait. Karena setiap sel juga dalam sebuah item (baris) dan item dapat memiliki tipe berbeda (seperti <tt>Header</tt>, <tt>AltneratingItem</tt>, dll.), konten berbeda bisa dibuat berdasarkan tipe item. Untuk contoh kolom gambar, seseorang dapat membuat kontrol <tt>TImage</tt> di dalam sel dalam item dari tipe <tt>Item</tt> dan <tt>AlterantingItem</tt>.
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_590124">
-class ImageColumn extends TDataGridColumn {
- ...
- public function initializeCell($cell,$columnIndex,$itemType) {
- parent::initializeCell($cell,$columnIndex,$itemType);
- if($itemType==='Item' || $itemType==='AlternatingItem') {
- $image=new TImage;
- // ... kustomisasi gambar
- $cell->Controls[]=$image;
- }
- }
-}
-</com:TTextHighlighter>
-<p id="590399" class="block-content">
-Dalam <tt>initializeCell()</tt>, jangan lupa untuk memanggil implementasi leluhur, karena ia menginisialisasi sel dalam item dari tipe <tt>Header</tt> dan <tt>Footer</tt>.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/DataList.page b/demos/quickstart/protected/pages/Controls/id/DataList.page deleted file mode 100755 index 517be66f..00000000 --- a/demos/quickstart/protected/pages/Controls/id/DataList.page +++ /dev/null @@ -1,113 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5101">TDataList</h1>
-<p id="580362" class="block-content">
-TDataList mewakili ikatan data dan kontrol list yang bisa dimutakhirkan. Seperti <tt>TRepeater</tt>, TDataList menampilkan kontennya secara berulang berdasarkan data yang diambil dari <tt>DataSource</tt>. Kontek yang diulang dalam TDataList disebut item, yang adalah kontrol dan bisa diakses melalui <tt>Items</tt>. Ketika <tt>dataBind()</tt> dipanggil, TDataList membuat sebuah item untuk setiap baris data dan mengikat baris data ke item. Secara opsional, TDataList dapat mempunyai header, footer dan/atau pemisah antara item.
-</p>
-
-<p id="580363" class="block-content">
-TDataList berbeda dari TRepeater yakni memperkenalkan konsep kondisi item dan membolehkan menerapkan gaya berbeda ke item dalam kondisi berbeda. Sebagai tambahan, TDataList mendukung pengotakan item berulang dalam berbagai cara.
-</p>
-
-<p id="580364" class="block-content">
-Tata letak dari konten yang diulang dalam TDataList ditetapkan dengan template inline. Item TDataList, header, footer, dll. diturunkan dengan template terkait saat data sedang diikat ke pengulang.
-</p>
-
-<p id="580365" class="block-content">
-Sejak v3.1.0, tata letak juga dapat berupa penyaji. Penyaji adalah kelas kontrol yang dapat diturunkan sebagai item datalist, header, dll. Penyaji dapat dilihat sebagai template eksternal (sebenarnya, ia juga merupakan kontrol tanpa-template). Untuk lebih jelasnya, lihat penjelasan mengenai penyaji dalam <a href="?page=Controls.Repeater">Tutorial TRepeater</a>.
-</p>
-
-<p id="580366" class="block-content">
-Properti berikut dipakai untuk menetapkan tipe template dan penyaji datalist. Jika tipe konten didefinisikan dengan template dan penyaji, maka penyaji diambil lebih dulu.
-</p>
-
-<ul id="u5" class="block-content">
-<li><tt>ItemTemplate</tt>, <tt>ItemRenderer</tt>: untuk setiap baris data yang diulang</li>
-<li><tt>AlternatingItemTemplate</tt>, <tt>AlternatingItemRenderer</tt>: untuk setiap pergantian baris data. Jika tidak disetel, <tt>ItemTemplate</tt> atau <tt>ItemRenderer</tt> yang akan dipakai.</li>
-<li><tt>HeaderTemplate</tt>, <tt>HeaderRenderer</tt>: untuk header datalist.</li>
-<li><tt>FooterTemplate</tt>, <tt>FooterRenderer</tt>: untuk footer datalist.</li>
-<li><tt>SeparatorTemplate</tt>, <tt>SeparatorRenderer</tt>: untuk konten yang ditampilkan diantara item.</li>
-<li><tt>EmptyTemplate</tt>, <tt>EmptyRenderer</tt>: dipakai saat data yang terikat ke datalist kosong.</li>
-<li><tt>EditItemTemplate</tt>, <tt>EditItemRenderer</tt>: untuk baris yang sedang diedit.</li>
-<li><tt>SelectedItemTemplate</tt>, <tt>SelectedItemRenderer</tt>: untuk baris yang sedang dipilih.</li>
-</ul>
-
-<p id="580367" class="block-content">
-Ketika <tt>dataBind()</tt> dipanggil, TDataList menjalani masa hidup seperti berikut untuk setiap baris data:
-</p>
-
-<ol id="u6" class="block-content">
-<li>buat item berdasarkan template atau penyaji</li>
-<li>setel baris data ke item</li>
-<li>munculkan event <tt>OnItemCreated</tt></li>
-<li>tambah item sebagai kontrol anak</li>
-<li>panggil <tt>dataBind()</tt> pada item</li>
-<li>munculkan event <tt>OnItemDataBound</tt></li>
-</ol>
-
-<p id="580368" class="block-content">
-TDataList memunculkan <tt>OnItemCommand</tt> kapan saja kontrol tombol di dalam beberapa item datalist memunculkan event <tt>OnCommand</tt>. Oleh karena itu, anda bisa menangani semua event <tt>OnCommand</tt> di satu tempat dengan menulis pengendali event untuk event <tt>OnItemCommand</tt>. Event tambahan dimunculkan jika event <tt>OnCommand</tt> memiliki salah satu dari nama perintah berikut (tidak sensitif-huruf):
-</p>
-
-<ul id="u7" class="block-content">
-<li><tt>edit</tt> - pengguna ingin mengedit item. Event <tt>OnEditCommand</tt> akan dimunculkan.</li>
-<li><tt>update</tt> - pengguna ingin menyimpan perubahan terhadap item. Event <tt>OnUpdateCommand</tt> akan dimunculkan.</li>
-<li><tt>select</tt> - pengguna memilih item. Event <tt>OnSelectedIndexChanged</tt> akan dimunculkan.</li>
-<li><tt>delete</tt> - pengguna menghapus item. Event <tt>OnDeleteCommand</tt> akan dimunculkan.</li>
-<li><tt>cancel</tt> - pengguna membatalkan aksi pengeditan sebelumnya. Event <tt>OnCancelCommand</tt> akan dimunculkan.</li>
-</ul>
-
-<p id="580369" class="block-content">
-TDataList menyediakan beberapa properti untuk mendukung pengotakan item. Jumlah kolom yang digunakan untuk menampilkan item data dietapkan melalui properti <tt>RepeatColumns</tt>, sementara <tt>RepeatDirection</tt> mengatur urutan item yang sedang disajikan. Tata letak item data dalam daftar ditetapkan melalui <tt>RepeatLayout</tt>, yang mengambil salah satu dari nilai berikut:
-</p>
-
-<ul id="u8" class="block-content">
-<li><tt>Table</tt> (default) - item diatur menggunakan tabel HTML dan sel. Ketika menggunakan tata letak ini, seseorang dapat menyetel <tt>CellPadding</tt> dan <tt>CellSpacing</tt> untuk menyesuaikan cellpadding dan cellspacing pada tabel, dan <tt>Caption</tt> serta <tt>CaptionAlign</tt> untuk menambahkan judul tabel dengan penjajaran yang ditetapkan.</li>
-<li><tt>Flow</tt> - item diatur menggunakan span dan break HTML.</li>
-<li><tt>Raw</tt> - TDataList tidak membuat tag HTML apapun untuk melakukan kotak-kotak.</li>
-</ul>
-
-<p id="580370" class="block-content">
-Item dalam TDataList dapat berupa salah satu dari tiga keadaan: sedang dilihat, sedang diedit dan sedang dipilih. Untuk mengubah keadaan item tertentu, setel <tt>SelectedItemIndex</tt> atau <tt>EditItemIndex</tt>. Former akan mengubah item yang ditunjuk ke mode yang dipilih, yang akan menyebabkan item menggunakan <tt>SelectedItemTemplate</tt> atau <tt>SelectedItemRenderer</tt> dalam penyajiannya. Yang terakhir akan mengubah item yang ditunjuk ke mode edit dan menggunakan template atau penyaji terkait. Catatan, jika sebuah item dalam mode edit, maka memilih item ini tidak akan berpengaruh.
-</p>
-
-<p id="580371" class="block-content">
-Gaya berbeda dapat diterapkan ke item dalam status yang berbeda. Gaya aplikasi dilakukan dalam cara hirarkis: Gaya dalam hirarki lebih tinggi akan diturunkan dari hirarki lebih rendah. Dimulai dari hirarki paling rendah, gaya item termasuk:
-</p>
-
-<ul id="u9" class="block-content">
-<li>gaya item sendiri</li>
-<li><tt>ItemStyle</tt></li>
-<li><tt>AlternatingItemStyle</tt></li>
-<li><tt>SelectedItemStyle</tt></li>
-<li><tt>EditItemStyle</tt></li>
-</ul>
-
-<p id="580372" class="block-content">
-Oleh karena itu, jika warna latar belakang disetel sebagai merah dalam <tt>ItemStyle</tt>, <tt>EditItemStyle</tt> juga akan mempunyai warna latar belakang merah keciali ia disetel ke nilai berbeda secara eksplisit.
-</p>
-
-<p id="580373" class="block-content">
-Ketika halaman yang berisi datalist adalah post back, datalist akan mengembalikan secara otomatis seluruh kontennya, termasuk item, header, footer dan pemisah. Akan tetapi, baris data terkait dengan setiap item tidak akan ditemukan kembali dan menjadi null. Untuk mengakses data, gunakan salah satu cara berikut:
-</p>
-
-<ul id="u10" class="block-content">
-<li>Gunakan <tt>DataKeys</tt> untuk memperoleh kunci data terkait dengan item pengulang (repeater) yang ditetapkan dan gunakan kunci untuk mengambil data terkait dari beberapa penyimpanan persisten seperti misalnya DB. </li>
-<li>Simpan seluruh dataset dalam kondisi tampilan, yang akan mengembalikan dataset secara otomatis setelah postback. Bagaimanapun juga, harap berhati-hati jika ukuran dataset anda besar, ukuran halaman akan menjadi besar. Beberapa data kompleks mungkin juga mempunyai masalah serialisasi jika disimpan dalam kondisi tampilan.</li>
-</ul>
-<p id="580374" class="block-content">
-Contoh berikut memperlihatkan bagaimana menggunakan TDataList guna menampilkan data tabular, dengan tata letak dan gaya yang berbeda.
-</p>
-<com:RunBar PagePath="Controls.Samples.TDataList.Sample1" />
-<p id="580375" class="block-content">
-Pemakaian umum dari TDataList adalah untuk memanipulasi data tabular, termasuk melihat, mengedit, meghapus item data. Ini dihidupkan dengan event perintah dan berbagai template item pada TDataList.
-</p>
-<p id="580376" class="block-content">
-Contoh berikut menampilkan informasi produk komputer. Para pengguna dapat menambah produk baru, memodifikasi atau menghapus produk yang sudah ada. Agar bisa mencari item data untuk pemutakhiran atau penghapusan, properti <tt>DataKeys</tt> yang digunakan.
-</p>
-<p id="580377" class="block-content">
-Harap berhati-hati, untuk kemudahan, aplikasi ini tidak melakukan validasi input apapun. Dalam aplikasi sebenarnya, pastikan input divalidasi sebelum menyimpannya ke dalam database.
-</p>
-<com:RunBar PagePath="Controls.Samples.TDataList.Sample2" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/DatePicker.page b/demos/quickstart/protected/pages/Controls/id/DatePicker.page deleted file mode 100755 index abf980f2..00000000 --- a/demos/quickstart/protected/pages/Controls/id/DatePicker.page +++ /dev/null @@ -1,64 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="2301">TDatePicker</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TDatePicker" />
-
-<p id="280245" class="block-content"><tt>TDatePicker</tt> menampilkan kotak teks untuk keperluan input tanggal.
-Ketika kotak teks menerima fokus, kalender akan muncul dan pengguna dapat mengambil tanggal darinya yang akan secara otomatis dimasukan ke dalam kotak teks. Format tanggal string yang ditampilkan dalam kotak teks ditentukan oleh properti <tt>DateFormat</tt>. Format yang benar adalah kombinasi dari token berikut:
-
-<com:TTextHighlighter Language="text" CssClass="source block-content" id="code_280103">
-Karakter Pola Format (en-US)
----------------------------------------------------------------------
- d digit hari
- dd digit hari diisi misalnya 01, 02
- M digit bulan
- MM digit bulan diisi
- MMM singkatan nama bulan yang dilokalisasi, misalnya Mar, Apr
- MMMM nama bulan yang dilokalisasi, misalnya March, April
- yy 2 digit tahun
- yyyy 4 digit tahun
----------------------------------------------------------------------
-</com:TTextHighlighter>
-
-<p id="280246" class="block-content">
-Tanggal pada pengambil tanggal bisa disetel menggunakan properti <tt>Date</tt> atau <tt>Timestamp</tt>. Nilai properti <tt>Date</tt> harus dalam format yang sama seperti pola yang ditetapkan dalam properti <tt>DateFormat</tt>. Properti <tt>Timestamp</tt> hanya menerima integer seperti cap waktu Unix.
-</p>
-
-<p id="280247" class="block-content">
-TDatePicker mempunyai tiga <tt>Mode</tt> untuk menampilkan tampilan pengambil tanggal.</p>
- <ul id="u1" class="block-content">
- <li><tt>Basic</tt> - Hanya menampilkan input teks, memfokuskan pada input menampilkan pengambil tanggal.</li>
- <li><tt>Button</tt> - Menampilkan tombol disebelah input teks, mengklik pada tombol tampilkan tanggal, teks tombol dapat diubah dengan properti <tt>ButtonText</tt>.</li>
- <li><tt>ImageButton</tt> - Menampilkan gambar di sebelah input teks, mengklik pada gambar pengambil tanggal, sumber gambar bisa diubah melalui properti <tt>ImageUrl</tt>.</li>
- </ul>
-
-<p id="280248" class="block-content">Properti <tt>CssClass</tt> dapat dipakai untuk mengganti nama kelas CSS untuk panel pengambil tanggal. Properti <tt>CalendarStyle</tt> mengubah gaya kalender secara keseluruhan.
-Nilai <tt>CalendarStyle</tt> berikut tersedia:</p>
- <ul id="u2" class="block-content">
- <li><tt>default</tt> - gaya standar kalender.</li>
- </ul>
-
-<p id="280249" class="block-content">Properti <tt>InputMode</tt> bisa disetel ke "TextBox" atau "DropDownList" dengan standar sebagai "TextBox". Dalam mode <tt>DropDownList</tt>, sebagai tambahan pada tampilan pengambil tanggal, tiga daftar drop down (hari, bulan dan tahun) disajikan untuk memilih tanggal.
-Ketika <tt>InputMode</tt> sama dengan "DropDownList", urutan dan penampilan tanggal, bulan, dan tahun akan bergantung pada pola yang ditetapkan dalam properti <tt>DateFormat</tt>.
-</p>
-
-<p id="280250" class="block-content">Tampilan pengambil tanggal dapat disembunyikan dengan menetapkan <tt>ShowCalendar</tt> ke false. Banyak teks pada tampilan pengambil tanggal dapat diubah ke bahasa berbeda menggunakan properti <tt>Culture</tt>.
-</p>
-
-<p id="280251" class="block-content">Batas tahun pengambil kalender dapat disetel menggunakan properti <tt>FromYear</tt> dan <tt>UpToYear</tt> di mana
-<tt>FromYear</tt> adalah tahun awal dan <tt>UpToYear</tt> adalah tahun terakhir yang dapat dipilih.
-Awal hari pada seminggu bisa diubah dengan properti <tt>FirstDayOfWeek</tt>, dengan 0 sebagai Minggu, 1 sebagai Senin, dst.
-</p>
-
-<p id="280252" class="block-content"><b>Catatan 1:</b> Jika <tt>InputMode</tt> adalah "TextBox", <tt>DateFormat</tt> <b>TIDAK</b> boleh berisi pola <code>MMM</code> atau <code>MMMM</code>. Pengurai sisi-server tidak akan bisa menentukan tanggal yang benar jika <code>MMM</code> atau <code>MMMM</code> dipakai. Ketika <tt>InputMode</tt> sama dengan "DropDownList", seluruh pola dapat dipergunakan.</p>
-
-<p id="280253" class="block-content"><b>Catatan 2:</b> Ketika <tt>TDatePicker</tt> dipakai bersama dengan validator, properti <tt>DateFormat</tt> pada validator harus sama dengan
-<tt>DateFormat</tt> pada <tt>TDatePicker</tt> <b>DAN</b> harus disetel <tt>DataType</tt>="Date" pada validator guna memastikan validasi yang benar. Lihat
-<a href="?page=Controls.Validation#TCompareValidator">TCompareValidator</a>,
-<a href="?page=Controls.Validation#TDataTypeValidator">TDataTypeValidator</a> dan
-<a href="?page=Controls.Validation#TRangeValidator">TRangeValidator</a>
-untuk lebih jelasnya.</p>
-
-<com:RunBar PagePath="Controls.Samples.TDatePicker.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Expression.page b/demos/quickstart/protected/pages/Controls/id/Expression.page deleted file mode 100755 index ff19aa91..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Expression.page +++ /dev/null @@ -1,23 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="2401">TExpression</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TExpression" />
-
-<p id="290254" class="block-content">
-<tt>TExpression</tt> mengevaluasi ekspresi PHP dan menampilkan hasil evaluasinya. Untuk menetapkan ekspresi yang akan dievaluasi, setel properti <tt>Expression</tt>. Catatan, <tt>TExpression</tt> mengevaluasi ekspresi selama menyajikan masa hidup kontrol.
-</p>
-
-<p id="290255" class="block-content">
-Konteks dari ekspresi dalam kontrol <tt>TExpression</tt> adalah kontrol itu sendiri. Yaitu, <tt>$this</tt> mewakili obyek kontrol jika ia ada dalam ekspresi. Sebagai contoh, tag template akan menampilkan judul halaman yang berisi kontrol <tt>TExpression</tt>.
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_290104">
-<com:TExpression Expression="$this->Page->Title" />
-</com:TTextHighlighter>
-
-<p id="290256" class="block-content">
-Harap berhati-hati karena <tt>TExpression</tt> membolehkan eksekusi kode bebas PHP, secara umum anda seharusnya tidak menggunakannya untuk mengevaluasi ekspresi yang dikirimkan oleh para pengguna aplikasi anda.
-</p>
-
-<com:RunBar PagePath="Controls.Samples.TExpression.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/FileUpload.page b/demos/quickstart/protected/pages/Controls/id/FileUpload.page deleted file mode 100755 index 53c62489..00000000 --- a/demos/quickstart/protected/pages/Controls/id/FileUpload.page +++ /dev/null @@ -1,27 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="2501">TFileUpload</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TFileUpload" />
-
-<p id="300257" class="block-content">
-<tt>TFileUpload</tt> menampilkan field file upload pada halaman Web. Setelah postback, teks yang dimasukan ke dalam field akan diperlkakukan sebagai nama (lokal) file yang di-upload ke server.
-</p>
-<p id="300258" class="block-content">
-<tt>TFileUpload</tt> memunculkan event <tt>OnFileUpload</tt> ketika ia adalah post back. Properti <tt>HasFile</tt> menunjukan apakah file yang di-upload sukses atau tidak. Jika sukses, file yang di-upload dapat disimpan pada server dengan memanggil metode <tt>saveAs()</tt>.
-</p>
-<p id="300259" class="block-content">
-Properti berikut memberikan informasi mengenai file yang di-upload:
-</p>
-<ul id="u1" class="block-content">
- <li><tt>FileName</tt> - nama file asal pada sisi-klien tanpa direktori.</li>
- <li><tt>FileType</tt> - tipe MIME dari file yang di-upload.</li>
- <li><tt>FileSize</tt> - ukuran file dalam byte.</li>
- <li><tt>LocalName</tt> - path file absolut dari file yang di-upload ke server. Catatan, file ini akan dihapus setelah permintaan halaman saat ini selesai. Panggil <tt>saveAs()</tt> untuk menyimpan file yang di-upload.</li>
-</ul>
-<p id="300260" class="block-content">
-Jika upload file tidak berhasil, properti <tt>ErrorCode</tt> memberikan kode kesalahan yang menyebabkan kegagalan. Lihat <a href="http://www.php.net/manual/en/features.file-upload.errors.php">dokumentasi PHP</a> untuk penjelasan lengkap atas kode kesalahan yang mungkin.
-</p>
-
-<com:RunBar PagePath="Controls.Samples.TFileUpload.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Head.page b/demos/quickstart/protected/pages/Controls/id/Head.page deleted file mode 100755 index 89d62544..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Head.page +++ /dev/null @@ -1,10 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="2601">THead</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.THead" />
-
-<p id="310261" class="block-content">
-TBD
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/HiddenField.page b/demos/quickstart/protected/pages/Controls/id/HiddenField.page deleted file mode 100755 index 97a14dda..00000000 --- a/demos/quickstart/protected/pages/Controls/id/HiddenField.page +++ /dev/null @@ -1,13 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="2701">THiddenField</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.THiddenField" />
-
-<p id="320262" class="block-content">
-<tt>THiddenField</tt> mewakili field tersembyni pada halaman Web. Nilai field tersembunyi dapat diakses melalui properti <tt>Value</tt>.
-</p>
-<p id="320263" class="block-content">
-<tt>THiddenField</tt> memunculkan event <tt>OnValueChanged</tt> jika nilainya diubah selama postback.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/HtmlArea.page b/demos/quickstart/protected/pages/Controls/id/HtmlArea.page deleted file mode 100755 index 5a6c4c5c..00000000 --- a/demos/quickstart/protected/pages/Controls/id/HtmlArea.page +++ /dev/null @@ -1,48 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="2801">THtmlArea</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.THtmlArea" />
-
-<p id="330264" class="block-content">
-<tt>THtmlArea</tt> menampilkan field input teks WYSIWYG pada halaman Web untuk mengumpulkan input dalam format HTML. Teks yang ditampilkan dalam kontrol <tt>THtmlArea</tt> ditetapkan atau ditentukan dengan menggunakan properti <tt>Text</tt>. Untuk menyesuaikan ukuran bagian input, setel properti <tt>Width</tt> dan <tt>Height</tt> daripada <tt>Columns</tt> dan <tt>Rows</tt> karena keduanya tidak memiliki arti di bawah situasi ini. Untuk mematikan fitur WYSIWYG, setel <tt>EnableVisualEdit</tt> ke false.
-</p>
-
-<p id="330265" class="block-content">
-<tt>THtmlArea</tt> menyediakan fitur WYSIWYG dengan melapisi fungsionalitas yang disediakan oleh <a href="http://tinymce.moxiecode.com/">Proyek TinyMCE</a>.
-</p>
-
-<p id="330266" class="block-content">
-Editor standar hanya memberikan bar piranti dasar. Untuk mengubah atau menambah bar piranti lainnya, gunakan properti <tt>Options</tt> guna menambah opsi editor tambahan dengan setiap opsi pada baris baru. Lihat <a href="http://tinymce.moxiecode.com/tinymce/docs/index.html">TinyMCE website</a> untuk daftar opsi lebih lengkap. Contoh berikut menampilkan bar piranti spesifik untuk memanipulasi tabel HTML,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_330105">
-<com:THtmlArea>
- <prop:Options>
- plugins : "table"
- theme_advanced_buttons3 : "tablecontrols"
- </prop:Options>
-</com:THtmlArea>
-</com:TTextHighlighter>
-
-<p id="330267" class="block-content">
-Kemampuan mengedit secara visual sisi-klien didukung oleh Internet Explorer 5.0+ untuk Windows dan browser berbasis-Gecko. Jika browser tidak mendukung mengedit secara visual visual, area teks tradisional yang akan ditampilkan.
-</p>
-
-<pre>
- Windows XP MacOS X 10.4
-----------------------------------------------------
-MSIE 6 OK
-MSIE 5.5 SP2 OK
-MSIE 5.0 OK
-Mozilla 1.7.x OK OK
-Firefox 1.0.x OK OK
-Firefox 1.5b2 OK OK
-Safari 2.0 (412) OK(1)
-Opera 9 Preview 1 OK(1) OK(1)
-----------------------------------------------------
-(1) - sebagian bekerja
-----------------------------------------------------
-</pre>
-
-<com:RunBar PagePath="Controls.Samples.THtmlArea.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/HyperLink.page b/demos/quickstart/protected/pages/Controls/id/HyperLink.page deleted file mode 100755 index 431a0e98..00000000 --- a/demos/quickstart/protected/pages/Controls/id/HyperLink.page +++ /dev/null @@ -1,11 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="2901">THyperLink</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.THyperLink" />
-
-<p id="340268" class="block-content">
-<tt>THyperLink</tt> menampilkan hiperlink pada halaman. URL hiperlink ditetapkan melalui properti <tt>NavigateUrl</tt>, dan teks link melalui properti <tt>Text</tt>. Target link ditetapkan melalui properti <tt>Target</tt>. Memungkinkan juga untuk menampilkan sebuah gambar dengan menyetel properti <tt>ImageUrl</tt>. Dalam hal ini, <tt>Text</tt> ditampilkan sebagai teks alternatif dari gambar. Jika <tt>ImageUrl</tt> dan <tt>Text</tt> keduanya kosong, konten ditutupi di dalam tag kontrol akan disajikan.
-</p>
-<com:RunBar PagePath="Controls.Samples.THyperLink.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Image.page b/demos/quickstart/protected/pages/Controls/id/Image.page deleted file mode 100755 index 4c811700..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Image.page +++ /dev/null @@ -1,11 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="3201">TImage</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TImage" />
-
-<p id="370273" class="block-content">
-<tt>TImage</tt> menampilkan gambar pada halaman. Gambar ditetapkan melalui properti <tt>ImageUrl</tt> yang mengambil URL absolut terhadap file gambar. Penjajaran gambar yang ditampilkan disetel oleh properti <tt>ImageAlign</tt>. Untuk menyetel teks alternatif atau penjelasan panjang atas gambar, gunakan masing-masing <tt>AlternateText</tt> atau <tt>DescriptionUrl</tt>.
-</p>
-<com:RunBar PagePath="Controls.Samples.TImage.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/ImageButton.page b/demos/quickstart/protected/pages/Controls/id/ImageButton.page deleted file mode 100755 index 2dbf05ad..00000000 --- a/demos/quickstart/protected/pages/Controls/id/ImageButton.page +++ /dev/null @@ -1,11 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="3001">TImageButton</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TImageButton" />
-
-<p id="350269" class="block-content">
-<tt>TImageButton</tt> juga mirip dengan <tt>TButton</tt>, kecuali bahwa <tt>TImageButton</tt> menampilkan tombol sebagai sebuah gambar. Gambar ditetapkan melalui <tt>ImageUrl</tt>, dan teks alternatif ditetapkan oleh <tt>Text</tt>. Sebagai tambahan, dimungkinkan untuk mendapatkan informasi koordinat titik di mana gambar diklik. Informasi koordinat yang diisikan dalam parameter event <tt>OnClick</tt> (bukan <tt>OnCommand</tt>).
-</p>
-<com:RunBar PagePath="Controls.Samples.TImageButton.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/ImageMap.page b/demos/quickstart/protected/pages/Controls/id/ImageMap.page deleted file mode 100755 index aa719459..00000000 --- a/demos/quickstart/protected/pages/Controls/id/ImageMap.page +++ /dev/null @@ -1,25 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="3101">TImageMap</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TImageMap" />
-
-<p id="360270" class="block-content">
-<tt>TImageMap</tt> Mewakili sebuah gambar pada halaman Web dengan bagian titik panas (hotspot) predefinisi yang dapat merespon secara berbeda saat pengguna mengkliknya. Tergantung pada <tt>HotSpotMode</tt> dari bagian hotspot, mengklik pada hotspot akan memicu postback atau mengendalikan URL yang ditetapkan.
-</p>
-<p id="360271" class="block-content">
-Setiap hotspot dijelaskan menggunakan obyek <tt>THotSpot</tt> dan dipelihara dalam koleksi <tt>HotSpots</tt> pada <tt>TImageMap</tt>. Sebuah hotspot dapat berupa lingkaran, persegi panjangn, poligon, dll.
-</p>
-<p id="360272" class="block-content">
-Hotspot dapat ditambahkan ke <tt>TImageMap</tt> melalui properti <tt>HotSpots</tt> atau dalam template seperti berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_360106">
-<com:TImageMap ... >
- <com:TCircleHotSpot ... />
- <com:TRectangleHotSpot ... />
- <com:TPolygonHotSpot ... />
-</com:TImageMap>
-</com:TTextHighlighter>
-
-<com:RunBar PagePath="Controls.Samples.TImageMap.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/InlineFrame.page b/demos/quickstart/protected/pages/Controls/id/InlineFrame.page deleted file mode 100755 index 05ca12bb..00000000 --- a/demos/quickstart/protected/pages/Controls/id/InlineFrame.page +++ /dev/null @@ -1,24 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="3301">TInlineFrame</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TInlineFrame" />
-
-<p id="380274" class="block-content">
-<tt>TInlineFrame</tt> menampilkan sebuah bingkai inline (<iframe>) pada halaman Web. Lokasi konten bingkai ditetapkan oleh properti <tt>FrameUrl</tt>.
-</p>
-<p id="380275" class="block-content">
-Penampilan <tt>TInlineFrame</tt> dapat dikustomisai dengan properti berikut, sebagai tambahan terhadap apa yang diturunkan dari <tt>TWebControl</tt>.
-</p>
-<ul id="u1" class="block-content">
- <li><tt>Align</tt> - penjajaran pada bingkai.</li>
- <li><tt>DescriptionUrl</tt> - URI dari penjelasan panjang pada konten bingkai.</li>
- <li><tt>MarginWidth</tt> dan <tt>MarginHeight</tt> - jumlah pixel masing-masing untuk digunakan sebagai batas kiri/kanan dan atas/bawah..</li>
- <li><tt>ScrollBars</tt> - apakah scrollbar disediakan untuk bingkai inline. Standarnya adalah <tt>Auto</tt>, berarti scroll bar muncul bila diperlukan. Menyetelnya sebagai <tt>None</tt> atau <tt>Both</tt> untuk secara eksplisit to menyembunyikan atau menampilkan scroll bars.</li>
-</ul>
-
-<p id="380276" class="block-content">
-Contoh berikut memperlihatkan <tt>TInlineFrame</tt> dengan setelan properti berbeda. Google homepage dipakai sebagai konten bingkai.
-</p>
-<com:RunBar PagePath="Controls.Samples.TInlineFrame.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/JavascriptLogger.page b/demos/quickstart/protected/pages/Controls/id/JavascriptLogger.page deleted file mode 100755 index d68bd537..00000000 --- a/demos/quickstart/protected/pages/Controls/id/JavascriptLogger.page +++ /dev/null @@ -1,31 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="3401">TJavascriptLogger</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TJavascriptLogger" />
-
-<p id="390277" class="block-content">
-<tt>TJavascriptLogger</tt> menyediakan javascript pencatatan sisi-klien. Ini sebagian besar adalah pelapis dari Javascript yang dikembangkan di <a href="http://web.archive.org/web/20060512041505/gleepglop.com/javascripts/logger/">http://gleepglop.com/javascripts/logger/</a>.
-</p>
-
-<p id="390278" class="block-content">
-Untuk menggunakan <tt>TJavascriptLogger</tt>, cukup tempatkan tag komponen berikut pada template halaman.
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_390107">
-<com:TJavascriptLogger />
-</com:TTextHighlighter>
-
-<p id="390279" class="block-content">
-Kemudian, Javascript sisi-klien dapat berisi pernyataan berikut. Ketika dieksekusi akan muncul dalam jendela pencatat.
-</p>
-<com:TTextHighlighter Language="js" CssClass="source block-content" id="code_390108">
-Logger.info('something happend');
-Logger.warn('A warning');
-Logger.error('This is an error');
-Logger.debug('debug information');
-</com:TTextHighlighter>
-
-<p id="390280" class="block-content">
-Untuk menghidup matikan penampakan pencatat dan konsol pada jendela browser, tekan ALT-D (atau CTRL-D pada OS X).
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Keyboard.page b/demos/quickstart/protected/pages/Controls/id/Keyboard.page deleted file mode 100755 index 6f26a871..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Keyboard.page +++ /dev/null @@ -1,29 +0,0 @@ -<com:TContent ID="body" >
-
-<h1>TKeyboard</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TKeyboard" />
-
-<p>
-<tt>TKeyboard</tt> menampilkan keyboard virtual yang dapat diklik pengguna untuk memasukan input dalam kotak teks terkait. Ini membantu mengurangi hacking perekaman.
-</p>
-
-<p>
-Untuk menggunakan TKeyboard, tulis template seperti berikut:
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source">
-<com:TTextBox ID="PasswordInput" />
-<com:TKeyboard ForControl="PasswordInput" />
-</com:TTextHighlighter>
-
-<p>
-Kontrol TKeyboard dikaitkan dengan kontrol <tt>TTextBox</tt> dengan menetapkan
-<tt>ForControl</tt> menjadi ID dari kontrol tersebut. Ketika kotak teks dalam fokus, keyboard virtual akan muncull dan ketika kotak teks kehilangan fokus, keyboard akan sembunyi secara otomatis. Setel <tt>AutoHide</tt> ke false untuk membiarkan keyboard tetap tampil.
-</p>
-
-<p>
-Penampilan keyboard juga bisa diubah dengan menetapkan file CSS terkustomisasi melalui <tt>CssUrl</tt>. Standarnya nama kelas CSS untuk keyboard adalah 'Keyboard'. Ini juga bisa diubah dengan menetapkan <tt>KeyboardCssClass</tt>
-</p>
-
-<com:RunBar PagePath="Controls.Samples.TKeyboard.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Label.page b/demos/quickstart/protected/pages/Controls/id/Label.page deleted file mode 100755 index 45663510..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Label.page +++ /dev/null @@ -1,11 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="3501">TLabel</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TLabel" />
-
-<p id="400281" class="block-content">
-<tt>TLabel</tt> menampilkan teks pada halaman Web. Teks yang ditampilkan disetel melalui properti <tt>Text</tt>. Jika <tt>Text</tt> kosong, konten yang ditutupi dalam tag komponen <tt>TLabel</tt> akan ditampilkan. <tt>TLabel</tt> juga dapat dipakai sebagai label formulir yang terkait dengan beberapa kontrol pada formulir. Karena <tt>Text</tt> bukan HTML-dikodekan ketika disajikan, pastikan ia tidak berisi karakter berbahaya yang ingin anda hindari.
-</p>
-<com:RunBar PagePath="Controls.Samples.TLabel.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/LinkButton.page b/demos/quickstart/protected/pages/Controls/id/LinkButton.page deleted file mode 100755 index 666efbd4..00000000 --- a/demos/quickstart/protected/pages/Controls/id/LinkButton.page +++ /dev/null @@ -1,11 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="3601">TLinkButton</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TLinkButton" />
-
-<p id="410282" class="block-content">
-<tt>TLinkButton</tt> mirip dengan <tt>TButton</tt> dalam setiap aspek kecuali bahwa <tt>TLinkButton</tt> ditampilkan sebagai hiperlink. Teks link ditentukan oleh properti <tt>Text</tt>. Jika properti <tt>Text</tt> kosong, maka konten tombol yang ditampilkan (oleh karenanya, anda bisa menutupi tag <img> di dalam badan tombol dan mendapatkan tombol gambar.
-</p>
-<com:RunBar PagePath="Controls.Samples.TLinkButton.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/List.page b/demos/quickstart/protected/pages/Controls/id/List.page deleted file mode 100755 index 558c0d2c..00000000 --- a/demos/quickstart/protected/pages/Controls/id/List.page +++ /dev/null @@ -1,99 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="4801">Kontrol Daftar</h1>
-<p id="550329" class="block-content">
-Kontrol Daftar yang tercakup pada seksi ini semuanya diturunkan secara langsung atau tidak langsung dari <tt>TListControl</tt>. Oleh karena itu akan berbagi set properti yang sama dan umum dipakai, termasuk,
-</p>
-<ul id="u1" class="block-content">
-<li><tt>Items</tt> - daftar item dalam kontrol. Item adalah tipe <tt>TListItem</tt>. Daftar item bisa dipopulasikan melalui penyatuan data atau ditetapkan dalam template seperti berikut:
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_550115">
-<com:TListBox>
- <com:TListItem Text="text 1" Value="value 1" />
- <com:TListItem Text="text 2" Value="value 2" Selected="true" />
- <com:TListItem Text="text 3" Value="value 3" />
-</com:TListBox>
-</com:TTextHighlighter>
-</li>
-<li><tt>SelectedIndex</tt> - indeks berbasis-nol pada item yang dipilih dalam daftar item.</li>
-<li><tt>SelectedIndices</tt> - indeks dari semua item yang dipilih.</li>
-<li><tt>SelectedItem</tt> - item yang pertama dipilih dalam daftar item.</li>
-<li><tt>SelectedValue</tt> - nilai dari item pertama yang dipilih dalam daftar item.</li>
-<li><tt>AutoPostBack</tt> - apakah perubahan pilihan pada kontrol memicu postback atau tidak.</li>
-<li><tt>CausesValidation</tt> - apakah validasi harus dilakukan saat postback dipicu oleh kontrol daftar.</li>
-</ul>
-
-<p id="550330" class="block-content">
-Karena <tt>TListControl</tt> berasal dari <tt>TDataBoundControl</tt>, kontrol daftar ini juga berbagi operasi umum yang sama yang dikenal sebagai <tt>databinding</tt> atau penyatuan data. <tt>Items</tt> dapat dipopulasikan dari data yang sudah ada dan ditetapkan oleh <tt>DataSource</tt> atau <tt>DataSourceID</tt>. Fungsi yang memanggil <tt>dataBind()</tt> akan menyebabkan populasi data. Untuk kontrol daftar, data bisa ditetapkan dalam dua jenis format berikut:
-</p>
-<ul id="u2" class="block-content">
- <li>array satu-dimensi atau obyek yang mengimplementasikan <tt>ITraversable</tt> : kunci array akan dipakai sebagai nilai item daftar, dan nilai array akan dipakai sebagai teks item daftar. Sebagai contoh
-<com:TTextHighlighter CssClass="source block-content" id="code_550116">
-$listbox->DataSource=array(
- 'key 1'=>'item 1',
- 'key 2'=>'item 2',
- 'key 3'=>'item 3');
-$listbox->dataBind();
-</com:TTextHighlighter>
-</li>
- <li>data tabular (dua-dimensi): setiap baris mempopulasi satu item daftar. Nilai item daftar ditetapkan oleh anggota yang diindeks dengan <tt>DataValueField</tt>, dan teks item daftar dengan <tt>DataTextField</tt>. Sebagai contoh,
-<com:TTextHighlighter CssClass="source block-content" id="code_550117">
-$listbox->DataTextField='name';
-$listbox->DataValueField='id';
-$listbox->DataSource=array(
- array('id'=>'001','name'=>'John','age'=>31),
- array('id'=>'002','name'=>'Mary','age'=>30),
- array('id'=>'003','name'=>'Cary','age'=>20));
-$listbox->dataBind();
-</com:TTextHighlighter>
-</li>
-</ul>
-
-<h2 id="4802">TListBox</h2>
-<p id="550331" class="block-content">
-<tt>TListBox</tt> menampilkan kotak daftar yang membolehkan satu atau multipel pilihan. Setel properti <tt>SelectionMode</tt> sebagai <tt>Single</tt> untuk menjadikan kotak daftar pilihan tunggal, dan <tt>Multiple</tt> untuk kotak daftar pilihan multipel. Jumlah baris ditampilkan dalam kotak ditetapkan melalui nilai properti <tt>Rows</tt>.
-</p>
-<com:RunBar PagePath="Controls.Samples.TListBox.Home" />
-
-<h2 id="4803">TDropDownList</h2>
-<p id="550332" class="block-content">
-<tt>TDropDownList</tt> menampilkan kotak daftar dropdown yang membolehkan pengguna untuk memilih opsi tunggal dari beberapa yang telah ditetapkan.
-</p>
-<p class="block-content">
-Sejak v3.1.1, <tt>TDropDownList</tt> mulai mendukung teks pertanyaan (seperti 'Please select:' sebagai item list pertama). Untuk menggunakan fitur ini, setel baik <tt>PromptText</tt> ataupun <tt>PromptValue</tt>, atau keduanya. Jika pengguna memilih item pertanyaan, dropdown list tidak akan dipilih.
-</p>
-<com:RunBar PagePath="Controls.Samples.TDropDownList.Home" />
-
-<h2 id="4804">TCheckBoxList</h2>
-<p id="550333" class="block-content">
-<tt>TCheckBoxList</tt> menampilkan sebuah daftar kotak centang pada halaman Web. Penjajaran teks selain setiap kotak centang dapat ditetapkan dengan <tt>TextAlign</tt>. Tata letak kotak centang bisa dikontrol oleh properti berikut:
-</p>
-<ul id="u3" class="block-content">
- <li><tt>RepeatLayout</tt> - berupa <tt>Table</tt> atau <tt>Flow</tt>. <tt>Table</tt> menggunakan sel tabel HTML untuk mengatur kotak centang, sementara <tt>Flow</tt> mengunakan tag span dan break HTML untuk pengaturannya. Dengan tata letak <tt>Table</tt>, anda bisa menyetel <tt>CellPadding</tt> dan <tt>CellSpacing</tt>.</li>
- <li><tt>RepeatColumns</tt> - berapa banyak kolom kotak centang akan ditampilkan.</li>
- <li><tt>RepeatDirection</tt> - ke mana menjelajahi kotak centang, dalam cara horisontal (karena kotak centang ditampilkan dalam tata letak mirip-matriks).</li>
-</ul>
-
-<com:RunBar PagePath="Controls.Samples.TCheckBoxList.Home" />
-
-<h2 id="4805">TRadioButtonList</h2>
-<p id="550334" class="block-content">
-<tt>TRadioButtonList</tt> mirip dengan <tt>TCheckBoxList</tt> dalam setiap aspek kecuali bahwa setiap <tt>TRadioButtonList</tt> menampilkan sebuah grup tombol radio. Hanya satu tombol radio dapat dipilih, (<tt>TCheckBoxList</tt> membolehkan pilihan multipel).
-</p>
-<com:RunBar PagePath="Controls.Samples.TRadioButtonList.Home" />
-
-<h2 id="4806">TBulletedList</h2>
-<p id="550335" class="block-content">
-<tt>TBulletedList</tt> menampilkan item dalam format bulat pada halaman Web. Gaya bulat dapat ditetapkan dengan <tt>BulletStyle</tt>. Ketika gaya adalah <tt>CustomImage</tt>, tanda bulat ditampilkan sebagai gambar, yang ditetapkan dengan <tt>BulletImageUrl</tt>.
-</p>
-<p id="550336" class="block-content">
-<tt>TBulletedList</tt> menampilkan teks item dalam tiga mode berbeda,
-</p>
-<ul id="u4" class="block-content">
- <li><tt>Text</tt> - teks item ditampilkan sebagai teks statis;</li>
- <li><tt>HyperLink</tt> - setiap item ditampilkan sebagai hiperlink yang URL-nya diberikan oleh nilai item, dan properti <tt>Target</tt> bisa dipakai untuk menetapkan jendela browser;</li>
- <li><tt>LinkButton</tt> - setiap item ditampilkan sebagai tombol link yang melakukan posts back pada halaman jika pengguna mengkliknya, dan event <tt>OnClick</tt> akan dimunculkan di bawah keadaan demikian.</li>
-</ul>
-
-<com:RunBar PagePath="Controls.Samples.TBulletedList.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Literal.page b/demos/quickstart/protected/pages/Controls/id/Literal.page deleted file mode 100755 index 2cb07646..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Literal.page +++ /dev/null @@ -1,25 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="3701">TLiteral</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TLiteral" />
-
-<p id="420283" class="block-content">
-<tt>TLiteral</tt> menampilkan teks statis pada halaman Web. <tt>TLiteral</tt> mirip dengan kontrol <tt>TLabel</tt>, kecuali bahwa <tt>TLiteral</tt>
- * Kontrol tidak memiliki properti style, seperti <tt>BackColor</tt>, <tt>Font</tt>, dll.
-</p>
-
-<p id="420284" class="block-content">
-Teks yang ditampilkan oleh <tt>TLiteral</tt> bisa dikontrol secara programatis dengan menyetel properti <tt>Text</tt>. Teks yang ditampilkan mungkin HTML-dikodekan jika <tt>Encode</tt> adalah true (nilai standarnya false).
-</p>
-
-<p id="420285" class="block-content">
-<tt>TLiteral</tt> akan menyajikan konten yang dikurung dalam tag komponen jika <tt>Text</tt> kosong.
-</p>
-
-<p id="420286" class="block-content">
-Harap berhati-hati jika <tt>Encode</tt> adalah false, pastikan <tt>Text</tt> tidak berisi karakter yang tidak diinginkan yang dapat menjadikan keamanan mudah ditembus.
-</p>
-
-<com:RunBar PagePath="Controls.Samples.TLiteral.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/MultiView.page b/demos/quickstart/protected/pages/Controls/id/MultiView.page deleted file mode 100755 index 677f4359..00000000 --- a/demos/quickstart/protected/pages/Controls/id/MultiView.page +++ /dev/null @@ -1,43 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="3801">TMultiView</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TMultiView" />
-
-<p id="430287" class="block-content">
-<tt>TMultiView</tt> bertindak sebagai penampung grup kontrol <tt>TView</tt>, yang dapat diambil oleh properti <tt>Views</tt>. Setiap tampilan berisi kontrol anak. <tt>TMultiView</tt> menentukan tampilan mana dan kontrol anaknya yang terlihat. Kapan saja hanya satu tampilan terlihat (disebut <i>aktif</i>). untuk mengaktifkan tampilan, setel <tt>ActiveView</tt> atau <tt>ActiveViewIndex</tt>. Catatan, standarnya tidak ada tampilan yang aktif.
-</p>
-<p id="430288" class="block-content">
-Untuk menambah tampilan ke <tt>TMultiView</tt>, manipulasi koleksi <tt>Views</tt> atau tambah ia dalam template seperti berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_430109">
-<com:TMultiView>
- <com:TView>
- view 1 content
- </com:TView>
- <com:TView>
- view 2 content
- </com:TView>
-</com:TMultiView>
-</com:TTextHighlighter>
-
-<p id="430289" class="block-content">
-<tt>TMultiView</tt> merespon event perintah berikut untuk mengatur penampakan tampilannya.
-</p>
-<ul id="u1" class="block-content">
- <li><tt>NextView</tt> : beralih ke tampilan berikutnya (dengan memperhatikan tampilan aktif saat ini).
- <li><tt>PreviousView</tt> : beralih ke tampilan sebelumnya (dengan memperhatikan tampilan aktif saat ini).
- <li><tt>SwitchViewID</tt> : beralih ke tampilan sesuai path ID. Path ID diambil dari parameter perintah.
- <li><tt>SwitchViewIndex</tt> : beralih ke tampilan sesuai indeks berbasis-nol dalam koleksi <tt>Views</tt>. Indeks diambil dari parameter perintah.
-</ul>
-
-<p id="430290" class="block-content">
-Setelah postback, jika indeks tampilan aktif diubah, <tt>TMultiView</tt> akan memunculkan event <tt>OnActiveViewChanged</tt>.
-</p>
-
-<p id="430291" class="block-content">
-<a href="?page=Fundamentals.Samples.Hangman.Home">Permainan Hangman</a> adalah penggunaan umum dari <tt>TMultiView</tt>. Contoh berikut memperlihatkan kegunaan lain dari <tt>TMultiView</tt>.
-</p>
-
-<com:RunBar PagePath="Controls.Samples.TMultiView.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/NewControl.page b/demos/quickstart/protected/pages/Controls/id/NewControl.page deleted file mode 100755 index 85c6eff0..00000000 --- a/demos/quickstart/protected/pages/Controls/id/NewControl.page +++ /dev/null @@ -1,152 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5401">Menulis Kontrol Baru</h1>
-<p id="660428" class="block-content">
-Menulis kontrol baru sering diinginkan oleh para pemrogram tingkat lanjut, karena mereka ingin menggunakan ulang kode yang mereka tulis untuk menghadapi penyajian yang komples serta interaksi pengguna.
-</p>
-<p id="660429" class="block-content">
-Secara umum, ada dua cara penulisan kontrol baru: komposisi kontrol yang sudah ada dan memperluas kontrol yang sudah ada. Semuanya memerlukan kontrol baru tersebut berasal dari <tt>TControl</tt> atau kelas anaknya.
-</p>
-
-<h2 id="5402">Komposisi Kontrol yang Sudah Ada</h2>
-<p id="660430" class="block-content">
-Komposisi adalah cara termudah membuat kontrol baru. Ia melibatkan terutama penurunan kontrol yang sudah ada, mengkonfigurasinya dan menjadikannya unsur komponen. Properti dari unsur komponen diperlihatkan melalui <a href="?page=Fundamentals.Components1">subproperti</a>.
-</p>
-<p id="660431" class="block-content">
-Seseorang dapat menciptakan sebuah kontrol baru dalam dua cara. Pertama adalah memperluas <tt>TCompositeControl</tt> dan mengganti metode <tt>TControl::createChildControls()</tt>. Kedua adalah memperluas <tt>TTemplateControl</tt> (atau kelas anaknya) dan menulis template kontrol. Yang terakhir lebih mudah digunakan dan bisa mengatur tata letak unsur komponen lebih intuitif, sementara pembentuk lebih efisien karena ia tidak perlu menguraikan template.
-</p>
-<p id="660432" class="block-content">
-Sebagai contoh, kami memperlihatkan bagaimana untuk membuat kotak teks berlabel yang disebut <tt>LabeledTextBox</tt> menggunakan dua pendekatan di atas. Kotak teks berlabel menampilkan label disamping kotak teks. Kami ingin menggunakan ulang <tt>TLabel</tt> dan <tt>TTextBox</tt> yang disediakan PRADO untuk menyelesaikan tugas ini.
-</p>
-
-<h3 id="5404">Komposisi dengan Menulis Template</h3>
-<p id="660433" class="block-content">
-Kita memerlukan dua file: sebuah file kelas kontrol bernama <tt>LabeledTextBox.php</tt> dan file template kontrol bernama <tt>LabeledTextBox.tpl</tt>. Keduanya harus berada di bawah direktori yang sama.
-</p>
-<p id="660434" class="block-content">
-Seperti membuat halaman PRADO, kita dapat dengan mudah menuliskan konten dalam file template kontrol.
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_660129">
-<com:TLabel ID="Label" ForControl="TextBox" />
-<com:TTextBox ID="TextBox" />
-</com:TTextHighlighter>
-<p id="660435" class="block-content">
-Template di atas menetapkan kontrol <tt>TLabel</tt> bernama <tt>Label</tt> dan kontrol <tt>TTextBox</tt> bernama <tt>TextBox</tt>. Kita ingin memperlihatkan kedua kontrol ini. Ini bisa dikerjakan dengan mendefinisikan properti untuk masing-masing kontrol dalam file kelas <tt>LabeledTextBox</tt>. Sebagai contoh, kita dapat mendefinisikan proper <tt>Label</tt> seperti berikut,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_660130">
-class LabeledTextBox extends TTemplateControl {
- public function getLabel() {
- $this->ensureChildControls();
- return $this->getRegisteredObject('Label');
- }
-}
-</com:TTextHighlighter>
-<p id="660436" class="block-content">
-Dalam contoh di atas, metode memanggil <tt>ensureChildControls()</tt> memastikan bahwa kontrol label dan kotak teks sudah dibuat (dari template) ketika properti <tt>Label</tt> diakses. Properti <tt>TextBox</tt> dapat diimplementasikan dengan cara yang sama.
-</p>
-<com:RunBar PagePath="Controls.Samples.LabeledTextBox1.Home" />
-
-<h3 id="5405">Komposisi dengan Penggantian <tt>createChildControls()</tt></h3>
-<p id="660437" class="block-content">
-Untuk kontrol gabungan sesederhana <tt>LabeledTextBox</tt>, lebih baik membuatnya dengan memperluas <tt>TCompositeControl</tt> dan mengganti metode <tt>createChildControls()</tt>, karena ia tidak menggunakan template dan menghemat waktu penguraian template.
-</p>
-<p id="660438" class="block-content">
-Kode lengkap untuk <tt>LabeledTextBox</tt> ditampilkan sebagai berikut,
-</p>
-<com:TTextHighlighter CssClass="source block-content" id="code_660131">
-class LabeledTextBox extends TCompositeControl {
- private $_label;
- private $_textbox;
- public function createChildControls() {
- $this->_label=new TLabel;
- $this->_label->setID('Label');
- // tambah label sebagai anak dari LabeledTextBox
- $this->getControls()->add($this->_label);
- $this->_textbox=new TTextBox;
- $this->_textbox->setID('TextBox');
- $this->_label->setForControl('TextBox');
- // tambah textbox sebagai anak dari LabeledTextBox
- $this->getControls()->add($this->_textbox);
- }
- public function getLabel() {
- $this->ensureChildControls();
- return $this->_label;
- }
- public function getTextBox() {
- $this->ensureChildControls();
- return $this->_textbox;
- }
-}
-</com:TTextHighlighter>
-<com:RunBar PagePath="Controls.Samples.LabeledTextBox2.Home" />
-
-<h3 id="5406">Menggunakan <tt>LabeledTextBox</tt></h3>
-<p id="660439" class="block-content">
-Untuk menggunakan kontrol <tt>LabeledTextBox</tt>, pertama kita perlu menyertakan file kelas terkait. Kemudian dalam template halaman, kita dapat menuliskan baris seperti berikut,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_660132">
-<com:LabeledTextBox ID="Input" Label.Text="Username" />
-</com:TTextHighlighter>
-<p id="660440" class="block-content">
-Dalam contoh di atas, <tt>Label.Text</tt> adalah subproperti dari <tt>LabeledTextBox</tt>, yang merujuk ke properti <tt>Text</tt> dari properti <tt>Label</tt>. Untuk lebih jelasnya atas pemakaian <tt>LabeledTextBox</tt>, lihat contoh online di atas.
-</p>
-
-<h2 id="5403">Memperluas Kontrol yang Sudah Ada</h2>
-<p id="660441" class="block-content">
-Memperluas kontrol yang sudah ada sama seperti penurunan kelas konvensional. Ia membolehkan para pengembang untuk mengkustomisasi kelas kontrol yang sudah ada dengan mengganti propertinya, metodenya, event, atau membuat yang baru.
-</p>
-<p id="660442" class="block-content">
-Kesulitan tugas tergantung pada seberapa banyak kelas yang sudah ada dikustomisasi. Sebagai contoh, tugas sederhana bisa mengkustomisasi kontrol <tt>TLabel</tt>, agar ia menampilkan label merah sercara standarnya. Ini akan melibatkan setelan properti <tt>ForeColor</tt> ke <tt>"red"</tt> dalam konstruktornya. Tugas yang sulit adalah membuat kontrol yang menyediakan fungsional inovatif secara lengkap. Biasanya, ini memerlukan perluasan kontrol dari kelas kontrol "tingkat rendah", seperti misalnya <tt>TControl</tt> atau <tt>TWebControl</tt>.
-</p>
-<p id="660443" class="block-content">
-Dalam bagian ini, sebagian besar kami memperkenalkan basis kelas kontrol <tt>TControl</tt> dan <tt>TWebControl</tt>, memperlihatkan bagaimana mereka bisa dikustomisasi. Kami juga memperkenalkan bagaimana untuk menulis kontrol dengan fungsionalitas khusus, seperti mengambil data post, memunculkan data post dan penyatuan data dengan sumber data.
-</p>
-
-<h3 id="5407">Memperluas <tt>TControl</tt></h3>
-<p id="660444" class="block-content">
-<tt>TControl</tt> adalah basis kelas dari semua kelas kontrol. Dua metode adalah yang paling penting untuk kelas kontrol turunannya:
-</p>
-<ul id="u1" class="block-content">
- <li><tt>addParsedObject()</tt> - metode ini diminta oleh setiap komponen ata string teks yang dikurung di dalam tag komponen yang menetapkan kontrol dalam sebuah template. Standarnya, komponen dan string teks yang dikurung ditambahkan ke dalam koleksi <tt>Controls</tt> dari kontrol. Kontrol turunannya dapat mengganti metode ini untuk melakukan proses khusus mengenai konten yang dikurung tersebut. Sebagai contoh, <tt>TListControl</tt> hanya menerima komponen <tt>TListItem</tt> dikurung di dalam tag komponennya, dan komponen ini ditambahkan ke koleksi <tt>Items</tt> dari <tt>TListControl</tt>.
- <li><tt>render()</tt> - metode ini menyajikan kontrol. Standarnya menyajikan item-item dalam koleksi <tt>Controls</tt>. Kontrol turunannya dapat mengganti metode ini guna memberikan penyajian yang dikustomisasi.</li>
-</ul>
-Properti dan metode penting lainnya termasuk:
-<ul id="u2" class="block-content">
- <li><tt>ID</tt> - string yang secara unik mengidentifikasi kontrol diantara semua kontrol dari tempat penamaan yang sama. ID otomatis akan dibuat jika properti ID tidak disetel secara eksplisit.</li>
- <li><tt>UnqiueID</tt> - ID unik lengkap yang mengidentifikasi kontrol diantara semua kontrol pada hirarki halaman saat ini. Ia dapat digunakan untuk mencari kontrol dalam hirarki halaman dengan memanggil metode <tt>TControl::findControl()</tt>. Kontrol input pengguna sering memakainya sebagai nilai dari atribut yang sama dari elemen input HTML.</li>
- <li><tt>ClientID</tt> - mirip dengan <tt>UniqueID</tt>, kecuali bahwa ia dipakai terutama untuk penyajian dan umumnya digunakan sebagai nilai atribut id elemen HTML. Jangan bergantung pada format eksplisit <tt>ClientID</tt>.</li>
- <li><tt>Enabled</tt> - apakah kontrol ini dihidupkan atau tidak. Catatan, dalam beberapa kasus, jika salah satu kontrol leluhurnya dimatikan, kontrol juga diperlakukan sebagai dimatikan, meskipun properti <tt>Enabled</tt> adalah true.</li>
- <li><tt>Parent</tt> - kontrol leluhur dari kontrol ini. Kontrol leluhur memegang kendali apakah menyajikan kontrol ini atau tidak dan di mana menempatkan hasil yang disajikan.</li>
- <li><tt>Page</tt> - halaman yang berisi kontrol ini.</li>
- <li><tt>Controls</tt> - koleksi dari semua kontrol anak, termasuk teks statis diantaranya. Ia dapat dipakai seperti sebuah array, karena ia mengimplementasikan antarmuka <tt>Traversable</tt>. Untuk menambah anak ke kontrol, cukup sisipkan ia ke dalam koleksi <tt>Controls</tt> di posisi yang sesuai.</li>
- <li><tt>Attributes</tt> - koleksi dari atribut kustom. Ini berguna untuk membolehkan para pengguna untuk menetapkan atribut dari elemen output HTML yang tidak tercakup oleh properti kontrol.</li>
- <li><tt>getViewState()</tt> dan <tt>setViewState()</tt> - metode ini umum dipakai untuk mendefinisikan properti yang disimpan dalam kondisi tampilan.</li>
- <li><tt>saveState()</tt> dan <tt>loadState()</tt> - kedua metode ini bisa diganti untuk menyediakan langkah terakhir kondisi penyimpanan dan pengambilan.</li>
- <li>Control lifecycles - Seperti halaman, kontrol juga mempunyai masa hidup. Setiap kontrol menjalani masa hidupnya dalam urutan berikut: constructor, <tt>onInit()</tt>, <tt>onLoad()</tt>, <tt>onPreRender()</tt>, <tt>render()</tt>, dan <tt>onUnload</tt>. Lebih jelasnya dapat ditemukan dalam seksi <a href="?page=Fundamentals.Pages">halaman</a>.</li>
-</ul>
-
-<h3 id="5408">Memperluas <tt>TWebControl</tt></h3>
-<p id="660445" class="block-content">
-<tt>TWebControl</tt> dipakai terutama sebagai basis kelas untuk kontrol yang menyajikan elemen HTML. Ia menyediakan satu set properti yang umum diantara elemen HTML. Ia memisahkan <tt>TControl::render()</tt> ke dalam metode berikut yang lebih cocok untuk menyajikan elemen HTML:
-</p>
-<ul id="u3" class="block-content">
- <li><tt>addAttributesToRender()</tt> - menambah atribut untuk elemen HTML yang disajikan. Metode ini sering diganti dengan kelas tutunannya karena biasanya memiliki atribut berbeda yang disajikan.</li>
- <li><tt>renderBeginTag()</tt> - menyajikan tag HTML pembuka.</li>
- <li><tt>renderContents()</tt> - menyajikan konten dikurung di dalam elemen HTML. Standarnya menampilkan item-item dalam koleksi <tt>Controls</tt> daru kontrol. kelas turunannya dapat mengganti metode ini guna menyajikan konten yang dikustomisasi.</li>
- <li><tt>renderEndTag()</tt> - menyajikan tag HTML penutup.</li>
-</ul>
-<p id="660446" class="block-content">
-Ketika menyajikan tag HTML pembuka, <tt>TWebControl</tt> memanggil <tt>getTagName()</tt> untuk mendapatkan nama tag. kelas turunannya dapat mengganti metode ini guna menyajikan nama tag yang berbeda.
-</p>
-
-<h3 id="5409">Membuat Kontrol dengan Fungsional Khusus</h3>
-<p id="660447" class="block-content">
-Jika sebuah kontrol ingin merespon event sisi-klien dan menterjemahkannya ke dalam event sisi server (disebut event postback), seperti <tt>TButton</tt>, ia harus mengimplementasikan antarmuka <tt>IPostBackEventHandler</tt>.
-</p>
-<p id="660448" class="block-content">
-Jika kontrol ingin bisa mengambil data post, seperti <tt>TTextBox</tt>, ia harus mengimplementasikan antarmuka <tt>IPostBackDataHandler</tt>.
-</p>
-<p id="660449" class="block-content">
-Jika kontrol ingin mendapatkan data dari beberapa sumber data eksternal, ia harus memperluas <tt>TDataBoundControl</tt>. <tt>TDataBoundControl</tt> mengimplementasikan properti dasar yang diperlukan untuk mempopulasi data melalui databinding. Kenyataanya, kontrol seperti <tt>TListControl</tt>, <tt>TRepeater</tt> adalah <tt>TDataGrid</tt> semua berasal darinya.
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/OutputCache.page b/demos/quickstart/protected/pages/Controls/id/OutputCache.page deleted file mode 100755 index 0a605a92..00000000 --- a/demos/quickstart/protected/pages/Controls/id/OutputCache.page +++ /dev/null @@ -1,46 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="88025">TOutputCache</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TOutputCache" />
-
-<p id="440292" class="block-content">
-<tt>TOutputCache</tt> menghidupkan cache sebagian dari halaman Web, juga dikenal sebagai partial caching. Konten yang sedang di-cache adalah sumber halaman HTML yang berasal dari teks statis pada template PRADO atau disajikan oleh satu atau beberapa kontrol pada template. Ketika konten yang di-cache dipakai, kontrol yang membuat konten tidak lagi dibuat untuk hirarki halaman dan selanjutnya penghematan secara signifikan waktu pemrosesan halaman dapat dicapai. Efek sampingnya, seperti yang sudah anda bayangkan adalah bahwa konten yang ditampilkan mungkin membosankan jika versi cache ditampilkan ke para pengguna.
-</p>
-
-<p id="440293" class="block-content">
-Untuk menggunakan <tt>TOutputCache</tt>, cukup kurung konten yang akan di-cache di dalam tag komponen <tt>TOutputCache</tt> pada template (baik template kontrol halaman ataupun non-halaman), misalnya
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_440110">
-<com:TOutputCache>
- content to be cached
-</com:TOutputCache>
-</com:TTextHighlighter>
-<p id="440294" class="block-content">
-di mana konten yang di-cache bisa berupa teks statis dan/atau tag template. Jika yang kedua, hasil penyajian dari tag template akan di-cache. Anda dapat menempatkan satu atau beberapa <tt>TOutputCache</tt> pada satu template dan ia dapat diulang-ulang.
-</p>
-
-<div class="note"><b class="tip">Note:</b>
-<tt>TOutputCache</tt> menyimpan konten yang di-cache melalui modul cache PRADO (misalnya <tt>TSqliteCache</tt>) dan selanjutnya memerlukan setidaknya satu modul cache diambil saat aplikasi dijalankan.
-</div>
-
-<p id="440295" class="block-content">
-Validitas dari konten yang di-cache ditentukan berdasarkan dua faktor: <tt>Durasi</tt> dan ketergantungan cache. Pembentuk menetapkan jumlah detik data bisa tetap benar dalam cache (standarnya 60 detik), sementara yang kedua menetapkan kondisi data yang di-cache tergantung padanya. Jika ketergantungan berubah (misalnya data relevan dalam DB dimutakhirkan), data yang di-cache akan dibuat tidak benar dan diabaikan.
-</p>
-
-<p id="440296" class="block-content">
-Ada dua cara untuk menetapkan ketergantungan cache. Seseorang bisa menulis pengendali event guna merespon event <tt>OnCheckDependency</tt> dan menyetel properti parameter event <tt>IsValid</tt> untuk menunjukan apakah data yang di-cache tetap benar atau tidak. Seseorang juga bisa memperluas <tt>TOutputCache</tt> dan mengganti metode <tt>getCacheDependency()</tt>-nya.
-</p>
-
-<p id="440297" class="block-content">
-Konten yang diambil dari cache dapat bervariasi dengan memperhatikan beberapa parameter. <tt>TOutputCache</tt> mendukung variasi dengan memperhatikan parameter permintaan, yang ditetapkan oleh properti <tt>VaryByParam</tt>. Jika parameter permintaan yang ditetapkan berbeda, versi berbeda dari konten yang di-cache dipakai. Ini sangat berguna jika konten halaman mungkin divariasikan berdasarkan beberapa parameter GET. Konten yang sedang di-cache juga dapat divariasikan dengan sesi pengguna jika <tt>VaryBySession</tt> disetel true. Untuk memvariasikan konten yang di-cache oleh faktor lain, ganti metode <tt>calculateCacheKey()</tt>.
-</p>
-
-<p id="440298" class="block-content">
-Output cache bisa diulang. Cache terluar mengambil lebih dulu di atas cache terdalam dalam menentukan kebenaran konten yang di-cache. Ini berarti, jika konten yang di-cache oleh cache terdalam berakhir atau dibuat tidak benar, sementara yang terluar tidak, maka konten terluar yang di-cache akan dipakai.
-</p>
-
-<p id="440299" class="block-content">
-Standarnya, <tt>TOutputCache</tt> hanya efektif untuk permintaan halaman non-postback dan saat modul cache dihidupkan. Jangan mencoba untuk mengalamatkan kontrol anak pada <tt>TOutputCache</tt> saat konten yang di-cache saat ini sedang dipakai. Gunakan properti <tt>ContentCached</tt> untuk menentukan apakah konten di-cache atau tidak.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Pager.page b/demos/quickstart/protected/pages/Controls/id/Pager.page deleted file mode 100755 index 1761e61c..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Pager.page +++ /dev/null @@ -1,38 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="3901">TPager</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TPager" />
-
-<p id="450300" class="block-content">
-<tt>TPager</tt> membuat sebuah lembaran yang menyediakan UI bagi pengguna akhir untuk secara interaktif menetapkan halaman data mana yang disajikan dalam kontrol turunan-<tt>TDataBoundControl</tt>, seperti <tt>TDataList</tt>, <tt>TRepeater</tt>, <tt>TCheckBoxList</tt>, dll. Kontrol data-terikat sasaran ditetapkan dengan properti <tt>ControlToPaginate</tt>, yang harus berupa path ID dari kontrol sasaran yang dijangkau dari tempat penamaan lembar.
-</p>
-
-<p id="450301" class="block-content">
-Note, the target data-bound control must have its <tt>AllowPaging</tt> set to true. Otherwise the pager will be invisible. Also, in case when there is only one page of data available, the pager will also be invisible.
-</p>
-
-<p id="450302" class="block-content">
-<tt>TPager</tt> dapat menampilkan salah satu dari tiga tipe antarmuka pengguna, ditetapkan melalui properti <tt>Mode</tt>-nya:
-</p>
-<ul id="u1" class="block-content">
-<li><tt>NextPrev</tt> - tombol halaman berikutnya dan sebelumnya yang disajikan pada setiap halaman.</li>
-<li><tt>Numeric</tt> - daftar tombol indeks halaman yang disajikan.</li>
-<li><tt>DropDownList</tt> - daftar dropdown pada indeks halaman yang disajikan.</li>
-</ul>
-<p id="450303" class="block-content">
-Antarmuka pengguna ini selanjutnya dapat dikustomisasi dengan mengkonfigurasi properti berikut
-</p>
-<ul id="u2" class="block-content">
-<li><tt>NextPageText</tt> dan <tt>PrevPageText</tt> - label dari tombol halaman berikutnya/sebelumnya. Properti ini dipakai ketika <tt>Mode</tt> lembar adalah <tt>NextPrev</tt> atau <tt>Numeric</tt>.</li>
-<li><tt>FirstPageText</tt> dan <tt>LastPageText</tt> - label dari tombol halaman pertama/terakhir. Jika kosong, tombol terkait tidak akan ditampilkan. Properti ini dipakai ketika <tt>Mode</tt> lembar adalah <tt>NextPrev</tt> atau <tt>Numeric</tt>.</li>
-<li><tt>PageButtonCount</tt> - jumlah maksimum tombol indeks halaman pada sebuah halaman. Properti ini dipakai saat <tt>Mode</tt> lembar adalah <tt>Numeric</tt>.</li>
-<li><tt>ButtonType</tt> - tipe tombol halaman, <tt>PushButton</tt> berarti tombol submisi normal, atau <tt>LinkButton</tt> berarti tombol hiperlink.</li>
-</ul>
-
-<p id="450304" class="block-content">
-<tt>TPager</tt> memunculkan event <tt>OnPageIndexChanged</tt> ketika pengguna-akhir berinteraksi dengannya dan menetapkan halaman baru (misalnya dengan mengklik pada tombol halaman berikutnya yang akan membawa ke halaman berikutnya). Para pengembang dapat menulis pengendali untuk merspon event ini dan medapatkan indeks halaman baru yang diinginkan, seseorang bisa memasukan halaman baru data ke kontrol ikatan-data terkait.
-</p>
-
-<com:RunBar PagePath="Controls.Samples.TPager.Sample1" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Panel.page b/demos/quickstart/protected/pages/Controls/id/Panel.page deleted file mode 100755 index 1152f65f..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Panel.page +++ /dev/null @@ -1,11 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="3901">TPanel</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TPanel" />
-
-<p id="460305" class="block-content">
-<tt>TPanel</tt> bertindak sebagai tempat penyajian untuk kontrol lain. Ia menampilkan elemen <div> pada halaman. Properti <tt>Wrap</tt> menetapkan konten badan panel yang menggulung ataupun tidak, sementara <tt>HorizontalAlign</tt> mengatur bagaimana konten dijajarkan secara horisontal dan <tt>Direction</tt> menunjukan arah konten (kiri ke kanan atau kanan ke kiri). Anda dapat menyetel <tt>BackImageUrl</tt> untuk memberikan gambar latar belakang pada panel, dan dana bisa menyetel <tt>GroupingText</tt> agar panel ditampilkan sebagai set field dengan legenda teks. Terakhir, anda bisa menetapkan tombol standar untuk dipicu saat para pengguna menekan tombol 'return' di dalam panel dengan menyetel properti <tt>DefaultButton</tt>.
-</p>
-<com:RunBar PagePath="Controls.Samples.TPanel.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/PlaceHolder.page b/demos/quickstart/protected/pages/Controls/id/PlaceHolder.page deleted file mode 100755 index fc269291..00000000 --- a/demos/quickstart/protected/pages/Controls/id/PlaceHolder.page +++ /dev/null @@ -1,12 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="4001">TPlaceHolder</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TPlaceHolder" />
-
-<p id="470306" class="block-content">
-<tt>TPlaceHolder</tt> menyimpan tempat pada template, di mana teks statis atau kontrol dapat disisipkan secara dinamis.
-</p>
-
-<com:RunBar PagePath="Controls.Samples.TPlaceHolder.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/RadioButton.page b/demos/quickstart/protected/pages/Controls/id/RadioButton.page deleted file mode 100755 index e9ff5cc7..00000000 --- a/demos/quickstart/protected/pages/Controls/id/RadioButton.page +++ /dev/null @@ -1,11 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="4101">TRadioButton</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TRadioButton" />
-
-<p id="480307" class="block-content">
-<tt>TRadioButton</tt> mirip dengan <tt>TCheckBox</tt> dalam setiap aspek, kecuali bahwa <tt>TRadioButton</tt> menampilkan tombol radio pada halaman Web. Tombol radio dapat dimiliki oleh grup yang ditetapkan oleh <tt>GroupName</tt> dengan demikian hanya satu tombol radio yang bisa dipilih.
-</p>
-<com:RunBar PagePath="Controls.Samples.TRadioButton.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Repeater.page b/demos/quickstart/protected/pages/Controls/id/Repeater.page deleted file mode 100755 index 801ef858..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Repeater.page +++ /dev/null @@ -1,111 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="5301">TRepeater</h1>
-
-<p id="600400" class="block-content">
-TRepeater menampilkan kontennya secara berulang berdasarkan data yang diambil dari <tt>DataSource</tt>. Konten yang diulang dalam TRepeater disebut <i>items</i> sebuah kontrol yang dapat diakses melalui properti <tt>Items</tt>. Ketika <tt>dataBind()</tt> dipanggil, TRepeater membuat sebuah item untuk setiap baris data dan mengikat baris data ke item. Secara opsional, TDataList dapat mempunyai header, footer dan/atau pemisah antara item.
-</p>
-
-<p id="600401" class="block-content">
-Tata letak dari konten yang diulang dalam TDataList ditetapkan dengan template inline. Item TDataList, header, footer, dll. diturunkan dengan template terkait saat data sedang diikat ke pengulang.
-</p>
-
-<p id="600402" class="block-content">
-Sejak v3.1.0, tata letak juga bisa dietapkan oleh <i>penyaji</i>. Penyaji adalah kelas kontrol yang dapat diturunkan sebagai item datalist, header, dll. Penyaji dapat dilihat sebagai template eksternal (sebenarnya, ia juga merupakan kontrol tanpa-template). Penyaji bisa berupa kelas kontrol apapun. Dengan menggunakan penyaji, seseorang dapat menghindari penulisan panjang dan template yang kacau. Karena penyaji adalah sebuah kelas, ia juga membantu menggunakan kembali template yang sebelumnya mungkin disertekan di dalam template lain. Jika diimplementasikan dengan salah satu antarmuka berikut, penyaji akan diinisialisasi dengan properti tambahan yang relevan terhadap item penyaji:
-</p>
-
-<ul id="u1" class="block-content">
-<li><tt>IDataRenderer</tt> - properti <tt>Data</tt> akan disetel sebagai baris dari data terikat ke item penyaji. Banyak kontrol PRADO mengimplementasikan antarmuka ini, seperti <tt>TLabel</tt>, <tt>TTextBox</tt>, dll.</li>
-<li><tt>IItemDataRenderer</tt> - properti <tt>ItemIndex</tt> akan disetel sebagai indeks berbasis-nol pada item dalam koleksi item penyaji, dan properti <tt>ItemType</tt> sebagai tipe item (seperti <tt>TListItemType::Item</tt>). Untuk kenyamanan basis kelas, <tt>TRepeaterItemRenderer</tt> mengimplementasikan <tt>IDataItemRenderer</tt> dan dapat mempunyai template terkait karena diperluas dari <tt>TTemplateControl</tt>.</li>
-</ul>
-
-
-<p id="600403" class="block-content">
-Properti berikut dipakai untuk menetapkan tipe template dan penyaji datalist. Jika tipe konten didefinisikan dengan template dan penyaji, maka penyaji diambil lebih dulu.
-</p>
-<ul id="u2" class="block-content">
-<li><tt>ItemTemplate</tt>, <tt>ItemRenderer</tt> - untuk setiap baris data yang diulang.</li>
-<li><tt>AlternatingItemTemplate</tt>, <tt>AlternatingItemRenderer</tt>: untuk setiap pergantian baris data. Jika tidak disetel, masing-masing <tt>ItemTemplate</tt> atau <tt>ItemRenderer</tt> yang akan dipakai.</li>
-<li><tt>HeaderTemplate</tt>, <tt>HeaderRenderer</tt> - untuk header repeater.</li>
-<li><tt>FooterTemplate</tt>, <tt>FooterRenderer</tt> - untuk footer repeater.</li>
-<li><tt>SeparatorTemplate</tt>, <tt>SeparatorRenderer</tt> - untuk konten yang ditampilkan diantara item.</li>
-<li><tt>EmptyTemplate</tt>, <tt>EmptyRenderer</tt> - dipakai saat data yang terikat ke penyaji kosong.</li>
-</ul>
-
-
-<p id="600404" class="block-content">
-Untuk mempopulasikan data ke dalam item pengulag, setel <tt>DataSource</tt> ke obyek data yang benar, seperti array, <tt>TList</tt>, <tt>TMap</tt>, atau tabel database, dan kemudian panggil <tt>dataBind()</tt> untuk pengulang. Yaitu,
-</p>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_600125">
-class MyPage extends TPage {
- public function onLoad($param) {
- parent::onLoad($param);
- if(!$this->IsPostBack) {
- $this->Repeater->DataSource=$data;
- $this->Repeater->dataBind();
- }
- }
-}
-</com:TTextHighlighter>
-
-<p id="600405" class="block-content">
-Ketika <tt>dataBind()</tt> dipanggil, TRepeater menjalani masa hidup seperti berikut untuk setiap baris data:
-</p>
-
-<ol id="u3" class="block-content">
-<li>buat item berdasarkan template atau penyaji</li>
-<li>setel baris data ke item</li>
-<li>munculkan event <tt>OnItemCreated</tt></li>
-<li>tambah item sebagai kontrol anak</li>
-<li>panggil <tt>dataBind()</tt> pada item</li>
-<li>munculkan event <tt>OnItemDataBound</tt></li>
-</ol>
-
-<p id="600406" class="block-content">
-Biasanya anda hanya perlu mengikat data ke pengulang saat halaman yang berisi pengulang mulai diminta. Ketika halaman adalah post back, pengulang akan mengembalikan secara otomatis seluruh konten, termasuk item, header, footer dan pemisah. Akan tetapi, baris data yang terkait dengan setiap item tidak akan ditemukan kembali dan menjadi null.
-</p>
-
-<p id="600407" class="block-content">
-Untuk mengakses data item pengulang dalam postbacks, gunakan salah satu cara berikut:
-</p>
-<ul id="u4" class="block-content">
-<li>Gunakan <tt>DataKeys</tt> untuk memperoleh kunci data terkait dengan item pengulang (repeater) yang ditetapkan dan gunakan kunci untuk mengambil data terkait dari beberapa penyimpanan persisten seperti misalnya DB. </li>
-<li>Simpan seluruh dataset dalam kondisi tampilan, yang akan mengembalikan dataset secara otomatis setelah postback. Bagaimanapun juga, harap berhati-hati jika ukuran dataset anda besar, ukuran halaman akan menjadi besar. Beberapa data kompleks mungkin juga mempunyai masalah serialisasi jika disimpan dalam kondisi tampilan.</li>
-</ul>
-
-
-<p id="600408" class="block-content">
-TRepeater memunculkan <tt>OnItemCommand</tt> kapan saja kontrol tombol di dalam beberapa item pengulang memunculkan event <tt>OnCommand</tt>. Oleh karena itu, anda bisa menangani semua event <tt>OnCommand</tt> di satu tempat dengan menulis pengendali event untuk event <tt>OnItemCommand</tt>.
-</p>
-
-<p id="600409" class="block-content">
-Contoh berikut memperlihatkan bagaimana menggunakan TRepeater guna menampilkan data tabular.
-</p>
-<com:RunBar PagePath="Controls.Samples.TRepeater.Sample1" />
-<p id="600410" class="block-content">
-TRepeater Dapat digunakan dalam situasi lebih kompleks. Sebagai contoh, kami tampilkan dalam contoh berikut bagaimana menggunakan pengulang yang diulang-ulang, misalnya pengulang dalam pengulang. Ini umum terlihat dalam penyajian data master-detail. Untuk menggunakan pengulang di dalam pengulang lain, untuk sebuah item untuk pengulang di luarnya dibuat, kita perlu menyetel sumber data detail untuk pengulang terdalam. Ini bisa dilakukan dengan merespon ke event <tt>OnItemDataBound</tt> pada pengulang terluar. Event <tt>OnItemDataBound</tt> dimunculkan setiap kali item pengulang terluar menyelesaikan penyatuan data. Dalam contoh berikut, kita mengeksploitasi event lain pada pengulang yang disebut <tt>OnItemCreated</tt>, yang dimunculkan setiap kali item pengulang (dan kontennya) baru saja dibuat. Kita respon ke event ini dengan menyetel warna latar belakang berbeda untuk item pengulang guna menyempurnakan tampilan latar belakang item berganti. Ini menghemat kita dari penulisan <tt>AlternatingItemTemplate</tt> untuk pengulang.
-</p>
-<com:RunBar PagePath="Controls.Samples.TRepeater.Sample2" />
-<p id="600411" class="block-content">
-Selain menampilkan data, TRepeater juga bisa dipakai untuk mengumpulkan data dari pengguna. Kontrol validasi dapat ditempatkan dalam template TRepeater guna memberifikasi bahwa input pengguna sudah benar.
-</p>
-<p id="600412" class="block-content">
-Demo <a href="../composer/index.php">Penyusun komponen PRADO</a> adalah contoh yang baik atas penggunaan tersebut. Ia menggunakan pengulang untuk mengumpulkan properti komponen dan definisi event. Para pengguna juga dapat menghapus atau menyesuaikan event dan propertinya, yang diimplementasikan dengan merespon ke event <tt>OnItemCommand</tt> pada pengulang.
-</p>
-<p id="600413" class="block-content">
-Lihat dalam contoh lain berikut yang memperlihatkan bagaimana menggunakan pengulang untuk mengumpulkan input pengguna.
-</p>
-<com:RunBar PagePath="Controls.Samples.TRepeater.Sample3" />
-
-<p id="600414" class="block-content">
-Contoh ini memperlihatkan bagaimana menggunakan penyaji item "drop-in", tersedia sejak v3.1.0. Penyaji ini ada dalam rilis PRADO. Mereka intinya kontrol yang mengimplementasikan antarmuka <tt>IDataRenderer</tt>. Kontrol Web umum, seperti <tt>TTextBox</tt>, <tt>TLabel</tt>, semuanya mengimplementasikan antarmuka ini. Ketika kontrol tersebut adalah penyaji item yang dipakai, properti <tt>Data</tt> ditempati dengan baris data yang sedang diikat ke item pengulang.
-</p>
-<com:RunBar PagePath="Controls.Samples.TRepeater.Sample4" />
-
-<p id="600415" class="block-content">
-Lebih sering, seseorang perlu mengkustomisasi tata letak item pengulang. Contoh di atas bergantng pada <tt>OnItemCreated</tt> untuk menyesuaikan penampilan pengulang. Pengulang item template lebih disukai dalam situasi ini, karena membolehkan kita untuk menyimpan tata letak dan konten yang lebih kompleks dalam sebuah item pengulang. Contoh berikut mengimplementasikan ulang contoh pengulang yang diulang-ulang menggunakan template item penyadi yang disebut <tt>RegionDisplay</tt>. seperti kita lihat, kode baru lebih mudah dimengerti dan dipelihara.
-</p>
-<com:RunBar PagePath="Controls.Samples.TRepeater.Sample5" />
-
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/SafeHtml.page b/demos/quickstart/protected/pages/Controls/id/SafeHtml.page deleted file mode 100755 index 6b3257f1..00000000 --- a/demos/quickstart/protected/pages/Controls/id/SafeHtml.page +++ /dev/null @@ -1,25 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="4201">TSafeHtml</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TSafeHtml" />
-
-<p id="490308" class="block-content">
-<tt>TSafeHtml</tt> adalah kontrol yang membuang semua konten HTML yang berpotensi membahayakan. Ini terutama sebagai pelapis dari proyek <a href="http://pixel-apes.com/safehtml/">SafeHTML</a>. Menurut proyek SafeHTML, ia mencoba untuk mengamankan situasi berikut saat string ditampilkan kepada pengguna-akhir:
-</p>
-<ul id="u1" class="block-content">
- <li>Tag pembuka tanpa tang penutupnya</li>
- <li>penutupan tag tanpa tag pembukanya
- <li>salah satu dari tag ini: base, basefont, head, html, body, applet, object, iframe, frame, frameset, script, layer, ilayer, embed, bgsound, link, meta, style, title, blink, xml, dll.</li>
- <li>seiap atribut ini: on*, data*, dynsrc</li>
- <li>javascript:/vbscript:/about: dll. protocols</li>
- <li>ekspresi/perangai, dll. dalam style</li>
- <li>konten aktif lainnya.</li>
-</ul>
-
-<p id="490309" class="block-content">
-Untuk menggunakan <tt>TSafeHtml</tt>, cukup kurung konten untuk diamankan dalam tag komponen <tt>TSafeHtml</tt> pada template. Konten bisa terdiri dari teks statis dan kontrol PRADO. Jika yang kedua, hasil penyajian kontrol akan aman.
-</p>
-
-<com:RunBar PagePath="Controls.Samples.TSafeHtml.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Slider.page b/demos/quickstart/protected/pages/Controls/id/Slider.page deleted file mode 100755 index 627366d8..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Slider.page +++ /dev/null @@ -1,50 +0,0 @@ -<com:TContent ID="body" > - -<h1 id="4401">TSlider</h1> -<com:DocLink ClassPath="System.Web.UI.WebControls.TSlider" /> - -<p id="510314" class="block-content"> -<tt>TSlider</tt> menampilkan sebuah slider untuk keperluan input numerik. Slider terdiri dari <em>lajur</em> -yang medefinisikan jangkauan nilai yang mungkin, dan sebuah <em>kendali</em> yang dapt bergeser pada lajur, untuk memilih -sebuah nilai dalam jangkauan. Lajur dapat berupa Horisontal atau Vertikal, tergantung dari properti <tt>Direction</tt>. -Standarnya adalah horisontal. -</p> -<p> -Batas jangkauan ditetapkan oleh properti <tt> MinValue</tt> dan <tt>MaxValue</tt>. -Jangkauan standar mulai dari 0 sampai 100. -Properti <tt>StepSize</tt> bisa dipakai untuk mendefinisikan <em>langkah</em> diantara 2 nilai didalam jangkauan. -Catatan bahwa langkah ini akan dihitung ulang jika ada lebih dari 200 nilai diantara batas jangkauan. -Anda juga bisa melengkapi nilai yang diijinkan dengan menyetel array <tt>Values</tt>. -</p> - -<p> -sub-properti kendali dapat diakses dengan properti <tt>Handle</tt>. Anda juga bisa menyediakan kontrol anda sendiri -untuk kendali, menggunakan properti <tt>HandleClass</tt>. Catatan bahwa kelas ini harus berupa subkelas dari <tt>TSliderHandle</tt> -</p> - -<p> -Kontrol TSlider bisa dikustomisasi dengan mudah menggunakan CssClasses. Anda bisa menyediakan file css sendiri menggunakan properti <tt>CssUrl</tt>. -Kelas css untuk TSlider dapat disetel dengan properti <tt>CssClass</tt>. Nilai standarnya dalah <b>'hslider'</b> untuk -slider Horisontal, atau <b>'vslider'</b> untuk Vertikal. -Kelas css untuk Handle bisa disetel dengan subproperti <tt>Handle.CssClass</tt>. Standarnya adalah <b>'handle'</b>, yang menggambar blok merah sebagai kursor. Kelas css <b>'handle-image'</b> juga disediakan demi kenyamanan anda, yang berfungsi menampilkan gambar sebagai kendali. -</p> - -<p> -Jika properti <tt>AutoPostBack</tt> adalah true, postback dilakukan segera setelah nilai berubah. -</p> - -<p> -TSlider memunculkan event <tt>onValueChanged</tt> saat nilai slider telah berubah selama postback. -</p> - -<p> -Anda juga bisa melampirkan pengendali event javascript ClientSide ke slider : -<ul> -<li><tt>ClientSide.onSlide</tt> dipanggil ketika kendali digeser pada lajur. Anda akan mendapatkan nilai saat ini di dalam variabel javascript <b>value</b>. Anda dapat menggunakan event ini untuk dimutakhirkan pada sisi klien dengan sebuah label dengan nilai saat ini</li> -<li><tt>ClientSide.onChange</tt> dipanggil saat nilai slider berubah (di akhir perpindahan).</li> -</ul> -</p> - -<com:RunBar PagePath="Controls.Samples.TSlider.Home" /> - -</com:TContent> diff --git a/demos/quickstart/protected/pages/Controls/id/Standard.page b/demos/quickstart/protected/pages/Controls/id/Standard.page deleted file mode 100755 index 5e9f76d8..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Standard.page +++ /dev/null @@ -1,147 +0,0 @@ -<com:TContent ID="body" >
-
-<h1>Kontrol Standar</h1>
-<p>* tutorial untuk kontrol ini belum lengkap.</p>
-<ul id="u1" class="block-content">
- <li>
- <a href="?page=Controls.Button">TButton</a> mewakili tombol klik pada halaman Web, dipakai terutama sebagai pemicu postback halaman.
- </li>
-
- <li>
- <a href="?page=Controls.Captcha">TCaptcha</a> menampilkan CAPTCHA untuk menjaga spammers dari pendaftaran untuk akun online tertentu.
- </li>
-
- <li>
- <a href="?page=Controls.CheckBox">TCheckBox</a> mewakili kotak centang pada halaman Web, bisa digunakan untuk mengumpulkan dua-kondisi input pengguna.
- </li>
-
- <li>
- <a href="?page=Controls.ClientScript">TClientScript</a> menambahkan kode javascript ke halaman.
- </li>
-
- <li>*
- <a href="?page=Controls.ColorPicker">TColorPicker</a> mewakili field input yang mengambil nilai warna via dialog warna.
- </li>
-
- <li>
- <a href="?page=Controls.Conditional">TConditional</a> menampilkan konten terkaiit ke hasil true atau false dari sebuah ekspresi PHP.
- </li>
-
- <li>
- <a href="?page=Controls.DatePicker">TDatePicker</a> mewakili field input yang mengambil nilai tanggal via dialog kalender.
- </li>
-
- <li>
- <a href="?page=Controls.Expression">TExpression</a> menerima ekspresi PHP dan menampilkan hasil evaluasi pada halaman Web.
- </li>
-
- <li>
- <a href="?page=Controls.FileUpload">TFileUpload</a> mewakili field upload file, membolehkan pengguna mengirimkan file ke server.
- </li>
-
- <li>*
- <a href="?page=Controls.Head">THead</a> mewakili elemen <head> pada halaman Web HTML. Diperlukan oleh halaman PRADO agar bisa memakai tema.
- </li>
-
- <li>
- <a href="?page=Controls.HiddenField">THiddenField</a> mewakili field input tersembunyi pada halaman Web.
- </li>
-
- <li>
- <a href="?page=Controls.HtmlArea">THtmlArea</a> mewakili field input teks WYSIWYG yang mengambil input pengguna dalam format HTML.
- </li>
-
- <li>
- <a href="?page=Controls.HyperLink">THyperLink</a> mewakili hyperlink pada halaman Web.
- </li>
-
- <li>
- <a href="?page=Controls.Image">TImage</a> mewakili gambar pada halaman Web.
- </li>
-
- <li>
- <a href="?page=Controls.ImageButton">TImageButton</a> mewakili tombol klik yang memiliki gambar sebagai latar belakang, dipakai untuk memicu postback halaman.
- </li>
-
- <li>
- <a href="?page=Controls.ImageMap">TImageMap</a> mewakili gambar pada halaman Web dengan bagian titik yang bisa diklik.
- </li>
-
- <li>
- <a href="?page=Controls.InlineFrame">TInlineFrame</a> mewakili elemen <iframe> HTML pada halaman Web.
- </li>
-
- <li>
- <a href="?page=Controls.JavascriptLogger">TJavascriptLogger</a> mewakili pencatat pada halaman Web yang bisa mencatat berbagai informasi JavaScript.
- </li>
-
- <li>
- <a href="?page=Controls.Keyboard">TKeyboard</a> menampilkan keyboard virtual bagi pengguna untuk memasukan input ke dalam kotak teks.
- </li>
-
- <li>
- <a href="?page=Controls.Label">TLabel</a> mewakili label pada halaman Web. Label bisa dikustomisasi via berbagai atribut CSS.
- </li>
-
- <li>
- <a href="?page=Controls.LinkButton">TLinkButton</a> mewakili hyperlink yang bisa melakukan postbacks halaman.
- </li>
-
- <li>
- <a href="?page=Controls.Literal">TLiteral</a> mewakili teks statis tanpa tag HTML yang mengelilinginya pada halaman Web.
- </li>
-
- <li>
- <a href="?page=Controls.MultiView">TMultiView</a> mewakili tempat untuk grup kontrol <tt>TView</tt>, masing-masing adalah tempat untuk kontrol lainnya. Kapan saja, sebanyak-banyaknya satu <tt>TView</tt> yang terlihat.
- </li>
-
- <li>
- <a href="?page=Controls.OutputCache">TOutputCache</a> menghidupkan bagian cache atas output halaman dan dapat meningkatkan waktu respon halaman secara signifikan.
- </li>
-
- <li>
- <a href="?page=Controls.Pager">TPager</a> membuatUI yang membolehkan pengguna untuk menetapkan halaman mana data ditampilkan secara interaktif dalam kontrol data-bound.
- </li>
-
- <li>
- <a href="?page=Controls.Panel">TPanel</a> mewakili tempat untuk kontrol lain pada halaman Web. Dalam HTML, ia ditampilkan sebagai elemen <div>.
- </li>
-
- <li>
- <a href="?page=Controls.PlaceHolder">TPlaceHolder</a> memesan tempat pada template kontrol. Ia menyisipkan konten body-nya di tempat itu.
- </li>
-
- <li>
- <a href="?page=Controls.RadioButton">TRadioButton</a> mewakili tombol radio pada halaman Web. Dipakai terutama dalam sebuah grup di mana pengguna membuat pilihan.
- </li>
-
- <li>
- <a href="?page=Controls.SafeHtml">TSafeHtml</a> menampilkan konten body dengan kepastian bahwa konten tidak berisi kode yang membahayakan (seperti <a href="?page=Advanced.Security">XSS</a>).
- </li>
-
- <li>
- <a href="?page=Controls.Slider">TSlider</a> mewakili sebuah kontrol Slider
- </li>
-
- <li>
- <a href="?page=Controls.Statements">TStatements</a> menerima beberapa pernyataan PHP dan menampilkan output standarnya pada halaman Web.
- </li>
-
- <li>
- <a href="?page=Controls.Table">TTable</a> mewakili tabel HTML pada halaman Web. Dipakai bersama dengan <tt>TTableRow</tt> dan <tt>TTableCell</tt>.
- </li>
-
- <li>
- <a href="?page=Controls.TextBox">TTextBox</a> mewakili field input teks pada halaman Web. Ia bisa mengumpulkan satu-baris, multi-baris atau input teks sandi dari pengguna.
- </li>
-
- <li>
- <a href="?page=Controls.TextHighlighter">TTextHighlighter</a> menerangi konten body berdasarkan penerang sintaks, seperti PHP, XML, PRADO, dll.
- </li>
-
- <li>
- <a href="?page=Controls.Wizard">TWizard</a> mewakili formulir multi-langkah yang bisas mengambil input pengguna langkah demi langkah. Mirip dengan bimbingan instalasi Windows.
- </li>
-</ul>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Statements.page b/demos/quickstart/protected/pages/Controls/id/Statements.page deleted file mode 100755 index bfc0ac72..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Statements.page +++ /dev/null @@ -1,40 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="4301">TStatements</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TStatements" />
-
-<p id="500310" class="block-content">
-<tt>TStatements</tt> mengevaluasi rangkaian pernyataan PHP dan menampilkan konten yang disajikan oleh pernyataan. Untuk menetapkan pernyataan PHP yang dievaluasi, setel properti <tt>Statements</tt>. Sebagai contoh, tag komponen berikut menampilkan waktu saat ini pada halaman Web,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_500111">
-<com:TStatements>
- <prop:Statements>
- setlocale(LC_ALL, 'nl_NL');
- echo strftime("%A %e %B %Y",time());
- </prop:Statements>
-</com:TStatements>
-</com:TTextHighlighter>
-
-<p id="500311" class="block-content">
-Catatan, <tt>TStatements</tt> mengevaluasi pernyataan PHP selama menyajikan masa hidup kontrol. Tidak seperti <tt>TExpression</tt>, <tt>TStatements</tt> hanya menampilkan konten 'echoed' di dalam pernyataan.
-</p>
-
-<p id="500312" class="block-content">
-Konteks pernyataan dalam kontrol <tt>TStatements</tt> adalah kontrol itu sendiri. Yakni, <tt>$this</tt> mewakili obyek kontrol jika ia ada dalam pernyataan. Sebagai contoh, tag pernyataan berikut akan menampilkan judul halaman berisi kontrol <tt>TStatements</tt>.
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_500112">
-<com:TStatements>
- <prop:Statements>
- $page=$this->Page;
- echo $page->Title;
- </prop:Statements>
-</com:TStatements>
-</com:TTextHighlighter>
-
-<p id="500313" class="block-content">
-Harap berhati-hati, karena <tt>TStatements</tt> membolehkan eksekusi kode PHP bebas, secara umum anda jangan menggunakannya untuk mengevaluasi kode PHP yang dikirimkan oleh pengguna aplikasi anda.
-</p>
-
-<com:RunBar PagePath="Controls.Samples.TStatements.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/TabPanel.page b/demos/quickstart/protected/pages/Controls/id/TabPanel.page deleted file mode 100755 index 02c0e49e..00000000 --- a/demos/quickstart/protected/pages/Controls/id/TabPanel.page +++ /dev/null @@ -1,55 +0,0 @@ -<com:TContent ID="body" >
-
-<h1>TTabPanel</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TTabPanel" />
-
-<p>
-<tt>TTabPanel</tt> menampilkan panel bertab. Para pengguna dapat mengklik pada bar tab untuk beralih diantara tampilan tab yang berbeda. Setiap tampilan tab adalah panel independen yang dapat berisi konten bebas.
-</p>
-
-<p>
-Kontrol <tt>TTabPanel</tt> terdiri dari satu atau beberapa kontrol <tt>TTabView</tt> yang mewakili tampilan tab yang mungkin. Kapan saja, hanya satu tampilan tab terlihat (aktif), yang ditetapkan oleh setiap properti berikut:
-</p>
-
-<ul>
-<li><tt>ActiveViewIndex</tt> - indeks integer berbasis-nol pada tampilan dalam koleksi view.</li>
-<li><tt>ActiveViewID</tt> - ID teks pada tampilan yang telihat.</li>
-<li><tt>ActiveView</tt> - turunan tampilan yang terlihat.</li>
-</ul>
-
-<p>
-Jika <tt>ActiveViewIndex</tt> dan <tt>ActiveViewID</tt> keduanya disetel, yang kedua diambil lebih dahulu.
-</p>
-
-<p>
-<tt>TTabPanel</tt> menggunakan CSS untuk menetapkan penampilan bat tab dan panel. Standarnya, file CSS yang disertakan akan diterbitkan berisi CSS standar untuk <tt>TTabPanel</tt>. Anda juga dapat menggunakan file CSS sendiri dengan menetapkan properti <tt>CssUrl</tt>. Properti berikut menetapkan kelas CSS yang dipakai untuk elemen div dalam <tt>TTabPanel</tt>:
-</p>
-
-<ul>
-<li><tt>CssClass</tt> - nama kelas CSS untuk elemen div terluar (standarnya 'tab-panel');</li>
-<li><tt>TabCssClass</tt> - nama kelas CSS untuk tab non aktif elemen div (standarnya 'tab-normal');</li>
-<li><tt>ActiveTabCssClass</tt> - nama kelas CSS untuk tab aktif elemen div (standarnya 'tab-active');</li>
-<li><tt>ViewCssClass</tt> - kelas CSS untuk elemen div menutupi tampilan konten (standarnya 'tab-view');</li>
-</ul>
-
-<p>
-Untuk menggunakan TTabPanel, tulis template seperti berikut:
-</p>
-
-<com:TTextHighlighter Language="prado" CssClass="source">
- <com:TTabPanel>
- <com:TTabView Caption="View 1">
- content for view 1
- </com:TTabView>
- <com:TTabView Caption="View 2">
- content for view 2
- </com:TTabView>
- <com:TTabView Caption="View 3">
- content for view 3
- </com:TTabView>
- </com:TTabPanel>
-</com:TTextHighlighter>
-
-<com:RunBar PagePath="Controls.Samples.TTabPanel.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Table.page b/demos/quickstart/protected/pages/Controls/id/Table.page deleted file mode 100755 index 5326a2d7..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Table.page +++ /dev/null @@ -1,11 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="4401">TTable</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TTable" />
-
-<p id="510314" class="block-content">
-<tt>TTable</tt> menampilkan tabel HTML pada halaman. ia dipakai bersama dengan <tt>TTableRow</tt> dan <tt>TTableCell</tt> untuk membolehkan memanipulasi tabel HTML secara programatis. Baris dari tabel disimpan dalam properti <tt>Rows</tt>. Anda dapat menyetel tabel cellspacing dan cellpadding masing-masing melalui properti <tt>CellSpacing</tt> dan <tt>CellPadding</tt>. Judul tabel dapat ditetapkan melalui <tt>Caption</tt> di mana penjajarannya ditetapkan dengan <tt>CaptionAlign</tt>. Properti <tt>GridLines</tt> menunjukan bagaimana tabel harus menampikan bingkainya, dan <tt>BackImageUrl</tt> membolehkan tabel untuk memiliki gambar latar belakang.
-</p>
-<com:RunBar PagePath="Controls.Samples.TTable.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/TextBox.page b/demos/quickstart/protected/pages/Controls/id/TextBox.page deleted file mode 100755 index 71f6d235..00000000 --- a/demos/quickstart/protected/pages/Controls/id/TextBox.page +++ /dev/null @@ -1,11 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="4501">TTextBox</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TTextBox" />
-
-<p id="520315" class="block-content">
-<tt>TTextBox</tt> menampilkan kotak teks pada halaman Web. Konten dalam kotak teks ditentukan oleh properti <tt>Text</tt>. Anda dapat membuat teks <tt>SingleLine</tt>, a <tt>MultiLine</tt>, atau <tt>Kata sandi</tt> dengan menyetel properti <tt>TextMode</tt>. Properti <tt>Rows</tt> dan <tt>Columns</tt> menetapkan dimensinya. Jika <tt>AutoPostBack</tt> adalah true, perubahan konten dalam kotak teks dan kemudian memindahkan fokur keluar darinya akan menyebabkan aksi postback.
-</p>
-<com:RunBar PagePath="Controls.Samples.TTextBox.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/TextHighlighter.page b/demos/quickstart/protected/pages/Controls/id/TextHighlighter.page deleted file mode 100755 index b1bb4ce7..00000000 --- a/demos/quickstart/protected/pages/Controls/id/TextHighlighter.page +++ /dev/null @@ -1,25 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="4601">TTextHighlighter</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TTextHighlighter" />
-
-<p id="530316" class="block-content">
-<tt>TTextHighlighter</tt> melakukan penerangan sintaks untuk konten badannya, termasuk teks statis dan hasil penyajian dari kontrol anaknya. Teks yang sedang diterangi mengikuti sintaks <tt>Language</tt> yang ditetapkan, yang dapat berupa 'php' (standar), 'prado', 'css', 'html', dll. Di sini, 'prado' terdiri dari sintaks template kontrol PRADO.
-</p>
-<p id="530317" class="block-content">
-Jika nomor baris diinginkan di depan setiap baris, setel <tt>ShowLineNumbers</tt> ke true.
-</p>
-<p id="530318" class="block-content">
-Untuk menggunakan <tt>TTextHighlighter</tt>, cukup kurung konten yang sintaksnya akan diterangi di dalam badan pada kontrol <tt>TTextHighlighter</tt>. Contoh berikut menerangi bagian kode PHP,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_530113">
-<com:TTextHighlighter ShowLineNumbers="true">
-<?php
-$str = 'one|two|three|four';
-print_r(explode('|', $str, 2)); // akan mengeluarkan array
-</com:TTextHighlighter>
-</com:TTextHighlighter>
-
-<com:RunBar PagePath="Controls.Samples.TTextHighlighter.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Validation.page b/demos/quickstart/protected/pages/Controls/id/Validation.page deleted file mode 100755 index e216d71e..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Validation.page +++ /dev/null @@ -1,216 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="4901">Kontrol Validasi</h1>
-
-<p id="560337" class="block-content">
-Kontrol validasi disebut validator, melakukan validasi terhadap nilai data yang dimasukan-pengguna saat ia ditulis kembali ke server. Validasi dipicu oleh kontrol postback, seperti properti <tt>TButton</tt>, <tt>TLinkButton</tt> atau <tt>TTextBox</tt> (di bawah mode <tt>AutoPostBack</tt>) di mana properti <tt>CausesValidation</tt> adalah true.
-</p>
-
-<p id="560338" class="block-content">
-Validasi selalu dilakukan pada sisi server. Jika <tt>EnableClientScript</tt> adalah true dan browser klien mendukung JavaScript, validator juga dapat melakukan validasi sisi-klien. Validasi sisi-klien akan memvalidasi input pengguna sebelum ia mengirimkannya ke server. Data formulir tidak akan dikirmkan jika ada kesalahan terdeteksi. Ini menghindari informasi yang diperlukan untuk validasi sisi-server.
-</p>
-
-<p id="560339" class="block-content">
-Validator dengan berbagai set properti umum yang didefinisikan dalam basis kelas <tt>TBaseValidator</tt> dan didaftarkan sebagai berikut,
-</p>
-<ul id="u1" class="block-content">
-<li><tt>ControlToValidate</tt> menetapkan kontrol input yang divalidasi. Properti ini harus disetel ke path ID dari kontrol input. Path ID adalah ID titik-terkoneksi dari kontrol yang menjangkai dari tempat penamaan validator ke kontrol sasaran.</li>
-<li><tt>ErrorMessage</tt> menetapkan pesan kesalahan untuk ditampilkan seandainya validator terkait gagal.</li>
-<li><tt>Text</tt> mirip dengan <tt>ErrorMessage</tt>. Jika keduanya ada, <tt>Text</tt> diambil lebih dulu. Properti ini berguna saat dipakai bersama dengan <tt>TValidationSummary</tt>.</li>
-<li><tt>ValidationGroup</tt> menetapkan di grup mana validator berada. Validator hanya akan melakukan validasi jika postback saat ini dipicu oleh kontrol yang berada dalam grup yang sama.</li>
-<li><tt>EnableClientScript</tt> menetapkan apakah validasi harus dilakukan di sisi-klien atau server. Standarnya dihidupkan.</li>
-<li><tt>Display</tt> menetapkan bagaimana pesan kesalahan ditampilkan. Ia mengambil salah satu dari tiga nilai berikut ini:
- <ul>
- <li><tt>None</tt> - pesn kesalahan tidak akan ditampilkan meskipun validator gagal.</li>
- <li><tt>Static</tt> - spasi untuk menampilkan pesan kesalahan disiapkan. Oleh karena itu, menampilkan pesan kesalahan tidak akan mengubah tata letak halaman anda yang sudah ada.</li>
- <li><tt>Dynamic</tt> - spasi untuk menampilkanpesan kesalahan TIDAK disiapkan. Oleh karena itu, menampilkan pesan kesalahan akan menggeser tata letak halaman anda (biasanya ke bawah).</li>
- </ul>
-</li>
-<li><tt>ControlCssClass</tt> - kelas CSS yang diterapkan ke kontrol yang sedang divalidasi seandainya validasi gagal.</li>
-<li><tt>FocusOnError</tt> - menyetel fokus di tempat validasi jika validasi gagal. Standarnya false.</li>
-<li><tt>FocusElementID</tt> - ID dari elemen HTML yang akan menerima fokus jika validasi gagal dan <tt>FocusOnError</tt> adalah true.</li>
-</ul>
-
-<h1 id="116008">Kontrol Validasi Prado</h1>
-<a name="TRequiredFieldValidator"></a>
-<h2 id="4902">TRequiredFieldValidator</h2>
-<p id="560340" class="block-content">
-TRequiredFieldValidator memastikan bahwa pengguna memasukan beberapa data dalam field input yang ditetapkan. Standarnya TRequiredFieldValidator akan memeriksa apakah input pengguna kosong atau tidak. Validasi gagal jika input kosong. Dengan menyetel <tt>InitialValue</tt>, validator dapat memeriksa apakah input pengguna berbeda dari <tt>InitialValue</tt>. Jika tidak, validasi gagal.
-</p>
-<com:RunBar PagePath="Controls.Samples.TRequiredFieldValidator.Home" />
-
-<a name="TRegularExpressionValidator"></a>
-<h2 id="4903">TRegularExpressionValidator</h2>
-<p id="560341" class="block-content">
-TRegularExpressionValidator memverifikasi input pengguna terhadap pola reguler. Validasi gagal jika input tidak sama dengan pola. Ekspresi reguler bisa ditetapkan dengan properti <tt>RegularExpression</tt>. Beberapa ekspresi reguler yang umumnya dipakai termasuk:
-</p>
-<ul id="u2" class="block-content">
-<li>Setidaknya 6 karakter: <code>[\w]{6,}</code></li>
-<li>Nomor Telepon Jepang: <code>(0\d{1,4}-|\(0\d{1,4}\) ?)?\d{1,4}-\d{4}</code></li>
-<li>Kode Pos Jepang: <code>\d{3}(-(\d{4}|\d{2}))?</code></li>
-<li>Nomor Telepon P.R.C.: <code>(\(\d{3}\)|\d{3}-)?\d{8} </code></li>
-<li>Kode Pos P.R.C.: <code>\d{6}</code></li>
-<li>Nomor Keamanan Sosial P.R.C.: <code>\d{18}|\d{15}</code></li>
-<li>Nomor Telepon Amerika: <code>((\(\d{3}\) ?)|(\d{3}-))?\d{3}-\d{4}</code></li>
-<li>Kode ZIP Amerika: <code>\d{5}(-\d{4})?</code></li>
-<li>Nomor Keamanan Sosial Amerika: <code>\d{3}-\d{2}-\d{4}</code></li>
-</ul>
-<p id="560342" class="block-content">
-Pola ekspresi reguler lebih jauh dapat ditemukan di Internet, misalnya
-<a href="http://regexlib.com/">http://regexlib.com/</a>.
-</p>
-<p id="560343" class="block-content">
-Catatan, TRegularExpressionValidator hanya memeriksa input pengguna yang tidak kosong. Gunakan TRequiredFieldValidator untuk memastikan input pengguna tidak kosong.
-</p>
-<com:RunBar PagePath="Controls.Samples.TRegularExpressionValidator.Home" />
-
-<h2 id="TEmailAddressValidator">TEmailAddressValidator</h2>
-<p id="560344" class="block-content">
-TEmailAddressValidator memverifikasi bahwa input pengguna adalah alamat email yang benar. Validator menggunakan ekspresi reguler untuk memeriksa apakah input adalah format alamat email yang benar. Jika <tt>CheckMXRecord</tt> adalah true, validator juga akan memeriksa apakah rekaman MX yang diindikasikan dalam alamat email adalah benar, <tt>checkdnsrr()</tt> tersedia dalam PHP yang diinstalasi.
-</p>
-<p id="560345" class="block-content">
-Catatan, jika input yang divalidasi kosong, TEmailAddressValidator tidak akan melakukan validasi. Gunakan TRequiredFieldValidator untuk memastikan nilai tidak kosong.
-</p>
-<com:RunBar PagePath="Controls.Samples.TEmailAddressValidator.Home" />
-
-<a name="TCompareValidator"></a>
-<h2 id="4904">TCompareValidator</h2>
-<p id="560346" class="block-content">
-TCompareValidator membandingkan input pengguna dengan nilai konstan yang ditetapkan oleh <tt>ValueToCompare</tt>, atau input pengguna lain yang ditetapkan oleh <tt>ControlToCompare</tt>. Properti <tt>Operator</tt> menetapkan bagaimana untuk membandingkan nilai, yang menyertakan <tt>Equal</tt>, <tt>NotEqual</tt>, <tt>GreaterThan</tt>, <tt>GreaterThanEqual</tt>, <tt>LessThan</tt> dan <tt>LessThanEqual</tt>. Sebelum perbandingkan, nilai yang dibandingkan akan diubah ke tipe yang ditetapkan oleh <tt>DataType</tt> seperti didaftarkan sebagai berikut,
-</p>
-<ul id="u3" class="block-content">
-<li><tt>String</tt> - Tipe data string.</li>
-<li><tt>Integer</tt> - Tipe data integer signed 32-bit.</li>
-<li><tt>Float</tt> - Tipe data pecahan presisi-ganda.</li>
-<li><tt>Date</tt> - Tipe data tanggal. Format tanggal dapat ditetapkan dengan menyeting properti <tt>DateFormat</tt>, yang harus dikenal oleh <tt>TSimpleDateFormatter</tt>. Jika properti tidak disetel, sintaks tanggal GNU diasumsikan.</li>
-</ul>
-<p id="560347" class="block-content">
-Catatan, jika input yang sedang divalidasi kosong, TEmailAddressValidator tidak akan melakukan validasi. Gunakan TRequiredFieldValidator untuk memastikan nilai tidak kosong.
-</p>
-<p id="560348" class="block-content">
-<b>N.B.</b> Jika memvalidasi terhadap <a href="?page=Controls.DatePicker">TDatePicker</a> properti <tt>DataType</tt> harus sama dengan "Date" dan properti <tt>DateFormat</tt> pada validator harus sama dengan <tt>DateFormat</tt> pada <a href="?page=Controls.DatePicker">TDatePicker</a>.
-</p>
-<com:RunBar PagePath="Controls.Samples.TCompareValidator.Home" />
-
-<a name="TDataTypeValidator"></a>
-<h2 id="4905">TDataTypeValidator</h2>
-<p id="560349" class="block-content">
-TDataTypeValidator memverifiksai apakah data input adalah tipe spesifik sepeti ditunjukan oleh <tt>DataType</tt>. Tipe data dapat diperiksa kembali apakah sama seperti yang ada dalam TCompareValidator.
-</p>
-<p id="560350" class="block-content">
-<b>N.B.</b> Jika memvalidasi terhadap <a href="?page=Controls.DatePicker">TDatePicker</a> properti <tt>DataType</tt> harus sama dengan "Date" dan properti <tt>DateFormat</tt> pada validator harus sama dengan <tt>DateFormat</tt> pada <a href="?page=Controls.DatePicker">TDatePicker</a>.
-</p>
-
-
-<com:RunBar PagePath="Controls.Samples.TDataTypeValidator.Home" />
-
-<a name="TRangeValidator"></a>
-<h2 id="4906">TRangeValidator</h2>
-<p id="560351" class="block-content">
-TRangeValidator memverifikasi apakah nilai input di dalam jangkauan yang ditetapkan. TRangeValidator menggunakan properti kunci untuk melakukan validasinya. Properti <tt>MinValue</tt> dan properti <tt>MaxValue</tt> menetapkan nilai minimum dan maksimum dari jangkauan yang benar. Properti <tt>DataType</tt> menetapkan tipe data dari nilai yang sedang divalidasi. Pertama, nilai akan diubah ke dalam tipe yang ditetapkan dan kemudian dibandingkan dengan jangkauan yang benar. Tipe data bisa diperiksa apakah sama dengan yang ada dalam TCompareValidator.
-</p>
-
-<p id="range_strict" class="block-content">
-Jika properti <tt>StrictComparison</tt> disetel ke <tt>true</tt>, maka jangkauan dibandingkan semata-mata kurang dari <tt>MaxValue</tt> dan/atau lebih besar dari <tt>MinValue</tt>.
-</p>
-
-<p id="560352" class="block-content">
-<b>N.B.</b> Jika memvalidasi terhadap <a href="?page=Controls.DatePicker">TDatePicker</a> properti <tt>DataType</tt> harus sama dengan "Date" dan properti <tt>DateFormat</tt> pada validator harus sama dengan <tt>DateFormat</tt> pada <a href="?page=Controls.DatePicker">TDatePicker</a>.
-</p>
-
-<com:RunBar PagePath="Controls.Samples.TRangeValidator.Home" />
-
-<a name="TCustomValidator"></a>
-<h2 id="4907">TCustomValidator</h2>
-<p id="560353" class="block-content">
-TCustomValidator melakukan validasi didefinisikan-pengguna (baik sisi-server atau sisi-klien ataupun keduanya) pada kontrol input.
-</p>
-<p id="560354" class="block-content">
-Untuk membuat fungsi validasii sisi-server, sediakan pengendali untuk event <tt>OnServerValidate</tt> yang melakukan validasi. String data pada kontrol input untuk memvalidasi dapat diakses dengan parameter event properti <tt>Value</tt>. Hasil validasi harus disimpan dalam properti <tt>IsValid</tt> pada parameter.
-</p>
-<p id="560355" class="block-content">
-Untuk membuat fungsi validasi sisi-klien, tambahkan fungsi validasi javascript ke template halaman dan tempatkan namanya ke properti <tt>ClientValidationFunction</tt>. Fungsi harus memiliki tanda sebagai berikut:
-</p>
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_560118">
-<script type="text/javascript">
-function ValidationFunctionName(sender, parameter)
-{
- // if(parameter == ...)
- // return true;
- // else
- // return false;
-}
-</script>
-</com:TTextHighlighter>
-<com:RunBar PagePath="Controls.Samples.TCustomValidator.Home" />
-
-<a name="TValidationSummary"></a>
-<h2 id="4908">TValidationSummary</h2>
-<p id="560356" class="block-content">
-TValidationSummary menampilkan ringkasan dari kesalahan inline validasi pada halaman Web, dalam kotak pesan, atau keduanya.
-</p>
-<p id="560357" class="block-content">
-Standarnya ringkasan validasi akan mengumpulkan <tt>ErrorMessage</tt> dari semua validator yang gagal pada halaman. Jika <tt>ValidationGroup</tt> tidak kosong, hanya validator itu yang dimiliki grup akan menampilkan pesan kesaslahannya dalam ringkasan.
-</p>
-<p id="560358" class="block-content">
-Ringkasan dapat ditampilkan sebagai daftar, daftar bertitik, atau satu paragraf berdasarkan properti <tt>DisplayMode</tt>. Pesan yang ditampilkan dapat diawali dengan <tt>HeaderText</tt>. Ringkasan dapat ditampilkan pada halaman Web atau kotak pesan JavaScript, masing-masing dengan menyetel properti <tt>ShowSummary</tt> dan <tt>ShowMessageBox</tt>. Catatan, yang terakhir hanya efektif saat <tt>EnableClientScript</tt> adalah true.
-</p>
-<com:RunBar PagePath="Controls.Samples.TValidationSummary.Home" />
-
-<h1 id="123123">Berinteraksi dengan Validator</h1>
-<h2 id="116009">Mereset atau Membersihkan Validator</h2>
-<p id="1212323">
-Validator bisa mereset pada sisi-klien menggunakan javascript dengan memanggil
-<tt>Prado.Validation.reset(groupID)</tt> di mana <tt>groupID</tt> adalah nama pengelompokan. Jika <tt>groupID</tt> adalah null, maka validator tanpa pengelompokan yang dipakai.
-</p>
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_560118a">
-<script type="text/javascript">
-function reset_validator()
-{
- Prado.Validation.reset("group1");
-}
-</script>
-</com:TTextHighlighter>
-<com:RunBar PagePath="Controls.Samples.ResetValidation.Home" />
-
-<h2 id="5301">Validasi Kondisional Sisi Server dan Klien</h2>
-<p id="560359" class="block-content">
- Semua validator berisi event berikut.
- Event terkait untuk sisi klien tersedia sebagai sub-properti
- dari properti <tt>ClientSide</tt> pada validator.
-</p>
- <ul id="u4" class="block-content">
- <li>Event <tt>OnValidate</tt> muncul sebelum fungsi validasi validator yang dipanggil.</li>
- <li>Event <tt>OnValidationSuccess</tt> muncul setelah validator sukses memvalidasi kontrol.</li>
- <li>Event <tt>OnValidationError</tt> muncul setelah validator gagal memvalidasi.</li>
- </ul>
-
-<div class="note"><b class="tip">Catatan:</b>
-Untuk Prado sebelum versi 3.1 nama properti adalah <tt>OnError</tt> dan <tt>OnSuccess</tt>. Untuk Prado versi 3.1 dan berikutnya masing-masing <tt>OnValidationError</tt> dan <tt>OnValidationSuccess</tt>.
-</div>
-
-<p id="560360" class="block-content">Contoh berikut memunculkan pesan yang mengatakan "hello" saat validator gagal pada sisi-klien.
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_560119">
-<com:TRequiredFieldValidator ... >
- <prop:ClientSide.OnValidationError>
- alert("hello");
- </prop:ClientSide.OnValidationError>
-</com:TRequiredFieldValidator>
-</com:TTextHighlighter>
-Hasil event fungsi callback sisi-klien adalah dalam bentuk seperti berikut.
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_560120">
-function onErrorHandler(sender, parameter)
-{
- alert("hello");
-}
-</com:TTextHighlighter>
-di mana <tt>sender</tt> adalah vaidator sisi-klien saat ini dan <tt>parameter</tt> adalah kontrol yang memanggil validator.
-</p>
-<h3 id="5302">Contoh Validasi Kondisional</h3>
-<p id="560361" class="block-content">
-Contoh berikut memperlihatkan penggunaan event validator sisi-klien dan sisi server. Contoh mendemonstrasikan validasi kondisional. Catatan bahwa, kita perlu menuliskan kode untuk sisi server dan klien. Selanjutnya, pada sisi server, kita perlu menghidupkankembali validator kondisional agar kode javascript dihasilkan tanpa mempedulikan apapun (sebaliknya, validator sisi-klien tidak tersedia).
-<com:RunBar PagePath="Controls.Samples.TClientSideValidator.Home" />
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Wizard.page b/demos/quickstart/protected/pages/Controls/id/Wizard.page deleted file mode 100755 index 5105adef..00000000 --- a/demos/quickstart/protected/pages/Controls/id/Wizard.page +++ /dev/null @@ -1,100 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="4701">TWizard</h1>
-<com:DocLink ClassPath="System.Web.UI.WebControls.TWizard" />
-
-<h2 id="4702">Tinjauan</h2>
-<p id="540319" class="block-content">
-<tt>TWizard</tt> adalah analogi terhadap bimbingan instalasi yang umum digunakan untuk menginstalasi software pada Windows. Ia memisahkan formulir besar dan menyajikan pengguna dengan sederetan formulir lebih kecil, disebut langkah bimbingan, untuk diselesaikan. Gambar berikut memperlihatkan bagaimana bimbingan dibuat atas kapan disajikan untuk pengguna, di mana <tt>konten langkah</tt> adalah konten utama pada langkah bimbingan untuk diselesaikan oleh para pengguna, <tt>header</tt> merujuk ke konten header yang umum bagi seluruh langkah, <tt>navigasi</tt> berisi tombol yang membolehkan pengguna untuk menjelajahi langkah demi langkah, dan <tt>bar samping</tt> berisi daftar hiperlink di mana para pengguna dapat menjangkau ke setiap langkah dengan satu klik. Penampakan bar samping dapat dihidup matikan dengan menyetel <tt>ShowSideBar</tt>.
-</p>
-<img src="<%~wizard.gif%>" alt="components of wizard" />
-
-<p id="540320" class="block-content">
-Standarnya <tt>TWizard</tt> menyertakan komponen di atas dalam sebuah tabel HTML agar bar samping bisa ditampilkan di kiri sementara sisanya di kanan. Jika <tt>UseDefaultLayout</tt> disetel ke false, tidak ada tabel HTML yang akan dipakai, dan para pengembang hrus menggunakan teknik murni CSS untuk posisi komponen bimbingan. Catatan, setiap komponen ditampilkan sebagai <div> dan bimbingan sendiri juga adalah <div> yang mengurung komponennya <div>.
-</p>
-
-<p id="540321" class="block-content">
-Langkah bimbingan disajikan dengan <tt>TWizardStep</tt> dan dipelihara dalam <tt>TWizard</tt> melalui properti <tt>WizardSteps</tt>. Kapan saja hanya satu yang terlihat, yang ditentukan oleh properti <tt>ActiveStep</tt>. Properti <tt>ActiveStepIndex</tt> memberikan indeks pada langkah yang aktif dalam koleksi langkah. Mengklik pada tombol navigasi dapat mengaktifkan langkah bimbingan yang berbeda.
-</p>
-
-<p id="540322" class="block-content">
-Langkah bimbingan biasanya ditambahkan ke bimbingan melalui template seperti berikut,
-</p>
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_540114">
-<com:TWizard>
- <com:TWizardStep Title="step 1" StepType="Start">
- konten dalam langkah 1 dapat berisi kontrol lain
- </com:TWizardStep>
-
- <com:TWizardStep Title="step 2" StepType="Step">
- konten dalam langkah 2 dapat berisi kontrol lain
- </com:TWizardStep>
-
- <com:TWizardStep Title="finish step" StepType="Finish">
- konten dalam langkah selesai dapat berisi kontrol lain
- </com:TWizardStep>
-</com:TWizard>
-</com:TTextHighlighter>
-
-<p id="540323" class="block-content">
-Dalam contoh di atas, <tt>StepType</tt> merujuk ke tipe langkah bimbingan, yang dapat mempengaruhi bagaimana penampilan navigasi dan perilaku langkah. Langkah bimbingan dapat berupa salah satu dari tipe berikut:
-</p>
-<ul id="u1" class="block-content">
- <li><tt>Start</tt> - langkah pertama dalam bimbingan.</li>
- <li><tt>Step</tt> - langkah internal dalam bimbiingan.</li>
- <li><tt>Finish</tt> - langkah terakhir yang membolehkan interaksi pengguna.</li>
- <li><tt>Complete</tt> - langkah yang memperlihatkan ringkasan kepada penngguna. Dalam langkah ini, bar samping dan panel navigasi tidak terlihat. Selanjutnya, langkah ini biasanya tidak membolehkan interaksi pengguna.</li>
- <li><tt>Auto</tt> - tipe langkah ditentukan oleh bimbingan secara otomatis.</li>
-</ul>
-
-
-<h2 id="4703">Menggunakan TWizard</h2>
-
-<h3 id="4704">Contoh Bimbingan Satu-Langkah</h3>
-<p id="540324" class="block-content">
-Dalam contoh ini, kita menggunakan bimbingan untuk mengumpulkan preferensi pengguna pada warna. Dalam langkah pertama, pengguna disajikan dengan daftar dropdown dari mana dia dapat memilih warna favoritnya. Dalam langkah kedua, langkah lengkap, pilihannya dalam langkah sebelumnya ditampilkan. Dalam aplikasi sebenarnya, pada langkah ini pilihan bisa disimpan dalam database di belakang layar.
-</p>
-<com:RunBar PagePath="Controls.Samples.TWizard.Sample1" />
-
-<h3 id="4705">Mengkustomisasi Gaya Bimbingan</h3>
-<p id="540325" class="block-content">
-<tt>TWizard</tt> mendefinisikan seluruh set properti untuk kustomisasi penampilan berbagai komponennya seperti yang ditampilkan pada gambar di atas. Dalam keadaan tertentu, properti berikut disediakan untuk kustomisasi gaya:
-</p>
-<ul id="u2" class="block-content">
- <li>Header - <tt>HeaderStyle</tt>.</li>
- <li>Langkah - <tt>StepStyle</tt>.</li>
- <li>Navigasi - <tt>NavigationStyle</tt>, <tt>StartNextButtonStyle</tt>, <tt>StepNextButtonStyle</tt>, <tt>StepPreviousButtonStyle</tt>, <tt>FinishPreviousButtonStyle</tt>, <tt>FinishCompleteButtonStyle</tt>, <tt>CancelButtonStyle</tt>.</li>
- <li>Bar samping - <tt>SideBarStyle</tt>, <tt>SideBarButtonStyle</tt>.</li>
-</ul>
-<com:RunBar PagePath="Controls.Samples.TWizard.Sample2" />
-
-<h3 id="4706">Mengkustomisasi Navigasi Bimbingan</h3>
-<p id="540326" class="block-content">
-Berikut adalah set langkah bimbingan, <tt>TWizard</tt> mendukung tiga cara navigasi diantaranya:
-</p>
-<ul id="u3" class="block-content">
- <li>Bidirectional - Para pengguna dapat menjelajahi maju dan mundur sepanjang rangkaian langkah bimbingan. Input data pengguna biasanya dikumpulkan di langkah terakhir. Ini juga dikenal sebagai model commit-at-the-end. Itulah cara navigasi standar yang didukung <tt>TWizard</tt>.</li>
- <li>Unidirectional - Para pengguna dapat menjelajahi maju sepanjang rangkaian langkah bimbingan. Pindah mundur tidak dibolehkan. Data input pengguna biasa dikumpulkan langkah demi langkah. Ini juga dikenal sebagai model command-as-you-go. Untuk melarang perpindahan mundur ke langkah tertentu, setel properti <tt>AllowReturn</tt> ke false.</li>
- <li>Nonlinear - Input pengguna dalam langkah menentukan langkah mana berikutnya. Untuk melakukannya, setel <tt>ActiveStepIndex</tt> ke langkah yang anda ingin agar pengguna pergi ke sana. Dalam hal ini, ketika pengguna mengklik pada tombol sebelumnya alam panel navigasi, langkah sebelumnya yang telah mereka kunjungi (bukan langkah sebelumnya dalam urtan sekuensial) akan menjadi terlihat.</li>
-</ul>
-<com:RunBar PagePath="Controls.Samples.TWizard.Sample3" />
-
-<h3 id="4707">Menggunakan Template dalam Bimbingan</h3>
-<p id="540327" class="block-content">
-<tt>TWizard</tt> mendukung kontrol konkrit dari penampilannya melalui template. Dalam keadaan tertentu, ia menyediakan properti template yang membolehkan kustomisasi lengkap pada header, navigasi dan bar samping.
-</p>
-<ul id="u4" class="block-content">
- <li>Header - <tt>HeaderTemplate</tt>.</li>
- <li>Navigation - <tt>StartNavigationTemplate</tt>, <tt>StepNavigationTemplate</tt>, <tt>FinishNavigationTemplate</tt>.</li>
- <li>Side bar - <tt>SideBarTemplate</tt>.</li>
-</ul>
-<com:RunBar PagePath="Controls.Samples.TWizard.Sample4" />
-
-<h3 id="4708">Menggunakan Langkah Bimbingan Bertemplate</h3>
-<p id="540328" class="block-content">
-Langkah bimbingan juga dapat diberi template. Dengan menggunakan <tt>TTemplatedWizardStep</tt>, seseorang dapat mengkustomisasi konten langkah dan navigasi melalui masing-masing properti <tt>ContentTemplate</tt> dan <tt>NavigationTemplate</tt>. Ini berguna untuk pengembang kontrol guna membangun bimbingan khusus seperti registrasi pengguna, kereta belanja, dll.
-</p>
-<com:RunBar PagePath="Controls.Samples.TWizard.Sample5" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/wizard.gif b/demos/quickstart/protected/pages/Controls/id/wizard.gif Binary files differdeleted file mode 100755 index 9faf580d..00000000 --- a/demos/quickstart/protected/pages/Controls/id/wizard.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Database/ActiveRecord.page b/demos/quickstart/protected/pages/Database/ActiveRecord.page index cf1485bd..566dfe66 100755 --- a/demos/quickstart/protected/pages/Database/ActiveRecord.page +++ b/demos/quickstart/protected/pages/Database/ActiveRecord.page @@ -36,7 +36,7 @@ Active Record objects can be used to update the database. The "relationship" between Active Records and <a href="?page=Database.SqlMap">SqlMap</a> is illustrated in the following diagram. More details regarding the SqlMap Data Mapper can be found in - the <a href="http://www.pradosoft.com/demos/sqlmap/">SqlMap Manual</a>. + the <a href="http://www.pradoframework.net/site/demos/sqlmap/">SqlMap Manual</a>. <img src=<%~ sqlmap_active_record.png %> alt="Active Records and SqlMap DataMapper" id="fig:diagram.png" class="figure"/> </p> diff --git a/demos/quickstart/protected/pages/Database/SqlMap.page b/demos/quickstart/protected/pages/Database/SqlMap.page index be8cb03a..8c528070 100755 --- a/demos/quickstart/protected/pages/Database/SqlMap.page +++ b/demos/quickstart/protected/pages/Database/SqlMap.page @@ -189,7 +189,7 @@ $user = $sqlmap->queryForObject("SelectUsers"); <p id="700523" class="block-content">The above example shows demonstrates only a fraction of the capabilities of the SqlMap Data Mapper. Further details can be found in the - <a href="http://www.pradosoft.com/demo/sqlamp/">SqlMap Manual</a>. + <a href="http://www.pradoframework.net/demos/sqlmap/">SqlMap Manual</a>. </p> <h2 id="140067">Combining SqlMap with Active Records</h2> diff --git a/demos/quickstart/protected/pages/Database/ViewsArUpdate.page b/demos/quickstart/protected/pages/Database/ViewsArUpdate.page index 5dd084c4..2df1d3d7 100644 --- a/demos/quickstart/protected/pages/Database/ViewsArUpdate.page +++ b/demos/quickstart/protected/pages/Database/ViewsArUpdate.page @@ -1,6 +1,6 @@ <com:TContent ID="body" > <h1 id="138046">Views - AR Classes Update</h1> -<com:SinceVersion Version="4.0" /> +<com:SinceVersion Version="3.3" /> <p class="block-content"> Usually when you use <tt>Active Records Classes</tt> to interact with your Data Base you also build some proper views to handle them. To save every element of your views in your Data Base @@ -9,9 +9,9 @@ Thats why Prado offers an automatic mechanism to update your views from your AR Classes and vice versa. </p> -<h2>Updating views from AR Classes</h2> +<h2 id="244034">Updating views from AR Classes</h2> -<p>Instead of assign each attribute in your AR Class to your view controls like this:</p> +<p id="1220005" class="block-content">Instead of assign each attribute in your AR Class to your view controls like this:</p> <com:TTextHighlighter CssClass="source block-content"> $student = AR_Student::finder()->findByPk(1); $this->name->Text = $student->name; @@ -20,7 +20,7 @@ $this->gender->Text = $student->gender; $this->average->Text = $student->average; </com:TTextHighlighter> -<p>You can do the same as follows:</p> +<p id="1220006" class="block-content">You can do the same as follows:</p> <com:TTextHighlighter CssClass="source block-content"> $student = AR_Student::finder()->findByPk(1); @@ -28,8 +28,8 @@ $this->tryToUpdateView($student); </com:TTextHighlighter> -<h2>Updating AR Classes from views</h2> -<p>Instead of assign each attribute in your views to your AR Classes like this:</p> +<h2 id="244035">Updating AR Classes from views</h2> +<p id="1220007" class="block-content">Instead of assign each attribute in your views to your AR Classes like this:</p> <com:TTextHighlighter CssClass="source block-content"> $student = new AR_Student(); $student->name = $this->name->Text; @@ -39,7 +39,7 @@ $student->average = $this->average->Text; $student->save(); </com:TTextHighlighter> -<p>You can do the same as follows:</p> +<p id="1220008" class="block-content">You can do the same as follows:</p> <com:TTextHighlighter CssClass="source block-content"> $student = new AR_Student(); diff --git a/demos/quickstart/protected/pages/Database/id/ActiveRecord.page b/demos/quickstart/protected/pages/Database/id/ActiveRecord.page deleted file mode 100755 index 8e81678e..00000000 --- a/demos/quickstart/protected/pages/Database/id/ActiveRecord.page +++ /dev/null @@ -1,1000 +0,0 @@ -<com:TContent ID="body" > -<h1 id="138046">Rekaman Aktif</h1> -<com:SinceVersion Version="3.1a" /> -<p id="690478" class="block-content">Rekaman Aktif adalah obyek yang melapisi baris dalam tabel atau view database, - melindungi akses database dan menambahkan logika domain pada data tersebut. - Dasar dari Rekaman Aktif adalah kelas bisnis, sebagai contoh, kelas - <tt>Products</tt>, yang hampir menyamai struktur rekaman dari tabel database - dibawahnya. Setiap Rekaman Aktif akan bertanggung jawab atas - penyimpanan dan pengambilan data ke dan dari database. </p> -<div class="info"><b class="note">Info:</b> - Struktur Rekaman Aktif harus sama dengan tabel dalam database. - Setiap kolom tabel harus mempunyai variabel atau properti anggota terkait dalam - kelas Rekaman Aktif yang mewakili tabel. -</div> - -<h2 id="138047">Kapan Menggunakannya</h2> -<p id="690479" class="block-content">Rekaman Aktif adalah pilihan yang baik untuk logika domain yang tidak terlalu rumit, - seperti membuat, membaca, memutakhirkan, dan menghapus. Derivasi dan validasi - didasarkan pada satu rekaman yang bekerja denga baik dalam struktur ini. Rekaman Aktif mempunyai kuntungan utama dalam hal kesederhanaan. Mudah untuk membangun Rekaman Aktif, dan mudah untuk dimengerti.</p> - - <p id="690480" class="block-content">Akan tetapi, seiring dengan perkembangan logika bisnis Anda dalm hal kompleksitas, Anda akan segera ingin menggunakan hubungan langsung obyek Anda, koleksi, turunan, dan seterusnya. Ini tidak mudah diterapkan ke dalam Rekaman Aktif, dan menambahkannya sedikit demi sedikit menjadi sangat kacau. - Argumen lain terhadap Rekaman Aktif adalah kenyataan bahwa ia menyandingkan desin obyek ke desain database. Ini menjadikannya lebih sulit untuk merefraktorisasi karena proyek terus berjalan.</p> - - <p id="690481" class="block-content">Alternatifnya adalah menggunakan Pemeta Data yang yang memisahkan aturan dari obyek bisnis dan bagaimana obyek ini disimpan. - Prado menyediakan pilihan tambahan antara Rekaman Aktif dan - <a href="?page=Database.SqlMap">Pemeta Data SqlMap</a>. - Pemeta Data SqlMap bisa dipakai untuk mengambil obyek Rekaman Aktif, hasilnya; obyek Rekaman Aktif ini bisa dipakai untuk memutakhirkan database. - "Hubungan" antara Rekaman Aktif dan <a href="?page=Database.SqlMap">SqlMap</a> digambarkan dalam diagram berikut. Lebih rinci mengenai Pemeta Data SqlMap dapat ditemukan dalam - <a href="http://www.pradosoft.com/demos/sqlmap/">Manual SqlMap</a>. - <img src=<%~ sqlmap_active_record.png %> alt="Rekaman Aktif dan SqlMap DataMapper" id="fig:diagram.png" class="figure"/> - </p> - - <p id="690482" class="block-content"> - Kelas Rekaman Aktif berfungsi untuk melakukan tugas-tugas berikut. - </p> - <ul id="u1" class="block-content"> - <li>Membuat, Mengambil, Memutakhirkan dan Menghapus rekaman.</li> - <li>Metode pencari untuk melapisi queri SQL yang umum dipakai dan mengemalikan obyek Rekaman Aktif.</li> - <li>Mengambil hubungan (terkait dengan obyek asing) seperti "has many", "has one", "belongs to" dan "has many" melalui asosiasi tabel.</li> - <li>Pengambilan lazy atas hubungan.</li> - </ul> -<h2>Implikasi Desain</h2> -<p> -Implementasi Prado terhadap Rekaman Aktif tidak memelihara identitas referensial. Setiap obyek diperoleh menggunakan Rekaman Aktif pada data dalam database. Sebagai contoh, jika Anda meminta kustomer tertentu dan mendapatkan kembali obyek <tt>Customer</tt>, kali berikutnya Anda meminta kustomer itu, Anda akan kembali mendapatkan turunan lain dari obyek <tt>Customer</tt>. Ini berarti bahwa perbandingan tepat (misalnya menggunakan <tt>===</tt>) akan mengembalikan false, sementara perbandingan bebas (misalnya menggunakan <tt>==</tt>) akan mengembalikan true jika nilai obyek sama menurut perbandingan bebas. -<p> -<p> -Implikasi desain ini terkait dengan pertanyaan berikut. -<i>"Anda pikir kustomer sebagai obyek, di mana hanya satu, -atau Anda pikir obyek yang Anda operasikan sebagai <b>duplikat</b> dari database?"</i> -Pemetaan O/R lain akan mengartikan bahwa hanya ada satu obyek Kustomer dengan custID 100, dan secara literal ia adalah kustomer. -Jika Anda mendapatkan kustomer dan mengubah field-nya, maka Anda sekarang telah mengubah kustomer itu. -<i>"Itu berbatasan dengan: Anda telah mengubah duplikat kustomer ini, tapi bukan pada duplikat itu. -Dan jika dua orang memutakhirkan kustomer pada dua duplikat obyek, siapapun yang memutakhirkan pertama kali, atau mungkin yang terakhir yang menang."</i> [A. Hejlsberg 2003] -</p> - -<h2 id="142010">Database yang Didukung</h2> -<p id="p1" class="block-content"> -Implementasi Rekaman Aktif memanfaatkan kelas <a href="?page=Database.DAO">Prado DAO</a> untuk akses data. -Implementasi Rekaman Aktif saat ini mendukung database sebagai berikut. -</p> -<ul> - <li><a href="http://www.mysql.com">MySQL 4.1 atau lebih tinggi</a></li> - <li><a href="http://www.postgres.com">Postgres SQL 7.3 atau lebih tinggi</a></li> - <li><a href="http://www.sqlite.org">SQLite 2 dan 3</a></li> - <li><a href="#">MS SQL 2000 atau terbaru</a></li> - <li><a href="http://www.oracle.com">Oracle Database (alfa)</a></li> -</ul> -<p id="710009" class="block-content">Dukungan database lain dapat disediakan jika permintaan mencukupi.</p> - -<h1 id="138048">Mendefinisikan Rekaman Aktif</h1> -<p id="690483" class="block-content">Mari kita anggap tabel - "<tt>users</tt>" berikut yang berisi dua kolom bernama "<tt>username</tt>" dan "<tt>email</tt>", - di mana "<tt>username</tt>" juga merupakan kunci primer. -<com:TTextHighlighter Language="sql" CssClass="source block-content" id="code_690147"> -CREATE TABLE users -( - username VARCHAR( 20 ) NOT NULL , - email VARCHAR( 200 ) , - PRIMARY KEY ( username ) -); -</com:TTextHighlighter> -</p> -<p id="690484" class="block-content">Selanjutnya kelas Rekaman Aktif kita yang terkait dengan tabel "<tt>users</tt>". -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690148"> -class UserRecord extends TActiveRecord -{ - const TABLE='users'; //nama tabel - - public $username; //kolom bernama "username" dalam tabel "users" - public $email; - - /** - * @return TActiveRecord active record finder instance - */ - public static function finder($className=__CLASS__) - { - return parent::finder($className); - } -} -</com:TTextHighlighter> -</p> -<p id="690485" class="block-content">Setiap kolom dari tabel "<tt>users</tt>" harus mempunyai properti terkait atas nama yang sama seperti nama kolom dalam kelas <tt>UserRecord</tt>. - Tentunya, Anda juga mendefinisikan variabel atau properti tambahan yang tidak ada dalam struktur tabel. - Konstan kelas - <tt>TABLE</tt> adalah opsional saat nama kelas adalah sama seperti nama tabel dalam database, sebaliknya <tt>TABLE</tt> harus - menetapkan nama tabel yang terkait dengan kelas Rekaman Aktif Anda. -</p> - -<div class="tip"><b class="note">Tip:</b> -Anda dapat menetapkan nama-nama tabel yang memenuhi syarat. Contohnya untuk MySQL, <tt>TABLE = "`database1`.`table1`"</tt>. -</div> - -<p class="block-content" id="ar_as_component"> - Karena <tt>TActiveRecord</tt> memperluas <tt>TComponent</tt>, metode penyetel dan pengambil dapat didefinisikan guna membolehkan kontrol melalui bagaimana variabel disetel dan dikembalikan. Sebagai contoh, menambah properti <tt>$level</tt> untuk menggunakan kelas UserRecord: -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690149"> -class UserRecord extends TActiveRecord { - ... //definisi yang sudah ada seprti di atas - - private $_level; - public function setLevel($value) { - $this->_level=TPropertyValue::ensureInteger($value,0); - } - public function getLevel($value){ - return $this->_level; - } -} -</com:TTextHighlighter> -<p id="710010" class="block-content">Lebih jelas mengenai TComponent dapat ditemukan dalam <a href="?page=Fundamentals.Components1">Dokumentasi komponen</a>. -Nantinya kita harus dapat menggunakan pengambil/penyetel guna membolehkan pengambilan malas atas obyek yang berhubungan. -</p> - -<div class="info"><b class="note">Info:</b> -<tt>TActiveRecord</tt> juga dapat bekerja dengan view database dengan menetapkan konstan <tt>TABLE</tt> terkait ke nama view. Akan tetapi, -obyek yang dikembalikan dari view hanya-baca, memanggil metode -<tt>save()</tt> atau <tt>delete()</tt> akan memunculkan eksepsi. -</div> - -<p id="690486" class="block-content"> - Metode statis <tt>finder()</tt> mengembalilkan turunan <tt>UserRecord</tt> - yang dapat dipakai untuk mengambil rekaman dari database. Pengambilan rekaman menggunakan metode finder akan didiskusikan nanti. Metode statis <tt>TActiveRecord::finder()</tt> mengambil nama kelas Rekaman Aktif sebagai parameter. -</p> - -<h2 id="138049">Menyiapkan koneksi database</h2> -<p id="690487" class="block-content"> - Koneksi database standar untuk Rekaman Aktif dapat disetel sebagai berikut. - Lihat <a href="?page=Database.DAO">Menetapkan Koneksi Database</a> untuk - rincian lebih jauh mengenai pembuatan koneksi database secara umum. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690150"> -//buat koneksi dan berikan kepada manajer Rekaman Aktif. -$dsn = 'pgsql:host=localhost;dbname=test'; //Postgres SQL -$conn = new TDbConnection($dsn, 'dbuser','dbpass'); -TActiveRecordManager::getInstance()->setDbConnection($conn); -</com:TTextHighlighter> - -<p id="710011" class="block-content">Alternatifnya, Anda dapat membuat basis kelas dan mengganti metode <tt>getDbConnection()</tt> untuk mengembalikan -koneksi database. Ini adalah cara sederhana untuk mengijinkan koneksi database multipel. Kode berikut mendemonstrasikan penetapan koneksi database dalam sebuah basis kelas (tidak perlu menyetel koneksi DB di manapun juga). -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class MyDb1Record extends TActiveRecord -{ - public function getDbConnection() - { - static $conn; - if($conn===null) - $conn = new TDbConnection('xxx','yyy','zzz'); - return $conn; - } -} -class MyDb2Record extends TActiveRecord -{ - public function getDbConnection() - { - static $conn; - if($conn===null) - $conn = new TDbConnection('aaa','bbb','ccc'); - return $conn; - } -} -</com:TTextHighlighter> - - -<h3 class="prado-specific">Menggunakan <tt>application.xml</tt> di dalam Kerangka Kerja Prado</h3> -<div class="prado-specific"> -<p id="690488" class="block-content"> - Koneksi database standar dapat juga dikonfigurasi menggunakan tag <tt><module></tt> dalam <a href="?page=Configurations.AppConfig">application.xml</a> - atau <a href="?page=Configurations.PageConfig">config.xml</a> seperti berikut. -<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_690151"> -<modules> - <module class="System.Data.ActiveRecord.TActiveRecordConfig" EnableCache="true"> - <database ConnectionString="pgsql:host=localhost;dbname=test" - Username="dbuser" Password="dbpass" /> - </module> -</modules> -</com:TTextHighlighter> -<div class="tip"><b class="note">Tip:</b> - Atribut <tt>EnableCache</tt> ketika disetel ke "true" akan melakukan cache meta data tabel, yakni nama kolom tabel, indeks dan batasan yang disimpan dalam cache dan dipakai ulang. Anda harus membersihkan atau mematikan cache jika Anda ingin melihat perubahan terhadap definisi tabel Anda. <a href="?page=Advanced.Performance#6402">Modul cache</a> juga harus didefinisikan agar cache berfungsi. -</div> -</p> - -<p id="690489" class="block-content">Properti <tt>ConnectionID</tt> dapat ditetapkan dengan nilai yang terkait ke nilai ID konfigurasi modul <tt>TDataSourceConfig</tt> lain. Ini membolehkan koneksi database yang sama untuk dipakai dalam modul lainnya seperti <a href="?page=Database.SqlMap">SqlMap</a>. -<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_690152"> -<modules> - <module class="System.Data.TDataSourceConfig" id="db1"> - <database ConnectionString="pgsql:host=localhost;dbname=test" - Username="dbuser" Password="dbpass" /> - </module> - - <module class="System.Data.ActiveRecord.TActiveRecordConfig" - ConnectionID="db1" EnableCache="true" /> - - <module class="System.Data.SqlMap.TSqlMapConfig" - ConnectionID="db1" ... /> -</modules> -</com:TTextHighlighter> -</p> -</div> - -<h2 id="138050">Mengambil data dari database</h2> -<p id="690490" class="block-content"> - Kelas <tt>TActiveRecord</tt> menyediakan banyak metode yang sesuai untuk mencari rekaman dari database. Yang paling sederhana adalah mencari satu rekaman yang sama dengan kunci primer atau kunci komposit (kunci primer yang terdiri dari multipel kolom). - Lihat <com:DocLink ClassPath="System.Data.ActiveRecord.TActiveRecord" /> untuk lebih jelasnya. -</p> - -<div class="info"><b class="note">Info:</b> -Semua metode finder yang dapat mengembalikan hanya 1 rekaman akan mengembalikan <tt>null</tt> jika tidak ada data yang sama yang ditemukan. Semua metode finder yang mengembalikan array rekaman akan mengembalikan array kosong jika tidak ada data yang ditemukan. -</div> - - <h3 id="138055"><tt>findByPk()</tt></h3> - <p id="690491" class="block-content">Mencari satu rekaman hanya menggunakan kunci primer atau kunci gabungan. -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690153"> -$finder = UserRecord::finder(); -$user = $finder->findByPk($primaryKey); - -//ketika tabel menggunakan kunci gabungan -$record = $finder->findByPk($key1, $key2, ...); -$record = $finder->findByPk(array($key1, $key2,...)); -</com:TTextHighlighter> -</p> - - <h3 id="138056"><tt>findAllByPks()</tt></h3> - <p id="690492" class="block-content">Mencari multipel rekaman menggunakan sebuah daftar kunci primer atau kunci gabungan. -Berikut adalah persamaan untuk kunci primer (kunci primer terdiri dari hanya satu kolom/field). -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690154"> -$finder = UserRecord::finder(); -$users = $finder->findAllByPks($key1, $key2, ...); -$users = $finder->findAllByPks(array($key1, $key2, ...)); -</com:TTextHighlighter> -Berikut adalah persamaan untuk kunci gabungan. -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690155"> -//ketika tabel menggunakan kunci gabungan -$record = $finder->findAllByPks(array($key1, $key2), array($key3, $key4), ...); - -$keys = array( array($key1, $key2), array($key3, $key4), ... ); -$record = $finder->findAllByPks($keys); -</com:TTextHighlighter> - - -<h3 id="138057"><tt>find()</tt></h3> -<p id="690493" class="block-content">Mencari <b>satu rekaman tunggal</b> yang memenuhi kriteria. Kriteria dapat berupa bagian string SQL atau obyek <tt>TActiveRecordCriteria</tt>.</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690156"> -$finder = UserRecord::finder(); - -//:name dan :pass adalah tempat untuk nilai $name dan $pass tertentu -$finder->find('username = :name AND password = :pass', - array(':name'=>$name, ':pass'=>$pass)); - -//menggunakan tempat posisi -$finder->find('username = ? AND password = ?', array($name, $pass)); -//same as above -$finder->find('username = ? AND password = ?', $name, $pass); - -//$criteria adalah TActiveRecordCriteria -$finder->find($criteria); //the 2nd parameter for find() is ignored. -</com:TTextHighlighter> - -<p id="690494" class="block-content">Kelas <tt>TActiveRecordCriteria</tt> mempunyai properti sebagai berikut: -</p> - <ul id="u2" class="block-content"> - <li><tt>Parameters</tt> -- pasangan parameter nama nilai.</li> - <li><tt>OrdersBy</tt> -- pasangan nama kolom dan urutan.</li> - <li><tt>Condition</tt> -- bagian dari kondisi SQL WHERE.</li> - <li><tt>Limit</tt> -- jumlah maksimum rekaman diambil.</li> - <li><tt>Offset</tt> -- ofset rekaman dalam tabel.</li> - </ul> - -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690157"> -$criteria = new TActiveRecordCriteria; -$criteria->Condition = 'username = :name AND password = :pass'; -$criteria->Parameters[':name'] = 'admin'; -$criteria->Parameters[':pass'] = 'prado'; -$criteria->OrdersBy['level'] = 'desc'; -$criteria->OrdersBy['name'] = 'asc'; -$criteria->Limit = 10; -$criteria->Offset = 20; -</com:TTextHighlighter> - -<div class="note"><b class="note">Catatan:</b> -Untuk MSSQL dan saat <tt>Limit</tt> serta <tt>Offset</tt> berisi nilai integer positif. Query aktual yang dijalankan diubah oleh kelas -<com:DocLink ClassPath="System.Data.ActiveRecord.Common.Mssql.TMssqlCommandBuilder" -Text="TMssqlCommandBuilder" -/> -berdasarkan pada -<a href="http://troels.arvin.dk/db/rdbms/#select-limit-offset">http://troels.arvin.dk/db/rdbms/</a> -untuk mengemulasikan kondisi <tt>Limit</tt> dan <tt>Offset</tt>. -</div> - -<h3 id="138058"><tt>findAll()</tt></h3> -<p id="690495" class="block-content">Sama seperti <tt>find()</tt> tapi mengembalikan array obyek.</p> - -<h3 id="138059"><tt>findBy*()</tt> dan <tt>findAllBy*()</tt></h3> -<p id="690496" class="block-content">Metode find dinamis menggunakan bagian dari nama metode sebagai kriteria pencarian. -Nama metode dimulai dengan <tt>findBy</tt> mengembalikan hanya 1 rekaman dan nama metode yang dimulai dengan <tt>findAllBy</tt> mengembalikan array rekaman. -Kondisi diambil sebagai bagian dari nama metode setelah <tt>findBy</tt> atau <tt>findAllBy</tt>. - -Blok kode berikut adalah sama: -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690158"> -$finder->findByName($name) -$finder->find('Name = ?', $name); -</com:TTextHighlighter> - -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690159"> -$finder->findByUsernameAndPassword($name,$pass); -$finder->findBy_Username_And_Password($name,$pass); -$finder->find('Username = ? AND Password = ?', $name, $pass); -</com:TTextHighlighter> - -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690160"> -$finder->findAllByAge($age); -$finder->findAll('Age = ?', $age); -</com:TTextHighlighter> - -<div class="tip"><b class="note">Tip:</b> -Anda juga dapat menggunakan kombinasi <tt>AND</tt> dan <tt>OR</tt> sebagai kondisi dalam metode dinamis. -</div> - -<h3 id="138060"><tt>findBySql()</tt> dan <tt>findAllBySql()</tt></h3> -<p id="690497" class="block-content">Mencari rekaman menggunakan SQL penuh di mana <tt>findBySql()</tt> mengembalikan Rekaman Aktif dan <tt>findAllBySql()</tt>mengembalikan array obyek rekaman. -Untuk setiap kolom yang dikembalikan, kelas Rekaman Aktif terkait harus mendefinisikan variabel atau properti untuk setiap nama kolom terkait. -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class UserRecord2 extends UserRecord -{ - public $another_value; -} -$sql = "SELECT users.*, 'hello' as another_value FROM users"; -$users = TActiveRecord::finder('UserRecord2')->findAllBySql($sql); -</com:TTextHighlighter> -</p> -<h3 id="138061"><tt>count()</tt></h3> -<p id="690498" class="block-content">Mencari jumlah rekaman yang sama, menerima beberapa parameters seperti metode <tt>findAll()</tt>.</p> - -<h2 id="138051">Menyisipkan dan memutakhirkan rekaman</h2> -<p id="690499" class="block-content"> -Menambah rekaman baru menggunakan TActiveRecord sangat sederhana, cukup buat obyek Rekaman Aktif baru dan panggil metode <tt>save()</tt>. Misalnya -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690161"> -$user1 = new UserRecord(); -$user1->username = "admin"; -$user1->email = "admin@example.com"; -$user1->save(); //sisipkan rekaman baru - -$data = array('username'=>'admin', 'email'=>'admin@example.com'); -$user2 = new UserRecord($data); //buat dengan mengirimkan beberapa data yang sudah ada -$user2->save(); //sisipkan rekaman baru -</com:TTextHighlighter> -<div class="tip"><b class="note">Tip:</b> -Obyek dimutakhirkan dengan kunci primer dari tabel itu yang berisi definisi yang secara otomatis membuat kunci primer untuk rekaman yang baru saja disisipkan. -Sebagai contoh, jika Anda menyisipkan sebuah rekaman baru ke dalam tabel MySQL yang kolomnya didefinisikan dengan "autoincrement", obyek Rekaman Aktif akan dimutakhirkan dengan nilai yang ditambahkan.</div> - -<p id="690500" class="block-content"> -Untuk memutakhirkan rekaman dalam database, cukup ubah satu atau lebih properti obyek Rekaman Aktif yang sudah diambil dari database dan kemudian panggil metode <tt>save()</tt>. - -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690162"> -$user = UserRecord::finder()->findByName('admin'); -$user->email="test@example.com"; //ubah properti -$user->save(); //mutakhirkan. -</com:TTextHighlighter> -</p> - -<p id="710012" class="block-content"> -Obyek Rekaman Aktif mempunyai masa-hidup sederhana seperti digambarkan dalam diagram berikut. -</p> -<img src=<%~ object_states.png %> alt="Active Records Life Cycle" id="fig:cycle.png" class="figure"/> -<p id="690501" class="block-content"> -Kita melihat bahwa obyek TActiveRecord baru dibuat dengan menggunakan salah satu metode <tt>find*()</tt> ataupun membuat turunan baru dengan menggunakan kata kunci PHP <tt>new</tt>. Obyek yang dibuat dengan metode <tt>find*()</tt> dimulai dengan kondisi <tt>clean</tt>. Turunan baru TActiveRecord membuat selain metode <tt>find*()</tt> yang dimulai dengan kondisi <tt>new</tt>. -Kapan saja Anda memanggil metode <tt>save()</tt> pada obyek TActiveRecord, obyek memasuki keadaan <tt>clean</tt>. Obyek dalam <tt>clean</tt> menjadi <tt>dirty</tt> ketika satu atau lebih keadaan internalnya diubah. Pemanggilan metode <tt>delete()</tt> pada obyek mengakhiri masa-hidup obyek, tidak ada aksi lanjutan yang dilakukan pada obyek. -</p> - -<h2 id="138052">Menghapus rekaman yang sudah ada</h2> -<p id="690502" class="block-content"> - Untuk menghapus rekaman yang sudah ada dan diambil, cukup panggil metode <tt>delete()</tt>. - Anda juga dapat menghapus rekaman dalam database dengan kunci primer tanpa mengambil rekaman apapun menggunakan metode <tt>deleteByPk()</tt> (dan metode yang sama <tt>deleteAllByPks()</tt>). - Sebagai contoh, untuk menghapus satu atau beberapa rekaman dengan menggunakan satu atau lebih kunci primer. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690163"> -$finder->deleteByPk($primaryKey); //hapus 1 rekaman -$finder->deleteAllByPks($key1,$key2,...); //hapus multipel rekaman -$finder->deleteAllByPks(array($key1,$key2,...)); //hapus multipel rekaman -</com:TTextHighlighter> - -<p id="690503" class="block-content"> -Untuk kunci gabungan (ditentukan secara otomatis dari definisi tabel): -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690164"> -$finder->deleteByPk(array($key1,$key2)); //hapus 1 rekaman - -//hapus multipel rekaman -$finder->deleteAllByPks(array($key1,$key2), array($key3,$key4),...); - -//hapus multipel rekaman -$finder->deleteAllByPks(array( array($key1,$key2), array($key3,$key4), .. )); -</com:TTextHighlighter> - -<h3 id="138052a"><tt>deleteAll()</tt> dan <tt>deleteBy*()</tt></h3> -<p id="690502a" class="block-content"> -Untuk menghapus dengan kriteria, gunakan <tt>deleteAll($criteria)</tt> dan <tt>deleteBy*()</tt> -yang sintaksnya mirip dengan <tt>findAll($criteria)</tt> dan <tt>findAllBy*()</tt> seperti dijelaskan di atas. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690163a"> -//hapus semua rekaman dengan Name yang sama -$finder->deleteAll('Name = ?', $name); -$finder->deleteByName($name); - -//hapus dengan username dan password -$finder->deleteBy_Username_And_Password($name,$pass); -</com:TTextHighlighter> - -<h2 id="138053">Transaksi</h2> -<p id="690504" class="block-content">Semua obyek Rekaman Aktif berisi properti <tt>DbConnection</tt> yang dapat dipakai untuk mendapatkan obyek transaksi. -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690165"> -$finder = UserRecord::finder(); -$finder->DbConnection->Active=true; //buka bila perlu -$transaction = $finder->DbConnection->beginTransaction(); -try -{ - $user = $finder->findByPk('admin'); - $user->email = 'test@example.com'; //ubah obyek $user - $user->save(); - $transaction->commit(); -} -catch(Exception $e) // eksepsi dimunculkan jika query gagal -{ - $transaction->rollBack(); -} -</com:TTextHighlighter> - -<h2 id="142011">Event</h2> -<p id="710013" class="block-content"> -TActiveRecord menawarkan dua event, <tt>OnCreateCommand</tt> dan <tt>OnExecuteCommand</tt>. -</p> - -<p id="710014" class="block-content">Event <tt>OnCreateCommand</tt> dimunculkan ketika perintah disiapkan dan penyatuan parameter lengkap. Obyek parameter adalah <tt>TDataGatewayEventParameter</tt> di mana properti -<tt>Command</tt> bisa diperiksa agar SQL query dijalankan. -</p> - -<p id="710015" class="block-content"> -Event <tt>OnExecuteCommand</tt> dimunculkan ketika perintah dijalankan dan hasil dari database dikembalikan. Obyek parameter <tt>TDataGatewayResultEventParameter</tt> -dari properti <tt>Result</tt> berisi data yang dikembalikan dari database. -Data yang dikembalikan dapat diubah dengan setelan properti <tt>Result</tt>. -</p> - -<h3 id="142016">Contoh Pencatatan</h3> -<p id="710016" class="block-content">Menggunakan <tt>OnExecuteCommand</tt> kita dapat menempelkan pengendali event untuk mencatat seluruh query SQL yang dijalankan untuk kelas TActiveRecord atau turunan yang diberikan. Sebagai contoh, kita mendefinisikan sebuah basis kelas dan mengganti <tt>getDbConnection()</tt> atau konstruktornya. -</p> - -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class MyDb1Record extends TActiveRecord -{ - public function getDbConnection() - { - static $conn; - if($conn===null) - { - $conn = new TDbConnection('xxx','yyy','zzz'); - $this->OnExecuteCommand[] = array($this,'logger'); - } - return $conn; - } - public function logger($sender,$param) - { - var_dump($param->Command->Text); - } -} -//alternatifnya sebagai per turunan dari per obyek finder -function logger($sender,$param) -{ - var_dump($param->Command->Text); -} -TActiveRecord::finder('MyRecord')->OnExecuteCommand[] = 'logger'; -$obj->OnExecuteCommand[] = array($logger, 'log'); //setiap PHP callback yg benar. -</com:TTextHighlighter> - -<h1 id="ar_relations">Hubungan Rekaman Aktif</h1> -<com:SinceVersion Version="3.1rc1" /> -<p id="690504a" class="block-content"> -Implementasi Rekaman Aktif Prado mendukung pemetaan kunci asing untuk database -yang mendukung batasan kunci asing. Agar hubungan Rekaman Aktif berfungsi, database di bawahnya harus mendukung batasan kunci asing (misalnya MySQL menggunakan InnoDB). -</p> - -<p id="710017" class="block-content"> -Dalam bagian berikut kita akan menganggap hubungan tabel antara -<tt>Teams</tt>, <tt>Players</tt>, <tt>Skills</tt> dan <tt>Profiles</tt>. -</p> -<img src=<%~ ar_relations.png %> class="figure" /> - - -<p id="710018" class="block-content">Tujuannya adalah untuk mendapatkan model obyek yang mewakili ke beberapa derajat hubungan entitas dalam gambar di atas. -</p> - -<img src=<%~ ar_objects.png %> class="figure" /> - -<p class="block-content"> -Ada ketidak cocokan antara hubungan dengan obyek dan hubungan tabel. Pertama, ada perbedaan dalam penyajian. Penghubung kendali obyek dengen menyimpan referensi yang dipegang oleh lingkungan memori-teratur runtime. Database relasional menangani kaitan dengan membentuk sebuah kunci ke dalam tabel lainnya. Keuda, obyek dapat dengan mudah menggunakan koleksi guna menangani multipel referensi dari satu field, sementara normalisasi memaksa seluruh relasi entitas mengaitkan ke nilai tunggal. Ini menyebabkan pembalikan struktur data antara obyek dan tabel. Pendekatan yang diambil dalam desain Rekaman Aktif Prado adalah untuk menggunakan batasan kunci asing guna memperoleh hubungan obyek. Ini berarti bahwa database di bawahnya harus mendukung batasan kunci asing. -</p> -<div class="tip"><b class="note">Tip:</b> -Untuk database SQLite, Anda dapat membuat tabel yang mendefinisikan batasan kunci asing seperti contoh di bawah ini. Akan tetapi, batasan ini <b>TIDAK</b> -dipaksakan oleh database SQLite itu sendiri. -<com:TTextHighlighter Language="sql" CssClass="source block-content"> -CREATE TABLE foo -( - id INTEGER NOT NULL PRIMARY KEY, - id2 CHAR(2) -); -CREATE TABLE bar -( - id INTEGER NOT NULL PRIMARY KEY, - foo_id INTEGER - CONSTRAINT fk_foo_id REFERENCES foo(id) ON DELETE CASCADE -); -</com:TTextHighlighter> -</div> - -<h2 id="142012">Pemetaan Kunci Asing</h2> -<p class="block-content">Hubungan entitas antara tabel <tt>Teams</tt> dan <tt>Players</tt> adalah apa yang dikenal sebagai hubungan 1-M. Yaitu, satu Tim dapat berisi 0 atau lebih Pemain. Dalam batasan hubungan obyek, kita katakan bahwa obyek <tt>TeamRecord</tt> <b>memiliki banyak</b> obyek <tt>PlayerRecord</tt>. -(Perhatikan kebalikan dari arah hubungan antara tabel dan obyek.) -<p id="710019" class="block-content"> - -<h3 id="142017">Hubungan Has Many</h3> -<p id="710020" class="block-content"> -Kita membuat model obyek <tt>Team</tt> sebagai kelas Rekaman Aktif berikut. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class TeamRecord extends TActiveRecord -{ - const TABLE='Teams'; - public $name; - public $location; - - public $players=array(); // deklarasi ini tidak diperlukan lagi sejak v3.1.2 - - //mendefinisikan anggota $player yang memiliki hubungan banyak dengan PlayerRecord - public static $RELATIONS=array - ( - 'players' => array(self::HAS_MANY, 'PlayerRecord', 'team_name'), - ); - - public static function finder($className=__CLASS__) - { - return parent::finder($className); - } -} -</com:TTextHighlighter> -<p id="710021" class="block-content"> -Properti statis <tt>$RELATIONS</tt> dari <tt>TeamRecord</tt> mendefinisikan bahwa properti <tt>$players</tt> <b>has many</b> <tt>PlayerRecord</tt>. Multipel hubungan dibolehkan dengan mendefinisikan setiap hubungan dengan sebuah entitas dalam array <tt>$RELATIONS</tt> di mana kunci array untuk entri menunjukan nama properti. -Dalam <tt>array(self::HAS_MANY, 'PlayerRecord')</tt>, elemen pertama mendefinisikan tipe hubungan, tipe yang benar adalah <tt>self::HAS_MANY</tt>, -<tt>self::HAS_ONE</tt> dan <tt>self::BELONGS_TO</tt>. -Elemen kedua adalah string <tt>'PlayerRecord'</tt> yang menunjukan nama kelas dari kelas <tt>PlayerRecord</tt>. -</p> - -<div class="note"><b class="note">Catatan:</b> -Seperti dijelaska dalam komentar kode di atas, sejak versi <b>3.1.2</b>, properti terkait tidak tidak lagi perlu dideklarasikan secara eksplisit. Standarnya, akan secara implisit dideklarasikan berdasarkan pada kunci array <tt>$RELATIONS</tt>. Keuntungan utama atas properti terkait yang dideklarasikan secara implisit adalah obyek terkait dapat diambil secara otomatis dengan cara malas. Sebagai contoh, anggap kita mempunyai <tt>TeamRecord</tt> turunan <tt>$team</tt>. Kita dapat mengakses players via <tt>$team->players</tt>, -meskipun kita tidak pernah menerbitkan perintah mengambil untuk players. Jika <tt>$players</tt> dideklarasikan secara eksplisit, kita harus menggunakan pendekatan <tt>with</tt> seperti dijelaskan dalam contoh berikut untuk mengambil rekaman player. -</div> - -<p id="710022" class="block-content"> -Batasan kunci asing tabel <tt>Players</tt> dipakai untuk menentukan nama kunci tabel <tt>Teams</tt> terkait. Ini dikerjakan secara otomatis, ditangani dalam Rekaman Aktif dengan memeriksa definisi tabel <tt>Players</tt> dan <tt>Teams</tt>. -</p> - -<div class="info"><b class="note">Info:</b> -Sejak versi <b>3.1.2</b>, Rekaman Aktif mendukung multipel referensi kunci asing pada tabel yang sama. Kerancuan diantara multipel referensi kunci asing dipecahkan dengan penyediaan nama kolom kunci asing sebagai parameter ke-3 dalam array relationship. -Sebagai contoh, kedua kunci asing <tt>owner_id</tt> dan <tt>reporter_id</tt> -merujuk tabel yang sama, didefinisikan dalam <tt>UserRecord</tt>. -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class TicketRecord extends TActiveRecord -{ - public $owner_id; - public $reporter_id; - - public $owner; // deklarasi ini tidak diperlukan lagi sejak v3.1.2 - public $reporter; // deklarasi ini tidak diperlukan lagi sejak v3.1.2 - - public static $RELATION=array - ( - 'owner' => array(self::BELONGS_TO, 'UserRecord', 'owner_id'), - 'reporter' => array(self::BELONGS_TO, 'UserRecord', 'reporter_id'), - ); -} -</com:TTextHighlighter> -Ini berlaku untuk hubungan termasuk <tt>BELONGS_TO</tt>, <tt>HAS_ONE</tt> dan -<tt>HAS_MANY</tt>. Lihat seksi <a href="#142021">Tabel Asosiaasi Merujuk Dirinya Sendiri</a> untuk memecahkan kerancuan atas hubungan <tt>MANY_TO_MANY</tt>. -</div> - -<p id="710023" class="block-content">Hubungan "has many" tidak diambil secara otomatis ketika Anda menggunakan salah satu metode finder Rekaman Aktif. -Anda perlu untuk mengambil secara eksplisit obyek terkait seperti berikut. Dalam kode di bawah ini, kedua baris adalah sama dan nama metode tidak sensitif huruf. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -$team = TeamRecord::finder()->withPlayers()->findAll(); -$team = TeamRecord::finder()->with_players()->findAll(); //equivalent -</com:TTextHighlighter> -<p id="710024" class="block-content"> -Metode <tt>with_xxx()</tt> (di mana <tt>xxx</tt> adalah nama properti hubungan, dalam hal ini, <tt>players</tt>) mengambil PlayerRecords terkait menggunakan query kedua (bukan menggunakan join). <tt>with_xxx()</tt> menerima argumen yang sama seperti metode finder lainnya dari TActiveRecord, misalnya <tt>with_players('age = ?', 35)</tt>. -</p> - -<div class="note"><b class="note">Catatan:</b> -Penting untuk dimengerti bahwa obyek terkait diambil menggunakan query tambahan. Query pertama mengambil obyek sumber, misalnya <tt>TeamRecord</tt> dalam contoh kode di atas. -Query kedua dipakai untuk mengambil obyek <tt>PlayerRecord</tt> terkait. -Penggunaan dua query mirip dengan query tunggal menggunakan Left-Outer join dengan eksepsi bahwa hasil null pada tabel kanan tidak dikembalikan. Konsekuensi pemakaian dua tau lebih query adalah kondisi agregat dan join tidak layak menggunakan Rekaman Aktif. Untuk query di luar lingkup Rekaman Aktif, <a href="?page=Database.SqlMap">Pemeta Data SqlMap</a> diapat dupertimbangkan. -</div> - -<div class="info"><b class="info">Info:</b> -Pendekatan <tt>with</tt> di atas juga bekerja dengan properti terkait yang dideklarasikan secara implisit (diperkenalkan dalam versi 3.1.2). Lalu apa perbedaan antara pendekatan <tt>with</tt> dan pendekatan pengambilan malas? Pengambilan malas berarti kita menerbitkan query SQL jika obyek terkait awalnya diakses dan tidak siap, -sementara query pendekatan <tt>with</tt> untuk obyek terkait sekaligus, tida peduli obyek terkait diakses atau tidak. Pendekatan pengambilan malas sangat cocok karena kita tidak perlu secara eksplisit mengambil obyek terkait, sementara pendekatan <tt>with</tt> lebih efisien jika multipel rekaman yang dikembalikan, masing-masing dengan beberapa obyek terkait. -</div> - -<h3 id="142018">Hubungan Belongs To</h3> -<p id="710025" class="block-content">Hubungan "has many" dalam bagian di atas mendefinisikan koleksi obyek asing. Dalam keadaan tertentu, kita mempunyai <tt>TeamRecord</tt> memiliki banyak (nol atau lebih) obyek <tt>PlayerRecord</tt>. Kita juga dapat menambah penunjuk kembali dengan menambahkan properti dalam kelas <tt>PlayerRecord</tt> yang mengaitkan kembali ke obyek <tt>TeamRecord</tt>, secara efektif membuat asosiasi dua arah. -Kita katakan bahwa properti <tt>$team</tt> dalam kelas <tt>PlayerRecord</tt> <tt>belongs to</tt> obyek <tt>TeamRecord</tt>. -Kode berikut mendefinisikan kelas <tt>PlayerRecord</tt> lengkap dengan 3 hubungan. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class PlayerRecord extends TActiveRecord -{ - const TABLE='Players'; - public $player_id; - public $age; - public $team_name; - - public $team; // deklarasi ini tidak diperlukan lagi sejak v3.1.2 - public $skills=array(); // deklarasi ini tidak diperlukan lagi sejak v3.1.2 - public $profile; // deklarasi ini tidak diperlukan lagi sejak v3.1.2 - - public static $RELATIONS=array - ( - 'team' => array(self::BELONGS_TO, 'TeamRecord', 'team_name'), - 'skills' => array(self::MANY_TO_MANY, 'SkillRecord', 'Player_Skills'), - 'profile' => array(self::HAS_ONE, 'ProfileRecord', 'player_id'), - ); - - public static function finder($className=__CLASS__) - { - return parent::finder($className); - } -} -</com:TTextHighlighter> -<p id="710026" class="block-content"> -Properti <tt>$RELATIONS</tt> dari <tt>PlayerRecord</tt> mendefinisikan properti <tt>$team</tt> <b>milik</b> <tt>TeamRecord</tt>. -Array <tt>$RELATIONS</tt> juga mendefinisikan dua hubungan lainnya yang nanti akan kita uji dalam seksi di bawah ini. -Dalam <tt>array(self::BELONGS_TO, 'TeamRecord')</tt>, elemen pertama mendefinisikan tipe hubungan, dalam hal ini <strong><tt>self::BELONGS_TO</tt></strong> dan -elemen kedua adalah string <tt>'TeamRecord'</tt> yang terkait ke nama kelas dari kelas <tt>TeamRecord</tt>. -Obyek pemain dengan obyek tim terkait dapat diambil serperti berikut. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -$players = PlayerRecord::finder()->with_team()->findAll(); -</com:TTextHighlighter> - -<p id="710027" class="block-content"> - Metode <tt>with_xxx()</tt> (di mana <tt>xxx</tt> adalah nama properti hubungan dalam hal ini, <tt>team</tt>) mengambil <tt>TeamRecords</tt> terkait menggunakan query kedua (bukan menggunakan join). <tt>with_xxx()</tt> menerima argumen yang sama seperti metode finder lainnya dari <tt>TActiveRecord</tt>, contohnya <tt>with_team('location = ?', 'Madrid')</tt>. -</p> - -<div class="tip"><b class="note">Tip:</b> -Hubungan tambahan dapat diambil dengan mengaitkan <tt>with_xxx()</tt> bersama seperti yang didemonstrasikan berikut. -<com:TTextHighlighter Language="php" CssClass="source block-content"> -$players = PlayerRecord::finder()->with_team()->with_skills()->findAll(); -</com:TTextHighlighter> -Setiap metode <tt>with_xxx()</tt> akan menjalankan query SQL tambahan. Setiap <tt>with_xxx()</tt> menerima argumen mirip dengan apa yang ada di dalam metode <tt>findAll()</tt> dan hanya diterapkan ke query hubungan tertentu tersebut. -</div> - -<p id="710028" class="block-content">Hubungan "belongs to" dari kelas <tt>ProfileRecord</tt> didefinisikan hampir sama.</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class ProfileRecord extends TActiveRecord -{ - const TABLE='Profiles'; - public $player_id; - public $salary; - - public $player; // deklarasi ini tidak diperlukan lagi sejak v3.1.2 - - public static $RELATIONS=array - ( - 'player' => array(self::BELONGS_TO, 'PlayerRecord'), - ); - - public static function finder($className=__CLASS__) - { - return parent::finder($className); - } -} -</com:TTextHighlighter> - -<p id="710029" class="block-content">Intinya, ada hubungan "<b>belongs to</b>" untuk obyek yang mengaitkan entitas yang memmpunyai kolom yakni kunci asing. Dalam keadaan tertentu, kita melihat bahwa tabel <tt>Profiles</tt> mempunyai batasan kunci asing pada kolom <tt>player_id</tt> yang terkait ke tabel -<tt>Players</tt> kolom <tt>player_id</tt>. Selanjutnya, obyek <tt>ProfileRecord</tt> -memiliki properti (<tt>$player</tt>) yang adalah <b>milik</b> obyek <tt>PlayerRecord</tt>. -Demikian juga, tabel <tt>Players</tt> mempunyai batasan kunci asing pada kolom <tt>team_name</tt> yang terkait ke tabel <tt>Teams</tt> kolom <tt>name</tt>. -Kemudian, obyek <tt>PlayerRecord</tt> mempunyai properti (<tt>$team</tt>) yang adalah <b>milik</b> obyek <tt>TeamRecord</tt>. -</p> - -<h3 id="142019">Hubungan Has One</h3> -<p id="710030" class="block-content">Hubungan entitas antara <tt>Players</tt> dan <tt>Profiles</tt> adalah satu ke satu. Yaitu, setiap obyek -<tt>PlayerRecord</tt> <b>has one</b> obyek <tt>ProfileRecord</tt> (mungkin tidak ada atau null). -Hubungan <b>has one</b> hampir identik ke hubungan <b>has many</b> dengan eksepsi bahwa obyek terkait hanya satu obyek (bukan koleksi obyek). -</p> - -<h3 id="142020">Hubungan Leluhur Anak</h3> -<p id="710031" class="block-content">Hubungan leluhur anak bisa didefinisikan menggunakan kombinasi hubungan <tt>has many</tt> dan <tt>belongs to</tt> yang -merujuk ke kelas yang sama. Contoh berikut memperlihatkan hubungan leluhur dan anaknya antara "kategori" dan "leluhur kategori". -</p> - -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class Category extends TActiveRecord -{ - public $cat_id; - public $category_name; - public $parent_cat_id; - - public $parent_category; // deklarasi ini tidak diperlukan lagi sejak v3.1.2 - public $child_categories=array(); // deklarasi ini tidak diperlukan lagi sejak v3.1.2 - - public static $RELATIONS=array - ( - 'parent_category' => array(self::BELONGS_TO, 'Category', 'parent_cat_id'), - 'child_categories' => array(self::HAS_MANY, 'Category', 'parent_cat_id'), - ); -} -</com:TTextHighlighter> - -<h3>Kriteria Query untuk Obyek Terkait</h3> -<p> -Dalam contoh di atas, kami memperlihatkan bahwa obyek Rekaman Aktif dapat mereferensi ke obyek terkaitnya sendiri dengan -mendeklarasikan anggota kelas statis $RELATIONS yang menetapkan sebuah daftar relasi. Setiap relasi -ditetapkan sebagai array yang terdiri dari tiga elemen: tipe relasi, nama kelas AR terkait, -dan kunci asing. Sebagai contoh, kami menggunakan <tt>array(self::HAS_MANY, 'PlayerRecord', 'team_name')</tt> -untuk menetapkan pemain dalam sebuah tim. Ada dua elemen opsional berikutnya yang dapat ditetapkan -dalam array ini: kondisi query (elemen keempat) dan parameters (elemen kelima). -Elemen tersebut dipakai untuk mengontrol bagaimana untuk melakukan query terhadap obyek terkait. Sebagai contoh, jika kita ingin memperoleh -para pemain yang diurut dengan usianya, kita dapat menetapkan <tt>array(self::HAS_MANY, 'PlayerRecord', 'team_name', 'ORDER BY age')</tt>. -Jika kita ingin mendapatkan para pemain yang usianya kurang dari 30, kita dapat menggunakan -<tt>array(self::HAS_MANY, 'PlayerRecord', 'team_name', 'age<:age', array(':age'=>30))</tt>. Secara umum, -dua elemen tambahan ini mirip seperti parameter yang dikirimkan ke metode <tt>find()</tt> dalam AR. -</p> - -<h2 id="142013">Pemetaan Tabel Asosiasi</h2> -<p id="710032" class="block-content"> -Obyek dapat dengan mudah menangani field multi nilai dengan menggunakan koleksi sebagai nilai field. Database relasional tidak memiliki fitur ini dan dibatasi hanya ke field nilai-tunggal. Ketika Anda memetakan asosiasi satu-ke-banyak, Anda bisa menangani ini menggunakan hubungan <b>has many</b>, intinya menggunakan kunci asing untuk nilai-tunggal akhir dari asosiasi. Tapi asosiasi banyak-ke-banyak tidak bisa melakukan ini karena tidak ada nilai-tunggal akhir ke kunci asing yang dipegangnya. -</p> -<p id="710033" class="block-content"> -Jawabannya adalah resolusi klasik yang telah dipakai oleh orang selama dekade ini yakni: buat tabel ekstra (tabel asosiasi) untuk merekam asosiasi. -Ide dasarnya adalah menggunakan tabel asosiasi untuk menyimpan asosiasi. Tabel ini memiliki ID kunci asing untuk dua tabel yang dikaitkan bersama, masing-masing memiliki pasangan dari obyek yang diasosiasikan. -</p> -<p id="710034" class="block-content"> -Tabel asosiasi tidak mempunyai kaitan obyek dalam-memori dan kunci primernya adalah gabungan dari dua kunci primer dari tabel yang diasosiasikan. -Dalam batasan yang sederhana, tuntuk mengambil data dari tabel asosiasi, Anda melakukan dua query (secara umum, ini juga bisa dicapai menggunakan satu query yang terdiri dari join). -Anggap pengambilan koleksi <tt>SkillRecord</tt> untuk daftar obyek <tt>PlayerRecord</tt>. -Dalam hal ini, Anda melakukan query dalam dua tahap. Tahap pertama meng-query tabel <tt>Players</tt> untuk mencari seluruh baris dari pemain yang Anda inginkan. Tahap kedua mencari obyek <tt>SkillRecord</tt> ID pemain terkait untuk setiap barisnya dalam tabel asosiasi <tt>Player_Skills</tt> menggunakan sebuah inner join. -</p> - -<p id="710035" class="block-content">Desain Rekaman Aktif Prado mengimplementasikan dua tahap pendekatan. Untuk hubungan entitas <tt>Players</tt>-<tt>Skills</tt> M-N (many-to-many), kita perlu mendefinisikan sebuah hubungan <b>has many</b> dalam kelas <tt>PlayerRecord</tt> dan sebagai tambahan mendefinisikan hubungan <b>has many</b> dalam kelas <tt>SkillRecord</tt> juga. -Kode contoh berikut mendefinisikan kelas <tt>SkillRecord</tt> lengkap dengan hubungan banyak-ke-banyak dengan kelas <tt>PlayerRecord</tt>. (Lihat definisi kelas <tt>PlayerRecord</tt> di atas untuk mengaitkan hubungan banyak-ke-banyak dengan kelas <tt>SkillRecord</tt>.) -</p> - -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class SkillRecord extends TActiveRecord -{ - const TABLE='Skills'; - public $skill_id; - public $name; - - public $players=array(); // deklarasi ini tidak diperlukan lagi sejak v3.1.2 - - public static $RELATIONS=array - ( - 'players' => array(self::MANY_TO_MANY, 'PlayerRecord', 'Player_Skills'), - ); - - public static function finder($className=__CLASS__) - { - return parent::finder($className); - } -} -</com:TTextHighlighter> - -<p id="710036" class="block-content"> -Properti statis <tt>$RELATIONS</tt> dari SkillRecord mendefinisikan bahwa properti <tt>$players</tt> memiliki banyak <tt>PlayerRecord</tt>s melalui tabel asosiasi '<tt>Player_Skills</tt>'. -Dalam <tt>array(self::MANY_TO_MANY, 'PlayerRecord', 'Player_Skills')</tt>, elemen pertama mendefinisikan tipe hubungan, dalam hal ini <strong><tt>self::HAS_MANY</tt></strong>, -elemen kedua adalah string <tt>'PlayerRecord'</tt> yang terkait ke nama kelas dari kelas <tt>PlayerRecord</tt>, dan elemen ketiga adalah nama dari nama tabel asosiasi. -</p> - -<div class="note"><b class="note">Catatan:</b> -Sebelum versi <b>3.1.2</b> (versi sampai dengan 3.1.1), hubungan many-to-many didefinisikan menggunakan <tt>self::HAS_MANY</tt>. Untuk versi <b>3.1.2</b> dan seterusnya, ini harus diubah ke <tt>self::MANY_TO_MANY</tt>. Ini bisa dikerjakan dengan mencari <tt>HAS_MANY</tt> dalam kode sumber dan hati-hati mengubah definisi terkait. -</div> - -<p id="710037" class="block-content"> -Daftar obyek pemain dengan koleksi obyek skil terkait bisa diambil seperti berikut. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -$players = PlayerRecord::finder()->withSkills()->findAll(); -</com:TTextHighlighter> -<p id="710038" class="block-content"> -Metode <tt>with_xxx()</tt> (di mana <tt>xxx</tt> adalah nama properti hubungan, dalam hal ini, <tt>Skill</tt>) mengambil <tt>SkillRecords</tt> terkait menggunakan query kedua (tidak dengan menggunakan join). <tt>with_xxx()</tt> menerima argumen yang sama seperti metode finder dari <tt>TActiveRecord</tt>. -</p> - -<h3 id="142021">Tabel Asosiasi Mereferensi Dirinya</h3> -<p id="710039" class="block-content"> -Untuk tabel asosiasi yang mererefensi dirinya sendiri, yaitu titik asosiasi ke tabel yang sama. Sebagai contoh, anggap tabel <tt>items</tt> dengan item terkait M-N melalui tabel asosiasi <tt>related_items</tt>. Sintaks dalam contoh berikut adalah benar untuk database PostgreSQL. Untuk database lain, lihat dokumentasinya masing-masing untuk mendefinisikan batasan kunci asing. -<com:TTextHighlighter Language="sql" CssClass="source block-content"> -CREATE TABLE items -( - "item_id" SERIAL, - "name" VARCHAR(128) NOT NULL, - PRIMARY KEY("item_id") -); -CREATE TABLE "related_items" -( - "item_id" INTEGER NOT NULL, - "related_item_id" INTEGER NOT NULL, - CONSTRAINT "related_items_pkey" PRIMARY KEY("item_id", "related_item_id"), - CONSTRAINT "related_items_item_id_fkey" FOREIGN KEY ("item_id") - REFERENCES "items"("item_id") - ON DELETE CASCADE - ON UPDATE NO ACTION - NOT DEFERRABLE, - CONSTRAINT "related_items_related_item_id_fkey" FOREIGN KEY ("related_item_id") - REFERENCES "items"("item_id") - ON DELETE CASCADE - ON UPDATE NO ACTION - NOT DEFERRABLE -); -</com:TTextHighlighter> - -<p id="710040" class="block-content">Nama tabel asosiasi dalam elemen ketiga dari array hubungan dapat berisi nama kolom tabel asing. Kolom yang didefinisikan dalam tabel asosiasi harus juga didefinisikan dalam kelas rekaman (contohnya properti <tt>$related_item_id</tt> terkait ke kolom <tt>related_item_id</tt> dalam tabel <tt>related_items</tt>). -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class Item extends TActiveRecord -{ - const TABLE="items"; - public $item_id; - public $details; - - //id item asing tambahan didefinisikan dalam tabel asosiasi - public $related_item_id; - public $related_items=array(); // deklarasi ini tidak diperlukan lagi sejak v3.1.2 - - public static $RELATIONS=array - ( - 'related_items' => array(self::MANY_TO_MANY, - 'Item', 'related_items.related_item_id'), - ); -} -</com:TTextHighlighter> -<div class="tip"><b class="note">Tip:</b> -Kunci gabungan dalam tabel asing dapat ditetapkan sebagai nilai dipisahkan koma diantara kurung buka/tutup. Contohnya <tt>'related_items.(id1,id2)'</tt>. -</div> - -<!--- -<h2 id="142014">Menambah/Menghapus/Memutakhirkan Obyek Terkait</h2> - -<p id="710041" class="block-content">Obyek terkait dapat disisipkan/dimutakhirkan dengan menambahkan obyek terkait itu ke obyek sumber saat ini (misalnya obyek yang saat ini sedang bekerja) dan kemudian memanggil metode <tt>save()</tt> pada obyek sumber. Referensi obyek terkait dan referensi asosiasi (jika diperlukan) akan ditambahkan dan/atau dimutakhirkan. -Sebagai contoh, untuk menambah dua pemain baru ke tim (mengasumsikan bahwa 'Team A' ada), kita cukup melakukan hal berikut. -</p> - -<com:TTextHighlighter Language="php" CssClass="source block-content"> -$team = TeamRecord::finder()->findByPk('Team A'); -$team->players[] = new PlayerRecord(array('age'=>20)); -$team->players[] = new PlayerRecord(array('age'=>25)); -$team->save(); -</com:TTextHighlighter> -<p id="710042" class="block-content"> -Karena kelas <tt>TeamRecord</tt> berisi hubungan <b>has many</b> dengan <tt>PlayerRecord</tt>, maka menyimpan obyek <tt>TeamRecord</tt> juga akan memutakhirkan obyek asing terkait dalam array <tt>$players</tt>. Yaitu, obyek dalam <tt>$players</tt> disisipkan/dimutakhirkan dalam database dan properti -<tt>$team_name</tt>, obyek itu akan berisi nilai kunci asing yang terkait dengan obyek nilai kunci primer <tt>$team</tt>. -</p> - -<p id="710043" class="block-content">Untuk menghapus obyek asing tertentu (atau setiap obyek Rekaman Aktif), cukup panggil metode obyek <tt>delete()</tt>. Anda dapat menyiapkan batas kunci asing tabel database seperti saat menghapus data tertentu dalam database ia akan menghapus data yang direferensi juga (ia juga dapat dicapai dengan menggunakan pemicu database). Contohnya seperti mempunyai batasan "<tt>ON DELETE CASCADE</tt>". -Menghapus kunci obyek asing dengan menyetel nilai properti ke null atau menghapus obyek dari array <b>TIDAK</b> akan menghapus data terkait dalam database. -</p> - -<p id="710044" class="block-content">Untuk menghapus asosiasi hubungan banyak-ke-banyak melalui tabel asosiasi, Rekaman Aktif yang terkait tabel asosiasi yang bisas dipakai. Kemudian asosiasi dapat dihapus dengan memanggil metode <tt>deleteByPk()</tt>, sebagai contoh: -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -PlayerSkillAssocation::finder()->deleteByPk(array('fk1','fk2')); -//di mana 'fk1' adalah nilai kunci primer dari seorang player -// dan 'fk2' adalah nilai kunci primer dari skill -</com:TTextHighlighter> ----> - -<h2 id="142015">Pengambilan Malas Obyek Terkait</h2> - -<div class="note"><b class="note">Catatan:</b> -Secara implisit mendeklarasikan properti terkait yang diperkenalkan dalam versi 3.1.2 secara otomatis memiliki fitur pengambilan malas. Oleh karena itu, teknik pengambilan malas dijelaskan berikut ini tidak lagi diperlukan dalam banyak kasus, kecuali Anda ingin memanipulasi obyek terkait melalui pengambil/penyetel. -</div> - -<p id="710045" class="block-content">Menggunakan metode <tt>with_xxx()</tt> akan mengambil hubungan rekaman sesuai permintaan. Mengambil rekaman terkait dengan lazy loading (yaitu, hanya obyek terkait itu saja yang diakses) bisa dicapai dengan menggunakan sebuah fitur <tt>TComponent</tt> yang menyediakan metode pengakses. Dalam keadaan tertentu, kita mendefinisikan pasangan metode pengambil dan penyetel di mana metode pengambil akan mengambil hubungan secara kondisional. Contoh berikut menggambarkan bahwa <tt>PlayerRecord</tt> dapat mengambil obyek asing <tt>$skills</tt> secara kondisional. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class PlayerRecord extends BaseFkRecord -{ - //... properti dan metode lainnya seperti sebelumnya - - private $_skills; //ubah ke private dan standar sebagai null - - public function getSkills() - { - if($this->_skills===null && $this->player_id !==null) - { - //lazy load rekaman skill - $this->setSkills($this->withSkills()->findByPk($this->player_id)->skills); - } - else if($this->_skills===null) - { - //buat TList baru; - $this->setSkills(new TList()); - } - - return $this->_skills; - } - - public function setSkills($value) - { - $this->_skills = $value instanceof TList ? $value : new TList($value); - } -} -</com:TTextHighlighter> -<p id="710046" class="block-content">Pertama kita perlu mengubah deklarasi <tt>$skills=array()</tt> ke properti private <tt>$_skills</tt> (perhatikan garis bawah) dan sebaliknya setel ke null. Ini membolehkan kita untuk mendefinisikan properti <tt>skills</tt> menggunakan metode pengambil/penyetel -(lihat <a href="?page=Fundamentals.Components1">Komponen</a> untuk lebih jelasnya). Metode pengambil <tt>getSkills()</tt> untuk properti <tt>skills</tt> akan mengambil malas rekaman skill terkait saat ia dipakai sebagai berikut. Catatan bahwa kita hanya melakukan pengambilan malas ketika <tt>$player_id</tt> tidak null (yakni, ketika rekaman sudah diambil dari database ataau id player sudah disetel). -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -$player = PlayerRecord::finder()->findByPk(1); -var_dump($player->skills); //pengambilan malas saat akses pertama -var_dump($player->skills[0]); //properti skills sudah diambil -$player->skills[] = new SkillRecord(); //menambah skill -</com:TTextHighlighter> - -<p id="710047" class="block-content">The <tt>setSkills()</tt> memastikan bahwa properti <tt>skills</tt> akan selalu berupa TList. -Menggunakan TList yang membolehkan kita untuk menyetel elemen properti <tt>skills</tt> seolah-olah mereka -sebuah array. Contohnya <tt>$player->skills[] = new SkillRecord()</tt>. Jika <tt>array</tt> dipakai, kesalahan PHP -akan dikeluarkan. -</p> - -<h2>Pemetaan Kolom</h2> -<p> -Sejak v3.1.1, Rekaman Aktif mulai mendukung pemetaan kolom. Pemetaan kolom membolehkan para -pengembang untuk mengalamatkan kolom dalam Rekaman Aktif menggunakan konvensi penamaan lebih -konsisten. Dalam keadaan tertentu, menggunakan pemetaan kolom, seseorang dapat mengakses kolom -menggunakan apapun namanya yang disukainya, daripada nama terbatas yang didefinisikan dalam -skema database. -</p> -<p> -Untuk menggunakan pemetaan kolom, deklarasikan array statis bernama <tt>COLUMN_MAPPING</tt> dalam kelas Rekaman Aktif. -Kunci dari array adalah nama kolom (disebut <i>nama kolom fisik</i>) yang didefinisikan dalam skema database, -sementara nilai terkait dengan nama properti (disebut <i>nama kolom logika</i>) didefinisikan dalam -kelas Rekaman Aktif. Nama properti dapat nama variabel anggota kelas public atau nama properti komponen -yang didefinisikan via pengambil/penyetel. Jika nama kolom fisik terjadi sama seperti nama kolom logika, -keduanya tidak perlu didaftarkan dalam <tt>COLUMN_MAPPING</tt>. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class UserRecord extends TActiveRecord -{ - const TABLE='users'; - public static $COLUMN_MAPPING=array - ( - 'user_id'=>'id', - 'email_address'=>'email', - 'first_name'=>'firstName', - 'last_name'=>'lastName', - ); - public $id; - public $username; // nama kolom fisik dan logika sama - public $email; - public $firstName; - public $lastName; - //.... -} -</com:TTextHighlighter> -<p> -Dengan pemetaan kolom di atas, kita mengalamatkan <tt>first_name</tt> menggunakan <tt>$userRecord->firstName</tt> -daripada <tt>$userRecord->first_name</tt>. Ini membantu pemisahan dari logika dengan model. -</p> - -<h2 id="138054">Referensi</h2> -<ul id="u3" class="block-content"> - <li>Fowler et. al. <i>Patterns of Enterprise Application Architecture</i>, - Addison Wesley, 2002.</li> - <li>B. Venners with B. Eckel. <i><a href="http://www.artima.com/intv/abstract3.html">Inappropriate Abstractions - A Conversation with Anders Hejlsberg, Part VI.</a></i> - Artima Developer, 2003. - </li> - -</ul> - -</com:TContent> diff --git a/demos/quickstart/protected/pages/Database/id/DAO.page b/demos/quickstart/protected/pages/Database/id/DAO.page deleted file mode 100755 index 8ccfb149..00000000 --- a/demos/quickstart/protected/pages/Database/id/DAO.page +++ /dev/null @@ -1,163 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="136039">Data Access Object (DAO)</h1>
-<com:SinceVersion Version="3.1a" />
-<p id="680461" class="block-content">
-Obyek Akses Data atau Data Access Object (DAO) memisahkan data sumber daya antarmuka klien dari mekanisme akses datanya. Ia mengadaptasi API akses sumber daya ke antarmuka klien generik. Hasilnya, mekanisme akses data dapat diubah tersendiri atas kode yang menggunakan data.
-</p>
-<p id="680462" class="block-content">
-Sejak versi 3.1, PRADO mulai menyediakan DAO yang adalah pelapis tipis sekitar <a href="http://www.php.net/manual/en/ref.pdo.php">PHP Data Objects (PDO)</a>. Meskipun PDO memiliki set fitur bagus dan API yang baik, kami memilih untuk mengimplementasikan PRADO DAO di atas PDO karena kelas PRADO DAO adalah kelas komponen dan bisa dikonfigurasi dalam aplikasi PRADO. Para pengguna dapat menggunakan kelas DAO ini dalam cara yang lebih disukai-PRADO.
-</p>
-<div class="note"><b class="tip">Catatan:</b>
-Karena PRADO DAO didasarkan pada PDO, ekstensi PDO PHP perlu diinstalasi. Sebagai tambahan, Anda perlu menginstalasi driver PDO database terkait untuk digunakan dalam aplikasi Anda. Lihat lebih jelasnya dalam <a href="http://www.php.net/manual/en/ref.pdo.php">PHP Manual</a>.
-</div>
-<p id="680463" class="block-content">
-PRADO DAO sebagian besar terdiri dari empat kelas (kebalikan dari PDO yang hanya dua kelas, <tt>PDO</tt> dan <tt>PDOStatement</tt>):
-</p>
-<ul id="u1" class="block-content">
-<li><tt>TDbConnection</tt> - mewakili koneksi ke database.</li>
-<li><tt>TDbCommand</tt> - mewakili pernyataan SQL yang dijalankan terhadap database.</li>
-<li><tt>TDbDataReader</tt> - mewakili stream hanya-maju atas stream baris dari set hasil query.</li>
-<li><tt>TDbTransaction</tt> - mewakili transaksi DB.</li>
-</ul>
-<p id="680464" class="block-content">
-Berikutnya, kami memperkenalkan penggunaan PRADO DAO dalam skenario yang berbeda.
-</p>
-
-<h2 id="136040">Menetapkan Koneksi Database</h2>
-<p id="680465" class="block-content">
-Untuk menetapkan koneksi database, seseorang membuat turunan <tt>TDbConnection</tt> dan mengaktifkannya. Nama sumber data (DSN) diperlukan guna menetapkan informasi yang dibutuhkan untuk menyambung ke database. Nama pengguna dan kata sandi database mungkin perlu disertakan untuk menetapkan koneksi.
-</p>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_680140">
-$connection=new TDbConnection($dsn,$username,$password);
-// panggil setAttribute() untuk mengirim parameter koneksi tambahan
-// $connection->Persistent=true; // gunakan koneksi persisten
-$connection->Active=true; // koneksi terlaksana
-....
-$connection->Active=false; // koneksi ditutup
-</com:TTextHighlighter>
-<p id="680466" class="block-content">
-Spesifikasi lengkap terhadap DSN dapat ditemukan dalam <a href="http://www.php.net/manual/en/ref.pdo.php#pdo.drivers">dokumentasi PDO</a>. Di bawah ini adalah daftar format DNS paling umum dipakai:
-</p>
-<ul id="u2" class="block-content">
-<li>MySQL - <tt>mysql:host=localhost;dbname=test</tt></li>
-<li>SQLite - <tt>sqlite:/path/to/dbfile</tt></li>
-<li>ODBC - <tt>odbc:SAMPLE</tt>
-</ul>
-<p id="680467" class="block-content">
-Dalam hal terjadi kesalahan ketika menetapkan koneksi (seperti DSN atau nama pengguna/sandi salah), <tt>TDbException</tt> akan dimunculkan.
-</p>
-
-<h2 id="136041">Menjalankan Pernyataan SQL</h2>
-<p id="680468" class="block-content">
-Sekali koneksi database terlaksana, pernyataan SQL dapat dijalankan melalui <tt>TDbCommand</tt>. Seseorang membuat <tt>TDbCommand</tt> dengan memanggil <tt>TDbConnection.createCommand()</tt> dengan pernyataan SQL yang ditetapkan:
-</p>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_680141">
-$command=$connection->createCommand($sqlStatement);
-// jika diperlukan, pernyataan SQL dapat dimutakhirkan seperti berikut:
-$command->Text=$newSqlStatement;
-</com:TTextHighlighter>
-
-<p id="680469" class="block-content">
-Pernyataan SQL dijalankan melalui <tt>TDbCommand</tt> dalam salah satu dari dua cara berikut:
-</p>
-<ul id="u4" class="block-content">
-<li><tt>execute()</tt> - melakukan pernyataan SQL non-query, seperti <tt>INSERT</tt>, <tt>UPDATE</tt> dan <tt>DELETE</tt>. Jika berhasil, ia mengembalikan jumlah baris yang dipengaruhi oleh eksekusi.</li>
-<li><tt>query()</tt> - melakukan pernyataan SQL yang mengembalikan baris data, seperti <tt>SELECT</tt>. Jika berhasil, ia mengembalikan turunan <tt>TDbDataReader</tt> dari salah satu yang bisa mengambil hasil baris data.
-</li>
-</ul>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_680142">
-$affectedRowCount=$command->execute(); // jalankan SQL non-query
-$dataReader=$command->query(); // jalankan query SQL
-$row=$command->queryRow(); // jalankan query SQL dan kembalikan hasil baris pertama
-$value=$command->queryScalar(); // jalankan query SQL dan kembalikan nilai kolom pertama
-</com:TTextHighlighter>
-<p id="680470" class="block-content">
-Dalam hal terjadi kesalahan selama eksekusi pernyataan SQL, <tt>TDbException</tt> akan dimunculkan.
-</p>
-
-<h2 id="136042">Mengambil Hasil Query</h2>
-<p id="680471" class="block-content">
-Setelah <tt>TDbCommand.query()</tt> membuat turunan <tt>TDbDataReader</tt>, seseorang dapat mengambil baris dari data hasil dengan memanggil <tt>TDbDataReader.read()</tt> secara berulang. Seseorang juga bisa menggunakan <tt>TDbDataReader</tt> dalam konstruksi bahasa PHP <tt>foreach</tt> untuk mengambil baris demi baris.
-</p>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_680143">
-// memanggil read() secara berulang sampai ia mengembalikan false
-while(($row=$dataReader->read())!==false) { ... }
-// menggunakan foreach untuk menjelajah melalui setiap baris data
-foreach($dataReader as $row) { ... }
-// mengambil semua baris sekaligus dalam satu array tunggal
-$rows=$dataReader->readAll();
-</com:TTextHighlighter>
-
-<h2 id="136043">Menggunakan Transaksi</h2>
-<p id="680472" class="block-content">
-Ketika aplikasi menjalankan beberapa query, setiap pembacaan dan/atau penulisan informasi dalam database, penting untuk memastikan bahwa datanase tidak dibiarkan dengan hanya beberapa query yang dibawanya. Transaksi, mewakili turunan <tt>TDbTransaksi</tt> dalam PRADO, dapat diinisialisasi dalam hal ini:
-</p>
-<ul id="u5" class="block-content">
-<li>Mulai transaksi.</li>
-<li>Jalankan query satu demi satu. Setiap memutakhirkan ke database tidak terlihat bagi dunia luar.</li>
-<li>Komit transaksi. Pemutakhiran menjadi terlihat jika transaksi berhasil.</li>
-<li>Jika salah satu query gagal, seluruh transaksi digulung kembali.</li>
-</ul>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_680144">
-$transaction=$connection->beginTransaction();
-try
-{
- $connection->createCommand($sql1)->execute();
- $connection->createCommand($sql2)->execute();
- //.... eksekusi SQL lain
- $transaction->commit();
-}
-catch(Exception $e) // eksepsi dimunculkan jika query gagal
-{
- $transaction->rollBack();
-}
-</com:TTextHighlighter>
-
-
-<h2 id="136044">Mengikat Parameter</h2>
-<p id="680473" class="block-content">
-Guna menghindari <a href="http://en.wikipedia.org/wiki/SQL_injection">serangan injeksi SQL</a> dan untuk meningkatkan performansi dari eksekusi pernyataan SQL yang dipakai secara berulang-ulang, seseorang dapat "menyiapkan" pernyataan SQL dengan tempat parameter opsional yang akan diganti dengan parameter sebenarnya selama proses pengikatan parameter.
-</p>
-<p id="680474" class="block-content">
-Tempat parameter dapat bernama (diwakili dengan token unik) ataupun tidak bernama (diwakili dengan tanda tanya). Panggil <tt>TDbCommand.bindParameter()</tt> atau <tt>TDbCommand.bindValue()</tt> untuk mengganti tempat ini dengan parameter aktual. Parameter tidak perlu diberi tanda kutip: driver database melakukan ini bagi Anda. Pengikatan parameter harus dikerjakan sebelum pernyataan SQL dijalankan.
-</p>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_680145">
-// sebuah SQL dengan dua tempat ":username" dan ":email"
-$sql="INSERT INTO users(username, email) VALUES(:username,:email)";
-$command=$connection->createCommand($sql);
-// ganti tempat ":username" dengan nilai username sebenarnya
-$command->bindParameter(":username",$username,PDO::PARAM_STR);
-// ganti tempat ":email" dengan nilai email sebenarnya
-$command->bindParameter(":email",$email,PDO::PARAM_STR);
-$command->execute();
-// sisipkan baris lain dengan set parameter baru
-$command->bindParameter(":username",$username2,PDO::PARAM_STR);
-$command->bindParameter(":email",$email2,PDO::PARAM_STR);
-$command->execute();
-</com:TTextHighlighter>
-<p id="680475" class="block-content">
-Metode <tt>bindParameter()</tt> dan <tt>bindValue()</tt> sangat mirip. Perbedaanya hanyalah pembentuk mengikat parameter dengan referensi variabel PHP sementara yang terkahir dengan nila. Untuk parameters yang mewakili blok memori data besar, pembentuk lebih disukai untuk pertimbangan performansi.
-</p>
-<p id="680476" class="block-content">
-Untuk lebih jelasnya mengenai pengikatan parameter, lihat <a href="http://www.php.net/manual/en/function.pdostatement-bindparam.php">dokumentasi PHP terkait</a>.
-</p>
-
-
-<h2 id="136045">Mengikat Kolom</h2>
-<p id="680477" class="block-content">
-Ketika mengambil hasil query, seseorang dapat juga mengikat kolom dengan bariabel PHP agar dipopulasikan secara otomatis dengan data terbaru setiap kali baris diambil.
-</p>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_680146">
-$sql="SELECT username, email FROM users";
-$dataReader=$connection->createCommand($sql)->query();
-// ikat kolom ke-1 (username) dengan variabel $username
-$dataReader->bindColumn(1,$username);
-// ikat kolom ke-2 (email) dengan variabel $email
-$dataReader->bindColumn(2,$email);
-while($dataReader->read()!==false)
-{
- // $username dan $email berisi username dan email dalam baris sekarang
-}
-</com:TTextHighlighter>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Database/id/Scaffold.page b/demos/quickstart/protected/pages/Database/id/Scaffold.page deleted file mode 100755 index e9f15b39..00000000 --- a/demos/quickstart/protected/pages/Database/id/Scaffold.page +++ /dev/null @@ -1,130 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="144022">Tampilan Scaffold Rekaman Aktif</h1>
-<com:SinceVersion Version="3.1b" />
-<p id="720048" class="block-content">Kelas <a href="?page=Database.ActiveRecord">Rekaman Aktif</a> dapat digunakan dengan
-<com:DocLink ClassPath="System.Data.ActiveRecord.Scaffold.TScaffoldListView" Text="TScaffoldListView"/>
-dan
-<com:DocLink ClassPath="System.Data.ActiveRecord.Scaffold.TScaffoldEditView" Text="TScaffoldEditView"/>
-( <com:DocLink ClassPath="System.Data.ActiveRecord.Scaffold.TScaffoldView" Text="TScaffoldView"/>
-mengaitkan <tt>TScaffoldListView</tt> dan <tt>TScaffoldEditView</tt>) untuk membuat aplikasi web Create/Read/Update/Delete (CRUD) <i>sederhana</i>.</p>
-
-<p id="720049" class="block-content">Tampilan scaffold dimaksudkan untuk membantu dalam membuat prototipe aplikasi web, tidak didesain sebagai yang bisa dikustomisasi atau serumit komponen misalnya
-<a href="?page=Controls.DataGrid">TDataGrid</a>. Tampilan scaffold menyediakan fungsionalitas builtin:
-</p>
-
-<ul>
- <li>Mendaftar semua item rekaman aktif.</li>
- <li>Mencari rekaman.</li>
- <li>Memilah halaman dan mengurut.</li>
- <li>Menghapus item.</li>
- <li>Menyisipkan item baru.</li>
- <li>Memutakhirkan item yang ada.</li>
- <li>Memvalidasi field dan tipe data dasar yang diperlukan.</li>
- <li>Menyajikan kontrol khusus seperti pengambil tanggal.</li>
-</ul>
-
-<p id="720050" class="block-content">Tampilan Scaffold berdiri sendiri pada Rekaman Aktif dan saat ini mendukung database: Mysql, Sqlite dan Postgres SQL. Dukungan untuk database lain dapat diputuskan bila ada permintaan yang cukup.</p>
-
-<h2 id="144023">Menyiapkan Tampilan Scaffold</h2>
-<p id="720051" class="block-content">Untuk menggunakan tampilan scaffold, pertama kita mendefinisikan kelas <a href="?page=Database.ActiveRecord">Rekaman Aktif</a> yang mewakili tabel atau view dalam database. Tetapkan kelas Rekaman Aktif berikut yang berkaitan dengan tabel <tt>users</tt>
-seperti didefinisikan dalam halaman <a href="?page=Database.ActiveRecord">Rekaman Aktif</a>.
-</p>
-
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_720188">
-class UserRecord extends TActiveRecord
-{
- const TABLE='users';
-
- public $username;
- public $email;
-}
-</com:TTextHighlighter>
-
-<p id="720052" class="block-content">Kelas tampilan scaffold ada di <tt>System.Data.ActiveRecord.Scaffold.*</tt>
-<a href="?page=Fundamentals.Components#704">namespace</a>.
-<a href="?page=Fundamentals.Components#704">namespace</a> ini bisa diimpor ke
-<a href="?page=Configurations.AppConfig">Konfigurasi Aplikasi</a>
-menggunakan file <tt>application.xml</tt> atau melalui kode php menggunakan metode <tt>Prado::using()</tt>. Untuk mulai menggunakan
-<com:DocLink ClassPath="System.Data.ActiveRecord.Scaffold.TScaffoldView" Text="TScaffoldView"/>
-cukup setel nilai properti <tt>RecordClass</tt> sama dengan nama kelas Rekaman Aktif.
-</p>
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_720189">
-<com:TScaffoldView RecordClass="UserRecord" />
-</com:TTextHighlighter>
-
-<p id="720053" class="block-content">Kode di atas akan mendaftar rekaman saat ini dalam tabel <tt>users</tt>.
-Setiap rekaman dapat diedit dengan mengklik tombol "edit" dan dihapus dengan mengklik tombol "delete". Rekaman baru bisa ditambahkan dengan mengklik pada tombol "Add new record", masukkan beberapa data (perhatikan validasi otomatis terhadap field dan tipe data yang diperlukan), dan klik tombol "save".
-Menetapkan batas pencarian dalam kotak teks cari guna menemukan rekaman tertentu. Akhirnya, daftar rekaman bisa disimpan pada setiap kolom dengan mengubah kolom pengurutan serta urutan.
-</p>
-
-<p id="720054" class="block-content"><tt>TScaffoldView</tt> adalah kontrol template yang dibuat dari kontrol scaffold lainnya.
-Properti berikut memberikan akses ke kontrol gabungan ini.</p>
-<ul>
- <li><b><tt>ListView</tt></b> -- <tt>TScaffoldListView</tt> menampilkan daftar rekaman. </li>
- <li><b><tt>EditView</tt></b> -- <tt>TScaffoldEditView</tt> yang menyajikan input untuk mengedit dan menambah rekaman.</li>
- <li><b><tt>SearchControl</tt></b> -- <tt>TScaffoldSearch</tt> bertanggung jawab atas pencarian antarmuka pengguna.</li>
-</ul>
-<p id="720055" class="block-content">
- Semua kontrol gabungan ini bisa dikustomisasi seperti yang akan kita lihat di bawah.
-</p>
-
-<h2 id="144024">TScaffoldListView</h2>
-
-<p id="720056" class="block-content">Daftar Rekaman Aktif dapat ditampilkan menggunakan <tt>TScaffoldListView</tt> dengan properti berguna berikut.</p>
-<ul>
- <li><b><tt>Header</tt></b> -- <a href="?page=Controls.Repeater">TRepeater</a> menampilkan properti/nama field Rekaman Aktif. </li>
- <li><b><tt>Sort</tt></b> -- <a href="?page=Controls.List">TDropDownList</a> menampilkan kombinasi properti dan kemungkinan urutannya. </li>
- <li><b><tt>Pager</tt></b> -- kontrol <a href="?page=Controls.Pager">TPager</a> menampilkan link dan/atau tombol yang menavigasi ke halaman berbeda dalam data Rekaman Aktif.</li>
- <li><b><tt>List</tt></b> -- <a href="?page=Controls.Repeater">TRepeater</a> yang menyajikan baris data Rekaman Aktif.</li>
-</ul>
-
-<p id="720057" class="block-content">Penyajian kustom dari Rekaman Aktif dapat dicapai dengan menetapkan properti <tt>ItemTemplate</tt> dan/atau <tt>AlternatingItemTemplate</tt> dari pengulang <tt>List</tt>.
-<tt>TScaffoldListView</tt> akan mendengarkan dua event perintah bernama "delete" dan "edit". Perintah "delete" akan menghapus rekaman untuk baris di mana perintah "delete" berasal.
-Perintah "edit" akan memaksa data rekaman untuk diedit oleh
-<tt>TScaffoldEditView</tt> dengan ID yang ditetapkan dengan properti <tt>EditViewID</tt>.
-Contoh berikut mendaftar nama pengguna hanya dengan format tebal.
-</p>
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_720190">
-<com:TScaffoldListView RecordClass="UserRecord" >
- <prop:List.ItemTemplate>
- <strong><%# $this->Data->username %></strong>
- </prop:List.ItemTemplate>
-</com:TScaffoldListView>
-</com:TTextHighlighter>
-
-<div class="info"><b class="note">Info:</b>
-Untuk <tt>TScaffoldView</tt>, tampilan daftar dapat diakses melalui properti <tt>ListView</tt> dari <tt>TScaffoldView</tt>.
-Selanjutnya, subproperti <tt>ListView.List.ItemTemplate</tt> pada <tt>TScaffoldView</tt>
-adalah sama dengan subproperti <tt>List.ItemTemplate</tt> dari <tt>TScaffoldListView</tt> dalam contoh di atas.
-</div>
-
-<p id="720058" class="block-content">Properti <tt>SearchCondition</tt> dan properti <tt>SearchParameters</tt> (mengambil nilai array) bisa ditetapkan untuk mengkustomisasi rekaman yang ditampilkan. <tt>SearchCondition</tt>
-akan dipakai sebagai properti <tt>Condition</tt> dari <tt>TActiveRecordCriteria</tt>
-dan properti <tt>SearchParameters</tt> berkaitan dengan properti
-<tt>Parameters</tt> dari <tt>TActiveRecordCriteria</tt>.</p>
-
-<h2 id="144025">TScaffoldEditView</h2>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_720191">
-<com:TScaffoldEditView RecordPk="user1" RecordClass="UserRecord" />
-</com:TTextHighlighter>
-
-<h2 id="144026">Menggabungkan tampilan daftar + edit</h2>
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_720192">
-<com:TScaffoldEditView ID="edit_view" RecordClass="UserRecord" />
-<com:TScaffoldListView EditViewID="edit_view" RecordClass="UserRecord" />
-</com:TTextHighlighter>
-
-<h2 id="144027">Mengkustomisasi TScaffoldView</h2>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_720193">
-<com:TScaffoldView RecordClass="UserRecord" >
- <prop:ListView.List.ItemTemplate>
- <%# $this->DataItem->username %>
- <com:TLinkButton Text="Edit" CommandName="edit" />
- </prop:ListView.List.ItemTemplate>
-</com:TScaffoldView/>
-</com:TTextHighlighter>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Database/id/SqlMap.page b/demos/quickstart/protected/pages/Database/id/SqlMap.page deleted file mode 100755 index 4b5041cc..00000000 --- a/demos/quickstart/protected/pages/Database/id/SqlMap.page +++ /dev/null @@ -1,210 +0,0 @@ -<com:TContent ID="body"> - -<h1 id="140062">Pemeta Data</h1> -<com:SinceVersion Version="3.1a" /> -<p id="700505" class="block-content">Pemeta Data memindahkan data antara obyek dan database sementara memeliharanya berdiri sendiri satu sama lain dan pemetanya sendiri. Jika Anda mulai dengan - <a href="?page=Database.ActiveRecord">Active Records</a>, mungkin nantinya Anda dihadapkan dengan obyek bisnis lebih kompleks seiring denga kemajuan proyek Anda. Ketika Anda membangun model obyek dengan banyak logika bisnis, sangat berharga untuk memakai mekanisme ini untuk mengatur data lebih baik dan perilaku bersamanya. Melakukan itu menyebabkan skema varian; yakni skema obyek dan skema relasional tidak sama. -</p> - -<p id="700506" class="block-content">Pemeta Data memisahkan obyek dalam-memori dari database. Tanggung jawabnya adalah mentransfer data diantara keduanya dan juga saling mengisolasinya. - Dengan Pemeta Data obyek dalam-memori tidak perlu mengetahui meskipun ada sebuah database; tidak perlu kode antarmuka SQL, dan tentunya tidak mengetahui skema database. (Skema database selalu diabaikan dari obyek yang memakainya.) -</p> - -<h2 id="140063">Kapan Menggunakannya</h2> -<p id="700507" class="block-content">Tujuan utama menggunakan Pemeta Data ialah ketika Anda menginginkan skema database dan model obyek tumbuh secara independen. Keuntungan utama dari Pemeta Data adalah bahwa saat bekerja pada obyek bisnis (atau domain) Anda bisa mengabaikan database, baik dalam desain maupun pembangunan propes pengujian. Obyek domain tidak mengetahui struktur databasenya karena semua ini dikerjakan oleh pemeta. -</p> - -<p id="700508" class="block-content">Ini membantu Anda dalam kode karena Anda bisa mengerti serta bekerja dengan obyek domain tanpa harus mengerti bagaimana ia disimpan dalam. Anda bisa memodifikasi model bisnis atau database tanpa harus mengubahnya. Dengan pemetaan rumit, terutama yang menyangkut <b>database yang sudah ada</b>, ini sangat berharga. -</p> - -<p id="700509" class="block-content">Harga tentunya merupakan lapisan ekstra yang tidak Anda peroleh dengan <a href="?page=Database.ActiveRecord">Rekaman Aktif</a>, maka pengujian menggunakan pola ini adalah kompleksitas dari logika bisnis. Jika Anda memiliki logika bisa cukup sederhana, <a href="?page=Database.ActiveRecord">Rekaman Aktif</a> mungkin akan mencukupi. -Untuk logika yang lebih rumit, Pemeta Data mungkin lebih cocok. -</p> - -<h2 id="140064">Pemeta Data SqlMap</h2> -<p id="700510" class="block-content">Kerangka kerja Pemeta Data SqlMap memudahkan untuk menggunakan database dengan aplikasi PHP. - PemetaData SqlMap memasangkan obyek dengan prosedur tersimpan atau pernyataan SQL menggunakan deskriptor XML. Kesederhanaan adalah keuntungan terbesar dari PemetaData SqlMap di atas piranti pemetaan relasional obyek. Untuk menggunakan PemetaData SqlMap Anda bergantung pada obyek Anda sendiri, - XML, dan SQL. Anda sedikit yang harus mempelajari yang belum Anda ketahui. - Dengan Pemeta Data SqlMap Anda mempunyai tenaga penuh pada SQL dan prosedur tersimpan di tangan Anda. -</p> - -<p id="700511" class="block-content"> - <img src=<%~ diagram.png %> alt="Tinjauan Pemeta Data SqlMap" id="fig:sqlmap.png" class="figure"/> - - Ini adalah penjelasan tingkat tinggi atas alur kerja yang dilukiskan pada gambar di atas. - Menyediakan parameter, baik sebagai obyek ataupun tipe primitif. Parameter bisa dipakai untuk menyetel nilai runtime dalam pernyataan SQL atau prosedur. Jika nilai runtime tidak diperlukan, parameter dapat diabaikan. -</p> -<p id="700512" class="block-content">Menjalankan pemetaan dengan mengirimkan parameter dan nama yang Anda berikan pada deskriptor XML Anda. Langkah ini adalah saat di mana keajaiban terjadi. Kerangka kerja akan menyiapkan pernyataan SQL atau prosedur tersimpan, menyetel setiap nilai runtime menggunakan parameter Anda, menjalankan prosedur atau pernyataan, dan mengembalikan hasil. -</p> - -<p id="700513" class="block-content">Dalam hal pemutakhiran, jumlah baris yang dipengaruhi dikembalikan. Dalam hal query, obyek tunggal, atau koleksi obyek dikembalikan. Seperti parameter, obyek hasil, atau koleksi obyek, bisa berupa obyek biasa ataupun tipe PHP primitif. -</p> - -<h2 id="140065">Menyiapkan koneksi database dan menginisialisasi SqlMap</h2> -<p id="700514" class="block-content"> - Koneksi database untuk SqlMap dapat disetel seperti berikut. - Lihat <a href="?page=Database.DAO">Menetapkan Koneksi Database</a> untuk lebih jelasnya mengenai pembuatan koneksi database secara umum. -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_700166"> -//buat koneksi dan berikan ke manajer SqlMap. -$dsn = 'pgsql:host=localhost;dbname=test'; //Postgres SQL -$conn = new TDbConnection($dsn, 'dbuser','dbpass'); -$manager = new TSqlMapManager($conn); -$manager->configureXml('my-sqlmap.xml'); -$sqlmap = $manager->getSqlMapGateway(); -</com:TTextHighlighter> -</p> - -<p id="700515" class="block-content"> - <tt>TSqlMapManager</tt> bertanggung jawab untuk menyiapkan koneksi database dan mengkonfigurasi SqlMap dengan file XML yang diberikan. metode <tt>configureXml()</tt> menerima string yang merujuk ke file konfigurasi XML SqlMap. Sekali dikonfigurasi, panggil metode <tt>getSqlMapGateway()</tt> untuk memperoleh turunan dari antarmuka gateway SqlMap (pakai obyek ini untuk menyisipkan/menghapus/mencari rekaman). -</p> - -<p id="700516" class="block-content"> - Koneksi database SqlMap juga bisa dikonfigurasi menggunakan tag <tt><module></tt> dalam <a href="?page=Configurations.AppConfig">application.xml</a> atau - <a href="?page=Configurations.PageConfig">config.xml</a> seperti berikut. -<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_700167"> -<modules> - <module id="my-sqlmap" class="System.Data.SqlMap.TSqlMapConfig" - EnableCache="true" ConfigFile="my-sqlmap.xml" > - <database ConnectionString="pgsql:host=localhost;dbname=test" - Username="dbuser" Password="dbpass" /> - </module> -</modules> -</com:TTextHighlighter> -</p> - -<p id="700517" class="block-content"> - Atribut <tt>ConfigFile</tt> harus menunjuk ke file konfigurasi SqlMap (dijelaskan nanti) baik menggunakan path absolut, path relatif ataupun path notasi titik namespace Prado (harus mengabaikan ekstensi ".xml"). - - <div class="tip"><b class="note">Tip:</b> - Atribut <tt>EnableCache</tt> saat disetel "true" akan men-cache - konfigurasi yang diurai. Anda harus membersihkan atau menghapus cache jika Anda mengubah file konfigurasinya. - <a href="?page=Advanced.Performance#6402">modul cache</a> juga harus didefinisikan agar cache berfungsi. - </div> -</p> - -<p id="700518" class="block-content">Untuk mendapatkan antarmuka gateway SqlMap dari konfigurasi <module>, cukup lakukan misalnya -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_700168"> -class MyPage extends TPage -{ - public function onLoad($param) - { - parent::onLoad($param); - $sqlmap = $this->Application->Modules['my-sqlmap']->Client; - $sqlmap->queryForObject(...); //query beberapa obyek - } -} -</com:TTextHighlighter> -</p> - -<h2 id="140066">Contoh cepat</h2> -<p id="700519" class="block-content">Mari kita anggap tabel "users" berikut yang berisi dua kolom bernama "username" dan "email", di mana "username" juga merupakan kunci primer. -<com:TTextHighlighter Language="sql" CssClass="source block-content" id="code_700169"> -CREATE TABLE users -( - username VARCHAR( 20 ) NOT NULL , - email VARCHAR( 200 ) , - PRIMARY KEY ( username ) -); -</com:TTextHighlighter> -</p> -<p id="700520" class="block-content">Kemudian kita mendefinisikan kelas <tt>User</tt> biasa seperti berikut. Perhatikan bahwa <tt>User</tt> sangat sederhana. -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_700170"> -class User -{ - public $username; - public $email; -} -</com:TTextHighlighter> -</p> -</p> - -<p id="700521" class="block-content">Selanjutnya, kita perlu mendefinisikan file konfigurasi XML SqlMap, mari namai file sebagai <tt>my-sqlmap.xml</tt>. -<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_700171"> -<?xml version="1.0" encoding="utf-8" ?> -<sqlMapConfig> - <select id="SelectUsers" resultClass="User"> - SELECT username, email FROM users - </select> -</sqlMapConfig> -</com:TTextHighlighter> -</p> -<p id="700522" class="block-content">Tag <select> mengembalikan definisi pernyataan SQL. Atribut <tt>id</tt> akan dipakai sebagai pengenal untuk query. Nilai atribut <tt>resultClass</tt> adalah nama kelas obyek yang dikembalikan. - Sekarang kita dapat melakukan query obyek sebagai berikut: - -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_700172"> -//anggap bahwa $sqlmap adalah turunan TSqlMapGateway -$userList = $sqlmap->queryForList("SelectUsers"); - -//Atau hanya satu, jika hanya itu yang Anda butuhkan: -$user = $sqlmap->queryForObject("SelectUsers"); -</com:TTextHighlighter> -</p> - -<p id="700523" class="block-content">Contoh di atas hanya menampilkan demonstrasi sedikit kemampuan Pemeta Data SqlMap. Rincian selanjutnya dapat ditemukan dalam - <a href="http://www.pradosoft.com/demo/sqlamp/">SqlMap Manual</a>. -</p> - -<h2 id="140067">Menggabung SqlMap dengan Rekaman Aktif</h2> -<p id="700524" class="block-content">Contoh di atas nampaknya seperti sepele dan ia juga seperti banyak pekerjaan hanya untuk mengambil data. Akan tetapi, perhatikan bahwa kelas <tt>User</tt> sama sekali tidak mengetahui telah disimpan dalam database, dan database tidak mengetahui kelas <tt>User</tt>. -</p> -<p id="700525" class="block-content"> - Salah satu keuntungan dari SqlMap adalah kemampuan memetakan hubungan - obyek yang kompleks, koleksi dari datbase yang sudah ada. Dilain pihak, - <a href="?page=Database.ActiveRecord">Rekaman Aktif</a> menyediakan cara - yang sangat sederhana untuk berinteraksi dengan database tapi tidak bisa - melakukan hubungan atau koleksi yang lebih rumit. Kompromi yang baik adalah - menggunakan SqlMap untuk mengambil hubungan dan koleksi rumit sebagai - obyek Rekaman Aktif dan kemudian menggunakan Rekaman Aktif ini untuk memutakhirkan, menyisipkan dan menghapus. -</p> -<p id="700526" class="block-content">Melanjutkan contoh sebelumnya, kita mengubah definisi kelas <tt>User</tt> menjadi sebuah Rekaman Aktif. -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_700173"> -class UserRecord extends TActiveRecord -{ - const TABLE='users'; //nama tabel - - public $username; //kolom bernama "username" dalam tabel "users" - public $email; - - /** - * @return TActiveRecord active record finder instance - */ - public static function finder($className=__CLASS__) - { - return parent::finder($className); - } -} -</com:TTextHighlighter> -</p> - -<p id="700527" class="block-content">Kita juga perlu mengubah definisi dari konfigurasi XML SqlMap XML configuration. Kita cukup perlu mengubah nilai atribut <tt>resultClass</tt> ke <tt>UserRecord</tt>. -<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_700174"> -<?xml version="1.0" encoding="utf-8" ?> -<sqlMapConfig> - <select id="SelectUsers" resultClass="UserRecord"> - SELECT username, email FROM users - </select> -</sqlMapConfig> -</com:TTextHighlighter> -</p> - - -<p id="700528" class="block-content">Kode PHP untuk mengambil pengguna tetap sama, tapi sebaliknya SqlMap mengembalikan Rekaman Aktif, dan kita bisa mengambil keuntungan dari metode Rekaman Aktif. - -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_700175"> -//anggap bahwa $sqlmap adalah turunan TSqlMapGateway -$user = $sqlmap->queryForObject("SelectUsers"); - -$user->email = 'test@example.com'; //ubah data -$user->save(); //simpan menggunakan Rekaman Aktif -</com:TTextHighlighter> -</p> - -<h2 id="140068">Referensi</h2> -<ul id="u1" class="block-content"> - <li>Fowler et. al. <i>Patterns of Enterprise Application Architecture</i>, - Addison Wesley, 2002.</li> - <li>iBatis Team. <i>iBatis Data Mapper</i>, - <a href="http://ibatis.apache.org">http://ibatis.apache.org</a>.</li> -</ul> - -</com:TContent> diff --git a/demos/quickstart/protected/pages/Database/id/ar_objects.png b/demos/quickstart/protected/pages/Database/id/ar_objects.png Binary files differdeleted file mode 100755 index 50ab812d..00000000 --- a/demos/quickstart/protected/pages/Database/id/ar_objects.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Database/id/ar_relations.png b/demos/quickstart/protected/pages/Database/id/ar_relations.png Binary files differdeleted file mode 100755 index 48e29f48..00000000 --- a/demos/quickstart/protected/pages/Database/id/ar_relations.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Database/id/diagram.png b/demos/quickstart/protected/pages/Database/id/diagram.png Binary files differdeleted file mode 100755 index 0a0ca73d..00000000 --- a/demos/quickstart/protected/pages/Database/id/diagram.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Database/id/object_states.png b/demos/quickstart/protected/pages/Database/id/object_states.png Binary files differdeleted file mode 100755 index db194783..00000000 --- a/demos/quickstart/protected/pages/Database/id/object_states.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Database/id/sqlmap_active_record.png b/demos/quickstart/protected/pages/Database/id/sqlmap_active_record.png Binary files differdeleted file mode 100755 index 6d958d33..00000000 --- a/demos/quickstart/protected/pages/Database/id/sqlmap_active_record.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Database/pl/ActiveRecord.page b/demos/quickstart/protected/pages/Database/pl/ActiveRecord.page deleted file mode 100755 index 3a073e57..00000000 --- a/demos/quickstart/protected/pages/Database/pl/ActiveRecord.page +++ /dev/null @@ -1,1144 +0,0 @@ -<com:TContent ID="body" > -<h1 id="138046">Rekord Aktywny (ang. Active Record)</h1> -<com:SinceVersion Version="3.1a" /> -<p id="690478" class="block-content">Rekordy Aktywne są obiektami, które opakowują wiersz w bazie danych lub widoku, - obudowują (ang. encapsulate) dostęp do bazy danych oraz dziedziny logiki dla tych danych. - Podstawą Rekordu Aktywnego są klasy biznesowe np. klasa - <tt>Produkty</tt>, które są bardzo podobne do struktury rekordu należącego do bazy danych. Każdy Rekord Aktywny jest odpowiedzialny - za zapisywanie i łądowanie danych do i z bazy danych.</p> -<div class="info"><b class="note">Info:</b> - Struktura danych Rekordu Sktywnego powinna zgadzać się ze strukturą tablicy w bazie danych. - Każda kolumna w bazie danych powinna posiadać odpowiadający element: zmienną lub właściwość w klasie Rekordu Aktywnego reprezentującego tablicę. -</div> - -<h2 id="138047">Kiedy używać?</h2> - <p id="690479" class="block-content">Rekord Aktywne jest dobrym wyborem dla dziedziny logiki, która nie jest zbyt złożona, tak jak tworzenie, odczyty, aktualizacje oraz usuwanie. - Pochocne (ang. derivations) oraz sprawdzenia bazujące na pojedyńczym rekordzie sprawdzają się dobrze w tej konstrukcji. - Rekord Aktywne ma podstawową zaletę, którą jest prostota. Łatwo jest stworzyć Rekord Aktywny, łatwo go również zrozuieć. - </p> - - <p id="690480" class="block-content">Jednakże, jeśli twoja logika biznesowa staje się coraz bardziej złożona, wkrótce będziesz chciał - używać bezpośrednich relacji, zbiorów, dziedziczenia twojego obiektu i tak dalej. Nie da się tego łatwo odwzorować za pomocą Rekordu Aktywnego, - a dodawanie ich po kawałku staje się bardzo kłopotliwe. Innym argumentem przeciw Rekordowi Aktywnemu jest fakt, że łączy model obiektowy z modelem baz danych. - To czyni trudniejszym refaktoring, gdy projekt idzie naprzód. - </p> - - <p id="690481" class="block-content">Alternatywą jest używanie wzorca Data Mapper (mapa danych), który odseparowuje role obiektu biznesowego od tego jak te obiekty są przechowywane. - Prado dostarcza - Prado provides a darmowy wybór pomiędzy rekordem aktywnym a <a href="?page=Database.SqlMap">SqlMap Data Mapper</a>. - SqlMap Data Mapper może być uzywany do wczytania obiektów Rekordu Aktywnego, i na odwrót, te Rekordy Aktywne mogą zostać użyte do aktualizacji bazy danych. - Związek pomiędzy Rekordem Aktywnym a <a href="?page=Database.SqlMap">SqlMap</a> przedstawiony jest na kolejnym diagramie. Więcej informacji związanych z SqlMap Data Mapper można znaleźć w - <a href="http://www.pradosoft.com/demos/sqlmap/">manualu SqlMap</a>. - <img src=<%~ sqlmap_active_record.png %> alt="Active Records and SqlMap DataMapper" id="fig:diagram.png" class="figure"/> - </p> - - <p id="690482" class="block-content"> - Klasa Rekordu aktywnego posiada funkcjonalność do przeprowadzenia następujących zadań: - </p> - <ul id="u1" class="block-content"> - <li>Tworzenie, zwracanie, aktualizowani i usuwanie recordów (CRUD)</li> - <li>metody wyszukujące obudowujące powszechnie używane zapytania SQL i zwracające obiekty Rekordu Aktywnego</li> - <li>Wydobywają relacje (powiazanych obcych obiektów) takie jak "posiada wiele" (ang. has many), "posiada jedno" (ang. has one), "należy do" (ang. belongs to) oraz wiele do wielu "many to many" poprzez tablice asocjacyjne.</li> - <li>Opóźnione ładowanie (ang. Lazy loading) relacji</li> - </ul> -<h2>Implikacje modelu</h2> -<p> -Implementacja wzorca Aktywnego Rekordu w PRADO nie zapewnia referencyjnej tożsamości (ang. referential identity). Każdy istniejący obiekt używający -Rekordu Aktywnego jest koopią danych z bazy danych. Na przykład jeśli zapytasz o konkretnego klienta i zostanie zwrócony obiekt <tt>Klient</tt>, -to następnym razem kiedy zapytasz o tego klienta otrzymasz spowrotem inną instancję obiektu <tt>Klient</tt>. To implikuje, że ścisłe porównianie (np. używając <tt>===</tt>) -zwróci fałsz, natomiast luźne porównianie (np. używając <tt>==</tt>) zwróci prawdę jeśli wartości obiektu są równe poprzez luźne porónanie. -<p> -<p> -Jest to implikacja modelu wynikająca z następującego pytania: -<i>"Czy myślisz o kliencie jako o obiekcie, którego któy jest tylko jeden, czy też myślisz o obiekcie na którym działasz jako o <b>kopii</b> bazy danych.</i> -Inne mapowania O/R implikują, że istnieje tylko jeden obiekt Klienta z KlientID 100 -Other O/R mappings will imply that there is only one Customer object with custID 100 i to dosłownie jest ten klient. -Jeśli pobierzesz klienta i zmienisz pole w nim, wtedy masz zmienionego tego klienta. -<i>"To kontroastuje z: zmieniłeś tą kopię klienta ale nie tamtą kopię. -Jeśli dwóch ludzi zaktualizuje kleinta z dwóch kopii obiektu, kto zaktualizuje pierwszy lub być może ostanie wygrywa."</i> [A. Hejlsberg 2003] -</p> - -<h2 id="142010">Wspierane bazy danych</h2> -<p id="p1" class="block-content"> -Implementacja Aktywnego Rekordu wykorzystuje kalsy <a href="?page=Database.DAO">Prado DAO</a> by uzyskać dostęp do danych. Aktualna implementacja Aktywnego Rekordu wspiera następujace bazy danych -</p> -<ul> - <li><a href="http://www.mysql.com">MySQL 4.1 i wyższe</a></li> - <li><a href="http://www.postgres.com">Postgres SQL 7.3 i wyższe</a></li> - <li><a href="http://www.sqlite.org">SQLite 2 i 3</a></li> - <li><a href="#">MS SQL 2000 i wyższe</a></li> - <li><a href="http://www.oracle.com">Oracle Database (alfa)</a></li> -</ul> -<p id="710009" class="block-content">Wsparcie dla pozostałych baz danych może zostać wprowadzone, keidy będzie dostatecne zapotrzebowanie</p> - -<h1 id="138048">Definiowanie Aktywnego Rekordu</h1> -<p id="690483" class="block-content">Rozważmy następującą tablicę "<tt>users</tt>", która zawiera dwie kolumny nazwane "<tt>username</tt>" oraz "<tt>email</tt>", - gdzie "<tt>username</tt>" jest kluczem głównym. -<com:TTextHighlighter Language="sql" CssClass="source block-content" id="code_690147"> -CREATE TABLE users -( - username VARCHAR( 20 ) NOT NULL , - email VARCHAR( 200 ) , - PRIMARY KEY ( username ) -); -</com:TTextHighlighter> -</p> -<p id="690484" class="block-content">Następnie zdefiniujemy naszą klasę Rekordu Aktywnego odpowiadającą tablicy "<tt>users</tt>". -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690148"> -class UserRecord extends TActiveRecord -{ - const TABLE='users'; //nazwa tablicy - - public $username; //kolumna nazwana "username" w tablicy "users" - public $email; - - /** - * @return TActiveRecord intancja finder rekordu aktywnego - */ - public static function finder($className=__CLASS__) - { - return parent::finder($className); - } -} -</com:TTextHighlighter> -</p> -<p id="690485" class="block-content">Każda kolumna tablicy "<tt>users</tt>" musi posiadać odpowiadającą jej właściwość o tej samej nazwie co kolumna w tablicy w klasie <tt>UserRecord</tt>. - Oczywiście, możesz zdefiniować dodatkowe zmienne lub właściwości, które nie istnieją w strukturze tablicy. - Stała <tt>TABLE</tt> jest opcjonalna w klasie , kiedy nazwa klasy jest taka sama jak nazwa tablicy w bazie danych, w przeciwnym przypadku <tt>TABLE</tt> - musi określać nazwę tablicy, która odpowiada klasie Rekordu Aktywnego. -</p> - -<div class="tip"><b class="note">Tip:</b> -Możesz określić kwalifikowane (ang. qualified) nazwy tablic np dla MySQL, <tt>TABLE = "`bazadanych1`.`tablica1`"</tt>. -</div> - -<p class="block-content" id="ar_as_component"> - Odkąd <tt>TActiveRecord</tt> rozszerza <tt>TComponent</tt>, metody setter i getter mogą zostać zdefiniowane - by umożliwić kontrolę nad tym jak zmienne są ustawiane i zwracane. Na przykłąd dodanie właściwości <tt>$level</tt> - do klasy UserRecord: -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690149"> -class UserRecord extends TActiveRecord { - ... //istniejąca uprzednio część definicji - - private $_level; - public function setLevel($value) { - $this->_level=TPropertyValue::ensureInteger($value,0); - } - public function getLevel($value){ - return $this->_level; - } -} -</com:TTextHighlighter> -<p id="710010" class="block-content">Więcej szczegółów dotyczących TComponent można znaleźć <a href="?page=Fundamentals.Components1">dokumentacji komponentów</a>. -Później użyjemy metod getter/setters by umożliwić opóźnione ładowanie (ang. lazy loading) obiektów relacji. -</p> - -<div class="info"><b class="note">Info:</b> -<tt>TActiveRecord</tt> może również działać z widokami poprzez przypisanie do stałej <tt>TABLE</tt> - odpowiedniej nazwy widoku. Jednakże obiektu zwracane przez widoki są tylko do odczytu, wywołanie metod <tt>save()</tt> lub <tt>delete()</tt> -spowoduje wywołanie wyjątku. -</div> - -<p id="690486" class="block-content"> - Metoda statyczna <tt>finder()</tt> zwraca instancję <tt>UserRecord</tt>, która może zostać użyta do załadowania rekordów z bazy. - Ładowanie rekordów za pomocą tej metody będzie omówione później. Statyczna metoda <tt>TActiveRecord::finder()</tt> - pobiera nazwę klasy Rekord Aktywnego jako parametr. -</p> - -<h2 id="138049">Ustanawianie połączenia z bazą danych</h2> -<p id="690487" class="block-content"> - Domyślne połączenie z bazą dla Rekordu Aktywnego może zostać ustawione następujaco. - Zobacz <a href="?page=Database.DAO">Ustanawianie połączenia z bazą</a> - by uzyskać ogólnie dalsze szczegóły odnośnie tworzenia połączenia z bazą danych. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690150"> -//utwóz połączenie i przekaż je do menadżera Rekordu Aktywnego -$dsn = 'pgsql:host=localhost;dbname=test'; //Postgres SQL -$conn = new TDbConnection($dsn, 'dbuser','dbpass'); -TActiveRecordManager::getInstance()->setDbConnection($conn); -</com:TTextHighlighter> - -<p id="710011" class="block-content">Alternatywnie, możesz stworzyć klasę bazową i nadpisać metodę <tt>getDbConnection()</tt> -do zwracania połączenia z bazą. To jest prosty spodób, by umożliwić wielkokrotne połączenia do wielu baz danych. - Następujący kod demonstruje definiowanie połączenia z bazą danych w klasie bazowej (nie ma potrzeby by ustawiać połączenie DB gdziekolwiek indziej). -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class MyDb1Record extends TActiveRecord -{ - public function getDbConnection() - { - static $conn; - if($conn===null) - $conn = new TDbConnection('xxx','yyy','zzz'); - return $conn; - } -} -class MyDb2Record extends TActiveRecord -{ - public function getDbConnection() - { - static $conn; - if($conn===null) - $conn = new TDbConnection('aaa','bbb','ccc'); - return $conn; - } -} -</com:TTextHighlighter> - - -<h3 class="prado-specific">Używanie <tt>application.xml</tt> w frameworku Prado</h3> -<div class="prado-specific"> -<p id="690488" class="block-content"> - Domyślne połączenie z bazą może zostać również skonfigurowane używając tagu <tt><module></tt> - w pliku <a href="?page=Configurations.AppConfig">application.xml</a> - lub <a href="?page=Configurations.PageConfig">config.xml</a> następująco: -<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_690151"> -<modules> - <module class="System.Data.ActiveRecord.TActiveRecordConfig" EnableCache="true"> - <database ConnectionString="pgsql:host=localhost;dbname=test" - Username="dbuser" Password="dbpass" /> - </module> -</modules> -</com:TTextHighlighter> -<div class="tip"><b class="note">Wskazówka:</b> - Atrybut <tt>EnableCache</tt> gdy ustawiony na "true" będzie keszował metadane tablicy, to oznacza, że nazwy kolumn, indeksy i ograniczenia (ang. constraints) - są zapisywane w keszu i używane ponownie. Musisz wyczyścić lub wyłączyć kesz jeśli chcesz zobaczyć wprowadzone zmiany do definicji twoich tablic. - <a href="?page=Advanced.Performance#6402">Moduł keszowania</a> musi być również zdefiniowany dla keszu by zadziałał. -</div> -</p> - -<p id="690489" class="block-content">Do właściwość <tt>ConnectionID</tt> może zostać przypisana wartość ID z konfiguracji z innego modułu - <tt>TDataSourceConfig</tt>. To pozwala uyżywać to połączenie z bazą danych w innych modułach, takich jak <a href="?page=Database.SqlMap">SqlMap</a> (mapa SQL). -<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_690152"> -<modules> - <module class="System.Data.TDataSourceConfig" id="db1"> - <database ConnectionString="pgsql:host=localhost;dbname=test" - Username="dbuser" Password="dbpass" /> - </module> - - <module class="System.Data.ActiveRecord.TActiveRecordConfig" - ConnectionID="db1" EnableCache="true" /> - - <module class="System.Data.SqlMap.TSqlMapConfig" - ConnectionID="db1" ... /> -</modules> -</com:TTextHighlighter> -</p> -</div> - -<h2 id="138050">Ładowanie danych z tablicy</h2> -<p id="690490" class="block-content"> - Klasa <tt>TActiveRecord</tt> dostarcza wielu wygodnych metod do wyszukiwania rekordów z bazy danych. - Najprostszym jest znajdowanie jednego rekordu poprzez dopasowanie klucza głównego lub klucza złożonego (ang. composite key) - (klucz główny skłądający się z wielu kolumn). - Zobacz <com:DocLink ClassPath="System.Data.ActiveRecord.TActiveRecord" /> by dowiedzieć się więcej. -</p> - -<div class="info"><b class="note">Info:</b> -Wszystkie metody wyszukujące, które mogą zwrócić tylko 1 rekord zwrócą <tt>null</tt> jeśli nie znajdą pasujących danych. -Wszystkie metody wyszukujące, które zwracają tablicę rekordów zwrócą pustą tablicęm jeśli nie znajdą pasujących danych. -</div> - - <h3 id="138055"><tt>findByPk()</tt></h3> - <p id="690491" class="block-content">Znajduje jeden rekord używając klucza głównego lub klucza złożonego. -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690153"> -$finder = UserRecord::finder(); -$user = $finder->findByPk($primaryKey); - -//kiedy tablica używa klucza złożonego -$record = $finder->findByPk($key1, $key2, ...); -$record = $finder->findByPk(array($key1, $key2,...)); -</com:TTextHighlighter> -</p> - - <h3 id="138056"><tt>findAllByPks()</tt></h3> - <p id="690492" class="block-content">Znajduje wiele rekordów używając listy kluczy głównych lub kluczy złożonych. -Co następuje jest odpowiednie dla kluczów głównych (klucz główny składa się tylko z jednego pola/kolumny) -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690154"> -$finder = UserRecord::finder(); -$users = $finder->findAllByPks($key1, $key2, ...); -$users = $finder->findAllByPks(array($key1, $key2, ...)); -</com:TTextHighlighter> -Co następuje jest odpowiednie dla kluczów złożonych: -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690155"> -//kiedy tablica używa klucza złożonego -$record = $finder->findAllByPks(array($key1, $key2), array($key3, $key4), ...); - -$keys = array( array($key1, $key2), array($key3, $key4), ... ); -$record = $finder->findAllByPks($keys); -</com:TTextHighlighter> - - -<h3 id="138057"><tt>find()</tt></h3> -<p id="690493" class="block-content">Znajduje <b>pojedyńczy rekord</b>, który spełnia kryteria. Kryteria mogą być częściowym łąńcuchem SQL lub obiektem <tt>TActiveRecordCriteria</tt></p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690156"> -$finder = UserRecord::finder(); - -//:name oraz :pass są pojemnikami dla konkretnych wartości $name oraz $pass -$finder->find('username = :name AND password = :pass', - array(':name'=>$name, ':pass'=>$pass)); - -//użycie znaków zastępczych -$finder->find('username = ? AND password = ?', array($name, $pass)); -//jak wyżej -$finder->find('username = ? AND password = ?', $name, $pass); - -//$criteria są typu TActiveRecordCriteria -$finder->find($criteria); //drugi parametr dla find() jest zignorowany. -</com:TTextHighlighter> - -<p id="690494" class="block-content">Klasa <tt>TActiveRecordCriteria</tt> ma następujące właściwości: -</p> - <ul id="u2" class="block-content"> - <li><tt>Parameters</tt> -- pary wartość nazwa parametru.</li> - <li><tt>OrdersBy</tt> -- nazwa kolumny i sortowanie par</li> - <li><tt>Condition</tt> -- część WHERE zapytania SQL</li> - <li><tt>Limit</tt> -- maksymalna ilość rekordów, któe zostaną zwrócone.</li> - <li><tt>Offset</tt> -- offset rekordów w tablicy.</li> - </ul> - -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690157"> -$criteria = new TActiveRecordCriteria; -$criteria->Condition = 'username = :name AND password = :pass'; -$criteria->Parameters[':name'] = 'admin'; -$criteria->Parameters[':pass'] = 'prado'; -$criteria->OrdersBy['level'] = 'desc'; -$criteria->OrdersBy['name'] = 'asc'; -$criteria->Limit = 10; -$criteria->Offset = 20; -</com:TTextHighlighter> - -<div class="note"><b class="note">Przypis:</b> -For MSSQL and when <tt>Limit</tt> and <tt>Offset</tt> are positive integer values. The -actual query to be executed is modified by the -<com:DocLink ClassPath="System.Data.ActiveRecord.Common.Mssql.TMssqlCommandBuilder" -Text="TMssqlCommandBuilder" -/> -class according to -<a href="http://troels.arvin.dk/db/rdbms/#select-limit-offset">http://troels.arvin.dk/db/rdbms/</a> -to emulate the <tt>Limit</tt> and <tt>Offset</tt> conditions. -</div> - -<h3 id="138058"><tt>findAll()</tt></h3> -<p id="690495" class="block-content">Podobnie jak <tt>find()</tt> ale zwraca tablicę obiektów.</p> - -<h3 id="138059"><tt>findBy*()</tt> oraz <tt>findAllBy*()</tt></h3> -<p id="690496" class="block-content">Dynamiczne metody wyszukujące używające część nazwy metody jako kryteria wyszukiwania. -Metody zaczynające się od słów <tt>findBy</tt> zwracają tylko 1 rekord natomiast metody zaczynające się <tt>findAllBy</tt> zwracają tablicę obiektów. -Warunej jest wzięty jako część nazwy metody po przedrostku <tt>findBy</tt> lub <tt>findAllBy</tt>. - -Następujące bloki kodów są sobie równoważne: -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690158"> -$finder->findByName($name) -$finder->find('Name = ?', $name); -</com:TTextHighlighter> - -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690159"> -$finder->findByUsernameAndPassword($name,$pass); -$finder->findBy_Username_And_Password($name,$pass); -$finder->find('Username = ? AND Password = ?', $name, $pass); -</com:TTextHighlighter> - -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690160"> -$finder->findAllByAge($age); -$finder->findAll('Age = ?', $age); -</com:TTextHighlighter> - -<div class="tip"><b class="note">Tip:</b> -Możesz również użyć połączenia <tt>AND</tt> oraz <tt>OR</tt> jako warunek w dynamicznych metodach. -</div> - -<h3 id="138060"><tt>findBySql()</tt> oraz <tt>findAllBySql()</tt></h3> -<p id="690497" class="block-content">Znajdują rekordy używając pełnego zapytania SQL z tym, że <tt>findBySql()</tt> -zwraca Rekord Aktywny a <tt>findAllBySql()</tt>zwraca tablicę obiektów rekordów. -Dla każdej zwróconej kolumny, odpowiadająca klasa Rekordu Aktywnego musi posiadać zdefiniowaną zmienną lub właściwość odpowiadającą nazwie kolumny. -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class UserRecord2 extends UserRecord -{ - public $another_value; -} -$sql = "SELECT users.*, 'hello' as another_value FROM users"; -$users = TActiveRecord::finder('UserRecord2')->findAllBySql($sql); -</com:TTextHighlighter> -</p> -<h3 id="138061"><tt>count()</tt></h3> -<p id="690498" class="block-content">Zlicza ilość pasujących rekordów, akceptuje te same parametry co metoda <tt>findAll()</tt></p> - -<h2 id="138051">Wstawianie i aktualizowanie rekordów</h2> -<p id="690499" class="block-content"> -Dodanie nowego rekordu za pomocą TActiveRecord jest bardzo łatwe, po prostu stwórz nowy obiekt Rekordu Aktywnego i wywołaj metodę <tt>save()</tt>. Na przykład -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690161"> -$user1 = new UserRecord(); -$user1->username = "admin"; -$user1->email = "admin@example.com"; -$user1->save(); //wstaw nowy rekord - -$data = array('username'=>'admin', 'email'=>'admin@example.com'); -$user2 = new UserRecord($data); //stwórz przekazując istniejące dane -$user2->save(); //wstaw nowy rekord -</com:TTextHighlighter> -<div class="tip"><b class="note">Wskazówka:</b> -Obiekty są aktualizowe automatycznie o wartość klucza głównego dla tych tablic, które zawierają definicję -określającą automatyczne tworzenie klucza głównego dla nowo tworzonych rekordów (przyp. tłum. autoincrement). -Na przykład jeśli wstawiasz nowy rekord do tablicy MySQL która posiada kolumnę zdefiniowaną jako to obiekt Rekordu Aktywnego -zostanie zaktualizowant o nową zwiększoną wartość.</div> - -<p id="690500" class="block-content"> -Aby zaktualizować rekord w bazie danych po prostu zmień jedną lub więcej właściwości obiektu Rekordu Aktywnego które zostały odczytane z bazy a następnie wywołaj metodę <tt>save()</tt>. - -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690162"> -$user = UserRecord::finder()->findByName('admin'); -$user->email="test@example.com"; //zmiana właściwości -$user->save(); //zaktualizuj ją -</com:TTextHighlighter> -</p> - -<p id="710012" class="block-content"> -Obiekt Rekordu Aktywnego posiada prosty cykl życia zilustrowany następujący diagram. -</p> -<img src=<%~ object_states.png %> alt="Active Records Life Cycle" id="fig:cycle.png" class="figure"/> -<p id="690501" class="block-content"> -Widzimy, że nowe obiekty Rekordu Aktywnego są tworzone zarówno przez jedną z metod <tt>find*()</tt> -lub poprzez stworzenie nowej instancji poprzez użycie polecenia PHP <tt>new</tt>. Obiekty stworzone przez metodę <tt>find*()</tt> -zaczynają ze stanem <tt>czysty (ang. clean)</tt>. Nowa instancja TActiveRecord stworzona inaczej niż za pomocą metod <tt>find*()</tt> zaczyna ze stanem <tt>nowy (ang. new)</tt>. -Kiedykolwiek wywołasz metodę <tt>save()</tt> na obiekcie TActiveRecord, obiekt przyjmuje stan <tt>czysty</tt>. -Obiekty będące <tt>czystymi</tt> stają się <tt>brudne (ang. dirty)</tt> kiedy jeden lub więcej ze stwoich wewnętrznych stanów ulegnie zmianie. -Wywoałanie metody <tt>delete()</tt> obiektu kończy cykl życia, żadne inne akcje nie mogą być wywołane na obiekcie. -</p> - -<h2 id="138052">Usuwanie istniejących obiektów</h2> -<p id="690502" class="block-content"> - Aby usunąc istniejący rekord, który jest załadowany, po prostu wywołaj metodę <tt>delete</tt>. - Możesz rónież usunąć rekord w bazie danych poprzez klucz główny bez ładowania żadnego rekordu używając metody - <tt>deleteByPk()</tt> (również metoda <tt>deleteAllByPks()</tt>). - Na przykład, aby usunąć jeden lub więcej rekordów z tabeli używając jednego lub wielu kluczów głównych: -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690163"> -$finder->deleteByPk($primaryKey); //usuwanie 1 rekordu -$finder->deleteAllByPks($key1,$key2,...); //usuwanie wielu rekordów -$finder->deleteAllByPks(array($key1,$key2,...)); //usuwanie wielu rekordów -</com:TTextHighlighter> - -<p id="690503" class="block-content"> -Dla klucza złożonego (ustalanego automatycznie na podstawie definicji tablicy): -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690164"> -$finder->deleteByPk(array($key1,$key2)); //usuwanie 1 rekordu - -//usuwanie wielu rekordów -$finder->deleteAllByPks(array($key1,$key2), array($key3,$key4),...); - -//usuwanie wielu rekordów -$finder->deleteAllByPks(array( array($key1,$key2), array($key3,$key4), .. )); -</com:TTextHighlighter> - -<h3 id="138052a"><tt>deleteAll()</tt> oraz <tt>deleteBy*()</tt></h3> -<p id="690502a" class="block-content"> -Aby usunąć używając kryteria użyj <tt>deleteAll($criteria)</tt> oraz <tt>deleteBy*()</tt> -z podobną składnią jak <tt>findAll($criteria)</tt> oraz <tt>findAllBy*()</tt> opisaną wcześniej. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690163a"> -//usuwanie wszystkich rekordów z pasującym Name -$finder->deleteAll('Name = ?', $name); -$finder->deleteByName($name); - -//usuwanie na podstawie Name oraz Password -$finder->deleteBy_Username_And_Password($name,$pass); -</com:TTextHighlighter> - -<h2 id="138053">Tranzakcje</h2> -<p id="690504" class="block-content">Wszystkie obiekkty Rekordu Aktywnego zawierają właściwość <tt>DbConnection</tt>, - która może być używana by uzyskać obiekt tranzakcyjny. -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_690165"> -$finder = UserRecord::finder(); -$finder->DbConnection->Active=true; //otwórz jeśli to konieczne -$transaction = $finder->DbConnection->beginTransaction(); -try -{ - $user = $finder->findByPk('admin'); - $user->email = 'test@example.com'; //zmień obiekt użytkownika $user - $user->save(); - $transaction->commit(); -} -catch(Exception $e) // wyjątek jest wołany jeśli zapytanie nie powiedzie się -{ - $transaction->rollBack(); -} -</com:TTextHighlighter> - -<h2 id="142011">Zdarzenia</h2> -<p id="710013" class="block-content"> -Rekord Aktywny oferuje dwa zdarzenia: <tt>OnCreateCommand</tt> oraz <tt>OnExecuteCommand</tt>. -</p> - -<p id="710014" class="block-content">Zdarzenie <tt>OnCreateCommand</tt> jest wołane gdy polecenie jest przygotowywane i przypisywanie (ang. binding) parametrów jest zakończone. - Parametrem obiektu jest <tt>TDataGatewayEventParameter</tt>, którego właściwość <tt>Command</tt> może być sprawdzona by otrzymać zapytanie, które będzie wykonane wykonywane. -</p> - -<p id="710015" class="block-content"> -Zdarzenie <tt>OnExecuteCommand</tt> jest wywoływane kiedy polecenie jest wykonane i rezultat z bazy danych został zwrócony. - Parametrem obiektu jest <tt>TDataGatewayResultEventParameter</tt>, którego właściwość <tt>Result</tt> zawiera dane zwrócone z bazy danych. - Dane zwrócone mogą zostać zmienione poprzez ustawienie właściwości <tt>Result</tt>. -</p> - -<h3 id="142016">Przykład z logowaniem</h3> -<p id="710016" class="block-content">Używając <tt>OnExecuteCommand</tt> możemy przypiąć uchwyt zdarzenia by logować całe -zapytanie SQL wwywoływane dla danej instancji lub klasy TActiveRecord. Na przykład definiujemy klasę bazową i nadpisujemy -metodę <tt>getDbConnection()</tt> lub konstruktor. -</p> - -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class MyDb1Record extends TActiveRecord -{ - public function getDbConnection() - { - static $conn; - if($conn===null) - { - $conn = new TDbConnection('xxx','yyy','zzz'); - $this->OnExecuteCommand[] = array($this,'logger'); - } - return $conn; - } - public function logger($sender,$param) - { - var_dump($param->Command->Text); - } -} -//alternatively as per instance of per finder object -function logger($sender,$param) -{ - var_dump($param->Command->Text); -} -TActiveRecord::finder('MyRecord')->OnExecuteCommand[] = 'logger'; -$obj->OnExecuteCommand[] = array($logger, 'log'); //dowolny poprawny callback PHP -</com:TTextHighlighter> - -<h1 id="ar_relations">Relacje dla Rekordu Aktywnego</h1> -<com:SinceVersion Version="3.1rc1" /> -<p id="690504a" class="block-content"> -Implementacja Rekordu Aktywnego w Prado wspiera mapowanie kluczów obcych dla baz, które wspierają ograniczenia (ang. constraints) kluczów obcych. - Aby relacje dla Rekordu Aktywnego działały używana baza danych musi wspierać ograniczenia klucza głównego (np. MySQL używająca InnoDB) -</p> - -<p id="710017" class="block-content"> -W następnych sekcjach będziemy rozważać nastepujące relacje pomiędzy tabelami <tt>Teams</tt>, <tt>Players</tt>, <tt>Skills</tt> oraz <tt>Profiles</tt>. -</p> -<img src=<%~ ar_relations.png %> class="figure" /> - - -<p id="710018" class="block-content">Celem jest uzyskanie modelu obiektowego, który będzie reprezetnował w pewnym stopniu relacje pomiędzy polami z powyższego rysunku. -</p> - -<img src=<%~ ar_objects.png %> class="figure" /> - -<p class="block-content"> -Istnieje rozbieżność pomiędzy relacjami w obiektach i relacjami w tablicach. - Po pierwsze jest różnica w reprezentacji. Obiekty trzymają powiązanie poprzez przechowywanie referencji, -które są trzymane poprzez zarządzające pamięcią środowiko uruchomieniowe. Bazy relacyjne trzymają powiązanie poprzez utworzenie klucza do innej tablicy. - Po drugie, obiekty mogą łatwo uzywać kolekcji by trzymać wielokrotnie referencje z jednego pola, -to handle multiple references from a single field, gdyż normalizacja zmusza wszystkie powiązania relacji encji by były pojedyńczymi wartościami. -To prowadzi do odwrócenia struktury danych pomiędzy obiektami i tablicami. -Podejście zastosowane w modelu Rekordu Aktywnego Prado uzywa ograniczeń kluczów obcych tablicy do wyprowadzenia relacji obiektów. -To implikuje fakt wspierania ograniczeń kluczów obcych dla bazy danych. -</p> -<div class="tip"><b class="note">Tip:</b> -Dla baz danych SQLite możesz stworzyć tablice, które definiują ograniczenia kluczó obcych tak jak na przykładzie poniżej. -Jednakże te ograniczenia <b>NIE SĄ</b> narzucane przez samą bazę SQLite. -<com:TTextHighlighter Language="sql" CssClass="source block-content"> -CREATE TABLE foo -( - id INTEGER NOT NULL PRIMARY KEY, - id2 CHAR(2) -); -CREATE TABLE bar -( - id INTEGER NOT NULL PRIMARY KEY, - foo_id INTEGER - CONSTRAINT fk_foo_id REFERENCES foo(id) ON DELETE CASCADE -); -</com:TTextHighlighter> -</div> - -<h2 id="142012">Mapowanie kluczów obcych</h2> -<p class="block-content">Relacja pól pomiędzy tablicami <tt>Teams</tt> and <tt>Players</tt> jest znana jako relacja jeden-do-wielu (ang. 1-M). Oznacza to, że jeden Team moze zawierać zero lub więcej Players. Z punktu widzenia relacji obiektów -powiemy, że obiekt <tt>TeamRecord</tt> <b>posiada wiele</b> (ang. has many) obiektów <tt>PlayerRecord</tt>. -(Zauważ odwrócenie kierunku relacji pomiędzy tablicami a obiektami) -</p> - -<h3 id="142017">Relacja posiada wiele (ang. has Many Relationship)</h3> -<p id="710020" class="block-content"> -Zamodelujemy obiekt <tt>Team</tt> jako następującą klasę Rekordu Aktywnego. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class TeamRecord extends TActiveRecord -{ - const TABLE='Teams'; - public $name; - public $location; - - public $players=array(); // this declaration is no longer needed since v3.1.2 - - //define the $player member having has many relationship with PlayerRecord - public static $RELATIONS=array - ( - 'players' => array(self::HAS_MANY, 'PlayerRecord', 'team_name'), - ); - - public static function finder($className=__CLASS__) - { - return parent::finder($className); - } -} -</com:TTextHighlighter> -<p id="710021" class="block-content"> -The static <tt>$RELATIONS</tt> property of <tt>TeamRecord</tt> defines that the -property <tt>$players</tt> <b>has many</b> <tt>PlayerRecord</tt>s. Multiple relationships -is permitted by defining each relationship with an entry in the <tt>$RELATIONS</tt> -array where array key for the entry corresponds to the property name. -In <tt>array(self::HAS_MANY, 'PlayerRecord')</tt>, the first element defines the -relationship type, the valid types are <tt>self::HAS_MANY</tt>, <tt>self::HAS_ONE</tt>, -<tt>self::BELONGS_TO</tt> and <tt>self::MANY_TO_MANY</tt>. -The second element is a string <tt>'PlayerRecord'</tt> that corresponds to the -class name of the <tt>PlayerRecord</tt> class. -And the third element 'team_name' refers to the foreign key column in the Players table that -references to the Teams table. -</p> - -<div class="note"><b class="note">Note:</b> -As described in the code comment above, since version <b>3.1.2</b>, related properties no longer -need to be explicitly declared. By default, they will be implicitly declared according to -keys of the <tt>$RELATIONS</tt> array. A major benefit of declared related properties implicitly -is that related objects can be automatically loaded in a lazy way. For example, assume we have -a <tt>TeamRecord</tt> instance <tt>$team</tt>. We can access the players via <tt>$team->players</tt>, -even if we have never issued fetch command for players. If <tt>$players</tt> is explicitly declared, -we will have to use the <tt>with</tt> approach described in the following to fetch the player records. -</div> - -<p id="710022" class="block-content"> -The foreign key constraint of the <tt>Players</tt> table is used to determine the corresponding -<tt>Teams</tt> table's corresponding key names. This is done automatically handled -in Active Record by inspecting the <tt>Players</tt> and <tt>Teams</tt> table definitions. -</p> - -<div class="info"><b class="note">Info:</b> -Since version <b>3.1.2</b>, Active Record supports multiple foreign key -references of the same table. Ambiguity between multiple foreign key references to the same table is -resolved by providing the foreign key column name as the 3rd parameter in the relationship array. -For example, both of the following foreign keys <tt>owner_id</tt> and <tt>reporter_id</tt> -references to the same table defined in <tt>UserRecord</tt>. -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class TicketRecord extends TActiveRecord -{ - public $owner_id; - public $reporter_id; - - public $owner; // this declaration is no longer needed since v3.1.2 - public $reporter; // this declaration is no longer needed since v3.1.2 - - public static $RELATION=array - ( - 'owner' => array(self::BELONGS_TO, 'UserRecord', 'owner_id'), - 'reporter' => array(self::BELONGS_TO, 'UserRecord', 'reporter_id'), - ); -} -</com:TTextHighlighter> -This is applicable to relationships including <tt>BELONGS_TO</tt>, <tt>HAS_ONE</tt> and -<tt>HAS_MANY</tt>. See section <a href="#142021">Self Referenced Association Tables</a> for solving ambiguity of <tt>MANY_TO_MANY</tt> -relationships. -</div> - -<p id="710023" class="block-content">The "has many" relationship is not fetched automatically when you use any of the Active Record finder methods. -You will need to explicitly fetch the related objects as follows. In the code below, both lines -are equivalent and the method names are case insensitive. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -$team = TeamRecord::finder()->withPlayers()->findAll(); -$team = TeamRecord::finder()->with_players()->findAll(); //equivalent -</com:TTextHighlighter> -<p id="710024" class="block-content"> -The method <tt>with_xxx()</tt> (where <tt>xxx</tt> is the relationship property -name, in this case, <tt>players</tt>) fetches the corresponding PlayerRecords using -a second query (not by using a join). The <tt>with_xxx()</tt> accepts the same -arguments as other finder methods of TActiveRecord, e.g. <tt>with_players('age = ?', 35)</tt>. -</p> - -<div class="note"><b class="note">Note:</b> -It is essential to understand that the related objects are fetched using additional -queries. The first query fetches the source object, e.g. the <tt>TeamRecord</tt> in the above example code. -A second query is used to fetch the corresponding related <tt>PlayerRecord</tt> objects. -The usage of the two query is similar to a single query using Left-Outer join with the -exception that null results on the right table -are not returned. The consequence of using two or more queries is that the aggregates -and other join conditions are not feasible using Active Records. For queries outside the -scope of Active Record the <a href="?page=Database.SqlMap">SqlMap Data Mapper</a> may be considered. -</div> - -<div class="info"><b class="info">Info:</b> -The above <tt>with</tt> approach also works with implicitly declared related properties (introduced -in version 3.1.2). So what is the difference between the <tt>with</tt> approach and the lazy loading -approach? Lazy loading means we issue an SQL query if a related object is initially accessed and not ready, -while the <tt>with</tt> approach queries for the related objects once for all, no matter the related objects -are accessed or not. The lazy loading approach is very convenient since we do not need to explictly -load the related objects, while the <tt>with</tt> approach is more efficient if multiple records are -returned, each with some related objects. -</div> - -<h3 id="142019">Has One Relationship</h3> -<p id="710030" class="block-content">The entity relationship between <tt>Players</tt> and <tt>Profiles</tt> is one to one. That is, -each <tt>PlayerRecord</tt> object <b>has one</b> <tt>ProfileRecord</tt> object (may be none or null). -A <b>has one</b> relationship is nearly identical to a <b>has many</b> relationship with the exception -that the related object is only one object (not a collection of objects). -</p> - -<h3 id="142018">Belongs To Relationship</h3> -<p id="710025" class="block-content">The "has many" relationship in the above section defines a collection of foreign -objects. In particular, we have that a <tt>TeamRecord</tt> has many (zero or more) -<tt>PlayerRecord</tt> objects. We can also add a back pointer by adding a property -in the <tt>PlayerRecord</tt> class that links back to the <tt>TeamRecord</tt> object, -effectively making the association bidirectional. -We say that the <tt>$team</tt> property in <tt>PlayerRecord</tt> class <tt>belongs to</tt> a <tt>TeamRecord</tt> object. -The following code defines the complete <tt>PlayerRecord</tt> class with 3 relationships. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class PlayerRecord extends TActiveRecord -{ - const TABLE='Players'; - public $player_id; - public $age; - public $team_name; - - public $team; // this declaration is no longer needed since v3.1.2 - public $skills=array(); // this declaration is no longer needed since v3.1.2 - public $profile; // this declaration is no longer needed since v3.1.2 - - public static $RELATIONS=array - ( - 'team' => array(self::BELONGS_TO, 'TeamRecord', 'team_name'), - 'skills' => array(self::MANY_TO_MANY, 'SkillRecord', 'Player_Skills'), - 'profile' => array(self::HAS_ONE, 'ProfileRecord', 'player_id'), - ); - - public static function finder($className=__CLASS__) - { - return parent::finder($className); - } -} -</com:TTextHighlighter> -<p id="710026" class="block-content"> -The static <tt>$RELATIONS</tt> property of <tt>PlayerRecord</tt> defines that the -property <tt>$team</tt> <b>belongs to</b> a <tt>TeamRecord</tt>. -The <tt>$RELATIONS</tt> array also defines two other relationships that we -shall examine in later sections below. -In <tt>array(self::BELONGS_TO, 'TeamRecord', 'team_name')</tt>, the first element defines the -relationship type, in this case <strong><tt>self::BELONGS_TO</tt></strong>; -the second element is a string <tt>'TeamRecord'</tt> that corresponds to the -class name of the <tt>TeamRecord</tt> class; and the third element 'team_name' refers -to the foreign key of Players referencing Teams. -A player object with the corresponding team object may be fetched as follows. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -$players = PlayerRecord::finder()->with_team()->findAll(); -</com:TTextHighlighter> - -<p id="710027" class="block-content"> - The method <tt>with_xxx()</tt> (where <tt>xxx</tt> is the relationship property - name, in this case, <tt>team</tt>) fetches the corresponding <tt>TeamRecords</tt> using - a second query (not by using a join). The <tt>with_xxx()</tt> accepts the same -arguments as other finder methods of <tt>TActiveRecord</tt>, e.g. -<tt>with_team('location = ?', 'Madrid')</tt>. -</p> - -<div class="tip"><b class="note">Tip:</b> -Additional relationships may be fetched by chaining the <tt>with_xxx()</tt> together as the following -example demonstrates. -<com:TTextHighlighter Language="php" CssClass="source block-content"> -$players = PlayerRecord::finder()->with_team()->with_skills()->findAll(); -</com:TTextHighlighter> -Each <tt>with_xxx()</tt> method will execute an additional SQL query. Every -<tt>with_xxx()</tt> accepts arguments similar to those in the <tt>findAll()</tt> method and is only -applied to that particular relationship query. -</div> - -<p id="710028" class="block-content">The "belongs to" relationship of <tt>ProfileRecord</tt> class is defined similarly.</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class ProfileRecord extends TActiveRecord -{ - const TABLE='Profiles'; - public $player_id; - public $salary; - - public $player; // this declaration is no longer needed since v3.1.2 - - public static $RELATIONS=array - ( - 'player' => array(self::BELONGS_TO, 'PlayerRecord'), - ); - - public static function finder($className=__CLASS__) - { - return parent::finder($className); - } -} -</com:TTextHighlighter> - -<p id="710029" class="block-content">In essence, there exists a "<b>belongs to</b>" relationship for objects corresponding to -entities that has column which are foreign keys. In particular, we see that -the <tt>Profiles</tt> table has a foreign key constraint on the column <tt>player_id</tt> -that relates to the <tt>Players</tt> table's <tt>player_id</tt> column. Thus, the <tt>ProfileRecord</tt> -object has a property (<tt>$player</tt>) that <b>belongs to</b> a <tt>PlayerRecord</tt> object. -Similarly, the <tt>Players</tt> table has a foreign key constraint on the column <tt>team_name</tt> that relates to the -<tt>Teams</tt> table's <tt>name</tt> column. -Thus, the <tt>PlayerRecord</tt> object has a property (<tt>$team</tt>) that <b>belongs to</b> a -<tt>TeamRecord</tt> object. -</p> - -<h3 id="142020">Parent Child Relationships</h3> -<p id="710031" class="block-content">A parent child relationship can be defined using a combination of <tt>has many</tt> and <tt>belongs to</tt> -relationship that refers to the same class. The following example shows a parent children relationship between -"categories" and a "parent category". -</p> - -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class Category extends TActiveRecord -{ - public $cat_id; - public $category_name; - public $parent_cat_id; - - public $parent_category; // this declaration is no longer needed since v3.1.2 - public $child_categories=array(); // this declaration is no longer needed since v3.1.2 - - public static $RELATIONS=array - ( - 'parent_category' => array(self::BELONGS_TO, 'Category', 'parent_cat_id'), - 'child_categories' => array(self::HAS_MANY, 'Category', 'parent_cat_id'), - ); -} -</com:TTextHighlighter> - -<h3>Query Criteria for Related Objects</h3> -<p> -In the above, we show that an Active Record object can reference to its related objects by -declaring a static class member $RELATIONS which specifies a list of relations. Each relation -is specified as an array consisting of three elements: relation type, related AR class name, -and the foreign key(s). For example, we use <tt>array(self::HAS_MANY, 'PlayerRecord', 'team_name')</tt> -to specify the players in a team. There are two more optional elements that can be specified -in this array: query condition (the fourth element) and parameters (the fifth element). -They are used to control how to query for the related objects. For example, if we want to obtain -the players ordered by their age, we can specify <tt>array(self::HAS_MANY, 'PlayerRecord', 'team_name', 'ORDER BY age')</tt>. -If we want to obtain players whose age is smaller than 30, we could use -<tt>array(self::HAS_MANY, 'PlayerRecord', 'team_name', 'age<:age', array(':age'=>30))</tt>. In general, -these two additional elements are similar as the parameters passed to the <tt>find()</tt> method in AR. -</p> - - - -<h2 id="142013">Association Table Mapping</h2> -<p id="710032" class="block-content"> -Objects can handle multivalued fields quite easily by using collections as field values. -Relational databases don't have this feature and are constrained to single-valued fields only. -When you're mapping a one-to-many association you can handle this using <b>has many</b> relationships, -essentially using a foreign key for the single-valued end of the association. -But a many-to-many association can't do this because there is no single-valued end to -hold the foreign key. -</p> -<p id="710033" class="block-content"> -The answer is the classic resolution that's been used by relational data people -for decades: create an extra table (an association table) to record the relationship. -The basic idea is using an association table to store the association. This table -has only the foreign key IDs for the two tables that are linked together, it has one -row for each pair of associated objects. -</p> -<p id="710034" class="block-content"> -The association table has no corresponding in-memory object and its primary key is the -compound of the two primary keys of the tables that are associated. -In simple terms, to load data from the association table you perform two queries (in general, it may also be achieved using one query consisting of joins). -Consider loading the <tt>SkillRecord</tt> collection for a list <tt>PlayerRecord</tt> objects. -In this case, you do queries in two stages. -The first stage queries the <tt>Players</tt> table to find all the rows of the players you want. -The second stage finds the <tt>SkillRecord</tt> object for the related player ID for each row -in the <tt>Player_Skills</tt> association table using an inner join. -</p> - -<p id="710035" class="block-content">The Prado Active Record design implements the two stage approach. For the -<tt>Players</tt>-<tt>Skills</tt> M-N (many-to-many) entity relationship, we -define a <b>many-to-many</b> relationship in the <tt>PlayerRecord</tt> class and -in addition we may define a <b>many-to-many</b> relationship in the <tt>SkillRecord</tt> class as well. -The following sample code defines the complete <tt>SkillRecord</tt> class with a -many-to-many relationship with the <tt>PlayerRecord</tt> class. (See the <tt>PlayerRecord</tt> -class definition above to the corresponding many-to-many relationship with the <tt>SkillRecord</tt> class.) -</p> - -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class SkillRecord extends TActiveRecord -{ - const TABLE='Skills'; - public $skill_id; - public $name; - - public $players=array(); // this declaration is no longer needed since v3.1.2 - - public static $RELATIONS=array - ( - 'players' => array(self::MANY_TO_MANY, 'PlayerRecord', 'Player_Skills'), - ); - - public static function finder($className=__CLASS__) - { - return parent::finder($className); - } -} -</com:TTextHighlighter> - -<p id="710036" class="block-content"> -The static <tt>$RELATIONS</tt> property of SkillRecord defines that the -property <tt>$players</tt> has many <tt>PlayerRecord</tt>s via an association table '<tt>Player_Skills</tt>'. -In <tt>array(self::MANY_TO_MANY, 'PlayerRecord', 'Player_Skills')</tt>, the first element defines the -relationship type, in this case <strong><tt>self::MANY_TO_MANY</tt></strong>, -the second element is a string <tt>'PlayerRecord'</tt> that corresponds to the -class name of the <tt>PlayerRecord</tt> class, and the third element is the name -of the association table name. -</p> - -<div class="note"><b class="note">Note:</b> -Prior to version <b>3.1.2</b> (versions up to 3.1.1), the many-to-many relationship was -defined using <tt>self::HAS_MANY</tt>. For version <b>3.1.2</b> onwards, this must be changed -to <tt>self::MANY_TO_MANY</tt>. This can be done by searching for the <tt>HAS_MANY</tt> in your -source code and carfully changing the appropriate definitions. -</div> - -<p id="710037" class="block-content"> -A list of player objects with the corresponding collection of skill objects may be fetched as follows. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -$players = PlayerRecord::finder()->withSkills()->findAll(); -</com:TTextHighlighter> -<p id="710038" class="block-content"> -The method <tt>with_xxx()</tt> (where <tt>xxx</tt> is the relationship property -name, in this case, <tt>Skill</tt>) fetches the corresponding <tt>SkillRecords</tt> using -a second query (not by using a join). The <tt>with_xxx()</tt> accepts the same -arguments as other finder methods of <tt>TActiveRecord</tt>. -</p> - -<h3 id="142021">Self Referenced Association Tables</h3> -<p id="710039" class="block-content"> -For self referenced association tables, that is, the association points to the same -table. For example, consider the <tt>items</tt> table with M-N related -item via the <tt>related_items</tt> association table. The syntax in the following -example is valid for a PostgreSQL database. For other database, consult their respective documentation for -defining the foreign key constraints. -<com:TTextHighlighter Language="sql" CssClass="source block-content"> -CREATE TABLE items -( - "item_id" SERIAL, - "name" VARCHAR(128) NOT NULL, - PRIMARY KEY("item_id") -); -CREATE TABLE "related_items" -( - "item_id" INTEGER NOT NULL, - "related_item_id" INTEGER NOT NULL, - CONSTRAINT "related_items_pkey" PRIMARY KEY("item_id", "related_item_id"), - CONSTRAINT "related_items_item_id_fkey" FOREIGN KEY ("item_id") - REFERENCES "items"("item_id") - ON DELETE CASCADE - ON UPDATE NO ACTION - NOT DEFERRABLE, - CONSTRAINT "related_items_related_item_id_fkey" FOREIGN KEY ("related_item_id") - REFERENCES "items"("item_id") - ON DELETE CASCADE - ON UPDATE NO ACTION - NOT DEFERRABLE -); -</com:TTextHighlighter> - -<p id="710040" class="block-content">The association table name in third element of the relationship array may -contain the foreign table column names. The columns defined in the association -table must also be defined in the record class (e.g. the <tt>$related_item_id</tt> property -corresponds to the <tt>related_item_id</tt> column in the <tt>related_items</tt> table). -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class Item extends TActiveRecord -{ - const TABLE="items"; - public $item_id; - public $details; - - //additional foreign item id defined in the association table - public $related_item_id; - public $related_items=array(); // this declaration is no longer needed since v3.1.2 - - public static $RELATIONS=array - ( - 'related_items' => array(self::MANY_TO_MANY, - 'Item', 'related_items.related_item_id'), - ); -} -</com:TTextHighlighter> -<div class="tip"><b class="note">Tip:</b> -Compound keys in the foreign table can -be specified as comma separated values between brackets. E.g. -<tt>'related_items.(id1,id2)'</tt>. -</div> - -<!--- -<h2 id="142014">Adding/Removing/Updating Related Objects</h2> - -<p id="710041" class="block-content">Related objects can be simply inserted/updated by first adding those related objects to -the current source object (i.e. the object currently been worked on) and then call -the <tt>save()</tt> method on the source object. The related object's references -and the association reference (if required) will be added and/or updated. -For example, to add two new players to the team (assuming that 'Team A' exists), we can simply do the following. -</p> - -<com:TTextHighlighter Language="php" CssClass="source block-content"> -$team = TeamRecord::finder()->findByPk('Team A'); -$team->players[] = new PlayerRecord(array('age'=>20)); -$team->players[] = new PlayerRecord(array('age'=>25)); -$team->save(); -</com:TTextHighlighter> -<p id="710042" class="block-content"> -Since the <tt>TeamRecord</tt> class contains a <b>has many</b> relationship with the <tt>PlayerRecord</tt>, -then saving a <tt>TeamRecord</tt> object will also update the corresponding foreign objects in <tt>$players</tt> array. -That is, the objects in <tt>$players</tt> are inserted/updated in the database and the -<tt>$team_name</tt> property of those objects will contain the foreign key value that corresponds to the <tt>$team</tt> object's primary key value. -</p> - -<p id="710043" class="block-content">To delete a particular foreign object (or any Active Record object), simply call -the object's <tt>delete()</tt> method. You may setup the database table's foreign key constraints such that -when deleting a particular data in the database it will delete the referenced data as well (it may also be achieved using database -triggers). E.g. such as having a "<tt>ON DELETE CASCADE</tt>" constraint. -Deleting foreign objects by either setting the property value to null or removing the object from an array will <b>NOT</b> -remove the corresponding data in the database. -</p> - -<p id="710044" class="block-content">To remove associations for the many-to-many relationships via an association table, an Active Record -that corresponds to the association table can be used. Then the association can be removed by calling the <tt>deleteByPk()</tt> method, for example: -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -PlayerSkillAssocation::finder()->deleteByPk(array('fk1','fk2')); -//where 'fk1' is the primary key value of a player -// and 'fk2' is the primary key value of a skill -</com:TTextHighlighter> ----> - -<h2 id="142015">Lazy Loading Related Objects</h2> - -<div class="note"><b class="note">Note:</b> -Implicitly declared related properties introduced in version 3.1.2 automatically have lazy -loading feature. Therefore, the lazy loading technique described in the following is no longer -needed in most of the cases, unless you want to manipulate the related objects through getter/setter. -</div> - -<p id="710045" class="block-content">Using the <tt>with_xxx()</tt> methods will load the relationship record on demand. Retrieving the -related record using lazy loading (that is, only when those related objects are accessed) can be -achieved by using a feature of the <tt>TComponent</tt> that provides accessor methods. In particular, -we define a pair of getter and setter methods where the getter method will retrieve the relationship -conditionally. The following example illustrates that the <tt>PlayerRecord</tt> can retrieve its -<tt>$skills</tt> foreign objects conditionally. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class PlayerRecord extends BaseFkRecord -{ - //... other properties and methods as before - - private $_skills; //change to private and default as null - - public function getSkills() - { - if($this->_skills===null && $this->player_id !==null) - { - //lazy load the skill records - $this->setSkills($this->withSkills()->findByPk($this->player_id)->skills); - } - else if($this->_skills===null) - { - //create new TList; - $this->setSkills(new TList()); - } - - return $this->_skills; - } - - public function setSkills($value) - { - $this->_skills = $value instanceof TList ? $value : new TList($value); - } -} -</com:TTextHighlighter> -<p id="710046" class="block-content">We first need to change the <tt>$skills=array()</tt> declaration to a private property -<tt>$_skills</tt> (notice the underscore) and set it to null instead. This allows us -to define the <tt>skills</tt> property using getter/setter methods -(see <a href="?page=Fundamentals.Components1">Components</a> for details). The <tt>getSkills()</tt> -getter method for the <tt>skills</tt> property will lazy load the corresponding skills foreign record -when it is used as follows. Notice that we only do a lazy load when its <tt>$player_id</tt> is -not null (that is, when the record is already fetched from the database or player id was already set). -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -$player = PlayerRecord::finder()->findByPk(1); -var_dump($player->skills); //lazy load it on first access -var_dump($player->skills[0]); //already loaded skills property -$player->skills[] = new SkillRecord(); //add skill -</com:TTextHighlighter> - -<p id="710047" class="block-content">The <tt>setSkills()</tt> ensures that the <tt>skills</tt> property will always be a TList. -Using a TList allows us to set the elements of the <tt>skills</tt> property as if they were -arrays. E.g. <tt>$player->skills[] = new SkillRecord()</tt>. If <tt>array</tt> was used, a PHP error -will be thrown. -</p> - -<h2>Column Mapping</h2> -<p> -Since v3.1.1, Active Record starts to support column mapping. Column mapping allows developers -to address columns in Active Record using a more consistent naming convention. In particular, -using column mapping, one can access a column using whatever name he likes, rather than limited by -the name defined in the database schema. -</p> -<p> -To use column mapping, declare a static array named <tt>COLUMN_MAPPING</tt> in the Active Record class. -The keys of the array are column names (called <i>physical column names</i>) as defined in the database -schema, while the values are corresponding property names (called <i>logical column names</i>) defined -in the Active Record class. The property names can be either public class member variable names or -component property names defined via getters/setters. If a physical column name happens to be the same -as the logical column name, they do not need to be listed in <tt>COLUMN_MAPPING</tt>. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content"> -class UserRecord extends TActiveRecord -{ - const TABLE='users'; - public static $COLUMN_MAPPING=array - ( - 'user_id'=>'id', - 'email_address'=>'email', - 'first_name'=>'firstName', - 'last_name'=>'lastName', - ); - public $id; - public $username; // the physical and logical column names are the same - public $email; - public $firstName; - public $lastName; - //.... -} -</com:TTextHighlighter> -<p> -With the above column mapping, we can address <tt>first_name</tt> using <tt>$userRecord->firstName</tt> -instead of <tt>$userRecord->first_name</tt>. This helps separation of logic and model. -</p> - -<h2 id="138054">References</h2> -<ul id="u3" class="block-content"> - <li>Fowler et. al. <i>Patterns of Enterprise Application Architecture</i>, - Addison Wesley, 2002.</li> - <li>B. Venners with B. Eckel. <i><a href="http://www.artima.com/intv/abstract3.html">Inappropriate Abstractions - A Conversation with Anders Hejlsberg, Part VI.</a></i> - Artima Developer, 2003. - </li> - -</ul> - -</com:TContent> diff --git a/demos/quickstart/protected/pages/Database/pl/ar_objects.png b/demos/quickstart/protected/pages/Database/pl/ar_objects.png Binary files differdeleted file mode 100755 index ac33b88b..00000000 --- a/demos/quickstart/protected/pages/Database/pl/ar_objects.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Database/pl/ar_relations.png b/demos/quickstart/protected/pages/Database/pl/ar_relations.png Binary files differdeleted file mode 100755 index 48e29f48..00000000 --- a/demos/quickstart/protected/pages/Database/pl/ar_relations.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Database/pl/diagram.png b/demos/quickstart/protected/pages/Database/pl/diagram.png Binary files differdeleted file mode 100755 index 0a0ca73d..00000000 --- a/demos/quickstart/protected/pages/Database/pl/diagram.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Database/pl/object_states.png b/demos/quickstart/protected/pages/Database/pl/object_states.png Binary files differdeleted file mode 100755 index db194783..00000000 --- a/demos/quickstart/protected/pages/Database/pl/object_states.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Database/pl/sqlmap_active_record.png b/demos/quickstart/protected/pages/Database/pl/sqlmap_active_record.png Binary files differdeleted file mode 100755 index 6d958d33..00000000 --- a/demos/quickstart/protected/pages/Database/pl/sqlmap_active_record.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/Pages.page b/demos/quickstart/protected/pages/Fundamentals/Pages.page index 58f4f06d..3e03a24c 100755 --- a/demos/quickstart/protected/pages/Fundamentals/Pages.page +++ b/demos/quickstart/protected/pages/Fundamentals/Pages.page @@ -15,7 +15,7 @@ A form submission is called <i>postback</i> if the submission is made to the pag <tt>TPage</tt> has a <tt>IsPostBack</tt> property exposing whether the current request being handled is the first request for this page or the consequence of a postback.
</p>
-<h2>CallBack</h2>
+<h2 id="34012">CallBack</h2>
<p class="block-content">
A <i>callback</i> is a special form submission that, instead of requiring a full page reload on the browser, gets executed in the background through an ajax call. So, a callback is considered a postback too, but not vice versa.
<br/>
diff --git a/demos/quickstart/protected/pages/Fundamentals/id/Applications.page b/demos/quickstart/protected/pages/Fundamentals/id/Applications.page deleted file mode 100755 index 43b956c3..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/Applications.page +++ /dev/null @@ -1,55 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="1201">Aplikasi</h1>
-<p id="160157" class="block-content">
-Aplikasi adalah turunan dari <tt>TApplication</tt> atau asal kelasnya. Ia mengatur modul yang menyediakan fungsionalitas berbeda dan diambil bila diperlukan. Ia menyediakan layanan bagi pengguna-akhir. Ia adalah tempat utama untuk menyimpan berbagai parameter dalam sebuah aplikasi. Dalam aplikasi PRADO, turunan aplikasi adalah satu-satunya obyek yang secara global dapat diakses melalui panggilan fungsi <tt>Prado::getApplication()</tt>.
-</p>
-<p id="160158" class="block-content">
-Aplikasi dikonfigurasi melalui <a href="?page=Configurations.AppConfig">konfigurasi aplikasi</a>. Biasanya dibuat dalam naskah entri seperti berikut,
-<com:TTextHighlighter CssClass="source block-content" id="code_160071">
-require_once('/path/to/prado.php');
-$application = new TApplication;
-$application->run();
-</com:TTextHighlighter>
-Di mana metode <tt>run()</tt> memulai aplikasi untuk menangani permintaan pengguna.
-</p>
-
-<h2 id="1202">Organisasi Direktori</h2>
-<p id="160159" class="block-content">
-Aplikasi PRADO minimal berisi dua file: file entri dan file template halaman. Ini harus diatur sebagai berikut,
-<img src="<%~directory.gif%>" class="figure"/>
-</p>
-<ul id="u2" class="block-content">
-<li><tt>wwwroot</tt> - Akar dokumen Web atau sub-direktori.</li>
-<li><tt>index.php</tt> - naskah entri dari aplikasi PRADO.</li>
-<li><tt>assets</tt> - direktori yang menyimpan file pribadi yang dipublikasikan. Lihat seksi <a href="?page=Advanced.Assets">assets</a>.</li>
-<li><tt>protected</tt> - path basis aplikasi yang menyimpan data aplikasi dan file naskah pribadi. Direktori ini harus dikonfigurasi tidak bisa diakses terhadap Web-inaccessible, atau ia dapat ditempatkan di luar direktori Web.</li>
-<li><tt>runtime</tt> - path penyimpan runtime aplikasi. Direktori ini dipakai oleh PRADO untuk menyimpan informasi runtime aplikasi, seperti kondisi aplikasi, data di-cache, dll.</li>
-<li><tt>pages</tt> - path basis yang menyimpan semua halaman PRADO. Lihat seksi <a href="?page=Fundamentals.Services">layanan</a>.</li>
-<li><tt>Home.page</tt> - Halaman standar yang diberikan saat pengguna tidak secara eksplisit menetapkan halaman yang diminta. Ini adalah file template halaman. Nama file tanpa akhiran adalah nama halaman. Kelas halaman adalah <tt>TPage</tt>. Jika di sana juga aga file kelas <tt>Home.php</tt>, kelas halaman menjadi <tt>Home</tt>.</li>
-</ul>
-
-<p id="160160" class="block-content">
-Produk aplikasi PRADO biasanya membutuhkan file lebih banyak. Ia dapat menyertakan file konfigurasi aplikasi bernama <tt>application.xml</tt> di bawah path basis aplikasi <tt>protected</tt>. Halaman bisa diatur dalam direktori, beberapa diantaranya dapat berisi file konfigurasi halaman bernama <tt>config.xml</tt>. Untuk lebih jelasnya, silahkan lihat seksi <a href="?page=Configurations.Overview">konfigurasi</a>.
-</p>
-
-<h2 id="1203">Penyebaran Aplikasi</h2>
-<p id="160161" class="block-content">
-Menyebarkan aplikasi PRADO sebagian besar terkait dengan meng-copy direktori. Sebagai contoh, untuk menyebarkan aplikasi minimal di atas ke server lain, ikuti langkah-langkah berikut,
-</p>
-<ol>
-<li>Copy konten di bawah <tt>wwwroot</tt> ke direktori yang dapat diakses=Web pada server baru.</li>
-<li>Ubah file naskah entri <tt>index.php</tt> agar ia menyertakan file <tt>prado.php</tt> secara benar.</li>
-<li>Hapus semua konten di bawah direktori <tt>assets</tt> dan <tt>runtime</tt> dan pastikan kedua direktori dapat ditulis oleh proses server Web.</li>
-</ol>
-
-<h2 id="1204">Masa Hidup Aplikasi</h2>
-<p id="160162" class="block-content">
-Seperti masa hidup halaman, aplikasi juga mempunyai masa hidup. Modul aplikasi dapat meregistrasi event masa hidup. Ketika aplikasi mencapai masa hidup tertentu dan memunculkan event terkait, metode modul teregistrasi akan di panggil secara otomatis. Modul yang disertakan dalam rilis PRADO, seperti <tt>TAuthManager</tt>, menggunakan cara ini untuk melasanakan tujuannya.
-</p>
-<p id="160163" class="block-content">
-Masa hidup aplikasi dapat digambarkan sebagai berikut,
-</p>
-<img src="<%~applifecycles.gif%>" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/id/Architecture.page b/demos/quickstart/protected/pages/Fundamentals/id/Architecture.page deleted file mode 100755 index 354e2403..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/Architecture.page +++ /dev/null @@ -1,13 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="601">Arsitektur</h1>
-
-<p id="100111" class="block-content">
-PRADO adalah kerangka kerja presentasi utama, meskipun tidak dibatasi demikian. Kerangka kerja terfokus pada pembuatan pemrograman Web, yang banyak berkaitan dengan interaksi pengguna, menjadi berbasis-komponen dan kendali-event agar pengembang itu bisa lebih produktif. Susunan kelas berikut menggambarkan beberapa kelas utama yang disediakan oleh PRADO,
-</p>
-<img src="<%~classtree.gif%>" />
-
-<p id="100112" class="block-content">
-Ketika aplikasi PRADO memproses permintaan halaman, diagram obyek statisnya dapat dilihat sebagai berikut,
-</p>
-<img src="<%~objectdiagram.gif%>" />
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/id/Components.page b/demos/quickstart/protected/pages/Fundamentals/id/Components.page deleted file mode 100755 index 4eb14964..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/Components.page +++ /dev/null @@ -1,128 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="701">Komponen</h1>
-<p id="110113" class="block-content">
-Komponen adalah turunan dari <tt>TComponent</tt> atau kelas anaknya. Basis kelas <tt>TComponent</tt> menerapkan mekanisme properti dan event komponen.
-</p>
-
-<h2 id="702">Properti Komponen</h2>
-<p id="110114" class="block-content">
-Properti komponen dapat dilihat sebagai variabel public yang menjelaskan aspek tertentu dari komponen seperti warna latar belakang, besar font, dll. Properti didefinisikan dengan keberadaan metode penyetel dan/atau pengambil dalam kelas komponen. Sebagai contoh, dalam <tt>TControl</tt>, kami mendefinisikan properti <tt>ID</tt> menggunakan metode pengambil dan penyetel berikut,
-<com:TTextHighlighter CssClass="source block-content" id="code_110056">
-class TControl extends TComponent {
- public function getID() {
- ...
- }
- public function setID($value) {
- ...
- }
-}
-</com:TTextHighlighter>
-</p>
-<p id="110115" class="block-content">
-Untuk mendapatkan atau menetapkan properti <tt>ID</tt>, lakukan seperti berikut, seperti bekerja dengan sebuah variabel,
-<com:TTextHighlighter CssClass="source block-content" id="code_110057">
-$id = $component->ID;
-$component->ID = $id;
-</com:TTextHighlighter>
-Ini sama dengan yang berikut,
-<com:TTextHighlighter CssClass="source block-content" id="code_110058">
-$id = $component->getID();
-$component->setID( $id );
-</com:TTextHighlighter>
-</p>
-<p id="110116" class="block-content">
-Properti hanya-baca jika metode pengambil tetapi tidak untuk metode penyetel. Karena nama metode PHP adalah sensitif-huruf, nama properti juga sensitif-huruf. Kelas komponen mewariskan seluruh properti kelas leluhurnya.
-</p>
-
-<h3 id="706">Subproperti</h3>
-<p id="110117" class="block-content">
-Subproperti adalah properti dari beberapa properti tipe-obyek. Sebagai contoh, <tt>TWebControl</tt> mempunyai properti <tt>Font</tt> yang merupakan tipe <tt>TFont</tt>. Kemudian properti <tt>Name</tt> dari <tt>Font</tt> dirujuk sebagai subproperti (dengan memperhatikan <tt>TWebControl</tt>).
-</p>
-<p id="110118" class="block-content">
-Untuk mendapatkan atau menentukan subproperti <tt>Name</tt>, gunakan metode beriktu,
-<com:TTextHighlighter CssClass="source block-content" id="code_110059">
-$name = $component->getSubProperty('Font.Name');
-$component->setSubProperty('Font.Name', $name);
-</com:TTextHighlighter>
-Ini sama dengan yang berikut,
-<com:TTextHighlighter CssClass="source block-content" id="code_110060">
-$name = $component->getFont()->getName();
-$component->getFont()->setName( $name );
-</com:TTextHighlighter>
-
-
-</p>
-
-<h2 id="703">Event Komponen</h2>
-<p id="110119" class="block-content">
-Event komponen adalah properti khusus yang mengambil nama metode sebagai nilainya. Melampirkan (setelan) metode ke sebuah event akan menancapkan metode ke tempat di mana event dimunculkan. Oleh karena itu, perilaku komponen bisa diubah dalam cara yang tidak terlihat selama pengembangan komponen.
-</p>
-<p id="110120" class="block-content">
-Event komponen didefinisikan dengan keberadaan metode yang namanya dimulai dengan kata <tt>on</tt>. Nama event adalah nama metode dan sensitif-huruf. Sebagai contoh, dalam <tt>TButton</tt>, kita mempunyai
-<com:TTextHighlighter CssClass="source block-content" id="code_110061">
-class TButton extends TWebControl {
- public function onClick( $param ) {
- ...
- }
-}
-</com:TTextHighlighter>
-Ini mendefinisikan event bernama <tt>OnClick</tt>, dan pengendali dapat dilampirkan ke event menggunakan salah satu cara berikut,
-<com:TTextHighlighter CssClass="source block-content" id="code_110062">
-$button->OnClick = $callback;
-$button->OnClick->add( $callback );
-$button->OnClick[] = $callback;
-$button->attachEventHandler( 'OnClick' , $callback );
-</com:TTextHighlighter>
-di mana <tt>$callback</tt> merujuk ke callback PHP yang benar (misalnya nama fungsi, metode kelas <tt>array($object,'method')</tt>, dll).
-</p>
-
-<h2 id="704">Namespace</h2>
-<p id="110121" class="block-content">
-Namespace merujuk ke pengelompokan logis dari beberapa nama kelas agar dapat dibedakan dari nama kelas lain meskipun jika namanya sama. Karena PHP pada hakekatnya tidak mendukung namespace, Anda tidak bisa membuat turunan dari dua kelas yang mempunyai nama sama tapi dengan definisi berbeda. Untuk membedakan dari kelas didefinisikan pengguna, semua kelas PRADO diawali dengan huruf 'T' (berarti 'Type'). Para pengguna disarankan untuk tidak menamai kelasnya seperti ini. Sebaiknya mengawali nama kelasnya dengan huruf yang lainnya.
-</p>
-<p id="110122" class="block-content">
-Namespace dalam PRADO dianggap sebagai direktori yang berisi satu atau beberapa file kelas. Sebuah kelas dapat ditetapkan tanpa dwimakna menggunakan namespace demikian diikuti oleh nama kelas. Setiap namespace dalam PRADO ditetapkan dalam format berikut,
-<div class="source">
-PathAlias.Dir1.Dir2
-</div>
-di mana <tt>PathAlias</tt> adalah alias dari beberapa direktori, sementara <tt>Dir1</tt> dan <tt>Dir2</tt> adalah subdirektori di bawah direktori itu. Kelas yang benama <tt>MyClass</tt> didefinisikan di bawah <tt>Dir2</tt> sekarang berkualifikasi lengkap sebagai <tt>PathAlias.Dir1.Dir2.MyClass</tt>.
-</p>
-<p id="110123" class="block-content">
-Untuk menggunakan namespace dalam kode, lakukan seperti berikut,
-<com:TTextHighlighter CssClass="source block-content" id="code_110063">
-Prado::using('PathAlias.Dir1.Dir2.*');
-</com:TTextHighlighter>
-menambah direktori yang dirujuk oleh <tt>PathAlias.Dir1.Dir2</tt> ke dalam path include PHP agar kelas itu didefinisikan di bawah direktori itu dapat diturunkan tanpa prefiks namespace. Anda juga dapat menyertakan definisi kelas individual dengan
-<com:TTextHighlighter CssClass="source block-content" id="code_110064">
-Prado::using('PathAlias.Dir1.Dir2.MyClass');
-</com:TTextHighlighter>
-yang akan menyertakan file kelas jika <tt>MyClass</tt> tidak didefinisikan.
-</p>
-<p id="110124" class="block-content">
-Untuk lebih jelasnya mengenai mendefinisikan alias path, lihat seksi <a href="?page=Configurations.AppConfig">konfigurasi aplikasi</a>.
-</p>
-
-<h2 id="705">Penurunan Komponen</h2>
-<p id="110125" class="block-content">
-Penurunan komponen berarti membuat turunan dari kelas komponen. Ada dua tipe penurunan komponen: penurunan statis dan dinamis. Komponen yang dibuat masing-masing disebut komponen statis dan komponen dinamis.
-</p>
-
-<h3 id="707">Penurunan Komponen Dinamis</h3>
-<p id="110126" class="block-content">
-Penurunan komponen dinamis berarti membuat turunan komponen dalam kode PHP. Itu sama dengan apa yang umum dirujuk pembuatan obyek dalam PHP. Sebuah komponen dapat dibuat secara dinamis menggunakan salah satu dari dua metode berikut dalam PHP,
-<com:TTextHighlighter CssClass="source block-content" id="code_110065">
-$component = new ComponentClassName;
-$component = Prado::createComponent('ComponentType');
-</com:TTextHighlighter>
-di mana <tt>ComponentType</tt> merujuk ke nama kelas atau nama tipe dalam format namespace (contoh <tt>System.Web.UI.TControl</tt>). Pendekatan kedua diperkenalkan guna mengimbangi kekurangan dukungan namespace dalam PHP.
-</p>
-
-<h3 id="708">Penurunan Komponen Statis</h3>
-<p id="110127" class="block-content">
-Penurunan komponen statis adalah mengenai pembuatan komponen melalui <a href="?page=Configurations.Overview">konfigurasi</a>. Pekerjaan pembuatan sebenarnya dilakukan oleh kerangka kerja PRADO. Sebagai contoh, dalam <a href="?page=Configurations.AppConfig">konfigurasi aplikasi</a>, seseorang dapat mengkonfigurasi sebuah modul untuk diambil ketika aplikasi dijalankan. Selanjutnya modul adalah komponen statis yang dibuat oleh kerangka kerja. Penurunan komponen statis lebih umum digunakan dalam <a href="?page=Configurations.Templates1">template</a>. Setiap tag komponen dalam sebuah template menetapkan komponen yang akan dibuat secara otomatis oleh kerangka kerja ketika template diambil. Sebagai contoh, dalam sebuah template halaman, tag berikut akan membawa ke pembuatan komponen <tt>TButton</tt> pada halaman,
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_110066">
-<com:TButton Text="Register" />
-</com:TTextHighlighter>
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/id/Controls.page b/demos/quickstart/protected/pages/Fundamentals/id/Controls.page deleted file mode 100755 index 47222b3d..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/Controls.page +++ /dev/null @@ -1,51 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="801">Kontrol</h1>
-<p id="120128" class="block-content">
-Kontrol adalah turunan dari kelas <tt>TControl</tt> atau asal sub kelasnya. Kontrol adalah komponen yang didefinisikan sebagai tambahan pada antarmuka pengguna. Kelas basis <tt>TControl</tt> mendefinisikan hubungan leluhur-anak diantara kontrol yang mencerminkan pengurungan hubungan diantara elemen antarmuka pengguna.
-</p>
-
-<h2 id="802">Susunan Kontrol</h2>
-<p id="120129" class="block-content">
-Kontrol dikaitkan satu sama lain melalui hubungan leluhur-anak. Setiap kontrol leluhur dapat memiliki beberapa kontrol anak. Kontrol leluhur bertugas terhadap transisi keadaan dari kontrol anaknya. Hasil dari kontrol anak biasanya dipakai untuk mengatur penampilan kontrol leluhur. Hubungan leluhur-anak membawa kontrol bersama ke dalam susunan kontrol. Halaman ada di akar dari susunan yang penampilannya di berikan kepada pengguna-akhir.
-</p>
-<p id="120130" class="block-content">
-Hubungan leluhur-anak biasanya dilakukan oleh kerangka kerja melalui <a href="?page=Configurations.Templates1">template</a>. Dalam kode, Anda dapat menetapkan kontrol secara eksplisit sebagai anak dari yang lainnya menggunakan salah satu metode berikut,
-<com:TTextHighlighter CssClass="source block-content" id="code_120067">
-$parent->Controls->add($child);
-$parent->Controls[]=$child;
-</com:TTextHighlighter>
-di mana properti <tt>Controls</tt> merujuk ke koleksi kontrol anak dari leluhur.
-</p>
-
-<h2 id="803">Identifikasi Kontrol</h2>
-<p id="120131" class="block-content">
-Setiap kontrol mempunyai properti <tt>ID</tt> yang dapat secara unik dapat mengidentifikasi dirinya sendiri diantara kontrol keluarganya. Sebagai tambahan, setiap kontrol mempunyai <tt>UniqueID</tt> dan <tt>ClientID</tt> yang dapat dipakai untuk mengidentifikasi kontrol secara global dalam susunan di mana kontrol berada. <tt>UniqueID</tt> dan <tt>ClientID</tt> sangat mirip. Pembentuk dipakai oleh kerangka kerja guna menentukan lokasi dari kontrol terkait dalam susunan, sementara yang kedua sebagian besar dipakai pada sisi klien sebagai ID tag HTML. Secara umum, Anda tidak boleh bergantung pada bentuk eksplisit <tt>UniqueID</tt> atau <tt>ClientID</tt>.
-</p>
-
-<h2 id="804">Wadah Penamaan</h2>
-<p id="120132" class="block-content">
-Setiap kontrol mempunyai wadah penamaan yang mana kontrol membuat ruang nama (namespace) unik untuk membedakan antara kontrol dengan <tt>ID</tt> yang sama. Sebagai contoh, kontrol <tt>TRepeater</tt> membuat multipel item masing-masing mempunyai kontrol anak dengan <tt>ID</tt> yang sama. Untuk membedakan kontrol anak ini, setiap item bertindak sebagai wadah penamaan. Oleh karena itu, kontrol anak dapat diidentifikasi secara unik menggunakan wadah penamaan <tt>ID</tt> bersama dengan <tt>ID</tt>-nya sendiri. Seperti yang mungkin sudah Anda mengerti, <tt>UniqueID</tt> dan <tt>ClientID</tt> bergantung pada wadah penamaan.
-</p>
-<p id="120133" class="block-content">
-Kontrol dapat bertindak sebagai wadah penamaan jika ia menerapkan antarmuka <tt>INamingContainer</tt>.
-</p>
-
-<h2 id="805">ViewState dan ControlState</h2>
-<p id="120134" class="block-content">
-HTTP adalah protokol tidak berkondisi, berarti ia tidak menyediakan fungsionalitas untuk mendukung interaksi berlanjut antara pengguna dan server. Setiap permintaan dianggap sebagai diskrit dan berdiri sendiri dari yang lainnya. Aplikasi Web, sering perlu untuk mengetahui apa yang telah dilakukan pengguna dalam permintaan sebelumnya. Selanjutnya orang memperkenalkan sesi guna membantu mengingat informasi kondisi seperti itu.
-</p>
-<p id="120135" class="block-content">
-PRADO meminjam konsep viewstate dan controlstate dari Microsoft ASP.NET guna menyediakan tambahan mekanisme pemrograman berkondisi. Penyimpanan nilai dalam viewstate atau controlstate mungkin tersedia untuk permintaan berikutnya jika permintaan baru dari submisi (disebut postback) ke halamanyang sama oleh pengguna yang sama. Perbedaan antara viewstate dan controlstate adalah bahwa pembentuk dapat dimatikan saat yang kemudian tidak bisa.
-</p>
-<p id="120136" class="block-content">
-Viewstate dan controlstate diterapkan dalam <tt>TControl</tt>. Biasanya dipakai untuk mendefinisikan berbagai properti kontrol. Untuk menyimpan dan mengambil nilai dari viewstate atau controlstate, gunakan metode berikut,
-<com:TTextHighlighter CssClass="source block-content" id="code_120068">
-$this->getViewState('Name',$defaultValue);
-$this->setViewState('Name',$value,$defaultValue);
-$this->getControlState('Name',$defaultValue);
-$this->setControlState('Name',$value,$defaultValue);
-</com:TTextHighlighter>
-di mana <tt>$this</tt> merujuk ke turunan kontrol, <tt>Name</tt> merujuk ke kunci yang mengidentifikasi nilai pasti, <tt>$defaultValue</tt> adalah opsional. Ketika mengambil nilai dari viewstate atau controlstate, jika kunci terkait tidak ada, nilai standar akan diberikan.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/id/Hangman.page b/demos/quickstart/protected/pages/Fundamentals/id/Hangman.page deleted file mode 100755 index 44a8887e..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/Hangman.page +++ /dev/null @@ -1,14 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="1301">Contoh: Permainan Hangman</h1>
-<p id="60043" class="block-content">
-Setelah melihat aplikasi "Hello World", sekarang kita membuat aplikasi yang lebih rumit disebut "Permainan Hangman". Dalam permainan ini, pemain diminta untuk menebak kata, satu huruf setiap waktu. Jika dia menebak huruf dengan benar, huruf akan ditampilkan dalam kata. Pemain dapat melanjutkan untuk menebak selama angka kesalahannya dalam batas yang sudah ditetapkan. Pemain memenangkan permainan jika menemukan kata dalam batas kesalahan, atau dia kalah.
-</p>
-<p id="60044" class="block-content">
-Untuk memfasilitasi pembangunan permainan ini, kami perlihatkan diagram transisi keadaan dari proses permainan sebagai berikut,
-<br /><br />
-Untuk dilanjutkan...
-</p>
-<com:RunBar PagePath="Fundamentals.Samples.Hangman.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/id/Modules.page b/demos/quickstart/protected/pages/Fundamentals/id/Modules.page deleted file mode 100755 index f484fece..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/Modules.page +++ /dev/null @@ -1,50 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="1001">Modul</h1>
-<p id="140141" class="block-content">
-Modul adalah turunan dari kelas yang menerapkan antarmuka <tt>IModule</tt>. Umumnya sebuah modul didesain untuk fungsionalitas tertentu yang dapat disertakan ke dalam aplikasi PRADO dan berbagi dengan semua komponen dalam aplikasi.
-</p>
-<p id="140142" class="block-content">
-PRADO menggunakan konfigurasi untuk menetapkan apakah mengambil sebuah modul, mengambil modul jenis apa, dan bagaimana untuk menginisialisasi modul yang diambilnya. Para pengembang dapat mengganti modul inti dengan implementasinya sendiri melalui konfigurasi aplikasi, atau mereka dapat menulis modul baru guna menyediakan fungsionalitas tambahan. Sebagai contoh, modul dapat dikembangkan untuk menyediakan logika database umum pada satu atau beberapa halaman. Untuk lebih jelasnya, silahkan lihat <a href="?page=Configurations.Overview">konfigurasi</a>.
-</p>
-<p id="140143" class="block-content">
-Ada tiga modul inti yang diambil secara standar kapan saja aplikasi dijalankan. Ketiganya adalah <a href="#request">modul permintaan</a>, <a href="#response">modul respon</a>, dan <a href="#error">modul pengendali kesalahan</a>. Sebagai tambahan, <a href="#session">modul sesi</a> diambil saat ia digunakan dalam aplikasi. PRADO menyediakan implementasi standar untuk semua modul ini. <a href="#custom">Modul kustom</a> dapat dikonfigurasi atau dikembangkan guna mengganti atau menambah modul inti ini.
-</p>
-
-<a name="request"></a>
-<h2 id="1002">Modul Permintaan</h2>
-<p id="140144" class="block-content">
-Modul permintaan menyediakan penyimpanan dan skema akses untuk permintaan pengguna yang dikirim melalui HTTP. Permintaan pengguna datang dari beberapa sumber, termasuk URL, data post, data sesi, data cookie, dll. Data ini semuanya dapat diakses melalui modul permintaan. Standarnya PRADO menggunakan <tt>THttpRequest</tt> sebagai modul permintaan. Modul permintaan dapat diakses melalui properti <tt>Request</tt> dari aplikasi dan kontrol.
-</p>
-
-<a name="response"></a>
-<h2 id="1003">Modul Respon</h2>
-<p id="140145" class="block-content">
-Modul respon menerapkan mekanisme untuk mengirimkan output ke pengguna klien. Modul respon dapat dikonfigurasi guna mengontrol bagaimana output di-cache pada sisi klien. Standarnya PRADO menggunakan <tt>THttpResponse</tt> sebagai modul respon. Modul respon dapat diakses melalui properti <tt>Response</tt> dari aplikasi dan kontrol.
-</p>
-
-<a name="session"></a>
-<h2 id="1004">Modul Sesi</h2>
-<p id="140146" class="block-content">
-Modul sesi melapisi fungsionalitas terkait dengan penanganan sesi pengguna. Modul sesi secara otomatis diambil saat aplikasi menggunakan sesi. Standarnya PRADO menggunakan <tt>THttpSession</tt> sebagai modul sesi, yang merupakan pelapis sederhana dari fungsi sesi yang disediakan oleh PHP. Modul sesi dapat diakses melalui properti <tt>Session</tt> dari aplikasi dan kontrol.
-</p>
-
-<a name="error"></a>
-<h2 id="1005">Modul Pengendali Kesalahan</h2>
-<p id="140147" class="block-content">
-Modul pengendali kesalahan dipakai untuk menangkap dan memproses semua kondisi kesalahan dalam sebuah aplikasi. PRADO menggunakan <tt>TErrorHandler</tt> sebagai modul pengendali kesalahan. Ia menangkap semua peringatan PHP, perhatian dan eksepsi, dan ditampilkan dalam bentuk yang tepat bagi pengguna-akhir. Modul pengendali kesalahan dapat diakses melalui properti <tt>ErrorHandler</tt> dari turunan aplikasi.
-</p>
-
-<a name="custom"></a>
-<h2 id="1006">Modul Kustom</h2>
-<p id="140148" class="block-content">
-PRADO dirilis dengan beberapa modul lebih disamping yang inti. Ini termasuk modul cache (<tt>TSqliteCache</tt> dan <tt>TMemCache</tt>), modul manajemen pengguna (<tt>TUserManager</tt>), modul otentikasi dan otorisasi (<tt>TAuthManager</tt>), dll.
-</p>
-<p id="140149" class="block-content">
-Ketika <tt>TPageService</tt> diminta, ia juga mengambil modul tertentu untuk layanan halaman, termasuk manajer asset (<tt>TAssetManager</tt>), manajer template (<tt>TTemplateManager</tt>), manajer tema/skin (<tt>TThemeManager</tt>).
-</p>
-<p id="140150" class="block-content">
-Modul kustom dan modul inti semuanya dapat dikonfigurasi melalui <a href="?page=Configurations.Overview">konfigurasi</a>.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/id/Pages.page b/demos/quickstart/protected/pages/Fundamentals/id/Pages.page deleted file mode 100755 index 496f9530..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/Pages.page +++ /dev/null @@ -1,23 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="901">Halaman</h1>
-<p id="130137" class="block-content">
-Halaman adalah kontrol teratas yang tidak mempunyai leluhur. Presentasi halaman ditampilkan secara langsung ke pengguna-akhir. Pengguna mengakses halaman dengan mengirimkan permintaan layanan halaman.
-</p>
-<p id="130138" class="block-content">
-Setiap halaman harus mempunyai file <a href="?page=Configurations.Templates1">template</a>. Akhiran nama file harus <tt>.page</tt>. Nama file (tanpa akhiran) adalah nama halaman. PRADO akan mencoba mencari file kelas halaman di bawah direktori yang berisi file template halaman. File kelas halaman tersebut harus mempunyai nama file yang sama (diakhiri dengan <tt>.php</tt>) seperti file template. Jika file kelas tidak ditemukan, halaman akan mengambil kelas <tt>TPage</tt>.
-</p>
-
-<h2 id="902">PostBack</h2>
-<p id="130139" class="block-content">
-Submisi formulir disebut <i>postback</i> jika submisi dibuat untuk halaman yang berisi formulir. Postback dapat dianggap sebagai kondisi di sisi klien, dimunculkan oleh pengguna. PRADO akan mencoba mengidentifikasi kontrol mana pada sisi server untuk postback kondisi. Jika seseorang menentukan misalnya, <tt>TButton</tt>, kami menyebutnya pengirim event postback yang akan menterjemahkan event postback ke dalam beberapa event sisi-server tertentu (contoh event <tt>OnClick</tt> dan <tt>OnCommand</tt> untuk <tt>TButton</tt>).
-
-</p>
-
-<h2 id="903">Masa Hidup Halaman</h2>
-<p id="130140" class="block-content">
-Mengerti masa hidup halaman adalah penting untuk menguasai pemrograman PRADO. Masa hidup halaman merujuk ke transisi kondisi dari sebuah halaman saat melayani halaman ini bagi pengguna-akhir. Ini dapat digambarkan dalam grafik kondisi berikut,
-<img src="<%~lifecycles.gif %>" />
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/id/Services.page b/demos/quickstart/protected/pages/Fundamentals/id/Services.page deleted file mode 100755 index 8834f214..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/Services.page +++ /dev/null @@ -1,34 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="1101">Layanan</h1>
-<p id="150151" class="block-content">
-Layanan adalah turunan dari kelas yang menerapkan antarmuka <tt>IService</tt>. Setiap jenis layanan memproses tipe permintaan tertentu pengguna. Sebagai contoh, respon layanan halaman terhadap permintaan pengguna untuk halaman PRADO.
-</p>
-<p id="150152" class="block-content">
-Sebuah layanan diidentifikasi secara unik dengan properti <tt>ID</tt>-nya. Standarnya ketika <tt>THttpRequest</tt> dipakai sebagai <a href="?page=Fundamentals.Modules#request">modul permintaan</a>, nama variabel GET digunakan untuk mengidentifikasi layanan mana yang sedang diminta oleh pengguna. Jika nama variabel GET sama dengan beberapa <tt>ID</tt> layanan, permintaan dianggap untuk layanan itu, dan nilai dari variabel GET dikirimkan sebagai parameter layanan. Untuk layanan halaman, nama variabel GET harus <tt>page</tt>. Sebagai contoh, URKL berikut meminta halaman <tt>Fundamentals.Services</tt>,
-<com:TTextHighlighter Language="none" CssClass="source block-content" id="code_150069">
-http://hostname/index.php?page=Fundamentals.Services
-</com:TTextHighlighter>
-</p>
-<p id="150153" class="block-content">
-Para pengembang dapat menerapkan layanan tambahan untuk aplikasinya. Untuk menjadikan layanan agar tersedia, konfigurasi itu dalam <a href="?page=Configurations.AppConfig">konfigurasi aplikasi</a>.
-</p>
-
-<h2 id="1102">Layanan Halaman</h2>
-<p id="150154" class="block-content">
-PRADO menerapkan <tt>TPageService</tt> untuk melayani permintaan halaman pengguna. Halam disimpan di bawah direktori yang ditetapkan oleh properti <tt>BasePath</tt> dari layanan halaman. Properti standarnya ke direktori <tt>pages</tt> di bawah path basis aplikasi. Anda boleh mengubah standar ini dengan mengkonfigurasi layanan dalam konfigurasi aplikasi.
-</p>
-<p id="150155" class="block-content">
-Halaman disusun ke dalam direktori di bawah <tt>BasePath</tt>. Dalam setiap direktori, di sana ada file konfigurasi bernama <tt>config.xml</tt>, yang berisi konfigurasi yang hanya efektif ketika halaman di bawah direktori atau sub direktori itu diminta. Untuk lebih jelasnya, lihat seksi <a href="?page=Configurations.PageConfig">konfigurasi halaman</a>.
-</p>
-<p id="150156" class="block-content">
-Parameter layanan untuk layanan halaman merujuk pada halaman yang sedang diminta. Parameter seperti <tt>Fundamentals.Services</tt> merujuk pada halaman <tt>Services</tt> di bawah direktori <tt><BasePath>/Fundamentals</tt>. Jika parameter tersebut tidak ada dalam permintaan, dianggap sebagai halaman standar bernama <tt>Home</tt>. Menggunakan <tt>THttpRequest</tt> sebagai modul permintaan (default), URL berikut masing-masing akan meminta halaman <tt>Home</tt>, <tt>About</tt> dan <tt>Register</tt>,
-<com:TTextHighlighter Language="none" CssClass="source block-content" id="code_150070">
-http://hostname/index.php
-http://hostname/index.php?page=About
-http://hostname/index.php?page=Users.Register
-</com:TTextHighlighter>
-di mana contoh pertama mengambiil keuntungan bahwa layanan halaman adalah layanan standar dan <tt>Home</tt> adalah halaman default.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/id/applifecycles.gif b/demos/quickstart/protected/pages/Fundamentals/id/applifecycles.gif Binary files differdeleted file mode 100755 index d5300aa6..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/applifecycles.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/id/applifecycles.vsd b/demos/quickstart/protected/pages/Fundamentals/id/applifecycles.vsd Binary files differdeleted file mode 100755 index 56f6602d..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/applifecycles.vsd +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/id/classtree.gif b/demos/quickstart/protected/pages/Fundamentals/id/classtree.gif Binary files differdeleted file mode 100755 index b1fbf0d6..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/classtree.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/id/classtree.vsd b/demos/quickstart/protected/pages/Fundamentals/id/classtree.vsd Binary files differdeleted file mode 100755 index c000d32f..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/classtree.vsd +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/id/directory.gif b/demos/quickstart/protected/pages/Fundamentals/id/directory.gif Binary files differdeleted file mode 100755 index c7d5086d..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/directory.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/id/lifecycles.gif b/demos/quickstart/protected/pages/Fundamentals/id/lifecycles.gif Binary files differdeleted file mode 100755 index 5edaff5f..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/lifecycles.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/id/lifecycles.vsd b/demos/quickstart/protected/pages/Fundamentals/id/lifecycles.vsd Binary files differdeleted file mode 100755 index 368d0ba7..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/lifecycles.vsd +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/id/objectdiagram.gif b/demos/quickstart/protected/pages/Fundamentals/id/objectdiagram.gif Binary files differdeleted file mode 100755 index 7910469c..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/objectdiagram.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/id/objectdiagram.vsd b/demos/quickstart/protected/pages/Fundamentals/id/objectdiagram.vsd Binary files differdeleted file mode 100755 index b2457220..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/id/objectdiagram.vsd +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/ja/Applications.page b/demos/quickstart/protected/pages/Fundamentals/ja/Applications.page deleted file mode 100755 index 8e0b9e9a..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/ja/Applications.page +++ /dev/null @@ -1,55 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="1201">Applications</h1>
-<p id="160157" class="block-content">
-An application is an instance of <tt>TApplication</tt> or its derived class. It manages modules that provide different functionalities and are loaded when needed. It provides services to end-users. It is the central place to store various parameters used in an application. In a PRADO application, the application instance is the only object that is globally accessible via <tt>Prado::getApplication()</tt> function call.
-</p>
-<p id="160158" class="block-content">
-Applications are configured via <a href="?page=Configurations.AppConfig">application configurations</a>. They are usually created in entry scripts like the following,
-<com:TTextHighlighter CssClass="source block-content" id="code_160071">
-require_once('/path/to/prado.php');
-$application = new TApplication;
-$application->run();
-</com:TTextHighlighter>
-where the method <tt>run()</tt> starts the application to handle user requests.
-</p>
-
-<h2 id="1202">Directory Organization</h2>
-<p id="160159" class="block-content">
-A minimal PRADO application contains two files: an entry file and a page template file. They must be organized as follows,
-<img src="<%~directory.gif%>" class="figure"/>
-</p>
-<ul id="u2" class="block-content">
-<li><tt>wwwroot</tt> - Web document root or sub-directory.</li>
-<li><tt>index.php</tt> - entry script of the PRADO application.</li>
-<li><tt>assets</tt> - directory storing published private files. See <a href="?page=Advanced.Assets">assets</a> section.</li>
-<li><tt>protected</tt> - application base path storing application data and private script files. This directory should be configured inaccessible to Web-inaccessible, or it may be located outside of Web directories.</li>
-<li><tt>runtime</tt> - application runtime storage path. This directory is used by PRADO to store application runtime information, such as application state, cached data, etc.</li>
-<li><tt>pages</tt> - base path storing all PRADO pages. See <a href="?page=Fundamentals.Services">services</a> section.</li>
-<li><tt>Home.page</tt> - default page returned when users do not explicitly specify the page requested. This is a page template file. The file name without suffix is the page name. The page class is <tt>TPage</tt>. If there is also a class file <tt>Home.php</tt>, the page class becomes <tt>Home</tt>.</li>
-</ul>
-
-<p id="160160" class="block-content">
-A product PRADO application usually needs more files. It may include an application configuration file named <tt>application.xml</tt> under the application base path <tt>protected</tt>. The pages may be organized in directories, some of which may contain page configuration files named <tt>config.xml</tt>. Fore more details, please see <a href="?page=Configurations.Overview">configurations</a> section.
-</p>
-
-<h2 id="1203">Application Deployment</h2>
-<p id="160161" class="block-content">
-Deploying a PRADO application mainly involves copying directories. For example, to deploy the above minimal application to another server, follow the following steps,
-</p>
-<ol>
-<li>Copy the content under <tt>wwwroot</tt> to a Web-accessible directory on the new server.</li>
-<li>Modify the entry script file <tt>index.php</tt> so that it includes correctly the <tt>prado.php</tt> file.</li>
-<li>Remove all content under <tt>assets</tt> and <tt>runtime</tt> directories and make sure both directories are writable by the Web server process.</li>
-</ol>
-
-<h2 id="1204">Application Lifecycles</h2>
-<p id="160162" class="block-content">
-Like page lifecycles, an application also has lifecycles. Application modules can register for the lifecycle events. When the application reaches a particular lifecycle and raises the corresponding event, the registered module methods are invoked automatically. Modules included in the PRADO release, such as <tt>TAuthManager</tt>, are using this way to accomplish their goals.
-</p>
-<p id="160163" class="block-content">
-The application lifecycles can be depicted as follows,
-</p>
-<img src="<%~applifecycles.gif%>" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/ja/Architecture.page b/demos/quickstart/protected/pages/Fundamentals/ja/Architecture.page deleted file mode 100755 index 7d828803..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/ja/Architecture.page +++ /dev/null @@ -1,15 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="601">アーキテクチャ</h1>
-
-<p id="100111" class="block-content">
-PRADO は主にプレゼンテーションを操作するためのフレームワークです。（プレゼンテーション操作のみで制限されるわけではありません）<br />
-このフレームワークはウェブプログラミングに集中するためのものであり、開発者がより生産性を上げられるようにコンポーネントベース、イベントドリブンなプログラミングが可能なつくりになっています。<br />
-以下のクラスツリーは PRADO によって提供されている主要なクラスについて書かれたものです。
-</p>
-<img src="<%~classtree.gif%>" />
-
-<p id="100112" class="block-content">
-PRADO アプリケーションがページ要求処理を行う際、以下のオブジェクトダイアグラムで動作します。
-</p>
-<img src="<%~objectdiagram.gif%>" />
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/ja/Components.page b/demos/quickstart/protected/pages/Fundamentals/ja/Components.page deleted file mode 100755 index 5662b53b..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/ja/Components.page +++ /dev/null @@ -1,128 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="701">Components</h1>
-<p id="110113" class="block-content">
-A component is an instance of <tt>TComponent</tt> or its child class. The base class <tt>TComponent</tt> implements the mechanism of component properties and events.
-</p>
-
-<h2 id="702">Component Properties</h2>
-<p id="110114" class="block-content">
-A component property can be viewed as a public variable describing a specific aspect of the component, such as the background color, the font size, etc. A property is defined by the existence of a getter and/or a setter method in the component class. For example, in <tt>TControl</tt>, we define its <tt>ID</tt> property using the following getter and setter methods,
-<com:TTextHighlighter CssClass="source block-content" id="code_110056">
-class TControl extends TComponent {
- public function getID() {
- ...
- }
- public function setID($value) {
- ...
- }
-}
-</com:TTextHighlighter>
-</p>
-<p id="110115" class="block-content">
-To get or set the <tt>ID</tt> property, do as follows, just like working with a variable,
-<com:TTextHighlighter CssClass="source block-content" id="code_110057">
-$id = $component->ID;
-$component->ID = $id;
-</com:TTextHighlighter>
-This is equivalent to the following,
-<com:TTextHighlighter CssClass="source block-content" id="code_110058">
-$id = $component->getID();
-$component->setID( $id );
-</com:TTextHighlighter>
-</p>
-<p id="110116" class="block-content">
-A property is read-only if it has a getter method but no setter method. Since PHP method names are case-insensitive, property names are also case-insensitive. A component class inherits all its ancestor classes' properties.
-</p>
-
-<h3 id="706">Subproperties</h3>
-<p id="110117" class="block-content">
-A subproperty is a property of some object-typed property. For example, <tt>TWebControl</tt> has a <tt>Font</tt> property which is of <tt>TFont</tt> type. Then the <tt>Name</tt> property of <tt>Font</tt> is referred to as a subproperty (with respect to <tt>TWebControl</tt>).
-</p>
-<p id="110118" class="block-content">
-To get or set the <tt>Name</tt> subproperty, use the following method,
-<com:TTextHighlighter CssClass="source block-content" id="code_110059">
-$name = $component->getSubProperty('Font.Name');
-$component->setSubProperty('Font.Name', $name);
-</com:TTextHighlighter>
-This is equivalent to the following,
-<com:TTextHighlighter CssClass="source block-content" id="code_110060">
-$name = $component->getFont()->getName();
-$component->getFont()->setName( $name );
-</com:TTextHighlighter>
-
-
-</p>
-
-<h2 id="703">Component Events</h2>
-<p id="110119" class="block-content">
-Component events are special properties that take method names as their values. Attaching (setting) a method to an event will hook up the method to the places at which the event is raised. Therefore, the behavior of a component can be modified in a way that may not be foreseen during the development of the component.
-</p>
-<p id="110120" class="block-content">
-A component event is defined by the existence of a method whose name starts with the word <tt>on</tt>. The event name is the method name and is thus case-insensitve. For example, in <tt>TButton</tt>, we have
-<com:TTextHighlighter CssClass="source block-content" id="code_110061">
-class TButton extends TWebControl {
- public function onClick( $param ) {
- ...
- }
-}
-</com:TTextHighlighter>
-This defines an event named <tt>OnClick</tt>, and a handler can be attached to the event using one of the following ways,
-<com:TTextHighlighter CssClass="source block-content" id="code_110062">
-$button->OnClick = $callback;
-$button->OnClick->add( $callback );
-$button->OnClick[] = $callback;
-$button->attachEventHandler( 'OnClick' , $callback );
-</com:TTextHighlighter>
-where <tt>$callback</tt> refers to a valid PHP callback (e.g. a function name, a class method <tt>array($object,'method')</tt>, etc.)
-</p>
-
-<h2 id="704">Namespaces</h2>
-<p id="110121" class="block-content">
-A namespace refers to a logical grouping of some class names so that they can be differentiated from other class names even if their names are the same. Since PHP does not support namespace intrinsically, you cannot create instances of two classes who have the same name but with different definitions. To differentiate from user defined classes, all PRADO classes are prefixed with a letter 'T' (meaning 'Type'). Users are advised not to name their classes like this. Instead, they may prefix their class names with any other letter(s).
-</p>
-<p id="110122" class="block-content">
-A namespace in PRADO is considered as a directory containing one or several class files. A class may be specified without ambiguity using such a namespace followed by the class name. Each namespace in PRADO is specified in the following format,
-<div class="source">
-PathAlias.Dir1.Dir2
-</div>
-where <tt>PathAlias</tt> is an alias of some directory, while <tt>Dir1</tt> and <tt>Dir2</tt> are subdirectories under that directory. A class named <tt>MyClass</tt> defined under <tt>Dir2</tt> may now be fully qualified as <tt>PathAlias.Dir1.Dir2.MyClass</tt>.
-</p>
-<p id="110123" class="block-content">
-To use a namespace in code, do as follows,
-<com:TTextHighlighter CssClass="source block-content" id="code_110063">
-Prado::using('PathAlias.Dir1.Dir2.*');
-</com:TTextHighlighter>
-which appends the directory referred to by <tt>PathAlias.Dir1.Dir2</tt> into PHP include path so that classes defined under that directory may be instantiated without the namespace prefix. You may also include an individual class definition by
-<com:TTextHighlighter CssClass="source block-content" id="code_110064">
-Prado::using('PathAlias.Dir1.Dir2.MyClass');
-</com:TTextHighlighter>
-which will include the class file if <tt>MyClass</tt> is not defined.
-</p>
-<p id="110124" class="block-content">
-For more details about defining path aliases, see <a href="?page=Configurations.AppConfig">application configuration</a> section.
-</p>
-
-<h2 id="705">Component Instantiation</h2>
-<p id="110125" class="block-content">
-Component instantiation means creating instances of component classes. There are two types of component instantation: static instantiation and dynamic instantiation. The created components are called static components and dynamic components, respectively.
-</p>
-
-<h3 id="707">Dynamic Component Instantiation</h3>
-<p id="110126" class="block-content">
-Dynamic component instantiation means creating component instances in PHP code. It is the same as the commonly referred object creation in PHP. A component can be dynamically created using one of the following two methods in PHP,
-<com:TTextHighlighter CssClass="source block-content" id="code_110065">
-$component = new ComponentClassName;
-$component = Prado::createComponent('ComponentType');
-</com:TTextHighlighter>
-where <tt>ComponentType</tt> refers to a class name or a type name in namespace format (e.g. <tt>System.Web.UI.TControl</tt>). The second approach is introduced to compensate for the lack of namespace support in PHP.
-</p>
-
-<h3 id="708">Static Component Instantiation</h3>
-<p id="110127" class="block-content">
-Static component instantiation is about creating components via <a href="?page=Configurations.Overview">configurations</a>. The actual creation work is done by the PRADO framework. For example, in an <a href="?page=Configurations.AppConfig">application configuration</a>, one can configure a module to be loaded when the application runs. The module is thus a static component created by the framework. Static component instantiation is more commonly used in <a href="?page=Configurations.Templates1">templates</a>. Every component tag in a template specifies a component that will be automatically created by the framework when the template is loaded. For example, in a page template, the following tag will lead to the creation of a <tt>TButton</tt> component on the page,
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_110066">
-<com:TButton Text="Register" />
-</com:TTextHighlighter>
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/ja/Controls.page b/demos/quickstart/protected/pages/Fundamentals/ja/Controls.page deleted file mode 100755 index 75f6bedf..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/ja/Controls.page +++ /dev/null @@ -1,51 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="801">Controls</h1>
-<p id="120128" class="block-content">
-A control is an instance of class <tt>TControl</tt> or its subclass. A control is a component defined in addition with user interface. The base class <tt>TControl</tt> defines the parent-child relationship among controls which reflects the containment relationship among user interface elements.
-</p>
-
-<h2 id="802">Control Tree</h2>
-<p id="120129" class="block-content">
-Controls are related to each other via parent-child relationship. Each parent control can have one or several child controls. A parent control is in charge of the state transition of its child controls. The rendering result of the child controls are usually used to compose the parent control's presentation. The parent-child relationship brings together controls into a control tree. A page is at the root of the tree, whose presentation is returned to the end-users.
-</p>
-<p id="120130" class="block-content">
-The parent-child relationship is usually established by the framework via <a href="?page=Configurations.Templates1">templates</a>. In code, you may explicitly specify a control as a child of another using one of the following methods,
-<com:TTextHighlighter CssClass="source block-content" id="code_120067">
-$parent->Controls->add($child);
-$parent->Controls[]=$child;
-</com:TTextHighlighter>
-where the property <tt>Controls</tt> refers to the child control collection of the parent.
-</p>
-
-<h2 id="803">Control Identification</h2>
-<p id="120131" class="block-content">
-Each control has an <tt>ID</tt> property that can be uniquely identify itself among its sibling controls. In addition, each control has a <tt>UniqueID</tt> and a <tt>ClientID</tt> which can be used to globally identify the control in the tree that the control resides in. <tt>UniqueID</tt> and <tt>ClientID</tt> are very similar. The former is used by the framework to determine the location of the corresponding control in the tree, while the latter is mainly used on the client side as HTML tag IDs. In general, you should not rely on the explicit format of <tt>UniqueID</tt> or <tt>ClientID</tt>.
-</p>
-
-<h2 id="804">Naming Containers</h2>
-<p id="120132" class="block-content">
-Each control has a naming container which is a control creating a unique namespace for differentiating between controls with the same <tt>ID</tt>. For example, a <tt>TRepeater</tt> control creates multiple items each having child controls with the same <tt>ID</tt>s. To differentiate these child controls, each item serves as a naming container. Therefore, a child control may be uniquely identified using its naming container's <tt>ID</tt> together with its own <tt>ID</tt>. As you may already have understood, <tt>UniqueID</tt> and <tt>ClientID</tt> rely on the naming containers.
-</p>
-<p id="120133" class="block-content">
-A control can serve as a naming container if it implements the <tt>INamingContainer</tt> interface.
-</p>
-
-<h2 id="805">ViewState and ControlState</h2>
-<p id="120134" class="block-content">
-HTTP is a stateless protocol, meaning it does not provide functionality to support continuing interaction between a user and a server. Each request is considered as discrete and independent of each other. A Web application, however, often needs to know what a user has done in previous requests. People thus introduce sessions to help remember such state information.
-</p>
-<p id="120135" class="block-content">
-PRADO borrows the viewstate and controlstate concept from Microsoft ASP.NET to provides additional stateful programming mechanism. A value storing in viewstate or controlstate may be available to the next requests if the new requests are form submissions (called postback) to the same page by the same user. The difference between viewstate and controlstate is that the former can be disabled while the latter cannot.
-</p>
-<p id="120136" class="block-content">
-Viewstate and controlstate are implemented in <tt>TControl</tt>. They are commonly used to define various properties of controls. To save and retrieve values from viewstate or controlstate, use following methods,
-<com:TTextHighlighter CssClass="source block-content" id="code_120068">
-$this->getViewState('Name',$defaultValue);
-$this->setViewState('Name',$value,$defaultValue);
-$this->getControlState('Name',$defaultValue);
-$this->setControlState('Name',$value,$defaultValue);
-</com:TTextHighlighter>
-where <tt>$this</tt> refers to the control instance, <tt>Name</tt> refers to a key identifying the persistent value, <tt>$defaultValue</tt> is optional. When retrieving values from viewstate or controlstate, if the corresponding key does not exist, the default value will be returned.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/ja/Hangman.page b/demos/quickstart/protected/pages/Fundamentals/ja/Hangman.page deleted file mode 100755 index d1776b7c..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/ja/Hangman.page +++ /dev/null @@ -1,14 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="1301">Sample: Hangman Game</h1>
-<p id="60043" class="block-content">
-Having seen the simple "Hello World" application, we now build a more complex application called "Hangman Game". In this game, the player is asked to guess a word, a letter at a time. If he guesses a letter right, the letter will be shown in the word. The player can continue to guess as long as the number of his misses is within a prespecified bound. The player wins the game if he finds out the word within the miss bound, or he loses.
-</p>
-<p id="60044" class="block-content">
-To facilitate the building of this game, we show the state transition diagram of the gaming process in the following,
-<br /><br />
-To be continued...
-</p>
-<com:RunBar PagePath="Fundamentals.Samples.Hangman.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/ja/Modules.page b/demos/quickstart/protected/pages/Fundamentals/ja/Modules.page deleted file mode 100755 index 37406976..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/ja/Modules.page +++ /dev/null @@ -1,50 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="1001">Modules</h1>
-<p id="140141" class="block-content">
-A module is an instance of a class implementing the <tt>IModule</tt> interface. A module is commonly designed to provide specific functionality that may be plugged into a PRADO application and shared by all components in the application.
-</p>
-<p id="140142" class="block-content">
-PRADO uses configurations to specify whether to load a module, load what kind of modules, and how to initialize the loaded modules. Developers may replace the core modules with their own implementations via application configuration, or they may write new modules to provide additional functionalities. For example, a module may be developed to provide common database logic for one or several pages. For more details, please see the <a href="?page=Configurations.Overview">configurations</a>.
-</p>
-<p id="140143" class="block-content">
-There are three core modules that are loaded by default whenever an application runs. They are <a href="#request">request module</a>, <a href="#response">response module</a>, and <a href="#error">error handler module</a>. In addition, <a href="#session">session module</a> is loaded when it is used in the application. PRADO provides default implementation for all these modules. <a href="#custom">Custom modules</a> may be configured or developed to override or supplement these core modules.
-</p>
-
-<a name="request"></a>
-<h2 id="1002">Request Module</h2>
-<p id="140144" class="block-content">
-Request module represents provides storage and access scheme for user request sent via HTTP. User request data comes from several sources, including URL, post data, session data, cookie data, etc. These data can all be accessed via the request module. By default, PRADO uses <tt>THttpRequest</tt> as request module. The request module can be accessed via the <tt>Request</tt> property of application and controls.
-</p>
-
-<a name="response"></a>
-<h2 id="1003">Response Module</h2>
-<p id="140145" class="block-content">
-Response module implements the mechanism for sending output to client users. Response module may be configured to control how output are cached on the client side. It may also be used to send cookies back to the client side. By default, PRADO uses <tt>THttpResponse</tt> as response module. The response module can be accessed via the <tt>Response</tt> property of application and controls.
-</p>
-
-<a name="session"></a>
-<h2 id="1004">Session Module</h2>
-<p id="140146" class="block-content">
-Session module encapsulates the functionalities related with user session handling. Session module is automatically loaded when an application uses session. By default, PRADO uses <tt>THttpSession</tt> as session module, which is a simple wrapper of the session functions provided by PHP. The session module can be accessed via the <tt>Session</tt> property of application and controls.
-</p>
-
-<a name="error"></a>
-<h2 id="1005">Error Handler Module</h2>
-<p id="140147" class="block-content">
-Error handler module is used to capture and process all error conditions in an application. PRADO uses <tt>TErrorHandler</tt> as error handler module. It captures all PHP warnings, notices and exceptions, and displays in an appropriate form to end-users. The error handler module can be accessed via the <tt>ErrorHandler</tt> property of the application instance.
-</p>
-
-<a name="custom"></a>
-<h2 id="1006">Custom Modules</h2>
-<p id="140148" class="block-content">
-PRADO is released with a few more modules besides the core ones. They include caching modules (<tt>TSqliteCache</tt> and <tt>TMemCache</tt>), user management module (<tt>TUserManager</tt>), authentication and authorization module (<tt>TAuthManager</tt>), etc.
-</p>
-<p id="140149" class="block-content">
-When <tt>TPageService</tt> is requested, it also loads modules specific for page service, including asset manager (<tt>TAssetManager</tt>), template manager (<tt>TTemplateManager</tt>), theme/skin manager (<tt>TThemeManager</tt>).
-</p>
-<p id="140150" class="block-content">
-Custom modules and core modules are all configurable via <a href="?page=Configurations.Overview">configurations</a>.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/ja/Pages.page b/demos/quickstart/protected/pages/Fundamentals/ja/Pages.page deleted file mode 100755 index 19900937..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/ja/Pages.page +++ /dev/null @@ -1,23 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="901">Pages</h1>
-<p id="130137" class="block-content">
-Pages are top-most controls that have no parent. The presentation of pages are directly displayed to end-users. Users access pages by sending page service requests.
-</p>
-<p id="130138" class="block-content">
-Each page must have a <a href="?page=Configurations.Templates1">template</a> file. The file name suffix must be <tt>.page</tt>. The file name (without suffix) is the page name. PRADO will try to locate a page class file under the directory containing the page template file. Such a page class file must have the same file name (suffixed with <tt>.php</tt>) as the template file. If the class file is not found, the page will take class <tt>TPage</tt>.
-</p>
-
-<h2 id="902">PostBack</h2>
-<p id="130139" class="block-content">
-A form submission is called <i>postback</i> if the submission is made to the page containing the form. Postback can be considered an event happened on the client side, raised by the user. PRADO will try to identify which control on the server side is responsible for a postback event. If one is determined, for example, a <tt>TButton</tt>, we call it the postback event sender which will translate the postback event into some specific server-side event (e.g. <tt>OnClick</tt> and <tt>OnCommand</tt> events for <tt>TButton</tt>).
-
-</p>
-
-<h2 id="903">Page Lifecycles</h2>
-<p id="130140" class="block-content">
-Understanding the page lifecycles is crucial to grasp PRADO programming. Page lifecycles refer to the state transitions of a page when serving this page to end-users. They can be depicted in the following statechart,
-<img src="<%~lifecycles.gif %>" />
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/ja/Services.page b/demos/quickstart/protected/pages/Fundamentals/ja/Services.page deleted file mode 100755 index 5e5889df..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/ja/Services.page +++ /dev/null @@ -1,34 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="1101">Services</h1>
-<p id="150151" class="block-content">
-A service is an instance of a class implementing the <tt>IService</tt> interface. Each kind of service processes a specific type of user requests. For example, the page service responds to users' requests for PRADO pages.
-</p>
-<p id="150152" class="block-content">
-A service is uniquely identified by its <tt>ID</tt> property. By default when <tt>THttpRequest</tt> is used as the <a href="?page=Fundamentals.Modules#request">request module</a>, GET variable names are used to identify which service a user is requesting. If a GET variable name is equal to some service <tt>ID</tt>, the request is considered for that service, and the value of the GET variable is passed as the service parameter. For page service, the name of the GET variable must be <tt>page</tt>. For example, the following URL requests for the <tt>Fundamentals.Services</tt> page,
-<com:TTextHighlighter Language="none" CssClass="source block-content" id="code_150069">
-http://hostname/index.php?page=Fundamentals.Services
-</com:TTextHighlighter>
-</p>
-<p id="150153" class="block-content">
-Developers may implement additional services for their applications. To make a service available, configure it in <a href="?page=Configurations.AppConfig">application configurations</a>.
-</p>
-
-<h2 id="1102">Page Service</h2>
-<p id="150154" class="block-content">
-PRADO implements <tt>TPageService</tt> to process users' page requests. Pages are stored under a directory specified by the <tt>BasePath</tt> property of the page service. The property defaults to <tt>pages</tt> directory under the application base path. You may change this default by configuring the service in the application configuration.
-</p>
-<p id="150155" class="block-content">
-Pages may be organized into subdirectories under the <tt>BasePath</tt>. In each directory, there may be a page configuration file named <tt>config.xml</tt>, which contains configurations effective only when a page under that directory or a sub-directory is requested. For more details, see the <a href="?page=Configurations.PageConfig">page configuration</a> section.
-</p>
-<p id="150156" class="block-content">
-Service parameter for the page service refers to the page being requested. A parameter like <tt>Fundamentals.Services</tt> refers to the <tt>Services</tt> page under the <tt><BasePath>/Fundamentals</tt> directory. If such a parameter is absent in a request, a default page named <tt>Home</tt> is assumed. Using <tt>THttpRequest</tt> as the request module (default), the following URLs will request for <tt>Home</tt>, <tt>About</tt> and <tt>Register</tt> pages, respectively,
-<com:TTextHighlighter Language="none" CssClass="source block-content" id="code_150070">
-http://hostname/index.php
-http://hostname/index.php?page=About
-http://hostname/index.php?page=Users.Register
-</com:TTextHighlighter>
-where the first example takes advantage of the fact that the page service is the default service and <tt>Home</tt> is the default page.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/ja/applifecycles.gif b/demos/quickstart/protected/pages/Fundamentals/ja/applifecycles.gif Binary files differdeleted file mode 100755 index d5300aa6..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/ja/applifecycles.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/ja/classtree.gif b/demos/quickstart/protected/pages/Fundamentals/ja/classtree.gif Binary files differdeleted file mode 100755 index b1fbf0d6..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/ja/classtree.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/ja/directory.gif b/demos/quickstart/protected/pages/Fundamentals/ja/directory.gif Binary files differdeleted file mode 100755 index c7d5086d..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/ja/directory.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/ja/lifecycles.gif b/demos/quickstart/protected/pages/Fundamentals/ja/lifecycles.gif Binary files differdeleted file mode 100755 index 5edaff5f..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/ja/lifecycles.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/ja/objectdiagram.gif b/demos/quickstart/protected/pages/Fundamentals/ja/objectdiagram.gif Binary files differdeleted file mode 100755 index 7910469c..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/ja/objectdiagram.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/pl/Applications.page b/demos/quickstart/protected/pages/Fundamentals/pl/Applications.page deleted file mode 100755 index 23866005..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/pl/Applications.page +++ /dev/null @@ -1,58 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="1201">Aplikacja</h1>
-<p id="160157" class="block-content">
-Aplikacja jest instancją <tt>TApplication</tt> lub klasy po niej dziedziczącej. Zarządza modułami dostarczającymi różnorodne funkcjonalności i ładuje je w razie potrzeby. Dostarcza użytkownikowu końcowemu serwisy.
-Jest centralnym miejscem do przechowywania różnych parametrów używanych w aplikacji. W aplikacji PRADO instancja aplikacji jest jedynym globalnie dostepnym obiektem poprzez wywołania funkcji <tt>Prado::getApplication()</tt>.
-</p>
-<p id="160158" class="block-content">
-Aplikacje są konfigurowane poprzez <a href="?page=Configurations.AppConfig">konfigurację aplikacji</a>. Są zazwyczaj tworzone w skrypcie wejściowym w podobny do następującego sposób,
-<com:TTextHighlighter CssClass="source block-content" id="code_160071">
-require_once('/path/to/prado.php');
-$application = new TApplication;
-$application->run();
-</com:TTextHighlighter>
-gdzie metoda <tt>run()</tt> rozpoczyna działanie aplikacji obsługującej żądania użytkownika.
-</p>
-
-<h2 id="1202">Organizacja folderów</h2>
-<p id="160159" class="block-content">
-Minimalna aplikacja PRADO zawiera dwa pliki: plik wejściowy i plik szablonu. Muszą być one zorganizowane w następujący sposób.
-<img src="<%~directory.gif%>" class="figure"/>
-</p>
-<ul id="u2" class="block-content">
-<li><tt>wwwroot</tt> - główny katalog serwera WWW lub jeden z podkatalogów.</li>
-<li><tt>index.php</tt> - skrypt wejściowy aplikacji PRADO.</li>
-<li><tt>assets</tt> - katalog przechowujący opublikowane pliki prywatne. Zobacz sekcję <a href="?page=Advanced.Assets">assets</a>.</li>
-<li><tt>protected</tt> - podstawowa ścieżka aplikacji zawierająca jej dane oraz prywatne pliki skryptów. Ten folder powinien być niedostepny z zewnątrz lub powinien znajdować się poza strukturą serwera WWW.</li>
-<li><tt>runtime</tt> - application runtime storage path. Ten folder jest używany przez PRADO do przechowywania informacji o wykonywanej aplikacji, takich jak stan aplikacji, kedzowane dane, itd.</li>
-<li><tt>pages</tt> - podstawowa ścieżka przechowująca wszystkie strony PRADO. Zobacz sekcję <a href="?page=Fundamentals.Services">serwisy</a>.</li>
-<li><tt>Home.page</tt> - domyślna strona zwracana gdy użytkownik nie poda jawnie żadanej strony. Jest to plik szablonu strony. Nazwa pliku bez rozszerzenia jest nazwą strony. Klasą strony jest klasa <tt>TPage</tt>. Jeśli znajduje się tam również plik klasy <tt>Home.php</tt>, klasą strony staje się <tt>Home</tt>.</li>
-</ul>
-
-<p id="160160" class="block-content">
-Produktywna aplikacja PRADO zazwyczaj potrzebuje więcej plików. Może ona zawierać plik konfiguracji aplikacji <tt>application.xml</tt> w podstawej ścieżce aplikacji <tt>protected</tt>. Strony mogą być zorganizowane w foldery, część z nich może zawierać pliki konfiguracji strony <tt>config.xml</tt>. Aby dowiedzieć się wiecej, zajrzyć do sekcji <a href="?page=Configurations.Overview">konfiguracji</a>.
-</p>
-
-<h2 id="1203">Osadzanie aplikacji</h2>
-<p id="160161" class="block-content">
-Osadzanie aplikacji PRADO zazwyczaj wiąże się z kopiowaniem folderów. Na przykład, aby osadzić powyższą minimalną wersję aplikacji na innym serwerze należy wykonać następujące kroki.
-</p>
-<ol>
-<li>Skopiuj zawartość z <tt>wwwroot</tt> do dostępnego poprzez WWW foldera na nowym serwerze.</li>
-<li>Zmodyfikuj skrypt wejściowy <tt>index.php</tt> tak by prawidłowo inkludował plik <tt>prado.php</tt>.</li>
-<li>Usuń całą zawartość z folderów <tt>assets</tt> i <tt>runtime</tt> i upewnij się, że oba umożliwiają zapis procesom serwera WWW.</li>
-</ol>
-
-<h2 id="1204">Cykle życia aplikacji</h2>
-<p id="160162" class="block-content">
-Tak jak cykle życia strony tak aplikacja również posiada cykle życia. Moduły aplikacji mogą rejestrować zdarzenia dla cykli życia.
-Kiedy aplikacja znajduje się w konkretnym cyklu i wywołuje odpowiednie zdarzenie, zarejstrowana metoda modułu jest wywoływana automatycznie.
-Moduły załaczone w oficjalnym wydaniu PRADO, takie jak <tt>TAuthManager</tt>, używają tego sposobu aby wyknać swoje zadania.
-</p>
-<p id="160163" class="block-content">
-Cykle życia aplikacji mogą zostać przedstawione następująco:
-</p>
-<img src="<%~applifecycles.gif%>" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/pl/Architecture.page b/demos/quickstart/protected/pages/Fundamentals/pl/Architecture.page deleted file mode 100755 index db429253..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/pl/Architecture.page +++ /dev/null @@ -1,15 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="601">Architektura</h1>
-
-<p id="100111" class="block-content">
-Prado jest przede wszystkim frameworkiem służącym do prezentacji, mimo to nie jest on ograniczony jedynie do ten funkcjonalności.
-Framework skupia się na programowaniu webowym, które w większości czasu ma do czynienia z interakcją z użytkownikiem, bazując na programowaniu sterowanym zdarzeniami (ang. event driven) oraz bazującym na komponentach (ang. component based),
-tak by deweloper był bardziej produktywny. Następujące drzewko klas pokazuje główne klasy dostarczanych przez PRADO.
-</p>
-<img src="<%~classtree.gif%>" />
-
-<p id="100112" class="block-content">
-Kiedy PRADO przetwarza żądanie strony, jego diagram obiektów statycznych wygląda następująco.
-</p>
-<img src="<%~objectdiagram.gif%>" />
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/pl/Components.page b/demos/quickstart/protected/pages/Fundamentals/pl/Components.page deleted file mode 100755 index 5890f17f..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/pl/Components.page +++ /dev/null @@ -1,128 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="701">Komponenty</h1>
-<p id="110113" class="block-content">
-Komponent jest instancją klasy lub klasy potomnej <tt>TComponent</tt>. Klasa bazowa <tt>TComponent</tt> implementuje mechanizm właściwości oraz zdarzeń kompomentu.
-</p>
-
-<h2 id="702">Właściwości komponentu (ang. component properties)</h2>
-<p id="110114" class="block-content">
-Właściwość kompoenentu może być postrzegana jako publiczna zmienna opsiującą określoną cechę/właściwość komponentu, taką jak kolor tła, rozmiar czcionki, itp. Właściwość jest definiowana poprzez istnienie metody getter i/lub setter w klasie. Na przykład w <tt>TControl</tt> definiujemy właściwość <tt>ID</tt> komponentu używając następujących funkcji typu getter i setter,
-<com:TTextHighlighter CssClass="source block-content" id="code_110056">
-class TControl extends TComponent {
- public function getID() {
- ...
- }
- public function setID($value) {
- ...
- }
-}
-</com:TTextHighlighter>
-</p>
-<p id="110115" class="block-content">
-Aby pobrać lub ustawić właściwość <tt>ID</tt>, postępuj jak poniżej (tak jakbyś miał do czynienia ze zmienną):
-<com:TTextHighlighter CssClass="source block-content" id="code_110057">
-$id = $component->ID;
-$component->ID = $id;
-</com:TTextHighlighter>
-Jest to równoznaczne z następującym zapisem:
-<com:TTextHighlighter CssClass="source block-content" id="code_110058">
-$id = $component->getID();
-$component->setID( $id );
-</com:TTextHighlighter>
-</p>
-<p id="110116" class="block-content">
-Właściwość jest "tylko do odczytu" jeśli posiada metodę getter a nie posiada metody setter. Odkąd nazwy metod w PHP nie są zależne od wielkiej bądź małej litery, właściwości również są niewrażliwe na wielkość liter. Klasa kompomentu dziedziny wszystkie właściwości rodzica.
-</p>
-
-<h3 id="706">Subwłaściwości (ang. subproperties)</h3>
-<p id="110117" class="block-content">
-Subwłaściwość jest właściwością właściwości typu obiektowego. Dla przykładu <tt>TWebControl</tt> posiada właściwość <tt>Font</tt>, która jest typu <tt>TFont</tt>. Wtedy właściwość <tt>Name</tt> właściwości <tt>Font</tt> jest subwłaściwością w stosunku do <tt>TWebControl</tt>.
-</p>
-<p id="110118" class="block-content">
-Aby pobrać lub ustawić subwłaściwość <tt>Name</tt> należy użyć następującej metody:
-<com:TTextHighlighter CssClass="source block-content" id="code_110059">
-$name = $component->getSubProperty('Font.Name');
-$component->setSubProperty('Font.Name', $name);
-</com:TTextHighlighter>
-Jest to równoznaczne z następującym zapisem:
-<com:TTextHighlighter CssClass="source block-content" id="code_110060">
-$name = $component->getFont()->getName();
-$component->getFont()->setName( $name );
-</com:TTextHighlighter>
-
-
-</p>
-
-<h2 id="703">Zdarzenia komponentu</h2>
-<p id="110119" class="block-content">
-Zdarzenia komponentu są specjalnymi właściwościami, które pobierają nazwy metod jako swoje wartości. Przypisując (ustawiając) metodę do zdarzenia (will hook up the method ) do miejsca gdzie zdarzenie jest wywoływane. Dzięki temu zachowanie komponentu może zostać zmodyfikowane w sposób, który nie był przewidziany podczas fazy dewelopowania komponentu.
-</p>
-<p id="110120" class="block-content">
-Zdarzenie komponentu jest definiowane poprzez istnienie metody, której nazwa zaczyna się przedrostkiem <tt>on</tt>. Nazwa zdarzenia jest nazwą metody i z tego powodu jest niewrażliwa na wielkość liter. Na przykład w komponencie <tt>TButton</tt> mamy:
-<com:TTextHighlighter CssClass="source block-content" id="code_110061">
-class TButton extends TWebControl {
- public function onClick( $param ) {
- ...
- }
-}
-</com:TTextHighlighter>
-W ten sposób definiujemy metodę o nazwie <tt>OnClick</tt> a uchwyt do zdarzenia przez nią definiowanego może być przypisany w jeden z następujących sposobów:
-<com:TTextHighlighter CssClass="source block-content" id="code_110062">
-$button->OnClick = $callback;
-$button->OnClick->add( $callback );
-$button->OnClick[] = $callback;
-$button->attachEventHandler( 'OnClick' , $callback );
-</com:TTextHighlighter>
-gdzie <tt>$callback</tt> odnosi się do poprawnej funkcji typu callback w PHP (np. nazwy funkcji, metody klasy <tt>array($object,'method')</tt>, itp.)
-</p>
-
-<h2 id="704">Przestrzenie nazw (ang. namespaces)</h2>
-<p id="110121" class="block-content">
-Przestrzeń nazw odnosi się do logicznego pogrupowania nazwy klas w taki sposób, że moga być one odróżniane od innych klas, których nazwy są identyczne. Ponieważ PHP nie wspiera przestrzeni nazw sam w sobie, nie można stworzyć instancji dwóch klas, które mają tą samoą nazwę ale różne definicje. Aby odróżniać się od klas użytkowników wszystkie klasy PRADO posiadają prefix 'T' (oznaczający 'Type' - z angielskiego: typ). Zachęcamy do nazywania własnych klas w ten sposób. W odróznieniu można dodawać prefiksy klas zaczynające się dowolną inną literą (lub grupą liter).
-</p>
-<p id="110122" class="block-content">
-Przestrzeń nazw w PRADO jest postrzegana jako folder zawierający jednen lub więcej plików klas. Poprzez poprzedzania nazwy klasy przestrzenią nazw klasa może zostać określona jednoznacznie. Każda przestrzeń nazw jest w PRADO określona w następujący sposób:
-<div class="source">
-PathAlias.Dir1.Dir2
-</div>
-gdzie <tt>PathAlias</tt> jest aliasem jakiegoś katalogu, gdzie <tt>Dir1</tt> i <tt>Dir2</tt> są podkatalogami tego katalogu. Klasa o nazwie <tt>MyClass</tt> zdefiniowana w <tt>Dir2</tt> jest fully qualified poprzez <tt>PathAlias.Dir1.Dir2.MyClass</tt>.
-</p>
-<p id="110123" class="block-content">
-By używać przestrzeni nazw w kodzie, napisz:
-<com:TTextHighlighter CssClass="source block-content" id="code_110063">
-Prado::using('PathAlias.Dir1.Dir2.*');
-</com:TTextHighlighter>
-co spowoduje dołączenie katalogu wskazywanego przez <tt>PathAlias.Dir1.Dir2</tt> do ścieżek include w PHP, dzięki czemu instancje klas zdefiniowanych w podanym katalogu mogą zostać utworzone bez podawania pełnej przestrzeni nazw. Możesz również zainkludować pojedyńczą definicję klasy poprzez
-<com:TTextHighlighter CssClass="source block-content" id="code_110064">
-Prado::using('PathAlias.Dir1.Dir2.MyClass');
-</com:TTextHighlighter>
-co spowoduje zainkludowanie pliku klasy <tt>MyClass</tt> jeśli nie została ona jeszcze zdefiniowana.
-</p>
-<p id="110124" class="block-content">
-Aby zobaczyć więcej informacji o definiowaniu aliasów zobacz sekcję <a href="?page=Configurations.AppConfig">konfigurowanie aplikacji</a>.
-</p>
-
-<h2 id="705">Tworzenie instancji komponentu</h2>
-<p id="110125" class="block-content">
-Tworzenie instancji komponentu oznacza tworzenie instancji klasy komponentu. Rozróżniamy dwa typy instancji komponentu: statyczną i dynamiczną. Utworzone komponenty nazywane są odpowiednio komponentami statycznymi i dynamicznymi.
-</p>
-
-<h3 id="707">Dynamiczne tworzenie instancji komponentów</h3>
-<p id="110126" class="block-content">
-Dynamiczne tworzenie instancji komponentów oznacza tworzenie instancji komponentu w kodzie PHP. Wygląda to identycznie jak zwyczajne tworznie komponentów w PHP. Komponent może zostać dynamicznie utworzony w jeden z poniższych sposobów w PHP:
-<com:TTextHighlighter CssClass="source block-content" id="code_110065">
-$component = new ComponentClassName;
-$component = Prado::createComponent('ComponentType');
-</com:TTextHighlighter>
-gdzie <tt>ComponentType</tt> wskazuje na nazwę klasy lub nazwę typu w formacie przestrzeni nazw (np. <tt>System.Web.UI.TControl</tt>). Drugi sposób został wprowadzony aby wypełnić brak wsparcia dla przestrzeni nazw w PHP.
-</p>
-
-<h3 id="708">Statyczne tworzenie instancji komponentów</h3>
-<p id="110127" class="block-content">
-Statyczne tworzenie instancji komponentów odnosi się do tworznenia komponentów poprzez <a href="?page=Configurations.Overview">konfigurację</a>. Proces tworzenia odbywa się po stronie frameworku. Na przykład w <a href="?page=Configurations.AppConfig">konfiguracji aplikacji</a> można skonfigurować moduł, który zostanie załadowany podczas uruchamiania aplikacji. Zatem moduł jest statycznym komponentem stworzonym przez framework. Statyczne tworzenie instancji jest często wspólnie używane w <a href="?page=Configurations.Templates1">szablonach</a>. Każdy tag komponentu w szablonie określa komponent, który będzie automatycznie stworzony przez framework, kiedy szablon będzie ładowany. Na przykład w szablonie strony następujący tag doprowadzi do stworzenia komponentu <tt>TButton</tt> na stronie:
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_110066">
-<com:TButton Text="Register" />
-</com:TTextHighlighter>
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/pl/Controls.page b/demos/quickstart/protected/pages/Fundamentals/pl/Controls.page deleted file mode 100755 index 68fdb993..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/pl/Controls.page +++ /dev/null @@ -1,51 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="801">Kontrolki (ang. controls)</h1>
-<p id="120128" class="block-content">
-Kontrolka jest instancją klasy <tt>TControl</tt> lub jej dziecka. Kontrolka jest komponentem definiowanym z dodatkiem interfejsu użytkownika. Klasa bazowa <tt>TControl</tt> definiuje relację rodzic-dziecko among controls which reflects the containment relationship among user interface elements.
-</p>
-
-<h2 id="802">Drzewko kontrolek</h2>
-<p id="120129" class="block-content">
-Kontrolki są powiązane z sobą za pomocą relacji rodzic-dziecko. Każda kontrolka rodzica może posiadać jedną lub więcej kontrolek dzieci. Kontrolka rodzica jest in charge of the state transition of its child controls. Wynik renderowanie kontrolki dziecka jest zazwyczaj używany do stworzenia warstwy prezentacji kontrolki rodzica. Relacja rodzic-dziecko brings together controls into a control tree. Strona jest korzeniem drzewka, której warstwa prezentacji jest zwracana dla użytkownika końcowego.
-</p>
-<p id="120130" class="block-content">
-Relacja rodzic-dziecko jest zazwyczaj ustalana przez framework poprzez <a href="?page=Configurations.Templates1">szablony</a>. W kodzie można bezpośrednio określić kontrolkę jako dziecko innej kontrolki stosując jedną z następujących metod:
-<com:TTextHighlighter CssClass="source block-content" id="code_120067">
-$parent->Controls->add($child);
-$parent->Controls[]=$child;
-</com:TTextHighlighter>
-gdzie właściwość <tt>Controls</tt> wskazuje na kolekcję kontrolek bedących dziećmi rodzica.
-</p>
-
-<h2 id="803">Identyfikacja kontrolki</h2>
-<p id="120131" class="block-content">
-Każda kontrolka ma właściwość <tt>ID</tt>, która jednoznacznie identyfikuje ją samą spośród jej rodzeństwa. W dodatku każda kontrolka posiada właściwość <tt>UniqueID</tt> oraz <tt>ClientID</tt>, która może zostać użyta do identyfikacji "globalnej" kontrolki w drzewku gdzie znajduje się ta kontrolka. Właściwości <tt>UniqueID</tt> oraz <tt>ClientID</tt> są bardzo podobne. Pierwsza jest używana przez framework do określenia położenia odpowiedniej kontrolki w drzewku, druga jest głównie używana po stronie klienta jako ID w tagach HTML. Ogólnie rzecz ujmując nie powinno się polegać na tak sprecyzowanym formacie <tt>UniqueID</tt> lub <tt>ClientID</tt>.
-</p>
-
-<h2 id="804">Kontenery nazw (ang. naming containers)</h2>
-<p id="120132" class="block-content">
-Każda kontrolka posiada kontener nazw, który jest kontrolką tworzącą unikalną przestrzeń nazw dla rozróżnienie pomiędzy kontrolkami o tych samych <tt>ID</tt>. Na przykład kontrolka <tt>TRepeater</tt> tworzy wiele pozycji, które posiadają kontrolki-dzieci o tych samych <tt>ID</tt>. Aby rozróżnić te kontrolki-dzieci, każda pozycja służy jako kontener nazw. Dzięki temu, kontrolka-dziecko może zostać jednoznacznie zidentyfikowana używając <tt>ID</tt> swojego kontenera nazw razem z swoim własnym <tt>ID</tt>. Powinieneś teraz zrozumieć, że właściwości <tt>UniqueID</tt> i <tt>ClientID</tt> bazują (wynikają?) na kontenerze nazw.
-</p>
-<p id="120133" class="block-content">
-Kontrolka może służyć jako kontener naz jeśli implementuje interfejs <tt>INamingContainer</tt>.
-</p>
-
-<h2 id="805">Stan widoku (ang. ViewState) oraz stan kontrolki (ang. ControlState)</h2>
-<p id="120134" class="block-content">
-HTTP jest protokołem bezstanowym, co oznacza, że nie dostarcza on funkjonalności wspierającej kontynuowanie interakcji pomiędzy użytkownikiem a serwerem. Każde żądanie (ang. request) jest rozpatrywane jako pojedyńcze i niezależne w stosunku do innego żądania. Jednakże, aplikacja webowa często potrzebuje wiedzieć co użytkownik zrobił w poprzednich żądaniach. Dlatego wprowadzono sesje by pomóc zapamiętać te informacje o stanie.
-</p>
-<p id="120135" class="block-content">
-PRADO zapożycza koncept stanu widoku oraz stanu kontrolki z ASP.NET Microsoftu by dostarczać dodatkowego stanowego mechanizmu programowania (ang. stateful programming mechanism). Wartość zachowana w stanie widoku lub stanie kontrolki może być dostępna w następnym żądaniu jeśli nowe żądanie pochodzi od wysłania formularza (ang. form submissions) (nazywanej postback'iem) do tej samej strony przez tego samego użytkownika. Różnica pomiędzy stanem widoku a stanem kontrolki wynika z tego iż pierwsza może zostać wyłączona a druga nie.
-</p>
-<p id="120136" class="block-content">
-Stan widoku i stan kontrolki są zaimplementowane w <tt>TControl</tt>. Są one zazwyczaj używane do zdefiniowania różnych właściwościu kontrolki. By zapisać i przywrócić wartości ze stanu widoku lub stanu kontrolki, należy użyć następujących sposobów:
-<com:TTextHighlighter CssClass="source block-content" id="code_120068">
-$this->getViewState('Nazwa',$wartoscDomyslna);
-$this->setViewState('Nazwa',$wartosc,$wartoscDomyslna);
-$this->getControlState('Nazwa',$wartoscDomyslna);
-$this->setControlState('Nazwa',$wartosc,$wartoscDomyslna);
-</com:TTextHighlighter>
-gdzie <tt>$this</tt> odnosi się do instancji kontrolki, <tt>Nazwa</tt> odnosi się to klucza identyfikującego zachowaną wartość, <tt>$wartoscDomyslna</tt> jest opcjonalna. Kiedy przywracamy wartości z stanu widoku lub stanu kontrolki, jeśli podany klucz nie istnieje, wartość domyślna jest zwracana.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/pl/Hangman.page b/demos/quickstart/protected/pages/Fundamentals/pl/Hangman.page deleted file mode 100755 index e3ad1338..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/pl/Hangman.page +++ /dev/null @@ -1,16 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="1301">Przykład: wisielec</h1>
-<p id="60043" class="block-content">
-Zobaczywszy prostą aplikację "Witaj Świecie" stworzymy teraz bardziej skomplikowaną aplikację "Wisielca".
-W tej grze gracz musi odgadnąć słowo podając litery w zadanym czasie. Jeśli odgadnie prawidłowo litera pojawi się w słowie. Gracz może tak długo kontynuować zgadywanie dopóki liczba pomyłek znajduje się w zdefiniwanym na początku zakresie.
-Gracz wygrywa grę jeśli znajdzie słowo zanim przekroczy dozwoloną liczbę pomyłek, w przeciwnym przypadku przegrywa.
-</p>
-<p id="60044" class="block-content">
-Aby ułatwić stowrzenie tej gry, pokażemy diagram zmiany stanów gry następująco
-<br /><br />
-Ciąg dalszy nastąpi...
-</p>
-<com:RunBar PagePath="Fundamentals.Samples.Hangman.Home" />
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/pl/Modules.page b/demos/quickstart/protected/pages/Fundamentals/pl/Modules.page deleted file mode 100755 index 1bc8ca94..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/pl/Modules.page +++ /dev/null @@ -1,50 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="1001">Moduły (ang. modules)</h1>
-<p id="140141" class="block-content">
-Moduł jest instancją klasy implementującej interfejs <tt>IModule</tt>. Moduł jest zazwyczaj zaprojektowany by dostarczać określonej funkcjonalności, która może być podłączona do aplikacji PRADO i dzielona wśród wszystkich komponentów aplikacji.
-</p>
-<p id="140142" class="block-content">
-PRADO używa konfiguracji aby określić kiedy załadować moduł, jaki rodzaj modułu i jak zainicjalizować załadowane moduły. Deweloper może zastąpić zródłowe (ang. core) moduły własnymi implementacjami poprzez konfigurację aplikacji lub może napisać nowe moduły by dostarczać dodatkowe funkcjonalności. Na przykład można stworzyć moduł, który będzie dostarczał wspólną logikę baz danych dla jednej lub więcej stron. Aby dowiedzieć się więcej zobacz sekcję <a href="?page=Configurations.Overview">konfiguracja</a>.
-</p>
-<p id="140143" class="block-content">
-Domyślnie ładowane są 3 moduły źródłowe (ang. core modules) podczas starty aplikacji. Są to <a href="#request">moduł żądania (ang. request module)</a>, <a href="#response">moduł odpowiedzi (ang. responce module)</a> oraz <a href="#error">moduł zarządzania błędami (ang. error handler module)</a>. Dodatkowo <a href="#session">moduł sesji (ang. session module)</a> jest ładowany kiedy jejst on używany w aplikacji. PRADO dostarcza domyślną implementację dla wszystkich tych modułów. <a href="#custom">Dodatkowe moduły (ang. custom modules)</a> mogą być konfigurowane lub stworzone by nadpisać lub uzupełnić te trzy moduły źródłowe.
-</p>
-
-<a name="request"></a>
-<h2 id="1002">Moduł żądania (ang. request module)</h2>
-<p id="140144" class="block-content">
-Moduł żądań reprezentuje i dostarcza schemat dostępu i przechowywania żądań użytkownika wysyłanych poprzez HTTP. Dane żądania użytkownika przychodzą z kilku źródeł wliczając adresy URL, dane z żądania POST, dane sesyjne, dane z ciasteczek, itd. Te dane są dostępne poprzez moduł żądania. Domyślnie PRADO używa <tt>THttpRequest</tt> jako moduł żądania. Moduł żądania jest dostępne poprzez właściwość <tt>Request</tt> aplikacjji i kontrolek.
-</p>
-
-<a name="response"></a>
-<h2 id="1003">Moduł odpowiedzi (ang. response module)</h2>
-<p id="140145" class="block-content">
-Moduł odpowiedzi implementuje mechanizm do wysywałania wyjścia do klienta użytkwonika. Moduł odpowiedzi może zostać skonfigurowany by kontrolować jak wyjście jest keszowane po stronie klienta. Może on być również uzywany by wysyłać cookie z powrotem na stronę klienta. Domyślnie PRADO używa <tt>THttpResponse</tt> jako moduły odpowiedzi. Moduł odpowiedzi jest dostępny poprzez właściwość <tt>Response</tt> aplikacji i kontrolek.
-</p>
-
-<a name="session"></a>
-<h2 id="1004">Moduł sesji (ang. session module)</h2>
-<p id="140146" class="block-content">
-Moduł sesji enkapsuluje funkcjonalność związaną z zarządzaniem sesji użytkowika. Moduł sesji jest automatycznie ładowany jeśli aplikacja używa sesji. Domyślnie PRADO używa <tt>THttpSession</tt> jako moduł sesji, który jest po prostu nadkładką (ang. wrapper) dla funkcji sesyjnych dostarczanych przez PHP. Moduł sesji jest dostępny poprzez właściwość <tt>Session</tt> aplikacji i kontrolek.
-</p>
-
-<a name="error"></a>
-<h2 id="1005">moduł zarządzania błędami (ang. error handler module)</h2>
-<p id="140147" class="block-content">
-Moduł zarządzzania błędami jest użuwany by przechwycić i obsłużyć wszystkie przypadki błędów w aplikacji. PRADO używa <tt>TErrorHandler</tt> jako moduł zarządzania błędami. Przechwytuje on wszystkie ostrzeżenia PHP (ang. warnings), wiadomości (ang. notices) oraz wyjątki (ang. exceptions) i wyświetla w odpowiedniej formie użytkownikowi końcowemu. Moduł zarządzania błędami jest dostępny poprzez właściwość <tt>ErrorHandler</tt> instancji aplikacji.
-</p>
-
-<a name="custom"></a>
-<h2 id="1006">Dodatkowe moduły (ang. custom modules)</h2>
-<p id="140148" class="block-content">
-PRADO zostało wydane z większą ilością modułów niż wymienione moduły źródłowe. PRADO zawiera moduły keszujące (<tt>TSqliteCache</tt> oraz <tt>TMemCache</tt>), moduły zarządzające użytkownikami (<tt>TUserManager</tt>), moduły autentykacji i autoryzacji (<tt>TAuthManager</tt>), itd.
-</p>
-<p id="140149" class="block-content">
-Kiedy wystąpi żądanie <tt>TPageService</tt> ładowane są także określone moduły dla serwisu stron, włączając menedżer elementów aktywnych (ang. assets manager) (<tt>TAssetManager</tt>), menedżer szablonów (<tt>TTemplateManager</tt>), menedżer tematów/skórek (ang. theme/skin manager) (<tt>TThemeManager</tt>).
-</p>
-<p id="140150" class="block-content">
-Dodatkowe moduły oraz moduły źródłowe są konfigurowalne poprzez <a href="?page=Configurations.Overview">konfigurację</a>.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/pl/Pages.page b/demos/quickstart/protected/pages/Fundamentals/pl/Pages.page deleted file mode 100755 index a6318674..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/pl/Pages.page +++ /dev/null @@ -1,25 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="901">Strony (ang. pages)</h1>
-<p id="130137" class="block-content">
-Strony są najwyżej umiejscowionymi w hierarchi kontrolkamki, które nie posiadają rodzica.
-Prezentacja strony jest bezpośrednio wyświetlana użytkownikowi końcowemu. Użytkownicy posiadają dostęp do strony poprzez wysłanie żądanie do serwisu strony (ang. sending page service requests).
-</p>
-<p id="130138" class="block-content">
-Każda strona musi posiadać plik <a href="?page=Configurations.Templates1">szablonu</a>. Musi posiadać on rozszerzenie <tt>.page</tt>. Nazwa pliku (bez rozszerzenia) jest nazwą strony. PRADO będzie próbować znaleźć plik klasy strony w katalogu zawierającym szablon strony. Taki plik klasy strony musi posiadać tą samą nazwę (z rozszerzeniem <tt>.php</tt>) jak plik szablonu. Jeśli klasa nie zostanie znaleziona, strona skorzysta z klasy <tt>TPage</tt>.
-</p>
-
-<h2 id="902">PostBack</h2>
-<p id="130139" class="block-content">
-Wysłanie formularza jest nazywane <i>postback</i> jeśli wysłanie następuje do strony zawierającej formularz. Postback może być postrzegany jako zdarzenie po stronie klienta, wywoływane przez użytkownika. PRADO będzie próbowało zidentyfikować, która kontrolka po stronie serwera jest odpowiedzialna za zdarzenie postblack. Jeśli znajdzie taką, np. przykład <tt>TButton</tt>, nazywać ją będziemy senderem zdarzenia postback, który przetłumaczy zdarzenie postback na pewne specyficzne zdarzenia po stronie serwera (np. zdarzenia <tt>OnClick</tt> i <tt>OnCommand</tt> dla <tt>TButton</tt>).
-
-</p>
-
-<h2 id="903">Cykl życia strony (ang. page lifecycles)</h2>
-<p id="130140" class="block-content">
-Zrozumienie cyklu życia strony jest kluczowe by zrozumieć istotę programowania w PRADO.
-Cykl życia strony odwołuje się do stanów przejściowych strony, gdy jest ona dostarczana użytkownikowi końcowemu. Może on (cykl) być przedstawiony za pomocą następującej tablicy stanów:
-<img src="<%~lifecycles.gif %>" />
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/pl/Services.page b/demos/quickstart/protected/pages/Fundamentals/pl/Services.page deleted file mode 100755 index 6d8b8866..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/pl/Services.page +++ /dev/null @@ -1,34 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="1101">Serwisy (ang. services)</h1>
-<p id="150151" class="block-content">
-Serwis jest instancją klasy implementującej interfejs <tt>IService</tt>. Każdy rodzaj serwisu przetwarza specyficzny typ żądania użytkownika. Na przykład serwis strony (ang. page service) odpowiada na żądania użytkownika dla stron PRADO.
-</p>
-<p id="150152" class="block-content">
-Serwis jest jednoznacznie identyfikowany poprzez swoją właściwość <tt>ID</tt>. Domyślnie kiedy <tt>THttpRequest</tt> jest używany jako <a href="?page=Fundamentals.Modules#request">moduł żądania</a> (ang. request module), nazwy zmiennych GET są używane by zidentyfikować serwis żadany przez użytkownika. Jeśli nazwa zmiennej GET zgadza się z jakimś <tt>ID</tt> serwisu, żądanie jest przetwarzane przez ten serwis oraz wartość parametru GET jest przekazywana jako parametr serwisu. Dla serwisu strony nazwą zmiennej GET musi być <tt>page</tt>. Na przykład następujący adres URL żadą strony <tt>Fundamentals.Services</tt>,
-<com:TTextHighlighter Language="none" CssClass="source block-content" id="code_150069">
-http://hostname/index.php?page=Fundamentals.Services
-</com:TTextHighlighter>
-</p>
-<p id="150153" class="block-content">
-Deweloper może zaimplementować dodatkowe serwisy dla swojej aplikacji. Aby uczynić serwis dostępnym należy go skonfigurować w <a href="?page=Configurations.AppConfig">konfiguracji aplikacji</a>.
-</p>
-
-<h2 id="1102">Serwis strony (ang. page service)</h2>
-<p id="150154" class="block-content">
-PRADO implementuje <tt>TPageService</tt> by przetwarzać żądania stron użytkonika. Strony są przechowywane w katalogu określonej przez właściwość <tt>BasePath</tt> serwisu strony. Właściwość wskazuje domyślnie na katalog <tt>pages</tt> w ścieżce aplikacji. Możesz zmienić tą wartość domyślną poprzez skonfigurowanie serwisu w konfiguracji aplikacji.
-</p>
-<p id="150155" class="block-content">
-Strony mogą być zorganizowane w podkatalogi w <tt>BasePath</tt>. W każdym katalogu może znajdować się plik konfiguracji strony o nazwie <tt>config.xml</tt>, który zawiera konfigurację aktywną tylko wtedy gdy strona spod tego katalogu lub podkatalogu jest żądana. Aby dowiedzieć się wiecej zobacz sekcję <a href="?page=Configurations.PageConfig">konfiguracja strony</a>.
-</p>
-<p id="150156" class="block-content">
-Parametr dla serwisu stron wskazuje na żądaną stronę. Parametr taki jak <tt>Fundamentals.Services</tt> wskazuje na stronę <tt>Services</tt> w katalogu <tt><BasePath>/Fundamentals</tt>. Jeśli taki parametr nie jest obecny w żądaniu domyślnie przyjmowana jest jego wartość jako <tt>Home</tt>. Używając <tt>THttpRequest</tt> jako moduł żądania (domyślnie), następujący adres URL zażada stron <tt>Home</tt>, <tt>About</tt> i <tt>Register</tt> odpowiednio dla:
-<com:TTextHighlighter Language="none" CssClass="source block-content" id="code_150070">
-http://hostname/index.php
-http://hostname/index.php?page=About
-http://hostname/index.php?page=Users.Register
-</com:TTextHighlighter>
-gdzie pierwszy przukład wynika z faktu, że serwis strony jest domyślnym serwisem a strona <tt>Home</tt> jest stroną domyślną.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Fundamentals/pl/applifecycles.gif b/demos/quickstart/protected/pages/Fundamentals/pl/applifecycles.gif Binary files differdeleted file mode 100755 index caf16028..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/pl/applifecycles.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/pl/classtree.gif b/demos/quickstart/protected/pages/Fundamentals/pl/classtree.gif Binary files differdeleted file mode 100755 index b1fbf0d6..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/pl/classtree.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/pl/directory.gif b/demos/quickstart/protected/pages/Fundamentals/pl/directory.gif Binary files differdeleted file mode 100755 index c7d5086d..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/pl/directory.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/pl/lifecycles.gif b/demos/quickstart/protected/pages/Fundamentals/pl/lifecycles.gif Binary files differdeleted file mode 100755 index 5edaff5f..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/pl/lifecycles.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/Fundamentals/pl/objectdiagram.gif b/demos/quickstart/protected/pages/Fundamentals/pl/objectdiagram.gif Binary files differdeleted file mode 100755 index 7910469c..00000000 --- a/demos/quickstart/protected/pages/Fundamentals/pl/objectdiagram.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/GettingStarted/CommandLine.page b/demos/quickstart/protected/pages/GettingStarted/CommandLine.page index 3619d3d9..9e919212 100644 --- a/demos/quickstart/protected/pages/GettingStarted/CommandLine.page +++ b/demos/quickstart/protected/pages/GettingStarted/CommandLine.page @@ -110,22 +110,22 @@ PostRecord#1 </com:TTextHighlighter>
</p>
-<h2>Creating Active Record Classes</h2>
-<p>
+<h2 id="18007">Creating Active Record Classes</h2>
+<p id="90001" class="block-content">
In the blog demo project, we need to create two <a href="?page=Database.ActiveRecord">Active Record</a> classes, <tt>UserRecord</tt> and <tt>PostRecord</tt>, to represent data records in the <tt>users</tt> and <tt>posts</tt> tables, respectively. Active Record classes must extend from the base class <tt>ActiveRecord</tt>, and must define property names that matches with the field names of the corresponding table.
</p>
-<p>
+<p id="90002" class="block-content">
To better organize our directories, we create a new directory <tt>protected/database</tt> to hold the class files. We also modify our application configuration by inserting the following lines. It is equivalent to adding the directory <tt>protected/database</tt> to PHP include_path, which allows us to use the classes without explicitly including them.
</p>
-<com:TTextHighlighter CssClass="source" Language="xml">
+<com:TTextHighlighter CssClass="source block-content" id="code_90016" Language="xml">
<paths>
<using namespace="Application.database.*" />
</paths>
</com:TTextHighlighter>
-<p>
+<p id="90003" class="block-content">
At the prompt, enter the following two commands to create <tt>UserRecord</tt> and <tt>PostRecord</tt> classes:
</p>
@@ -135,7 +135,7 @@ At the prompt, enter the following two commands to create <tt>UserRecord</tt> an >> generate posts Application.database.PostRecord
</com:TTextHighlighter>
-<p>
+<p id="90004" class="block-content">
Here we used the <a href="?page=Fundamentals.Components1">namespace format</a> again to specify the classes to be created. The path <tt>Application.database.UserRecord</tt> indicates that we want the <tt>UserRecord</tt> class file to be <tt>protected/database/UserRecord.php</tt>.
</p>
diff --git a/demos/quickstart/protected/pages/GettingStarted/HelloWorld.page b/demos/quickstart/protected/pages/GettingStarted/HelloWorld.page index d65cf7f8..285be3b4 100755 --- a/demos/quickstart/protected/pages/GettingStarted/HelloWorld.page +++ b/demos/quickstart/protected/pages/GettingStarted/HelloWorld.page @@ -77,7 +77,7 @@ class Home extends TPage The application is now ready and can be accessed via: <tt>http://Web-server-address/helloworld/index.php</tt>, assuming <tt>helloworld</tt> is directly under the Web <tt>DocumentRoot</tt>. Try to change <tt>TButton</tt> in <tt>Home.page</tt> to <tt>TLinkButton</tt> and see what happens.
</p>
<p id="50042">
-Complete source code of this demo can be found in the PRADO release. You can also try the <a href="http://www.pradosoft.com/demos/helloworld/">online demo</a>.
+Complete source code of this demo can be found in the PRADO release. You can also try the <a href="http://www.pradoframework.net/site/demos/helloworld/">online demo</a>.
</p>
</div>
diff --git a/demos/quickstart/protected/pages/GettingStarted/Installation.page b/demos/quickstart/protected/pages/GettingStarted/Installation.page index 956f53c2..5280d25b 100755 --- a/demos/quickstart/protected/pages/GettingStarted/Installation.page +++ b/demos/quickstart/protected/pages/GettingStarted/Installation.page @@ -13,9 +13,9 @@ The minimum requirement by PRADO is that the Web server support PHP 5.3.3. PRADO PRADO can be installed as a standalone package or using <a href="http://getcomposer.org/">composer</a>
</p>
<div id="install-steps" class="block-content">
-<h3>Standalone package</h3>
+<h3 id="6001">Standalone package</h3>
<ol>
-<li>Go to <a href="http://www.pradosoft.com/download/">pradosoft.com</a> to grab the latest version of PRADO.</li>
+<li>Go to the <a href="https://github.com/pradosoft/prado">Prado framework project page</a> to grab the latest version of PRADO.</li>
<li>Unpack the PRADO release file to a Web-accessible directory.
</ol>
</div>
@@ -28,7 +28,7 @@ If you encounter any problems with the demo applications, please use the PRADO r </p>
<div id="install-steps" class="block-content">
-<h3>Composer install</h3>
+<h3 id="6002">Composer install</h3>
<ol>
<li>If you don't have installed composer already, install it globally:
<com:TTextHighlighter CssClass="source block-content">
diff --git a/demos/quickstart/protected/pages/GettingStarted/Introduction.page b/demos/quickstart/protected/pages/GettingStarted/Introduction.page index 522e385c..2056b5e1 100755 --- a/demos/quickstart/protected/pages/GettingStarted/Introduction.page +++ b/demos/quickstart/protected/pages/GettingStarted/Introduction.page @@ -52,11 +52,7 @@ You may refer to the following resources if you find this tutorial does not fulf </p>
</div>
<ul class="block-content" id="intro-links">
- <li><a href="http://www.pradosoft.com/docs/classdoc/">PRADO Classes</a></li>
- <li><a href="http://www.pradosoft.com/docs/manual/">PRADO API Documentation</a></li>
- <li><a href="http://www.pradosoft.com/forum/">PRADO Forum</a></li>
- <li><a href="http://www.pradosoft.com/wiki/">PRADO Wiki</a></li>
+ <li><a href="http://pradosoft.github.io/docs/manual/">PRADO API Documentation</a></li>
<li><a href="http://github.com/pradosoft/prado/issues">PRADO Issue Tracker</a></li>
</ul>
-
</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/Upgrading32.page b/demos/quickstart/protected/pages/GettingStarted/Upgrading32.page index e2378ed5..7e630488 100644 --- a/demos/quickstart/protected/pages/GettingStarted/Upgrading32.page +++ b/demos/quickstart/protected/pages/GettingStarted/Upgrading32.page @@ -1,6 +1,6 @@ <com:TContent ID="body" > -<h1>Upgrading from v3.2</h1> +<h1 id="12003">Upgrading from v3.2</h1> <div class="block-content"> <p class="block-content"> @@ -17,7 +17,7 @@ We summarize in the following the most significant changes in v3.3 to help devel </p> </div> -<h2>Basic Prototype to jQuery javascript porting</h2> +<h2 id="12004">Basic Prototype to jQuery javascript porting</h2> <p class="block-content"> The number one rule on writing jQuery javascript code is to read the <a href="http://api.jquery.com/">jQuery documentation</a>. Porting code from Prototype to jQuery needs some effort: here's a basic lookup table to port existing code: </p> @@ -168,7 +168,7 @@ The number one rule on writing jQuery javascript code is to read the <a href="ht </tr> </table> -<h2>PRADO specific code changes</h2> +<h2 id="12005">PRADO specific code changes</h2> <p class="block-content"> PRADO Porting prado to jQuery some method signatures has changed, or have been adapted: @@ -207,7 +207,7 @@ Porting prado to jQuery some method signatures has changed, or have been adapted </tr> </table> -<h2>Specific controls changes</h2> +<h2 id="12006">Specific controls changes</h2> <p class="block-content"> Some Prado controls were based on specific extensions of the Prototype + Scriptaculous javascript framework, and they have been deprecated now that jQuery has become the primary js framework in PRADO. PRADO 3.3 introduces jQuery-based counterpart for these controls and encourage everyone to port their code to the new controls, but the old controls are still supposed to work with some minor annoyance: diff --git a/demos/quickstart/protected/pages/GettingStarted/Wsat.page b/demos/quickstart/protected/pages/GettingStarted/Wsat.page index 3d07e6f2..a76ca163 100644 --- a/demos/quickstart/protected/pages/GettingStarted/Wsat.page +++ b/demos/quickstart/protected/pages/GettingStarted/Wsat.page @@ -1,5 +1,5 @@ <com:TContent ID="body"> - <h1>Web Site Administration Tool</h1> + <h1 id="20008">Web Site Administration Tool</h1> <p class="block-content"> Web Site Administration Tool (WSAT) is a development tool which allows you to perform several tedious tasks of a PRADO project in a GUI fashion. Its inspired in both Asp.Net - Web Site Administration Tool and Yii's Gii. @@ -12,12 +12,12 @@ </ul> </p> - <h2>Requirements</h2> + <h2 id="20009">Requirements</h2> <p class="block-content"> To use WSAT, you need to add in your project configuration file: <tt>application.xml</tt>, in the services section the wsat service like follows: -<com:TTextHighlighter CssClass="source" Language="xml"> +<com:TTextHighlighter CssClass="source block-content" id="code_100018" Language="xml"> <services> ... <service id="wsat" class="System.Wsat.TWsatService" Password="my_secret_password" /> @@ -25,7 +25,7 @@ </com:TTextHighlighter> </p> - <h2>Usage</h2> + <h2 id="20010">Usage</h2> <p class="block-content"> Then you are ready to go to: http://localhost/yoursite/index.php?wsat=TWsatLogin and doing so you should see the following page: @@ -36,7 +36,7 @@ is part of a basic security system to avoid undesirable persons to use this tool. </p> - <h2>Active Record classes generation</h2> + <h2 id="20011">Active Record classes generation</h2> <p class="block-content"> In order to generate AR classes you need to go to: http://localhost/divermania/index.php?wsat=TWsatGenerateAR by clicking the proper links in the welcome page. Then you should see the following page: diff --git a/demos/quickstart/protected/pages/GettingStarted/de/Introduction.page b/demos/quickstart/protected/pages/GettingStarted/de/Introduction.page deleted file mode 100755 index 0c6b4ee6..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/de/Introduction.page +++ /dev/null @@ -1,62 +0,0 @@ -<com:TContent ID="body" > -<h1 id="101">Willkommen zum PRADO Quickstart Tutorial</h1> -<div id="intro" class="block-content"> -<p id="10001"> -Das Quicktstart tutorial soll Sie bei der Erstellung einer PRADO 3.x-basierten Webanwendung unterstützen. -</p> -<p id="10001" class="block-content"> -Wenn Sie bereits PRADO 3.x nutzen und herausfinden möchten welche Verbesserungen und neuen Funktionen mit welcher Prado-Version unterstützt werden, besuchen sie die <a href="?page=GettingStarted.NewFeatures">Neue Features-Seite</a>. -</p> -<!-- -<div class="start-page"> - <div class="concepts start-block"> - <h2 id="2001">How PRADO Works</h2> - <p id="10002" class="block-content">Concepts and fundamentals</p> - <ol> - <li><a href="#">Building web applications with PRADO</a></li> - <li><a href="#">Web controls and events</a></li> - <li><a href="#">Validating user input</a></li> - <li><a href="#">Connecting to your database</a></li> - <li><a href="#">Displaying data from database</a></li> - </ol> - </div> - <div class="examples start-block"> - <h2 id="2002">Examples and Demos</h2> - <ul> - <li><a href="../helloworld/">Hello World</a></li> - <li><a href="../currency-convert/">Currency Converter</a></li> - <li><a href="../address-book/">Address Book</a></li> - <li><a href="../blog/">Blog</a></li> - <li><a href="../chat/">AJAX Chat</a></li> - <li><a href="../time-tracker/">Project Time Tracker</a></li> - </ul> - <p id="10003" class="block-content">More examples in <a href="?page=Controls.Standard">Standard Controls</a>, - <a href="?page=Controls.Validation">Validation Controls</a> and - <a href="?page=Controls.Data">Data Controls</a>. - </div> - - <div class="tutorials start-block"> - <h2 id="2003">Tutorials and Help</h2> - <ul> - <li><a href="?page=GettingStarted.HelloWorld">Hello World in detail</a></li> - <li><a href="?page=Tutorial.CurrencyConverter">Currency Converter Tutorial</a></li> - <li><a href="?page=Tutorial.AddressBook">Address Book Tutorial</a></li> - <li><a href="?page=Tutorial.AjaxChat">AJAX Chat Tutorial</a></li> - </ul> - </div> -</div> ---> - -<p id="10002"> -Nutzen Sie auch die folgenden Ressourcen, wenn dieses Tutorial ihre Fragen nicht hinreichend beantwortet: -</p> -</div> -<ul class="block-content" id="intro-links"> - <li><a href="http://www.pradosoft.com/docs/classdoc/">PRADO Classes</a></li> - <li><a href="http://www.pradosoft.com/docs/manual/">PRADO API Documentation</a></li> - <li><a href="http://www.pradosoft.com/forum/">PRADO Forum</a></li> - <li><a href="http://www.pradosoft.com/wiki/">PRADO Wiki</a></li> - <li><a href="http://github.com/pradosoft/prado/issues">PRADO Issue Tracker</a></li> -</ul> - -</com:TContent> diff --git a/demos/quickstart/protected/pages/GettingStarted/es/AboutPrado.page b/demos/quickstart/protected/pages/GettingStarted/es/AboutPrado.page deleted file mode 100755 index 1aa1d765..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/es/AboutPrado.page +++ /dev/null @@ -1,86 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="201">¿Que es PRADO?</h1>
-<p id="20003" class="block-content">
-PRADO es una capa de programación (framework) basada componentes y programación dirigida por eventos, para desarrollos de aplicaciones Web en PHP 5. Las siglas PRADO significan en español Desarrollo Rapido de Aplicaciones con Programación Orientada a Objetos en PHP (<b>P</b>HP <b>R</b>apid <b>A</b>pplication <b>D</b>evelopment <b>O</b>bject-oriented).
-</p>
-<p id="20004" class="block-content">
-El principal objetivo de PRADO es utilizar al máximo la reutilización en la programación Web. Por reusabilidad, queremos decir no solamente reutilizar el código propio, si no el de otros programadores de una manera fácil. Lo último dicho es más importante, ya que evita el esfuerzo de reinventar nuevamente la rueda y además posibilita disminuir notablemente los tiempos de desarrollos. La introducción al concepto de componentes tiene este propósito.
-</p>
-<p id="20005" class="block-content">
-Para alcanzar el propósito mencionado, PRADO estipula un protocolo para escribir y usar componentes para construir una aplicación Web. Un componente es una pieza de programa que es autocontenido (self-contained) y puede ser reutilizado con una mínima personalización del mismo. Nuevos componentes pueden ser creados por una simple composición de componentes existentes.
-</p>
-<p id="20006" class="block-content">
-Para facilitar la interacción con componentes, PRADO implementa el paradigma de la programación dirigida por eventos (event-driven) que permite la delegación de comportamientos extensibles a los componentes.
-Las actividades de los usuarios finales, tales como hacer clic en un botón de un formulario, son capturados como eventos en el lado del servidor (server events).
-Metodos o funciones deben ser enlazadas a dichos eventos de tal manera que cuando los eventos sucedan, estos son invocados automáticamente para responder a dicho evento. Comparado con la programación Web tradicional en la cual los desarrolladores tienen que tratar directamente (raw) con las variables de arreglo POST y GET, la programación dirigida por eventos ayuda a los desarrolladores enfocarse mejor en las necesidades lógicas y reducir significativamente el código de bajo nivel repetitivo (low-level repetitive coding).
-</p>
-<p id="20007" class="block-content">
-En resumen, desarrollar aplicaciones Web con PRADO principalmente involucra instantáneamente tipos de componentes predesarrollados, configurarlos mediante sus propiedades, responder a sus eventos escribiendo funciones manipuladoras de los mismos , y agrupándolos (composing them) dentro de paginas para la aplicación. Es muy similar al Kit de herramientas RAD de Borland Delphi y Microsoft Visual Basic, que son utilizadas para desarrollar aplicaciones (Interfaces Graficas de Usuarios, GUI) de escritorio.
-</p>
-
-<h2 id="202">¿Proque PRADO?</h2>
-<p id="20008" class="block-content">
-PRADO es comúnmente citado como una plataforma de programación (framework) única. En realidad es tan único que puede convertir una tediosa y aburrida tarea de programación en PHP en una tarea divertida (fun task). La siguiente lista es un pequeño resumen de las características principales de PRADO,
-</p>
-<ul id="prado-features" class="block-content">
-<li>
-Reutilización - Los codigos que se rigen por el protocolo basado en componentes de PRADO son altamente reutilizables. Esto beneficia a los equipos de desarrollo a largo plazo, ya que pueden reutilizar sus trabajos anteriores e integrar otras partes de trabajo con facilidad.</li>
-<li>
-Programación dirigida por eventos - Las actividades del usuario final, tales como como hacer clic en un botón de enviar, son capturadas como eventos del servidor permitiendo que los desarrolladores tengan un mejor enfoque en interacciones del usuario.</li>
-<li>Integración de equipo - La capa de presentacion y la capa logica son almacenados por separado. Las aplicaciones en PRADO pueden ser armadas por temas (themable).</li>
-<li>
-Controles webs Potentes - PRADO viene con un conjunto de poderosos componentes que se ocupan de interfaces de usuario Web. Altamente interactivo de páginas web se puede crear con unas pocas líneas de código. Por ejemplo, utilizando el componente DataGrid, se puede crear rápidamente una página que presenta una tabla de datos que permite la paginación, la clasificación, editar y eliminar filas de los datos.
-<li>
-Fuerte soporte de bases de datos - Desde la versión 3.1, PRADO ha sido equipada con total soporte de bases de datos escrita en forma nativa y, por tanto, encaja con el resto del framework PRADO. De acuerdo a la complejidad de los objetos de negocio, se puede optar por utilizar la PDO simple, basada en el acceso a los datos, o el apmpliamente conocido Active Record, o el mapa completo de los objetos del negocio SqlMap.</li>
-<li>
-Soporte de AJAX sin fisuras - Uso de AJAX en PRADO nunca ha sido más fácil con su innovador Controles Activos (Active Controls) introducidos desde la versión 3.1. Puede escribir una aplicación AJAX sin escribir una sola línea de código javascript. De hecho, que la utilización de los Controles Activos, no es muy diferente a la utilizacion de componentes no-AJAX.</li>
-<li>
-Soporte de I18N y L10N - PRADO incluye soporte completo para crear aplicaciones con múltiples idiomas y la localización.</li>
-<li>
-Compatibilidad (compliance) XHTML - Las páginas Web generadas por PRADO son compatibles con XHTML.</li>
-<li>
-Albergar trabajos ya existentes - PRADO es un framework genérico, con especial atención a la capa de presentación. No excluye a desarrolladores que hacen uso de la mayoría de las actuales bibliotecas de clase o juegos (kits) de herramientas. Por ejemplo, uno puede usar ADOdb o Creole para tratar con base de datos en su aplicación PRADO.
-<li>
-Otras características - Potente manipulación de errores /excepciones y registro de mensjes (message logging); cahe genérico y memoria caché de salida selectiva; manejo de errores personalizable y localizable; extensible autentificación y autorización; prevención de medidas de seguridad tales como cross-site script (XSS) , protección de cookies, etc.
-</li>
-</ul>
-
-<h2 id="203">¿Qué es adecuado para utilizar PRADO </h2>
-<p id="20009" class="block-content">
-PRADO es mejor adecuado para la creación de aplicaciones Web que tienen alta interactividdad con usuarios (user-interactive). Se puede utilizar para desarrollar sistemas tan simple como un blog o para aquellos sistema tan complejo como un sistema de gestión de contenidos (CMS) o una completa solución de comercio electrónico. PRADO promueve la programación orientada a objetos a través de su metodología basada en componente , se ajusta muy bien para el trabajo en equipo y el desarrollo empresarial.
-</p>
-<p id="20011" class="block-content">
-PRADO viene con un conjunto completo de técnicas de caching que ayudan a acelerar las aplicaciones Web PRADO y acomodar el tráfico de alta exigencia. Su arquitectura modular permite a los desarrolladores el uso o icorporar (plug-in) diferentes módulos de caché de memoria para diferentes necesidades. La salida de caché permite elegir selectivamente el caché de las paginas webs generadas.
-</p>
-
-<h2 id="204">
-¿Cómo se PRADO en comparación con otros Frameworks?
-</h2>
-<p id="20012" class="block-content">
-PRADO es a menudo citado como un framework único. Su singularidad radica principalmente en el paradigma de la programacion basada en componentes (component-based) y dirigida a eventos (event-driven) que pretende promover. Aunque este paradigma de programación no es nuevo en programación de aplicaciones de escritorio y no en una nueva web de algunos lenguajes de programación, PRADO es quizás el primer framework PHP que lo lleva a cabo.
-</p>
-<p id="20013" class="block-content">
-La mayoría de frameworks de PHP principalmente se centra en separar la presentación y la lógica y promueve el patrón de diseño MVC (modelo-vista-controlador) . PRADO logra el mismo objetivo, naturalmente, al exigir que la lógica se almacena en las clases y la presentación en las plantillas. PRADO hace mucho más en otros aspectos distintos de MVC. Se llena de mucho espacio en blanco en la programación web en PHP, con su paradigma de programacion basada en componentes, la riqueza de su conjunto de controles Web, sus potente soporte de bases de datos, su flexible manejo de errores y registro de mensajes, y muchos otros.
-</p>
-
-<h2 id="4004">
-¿Es PRADO lo suficientemente estable?
-</h2>
-<p id="20004" class="block-content">
-Sí. PRADO inicialmente fue liberado en agosto de 2004. Muchas series de ensayos se han escrito y realizado con frecuencia para asegurar su calidad. Se ha utilizado por miles de desarrolladores y muchas aplicaciones Web se han desarrollado sobre la base de la misma. Bugs y peticiones se gestionan a través del sistema TRAC y tenemos una gran comunidad de usuarios y el equipo de desarrollo para asegurar que todas las preguntas se respondan en forma oportuna.
-</p>
-
-<h2 id="205">Historia de PRADO</h2>
-<p id="20014" class="block-content">
-La propia inspiración original de PRADO vino de Apache Tapestry. Durante el diseño y la ejecución, me tome prestadas muchas ideas de Borland Delphi y Microsoft ASP.NET. La primera versión de PRADO salió en junio de 2004 y fue escrita en PHP 4. Impulsado por el concurso de codificación de Zend PHP 5 , re-escrbí PRADO en PHP 5, que resultó ser una sabia decisión, gracias al nuevo modelo de objetos proporcionados por PHP 5. PRADO ganó el gran premio en el concurso Zend, ganando el más alto de votos del público y los jueces del panel.
-</p>
-<p id="20015" class="block-content">
-En agosto de 2004, PRADO comenzó a ser alojado en SourceForge como un proyecto de código abierto. Poco después, el sitio del proyecto <a href="http://www.xisc.com/"> xisc.com </a> se anunció para el orden público. Con el fantástico apoyo del equipo de desarrolladores PRADO y usuarios PRADO, PRADO evolucionado a la versión 2,0 a mediados de 2005. En esta versión, Wei Zhuo contribuyó en PRADO con el excelente I18N y L10N apoyo.
-</p>
-<p id="20016" class="block-content">
-En mayo de 2005, se decidió re-escribir por completo el framework PRADO para resolver algunas cuestiones fundamentales que se encuentran en la versión 2.0 y para ponerse al día con algunas geniales características disponibles en Microsoft ASP.NET 2.0. Después de casi un año de arduo trabajo con más de 50.000 líneas de nuevo código, la versión 3.0 fue finalmente puesta a disposición en abril de 2006.
-</p>
-<p id="20017" class="block-content">
-A partir de la versión 3.0, importantes esfuerzos se asignan a asegurar la calidad y la estabilidad de PRADO. Si decimos PRADO v2.x y v1.x son prueba de concepto de trabajo, podemos decir PRADO 3.x ha crecido a un proyecto que es adecuado para un negocio serio el desarrollo de aplicaciones.
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/es/Installation.page b/demos/quickstart/protected/pages/GettingStarted/es/Installation.page deleted file mode 100755 index 973415fa..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/es/Installation.page +++ /dev/null @@ -1,29 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="301">Installing PRADO</h1>
-<div id="install-info" class="block-content">
-<p id="30018">
-Su usted esta viendo esta pagina desde su explorador Web, usted ha ya realizado la instalación.
-</p>
-<p id="30019">
-Los requerimientos minimos por PRADO, son que el servidor Web soporte PHP version 5. PRADO ha sido probado con el servidor Web Apache en las plataformas Windows y Linux. Existen muchas probabilidades de que tambien pueda correr en otras plataformas con otros servidores Webs siempre y cuando estos soporten PHP 5.
-</p>
-</div>
-
-<div id="install-steps" class="block-content">
-<p id="30020">
-La instalacion de PRADO, consiste principalmente en descargarlo y descomprimirlo.
-</p>
-<ol>
-<li>Ingrese en <a href="http://www.pradosoft.com/">pradosoft.com</a> para obtener la ultima version de PRADO.</li>
-<li>Descomprima el archivo de la ultima publicacion de PRADO en una carpeta o directorio accesible via Web (Web-accessible).
-</ol>
-</div>
-<div id="install-after" class="block-content">
-<p id="30021">
-Su instalacion de PRADO esta lista y usted puede comenzar a probarlo con las aplicaciones de demostraciones incluidas en la pulicacion de prado a travez de la URL <tt>http://web-server-address/prado/demos/</tt>. Aqui asumimos que PRADO esta descomprimido en la subcarpeta <tt>prado</tt> que se ecnuentra debajo de <tt>DocumentRoot</tt> del servidor Web.
-</p>
-<p id="30022">
-Si encuentra algun problema con las aplicaciones demostrativa de PRADO, utilice por favor el script de chequeo de requerimientos que viene con PRADO , accesible desde <tt>http://web-server-address/prado/requirements/index.php</tt>, para comprobar primeramente si la configuracion de su server cumple con las condiciones requeridas por PRADO.
-</p>
-</div>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/es/Introduction.page b/demos/quickstart/protected/pages/GettingStarted/es/Introduction.page deleted file mode 100755 index 324843ea..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/es/Introduction.page +++ /dev/null @@ -1,60 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="101">Bienvenido al Tutorial rápido de PRADO</h1>
-<div id="intro" class="block-content">
-<p id="10001">Este tutorial rápido se presta a ayudarle rápidamente a empezar a construir tu propia web aplicaciones basadas en PRADO versión 3.x.
-</p>
-<p id="10001" class="block-content">Si ya es usuario PRADO 3.x y me gustaría saber qué mejoras están disponibles para cada nueva versión, por favor, consulte las <a href="?page=GettingStarted.NewFeatures"> nuevas características </a>. De lo contrario, las siguientes secciones son útiles para novatos.
-</p>
-
-<div class="start-page">
- <div class="concepts start-block">
- <h2 id="2001">¿Cómo funciona PRADO?</h2>
- <p id="10002" class="block-content">Conceptos y fundamentos</p>
- <ol>
- <li><a href="#">Creación de aplicaciones web con PRADO</a></li>
- <li><a href="#">Controles Web y eventos</a></li>
- <li><a href="#">Validación de entrada de usuario</a></li>
- <li><a href="#">Conexión a bases de datos</a></li>
- <li><a href="#">Viendo los datos de la base de datos</a></li>
- </ol>
- </div>
- <div class="examples start-block">
- <h2 id="2002">Examples and Demos</h2>
- <ul>
- <li><a href="../helloworld/">Hello World (Hola Mundo)</a></li>
- <li><a href="../currency-convert/">Currency Converter (Conversor de monedas)</a></li>
- <li><a href="../address-book/">Address Book (Libreta de direcciones)</a></li>
- <li><a href="../blog/">Blog</a></li>
- <li><a href="../chat/">AJAX Chat (Chat en AJAX)</a></li>
- <li><a href="../time-tracker/">Project Time Tracker (Seguimiento de tiempos de un proyecto)</a></li>
- </ul>
- <p id="10003" class="block-content">Más ejemplos en <a href="?page=Controls.Standard">Controles Estándard</a>,
- <a href="?page=Controls.Validation">Controles de validación</a> and
- <a href="?page=Controls.Data">Controles de Datos</a>.
- </div>
-
- <div class="tutorials start-block">
- <h2 id="2003">Tutorials and Help</h2>
- <ul>
- <li><a href="?page=GettingStarted.HelloWorld">Hello World en detalles</a></li>
- <li><a href="?page=Tutorial.CurrencyConverter">Tutorial de Currency Converter</a></li>
- <li><a href="?page=Tutorial.AddressBook">Tutorial de Address Book Tutorial</a></li>
- <li><a href="?page=Tutorial.AjaxChat">Tutorial de AJAX Chat Tutorial</a></li>
- </ul>
- </div>
-</div>
-<p> </p>
-
-<p id="10002">
-Usted podrá hacer referencia a los siguientes recursos si usted encuentra que este tutorial no cumple con todas sus necesidades.
-</p>
-</div>
-<ul class="block-content" id="intro-links">
- <li><a href="http://www.pradosoft.com/docs/classdoc/">Classes PRADO </a></li>
- <li><a href="http://www.pradosoft.com/docs/manual/">Documentación API PRADO </a></li>
- <li><a href="http://www.pradosoft.com/forum/">Foro PRADO</a></li>
- <li><a href="http://www.pradosoft.com/wiki/">Wiki PRADO</a></li>
- <li><a href="http://trac.pradosoft.com/prado/">Trac PRADO</a></li>
-</ul>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/AboutPrado.page b/demos/quickstart/protected/pages/GettingStarted/fr/AboutPrado.page deleted file mode 100755 index 25bb0bc7..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/fr/AboutPrado.page +++ /dev/null @@ -1,71 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="201">Qu'est-ce que PRADO ?</h1>
-<p id="20003" class="block-content">
-PRADO est un framework de programmation évènementielle basé sur des composants pour développer des applications Web en PHP5. PRADO signifie <b>P</b>HP <b>R</b>apid <b>A</b>pplication <b>D</b>evelopment <b>O</b>bject-oriented.
-</p>
-<p id="20004" class="block-content">
-Le but principal de PRADO est la réutilisation maximale de code dans la programmation Web. Par réutilisation, cela ne se limite pas à son propre code mais aussi celui d'autres développeurs, de manière la plus aisée possible. Cela est très important car cela évite de réinventer la roue et peut donc réduire de façon significative le temps de développement. L'introduction du concept de composant provient de cela.
-</p>
-<p id="20005" class="block-content">
-Afin de parvenir au but ci-dessus, PRADO stipule un protocole d'écriture et d'utilisation des composants afin de construire des applications Web. Un composant est une brique logicielle qui peut être réutilisée avec quelques modifications. De nouveaux composants peuvent ainsi être construits en utilisant des composants existants.
-</p>
-<p id="20006" class="block-content">
-Afin de faciliter l'intéraction avec les composants, PRADO implémente une programmation évènementielle qui permet la délégation des comportements aux composants. Les actions des utilisateurs comme le click sur un bouton de type submit sont capturées comme des évènements serveurs. Des méthodes ou fonctions peuvent être attachées à ces évènements et lorsque l'évènement se produit, elles sont automatiquement invoquées afin de répondre à ces même évènements. Comparé à la traditionnelle programmation Web où les développeurs doivent utiliser les variables POST ou GET, la programmation évènementielle aide les développeurs à se consacrer à la logique et réduit de façon significative le code répétitif.
-</p>
-<p id="20007" class="block-content">
-Développer une application Web avec PRADO se résume à instancier des composants existants, les configurer en définissant leurs propriétés, leur affecter des fonctions répondants à ces mêmes évènements, et ainsi composer les pages de l'application. Cela est très similaire aux développants à l'aide de RAD, comme Borland Delphi et Microsoft Visual Basic, qui sont utilisés pour développer des applications GUI.
-</p>
-
-<h2 id="202">Pourquoi PRADO ?</h2>
-<p id="20008" class="block-content">
-PRADO est le plus souvent cité comme un framework unique. En fait, il est tellement unique qu'il peut changer votre programmation PHP en une tâche amusante. La liste suivante est un rapide résumé des principales fonctionnalités de PRADO,
-</p>
-<ul id="prado-features" class="block-content">
-<li>Réutilisation - Le code provenant du protocole de composant PRADO est réellement réutilisable. Cela bénéficie à l'équipe de développement dans le sens où ils peuvent réutiliser leur travail précédent afin de l'intégrer dans d'autres parties de façon aisée.</li>
-<li>Programmation évènementielle - Les actions de l'utilisateur, comme un click sur un bouton de type submit, sont capturées comme évènement serveur afin que le développeur se consacre principalement à la façon de gérer ces interactions.</li>
-<li>Intégration des équipes - La logique et la présentation sont séparées. Des thèmes peuvent être appliqués aux applications PRADO.</li>
-<li>Contrôles Web puissants - PRADO possède un large éventail de composants afin de gérer les interfaces Web. Des pages Web très interactives peuvent être crées avec peu de lignes de code. Par exemple, le seul composant "datagrid" (ou grille de données) permet de créer rapidement une page présentant un tableau paginé triable qui permet l'édition et la suppression de lignes de données.
-<li>Support robuste des base de données - Depuis la version 3.1, PRADO a été doté d'un support complet des base de données qui s'intègre totalement avec les autres parties du framework. Selon la complexité des objets métiers, votre choix pourra porter vers une simple couche d'accès PDA, vers les largements connus "Active Record" ou un mapping complet des objets métiers à travers un schéma SqlMap.</li>
-<li>Support de AJAX - Utiliser AJAX dans PRADO n'a jamais été aussi facile qu'avec les innovants "active controls" introduits depuis la version 3.1. Vous pouvez facilement créer une application intégrant de l'AJAX sans écrire une seule ligne de javascript. En fait, l'utilisation des "active controls" n'est pas différente des contrôles Web standards.</li>
-<li>Support I18N et L10N - PRADO intègre un support complet afin de contruire des applications dans plusieurs langues et plusieurs locales.</li>
-
-<li>Rendu XHTML - Les pages Web générées par PRADO sont "XHTML-compliant" et ainsi conformes aux standards W3C.</li>
-<li>Intégration de l'existant - PRADO est un framework généric se focalisant sur la couche de présentation. Cela n'empêche en rien les développeurs d'utiliser la plupart des bibliothèques existantes. Par exemple, on peut utiliser AdoDB ou Creole afin de gérer l'accès données dans son application PRADO.
-<li>Autres fonctionnalités - Puissante gestion des erreurs et/ou exceptions et enregistrement des messages; Cache générique et sélectif; Gestion des erreurs customisable et localisable; Authentification et authorisation extensible; Mesures de sésurité comme prévention des cross-site script (CSS), protection des cookies, etc...</li>
-</ul>
-
-<h2 id="203">Pour quelles applications PRADO est-il adapté ?</h2>
-<p id="20009" class="block-content">
-PRADO est le plus adapté pour des applications Web très interactives. Il peut être utilisé pour développer des systèmes simples comme un blog, ou complexes comme un système de gestion de contenu (CMS), ou une solution complète de e-commerce. Puisque PRADO est basé sur une programmation orientée objet à travers sa méthodologie de composants, il convient particulièrement bien pour le travail en équipe et le développement d'entreprise.
-</p>
-<p id="20011" class="block-content">
-PRADO intègre un système de cache complet qui peut aider les applications à tenir des charges de traffic élevées. Son architecture modulaire permet aux développeurs d'utiliser des modules de cache différents pour chaque besoin. Le cache peut s'effectuer sur toute ou partie d'une page Web.
-</p>
-
-<h2 id="204">Comment est PRADO comparé à d'autres Frameworks ?</h2>
-<p id="20012" class="block-content">
-PRADO est souvent cité comme un framework unique. Sa particularité est principalement liée à la gestion des composants et à la programmation évènementielle qu'il essaie de promouvoir. Bien que ce paradigme ne soit pas nouveau dans la programmation d'application GUI, PRADO est peut-être le premier framework PHP à l'intégrer.
-</p>
-<p id="20013" class="block-content">
-La plupart des frameworks PHP se focalise principalement sur la séparation des couches de présentation et de la logique en utilisant le design pattern MVC (Model-Vue-Contrôleur). PRADO atteint le même but en imposant que la logique se situe dans des classes et la présentation dans des templates. PRADO fait beaucoup plus sur d'autres aspects que le MVC. Il comble des manque dans la programmation PHP avec son modèle de composants Web riches, son support robuste des bases de données, sa gestion d'erreur flexible et beaucoup d'autre...
-</p>
-
-<h2>PRADO est-il assez stable ?</h2>
-<p>
-Oui. Le projet PRADO a débuté en août 2004. Beaucoup de tests unitaires ont été écrits et fréquemment éxecutés afin d'assurer sa qualité. Il a été utilisé par des milliers de développeurs et beaucoup d'applications sont basés sur celui-ci. Les bugs et les demandes de fonctionnalités sont gérées à travers le système TRAC, nous avons une grande communauté d'utilisateurs et une équipe de développement afin d'assurer que toutes les questions sont répondues en un temps record.
-</p>
-
-<h2 id="205">Histoire de PRADO</h2>
-<p id="20014" class="block-content">
-L'inspiration originale de PRADO vient de Apache Tapestry. Pendant le design et l'implémentation, j'ai emprunté beaucoup d'idées de Borland Delphi et Microsoft ASP.NET. La première version de PRADO a vue le jour en juin 2004 et était écrite en PHP4. Conduit par le concours de codage de Zend, j'ai réécrit PRADO en PHP5, qui est un changement majeur grâce au nouveau modèle objet fourni par PHP5. PRADO a remporté le grand prix du concours grâce aux votes du public ainsi que du jury.
-</p>
-<p id="20015" class="block-content">
-En août 2004, PRADO a commencé à être hébergé sur SourceForge en projet Open Source. Peu après, le site du projet <a href="http://www.xisc.com/">xisc.com</a> a été annoncé au public. Grâce au fantastique support de l'équipe de développement et des utilisateurs de PRADO, PRADO a évolué en version 2.0 mi 2005. Dans cette version, Wei Zhuo a contribué à PRADO avec le support I18N et L10N.
-</p>
-<p id="20016" class="block-content">
-En mai 2005, nous avons décidé de réécrire complètement le framework PRADO afin de résoudre quelques problèmes trouvés dans la version 2.0 et ajouter des fonctionnalités disponibles dans Microsoft ASP.NET 2.0. Après près d'un an de dur labeur et 50.000 lignes de nouveau code, la version 3.0 était finalement disponible en avril 2006.
-</p>
-<p id="20017" class="block-content">
-Au démarrage de la version 3.0, des efforts significatifs ont été fournis afin d'assurer la qualité et la stabilité de PRADO. Si PRADO v2.x et v1.x sont la preuve du concept, nous pouvons affirmer que PRADO v3.x est un projet qui est désormais adapté pour le développement d'applications métiers.
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/CommandLine.page b/demos/quickstart/protected/pages/GettingStarted/fr/CommandLine.page deleted file mode 100755 index d1406928..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/fr/CommandLine.page +++ /dev/null @@ -1,94 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="501">Outil en ligne de commande</h1>
-<p id="70046" class="block-content">Le script optionnel <tt>prado-cli.php</tt> du répertoire <tt>framework</tt> est un outil en ligne de commande destiné à éxecuter certaines tâches dans PRADO.
-Le script <tt>prado-cli.php</tt> peut être utilisé pour créer le squelette de projet PRADO, des fichiers tests et accéder à un shell interactif PHP.
-</p>
-<h2 id="502">Pré-requis</h2>
-<p id="70047" class="block-content">
-Afin d'utiliser l'outil en ligne de commande, vous aurez à utiliser une console. De plus, PHP doit être capable d'éxecuter des scripts en ligne de commande.
-</p>
-
-<h2 id="503">Utilisation</h2>
-<p id="70048" class="block-content">
-Si vous tapez <tt>php chemin/vers/framework/prado-cli.php</tt>, vous devez voir les informations suivantes. Alternativement, si vous n'êtes pas sous Windows, vous pouvez essayer de transformer le fichier <tt>prado-cli.php</tt> en un éxecutable</p>
-<com:TTextHighlighter Language="cli" CssClass="source block-content" id="code_70006">
-Command line tools for Prado 3.0.5.
-usage: php prado-cli.php action <parameter> [optional]
-example: php prado-cli.php -c mysite
-
-actions:
- -c <directory>
- Creates a Prado project skeleton for the given <directory>.
-
- -t <directory>
- Create test fixtures in the given <directory>.
-
- shell [directory]
- Runs a PHP interactive interpreter. Initializes the Prado
- application in the given [directory].
-</com:TTextHighlighter>
-
-<p id="70049" class="block-content">Les <b><parameter></b> sont les paramètres requis et <b>[optional]</b>
-désignent les paramètres optionnels. </p>
-
-<h2 id="504">Créer un nouveau squelette de projet PRADO</h2>
-
-<p id="70050" class="block-content">Afin de créer un squelettre de projet PRADO, suivez les instructions suivantes :</p>
-<ol>
- <li>Placez-vous dans le dossier où vous souhaitez créer le projet.</li>
- <li>Tapez, <tt>php ../prado/framework/prado-cli.php -c helloworld</tt>, où
- <tt>helloworld</tt> est le nom du dossier où vous souhaitez créer le squelette.</li>
- <li>Tapez, <tt>php ../prado/framework/prado-cli.php <b>-t</b> helloworld</tt> afin de créer les fichiers tests du projet <tt>helloworld</tt>.</li>
-</ol>
-
-<h2 id="505">Shell interactif</h2>
-<p id="70051" class="block-content">
-Le shell interactif vous permet d'évaluer des scripts PHP directement en ligne de commande.
-Le script <tt>prado-cli.php</tt> peut être utilisé pour démarrer le shell et charger un projet PRADO existant.
-Par exemple, chargons le projet de démo blog. En supposant que votre console se situe actuellement dans le répertoire <tt>prado</tt> de la distribution, tapez :
-</p>
-<p id="70052" class="block-content">
-<com:TTextHighlighter Language="cli" CssClass="source block-content" id="code_70007">
-$: php framework/prado-cli.php shell demos/blog
-</com:TTextHighlighter>
-Le résultat doit être
-<com:TTextHighlighter Language="cli" CssClass="source block-content" id="code_70008">
-Command line tools for Prado 3.0.5.
-** Loaded Prado application in directory "demos\blog\protected".
-PHP-Shell - Version 0.3.1
-(c) 2006, Jan Kneschke <jan@kneschke.de>
-
->> use '?' to open the inline help
-
->>
-</com:TTextHighlighter>
-Ensuite, nous allons appeler une instance de l'application du blog PRADO, et de cette instance nous allons créer une instance du module<tt>'data'</tt>. Notez qu'un <b>point-virgule</b> à la fin de la ligne <b>n'affiche pas la sortie</b>.
-
-<com:TTextHighlighter Language="cli" CssClass="source block-content" id="code_70009">
->> $app = Prado::getApplication();
-
->> $db = $app->getModule('data');
-</com:TTextHighlighter>
-Pour finir, nous voulons utiliser le module 'data' pour récupérer le post ayant l'<tt>ID=1</tt>. Notez que nous <b>n'avons pas mis de point-virgule</b> afin de voir le résultat de la commande.
-<com:TTextHighlighter Language="cli" CssClass="source block-content" id="code_70010">
->> $db->queryPostByID(1)
-</com:TTextHighlighter>
-Aucune erreur ne doit se produire et vous devez dorénavant voir :
-<com:TTextHighlighter Language="cli" CssClass="source block-content" id="code_70011">
-PostRecord#1
-(
- [ID] => 1
- [AuthorID] => 1
- [AuthorName] => 'Prado User'
- [CreateTime] => 1148819691
- [ModifyTime] => 0
- [Title] => 'Welcome to Prado Weblog'
- [Content] => 'Congratulations! You have successfully installed Prado Blog --
- a PRADO-driven weblog system. A default administrator account has been created.
- Please login with <b>admin/prado</b> and update your password as soon as possible.'
- [Status] => 0
- [CommentCount] => 0
-)
-</com:TTextHighlighter>
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/HelloWorld.page b/demos/quickstart/protected/pages/GettingStarted/fr/HelloWorld.page deleted file mode 100755 index 1e0f5574..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/fr/HelloWorld.page +++ /dev/null @@ -1,83 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="401">Ma première application PRADO</h1>
-<div id="hello1" class="block-content">
-<p id="50034">
-Dans cette partie, nous allons vous guider afin de créer votre première application PRADO, la fameuse application "Hello World".
-</p>
-<p id="50035">
-"Hello World" est peut-être l'application PRADO la plus simple et <i>interactive</i> que vous pouvez créer. Cela affiche une page avec un bouton où il est affiché <tt>Click Me</tt>. Lorsque l'utilisateur clicke sur la bouton, il est affiché <tt>Hello World</tt>.
-</p>
-<p id="50036">
-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 <tt>onclick</tt>.
-</p>
-</div>
-<p id="50037" class="block-content">
-PRADO privilégie une programmation évènementielle basée sur des composants. Le bouton est représenté par un objet <tt>TButton</tt>. Celui-ci comprend le libellé du bouton en tant que propriété <tt>Text</tt> et associe l'évènement "click" avec un évènement serveur <tt>OnClick</tt>. Afin de répondre à l'action de l'utilisateur sur le click du bouton, il suffit simplement d'attacher une fonction à l'évènement <tt>OnClick</tt> du bouton. Dans cette fonction, la propriété <tt>Text</tt> est modifiée en "Hello World". Le diagramme suivant image la séquence ci-dessus :
-<img src="<%~sequence.gif%>" class="figure"/>
-</p>
-<p id="50038" class="block-content">
-Notre application PRADO sera composée de trois fichiers, <tt>index.php</tt>, <tt>Home.page</tt> et <tt>Home.php</tt>, qui sont organisés de la façon suivante :
-<img src="<%~directory.gif%>" class="figure"/>
-
-où chaque répertoire est expliqué comme suit. Notez que la structure des répertoire peut être personnalisée. Par example, le dossier <tt>protected</tt> peut se trouver hors du répertoire Web public. Vous saurez comment faire à la suite de ce tutorial.
-</p>
-<ul id="dir-struct" class="block-content">
-<li><tt>assets</tt> - dossier de stockage des fichiers publiés privés. Voir la partie <a href="?page=Advanced.Assets">"assets"</a> pour plus de détails. Le processus du serveur Web doit avoir les droits d'écriture sur ce répertoire.</li>
-<li><tt>protected</tt> - 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.</li>
-<li><tt>runtime</tt> - 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.</li>
-<li><tt>pages</tt> - répertoire de base des pages PRADO.</li>
-</ul>
-
-<div class="tip">
-<b class="tip">Astuce :</b>Vous pouvez également utiliser le script <tt>framework/prado-cli.php</tt>
-<a href="?page=GettingStarted.CommandLine">en ligne de commande</a>
-afin de créer la structure de votre projet PRADO. Par exemple, tapez la commande
-<tt>php path/to/prado-cli.php -c helloworld</tt> dans le dossier où vous souhaitez créer votre projet <tt>helloworld</tt>.
-</div>
-
-<p id="50040">
-Les trois fichiers dont nous avons besoin sont expliqués comme suit.
-</p>
-<ul id="file-list" class="block-content">
-<li><tt>index.php</tt> - 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 <tt>index.php</tt> consiste principalement aux trois lignes suivantes :
-<com:TTextHighlighter CssClass="source block-content" id="code_50003">
-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
-</com:TTextHighlighter>
-</li>
-<li><tt>Home.page</tt> - 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,<tt>TForm</tt> et <tt>TButton</tt>, qui correspondent respectivement aux tags HTML <form> et <input>. Le fichier template contient le contenu suivant :
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_50004">
-<html>
- <body>
- <com:TForm>
- <com:TButton Text="Click me" OnClick="buttonClicked" />
- </com:TForm>
- </body>
-</html>
-</com:TTextHighlighter>
-</li>
-<li><tt>Home.php</tt> - fichier de classe pour la page <tt>Home</tt> page. Celui-ci contient principalement la méthode répondant à l'évènement <tt>OnClick</tt> du bouton.
-<com:TTextHighlighter CssClass="source block-content" id="code_50005">
-class Home extends TPage
-{
- public function buttonClicked($sender,$param)
- {
- // $sender se rapporte au composant bouton
- $sender->Text="Hello World!";
- }
-}
-</com:TTextHighlighter>
-</li>
-</ul>
-<div id="hello-end" class="block-content">
-<p id="50041">
-L'application is maintenant prête et est accesible à l'adresse
-The application is now ready and can be accessed via: <tt>http://Web-server-address/helloworld/index.php</tt>, en supposant que <tt>helloworld</tt> soit directement sous la racine de votre serveur. Essayez de modifier le <tt>TButton</tt> de la page <tt>Home.page</tt> en <tt>TLinkButton</tt> et voyez ce qui se produit.
-</p>
-<p id="50042">
-Le code source complet de cette démonstration peut être téléchargé dans la release de PRADO. Vous pouvez également essayer <a href="http://www.pradosoft.com/demos/helloworld/">la démonstration en ligne</a>.
-</p>
-</div>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/Installation.page b/demos/quickstart/protected/pages/GettingStarted/fr/Installation.page deleted file mode 100755 index 04b31cef..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/fr/Installation.page +++ /dev/null @@ -1,29 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="301">Installer PRADO</h1>
-<div id="install-info" class="block-content">
-<p id="30018">
-Si vous voyez cette page à partir de votre serveur Web, c'est que l'installation s'est déjà bien déroulée.
-</p>
-<p id="30019">
-La configuration minimum requise par PRADO est que le serveur Web supporte PHP 5. PRADO a été testé avec un serveur Apache sur une platforme Windows et Linux. Il est fort possible qu'il fonctionne avec d'autres platformes avec d'autres types de serveurs Web tant que PHP 5 est supporté.
-</p>
-</div>
-
-<div id="install-steps" class="block-content">
-<p id="30020">
-L'installation de PRADO se résume principalement au téléchargement et à la décompression des sources.
-</p>
-<ol>
-<li>Rendez-vous sur <a href="http://www.pradosoft.com/">pradosoft.com</a> afin de récupérer la dernière version de PRADO.</li>
-<li>Décompressez le fichier PRADO dans le répertoire du serveur Web.
-</ol>
-</div>
-<div id="install-after" class="block-content">
-<p id="30021">
-Votre installation de PRADO est terminée et vous pouvez commencer à utiliser les applications de démonstration incluses dans PRADO avec l'URL <tt>http://web-server-address/prado/demos/</tt>. Ici nous supposons que PRADO est décompressé dans le sous-répertoire <tt>prado</tt> sous le <tt>répertoire racine</tt> du serveur Web.
-</p>
-<p id="30022">
-Si vous rencontrez un problème avec les applications de démonstration, merci d'utiliser le script de vérification des pré-requis de PRADO, accessible à l'adresse <tt>http://web-server-address/prado/requirements/index.php</tt>, afin de vérifier que votre configuration réponds bien aux exigences de PRADO.
-</p>
-</div>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/Introduction.page b/demos/quickstart/protected/pages/GettingStarted/fr/Introduction.page deleted file mode 100755 index 2a7768ee..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/fr/Introduction.page +++ /dev/null @@ -1,19 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="101">Bienvenue sur le tutorial de démarrage rapide de PRADO</h1>
-<div id="intro" class="block-content">
-<p id="10001">
-Ce tutorial est destiné à vous aider rapidement à créer votre propre application Web basée sur PRADO version 3.X.
-</p>
-<p id="10002">
-Vous pouvez vous réferrer aux ressouces suivantes si vous trouvez que ce tutorial ne correspond pas à vos besoins.
-</p>
-</div>
-<ul class="block-content" id="intro-links">
- <li><a href="http://www.pradosoft.com/docs/classdoc/">PRADO Classes</a></li>
- <li><a href="http://www.pradosoft.com/docs/manual/">PRADO API Documentation</a></li>
- <li><a href="http://www.pradosoft.com/forum/">PRADO Forum</a></li>
- <li><a href="http://www.pradosoft.com/wiki/">PRADO Wiki</a></li>
- <li><a href="http://trac.pradosoft.com/prado/">PRADO Trac</a></li>
-</ul>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/NewFeatures.page b/demos/quickstart/protected/pages/GettingStarted/fr/NewFeatures.page deleted file mode 100755 index 7e0805c4..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/fr/NewFeatures.page +++ /dev/null @@ -1,24 +0,0 @@ -<com:TContent ID="body" >
-
-<h1>Nouvelles fonctionnalités</h1>
-
-<p>
-Cette page résume les principale fonctionnalités introduites dans chaque version de PRADO.
-</p>
-
-<h2>Version 3.1.0</h2>
-<ul>
-
-<li>Ajout d'un support d'AJAX. Un large panel de contrôles AJAX, appelés "active controls", est introduit. L'utilisation de ces contrôles est très similaires à leur homologue "non-AJAX". Pour plus de détails, voir le détail sur les <a href="?page=ActiveControls.Home">"active controls"</a>.</li>
-
-<li>Ajout d'un support complet de base de données.</li>
-<li>Ajout de nouveaux contrôles, modules et services, incluant <a href="?page=Services.SoapService">TSoapService</a>, <a href="?page=Controls.OutputCache">TOutputCache</a>, TSessionPageStatePersister, TFeedService, TJsonService, cache des dépendances entre les classes et TXmlTransform.
-</li>
-
-<li>Amélioration de certains contrôles de données avec des "renderers". Le "Renderer" permet la réutilisation des templates qui sont généralement trouvés dans les contrôles comme <tt>TRepeater</tt>, <tt>TDataList</tt> et <tt>TDataGrid</tt>, rendant ainsi la configuration de ces contrôles plus "propre". Pour plus de détails, consultez les tutoriaux mis à jour : <a href="?page=Controls.Repeater"><tt>TRepeater</tt></a>, <a href="?page=Controls.DataList"><tt>TDataList</tt></a> et <a href="?page=Controls.DataGrid"><tt>TDataGrid</tt></a>.</li>
-
-<li>Ajout du support des <a href="?page=Configurations.AppConfig">fichiers de configurations externes</a>. Amélioration de la syntaxe des templates afin de faciliter la <a href="?page=Configurations.Templates1">configuration des sous-propriétés</a>.</li>
-
-</ul>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/Upgrading.page b/demos/quickstart/protected/pages/GettingStarted/fr/Upgrading.page deleted file mode 100755 index 18d3b218..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/fr/Upgrading.page +++ /dev/null @@ -1,63 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="501">Mise à jour à partir des versions v2.x et v1.x</h1>
-
-<div id="from-2-or-1" class="block-content">
-<p id="40023">
-PRADO v3.0 n'est pas rétro-compatible avec les versions précédents de PRADO.
-</p>
-<p id="40024">
-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.
-</p>
-<p id="40025">
-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.
-</p>
-</div>
-
-<h2 id="502">Définition des composants</h2>
-<p id="40026" class="block-content">
-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 <tt>on</tt>... .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é <tt>Enabled</tt> propriétaire d'un <tt>TControl</tt>, qui est un type <tt>booléen</tt>,
-</p>
-<com:TTextHighlighter Language="php" CssClass="block-content source" ID="code1">
-public function setEnabled($value)
-{
- $value=TPropertyValue::ensureBoolean($value);
- $this->setViewState('Enabled',$value,true);
-}
-</com:TTextHighlighter>
-<p id="40027" class="block-content">
-où la fonction <tt>TPropertyValue::ensureBoolean()</tt> 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.
-</p>
-
-<h2 id="503">Contrôleur de l'application</h2>
-<p id="40028" class="block-content">
-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 <a href="?page=Fundamentals.Applications">le cycle de vie de l'application</a>. Le concept des modules de la version 2.x a été replacé dans la v3.0 par <a href="?page=Configurations.PageConfig">les répertoires des pages</a>. En conséquence, le format de <a href="?page=Configurations.AppConfig">configuration de l'application</a> de la v3.0 est très différent des versions précédentes.
-</p>
-
-<h2 id="504">Pages</h2>
-<p id="40029" class="block-content">
-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 <tt>index.php?page=Controls.Samples.Sample1</tt> sera utilisée pour servir une page nommée <tt>Sample1</tt> se trouvant dans le répertoire <tt>[BasePath]/Controls/Samples</tt>, où <tt>[BasePath]</tt> se réfère au répertoire racine des pages. Le nom d'un fichier template d'une page doit avoir comme extension <tt>.page</tt>, principalement pour différencier les templates des pages des templates des contrôles qui se termineront par l'extension <tt>.tpl</tt>.
-</p>
-
-<h2 id="505">Relation des contrôles</h2>
-<p id="40030" class="block-content">
-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 <a href="?page=Fundamentals.Controls">contrôles</a>.
-</p>
-
-<h2 id="506">Syntaxe des Templates</h2>
-<div id="template-syntax" class="block-content">
-<p id="40031">
-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,</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_40002">
-<com:MyComponent PropertyName=<%# PHP expression %> .../>
-</com:TTextHighlighter>
-<p id="40032">
-Les expressions et les tags d'états ont aussi changé. Pour plus de détails, voir la section concernant la <a href="?page=Configurations.Templates1">définition des templates</a>.
-</p>
-</div>
-<h2 id="507">Syntaxe des Thèmes</h2>
-<p id="40033" class="block-content">
-Les thèmes dans la v3.0 sont définis comme les contrôles des templates avec quelques restrictions.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/directory.gif b/demos/quickstart/protected/pages/GettingStarted/fr/directory.gif Binary files differdeleted file mode 100755 index e6c4f724..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/fr/directory.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/GettingStarted/fr/sequence.gif b/demos/quickstart/protected/pages/GettingStarted/fr/sequence.gif Binary files differdeleted file mode 100755 index 4207a9bb..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/fr/sequence.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/GettingStarted/id/AboutPrado.page b/demos/quickstart/protected/pages/GettingStarted/id/AboutPrado.page deleted file mode 100755 index e2704859..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/id/AboutPrado.page +++ /dev/null @@ -1,70 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="201">Apa itu PRADO?</h1>
-<p id="20003" class="block-content">
-PRADO adalah kerangka pemrograman berbasis-komponen dan kendali-event untuk mengembangkan aplikasi Web dalam PHP 5. PRADO singkatan dari <b>P</b>HP <b>R</b>apid <b>A</b>pplication <b>D</b>evelopment <b>O</b>bject-oriented.
-</p>
-<p id="20004" class="block-content">
-Tujuan utama dari PRADO adalah menghidupkan usabilitas secara maksimum dalam pemrograman Web. Dengan usabilitas, kami artikan tidak hanya menggunakan ulang kode yang dimiliki seseorang, tapi juga menggunakan ulang kode orang lain dalam cara yang mudah. Yang terakhir lebih penting karena menghemat usaha penciptaan roda dan menghemat waktu pengembangan secara dramatis. Pengenalan atas konsep komponen adalah untuk tujuan ini.
-</p>
-<p id="20005" class="block-content">
-Untuk mencapai tujuan di atas, PRADO menetapkan sebuah protokol atas penulisan dan pemakaian komponen untuk membentuk aplikasi Web. Komponen adalah unit software yang mengandung-dirinya sendiri dan dapat dipakai ulang dengan kustomisasi mudah. Komponen baru dapat dibuat dengan komposisi sederhana terhadap komponen-komponen yang sudah ada.
-</p>
-<p id="20006" class="block-content">
-Untuk menjembatani interaksi dengan komponen, PRADO menerapkan paradigma pemrograman kendali-event yang membolehkan delegasi aturan yang bisa diperpanjang ke komponen. Aktivitas pengguna-akhir seperti mengklik pada tombol kirim, ditangkap sebagai event server. Metode atau fungsi dapat disertakan pada event ini agar ketika event terjadi, metode atau fungsi dipanggil secara otomatis untuk merespon event. Dibandingkan dengan pemrograman Web tradisional di mana para pengembang harus berhadapan dengan variabel kasar POST atay GET, pemrograman kendali-event membantu para pengembang lain lebih berfokus pada logika yang diperlukan dan mengurangi secara drastis pengkodean berulang kali.
-</p>
-<p id="20007" class="block-content">
-Ringkasnya, mengembangkan aplikasi Web PRADO sebagian besar menyangkut penurunan tipe komponen yang sudah dibuat sebelumnya, mengkonfigurasinya dengan menyetel propertinya, merespon ke event-nya dengan menulis fungsi pengendali, dan mengaturnya ke dalam halaman untuk aplikasi. Ini sangat mirip dengan kit piranti RAD, seperti Borland Delphi dan Microsoft Visual Basic, yang digunakan untuk mengembangkan aplikasi GUI desktop.
-</p>
-
-<h2 id="202">Mengapa PRADO?</h2>
-<p id="20008" class="block-content">
-PRADO banyak dikutip sebagai kerangka kerja yang unik. Kenyataannya, ia begitu unik sehinggi ia dapat mengalihkan pemrograman PHP yang membosankan menjadi tugas yang menyenangkan. Daftar berikut adalah ringkasan pendek dari fitur utama PRADO,
-</p>
-<ul id="prado-features" class="block-content">
-<li>Usabilitas - Kode mengikuti protokol komponen yang dapat digunakan secara berulang-ulang. Ini menguntungkan tim pengembang selama bekerja karena mereka dapat menggunakan kembali pekerjaan mereka sebelumnya serta mengintegrasikan pekerjaan pihak lain dengan mudah.</li>
-<li>Pemrograman kendali-event - Aktivitas pengguna-akhir, seperti mengklik pada tombol kirim, dianggap sebagai event server dengan begitu para pengembang lebih terfokus pada menghadapi interaksi pengguna.</li>
-<li>Integrasi tim - Penyajian dan logika disimpan secara terpisah. Aplikasi PRADO dapat berganti tema.</li>
-<li>Kontrol Web bertenaga - PRADO hadir dengan set komponen bertenaga berkenaan dengan antarmuka pengguna Web. Halaman Web interaktif tinggi dapat dibuat dengan beberapa baris kode. Sebagai contoh, menggunakan komponen datagrid, seseorang bisa dengan cepat membuat sebuah halaman yang menyajikan tabel data yang membolehkan banyak halaman, pengurutan, penyuntingan, dan penghapusan baris data.
-<li>Dukungan database kuat - Sejak versi 3.1, PRADO telah dilengkapi dengan dukungan database lengkap yang secara alami ditulis dan selanjutnya cocok dengan kerangka kerja PRADO lainnya. Berdasarkan kompleksitas dari obyek bisnis, seseorang dapat memilih untuk menggunakan akses data berbasis-PDO, atau rekaman aktif yang lebih umum dikenal, atau skema pemetaan obyek bisnis lengkap SqlMap.</li>
-<li>Dukungan AJAX - Menggunakan AJAX dalam PRADO jauh lebih mudah dengan kontrol aktif inovatif yang diperkenalkan sejak versi 3.1. Dengan mudah Anda dapat menulis aplikasi AJAX-enabled tanpa menuliskan satu barispun kode javascript. Kenyataannya, menggunakan kontrol aktif tidak jauh berbeda dengan menggunakan kontrol Web reguler non-AJAX.</li>
-<li>Dukungan I18N dan L10N - PRADO menyertakan dukungan lengkap untuk membangun aplikasi dengan multipel bahasa dan lokal.</li>
-<li>Sesuai XHTML - Halaman Web yang dibuat oleh PRADO sesuai dengan XHTML.</li>
-<li>Akomodasi dari pekerjaan yang sudah ada - PRADO adalah kerangka kerja umum dengan fokus pada lapisan penyajian. Ita tidak mengecualikan para pengembang dari pemakaian librari kelas atau kit piranti yang sudah ada. Sebagai contoh, seseorang dapat memakai AdoDB atau Creole untuk berhadapan dengan DB dalam aplikasi PRADO-nya.
-<li>Fitur lainnya - Penangangan kesalahan/kekecualian bertenaga serta pencatatan pesan; cache generik dan cache output selektif; penanganan kesalahan yang dapat dikustomisasi serta dilokalisasi; otorisasi dan otentikasi yang yang dapat diperluas; ukuran keamanan serperti pencegahan naskah situs-silang (XSS), proteksi cookie, dll.</li>
-</ul>
-
-<h2 id="203">Untuk Apa PRADO Paling Cocok?</h2>
-<p id="20009" class="block-content">
-PRADO paling cocok untuk membuat aplikasi Web yang tingkat interaksif-penggunanya cukup tinggi. Ia dapat dipakai untuk mengembangkan sistem sesederhana sistem blog sampai serumit sistem manajemen konten (CMS) atau solusi e-commerce lengkap. Karena PRADO mempromosikan pemrograman terorientasi-obyek melalui metodologi basis-komponennya, ia sangat cocok untuk kerjasama tim dan pengembangan enterprise.
-</p>
-<p id="20011" class="block-content">
-PRADO hadir dengan set lengkap atas teknik cache yang membantu mempercepat aplikasi Web PRADO untuk mengakomodasi kebutuhan lalu lintas tinggi. Arsitektur modularnya membolehkan para pengembang menyertakan modul cache berbeda untuk keperluan yang berbeda pula. Cache output membebaskan seseorang untuk memilih secara selektif bagian halaman Web yang akan di-cache.
-</p>
-
-<h2 id="204">Bagaimana PRADO Bila Dibandingkan dengan Kerangka Kerja Lain?</h2>
-<p id="20012" class="block-content">
-PRADO sering dikutip sebagai kerangka kerja unik. Keunikannya terutama berada pada paradigma pemrograman berbasis-komponen dan kendali-event yang dicoba dipromosikan. Meskipun paradigma pemrograman ini bukan hal baru dalam pemrograman aplikasi desktop dan bukan hal baru dalam beberapa bahasa pemrograman Web, Barangkali PRADO adalah kerangka kerja PHP pertama yang menghidupkannya.
-</p>
-<p id="20013" class="block-content">
-Kebanyakan kerangka kerja PHP berfokus pada pemisahan penyajian dan logika serta mempromosikan pola desain MVC (model-view-controller). Pada dasarnya PRADO melakukan tujuan yang sama dengan membutuhkan logika disimpan dalam kelas dan penyajian dalam template. PRADO melakukan lebih banyak aspek tidak hanya MVC. Ia mengisi banyak area kosong dalam pemrograman Web PHP dengan paradigma pemrograman berbasis-komponen, kontrol Web yang kaya, dukungan database yang handal, fitur penanganan kesalahan yang fleksibel serta fitur pencatatan, dan masih banyak lagi.
-</p>
-
-<h2 id="4004">Apakah PRADO Cukup Stabil?</h2>
-<p id="20004" class="block-content">
-Ya. PRADO awalnya dirilis pada bulan Agustus 2004. Banyak rangkaian pengujian sudah ditulis dan dilaksanakan secara berkala guna memastikan kualitasnya. Sudah dipakai oleh ribuan pengembang dan banyak aplikasi Web dikembangkan berbasis itu. Bugs dan permintaan fitur diatur melalui sistem TRAC dan kami mempunyai komunitas pengguna besar dan tim pengembangan untuk memastikan semua pertanyaan dijawab dalam model berkala.
-</p>
-
-<h2 id="205">Sejarah PRADO</h2>
-<p id="20014" class="block-content">
-Inspirasi orisinil PRADO berasal dari Apache Tapestry. Selama desain dan implementasi, Saya meminjam ide dari Borland Delphi dan Microsoft ASP.NET. Versi pertama PRADO keluar dalam bulan Juni 2004 dan ditulis dalam PHP 4. Karena adanya kontes kode Zend PHP 5, Saya menulis ulang PRADO dalam PHP 5, yang membuktikan menjadi perpindahan yang bijaksana, terima kasih pada model obyek baru yang disediakan PHP 5. PRADO memenangkan hadiah utama dalam kontes Zend, memperoleh pilihan tertinggi baik dari umum dan panelis juri.
-</p>
-<p id="20015" class="block-content">
-Dalam bulan Agustus 2004, PRADO mulai ditampung pada SourceForge sebagai proyek sumber terbuka. Segera setelah itu, situs proyek <a href="http://www.xisc.com/">xisc.com</a> diumumkan kepada publik. Dengan dukungan fantastis dari tim pengembang PRADO dan pengguna PRADO, PRADO berkembang ke versi 2.0 di pertengahan 2005. Dalam versi ini, Wei Zhuo berkontribusi ke PRADO dengan dukungan I18N dan L10N yang istimewa.
-</p>
-<p id="20016" class="block-content">
-Dalam bulan Mei 2005, kami memutuskan untuk menulis ulang sepenuhnya kerangka kerja PRADO untuk memecahkan beberapa isu dasar dalam versi 2.0 dan untuk menangkap dengan beberapa fitur bagus dalam Microsoft ASP.NET 2.0. Setelah hampir setahun kerja keras dengan lebih dari 50,000 baris kode baru, versi 3.0 akhirnya tersedia pada bulan April 2006.
-</p>
-<p id="20017" class="block-content">
-Mulai dari versi 3.0, usaha signifikan dialokasikan untuk memastikan kualitas dan stabilitas PRADO. Jika kami katakan PRADO v2.x dan v1.x adalah pekerjaan bukti-konsep, kami dapat mengatakan PRADO 3.x telah berkembang menjadi proyek yang layak untuk pengembangan aplikasi bisnis serius.
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/id/CommandLine.page b/demos/quickstart/protected/pages/GettingStarted/id/CommandLine.page deleted file mode 100755 index 36c29700..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/id/CommandLine.page +++ /dev/null @@ -1,93 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="501">Piranti Baris Perintah</h1>
-<p id="70046" class="block-content">File naskah PHP opsional <tt>prado-cli.php</tt> dalam direktori <tt>framework</tt>
-menyediakan piranti baris perintah untuk melakukan berbagai hal membosankan dalam Prado.
-<tt>prado-cli.php</tt> dapat dipakai untuk membuat kerangka proyek Prado, membuat perlengkapan pengujian awal, dan akses ke shell PHP interaktif.
-</p>
-<h2 id="502">Persyaratan</h2>
-<p id="70047" class="block-content">
-Untuk menggunakan piranti baris perintah, Anda perlu memakai prompt perintah Anda, konsol perintah atau terminal. Sebagai tambahan, PHP harus dapat menjalankan naskah PHP dari baris perintah.
-</p>
-
-<h2 id="503">Usage</h2>
-<p id="70048" class="block-content">
-Jika Anda ketik <tt>php path/ke/framework/prado-cli.php</tt>, Anda seharusnya melihat informasi berikut. Alternatifnya, jika Anda tidak pada Windows, Anda dapat mencoba untuk mengubah <tt>prado-cli.php</tt> ke dalam eksecutabel dan menjalankannya seperti sebuah naskah</p>
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70006">
-Command line tools for Prado 3.0.5.
-usage: php prado-cli.php action <parameter> [optional]
-example: php prado-cli.php -c mysite
-
-actions:
- -c <directory>
- Creates a Prado project skeleton for the given <directory>.
-
- -t <directory>
- Create test fixtures in the given <directory>.
-
- shell [directory]
- Runs a PHP interactive interpreter. Initializes the Prado
- application in the given [directory].
-</com:TTextHighlighter>
-
-<p id="70049" class="block-content"><b><parameter></b> adalah parameter diperlukan dan <b>[optional]</b> adalah parameter opsional. </p>
-
-<h2 id="504">Membuat kerangka proyek Prado baru</h2>
-
-<p id="70050" class="block-content">Untuk membuat kerangka proyek Prado, lakukan yang berikut:</p>
-<ol>
- <li>Ubah direktori di mana Anda ingin membuat kerangka proyek.</li>
- <li>Ketik, <tt>php ../prado/framework/prado-cli.php -c helloworld</tt>, sedangkan
- <tt>helloworld</tt> adalah nama direktori di mana file kerangka proyek ingin Anda buat.</li>
- <li>Ketik, <tt>php ../prado/framework/prado-cli.php <b>-t</b> helloworld</tt> untuk membuat perlengkapan pengujian untuk proyek <tt>helloworld</tt>.</li>
-</ol>
-
-<h2 id="505">Shell Interaktif</h2>
-<p id="70051" class="block-content">
-Shell interaktif membolehkan Anda untuk mengevaluasi pernyataan PHP dari baris perintah.
-Naskah <tt>prado-cli.php</tt> dapat dipakai untuk memulai shell dan mengambil proyek Prado yang sudah ada. Sebagai contoh, mari kita ambil proyek demo blog. Anggap bahwa baris perintah Anda ada dalam direktori distribusi <tt>prado</tt> dan Anda mengetikkannya.
-</p>
-<p id="70052" class="block-content">
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70007">
-$: php framework/prado-cli.php shell demos/blog
-</com:TTextHighlighter>
-Output seharusnya
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70008">
-Command line tools for Prado 3.0.5.
-** Loaded Prado application in directory "demos\blog\protected".
-PHP-Shell - Version 0.3.1
-(c) 2006, Jan Kneschke <jan@kneschke.de>
-
->> use '?' to open the inline help
-
->>
-</com:TTextHighlighter>
-Selanjutnya kita akan mendapatkan turunan dari aplikasi blog Prado, dan dari turunan itu kita menginginkan sebuah turunan dari modul <tt>'data'</tt>. Catatan bahwa <b>titik koma</b> di akhir baris <b>menindih output</b>.
-
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70009">
->> $app = Prado::getApplication();
-
->> $db = $app->getModule('data');
-</com:TTextHighlighter>
-Terakhir, kita ingin menggunakan modul data untuk meng-query sebuah tulisan dengan <tt>ID=1</tt>. Catatan bahwa kita <b>membiarkan titik koma</b> untuk menampilkan hasilnya.
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70010">
->> $db->queryPostByID(1)
-</com:TTextHighlighter>
-Di sana seharusnya tidak terjadi kesalahan apapun dan seharusnya Anda melihat yang berikut.
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70011">
-PostRecord#1
-(
- [ID] => 1
- [AuthorID] => 1
- [AuthorName] => 'Prado User'
- [CreateTime] => 1148819691
- [ModifyTime] => 0
- [Title] => 'Welcome to Prado Weblog'
- [Content] => 'Congratulations! You have successfully installed Prado Blog --
- a PRADO-driven weblog system. A default administrator account has been created.
- Please login with <b>admin/prado</b> and update your password as soon as possible.'
- [Status] => 0
- [CommentCount] => 0
-)
-</com:TTextHighlighter>
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/id/HelloWorld.page b/demos/quickstart/protected/pages/GettingStarted/id/HelloWorld.page deleted file mode 100755 index a24b5969..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/id/HelloWorld.page +++ /dev/null @@ -1,82 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="401">Aplikasi PRADO Pertama Saya</h1>
-<div id="hello1" class="block-content">
-<p id="50034">
-Dalam seksi ini, kami membimbing Anda melalui pembuatan aplikasi PRADO pertama Anda, aplikasi terkenal "Hello World".
-</p>
-<p id="50035">
-"Hello World" barangkali adalah aplikasi PRADO <i>interaktif</i> paling sederhana yang bisa Anda buat. Ia menampilkan kepada pengguna-akhir sebuah halaman dengan tombol kirim yang judulnya adalah <tt>Click Me</tt>. Setelah pengguna mengklik tombol, judulnya diubah ke <tt>Hello World</tt>.
-</p>
-<p id="50036">
-Ada banyak pendekatan yang dapat mencapai tujuan di atas. Seseorang dapat mengirim halaman ke server, menentukan variabel POST, dan membuat halaman baru dengan judul tombol yang dimutakhirkan. Atau seseorang cukup menggunakan JavaScript untuk memutakhirkan judul tombol setelah event klien <tt>onclick</tt>.
-</p>
-</div>
-<p id="50037" class="block-content">
-PRADO mempromosikan pemrograman Web berbasis-komponen dan kendali-event. Tombol disajikan oleh obyek <tt>TButton</tt>. Ia melapisi judul tombol sebagai properti <tt>Text</tt> dan mengaitkan tindakan klik pengguna dengan event sisi-server <tt>OnClick</tt>. Untuk merespon klik pengguna pada tombol, seseorang cukup perlu menyertakan fungsi ke event <tt>OnClick</tt> tombol. Di dalam fungsi, properti tombol <tt>Text</tt> diubah sebagai "Hello World". Diagram berikut menampilkan urutan di atas,
-<img src="<%~sequence.gif%>" class="figure"/>
-</p>
-<p id="50038" class="block-content">
-Aplikasi PRADO kita terdiri dari tiga file, <tt>index.php</tt>, <tt>Home.page</tt> dan <tt>Home.php</tt>, yang diatur sebagai berikut,
-<img src="<%~directory.gif%>" class="figure"/>
-
-di mana setiap direktori dijelaskan sebagai berikut. Catatan, struktur direktori di atas bisa dikustomisasi. Sebagai contoh, seseorang dapat memindahkan direktori <tt>protected</tt> ke luar direktori Web. Anda akan mengetahui bagaimana melakukan ini setelah Anda melewati tutorial ini.
-</p>
-<ul id="dir-struct" class="block-content">
-<li><tt>assets</tt> - direktori yang menyimpan file pribadi yang dipublikasikan. Lihat seksi <a href="?page=Advanced.Assets">assets</a> untuk lebih jelasnya. Direktori ini harus bisa ditulisi oleh proses server Web.</li>
-<li><tt>protected</tt> - path basis aplikasi yang menyimpan data aplikasi dan file naskah pribadi. Direktori ini harus dikonfigurasi tidak bisa diakses terhadap pengguna-akhir.</li>
-<li><tt>runtime</tt> - path penyimpan runtime aplikasi. Direktori ini dipakai oleh PRADO untuk menyimpan informasi runtime aplikasi, seperti kondisi aplikasi, data di-cache, dll. Direktori ini harus bisa ditulisi oleh proses server Web.</li>
-<li><tt>pages</tt> - path basis yang menyimpan semua halaman PRADO.</li>
-</ul>
-
-<div class="tip">
-<b class="tip">Tip:</b>Anda juga dapat menggunakan <tt>framework/prado-cli.php</tt>
-<a href="?page=GettingStarted.CommandLine">naskah baris perintah</a>
-untuk membuat struktur direktori Prado. Sebagai contoh, ketik perintah
-<tt>php path/to/prado-cli.php -c helloworld</tt> dalam direktori di mana Anda ingin membuat proyek <tt>helloworld</tt>.
-</div>
-
-<p id="50040">
-Ketiga file yang kita pakai dijelaskan sebagai berikut.
-</p>
-<ul id="file-list" class="block-content">
-<li><tt>index.php</tt> - naskah entri dari aplikasi PRADO. File ini dibutuhkan oleh semua aplikasi PRADO dan satu-satunya file naskah yang secara langsung bisa diakses oleh pengguna-akhir. Konten dalam <tt>index.php</tt> sebagian besar terdiri dari tiga baris berikut,
-<com:TTextHighlighter CssClass="source block-content" id="code_50003">
-require_once('path/to/prado.php'); // sertakan naskah prado
-$application=new TApplication; // buat turunan aplikasi PRADO
-$application->run(); // jalankan aplikasi
-</com:TTextHighlighter>
-</li>
-<li><tt>Home.page</tt> - template untuk setiap halaman standar saat pengguna tidak secara eksplisit menetapkan halaman yang diminta. Sebuah template menetapkan penyajian tata letak komponen. Dalam contoh ini, kita gunakan dua komponen, <tt>TForm</tt> dan <tt>TButton</tt>, masing-masing terkait ke tag HTML <form> dan <input>. Template berisi konten berikut,
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_50004">
-<html>
- <body>
- <com:TForm>
- <com:TButton Text="Click me" OnClick="buttonClicked" />
- </com:TForm>
- </body>
-</html>
-</com:TTextHighlighter>
-</li>
-<li><tt>Home.php</tt> - Kelas halaman untuk halaman <tt>Home</tt>. Ia terutama berisi metode yang terkait dengan event tombol <tt>OnClick</tt>.
-<com:TTextHighlighter CssClass="source block-content" id="code_50005">
-class Home extends TPage
-{
- public function buttonClicked($sender,$param)
- {
- // $sender refers to the button component
- $sender->Text="Hello World!";
- }
-}
-</com:TTextHighlighter>
-</li>
-</ul>
-<div id="hello-end" class="block-content">
-<p id="50041">
-Aplikasi sekarang siap dan dapat diakses melalui: <tt>http://Web-server-address/helloworld/index.php</tt>, menganggap <tt>helloworld</tt> adalah direktori di bawah Web <tt>DocumentRoot</tt>. Coba untuk mengubah <tt>TButton</tt> dalam <tt>Home.page</tt> ke <tt>TLinkButton</tt> dan lihat apa yang terjadi.
-</p>
-<p id="50042">
-Kode sumber lengkap dari demo ini dapat ditemukan pada rilis PRADO. Anda juga dapat mencoba <a href="http://www.pradosoft.com/demos/helloworld/">demo online</a>.
-</p>
-</div>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/id/Installation.page b/demos/quickstart/protected/pages/GettingStarted/id/Installation.page deleted file mode 100755 index 1990335b..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/id/Installation.page +++ /dev/null @@ -1,29 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="301">Menginstalasi PRADO</h1>
-<div id="install-info" class="block-content">
-<p id="30018">
-Jika Anda sedang melihat halaman ini dari server Web Anda, maka Anda sudah selesai dengan instalasi.
-</p>
-<p id="30019">
-Persyaratan minimum PRADO adalah server Web yang mendukung PHP 5. PRADO sudah diuji dengan server Web Apache pada Windows dan Linux. Sangat dimungkinkan ia juga berjalan pada platform lain dengan server Web lain, selama PHP 5 didukung.
-</p>
-</div>
-
-<div id="install-steps" class="block-content">
-<p id="30020">
-Instalasi PRADO sebagian besar menyangkut download dan penguraian.
-</p>
-<ol>
-<li>Pergi ke <a href="http://www.pradosoft.com/">pradosoft.com</a> untuk mendapatkan PRADO versi terbaru.</li>
-<li>Uraikan file rilis PRADO ke direktori yang dapat diakses Web.
-</ol>
-</div>
-<div id="install-after" class="block-content">
-<p id="30021">
-Instalasi PRADO Anda selesai dan dapat mulai bermain dengan demo aplikasi yang disertakan dalam rilis PRADO via URL <tt>http://web-server-address/prado/demos/</tt>. Di sini kami menganggap PRADO diurai ke subdirektori <tt>prado</tt> di bawah <tt>DocumentRoot</tt> pada server Web.
-</p>
-<p id="30022">
-Jika Anda menemukan masalah dengan demo aplikasi, silahkan gunakan naskah pemeriksa persyaratan, yang dapapt diakses melalui <tt>http://web-server-address/prado/requirements/index.php</tt>, untuk terlebih dahulu memeriksa apakah konfigurasi server Anda memenuhi kondisi yang dibutuhkan oleh PRADO.
-</p>
-</div>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/id/Introduction.page b/demos/quickstart/protected/pages/GettingStarted/id/Introduction.page deleted file mode 100755 index 3aed6f6e..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/id/Introduction.page +++ /dev/null @@ -1,62 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="101">Selamat datang di Tutorial Cepat PRADO</h1>
-<div id="intro" class="block-content">
-<p id="10001">
-Tutorial Cepat ini disediakan untuk membantu Anda secara cepat membangun aplikasi Web Anda sendiri berbasis PRADO versi 3.x.
-</p>
-<p id="10001" class="block-content">
-Jika Anda adalah pengguna yang sudah mengenal PRADO 3.x dan ingin mempelajari peningkatan apa yang tersedia pada versi baru, silahkan periksa halaman <a href="?page=GettingStarted.NewFeatures">fitur baru</a>. Sebaliknya, seksi berikut sangat membantu bagi para pemula.
-</p>
-<!--
-<div class="start-page">
- <div class="concepts start-block">
- <h2 id="2001">Bagaimana PRADO Bekerja</h2>
- <p id="10002" class="block-content">Konsep dan fundamental</p>
- <ol>
- <li><a href="#">Membangun aplikasi web dengan PRADO</a></li>
- <li><a href="#">Kontrol dan event Web</a></li>
- <li><a href="#">Memvalidasi input pengguna</a></li>
- <li><a href="#">Menyambung ke database Anda</a></li>
- <li><a href="#">Menampilkan data dari database</a></li>
- </ol>
- </div>
- <div class="examples start-block">
- <h2 id="2002">Contoh dan Demo</h2>
- <ul>
- <li><a href="../helloworld/">Hello World</a></li>
- <li><a href="../currency-convert/">Pengubah Kurs</a></li>
- <li><a href="../address-book/">Buku Alamat</a></li>
- <li><a href="../blog/">Blog</a></li>
- <li><a href="../chat/">AJAX Chat</a></li>
- <li><a href="../time-tracker/">Pelacak Waktu Proyek</a></li>
- </ul>
- <p id="10003" class="block-content">Lebih banyak contoh di <a href="?page=Controls.Standard">Kontrol Standar</a>,
- <a href="?page=Controls.Validation">Memvalidasi Kontrol</a> dan
- <a href="?page=Controls.Data">Kontrol Data</a>.
- </div>
-
- <div class="tutorials start-block">
- <h2 id="2003">Tutorial dan Bantuan</h2>
- <ul>
- <li><a href="?page=GettingStarted.HelloWorld">Hello World secara rinci</a></li>
- <li><a href="?page=Tutorial.CurrencyConverter">Tutorial Pengubah Kurs</a></li>
- <li><a href="?page=Tutorial.AddressBook">Tutorial Buku Alamat</a></li>
- <li><a href="?page=Tutorial.AjaxChat">Tutorial Obrolan AJAX</a></li>
- </ul>
- </div>
-</div>
--->
-
-<p id="10002">
-Anda dapat merujuk ke sumber daya berikut jika Anda mendapatkan tutorial ini tidak memenuhi semua kebutuhan Anda.
-</p>
-</div>
-<ul class="block-content" id="intro-links">
- <li><a href="http://www.pradosoft.com/docs/classdoc/">Kelas PRADO</a></li>
- <li><a href="http://www.pradosoft.com/docs/manual/">Dokumentasi API PRADO</a></li>
- <li><a href="http://www.pradosoft.com/forum/">Forum PRADO</a></li>
- <li><a href="http://www.pradosoft.com/wiki/">Wiki PRADO</a></li>
- <li><a href="http://trac.pradosoft.com/prado/">Trac PRADO</a></li>
-</ul>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/id/NewFeatures.page b/demos/quickstart/protected/pages/GettingStarted/id/NewFeatures.page deleted file mode 100755 index 6d3ce4f9..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/id/NewFeatures.page +++ /dev/null @@ -1,41 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="8005">Fitur Baru</h1>
-
-<p id="40005" class="block-content">
-Halaman ini meringkas fitur-fitur utama baru yang diperkenalkan dalam setiap rilis PRADO.
-</p>
-
-<h2>Version 3.1.1</h2>
-<ul>
-<li>Ditambahkan kontrol baru <a href="?page=Controls.TabPanel">TTabPanel</a> yang menampilkan tampilan tab.</li>
-<li>Ditambahkan kontrol baru <a href="?page=Controls.Keyboard">TKeyboard</a> yang menampilkan keyboard virtual untuk input teks.</li>
-<li>Ditambahkan kontrol baru <a href="?page=Controls.Captcha">TCaptcha</a> yang menampilkan CAPTCHA untuk menjaga spammers dari pendaftaran untuk akun online tertentu. Validator <tt>TCaptchaValidator</tt> terkait juga diimplementasikan.</li>
-<li>Ditambahkan kontrol baru <a href="?page=Controls.Slider">TSlider</a> yang menampilkan sebuah slider yang dapat dipakai untuk input numerik.</li>
-<li>Ditambahkan kontrol baru <a href="?page=Controls.Conditional">TConditional</a> yang menampilkan salah satu dari dua konten secara kondisional.</li>
-<li>Ditambahkan dukungan Oracle DB ke Rekaman Aktif</li>
-<li>Ditambahkan dukungan TDataGrid untuk membolehkan pengelompokan sel yang berurutan dengan isi yang sama.</li>
-<li>Ditambahkan dukungan untuk mengkonfigurasi properti halaman dan aturan otorisasi menggunakan <a href="?page=Configurations.PageConfig">path halaman relatif</a> dalam konfigurasi aplikasi dan halaman. Ditambahkan dukungan untuk membolehkan <a href="?page=Advanced.Auth">otorisasi</a> didasarkan pada alamat remote host.</li>
-<li>Ditambahkan persister kondisi halaman baru <tt>TCachePageStatePersister</tt>. Ia membolehkan kondisi halaman untuk disimpan menggunakan modul cache (misalnya TMemCache, TDbCache, dll.)
-<li>Ditambahkan dukungan untuk <a href="?page=Advanced.Auth">kerangka kerja otentikasi</a> guna mengingat yang sudah masuk.</li>
-<li>Ditambahkan dukungan untuk menampilkan item pertanyaan dalam TDropDownList dan TListBox (sesuatu mirip 'Please select:' sebagai item pertama.)</li>
-<li>Ditambahkan dukungan untuk <a href="?page=Database.ActiveRecord">pemetaan kolom dalam Rekaman Aktif</a>.</li>
-</ul>
-
-<h2 id="8006">Versi 3.1.0</h2>
-<ul>
-<li>Ditambahkan dukungan AJAX. Seluruh array dari kontrol AJAX-enabled, disebut kontrol aktif, diperkenalkan. Penggunaan dari kontrol aktif ini sangat mirip dengan kontrol non-AJAX lainnya, misalnya masukkan dan gunakan. Untuk lebih jelasnya, lihat tutorial mengenai <a href="?page=ActiveControls.Home">kontrol aktif</a>.</li>
-
-<li>Ditambahkan dukungan lengkap database. </li>
-<li>Ditambahkan kontrol, modul dan layanan baru, termasuk <a href="?page=Services.SoapService">TSoapService</a>, <a href="?page=Controls.OutputCache">TOutputCache</a>, TSessionPageStatePersister, TFeedService, TJsonService, cache dependency classes, TXmlTransform.
-</li>
-
-<li>Ditingkatkan beberapa kontrol data dengan penyaji. Penyaji mendhidupkan penggunaan kembali item template yang umumnya ditemukan dalam <tt>TRepeater</tt>, <tt>TDataList</tt> dan <tt>TDataGrid</tt>, dan menjadikan konfigurasi pada kontrol-kontrol ini jauh lebih mudah. Untuk lebih jelasnya mengenai penyaji, lihat tutorial yang dimutakhirkan pada <a href="?page=Controls.Repeater"><tt>TRepeater</tt></a>, <a href="?page=Controls.DataList"><tt>TDataList</tt></a> dan <a href="?page=Controls.DataGrid"><tt>TDataGrid</tt></a>.</li>
-
-<li>Ditambahkan dukungan untuk membolehkan <a href="?page=Configurations.AppConfig">menyertakan konfigurasi aplikasi eksternal</a>. Sintaks template ditingkatkan untuk menjembatani <a href="?page=Configurations.Templates1">konfigurasi subproperti</a>.</li>
-
-<li>Ditambahkan TDbUserManager dan TDbUser untuk menyederhanakan <a href="?page=Advanced.Auth">otentikasi dan otorisasi</a> dengan akun pengguna yang disimpan dalam sebuah database.</li>
-
-</ul>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/id/Upgrading.page b/demos/quickstart/protected/pages/GettingStarted/id/Upgrading.page deleted file mode 100755 index 744256ce..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/id/Upgrading.page +++ /dev/null @@ -1,64 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="501">Meningkatkan dari v2.x dan v1.x</h1>
-
-<div id="from-2-or-1" class="block-content">
-<p id="40023">
-PRADO v3.0 TIDAK kompatibel mundur dengan versi PRADO sebelumnya.
-</p>
-<p id="40024">
-Berita baiknya adalah, properti dan event dari kebanyakan kontrol tetap sama, dan sintaks template kontrol sebagian besar tidak diubah. Oleh karena itu, pengetahuan para pengembang dari versi PRADIO sebelumnya masih berlaku dalam v3.0.
-</p>
-<p id="40025">
-Kami meringkas perubahan paling berarti dalam v3.0 guna membantu para pengembang meningkatkan aplikasi PRADO v2.x dan v1.x lebih mudah, jika diperlukan.
-</p>
-</div>
-
-<h2 id="502">Definisi Komponen</h2>
-<p id="40026" class="block-content">
-Versi 3.0 sepenuhnya telah mengabaikan kebutuhan file spesifikasi komponen. Ia banyak bergantung pada konvensi untuk mendefinisikan properti dan event komponen. Dalam keadaan tertentu, properti didefinisikan oleh keberadaan dari metode pengambil dan/atau metode penyetel, sementara event didefinisikan dengan keberadaan <tt>pada</tt>-metode. Nama properti dan event dalam v3.0 keduanya sensitif-huruf. Sebagai konsekuensinya, para pengembang diperlukan untuk memelihara perubahan tipe saat properti komponen sedang disetel. Sebagai contoh, kode berikut dipakai untuk mendefinisikan metode penyetel untuk properti yang <tt>Dihidupkan</tt> dari <tt>TControl</tt>, yang merupakan tipe <tt>boolean</tt>,
-</p>
-<com:TTextHighlighter Language="php" CssClass="block-content source" ID="code1">
-public function setEnabled($value)
-{
- $value=TPropertyValue::ensureBoolean($value);
- $this->setViewState('Enabled',$value,true);
-}
-</com:TTextHighlighter>
-<p id="40027" class="block-content">
-di mana <tt>TPropertyValue::ensureBoolean()</tt> dipakai untuk memastikan bahwa nilai input adalah boolean. Ini adalah karena ketika properti dikonfigurasi dalam template, nilai string dikirimkan ke penyetel. Dalam versi sebelumnya, PRADO mengetahui tipe properti berdasarkan file spesifikasi komponen dan melakukan konversi tipe bagi Anda.
-</p>
-
-<h2 id="503">Pengontrol Aplikasi</h2>
-<p id="40028" class="block-content">
-Pengontrol aplikasi sekarang menerapkan sebuah arsitektur modular. Modul bisa disertakan dan dikonfigurasi dalam spesifikasi aplikasi. Setiap modul menganggap fungsionalitas tertentu, dan dikoordinasikan bersama oleh <a href="?page=Fundamentals.Applications">masa hidup aplikasi</a>. Konsep modul v2.x diganti dalam v3.0 by <a href="?page=Configurations.PageConfig">direktori halaman</a>. Walhasil, format v3.0 <a href="?page=Configurations.AppConfig">spesifikasi aplikasi</a> juga berbeda dari versi sebelumnya.
-</p>
-
-<h2 id="504">Halaman</h2>
-<p id="40029" class="block-content">
-Halaman pada v3.0 diatur dalam direktori yang bisa dibandingkan ke konsep modul pada v2.x. Halaman diminta menggunakan path kepadanya. Sebagai contoh, URL <tt>index.php?page=Controls.Samples.Sample1</tt> akan dipakai untuk meminta halaman bernama <tt>Sample1</tt> yang disimpan di bawah direktori <tt>[BasePath]/Controls/Samples</tt>, di mana <tt>[BasePath]</tt> merujuk ke akar path halaman. Nama file dari template halaman harus diakhiri dengan <tt>.page</tt>, terutama untuk membedakan template halaman dari template kontrol non-halaman yang nama filenya sama harus diakhiri dengan <tt>.tpl</tt>.
-</p>
-
-<h2 id="505">Hubungan Kontrol</h2>
-<p id="40030" class="block-content">
-Versi 3.0 mendefinsikan kembali hubungan diantara kontrol. Dalam keadaan tertentu, hubungan leluhur-anak sekarang merujuk ke hubungan lampiran antara penyajian kontrol. Dan hubungan wadah-penamaan baru diperkenalkan guna membantu lebih baik mengatur ID kontrol. Untuk lebih jelasnya, lihat seksi <a href="?page=Fundamentals.Controls">controls</a>.
-</p>
-
-<h2 id="506">Sintaks Template</h2>
-<div id="template-syntax" class="block-content">
-<p id="40031">
-Sintaks template kontrol dalam v3.0 tetap mirip dengan versi sebelumnya, dengan banyak peningkatan. Perubahan utama adalah mengenai ekspresi penyatuan data. Dalam v3.0, ini dikerjakan dengan mengikuti,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_40002">
-<com:MyComponent PropertyName=<%# PHP expression %> .../>
-</com:TTextHighlighter>
-<p id="40032">
-Tag ekspresi dan pernyataan juga diubah. Untuk lebih jelasnya, lihat seksi <a href="?page=Configurations.Templates1">definisi template</a>.
-</p>
-</div>
-<h2 id="507">Sintaks Tema</h2>
-<p id="40033" class="block-content">
-Tema dalam v3.0 didefinisikan seperti template kontrol dengan beberapa batasan.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/id/directory.gif b/demos/quickstart/protected/pages/GettingStarted/id/directory.gif Binary files differdeleted file mode 100755 index e6c4f724..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/id/directory.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/GettingStarted/id/sequence.gif b/demos/quickstart/protected/pages/GettingStarted/id/sequence.gif Binary files differdeleted file mode 100755 index df5e7cef..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/id/sequence.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/GettingStarted/id/sequence.vsd b/demos/quickstart/protected/pages/GettingStarted/id/sequence.vsd Binary files differdeleted file mode 100755 index 4129f1fc..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/id/sequence.vsd +++ /dev/null diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/AboutPrado.page b/demos/quickstart/protected/pages/GettingStarted/ja/AboutPrado.page deleted file mode 100755 index 81c1efa0..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/ja/AboutPrado.page +++ /dev/null @@ -1,79 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="201">PRADO とは？</h1>
-<p id="20003" class="block-content">
-PRADO はコンポーネントベースかつイベントドリブンなウェブアプリケーションを開発するためのPHP5フレームワークです。「PRADO」の名称は、<b>P</b>HP <b>R</b>apid <b>A</b>pplication <b>D</b>evelopment <b>O</b>bject-oriented の略です。
-</p>
-
-<p id="20004" class="block-content">
-PRADO の第一の目標は、ウェブプログラミングにおけるコードの再利用性を最大限に高めることです。
-ここでの再利用性は、自分自身で開発したコードを再利用することだけではなく、簡単な方法で他人の開発したコードを再利用することも意味しています。これは、「車輪の発明」という無駄な努力に要する時間を節約し開発工数を劇的に減らすためにはとても重要な項目といえます。PRADOではこの目的を実現するためにコンポーネントという概念を導入しています。
-</p>
-<p id="20005" class="block-content">
-上記の目的を達するために、PRADO ではウェブアプリケーション構築のためのコンポーネントの作成方法および使用方法を規定しています。コンポーネントとは、自己充足的かつちょっとしたカスタマイズで再利用が可能なソフトウェアユニットです。新しいコンポーネントは既存のコンポーネントを単純に組み合わせるだけで作成する事ができます。
-</p>
-<p id="20006" class="block-content">
-コンポーネントをインタラクティブに利用できるように、PRADO ではイベントドリブンプログラミングの枠組みを実装しています。ボタンの押下などのユーザーアクションはサーバー側のイベントとして補足されます。メソッドや関数をそれらのイベントに対応付けておくと、イベントに反応するかのように自動的にメソッドや関数が実行されます。POST/GET 変数を取得して処理をする従来のウェブプログラミングと比べて、イベントドリブン型プログラミングは開発者が必要な処理に集中でき、POST/GET の取得などの反復コードも激減する事になります。
-</p>
-<p id="20007" class="block-content">
-PRADO でのアプリケーション開発は、ページにコンポーネントを配置し、プロパティの設定やイベントに反応するメソッドをコーディングすることが主な作業となります。これはデスクトップ GUI アプリケーションを開発するのに使用する Borland Delphi や Microsoft Visual Basic などの RAD ツールと非常に似た作りとなっています。
-</p>
-
-<h2 id="202">なぜ PRADO を使うのですか？</h2>
-<p id="20008" class="block-content">
-PRADO はユニークなフレームワークとして紹介されています。事実、退屈な PHP プログラミングを楽しいものと変えることができるくらいユニークなフレームワークです。以下のリストは、PRADO に関する主な機能となっています。
-</p>
-<ul id="prado-features" class="block-content">
-<li>再利用性 - PRADOコンポーネント規約に則って作成されたコードは再利用性が高いです。開発チームの他の人が開発したコードを再利用することにより、容易にチーム開発での連携を強める事ができます。</li>
-
-<li>イベントドリブン型プログラミング - サーバーイベントとしてユーザーのアクションを取得する事ができるので、開発者はユーザの操作とアプリケーションとの相互作用に今まで以上に焦点を合わせることができます。。</li>
-
-<li>チーム統合 - 画面出力部分とロジック部分が別々に保存されるので、デザイナーと開発者の連携が容易になります。</li>
-<li>便利なウェブコントロール - PRADO ではとても便利なウェブコントロールがいくつも用意されており、インタラクティブなウェブページをほんの数行のコードで作成することができます。例えば DataGrid コントロールを使用すると、ページングやソート、編集、行の削除が可能なテーブルを表示するページをすぐに作成することができます。</li>
-
-<li>バージョン3.1から、PRADOはデータベースアクセス機能をサポートがしています。開発者はビジネスロジックの複雑さに応じて、シンプルな PDO ベースのデータベースアクセス、広く知られているアクティブレコードによるデータベースアクセス、複雑なビジネスオブジェクトとスキーマとのマッピングをサポートした SqlMapによるデータベースアクセスという３つの中から選択する事ができます。はどうでしょう。
-</li>
-
-<li>AJAX サポート - バージョン3.1から、アクティブコントロールが実装されました。開発者は javascript のコードを一行も書くことなく、AJAXを利用する事ができます。アクティブコントロールの利用は、通常のコントロールの利用方法とまったく変わらずに行う事ができます。</li>
-<li>I18N/L10N サポート - PRADO では国際語化ならびにローカライズに対応しています。</li>
-<li>XHTML 対応 - PRADO で生成されたウェブページは XHTML に対応しています。</li>
-<li>既存技術の利用が可能 - PRADO はプレゼンテーション層にターゲットを当てたフレームワークです。ほとんどの既存クラスライブラリやツールをそのまま利用する事ができます。例として、AdoDB や Creole なども PRADO アプリケーションで利用する事ができます。</li>
-<li>その他の機能 - エラーハンドリングとメッセージのロギング機能、キャッシング機構、エラーハンドリングのカスタム、ローカライズ、拡張可能な認証機能、クロスサイトサイトスクリプティング等のセキュリティに対応、クッキー保護等</li>
-</ul>
-
-<h2 id="203">PRADO での開発はどの場面が適していますか？</h2>
-<p id="20009" class="block-content">
-PRADO はインタラクティブなウェブアプリケーションを開発するのにとても適しています。コンテンツ管理システム（CMS）や、Eコマースなどの複雑なシステムを比較的容易に開発する事ができます。PRADO はコンポーネントベースのオブジェクト指向プログラミングですので、企業等でのチーム開発で力を発揮します。
-</p>
-<p id="20011" class="block-content">
-PRADO はアプリケーションの高速化とスケーラビリティを実現するためのキャッシュ機構を実装しています。利用する環境によりキャッシュモジュールを選択し、PRADO アプリケーションで利用する事ができます。出力キャッシュは、レンダリングされたウェブページの一部をキャッシュとして保存しておき、再度レンダリングする際に自動的にキャッシュから取得する機構になっています。
-</p>
-
-<h2 id="204">PRADO は他のフレームワークと比較してどのような点が異なっていますか？</h2>
-<p id="20012" class="block-content">
-PRADO はよくユニークなフレームワークと呼ばれています。コンポーネントベースとイベントドリブンな実装が特にユニークであるとされています。このプログラミング方法はデスクトップアプリケーション開発においては新しくはなく、いくつかのウェブプログラミング言語でも実装されていますが、PHP のフレームワークとしてはおそらく初めて実装されたフレームワークです。
-</p>
-<p id="20013" class="block-content">
-ほとんどの PHP フレームワークでは、画面表示部分とロジック部分を分離することに着目し、そのためにMVCデザインパターンで開発することを推奨しています。一方PRADOでは、テンプレートの中に画面表示部分を、クラスにロジック部分を記述することで、自然に同様の目標を達成する事ができています。そして、MVCでは実現できなかったコンポーネントベースのプログラミングスタイル、豊富なウェブコントロール、強力なデータベースサポート、柔軟なエラー処理とロギング機能などの色々な機能を実装することができています。
-</p>
-
-<h2 id="4004">PRADO は安定していますか？</h2>
-<p id="20004" class="block-content">
-はい。PRADO は2004年8月に初めてリリースされました。品質を確保するために多くのテストプログラムが作成されており、何千人もの開発者が利用しています。このテストプログラムによるテストを重ねて、フレームワークは開発されており、バグや機能追加などは TRAC システムにより管理されています。そして、すべての開発者の疑問にスピーディーに回答できるようにコミュニティも用意してあります。
-</p>
-
-<h2 id="205">PRADO の歴史</h2>
-<p id="20014" class="block-content">
-PRADO のユニークな発想は Apache Tapestry から生まれました。設計と実装には、Borland Delphi と Microsoft ASP.NET から多くのアイディアを借りました。PRADO の最初のバージョンは、2004年6月にできて、PHP4で書かれていましたが、Zend PHP5コンテストに応募するためにPHP5のコードに書き直しました。（PHP5から提供されたオブジェクトモデルはとても助けになりました）そして PRADO は Zend コンテストで観客・審査員の高い評価を得て特賞を勝ち取りました。
-</p>
-<p id="20015" class="block-content">
-2004年8月にオープンソースプロジェクトとして SourceForge にて提供され始め、そのすぐ後にプロジェクトサイト「<a href="http://www.xisc.com/">xisc.com</a>」が公開されました。PRADO 開発チームと PRADO ユーザーのサポートにより、PRADO は2005年中頃にバージョン2.0へとバージョンアップしました。このバージョンでは Wei Zhuo が I18N/L10N サポートの実装で貢献をしました。
-</p>
-<p id="20016" class="block-content">
-2005年5月に、バージョン2.0で見つかった問題点を解決し、さらに Microsoft ASP.NET2.0 で利用可能ないくつかの機能を実装するために PRADO フレームワークを完全に書き直す決定をしました。1年近い期間をかけて、新たに50,000行を超える新しいコードを追加し、2006年4月にバージョン3.0をリリースしました。
-</p>
-<p id="20017" class="block-content">
-バージョン3.0では、PRADO の品質と安定性を確実にするために多くの時間を当てています。
-そして私たちは、PRADO 2.x/1.x においてそのコンセプトの正しさが証明され、PRADO 3.x において重要なビジネスアプリケーションの開発に適したフレームワークにまで成長したと私たちは確信しています。
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/CommandLine.page b/demos/quickstart/protected/pages/GettingStarted/ja/CommandLine.page deleted file mode 100755 index 5f5dacb9..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/ja/CommandLine.page +++ /dev/null @@ -1,106 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="501">Command Line Tool</h1>
-<p id="70046" class="block-content">The optional <tt>prado-cli.php</tt> PHP script file in the <tt>framework</tt>
-directory provides command line tools to perform various tedious takes in Prado.
-The <tt>prado-cli.php</tt> can be used to create Prado project skeletons, create
-initial test fixtures, and access to an interactive PHP shell.
-</p>
-<h2 id="502">Requirements</h2>
-<p id="70047" class="block-content">
-To use the command line tool, you need to use your command prompt, command console
-or terminal. In addition, PHP must be able to execute PHP scripts from
-the command line.
-</p>
-
-<h2 id="503">Usage</h2>
-<p id="70048" class="block-content">
-If you type <tt>php path/to/framework/prado-cli.php</tt>, you should see
-the following information. Alternatively, if you are not on Windows,
-you may try to change the <tt>prado-cli.php</tt> into an executable
-and execute it as a script</p>
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70006">
-Command line tools for Prado 3.0.5.
-usage: php prado-cli.php action <parameter> [optional]
-example: php prado-cli.php -c mysite
-
-actions:
- -c <directory>
- Creates a Prado project skeleton for the given <directory>.
-
- -t <directory>
- Create test fixtures in the given <directory>.
-
- shell [directory]
- Runs a PHP interactive interpreter. Initializes the Prado
- application in the given [directory].
-</com:TTextHighlighter>
-
-<p id="70049" class="block-content">The <b><parameter></b> are required parameters and <b>[optional]</b>
-are optional parameters. </p>
-
-<h2 id="504">Creating a new Prado project skeleton</h2>
-
-<p id="70050" class="block-content">To create a Prado project skeleton, do the following:</p>
-<ol>
- <li>Change to the directory where you want to create the project skeleton.</li>
- <li>Type, <tt>php ../prado/framework/prado-cli.php -c helloworld</tt>, where
- <tt>helloworld</tt> is the directory name that you want to create the project skeleton files.</li>
- <li>Type, <tt>php ../prado/framework/prado-cli.php <b>-t</b> helloworld</tt> to create
- the test fixtures for the <tt>helloworld</tt> project.</li>
-</ol>
-
-<h2 id="505">Interactive Shell</h2>
-<p id="70051" class="block-content">
-The interactive shell allows you to evaluate PHP statements from the command line.
-The <tt>prado-cli.php</tt> script can be used to start the shell and load an existing
-Prado project. For example, let us load the blog demo project. Assume that your
-command line is in the <tt>prado</tt> distribution directory and you type.
-</p>
-<p id="70052" class="block-content">
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70007">
-$: php framework/prado-cli.php shell demos/blog
-</com:TTextHighlighter>
-The output should be
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70008">
-Command line tools for Prado 3.0.5.
-** Loaded Prado application in directory "demos\blog\protected".
-PHP-Shell - Version 0.3.1
-(c) 2006, Jan Kneschke <jan@kneschke.de>
-
->> use '?' to open the inline help
-
->>
-</com:TTextHighlighter>
-Then we will get an instance of the Prado blog application, and from
-that instance we want an instance of the <tt>'data'</tt> module. Notice that
-a <b>semicolon</b> at the end of the line <b>suppresses the output</b>.
-
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70009">
->> $app = Prado::getApplication();
-
->> $db = $app->getModule('data');
-</com:TTextHighlighter>
-Lastly, we want to use the data module to query for a post with <tt>ID=1</tt>. Notice that
-we <b>leave out the semicolon</b> to show the results.
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70010">
->> $db->queryPostByID(1)
-</com:TTextHighlighter>
-There should not be any errors and you should see the following.
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70011">
-PostRecord#1
-(
- [ID] => 1
- [AuthorID] => 1
- [AuthorName] => 'Prado User'
- [CreateTime] => 1148819691
- [ModifyTime] => 0
- [Title] => 'Welcome to Prado Weblog'
- [Content] => 'Congratulations! You have successfully installed Prado Blog --
- a PRADO-driven weblog system. A default administrator account has been created.
- Please login with <b>admin/prado</b> and update your password as soon as possible.'
- [Status] => 0
- [CommentCount] => 0
-)
-</com:TTextHighlighter>
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/HelloWorld.page b/demos/quickstart/protected/pages/GettingStarted/ja/HelloWorld.page deleted file mode 100755 index bc9cf264..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/ja/HelloWorld.page +++ /dev/null @@ -1,89 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="401">初めての PRADO アプリケーション</h1>
-<div id="hello1" class="block-content">
-<p id="50034">
-ここでは、初めて PRADO アプリケーションを開発する人のために、定番の "Hello World" アプリケーションを解説します。
-</p>
-<p id="50035">
-"Hello World" を作る事は、最もシンプルで<i>インタラクティブ</i>な PRADO アプリケーションを作る事かもしれません。<br />
-このアプリケーションは、ページに <tt>Click Me</tt> と書いてある送信ボタンを配置してあります。<br />
-ユーザーがボタンをクリックすると、ボタン文字が <tt>Hello World</tt> に変わるというアプリケーションです。
-</p>
-<p id="50036">
-このアプリケーションには、複雑なアプリケーションを作る上で重要なアプローチがいくつかあります。<br />
-ひとつは、ページからサーバーに変数を送信して、その変数を利用して新しいページ（新しいボタン）を生成していることです。<br />
-またもう一つは、Javascript の <tt>onclick</tt> を意識することなく利用し、ボタン文字を変更する事ができるということです。
-</p>
-</div>
-<p id="50037" class="block-content">
-PRADO ではコンポーネントベース、そしてイベントドリブンのウェブプログラミングを構築する事ができます。<br />
-ボタンは、<tt>TButton</tt> オブジェクトを使用します。
-<tt>TButton</tt> では <tt>Text</tt> プロパティがボタン文字となり、ユーザーのクリック動作をサーバーサイドの <tt>OnClick</tt> イベントに対応付けます。<br />
-<tt>Text</tt> プロパティを変更する内容を定義したメソッドを <tt>OnClick</tt> に対応付けるだけで、ボタンクリックのアクションを設定することができます。<br />
-以下にアプリケーションのシーケンスを示します。
-<img src="<%~sequence.gif%>" class="figure"/>
-</p>
-<p id="50038" class="block-content">
-このアプリケーションは3つのファイル <tt>index.php</tt>, <tt>Home.page</tt>, <tt>Home.php</tt> から構成されています。
-<img src="<%~directory.gif%>" class="figure"/>
-
-各ディレクトリ名は開発者によって変更する事が可能です。例えば <tt>protected</tt> ディレクトリはウェブサーバーにより公開されたディレクトリ以外の場所へ移動することができます。このチュートリアルを読む事で、その方法を修得する事ができます。
-</p>
-<ul id="dir-struct" class="block-content">
-<li><tt>assets</tt> - このディレクトリにはコンポーネントからファイルが展開されます。詳細は <a href="?page=Advanced.Assets">assets</a> に書かれていますのでご覧下さい。このディレクトリはウェブサーバープロセスから書き込み可能である事が必要となります。</li>
-<li><tt>protected</tt> - アプリケーションデータと開発したコードが保存されるディレクトリです。このディレクトリは閲覧者からのアクセスを禁止されているべきディレクトリです。</li>
-<li><tt>runtime</tt> - アプリケーション状態などのアプリケーション情報がキャッシュとして保存されるディレクトリです。このディレクトリはウェブサーバープロセスからの書き込みが可能でなければなりません。</li>
-<li><tt>pages</tt> - PRADO ページを保存するディレクトリです。</li>
-</ul>
-
-<div class="tip">
-<b class="tip">Tip:</b>PRADO プロジェクトディレクトリを作成するのに <tt>framework/prado-cli.php</tt>（<a href="?page=GettingStarted.CommandLine">コマンドラインスクリプト</a>）を使用することができます。<br />
-例えば、<tt>helloworld</tt> プロジェクトを作りたいディレクトリへ移動し、<tt>php path/to/prado-cli.php -c helloworld</tt> とコマンド入力する事で、<tt>helloworld</tt> プロジェクトディレクトリを作成する事ができます。
-</div>
-
-<p id="50040">
-アプリケーションの実行に必要な3つのファイルの内容は以下のとおりです。
-</p>
-<ul id="file-list" class="block-content">
-<li><tt>index.php</tt> - PRADO アプリケーションのエントリースクリプトです。このファイルは、PRADO アプリケーションでは必ず必要なファイルであり、唯一エンドユーザーが直接アクセスできるスクリプトファイルです。<tt>index.php</tt> の内容は主に以下の3つの項目からなっています。
-<com:TTextHighlighter CssClass="source block-content" id="code_50003">
-require_once('path/to/prado.php'); // PRADO スクリプトの読み込み
-$application=new TApplication; // PRADO アプリケーションインスタンスの作成
-$application->run(); // アプリケーション実行
-</com:TTextHighlighter>
-</li>
-<li><tt>Home.page</tt> - エンドユーザーが明示的にページを指定しない場合にこのページテンプレートが呼び出されます。テンプレートファイルでは、コンポーネントのレイアウトを定義します。この例では、<tt>TForm</tt> と <tt>TButton</tt> を使用しており、それぞれ<form> <input> のHTMLタグに対応しています。
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_50004">
-<html>
- <body>
- <com:TForm>
- <com:TButton Text="Click me" OnClick="buttonClicked" />
- </com:TForm>
- </body>
-</html>
-</com:TTextHighlighter>
-</li>
-<li><tt>Home.php</tt> - <tt>Home</tt> テンプレートファイルのクラス定義ファイルです。ここではボタンの <tt>OnClick</tt> イベント内容の定義を行っています。
-<com:TTextHighlighter CssClass="source block-content" id="code_50005">
-class Home extends TPage
-{
- public function buttonClicked($sender,$param)
- {
- // $sender refers to the button component
- $sender->Text="Hello World!";
- }
-}
-</com:TTextHighlighter>
-</li>
-</ul>
-<div id="hello-end" class="block-content">
-<p id="50041">
-アプリケーションファイルの準備ができたら、次のURLからアクセスすることができます。 <tt>http://Web-server-address/helloworld/index.php</tt><br />
-この例では<tt>ドキュメントルート</tt>配下に <tt>helloworld</tt> というディレクトリを配置しています。<tt>Home.page</tt> テンプレートファイル内の <tt>TButton</tt> を <tt>TLinkButton</tt> へ変更してみてどのようになるかも試してみてください。
-</p>
-<p id="50042">
-PRADO リリースアーカイブファイルにこのデモのソースを格納しています。また、<a href="http://www.pradosoft.com/demos/helloworld/">オンラインデモ</a>にて動作を確認する事ができます。
-</p>
-</div>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/Installation.page b/demos/quickstart/protected/pages/GettingStarted/ja/Installation.page deleted file mode 100755 index b0c35205..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/ja/Installation.page +++ /dev/null @@ -1,33 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="301">PRADO のインストール</h1>
-<div id="install-info" class="block-content">
-<p id="30018">
-ご自分で管理されているサーバーをお持ちであれば、すぐにインストールすることが可能です。
-</p>
-<p id="30019">
-PRADO の最小構成は、サーバーがPHP5をサポートしていることです。<br />
-PRADO は Windows と Linux 両環境の Apache サーバーでテストされています。<br />
-PHP5 がサポートされているのであれば、他の環境でも動作させることができるかもしれません。
-</p>
-</div>
-
-<div id="install-steps" class="block-content">
-<p id="30020">
-PRADO のインストールは、PRADO をダウンロードし解凍することが主な作業となります。
-</p>
-<ol>
-<li><a href="http://www.pradosoft.com/">PRADO公式ページ</a>からPRADOの最新版をダウンロードします。</li>
-<li>ウェブアクセス可能なディレクトリに展開します。</li>
-</ol>
-</div>
-<div id="install-after" class="block-content">
-<p id="30021">
-上記の作業のみでPRADOのインストールが完了します。<br />
-<tt>http://web-server-address/prado/demos/</tt> 以下にPRADOデモアプリケーションが展開されますので、PRADOを利用したアプリケーションの動作を体験する事ができます。<br />
-デモアプリケーションの動作が確認できていれば、<tt>DocumentRoot</tt> 配下に <tt>prado</tt> サブディレクトリが展開されたことになりますので、インストールは正常に完了しております。
-</p>
-<p id="30022">
-もしデモアプリケーションが動作しない等の問題が発生しましたら、サーバー構成がPRADO必要条件を満たしているかどうかを確認する事ができるスクリプト <tt>http://web-server-address/prado/requirements/index.php</tt> が用意されていますので、確認してください。
-</p>
-</div>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/Introduction.page b/demos/quickstart/protected/pages/GettingStarted/ja/Introduction.page deleted file mode 100755 index 832b5916..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/ja/Introduction.page +++ /dev/null @@ -1,62 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="101">ようこそ PRADO クイックスタートチュートリアルへ</h1>
-<div id="intro" class="block-content">
-<p id="10001">
-このチュートリアルはPRADO3.xを使ったアプリケーションをスピーディーに構築するためのものです。
-</p>
-<p id="10001" class="block-content">
-既にPRADO3.xを使用しており新しいバージョンで強化された機能を知りたい方は、まずは<a href="?page=GettingStarted.NewFeatures">新機能ページ</a>をご覧ください。PRADOを使用したことのない方にはこのチュートリアルはとても役立つものですので、ぜひご覧下さい。
-</p>
-<!--
-<div class="start-page">
- <div class="concepts start-block">
- <h2 id="2001">How PRADO Works</h2>
- <p id="10002" class="block-content">Concepts and fundamentals</p>
- <ol>
- <li><a href="#">Building web applications with PRADO</a></li>
- <li><a href="#">Web controls and events</a></li>
- <li><a href="#">Validating user input</a></li>
- <li><a href="#">Connecting to your database</a></li>
- <li><a href="#">Displaying data from database</a></li>
- </ol>
- </div>
- <div class="examples start-block">
- <h2 id="2002">Examples and Demos</h2>
- <ul>
- <li><a href="../helloworld/">Hello World</a></li>
- <li><a href="../currency-convert/">Currency Converter</a></li>
- <li><a href="../address-book/">Address Book</a></li>
- <li><a href="../blog/">Blog</a></li>
- <li><a href="../chat/">AJAX Chat</a></li>
- <li><a href="../time-tracker/">Project Time Tracker</a></li>
- </ul>
- <p id="10003" class="block-content">More examples in <a href="?page=Controls.Standard">Standard Controls</a>,
- <a href="?page=Controls.Validation">Validation Controls</a> and
- <a href="?page=Controls.Data">Data Controls</a>.
- </div>
-
- <div class="tutorials start-block">
- <h2 id="2003">Tutorials and Help</h2>
- <ul>
- <li><a href="?page=GettingStarted.HelloWorld">Hello World in detail</a></li>
- <li><a href="?page=Tutorial.CurrencyConverter">Currency Converter Tutorial</a></li>
- <li><a href="?page=Tutorial.AddressBook">Address Book Tutorial</a></li>
- <li><a href="?page=Tutorial.AjaxChat">AJAX Chat Tutorial</a></li>
- </ul>
- </div>
-</div>
--->
-
-<p id="10002">
-もしこのチュートリアルの内容では不十分と感じたら、以下リンクの各種資料もご覧ください。
-</p>
-</div>
-<ul class="block-content" id="intro-links">
- <li><a href="http://www.pradosoft.com/docs/classdoc/">PRADO Classes</a></li>
- <li><a href="http://www.pradosoft.com/docs/manual/">PRADO APIドキュメント</a></li>
- <li><a href="http://www.pradosoft.com/forum/">PRADO フォーラム</a></li>
- <li><a href="http://www.pradosoft.com/wiki/">PRADO Wiki</a></li>
- <li><a href="http://trac.pradosoft.com/prado/">PRADO Trac</a></li>
-</ul>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/NewFeatures.page b/demos/quickstart/protected/pages/GettingStarted/ja/NewFeatures.page deleted file mode 100755 index f2fdc618..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/ja/NewFeatures.page +++ /dev/null @@ -1,35 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="8005">新機能</h1>
-
-<p id="40005" class="block-content">
-このページは、以下バージョンの PRADO に含まれる新機能の概要を紹介するページです。
-</p>
-
-<h2 id="8006">バージョン 3.1.0</h2>
-<ul>
-
-<li>AJAXサポート<br />
-全てのコントロールにて Ajaxが有効になりました。（アクティブコントロール - active controls）<br />
-アクティブコントロールは、通常のコントロールととても似た作りになっています。<br />
-使用方法の詳細はチュートリアル <a href="?page=ActiveControls.Home">アクティブコントロール</a> をご覧下さい。</li>
-
-<li>データベース連携サポートの完成 </li>
-<li>新しいコントロール/モジュール/サービスを追加<br />
-<a href="?page=Services.SoapService">TSoapService</a>, <a href="?page=Controls.OutputCache">TOutputCache</a>, TSessionPageStatePersister, TFeedService, TJsonService, cache dependency classes, TXmlTransform.
-</li>
-
-<li>データコントロールの描画エンジンを改善<br />
-データコントロールにて、アイテムテンプレートを再利用して描画するよう改善しました。<br />
-<tt>TRepeater</tt>, <tt>TDataList</tt>, <tt>TDataGrid</tt> などのコントロールでの構成がクリアなコードになりました。<br />
-チュートリアルが更新されているので、詳細はチュートリアル <a href="?page=Controls.Repeater"><tt>TRepeater</tt></a>, <a href="?page=Controls.DataList"><tt>TDataList</tt></a>, <a href="?page=Controls.DataGrid"><tt>TDataGrid</tt></a> をご覧下さい。</li>
-
-<li>アプリケーション構造ファイルにて外部ファイル設定をサポート<br />
-<a href="?page=Configurations.AppConfig">アプリケーション構造</a>を外部ファイルにも定義できるようになり、<a href="?page=Configurations.Templates1">テンプレート</a>での定義など柔軟なアプリケーション定義ができるようになりました</li>
-
-<li>TDbUserManager / TDbUser によるシンプルなユーザー認証<br />
-<a href="?page=Advanced.Auth">認証</a>処理時のユーザーアカウントをデータベースに簡単に保存できるようになりました。</li>
-
-</ul>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/Upgrading.page b/demos/quickstart/protected/pages/GettingStarted/ja/Upgrading.page deleted file mode 100755 index 9ad1f003..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/ja/Upgrading.page +++ /dev/null @@ -1,64 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="501">Upgrading from v2.x and v1.x</h1>
-
-<div id="from-2-or-1" class="block-content">
-<p id="40023">
-PRADO v3.0 is NOT backward compatible with earlier versions of PRADO.
-</p>
-<p id="40024">
-A good news is, properties and events of most controls remain intact, and the syntax of control templates remains largely unchanged. Therefore, developers' knowledge of earlier versions of PRADO are still applicable in v3.0.
-</p>
-<p id="40025">
-We summarize in the following the most significant changes in v3.0 to help developers upgrade their v2.x and v1.x PRADO applications more easily, if needed.
-</p>
-</div>
-
-<h2 id="502">Component Definition</h2>
-<p id="40026" class="block-content">
-Version 3.0 has completely discarded the need of component specification files. It relies more on conventions for defining component properties and events. In particular, a property is defined by the existence of a getter method and/or a setter method, while an event is defined by the existence of an <tt>on</tt>-method. Property and event names in v3.0 are both case-insensitive. As a consequence, developers are now required to take care of type conversions when a component property is being set. For example, the following code is used to define the setter method for the <tt>Enabled</tt> property of <tt>TControl</tt>, which is of <tt>boolean</tt> type,
-</p>
-<com:TTextHighlighter Language="php" CssClass="block-content source" ID="code1">
-public function setEnabled($value)
-{
- $value=TPropertyValue::ensureBoolean($value);
- $this->setViewState('Enabled',$value,true);
-}
-</com:TTextHighlighter>
-<p id="40027" class="block-content">
-where <tt>TPropertyValue::ensureBoolean()</tt> is used to ensure that the input value be a boolean. This is because when the property is configured in template, a string value is passed to the setter. In previous versions, PRADO knows the property type based on the component specification files and does the type conversion for you.
-</p>
-
-<h2 id="503">Application Controller</h2>
-<p id="40028" class="block-content">
-Application controller now implements a modular architecture. Modules can be plugged in and configured in application specifications. Each module assumes a particular functionality, and they are coordinated together by the <a href="?page=Fundamentals.Applications">application lifecycle</a>. The concept of v2.x modules is replaced in v3.0 by <a href="?page=Configurations.PageConfig">page directories</a>. As a result, the format of v3.0 <a href="?page=Configurations.AppConfig">application specification</a> is also different from earlier versions.
-</p>
-
-<h2 id="504">Pages</h2>
-<p id="40029" class="block-content">
-Pages in v3.0 are organized in directories which may be compared to the module concept in v2.x. Pages are requested using the path to them. For example, a URL <tt>index.php?page=Controls.Samples.Sample1</tt> would be used to request for a page named <tt>Sample1</tt> stored under the <tt>[BasePath]/Controls/Samples</tt> directory, where <tt>[BasePath]</tt> refers to the root page path. The file name of a page template must be ended with <tt>.page</tt>, mainly to differentiate page templates from non-page control templates whose file names must be ended with <tt>.tpl</tt>.
-</p>
-
-<h2 id="505">Control Relationship</h2>
-<p id="40030" class="block-content">
-Version 3.0 redefines the relationships between controls. In particular, the parent-child relationship now refers to the enclosure relationship between controls' presentation. And a new naming-container relationship is introduced to help better manage control IDs. For more details, see the <a href="?page=Fundamentals.Controls">controls</a> section.
-</p>
-
-<h2 id="506">Template Syntax</h2>
-<div id="template-syntax" class="block-content">
-<p id="40031">
-The syntax of control templates in v3.0 remains similar to those in earlier versions, with many enhancements. A major change is about the databinding expression. In v3.0, this is done by the following,
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_40002">
-<com:MyComponent PropertyName=<%# PHP expression %> .../>
-</com:TTextHighlighter>
-<p id="40032">
-Expression and statement tags are also changed similarly. For more details, see the <a href="?page=Configurations.Templates1">template definition</a> section.
-</p>
-</div>
-<h2 id="507">Theme Syntax</h2>
-<p id="40033" class="block-content">
-Themes in v3.0 are defined like control templates with a few restrictions.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/directory.gif b/demos/quickstart/protected/pages/GettingStarted/ja/directory.gif Binary files differdeleted file mode 100755 index e6c4f724..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/ja/directory.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/GettingStarted/ja/sequence.gif b/demos/quickstart/protected/pages/GettingStarted/ja/sequence.gif Binary files differdeleted file mode 100755 index 4207a9bb..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/ja/sequence.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/GettingStarted/pl/AboutPrado.page b/demos/quickstart/protected/pages/GettingStarted/pl/AboutPrado.page deleted file mode 100755 index 023a9fe1..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/pl/AboutPrado.page +++ /dev/null @@ -1,71 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="201">Czym jest PRADO?</h1>
-<p id="20003" class="block-content">
-PRADO jest napisanym w PHP5 frameworkiem dla aplikacji webowych opartym na komponentach oraz programowaniu zdarzeniowym (<i>ang. event-driven programming</i>).
-PRADO z angielskiego oznacza <b>P</b>HP <b>R</b>apid <b>A</b>pplication <b>D</b>evelopment <b>O</b>bject-oriented (przyp. tłum. <i>szybkie tworzenie aplikacji zorientowanych obiektowo w PHP</i>).
-</p>
-<p id="20004" class="block-content">
-Głównym celem PRADO jest zmaksymalizowanie ponownego wykorzystania kodu (ang. <i>reusability</i> w programowaniu webowym. Poprzez ponowne wykorzystanie kodu rozumiemy nie tylko ponowne używanie własnego kodu ale również ponowne używanie w prosty sposób tego kodu przez inne osoby. To drugie jest bardziej ważne, gdyż oszczędza niepotrzebny wysiłek włożony w ponowne odkrywanie koła i może znacznie zmniejszyć czas developmentu. Taka jest właśnie intencja zastosowania koncepcji komponentów.
-</p>
-<p id="20005" class="block-content">
-Aby osiągnąć powyższe cele, PRADO wymaga protokołu pisania i używania komnponentów do konstrukcji aplikacji webowych. Komponent jest jednostką programowania, która jest samowystarczalna i może być użyta ponownie poprzez proste dostosowanie (ang. <i>trivial customization</i>). Nowy komponent może zostać stworzony jako prosta kompozycja istniejących komponentów.
-</p>
-<p id="20006" class="block-content">
-Aby ułatwić interakcję z komponentami, PRADO implementuje paradygmat programowania sterowanego zdarzeniami (ang. <i>event-driven programming paradigm</i>), który umożliwia elastyczne przekierowanie zachowania do komponentu. Czynności użytkownika końcowego, takie jak kliknięcie na przycisk (ang. <i>submit button</i>), są przechwytywane jako zdarzenia serwera. Zarówno metody jak i funkcje mogą być przypisane do tych zdarzeń. W chwili gdy takie zdarzenie występuje są one (metody, funkcje) automatycznie wywoływane w odpowiedzi na zdarzenie. W porównaniu do tradycyjnego programowania, w których developerzy muszą zmagać się z surowymi zmiennymi POST i GET, programowanie zdarzeniowe pomaga developerom lepiej skupić się na niezbędnej logice i poważnie zredukować nispoziomowe powtarzające się kodowanie.
-</p>
-<p id="20007" class="block-content">
-Sumując, tworzenie w PRADO aplikacji sieciowych, polega głównie na tworzeniu instancji różnego typu wbudowanych komponentów, konfigurowania ich, odpowiadania na ich zdarzenia poprzez przypisanie im uchwytów funkcji oraz wkomponowanie ich w stronę aplikacji. Jest to bardzo podobne do narzędzi RAD, takich jak Borland Delphi, czy też Microsoft Visual Basic, które używane są do tworzenia desktopowych aplickacji GUI (ang. <i>develop GUI application</i>).
-</p>
-
-<h2 id="202">Dlaczego PRADO?</h2>
-<p id="20008" class="block-content">
-PRADO jest najczęściej postrzegane jako jedyny w swoim rodzaju framework. W rzeczy samej, jest on tak unikatowy, że może zamienić nużące programowanie w PHP w przyjemną zabawę. Poniższa lista jest krótkim podsumowaniem, głównych możliwości (cech) PRADO.
-</p>
-<ul id="prado-features" class="block-content">
-<li>Ponowne wykorzystanie kodu (ang. <i>Reusability</i>) - kod zgodny z protokołem komponentów PRADO jest wysoce wielokrotnie używalny. To przynosi korzyści zespołom developerów w dłuższej prespektywie czasowej, gdyż mogą oni ponownie używać swoje poprzednio wykonane prace oraz łatwo integrować rozwiązania stron trzecich.</li>
-<li>Programowanie zdarzeniowe - czynności użytkownika końcowego, takie jak kliknięcie na [submit button], są przechwytywane jako zdarzenia serwera, w ten sposób developerzy lepiej skupiają się na działaniach związanych z interakcją użytkownika.</li>
-<li>Grupowa integracja - warstwa prezentacji i logiki są rozdzielone. W aplikacjach PRADO można stosować motywy.</li>
-<li>Wszechstronne kotnrolki webowe - PRADO składa się z zestawu wszechstronnych komponentów mających do czynienia z interfejsem użytkownika. Wysoko interaktywne strony internetowe, mogą być stworzone za pomocą kilku linijek kodu. Na przykład, użycie komponentu datagrid (przyp. tłum. <i>z and. data - dane, grid - siatka</i>), może szybko stworzyć stronę prezentującą tabelę z danymi, krórą można posortować, stronicowac, edytować oraz usuwać wiersze danych.
-<li>Silne wsparcie dla baz danych - od wersji 3.1, PRADO zostało wyposażone w kompletną obsługę baz danych, własnoręcznie napisaną, dzięki czemu odpowiednio współgrającą z pozostałymi elementami frameworku PRADO. W zależności od złożoności obiektów biznesowych, każdy może wybrać pomiędzy używaniem prostego, bazujacego na PDO dostępie do danych lub powszechnie znanym wzorcem Active Record lub też kompletnym schematem mapowania obiektów biznesowych SqlMap.</li>
-<li>Jednolite wsparcie dla AJAXA - Używanie AJAX-a w PRADO nigdy nie było łatwiejsze. Wraz ze swym innowacymi aktywnymi kontrolkami (ang. <i>active controls</i>) wprowadzonymi w wersji 3.1 możesz łatwo napisać aplikację używającą AJAX-a bez napisania nawet linijki kodu w Java Skrypcie. W rzeczy samej, używanie kontrolek aktywnych, prawie nie różni się w użyciu od zwykłych nieAJAX-owych kontrolek webowych.</li>
-<li>Wsparcie dla I18N oraz L10N - PRADO zawiera kompletne wsparcie dla tworzenia aplikacji wielojęzycznych i lokalnych</li>
-<li>Zgodność z XHTML - Strony internetowe generowanie przez PRADO są zgodne z XHTML.</li>
-<li>Przystosowanie istniejących prac - PRADO jest ogólnym frameworkiem skupiającym się na warstwie prezentacyjnej. Nie pozbawia on developerów możliwości używania istniejących bibliotek klas czy też narzędzi. Na przykład, kazdy może używać AdoDB czy też Creole do obsługi baz danych w aplikacjach PRADO.
-ś<li>Pozostałe cechy - Wszechstronna obsługa błędów/wyjątków oraz logowania komunikatów; standardowe keszowanie oraz selektywne kaszowanie danych wyściowych; rozszerzalna oraz lokalizowalna obsługa błędów; elastyczna autentykacja oraz autoryzacja; przedsięwzięcie króków chroniących przed atakami cross-site script (XSS), ochrona plików cookie, itd.</li>
-</ul>
-
-<h2 id="203">Do czego najlepiej nadaje się PRADO?</h2>
-<p id="20009" class="block-content">
-Stosowanie PRADO jest najbardziej wskazane w aplikacjach internetowych, które są wysoce interaktywne z użytkownikiem. Może być wykorzystywane do tworzenia systemów tak prostych jak internetowe blogi po kompleksowe rozwiązania e-commerce. Ponieważ PRADO wspiera programowanie zorietnowane obiektowo (OOP) poprzez własną metodologię, bazująca na komponentach, pasuje ono ekstremalnie dobrze do pracy grupowej oraz tworzenia aplikacji klasy enterprise (ang. <i>enterprise development</i>).
-</p>
-<p id="20011" class="block-content">
-PRADO przychodzi z kompletnym zestawem technik keszowania, które pomagają przyśpieszyć aplikacje internetowe PRADO, by móc zastosować je do aplikacji o wysokim ruchu. Jego modularna architektura umożliwia developerom używanie oraz podłączanie różnych modułów keszujących w zależności od potrzeb. Keszowanie wyjścia umożliwia każdemu selektywny wybór keszowania części wyświetlanej strony.
-</p>
-
-<h2 id="204">Jak PRADO reprezentuje się na tle innych frameworków?</h2>
-<p id="20012" class="block-content">
-PRADO często jest postrzegane jako jedyny w swoim rodzaju framework. Jego unikatowość polega głównie na programowaniu bazującym na komponentach oraz paradygmacie programowania sterowanego zdarzeniami, które stara się promować. Chociaż ten paradygmat nie jest nowością w aplikacjach desktopowych oraz nie jest nowy w kilku językach programowania webowego, PRADO jest prawdopodobnie pierwszym frameworkiem umożliwiającym go.
-</p>
-<p id="20013" class="block-content">
-Większość frameworków PHP skupia się głównie na odseparowaniu warstwy prezentacji i logiki promując wzorzec programowania MVC (przyp. tłum. od pierwszych liter <i>model</i> - model <i>view</i> - widok <i>controler</i> - kontroler). PRADO osiąga te same cele naturalnie poprzez potrzebę prechowywania logiki w klasach a prezetnacji w szablonach (ang. <i>templates</i>). PRADO robi dużo więcej w sprawach innych niż MVC. Wypełnia wiele białych plam w programowaniu webowym w PHP, swoim bazującym na komponentach paradygmacie programowania, jego bogatym zestawem kontrolek webowych, jego wszechstronną obsługą baz danych, jego elastyczną obsługą błędów oraz ich logowania oraz wiele wiele innych.
-</p>
-
-<h2 id="4004">Czy PRADO jest wystarczająco stabilne?</h2>
-<p id="20004" class="block-content">
-Tak. PRADO zostało pierwszy raz opublikowane w sierpniu 2004 roku. Wiele zestawów testów zostało od tego czasu napisanych oraz często przeprowadzanych by upewnić sie o jakości PRADO. Framework był używany przez tysiące użytkowników oraz developerów a wiele aplikacji internetowych powstało w oparciu o niego. Bugi oraz żądania rozszerzeń są zarządzane poprzez system TRAC, posiadamy także wspaniałą społeczność użytkowników oraz zespół developerów by być pewnym, że żadne pytanie nie pozostanie bez odpowiedzi.
-</p>
-
-<h2 id="205">Historia PRADO</h2>
-<p id="20014" class="block-content">
-Pierwotna inspiracja PRADO pochodziła od Apache Taperstry. W trakcie projektowania i implementacji, zapożyczyłem wiele idei z Borland Delphi oraz Microsodt ASP.NET. Pierwsza wersja PRADO ujrzała świat w czerwcu 2004 roku i została napisana w PHP4. Zachęcony konkursem kodowania w PHP5 Zenda, przepisałem PRADO do PHP5, co okazało się mądrym posunięciem, dzięki nowemu modelowi obiektowemu dostarczonemu przez PHP5. PRADO zdobyło główną nagrodę w konkrusie Zenda, uzyskując najwięcej głosów zarówno wsród publiczności jak i wśród sędziów.
-</p>
-<p id="20015" class="block-content">
-W sierpniu 2004, PRADO zaczęło być hostowane przez SourceForge jako projekt open source. Wkrótce, stona projektu <a href="http://www.xisc.com/">xisc.com</a> została zaprezentowana publicznie. Wraz z fantastycznym wparciem zespołu developerów PRADO oraz jego użytkowników, PRADO rozwinęło się do wersji 2.0 w połówie 2005 roku. W tej wersji, Wei Zhuo dołączył do PRADO ze znakomita opbsługą dla I18N oraz L10N.
-</p>
-<p id="20016" class="block-content">
-W maju 2005, zdecydowaliśmy się całkowicie przepisać framewrork PRADO, by rozwiązać kilka kluczowych kwestii z wersji 2.0 oraz by porwać kilka fajnych możliwości dostępncyh w Microsoft ASP.NET. Po około roku ciężkiej pracy z ponad 50.000 liniami nowego kodu, wersja 3.0 została w końcu udostępniona w kwietniu 2006r.
-</p>
-<p id="20017" class="block-content">
-Poczynając od wersji 3.0, znaczny nakład jest kładziony by zapewnić jakość oraz stabilność PRADO. Jeśli powiemy, że PRADO w wersjach 2.x oraz 1.x były dziełem potwierdzającym koncept (ang. <i>proof-of-concept work</i>), możemy powiedzieć, że PRADO 3.X wyrosło na projekt, który jest odpowiedni dla tworzenia plikacji biznesowych.
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/pl/CommandLine.page b/demos/quickstart/protected/pages/GettingStarted/pl/CommandLine.page deleted file mode 100755 index f0edb39a..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/pl/CommandLine.page +++ /dev/null @@ -1,101 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="501">Narzędzie linii poleceń</h1>
-<p id="70046" class="block-content">Opcjonalny plik skryptu PHP <tt>prado-cli.php</tt> PHP w folderze <tt>framework</tt>
-dostarcza narzędzia linii poleceń do wykonywania różnych monotonnych czynności w PRADO.
-<tt>Prado-cli.php</tt> może zostać użyte do stworzenia szkieletu projektu PRADO, zainicjowania testów oraz uzyskania dostępu do
-interaktywnej powłoki PHP.
-</p>
-<h2 id="502">Wymagania</h2>
-<p id="70047" class="block-content">
-Aby używać narzędzia linii poleceń powinieneś użyć terminala, consoli komend lub opcji uruchom. Dodatkowo PHP musi mieć możliwość
-wykonywania skryptów PHP z linii poleceń.
-</p>
-
-<h2 id="503">Używanie</h2>
-<p id="70048" class="block-content">
-Wpisując <tt>php ścieżka/do/katalogu/framework/prado-cli.php</tt>, powinieneć zobaczyć następujace informacje.
-Alternatywnie, jeśli nie używasz Windowsa możesz spróbować zamienić <tt>prado-cli.php</tt> na plik wykonywalny
-i wywołać go jako skrypt.</p>
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70006">
-Command line tools for Prado 3.0.5.
-usage: php prado-cli.php action <parameter> [optional]
-example: php prado-cli.php -c mysite
-
-actions:
- -c <directory>
- Creates a Prado project skeleton for the given <directory>.
-
- -t <directory>
- Create test fixtures in the given <directory>.
-
- shell [directory]
- Runs a PHP interactive interpreter. Initializes the Prado
- application in the given [directory].
-</com:TTextHighlighter>
-
-<p id="70049" class="block-content"><b><parameter></b> są wymaganymi parametrami a <b>[optional]</b>
-są parametrami opcjonalnymi. </p>
-
-<h2 id="504">Tworzenie szkieletu nowego projektu PRADO</h2>
-
-<p id="70050" class="block-content">Aby stworzyć szkielekt projektu Prado, wykonaj następujące czynności:</p>
-<ol>
- <li>Przejdź do folderu gdzie chcesz utworzyć szkielet projektu.</li>
- <li>Wpisz <tt>php ../prado/framework/prado-cli.php -c helloworld</tt>, gdzie
- <tt>helloworld</tt> jest nazwą katalogu w której chcesz utworzyć pliki należace do szkieletu projektu.</li>
- <li>Wpisz <tt>php ../prado/framework/prado-cli.php <b>-t</b> helloworld</tt> aby stworzyć wbudowany test dla projektu <tt>helloworld</tt> (Witaj Świecie).</li>
-</ol>
-
-<h2 id="505">Interaktywna powłoka</h2>
-<p id="70051" class="block-content">
-Interaktywna powłoka umożliwia Ci wykonywanie wyrażeń PHP z linii poleceń.
-Skrypt <tt>prado-cli.php</tt> może zostać użyty do uruchomienia powłoki i załadowania istniejącego projektu Prado.
-Dla przykładu załadujmy projekt demo blogu. Zakładając, że twoja linia poleceń jest w katalogu żródłowym <tt>prado</tt> i wpiszesz...
-</p>
-<p id="70052" class="block-content">
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70007">
-$: php framework/prado-cli.php shell demos/blog
-</com:TTextHighlighter>
-jako rezultat powinieneś ujrzeć
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70008">
-Command line tools for Prado 3.0.5.
-** Loaded Prado application in directory "demos\blog\protected".
-PHP-Shell - Version 0.3.1
-(c) 2006, Jan Kneschke <jan@kneschke.de>
-
->> use '?' to open the inline help
-
->>
-</com:TTextHighlighter>
-Następnie pobierzemy instancję aplikacji blogu Prado a następnie z niej instancję modułu
- <tt>'data'</tt>. Zauważ, że <b>średnik</b> na koncu linii <b>wycisza wyjście</b>.
-
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70009">
->> $app = Prado::getApplication();
-
->> $db = $app->getModule('data');
-</com:TTextHighlighter>
-Na koniec będziemy chcieli użyć wybranego modułu aby zapytać o post o <tt>ID=1</tt>. Zauważ, że
-<b>pomijamy średnik</b> aby zobaczyć rezultat.
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70010">
->> $db->queryPostByID(1)
-</com:TTextHighlighter>
-Nie powinien wystąpić żaden błąd i powinieneś zobaczyć następujący reziltat
-<com:TTextHighlighter Language="cli" CssClass="source block-content cli" id="code_70011">
-PostRecord#1
-(
- [ID] => 1
- [AuthorID] => 1
- [AuthorName] => 'Prado User'
- [CreateTime] => 1148819691
- [ModifyTime] => 0
- [Title] => 'Welcome to Prado Weblog'
- [Content] => 'Congratulations! You have successfully installed Prado Blog --
- a PRADO-driven weblog system. A default administrator account has been created.
- Please login with <b>admin/prado</b> and update your password as soon as possible.'
- [Status] => 0
- [CommentCount] => 0
-)
-</com:TTextHighlighter>
-</p>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/pl/HelloWorld.page b/demos/quickstart/protected/pages/GettingStarted/pl/HelloWorld.page deleted file mode 100755 index c4a23059..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/pl/HelloWorld.page +++ /dev/null @@ -1,82 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="401">Moja pierwsza aplikacja w PRADO</h1>
-<div id="hello1" class="block-content">
-<p id="50034">
-W tej sekcji, przeprowadzimy Cię przez proces tworzenia Twojej pierwszej aplikcaji w PRADO, słynną aplikację "Witaj świecie" (ang. "Hello World").
-</p>
-<p id="50035">
-"Witaj świecie" prawdopodobnie jest najprostszą <i>interaktywną</i> aplikacją w PRADO, którą możesz stworzyć. Wyświetla ona użytkownikowu końcowemu stronę z przyciskiem, którego napis to <tt>Kliknij mnie</tt> (ang. Click Me). Po tym jak użytkownik kliknie na przycisk, jego napis zmienia się na <tt>Witaj świecie</tt>.
-</p>
-<p id="50036">
-Jest wiele dróg aby osiągnąć ten cel. Można przesłać (ang. <i>submit</i>) stronę do serwera, sprawdzić zmienną POST i wygenerować nową stronę z przyciskiem ze zaktualizowanym napisem. Można też przez proste użycie JavaScript zaktualizować napis podczas zdarzenia <tt>OnClick</tt> po stronie klienta.
-</p>
-</div>
-<p id="50037" class="block-content">
-PRADO promuje programowanie sterowane zdarzeniami i bazujące na komponentach. Przycisk jest reprezentowany przez obiekt <tt>TButton</tt>. Hermetyzuje on napis na przycisku jako właściwość <tt>Text</tt> przycisku oraz wiąże akcję naciśnięcia przez użytkownika przycisku ze zdarzeniem po stronie serwera <tt>OnClick</tt>. Aby odpowiedzieć na naciśnięcie przez użytkownika przycisku, należy po prostu przypisać funkcję do zdarzenia <tt>OnClick</tt> przycisku. Wewnątrz funkcji, właściwość <tt>Text</tt> przycisku jest zmodyfikowana na "Witaj świecie". Poniższy diagram pokazuje powyższą sekwencję.
-<img src="<%~sequence.gif%>" class="figure"/>
-</p>
-<p id="50038" class="block-content">
-Nasza aplikacja PRADO składa się z trzech plików <tt>index.php</tt>, <tt>Home.page</tt> and <tt>Home.php</tt>, które są zorganizowane w poniższy sposób,
-<img src="<%~directory.gif%>" class="figure"/>
-
-gdzie każdy katalog należy rozumieć następująco. Zauważ, że powyższa struktura katalogów jest rozszerzalna. Na przykład, można przenieść katalog <tt>protected</tt> poza katalog WWW. Będziesz wiedział jak tego dokonać, jeśli przejdziesz przez ten przewodnik.
-</p>
-<ul id="dir-struct" class="block-content">
-<li><tt>assets</tt> - katalog zawierający upublicznione prywatne pliki. Zobacz sekcję <a href="?page=Advanced.Assets">assets</a> by dowiedzieć się więcej. Katalog ten musi być zapisywalny przez proces serwera.</li>
-<li><tt>protected</tt> - podstawowa ścieżka aplikacji zawierająca dane aplikacji oraz prywatne skrypty plików. Katalog ten powinien być skonfigurowany jako niedostępny dla użytkownika końcowego.</li>
-<li><tt>runtime</tt> - składująca uruchomieniowa ścieżka aplikacji (ang. <i>application runtime storage path</i>) przechowuje informacje rurchomieniowe aplikacji, takie jak stan aplikacji, keszowane dane, itp. Katalog ten musi być zapisywalny przez proces serwera.</li>
-<li><tt>pages</tt> - podstawowa ścieżka przechowująca wszystkie strony PRADO.</li>
-</ul>
-
-<div class="tip">
-<b class="tip">Podpowiedż:</b>Możesz również użyć <tt>framework/prado-cli.php</tt>
-<a href="?page=GettingStarted.CommandLine">narzędzia linii poleceń</a>
-aby stworzyć strukturę katalogów dla projektu w PRADO. Na przykład, wpisz komendę
-<tt>php ścieżka/do/prado-cli.php -c helloworld</tt> w katalogu gdzie chcesz stworzyć projekt <tt>helloworld</tt> (witaj świecie).
-</div>
-
-<p id="50040">
-Trzy pliki, krórych potrzebujemy, kolejno oznaczają
-</p>
-<ul id="file-list" class="block-content">
-<li><tt>index.php</tt> - skrypt wejściowy aplikacji PRADO. Ten plik jest wymagany prez wszyskie aplikacje PRADO i jest jedynym skryptem, który jest bezpośrednio dostępny przez użytkownika końcowego. Zawartość <tt>index.php</tt> przeważnie zawiera następujące trzy linie,
-<com:TTextHighlighter CssClass="source block-content" id="code_50003">
-require_once('path/to/prado.php'); // załącz skrypt PRADO
-$application=new TApplication; // utwórz instancję aplikacji PRADO
-$application->run(); // uruchom aplikację
-</com:TTextHighlighter>
-</li>
-<li><tt>Home.page</tt> - szablon dla domyślnej strony, zwracany gdy użytkownik nie wybierze jawnie żadnej strony. Szablon określa warstwę prezentacji komponentów. W tym przykładzie, używamy dwóch komponentów, <tt>TForm</tt> oraz <tt>TButton</tt>, które odpowiadają odpowiednio znacznikom HTML <form> oraz <input>. Szablon posiada następującą treść
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_50004">
-<html>
- <body>
- <com:TForm>
- <com:TButton Text="Kliknij mnie" OnClick="buttonClicked" />
- </com:TForm>
- </body>
-</html>
-</com:TTextHighlighter>
-</li>
-<li><tt>Home.php</tt> - klasa strony dla strony głównej <tt>Home</tt>. Zawieta przeważnie metody odpowiadające na zdarzenia<tt>OnClick</tt> przycisku.
-<com:TTextHighlighter CssClass="source block-content" id="code_50005">
-class Home extends TPage
-{
- public function buttonClicked($sender,$param)
- {
- // $sender wskazuje na komponent przycisku
- $sender->Text="Witaj świecie!";
- }
-}
-</com:TTextHighlighter>
-</li>
-</ul>
-<div id="hello-end" class="block-content">
-<p id="50041">
-Aplikacja jest teraz gotowa i jest dostępna poprzez adres <tt>http://adres-serwera/helloworld/index.php</tt>, zakładając, że <tt>helloworld</tt> znajduje się bezpośrenio w <tt>KataloguGłównymDokumentó</tt> serwera (ang. <i>DocumentRoot</i>). Spróbuj zmienić <tt>TButton</tt> w <tt>Home.page</tt> na <tt>TLinkButton</tt> i zobacz co się stanie.
-</p>
-<p id="50042">
-Kompletne źródło kodu dla tego demo można znaleźć w wydaniu PRADO. Możesz również spróbować <a href="http://www.pradosoft.com/demos/helloworld/">demo online</a>.
-</p>
-</div>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/pl/Installation.page b/demos/quickstart/protected/pages/GettingStarted/pl/Installation.page deleted file mode 100755 index f25a4cc2..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/pl/Installation.page +++ /dev/null @@ -1,29 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="301">Instalacja PRADO</h1>
-<div id="install-info" class="block-content">
-<p id="30018">
-Jeśli widzisz tą stronę z poziomu własnego serwera, zakończyłeś właśnie instalację.
-</p>
-<p id="30019">
-Minimalne wymagania PRADO to serwer internetowy wspierający PHP5. PRADO zostało przetestowane na serwerze Apache na Windowsie oraz Linuxie. Jest wielce prawdopodobne, że może również działać na innych platformach z innymi serwerami internetowymi dopóki wspierają one PHP5.
-</p>
-</div>
-
-<div id="install-steps" class="block-content">
-<p id="30020">
-Instalacja PRADO składa się głównie z jego pobrania oraz rozpakowania.
-</p>
-<ol>
-<li>Przejdź do strony <a href="http://www.pradosoft.com/">pradosoft.com</a> aby pobrać ostatnią wersję PRADO.</li>
-<li>Rozpakuj plik PRADO zawierający jego ostatnie wydanie do katalogu znajdującego się na serwerze.
-</ol>
-</div>
-<div id="install-after" class="block-content">
-<p id="30021">
-Twoja instalacja PRADO jest zakończona i możesz zacząć zabawę z aplikacjami demo zawartymi w PRADO znajdującymi się pod adresem <tt>http://adres-serwera/prado/demos/</tt>. Tutaj zakładamy, że PRADO jest rozpakowane do katalogu <tt>prado</tt> w <tt>katalogu głównym</tt> serwera.
-</p>
-<p id="30022">
-Jeśli spotkasz się z jakimkolwiek problemem w aplikacjach demo, proszę użyj skryptu sprawdzającego wymagania do korzystania z PRADO dostępnego poprzez <tt>http://adres-serwera/prado/requirements/index.php</tt>, aby najpierw sprawdzić czy Twoja konfiguracja serwera spełnia wszystkie warunki wymagane przez PRADO.
-</p>
-</div>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/pl/Introduction.page b/demos/quickstart/protected/pages/GettingStarted/pl/Introduction.page deleted file mode 100755 index d8bd6381..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/pl/Introduction.page +++ /dev/null @@ -1,23 +0,0 @@ -<com:TContent ID="body" >
-<h1 id="101">Witamy w przewodniku SzybkiStart z PRADO</h1>
-<div id="intro" class="block-content">
-<p id="10001">
-Niniejszy przewodnik powstał by pomóc Tobie w szybkim rozpoczęciu budowania Twojej własnej aplikacji internetowej bazującej na PRADO w wersji 3.x
-</p>
-<p id="10001" class="block-content">
-Jeśli jesteś już użytkownikiem PRADO #.x i chciałbyś dowiedzieć się jakie rozszerzenia są dostępne dla każdej nowej wersji, proszę sprawdź <a href="?page=GettingStarted.NewFeatures">nowe właściwości</a>.
-Następujące sekcje są pomocne dla początkujących.
-</p>
-<p id="10002">
-Możesz odwoływać się do następujących zasobów jeśli czujesz, że ten przewodnik nie spełnia wszystkich twoich oczekiwań.
-</p>
-</div>
-<ul class="block-content" id="intro-links">
- <li><a href="http://www.pradosoft.com/docs/classdoc/">Klasy PRADO</a></li>
- <li><a href="http://www.pradosoft.com/docs/manual/">Dokumentacja API PRADO</a></li>
- <li><a href="http://www.pradosoft.com/forum/">Forum PRADO</a></li>
- <li><a href="http://www.pradosoft.com/wiki/">PRADO Wiki</a></li>
- <li><a href="http://trac.pradosoft.com/prado/">PRADO Trac</a></li>
-</ul>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/pl/NewFeatures.page b/demos/quickstart/protected/pages/GettingStarted/pl/NewFeatures.page deleted file mode 100755 index c5de2f02..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/pl/NewFeatures.page +++ /dev/null @@ -1,33 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="8005">Nowe możliwości</h1>
-
-<p id="40005" class="block-content">
-Poniższa strona podsumowuje główne możliwości, które zostały wprowadzone w każnym z wydań PRADO.
-</p>
-
-<h2>Wersja 3.1.1</h2>
-<ul>
-<li>Dodano nową kontrolkę <a href="?page=Controls.TabPanel">TTabPanel</a> wyświetlającą zawartość widoków w zakładkach.</li>
-<li>Dodano nową kontrolkę <a href="?page=Controls.Keyboard">TKeyboard</a> wyświetlającą wirtualną klawiaturę do wprowadzania tekstu.</li>
-<li>Dodano nową kontrolkę <a href="?page=Controls.Captcha">TCaptcha</a> wyświetlającą CAPTCHA uniemożliwiającą spamerom logowanie się do kont online. Powiązany Validator <tt>TCaptchaValidator</tt> został również zaimplementowany.</li>
-<li>Dodano nową kontrolkę <a href="?page=Controls.Slider">TSlider</a> wyświetlającą suwak do wprowadzania wartości numerycznych.</li>
-<li>Dodano nową kontrolkę <a href="?page=Controls.Conditional">TConditional</a> wyświetlającą jedną z dwóch rodzajów zawartości w zależności od spełnionego (bądź nie) warunku.</li>
-<li>Dodano wsparcie dla baz Oracle dla Rekordu Aktywnego (Active Record).</li>
-<li>Dodano wsparcie dla TDataGrid umożliwiające grupowanie kolejnych komórek z tą samą zawartością.</li>
-<li>Dodanow możliwość konfiguracji właściwości strony oraz reguł autoryzacji za pomocą <a href="?page=Configurations.PageConfig">relacyjnych ścieżek strony</a> w aplikacji oraz konfiguracji strony. Dodano możliwość <a href="?page=Advanced.Auth">autoryzacji</a> bazującej na zewnętrzym adresie hosta.</li>
-<li>Dodano nowy utrzymywacz (ang. persister) stanu strony <tt>TCachePageStatePersister</tt> umożliwiający przetrzymywanie stanu strony za pomocą modułów cache (np. TMemCache, TDbCache, itd.)
-<li>Dodano wsparcie dla <a href="?page=Advanced.Auth">frameworku authentykacji</a> umożliwiającą zapamiętanie logowania.</li>
-<li>Dodano możliwość wyświetlenia wskazówki w TDropDownList oraz TListBox (coś na wzów 'Proszę wybrać :' jako pierwszą pozycję w liście.)</li>
-<li>Dodanow wsparcie dla <a href="?page=Database.ActiveRecord">mapowania kolumn w Rekordzie Aktywnym (Active Record)</a>.</li>
-</ul>
-
-<h2 id="8006">wersja 3.1.0</h2>
-<ul>
-<li>Dodano jednolite/spójne wsparcie dla AJAX-a. Wprowadzono cały zestaw kontrolek AJAX-owych, nazywanych kontrolkami aktywnymi (ang. <i>active controls</i>).Uzywanie tych kontrolek jest bardzo podobne do swoich nieAJAX-owych odpowiedników, np. wstaw w kod i korzystaj. Aby uzyskać więcej szczegółów, zobacz przewodnik o <a href="?page=ActiveControls.Home">aktywnych kotnrolkach</a>.</li>
-<li>Dodano kompletną obsługę baz danych. </li>
-<li>Dodano nowe kontrolki, moduły i serwisy, w tym <a href="?page=Services.SoapService">TSoapService</a>, <a href="?page=Controls.OutputCache">TOutputCache</a>, TSessionPageStatePersister, TFeedService, TJsonService, klasy powiązane z cachem (ang. <i>cache dependency classes</i>), TXmlTransform.</li>
-<li>Rozszerzono część kontrolek danych o "odtwóców" (ang. <i>renderers</i>). "Odtwórcy" umożliwiają ponowne używanie szablonów pozycji (ang. <i>item templates</i>), które powszechnie można znaleźć w <tt>TRepeater</tt>, <tt>TDataList</tt> i <tt>TDataGrid</tt>, przez co czynią konfigurację tych kontrolek bardziej przejrzystą. Aby uzyskać więcej szczegółów o "odtwórcach" zobacz zaktualizowany przewodnik <a href="?page=Controls.Repeater"><tt>TRepeater</tt></a>, <a href="?page=Controls.DataList"><tt>TDataList</tt></a> oraz <a href="?page=Controls.DataGrid"><tt>TDataGrid</tt></a>.</li>
-<li>Dodano usługę umożliwiającą <a href="?page=Configurations.AppConfig">inkludowanie zewnętrznej konfiguracji serwera</a>. Rozszerzono składnię szablonów ułatwiającą <a href="?page=Configurations.Templates1">konfigurację subwłaściwości</a> (ang. <i>subproperties</i>).</li>
-</ul>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/pl/Upgrading.page b/demos/quickstart/protected/pages/GettingStarted/pl/Upgrading.page deleted file mode 100755 index deb726bb..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/pl/Upgrading.page +++ /dev/null @@ -1,64 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="501">Aktualizowanie z wersji 2.x i 1.x</h1>
-
-<div id="from-2-or-1" class="block-content">
-<p id="40023">
-PRADO 3.0 nie jest kompatybilne wstecz z wcześniejszymi wersjalmi PRADO.
-</p>
-<p id="40024">
-Dobrą wiadomością jest, że własciwości oraz zdarzenia większości kontrolek pozostają niezmienione a składnia szablonów kontrolek pozostaje w dużej mierze niezmieniona. Dlatego więc, wiedza develoiperów dotycząca wcześniejszych wersji PRADO wciąż znajduje zastosowanie w wersji 3.0.
-</p>
-<p id="40025">
-Kolejno podsumujemu najbardziej znaczące zmiany w wersji 3.0 aby pomóc developerom aktualizację ich aplikacji PRADO z wersji 2.x oraz 1.x jeśli wystąpi taka potrzeba.
-</p>
-</div>
-
-<h2 id="502">Definicja komponentu (<i>Component definition</i>)</h2>
-<p id="40026" class="block-content">
-Wersja 3.0 całkowicie zarzuciła potrzebę występowania pliku specyfikującego komponent. Polega ona obecnie bardziej na konwencji definiowania właściwości komponentu i jego zdarzeń. Uszczegóławiając, właściwość (ang. <i>property</i>) jest definiowana poprzez istnienie metod: getterów i/lub setterów (ang. getter and/or setter methods), natomiast zdarzenie jest zdefiniowane poprzez istnienie metod z przedrostniem <tt>on</tt> (ang. <i>on-methods</i>). Zarówno właściwości jak i nazwy zdarzeń są w wersji 3.0 nie są wrażliwe na wielkość liter. W konsekwencji developerzy, są teraz zobowiązaniu do troszczenia się konwersję typów, kiedy właściwość komponentu jest ustawiana. Na przykład, następujący kod jest używany do zdefiniowania metody będącej setterem dla właściwości <tt>Enabled</tt> (przyp. tłum. ang <i>enabled</i> - dostępny, umożliwiony) <tt>TControl</tt>, która jest typu boolowskiego: <tt>boolean</tt>,
-</p>
-<com:TTextHighlighter Language="php" CssClass="block-content source" ID="code1">
-public function setEnabled($value)
-{
- $value=TPropertyValue::ensureBoolean($value);
- $this->setViewState('Enabled',$value,true);
-}
-</com:TTextHighlighter>
-<p id="40027" class="block-content">
-gdzie <tt>TPropertyValue::ensureBoolean()</tt> jest używana aby ipewnić się, że wartość wejściowa jest typu boolean. Dziejse się tak ponieważ, gdy watość jest konfigurowana w szablonie, wartość łańcuchowa (ang. <i>string value<i/>) jest przekazywana do settera. W poprzednich wersjach PRADO znało typ właściwości bazując na pliku specyfikacji i wykonywało konwersję typów za Ciebie.
-</p>
-
-<h2 id="503">Kontroler aplickacji (<i>Application Controller</i>)</h2>
-<p id="40028" class="block-content">
-Kontroler aplickacji implementuje teraz architekturę modułową. Moduły mogą być podłączone i skonfigurowane w specyfikacji aplikacji. Każdy moduł obejmuje określoną funkcjonalność a wszystkie one są koordynowane przez <a href="?page=Fundamentals.Applications">cykl życia aplickacji</a> (ang. <i>application lidecycle</i>). Konecpcja modułów w wersji 2.x została zastąpiona w wersji 3.0 przez <a href="?page=Configurations.PageConfig">katalogi stron</a> (ang. <i>page directories</i>). W wyniku tego format <a href="?page=Configurations.AppConfig">specyfikacji aplikacji</a> (ang. <i>application specification</i>) w wersji 3.0 różni się od wersji wcześniejszych.
-</p>
-
-<h2 id="504">Strony (<i>Pages</i>)</h2>
-<p id="40029" class="block-content">
-Strony w wersji 3.0 są zorganizowane w katalogach, które mogą zostać porównane do koncepcji modułów w wersji 2.x. Strony są dostępne poprzez ścieżkę do nich. Na przykład, adres URL <tt>index.php?page=Kontrolki.Przyklady.Przyklad1</tt> będzie używany do dostępu do strony nazwanej <tt>Przyklad1</tt> przechowywanej w katalogu <tt>[ŚcieżkaBazowa]/Kontrolki/Przyklad</tt>, gdzie <tt>[ŚcieżkaBazowa]</tt> oznacza główny katalog stron (ang. <i>root page path</i>). Nazwa pliku szablonu strony musi kończyć się rozszerzeniem <tt>.page</tt>, głównie, aby odróżnić szablony stron od "niestronowych" (ang. <i>non-paged</i>) szablonów kontrolek, których nazwa musi być zakończona rozszerzeniem <tt>.tpl</tt>.
-</p>
-
-<h2 id="505">Zależności między kontrolkami (<i>Control Relationship</i>)</h2>
-<p id="40030" class="block-content">
-Wersja 3.0 redefiniuje zależności pomiędzy kontrolkami. W szczególności, relacja rodzic-dziecko (<i>parent-child relationship</i> teraz odnosi się do relacji zawierajacej się w prezentacji kontrolek. Nowa relacja naming-container (przyp tłum. ang. <i>naming</i> - nazywanie, <i>container</i> - kontener) została wprowadzona dla lepszego zarządzania identyfikatorami ID kontrolek. Aby uzyskać więcej informacji zobacz sekcję <a href="?page=Fundamentals.Controls">kontrolki</a>.
-</p>
-
-<h2 id="506">Składnia szablonów (<i>Template Syntax</i>)</h2>
-<div id="template-syntax" class="block-content">
-<p id="40031">
-Składnia szblonów kontrolek w wersji 3.0 została podobna do tej we wcześniejszych wersjach, ale z wieloma rozszerzeniami. Główna zmiana dotyczy wyrażenia wiążącego dane (ang. <i>databind expression</i>), które jest wykonywane następująco
-</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_40002">
-<com:MojKomponent NazwaWlasciwosci=<%# formuła PHP %> .../>
-</com:TTextHighlighter>
-<p id="40032">
-Tagi formuł oraz wyrażeń (ang. <i>expression and statement tags</i>) zostały zmienione w podobny sposób. Aby uzyskać więcej szczegółów zobacz sekcję <a href="?page=Configurations.Templates1">definiowanie szablonów</a> (ang. <i>template definition</i>).
-</p>
-</div>
-<h2 id="507">Składnia tematów (<i>Theme Syntax</i>)</h2>
-<p id="40033" class="block-content">
-Tematy w wersji 3.0 są definiowane jak szablony kotnrolek z kilkoma obwarowaniami.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/GettingStarted/pl/directory.gif b/demos/quickstart/protected/pages/GettingStarted/pl/directory.gif Binary files differdeleted file mode 100755 index e6c4f724..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/pl/directory.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/GettingStarted/pl/sequence.gif b/demos/quickstart/protected/pages/GettingStarted/pl/sequence.gif Binary files differdeleted file mode 100755 index 4207a9bb..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/pl/sequence.gif +++ /dev/null diff --git a/demos/quickstart/protected/pages/GettingStarted/wsat_generate_ar.png b/demos/quickstart/protected/pages/GettingStarted/wsat_generate_ar.png Binary files differindex 8f0f59e7..6333d26b 100644 --- a/demos/quickstart/protected/pages/GettingStarted/wsat_generate_ar.png +++ b/demos/quickstart/protected/pages/GettingStarted/wsat_generate_ar.png diff --git a/demos/quickstart/protected/pages/GettingStarted/wsat_login.png b/demos/quickstart/protected/pages/GettingStarted/wsat_login.png Binary files differindex dbe1ad8b..3159a8ff 100644 --- a/demos/quickstart/protected/pages/GettingStarted/wsat_login.png +++ b/demos/quickstart/protected/pages/GettingStarted/wsat_login.png diff --git a/demos/quickstart/protected/pages/GettingStarted/zh/Introduction.page b/demos/quickstart/protected/pages/GettingStarted/zh/Introduction.page deleted file mode 100755 index ee5db70f..00000000 --- a/demos/quickstart/protected/pages/GettingStarted/zh/Introduction.page +++ /dev/null @@ -1,20 +0,0 @@ -<com:TContent ID="body" >
-<h1>欢迎使用PRADO快速教程</h1>
-
-<div id="intro" class="block-content">
-<p>
-本教程旨在帮助您快速掌握用PRADO v3.x构建Web应用。
-</p>
-<p>
-如果您觉得本教程没能满足您的需求，您也可以参考以下资源：
-</p>
-</div>
-<ul class="block-content" id="intro-links">
- <li><a href="http://www.pradosoft.com/docs/classdoc/">PRADO类库文档</a></li>
- <li><a href="http://www.pradosoft.com/docs/manual/">PRADO API文档</a></li>
- <li><a href="http://www.pradosoft.com/forum/">PRADO论坛</a></li>
- <li><a href="http://www.pradosoft.com/wiki/">PRADO Wiki</a></li>
- <li><a href="http://trac.pradosoft.com/prado/">PRADO Trac</a></li>
-</ul>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/JuiControls/Home.page b/demos/quickstart/protected/pages/JuiControls/Home.page index 4bf8f7fe..f997e573 100644 --- a/demos/quickstart/protected/pages/JuiControls/Home.page +++ b/demos/quickstart/protected/pages/JuiControls/Home.page @@ -1,9 +1,9 @@ <com:TContent ID="body" > -<h1>Jui Controls (jQuery UI)</h1> +<h1 id="224018">Jui Controls (jQuery UI)</h1> <p class="block-content"> Jui controls are the PRADO port of the standard <a href="http://jqueryui.com/">jQuery UI</a> widgets. They can be used as standard <a href="?page=ActiveControls.Introduction">Active Controls</a>, but will automatically load the needed jQuery-UI javascript libraries. </p> -<h3>Options</h3> +<h3 id="224021">Options</h3> <p class="block-content"> The <tt>Options</tt> property of PRADO Jui controls is used to pass options to the underlying javascript object. Each subproperty set on <tt>Options</tt> will be translated to a javascript property added to the object. The complete list of options available for each widget is availble at jQuery-UI's API Documentation. </p> @@ -24,7 +24,7 @@ jQuery-UI's <a href="http://jqueryui.com/resizable/">Resizable</a> adds an handl /> </com:TTextHighlighter> -<h3>Events</h3> +<h3 id="224022">Events</h3> <p class="block-content"> jQuery-UI widgets offers a lot of events that PRADO can hook up and trasmit to the serverside using a <a href="?page=ActiveControls.Introduction">callback request</a>. Event available for PRADO Jui controls inherits their names from their jQuery-UI counterparts, prefixed with "On". Jui controls doesn't make use of the AutoPostback property anymore, but only triggers a callback when an event handler is associated to the corresponding event. @@ -42,7 +42,7 @@ jQuery's <a href="http://jqueryui.com/draggable/">Draggable</a> allows a target /> </com:TTextHighlighter> -<h2>PRADO Jui interactions controls</h2> +<h2 id="224019">PRADO Jui interactions controls</h2> <p class="block-content"> Jui interactions adds basic mouse-based interactions to elements like moving, resizing or sorting. PRADO Jui interactions controls applies there interactions to a <a href="?page=ActiveControls.ActivePanel">TActivePanel</a> For informations of the specific options of each interaction, follow jQuery-UI Interaction <a href="http://api.jqueryui.com/category/interactions/">API Documentation</a> for the specific interaction. @@ -74,15 +74,15 @@ For informations of the specific options of each interaction, follow jQuery-UI I </li> </ul> -<h2>PRADO Jui widgets controls</h2> +<h2 id="224020">PRADO Jui widgets controls</h2> <ul id="u2" class="block-content"> <li> <a href="?page=JuiControls.Widgets#TJuiProgressbar">TJuiProgressbar</a> displays a progress bar. </li> <li> - <a href="?page=JuiControls.Widgets#TJuiAutoComplete">TJuiProgressbar</a> - provides a list of suggestions on the current partial word typed in the textbox + <a href="?page=JuiControls.Widgets#TJuiAutoComplete">TJuiAutoComplete</a> + is a textbox that provides a list of suggestion on the current partial typed word </li> <li> <a href="?page=JuiControls.Widgets#TJuiDialog">TJuiDialog</a> diff --git a/demos/quickstart/protected/pages/JuiControls/Interactions.page b/demos/quickstart/protected/pages/JuiControls/Interactions.page index 2b48da68..b2be141f 100644 --- a/demos/quickstart/protected/pages/JuiControls/Interactions.page +++ b/demos/quickstart/protected/pages/JuiControls/Interactions.page @@ -1,12 +1,12 @@ <com:TContent ID="body"> -<h1>Jui interactions controls</h1> +<h1 id="226023">Jui interactions controls</h1> <p class="block-content"> Jui interactions adds basic mouse-based interactions to elements like moving, resizing or sorting. PRADO Jui interactions controls applies these interactions to a <a href="?page=ActiveControls.ActivePanel">TActivePanel</a> For informations of the specific options of each interaction, follow jQuery-UI Interaction <a href="http://api.jqueryui.com/category/interactions/">API Documentation</a> for the specific interaction. </p> <a name="TJuiDraggable"></a> -<h2>TJuiDraggable</h2> +<h2 id="226024">TJuiDraggable</h2> <com:DocLink ClassPath="System.Web.UI.JuiControls.TJuiDraggable" /> - <a href="http://api.jqueryui.com/draggable/">jQuery UI API</a> <p class="block-content"> @@ -22,7 +22,7 @@ The panel can be moved using the mouse, and eventually dropped over a <a href="? <a name="TJuiDroppable"></a> -<h2>TJuiDroppable</h2> +<h2 id="226025">TJuiDroppable</h2> <com:DocLink ClassPath="System.Web.UI.JuiControls.TJuiDroppable" /> - <a href="http://api.jqueryui.com/droppable/">jQuery UI API</a> <p class="block-content"> @@ -37,7 +37,7 @@ When a <a href="?page=JuiControls.Interactions#TJuiDroppable">TJuiDraggable</a> <br/> <a name="TJuiResizable"></a> -<h2>TJuiResizable</h2> +<h2 id="226026">TJuiResizable</h2> <com:DocLink ClassPath="System.Web.UI.JuiControls.TJuiResizable" /> - <a href="http://api.jqueryui.com/resizable/">jQuery UI API</a> <p class="block-content"> <tt>TJuiResizable</tt> is an extension to <a href="?page=ActiveControls.ActivePanel">TActivePanel</a> based on jQuery-UI's <a href="http://jqueryui.com/resizable/">Resizable</a> interaction. @@ -52,7 +52,7 @@ A small handle is shown on the bottom right corner of the panel, that permits th <a name="TJuiSelectable"></a> -<h2>TJuiSelectable</h2> +<h2 id="226027">TJuiSelectable</h2> <com:DocLink ClassPath="System.Web.UI.JuiControls.TJuiSelectable" /> - <a href="http://api.jqueryui.com/selectable/">jQuery UI API</a> <p class="block-content"> <tt>TJuiSelectable</tt> is an extension to <a href="?page=ActiveControls.ActivePanel">TActivePanel</a> based on jQuery-UI's <a href="http://jqueryui.com/selectable/">Selectable</a> interaction. @@ -67,7 +67,7 @@ A small handle is shown on the bottom right corner of the panel, that permits th <a name="TJuiSortable"></a> -<h2>TJuiSortable</h2> +<h2 id="226028">TJuiSortable</h2> <com:DocLink ClassPath="System.Web.UI.JuiControls.TJuiSortable" /> - <a href="http://api.jqueryui.com/sortable/">jQuery UI API</a> <p class="block-content"> <tt>TJuiSortable</tt> is an extension to <a href="?page=ActiveControls.ActivePanel">TActivePanel</a> based on jQuery-UI's <a href="http://jqueryui.com/sortable/">Sortable</a> interaction. diff --git a/demos/quickstart/protected/pages/JuiControls/Widgets.page b/demos/quickstart/protected/pages/JuiControls/Widgets.page index 63c6aa32..5bf8b083 100644 --- a/demos/quickstart/protected/pages/JuiControls/Widgets.page +++ b/demos/quickstart/protected/pages/JuiControls/Widgets.page @@ -1,5 +1,5 @@ <com:TContent ID="body"> -<h1>Jui widgets controls</h1> +<h1 id="228029">Jui widgets controls</h1> <p class="block-content"> Jui widgets are complex controls built on the foundations of jQuery effects and jQueryUI interactions. PRADO Jui widgets controls can be divided in two groups: @@ -11,7 +11,7 @@ For informations of the specific options of each widget, follow jQuery-UI Widget </p> <a name="TJuiProgressbar" /> -<h2>TJuiProgressbar</h2> +<h2 id="228030">TJuiProgressbar</h2> <com:DocLink ClassPath="System.Web.UI.JuiControls.TJuiProgressbar" /> - <a href="http://api.jqueryui.com/progressbar/">jQuery UI API</a> <p class="block-content"> @@ -26,7 +26,7 @@ The panel takes the aspect of a progressbar ranging from a value of 0 to the val <br/> <a name="TJuiAutoComplete" /> -<h2>TJuiAutoComplete</h2> +<h2 id="228031">TJuiAutoComplete</h2> <com:DocLink ClassPath="System.Web.UI.JuiControls.TJuiAutoComplete" /> - <a href="http://api.jqueryui.com/autocomplete/">jQuery UI API</a> <p class="block-content"> @@ -50,7 +50,7 @@ When a suggestion is selected the <tt>OnSuggestionSelected</tt> event is raised, <a name="TJuiDialog" /> -<h2>TJuiDialog</h2> +<h2 id="228032">TJuiDialog</h2> <com:DocLink ClassPath="System.Web.UI.JuiControls.TJuiDialog" /> - <a href="http://api.jqueryui.com/dialog/">jQuery UI API</a> <p class="block-content"> @@ -72,7 +72,7 @@ The buttons may contain a callback that will be fired when they are clicked. <a name="TJuiDatePicker" /> -<h2>TJuiDatePicker</h2> +<h2 id="228033">TJuiDatePicker</h2> <com:DocLink ClassPath="System.Web.UI.JuiControls.TJuiDatePicker" /> - <a href="http://api.jqueryui.com/datepicker/">jQuery UI API</a> <p class="block-content"> diff --git a/demos/quickstart/protected/pages/Services/id/SoapService.page b/demos/quickstart/protected/pages/Services/id/SoapService.page deleted file mode 100755 index e7f552c4..00000000 --- a/demos/quickstart/protected/pages/Services/id/SoapService.page +++ /dev/null @@ -1,164 +0,0 @@ -<com:TContent ID="body" >
-
-<h1 id="134038">Layanan SOAP</h1>
-
-<p id="670450" class="block-content">
-SOAP membentuk lapisan dasar dari tumpukan layanan Web. Ia menyediakan cara yang rapi agar aplikasi PHP saling berkomunikasi atau dengan aplikasi yang ditulis dalam bahasa lain. PRADO menyediakan <tt>TSoapService</tt> yang membuat pengembagan aplikasi server SOAP menjadi tugas yang sangat mudah.
-</p>
-
-<p id="670451" class="block-content">
-Untuk menggunakan <tt>TSoapService</tt>, konfigurasi itu dalam spesifikasi aplikasi seperti berikut:
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_670133">
-<services>
- <service id="soap" class="System.Web.Services.TSoapService">
- <soap id="stockquote" provider="path.to.StockQuote" />
- <!--
- <soap...other soap service... />
- -->
- </service>
-</services>
-</com:TTextHighlighter>
-<p id="670452" class="block-content">
-Contoh menetapkan penyedia layanan SOAP bernama <tt>stockquote</tt> yang mengimplementasikan metode SOAP <tt>getPrice</tt> dalam kelas penyedia <tt>StockQuote</tt>,
-</p>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_670134">
-class StockQuote
-{
- /**
- * @param string $symbol the symbol of the stock
- * @return float the stock price
- * @soapmethod
- */
- public function getPrice($symbol)
- {
- ....return stock price for $symbol
- }
-}
-</com:TTextHighlighter>
-
-<div class="note"><b class="tip">Catatan:</b>
-<tt>TSoapService</tt> didasarkan pada <a href="http://www.php.net/manual/en/ref.soap.php">ekstensi SOAP PHP</a> dan memerlukan ekstensi terinstalasi.
-</div>
-
-<p id="670453" class="block-content">
-Dengan kode sederhana di atas, kita sudah menyelesaikan layanan SOAP sederhana yang membolehkan aplikasi lain untuk meng-query harga dari stok tertentu. Sebagai contoh, umumnya klien SOAP bisa ditulis seperti berikut guna mendapatkan harga stok atas IBM,
-</p>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_670135">
-$client=new SoapClient('http://path/to/index.php?soap=stockquote.wsdl');
-echo $client->getPrice('IBM');
-</com:TTextHighlighter>
-
-<p id="670454" class="block-content">
-Perhatikan URL yang digunakan untuk membentuk <tt>SoapClient</tt> (kelas disediakan oleh ekstensi SOAP PHP). Ini adalah URL untuk <a href="http://en.wikipedia.org/wiki/WSDL">WSDL</a> yang menjelaskan protokol komunikasi untuk layanan SOAP yang baru kita implementasikan. WSDL sering kali terlalu rumit untuk ditulis secara manual. Kebetulan, <tt>TSoapService</tt> bisa membuat ini bagi kita menggunakan generator WSDL. Secara umum, URL untuk membuat WSDL secara otomatis dalam PRADO mempunyai format berikut:
-</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_670136">
-http://path/to/index.php?SoapServiceID=SoapProviderID.wsdl
-</com:TTextHighlighter>
-
-<p id="670455" class="block-content">
-Agar generator WSDL membuat WSDL untuk layanan SOAP, kelas penyedia perlu untuk mengikuti sintaks tertentu. Dalam keadaan tertentu, untuk metode yang akan diperlihatkan sebagai metode SOAP, kata kunci <tt>@soapmethod</tt> harus muncul dalam komentar phpdoc terhadap metode dengan baris berikut yang menetapkan parameter metode dan nilai hasil:
-</p>
-<ul id="u1" class="block-content">
-<li>parameter: <tt>@param parameter-type $parameter-name description</tt></li>
-<li>return value: <tt>@return value-type description</tt></li>
-</ul>
-<p id="670456" class="block-content">
-Parameter yang benar dan tipe hasil termasuk: <tt>string</tt>, <tt>int</tt>, <tt>boolean</tt>, <tt>float</tt>, <tt>array</tt>, <tt>mixed</tt>, dll. Anda dapat juga menetapkan nama kelas sebagai tipe, yang menterjemahkan ke dalam tipe SOAP kompleks. Sebagai contoh, untuk tipe kompleks <tt>Contact</tt>
-</p>
-
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_670137">
-/**
- * Memperluas TComponent untuk menyediakan metode pengambil/penentu properti
- */
-class Contact {
- /**
- * @var string $name
- * @soapproperty
- */
- public $name;
-
- /**
- * @var Address $address
- * @soapproperty
- */
- private $_address;
-
- public function setAddress($value) {
- $this->_address=$value;
- }
-
- public function getAddress() {
- if($this->_address===null)
- $this->_address=new Address;
- return $this->_address;
- }
-}
-
-class Address{
- /**
- * @var string $city
- * @soapproperty
- */
- public $city;
-}
-
-class ContactManager {
- /**
- * @return Contact[] an array of contacts
- * @soapmethod
- */
- function getAllContacts() {
- return array(new Contact);
- }
-
- /**
- * @return Contact one contact
- * @soapmethod
- */
- function getContact($name) {
- return new Contact;
- }
-}
-</com:TTextHighlighter>
-<p id="670457" class="block-content">Untuk obyek soap kompleks, properti obyek ditetapkan dengan kata kunci <tt>@soapproperty</tt> dalam phpdocs. Selanjutnya, nama tipe properti harus ditetapkan sebagai <tt>@var type $name</tt> di mana <tt>type</tt> adalah tipe apapun yang benar seperti telah disebutkan sebelumnya dan <tt>$name</tt> akan mendefinisikan properti <tt>name</tt> (catatan bahwa jika kelas Anda adalah TComponent, Anda bisa menyediakan properti pengambil/penentu).
-</p>
-<p id="670458" class="block-content">
-Sebuah array dari obyek yang kompleks juga bisa dihasilkan dengan menambahkan pasangan yang dilindungi kurung kotak setelah nama tipe. Sebagai contoh, untuk menghasilkan array dari tipe <tt>Contact</tt>, kita mendefinisikan <tt>@return Contact[] ...</tt>.
-</p>
-
-<div class="tip"><b class="note">Tip:</b>
-Piranti sangat berguna untuk menguji layanan web Anda adalah piranti bebas
-<a href="http://www.gotdotnet.com/Community/UserSamples/Details.aspx?SampleGuid=65a1d4ea-0f7a-41bd-8494-e916ebc4159c">WebServiceStudio 2.0</a>. Ia bisa memanggil webmethods secara interaktif. Pengguna dapat menyediakan sebuah titik akhir WSDL. Pada saat mengklik tombol Get piranti mengambil WSDL, membuat proxy .NET dari WSDL dan menampilkan daftar metode yang tersedia. Pengguna bisa memilih setiap metode dan menyediakan parameter input yang diplerukan.
-Piranti membutuhkan MS .NET runtime terinstalasi.
-
-<p id="690008" class="block-content">Piranti semacam itu tersedia untuk Mac OS X Tiger dari
-<a href="http://www.ditchnet.org/soapclient/">http://www.ditchnet.org/soapclient/</a>
-</p>
-</div>
-
-<p id="670459" class="block-content">
-<tt>TSoapService</tt> bisa dikonfigurasi dan dikustomisasi dalam beberapa cara. Dalam contoh di atas, elemen <tt><soap></tt> sebenarnya menetapkan sebuah layanan SOAP menggunakan implementasi standar <tt>TSoapServer</tt>. Atribut dalam <tt><soap></tt> dikirimkan ke <tt>TSoapServer</tt> sebagai nilai properti awalnya. Sebagai contoh, atribut <tt>provider</tt> menginisialisasi properti <tt>Provider</tt> dari <tt>TSoapServer</tt>. Dengan menyetel <tt>SessionPersistent</tt> menjadi true dalam elemen <tt><soap></tt>, turunan penyedia akan sama di dalam sesi pengguna. Anda bisa mengembangkan kelas server SOAP sendiri dan menggunakannya dengan menetapkan atribut <tt>class</tt> dari <tt><soap></tt>.
-</p>
-
-<p id="670460" class="block-content">Standarnya, server SOAP PHP akan membuat obyek dari tipe <tt>StdClass</tt> ketika obyek diterima dari klien. Server soap bisa dikonfigurasi untuk secara otomatis membuat obyek dari obyek tipe tertentu diterima sebagai parameter metode. Sebagai contoh, jika kita mempunyai sebuah metode Soap yang menerima obyek <tt>Contact</tt> sebagai parameter.
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_670138">
-/**
- * @param Contact $contact
- * @return boolean true if saved, false otherwise
- * @soapmethod
- */
- function save(Contact $contact)
- {
- return true
- }
-</com:TTextHighlighter>
-Untuk melakukan ini, kita perlu menyetel properti <tt>ClassMaps</tt> dari
-<tt>TSoapServer</tt> dalam tag <tt><soap></tt> sebagai nama kelas string dipisahkan koma yang kita inginkan secara otomatis dikonversi.
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_670139">
-<soap id="contact-manager" provider="path.to.ContactManager"
- ClassMaps="Contact, Address"/>
-</com:TTextHighlighter>
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Tutorial/AjaxChat.page b/demos/quickstart/protected/pages/Tutorial/AjaxChat.page index 92118720..40e283dd 100755 --- a/demos/quickstart/protected/pages/Tutorial/AjaxChat.page +++ b/demos/quickstart/protected/pages/Tutorial/AjaxChat.page @@ -22,7 +22,7 @@ that asks the user to enter their nickname and the main application chat page. You can try the application <a href="../chat/index.php">locally</a> or at - <a href="http://www.pradosoft.com/demos/chat/">Pradosoft.com</a>. + <a href="http://www.pradoframework.net/site/demos/chat/">Prado website</a>. The main application chat page is shown bellow. <img src=<%~ chat1.png %> class="figure" /> </p> diff --git a/demos/quickstart/protected/pages/Tutorial/CurrencyConverter.page b/demos/quickstart/protected/pages/Tutorial/CurrencyConverter.page index 1abd68b9..0beeaaf4 100755 --- a/demos/quickstart/protected/pages/Tutorial/CurrencyConverter.page +++ b/demos/quickstart/protected/pages/Tutorial/CurrencyConverter.page @@ -10,15 +10,15 @@ a dollar amount to an other currency, given the rate of that currency relative to the dollar. The completed application is shown bellow. <img src=<%~ example2.png %> class="figure" /> - You can try the application <a href="../currency-converter/index.php">locally</a> or at - <a href="http://www.pradosoft.com/demos/currency-converter/">Pradosoft.com</a>. + You can try the application <a href="../currency-converter/index.php">locally</a> or at the + <a href="http://www.pradoframework.net/site/demos/currency-converter/">Prado website</a>. Notice that the application still functions exactly the same if javascript is not available on the user's browser. </p> <h1 id="download">Downloading and Installing Prado</h1> - <p id="80055" class="block-content">To install Prado, simply download the latest version of Prado from - <a href="http://www.pradosoft.com/">http://www.pradosoft.com</a> + <p id="80055" class="block-content">To install Prado, simply download the latest version of Prado from the + <a href="https://github.com/pradosoft/prado">Prado project website</a> and unzip the file to a directory <b>not</b> accessible by your web server (you may unzip it to a directory accessible by the web server if you wish to see the demos and test). For further detailed installation, see the diff --git a/demos/quickstart/protected/pages/Tutorial/fr/AjaxChat.page b/demos/quickstart/protected/pages/Tutorial/fr/AjaxChat.page deleted file mode 100755 index 568e920f..00000000 --- a/demos/quickstart/protected/pages/Tutorial/fr/AjaxChat.page +++ /dev/null @@ -1,755 +0,0 @@ -<com:TContent ID="body"> - <h1 id="18008">Building an AJAX Chat Application</h1> - <p id="90081" class="block-content">This tutorial introduces the Prado web application framework's - <a href="?page=Database.ActiveRecord">ActiveRecord</a> - and <a href="?page=ActiveControls.Home">Active Controls</a> to build a Chat - web application. It is assumed that you - are familiar with PHP and you have access to a web server that is able to serve PHP5 scripts. - This basic chat application will utilize the following ideas/components in Prado. - </p> - <ul id="u1" class="block-content"> - <li>Building a custom User Manager class.</li> - <li>Authenticating and adding a new user to the database.</li> - <li>Using ActiveRecord to interact with the database.</li> - <li>Using Active Controls and callbacks to implement the user interface.</li> - <li>Separating application logic and application flow.</li> - </ul> - - <p id="90082" class="block-content">In this tutorial you will build an AJAX Chat web application that allows - multiple users to communicate through their web browser. - The application consists of two pages: a login page - that asks the user to enter their nickname and the main application chat - page. - You can try the application <a href="../chat/index.php">locally</a> or at - <a href="http://www.pradosoft.com/demos/chat/">Pradosoft.com</a>. - The main application chat page is shown bellow. - <img src=<%~ chat1.png %> class="figure" /> - </p> - - <h1 id="18009">Download, Install and Create a New Application</h1> - <p id="90083" class="block-content">The download and installation steps are similar to those in - the <a href="?page=Tutorial.CurrencyConverter#download">Currency converter tutorial</a>. - To create the application, we run from the command line the following. - See the <a href="?page=GettingStarted.CommandLine">Command Line Tool</a> - for more details. -<com:TTextHighlighter Language="text" CssClass="source block-content" id="code_90027"> -php prado/framework/prado-cli.php -c chat -</com:TTextHighlighter> - </p> - - <p id="90084" class="block-content">The above command creates the necessary directory structure and minimal - files (including "index.php" and "Home.page") to run a Prado web application. - Now you can point your browser's URL to the web server to serve up - the <tt>index.php</tt> script in the <tt>chat</tt> directory. - You should see the message "Welcome to Prado!" - </p> - - <h1 id="18010">Authentication and Authorization</h1> - <p id="90085" class="block-content">The first task for this application is to ensure that each user - of the chat application is assigned with a unique (chosen by the user) - username. To achieve this, we can secure the main chat application - page to deny access to anonymous users. First, let us create the <tt>Login</tt> - page with the following code. We save the <tt>Login.php</tt> and <tt>Login.page</tt> - in the <tt>chat/protected/pages/</tt> directory (there should be a <tt>Home.page</tt> - file created by the command line tool). - </p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90028"> -<?php -class Login extends TPage -{ -} -</com:TTextHighlighter> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_90029"> -<!doctype html public "-//W3C//DTD XHTML 1.0 Strict//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> -<head> - <title>Prado Chat Demo Login</title> -</head> -<body> -<com:TForm> - <h1 class="login">Prado Chat Demo Login</h1> - <fieldset class="login"> - <legend>Please enter your name:</legend> - <div class="username"> - <com:TLabel ForControl="username" Text="Username:" /> - <com:TTextBox ID="username" MaxLength="20" /> - <com:TRequiredFieldValidator - ControlToValidate="username" - Display="Dynamic" - ErrorMessage="Please provide a username." /> - </div> - <div class="login-button"> - <com:TButton Text="Login" /> - </div> -</com:TForm> -</body> -</html> -</com:TTextHighlighter> - <p id="90086" class="block-content">The login page contains - a <com:DocLink ClassPath="System.Web.UI.TForm" Text="TForm" />, - a <com:DocLink ClassPath="System.Web.UI.WebControls.TTextBox" Text="TTextBox" />, - a <com:DocLink ClassPath="System.Web.UI.WebControls.TRequiredFieldValidator" Text="TRequiredFieldValidator" /> - and a <com:DocLink ClassPath="System.Web.UI.WebControls.TButton" Text="TButton" />. The resulting - page looks like the following (after applying some a style sheet). - <img src=<%~ chat2.png %> class="figure" /> - If you click on the <tt>Login</tt> button without entering any - text in the username textbox, an error message is displayed. This is - due to the <com:DocLink ClassPath="System.Web.UI.WebControls.TRequiredFieldValidator" Text="TRequiredFieldValidator" /> - requiring the user to enter some text in the textbox before proceeding. - </p> -<h2 id="18019">Securing the <tt>Home</tt> page</h2> -<p id="90087" class="block-content">Now we wish that if the user is trying to access the main application -page, <tt>Home.page</tt>, before they have logged in, the user is presented with -the <tt>Login.page</tt> first. We add a <tt>chat/protected/application.xml</tt> configuration -file to import some classes that we shall use later. -<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_90030"> -<?xml version="1.0" encoding="utf-8"?> -<application id="Chat" Mode="Debug"> - <paths> - <using namespace="System.Data.*" /> - <using namespace="System.Data.ActiveRecord.*" /> - <using namespace="System.Security.*" /> - <using namespace="System.Web.UI.ActiveControls.*" /> - </paths> -</application> -</com:TTextHighlighter> -Next, we add a <tt>chat/protected/pages/config.xml</tt> configuration file to -secure the <tt>pages</tt> directory. -<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_90031"> -<?xml version="1.0" encoding="utf-8"?> -<configuration> - <modules> - <module id="users" class="TUserManager" /> - <module id="auth" class="TAuthManager" UserManager="users" LoginPage="Login" /> - </modules> - <authorization> - <allow pages="Login" users="?" /> - <allow roles="normal" /> - <deny users="*" /> - </authorization> -</configuration> -</com:TTextHighlighter> -We setup the authentication using the default classes as explained in the -<a href="?page=Advanced.Auth">authentication/authorization quickstart</a>. -In the authorization definition, we allow anonymous users to access the -<tt>Login</tt> page (anonymous users is specified by the <tt>?</tt> question mark). -We allow any users with role equal to "normal" (to be defined later) -to access all the pages, that is, the <tt>Login</tt> and <tt>Home</tt> pages. -Lastly, we deny all users without any roles to access any page. The authorization -rules are executed on first match basis. -</p> - -<p id="90088" class="block-content">If you now try to access the <tt>Home</tt> page by pointing your browser -to the <tt>index.php</tt> you will be redirected to the <tt>Login</tt> page. -</p> - -<h1 id="18011">Active Record for <tt>chat_users</tt> table</h1> -<p id="90089" class="block-content">The <com:DocLink ClassPath="System.Secutity.TUserManager" Text="TUserManager" /> -class only provides a read-only list of users. We need to be able to add or -login new users dynamically. So we need to create our own user manager class. -First, we shall setup a database with a <tt>chat_users</tt> table and create an ActiveRecord -that can work with the <tt>chat_users</tt> table with ease. For the demo, we -use <tt>sqlite</tt> as our database for ease of distributing the demo. The demo -can be extended to use other databases such as MySQL or Postgres SQL easily. -We define the <tt>chat_users</tt> table as follows. -<com:TTextHighlighter Language="text" CssClass="source block-content" id="code_90032"> -CREATE TABLE chat_users -( - username VARCHAR(20) NOT NULL PRIMARY KEY, - last_activity INTEGER NOT NULL DEFAULT "0" -); -</com:TTextHighlighter> -Next we define the corresponding <tt>ChatUserRecord</tt> class and save it as -<tt>chat/protected/App_Code/ChatUserRecord.php</tt> (you need to create the -<tt>App_Code</tt> directory as well). We also save the sqlite database file -as <tt>App_Code/chat.db</tt>. -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90033"> -class ChatUserRecord extends TActiveRecord -{ - const TABLE='chat_users'; - - public $username; - public $last_activity; - - public static function finder($className=__CLASS__) - { - return parent::finder($className); - } -} -</com:TTextHighlighter> -Before using the <tt>ChatUserRecord</tt> class we to configure a default -database connection for ActiveRecord to function. In the <tt>chat/protected/application.xml</tt> -we import classes from the <tt>App_Code</tt> directory and add an -<a href="?page=Database.ActiveRecord">ActiveRecord configuration module</a>. -<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_90034"> -<?xml version="1.0" encoding="utf-8"?> -<application id="Chat" Mode="Debug"> - <paths> - <using namespace="Application.App_Code.*" /> - <using namespace="System.Data.*" /> - <using namespace="System.Data.ActiveRecord.*" /> - <using namespace="System.Security.*" /> - <using namespace="System.Web.UI.ActiveControls.*" /> - </paths> - <modules> - <module class="TActiveRecordConfig" EnableCache="true" - Database.ConnectionString="sqlite:protected/App_Code/chat.db" /> - </modules> -</application> -</com:TTextHighlighter> -</p> - -<h2 id="18020">Custom User Manager class</h2> -<p id="90090" class="block-content">To implement a custom user manager module class we just need -to extends the <tt>TModule</tt> class and implement the <tt>IUserManager</tt> -interface. The <tt>getGuestName()</tt>, <tt>getUser()</tt> and <tt>validateUser()</tt> -methods are required by the <tt>IUserManager</tt> interface. -We save the custom user manager class as <tt>App_Code/ChatUserManager.php</tt>. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90035"> -class ChatUserManager extends TModule implements IUserManager -{ - public function getGuestName() - { - return 'Guest'; - } - - public function getUser($username=null) - { - $user=new TUser($this); - $user->setIsGuest(true); - if($username !== null && $this->usernameExists($username)) - { - $user->setIsGuest(false); - $user->setName($username); - $user->setRoles(array('normal')); - } - return $user; - } - - public function addNewUser($username) - { - $user = new ChatUserRecord(); - $user->username = $username; - $user->save(); - } - - public function usernameExists($username) - { - $finder = ChatUserRecord::finder(); - $record = $finder->findByUsername($username); - return $record instanceof ChatUserRecord; - } - - public function validateUser($username,$password) - { - return $this->usernameExists($username); - } -} -</com:TTextHighlighter> -<p id="90091" class="block-content"> -The <tt>getGuestName()</tt> -method simply returns the name for a guest user and is not used in our application. -The <tt>getUser()</tt> method returns a <tt>TUser</tt> object if the username -exists in the database, the <tt>TUser</tt> object is set with role of "normal" -that corresponds to the <tt><authorization></tt> rules defined in our -<tt>config.xml</tt> file. </p> - -<p id="90092" class="block-content">The <tt>addNewUser()</tt> and <tt>usernameExists()</tt> -method uses the ActiveRecord corresponding to the <tt>chat_users</tt> table to -add a new user and to check if a username already exists, respectively. -</p> - -<p id="90093" class="block-content">The next thing to do is change the <tt>config.xml</tt> configuration to use -our new custom user manager class. We simply change the <tt><module></tt> -configuration with <tt>id="users"</tt>.</p> -<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_90036"> -<module id="users" class="ChatUserManager" /> -</com:TTextHighlighter> - -<h1 id="18012">Authentication</h1> -<p id="90094" class="block-content">To perform authentication, we just want the user to enter a unique -username. We add a -<com:DocLink ClassPath="System.Web.UI.WebControls.TCustomValidator" Text="TCustomValidator" /> -for validate the uniqueness of the username and add an <tt>OnClick</tt> event handler -for the login button.</p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_90037"> -<com:TCustomValidator - ControlToValidate="username" - Display="Dynamic" - OnServerValidate="checkUsername" - ErrorMessage="The username is already taken." /> - -... - -<com:TButton Text="Login" OnClick="createNewUser" /> -</com:TTextHighlighter> -In the <tt>Login.php</tt> file, we add the following 2 methods. -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90038"> -function checkUsername($sender, $param) -{ - $manager = $this->Application->Modules['users']; - if($manager->usernameExists($this->username->Text)) - $param->IsValid = false; -} - -function createNewUser($sender, $param) -{ - if($this->Page->IsValid) - { - $manager = $this->Application->Modules['users']; - $manager->addNewUser($this->username->Text); - - //do manual login - $user = $manager->getUser($this->username->Text); - $auth = $this->Application->Modules['auth']; - $auth->updateSessionUser($user); - $this->Application->User = $user; - - $url = $this->Service->constructUrl($this->Service->DefaultPage); - $this->Response->redirect($url); - } -} -</com:TTextHighlighter> -The <tt>checkUserName()</tt> method uses the <tt>ChatUserManager</tt> class -(recall that in the <tt>config.xml</tt> configuration we set the -ID of the custom user manager class as "users") to validate the username -is not taken. -</p> -<p id="90095" class="block-content"> -In the <tt>createNewUser</tt> method, when the validation passes (that is, -when the user name is not taken) we add a new user. Afterward we perform -a manual login process:</p> -<ul id="u2" class="block-content"> - <li>First we obtain a <tt>TUser</tt> instance from -our custom user manager class using the <tt>$manager->getUser(...)</tt> method.</li> - <li>Using the <tt>TAuthManager</tt> we set/update the user object in the - current session data.</li> - <li>Then we set/update the <tt>Application</tt>'s user instance with our - new user object.</li> -</ul> -</p> -<p id="finally" class="block-content"> -Finally, we redirect the client to the default <tt>Home</tt> page. -</p> - -<h2 id="18021">Default Values for ActiveRecord</h2> -<p id="90096" class="block-content">If you try to perform a login now, you will receive an error message like -"<i>Property '<tt>ChatUserRecord::$last_activity</tt>' must not be null as defined -by column '<tt>last_activity</tt>' in table '<tt>chat_users</tt>'.</i>". This means that the <tt>$last_activity</tt> -property value was null when we tried to insert a new record. We need to either -define a default value in the corresponding column in the table and allow null values or set the default -value in the <tt>ChatUserRecord</tt> class. We shall demonstrate the later by -altering the <tt>ChatUserRecord</tt> with the addition of a set getter/setter -methods for the <tt>last_activity</tt> property. - -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90039"> -private $_last_activity; - -public function getLast_Activity() -{ - if($this->_last_activity === null) - $this->_last_activity = time(); - return $this->_last_activity; -} - -public function setLast_Activity($value) -{ - $this->_last_activity = $value; -} -</com:TTextHighlighter> -Notice that we renamed <tt>$last_activity</tt> to <tt>$_last_activity</tt> (note -the underscore after the dollar sign). -</p> - -<h1 id="18013">Main Chat Application</h1> -<p id="90097" class="block-content">Now we are ready to build the main chat application. We use a simple -layout that consist of one panel holding the chat messages, one panel -to hold the users list, a textarea for the user to enter the text message -and a button to send the message. -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_90040"> -<!doctype html public "-//W3C//DTD XHTML 1.0 Strict//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> -<head> - <title>Prado Chat Demo</title> -<style> -.messages -{ - width: 500px; - height: 300px; - float: left; - border: 1px solid ButtonFace; - overflow: auto; -} -.user-list -{ - margin-left: 2px; - float: left; - width: 180px; - height: 300px; - border: 1px solid ButtonFace; - overflow: auto; - font-size: 0.85em; -} -.message-input -{ - float: left; -} - -.message-input textarea -{ - margin-top: 3px; - padding: 0.4em 0.2em; - width: 493px; - font-family: Verdana, Geneva, Arial, Helvetica, sans-serif; - font-size: 0.85em; - height: 40px; -} -.send-button -{ - margin: 0.5em; -} -</style> -</head> -<body> -<com:TForm> -<h1 id="18014">Prado Chat Demo</h1> -<div id="messages" class="messages"> - <com:TPlaceHolder ID="messageList" /> -</div> -<div id="users" class="user-list"> - <com:TPlaceHolder ID="userList" /> -</div> -<div class="message-input"> - <com:TActiveTextBox ID="userinput" - Columns="40" Rows="2" TextMode="MultiLine" /> - <com:TActiveButton ID="sendButton" CssClass="send-button" - Text="Send" /> -</div> -</com:TForm> -</body> -</html> -</com:TTextHighlighter> -We added two Active Control components: a -<com:DocLink ClassPath="System.Web.UI.ActiveControls.TActiveTextBox" Text="TActiveTextBox" /> -and a -<com:DocLink ClassPath="System.Web.UI.ActiveControls.TActiveButton" Text="TActiveButton" />. -We also added a -<com:DocLink ClassPath="System.Web.UI.WebControls.TJavascriptLogger" Text="TJavascriptLogger" /> -that will be very useful for understanding how the Active Controls work. -</p> - -<h2 id="18022">Exploring the Active Controls</h2> -<p id="90098" class="block-content">We should have some fun before we proceeding with setting up the chat buffering. We want -to see how we can update the current page when we receive a message. First, we add -an <tt>OnClick</tt> event handler for the <tt>Send</tt> button. - -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_90041"> -<com:TActiveButton ID="sendButton" CssClass="send-button" - Text="Send" OnClick="processMessage"/> -</com:TTextHighlighter> -And the corresponding event handler method in the <tt>Home.php</tt> class (we -need to create this new file too). -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90042"> -class Home extends TPage -{ - function processMessage($sender, $param) - { - echo $this->userinput->Text; - } -} -</com:TTextHighlighter> -If you now type something in the main application textbox and click the send button -you should see whatever you have typed echoed in the <tt>TJavascriptLogger</tt> console. -</p> - -<p id="90099" class="block-content">To append or add some content to the message list panel, we need to use -some methods in the -<com:DocLink ClassPath="System.Web.UI.ActiveControls.TCallbackClientScript" Text="TCallbackClientScript" /> -class which is available through the <tt>CallbackClient</tt> property of the -current <tt>TPage</tt> object. For example, we do can do -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90043"> -function processMessage($sender, $param) -{ - $this->CallbackClient->appendContent("messages", $this->userinput->Text); -} -</com:TTextHighlighter> -This is one way to update some part of the existing page during a callback (AJAX style events) -and will be the primary way we will use to implement the chat application. -</p> - -<h1 id="18015">Active Record for <tt>chat_buffer</tt> table</h1> -<p id="90100" class="block-content">To send a message to all the connected users we need to buffer or store -the message for each user. We can use the database to buffer the messages. The -<tt>chat_buffer</tt> table is defined as follows. -<com:TTextHighlighter Language="text" CssClass="source block-content" id="code_90044"> -CREATE TABLE chat_buffer -( - id INTEGER PRIMARY KEY, - for_user VARCHAR(20) NOT NULL, - from_user VARCHAR(20) NOT NULL, - message TEXT NOT NULL, - created_on INTEGER NOT NULL DEFAULT "0" -); -</com:TTextHighlighter> -The corresponding <tt>ChatBufferRecord</tt> class is saved as -<tt>App_Code/ChatBufferRecord.php</tt>. - -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90045"> -class ChatBufferRecord extends TActiveRecord -{ - const TABLE='chat_buffer'; - - public $id; - public $for_user; - public $from_user; - public $message; - private $_created_on; - - public function getCreated_On() - { - if($this->_created_on === null) - $this->_created_on = time(); - return $this->_created_on; - } - - public function setCreated_On($value) - { - $this->_created_on = $value; - } - - public static function finder($className=__CLASS__) - { - return parent::finder($className); - } -} -</com:TTextHighlighter> -</p> - -<h1 id="18016">Chat Application Logic</h1> -<p id="90101" class="block-content">We finally arrive at the guts of the chat application logic. First, we -need to save a received message into the chat buffer for <b>all</b> the -current users. We add this logic in the <tt>ChatBufferRecord</tt> class. - -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90046"> -public function saveMessage() -{ - foreach(ChatUserRecord::finder()->findAll() as $user) - { - $message = new self; - $message->for_user = $user->username; - $message->from_user = $this->from_user; - $message->message = $this->message; - $message->save(); - if($user->username == $this->from_user) - { - $user->last_activity = time(); //update the last activity; - $user->save(); - } - } -} -</com:TTextHighlighter> -We first find all the current users using the <tt>ChatUserRecord</tt> finder -methods. Then we duplicate the message and save it into the database. In addition, -we update the message sender's last activity timestamp. The above piece of code -demonstrates the simplicity and succinctness of using ActiveRecords for simple database designs. -</p> - -<p id="90102" class="block-content">The next piece of the logic is to retrieve the users' messages from the buffer. -We simply load all the messages for a particular username and format that message -appropriately (remember to escape the output to prevent Cross-Site Scripting attacks). -After we load the messages, we delete those loaded messages and any older -messages that may have been left in the buffer. -</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90047"> -public function getUserMessages($user) -{ - $content = ''; - foreach($this->findAll('for_user = ?', $user) as $message) - $content .= $this->formatMessage($message); - $this->deleteAll('for_user = ? OR created_on < ?', - $user, time() - 300); //5 min inactivity - return $content; -} - -protected function formatMessage($message) -{ - $user = htmlspecialchars($message->from_user); - $content = htmlspecialchars($message->message); - return "<div class=\"message\"><strong>{$user}:</strong>" - ." <span>{$content}</span></div>"; -} -</com:TTextHighlighter> - -To retrieve a list of current users (formatted), we add this logic to the -<tt>ChatUserRecord</tt> class. We delete any users that may have been inactive -for awhile. -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90048"> -public function getUserList() -{ - $this->deleteAll('last_activity < ?', time()-300); //5 min inactivity - $content = '<ul>'; - foreach($this->findAll() as $user) - $content .= '<li>'.htmlspecialchars($user->username).'</li>'; - $content .= '</ul>'; - return $content; -} -</com:TTextHighlighter> - -<div class="note"><b class="tip">Note:</b> -For simplicity -we formatted the messages in these Active Record classes. For large applications, -these message formatting tasks should be done using Prado components (e.g. using -a TRepeater in the template or a custom component). -</div> -</p> - -<h1 id="18017">Putting It Together</h1> -<p id="90103" class="block-content">Now comes to put the application flow together. In the <tt>Home.php</tt> we update -the <tt>Send</tt> buttons <tt>OnClick</tt> event handler to use the application -logic we just implemented. -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90049"> -function processMessage($sender, $param) -{ - if(strlen($this->userinput->Text) > 0) - { - $record = new ChatBufferRecord(); - $record->message = $this->userinput->Text; - $record->from_user = $this->Application->User->Name; - $record->saveMessage(); - - $this->userinput->Text = ''; - $messages = $record->getUserMessages($this->Application->User->Name); - $this->CallbackClient->appendContent("messages", $messages); - $this->CallbackClient->focus($this->userinput); - } -} -</com:TTextHighlighter> -We simply save the message to the chat buffer and then ask for all the messages -for the current user and update the client side message list using a callback -response (AJAX style). -</p> - -<p id="90104" class="block-content">At this point the application is actually already functional, just not very -user friendly. If you open two different browsers, you should be able to communicate -between the two users whenever the <tt>Send</tt> button is clicked. -</p> - -<p id="90105" class="block-content">The next part is perhaps the more tricker and fiddly than the other tasks. We -need to improve the user experience. First, we want a list of current users -as well. So we add the following method to <tt>Home.php</tt>, we can call -this method when ever some callback event is raised, e.g. when the <tt>Send</tt> -button is clicked. -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90050"> -protected function refreshUserList() -{ - $lastUpdate = $this->getViewState('userList',''); - $users = ChatUserRecord::finder()->getUserList(); - if($lastUpdate != $users) - { - $this->CallbackClient->update('users', $users); - $this->setViewstate('userList', $users); - } -} -</com:TTextHighlighter> -</p> - -<p id="90106" class="block-content">Actually, we want to periodically update the messages and user list as new -users join in and new message may arrive from other users. So we need to refresh -the message list as well.</p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90051"> -function processMessage($sender, $param) -{ - ... - $this->refreshUserList(); - $this->refreshMessageList(); - ... -} - -protected function refreshMessageList() -{ - //refresh the message list - $finder = ChatBufferRecord::finder(); - $content = $finder->getUserMessages($this->Application->User->Name); - if(strlen($content) > 0) - { - $anchor = (string)time(); - $content .= "<a href=\"#\" id=\"{$anchor}\"> </a>"; - $this->CallbackClient->appendContent("messages", $content); - $this->CallbackClient->focus($anchor); - } -} -</com:TTextHighlighter> -The anchor using <tt>time()</tt> as ID for a focus point is so that when the -message list on the client side gets very long, the focus method will -scroll the message list to the latest message (well, it works in most browsers). -</p> - -<p id="90107" class="block-content">Next, we need to redirect the user back to the login page if the user has -been inactive for some time, say about 5 mins, we can add this check to any stage -of the page life-cycle. Lets add it to the <tt>onLoad()</tt> stage. -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90052"> -public function onLoad($param) -{ - $username = $this->Application->User->Name; - if(!$this->Application->Modules['users']->usernameExists($username)) - { - $auth = $this->Application->Modules['auth']; - $auth->logout(); - - //redirect to login page. - $this->Response->Redirect($this->Service->ConstructUrl($auth->LoginPage)); - } -} -</com:TTextHighlighter> -</p> - -<h1 id="18018">Improving User Experience</h1> -<p id="90108" class="block-content">The last few details are to periodically check for new messages and -refresh the user list. We can accomplish this by polling the server using a -<com:DocLink ClassPath="System.Web.UI.ActiveControls.TTimeTriggeredCallback" Text="TTimeTriggeredCallback" /> -control. We add a <tt>TTimeTriggeredCallback</tt> to the <tt>Home.page</tt> -and call the <tt>refresh</tt> handler method defined in <tt>Home.php</tt>. -We set the polling interval to 2 seconds. -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_90053"> -<com:TTimeTriggeredCallback OnCallback="refresh" - Interval="2" StartTimerOnLoad="true" /> -</com:TTextHighlighter> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90054"> -function refresh($sender, $param) -{ - $this->refreshUserList(); - $this->refreshMessageList(); -} -</com:TTextHighlighter> -</p> - -<p id="90109" class="block-content">The final piece requires us to use some javascript. We want that when the -user type some text in the textarea and press the <tt>Enter</tt> key, we want it -to send the message without clicking on the <tt>Send</tt> button. We add to the -<tt>Home.page</tt> some javascript. - -<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_90055"> -<com:TClientScript> -Event.observe($("<%= $this->userinput->ClientID %>"), "keypress", function(ev) -{ - if(Event.keyCode(ev) == Event.KEY_RETURN) - { - if(Event.element(ev).value.length > 0) - new Prado.Callback("<%= $this->sendButton->UniqueID %>"); - Event.stop(ev); - } -}); -</com:TClientScript> -</com:TTextHighlighter> -Details regarding the javascript can be explored in the -<a href="?page=Advanced.Scripts">Introduction to Javascript</a> section of the quickstart. -</p> - -<p id="90110" class="block-content">This completes the tutorial on making a basic chat web application using -the Prado framework. Hope you have enjoyed it. -</p> - -</com:TContent> diff --git a/demos/quickstart/protected/pages/Tutorial/fr/CurrencyConverter.page b/demos/quickstart/protected/pages/Tutorial/fr/CurrencyConverter.page deleted file mode 100755 index 6b8c7bc3..00000000 --- a/demos/quickstart/protected/pages/Tutorial/fr/CurrencyConverter.page +++ /dev/null @@ -1,404 +0,0 @@ -<com:TContent ID="body"> - <h1 id="16001">Building a Simple Currency Converter</h1> - <p id="80053" class="block-content">This tutorial introduces the Prado web application framework and teaches - you how to build a simple web application in a few simple steps. This - tutorial assumes that you are familiar with PHP and you have access - to a web server that is able to serve PHP5 scripts. - </p> - - <p id="80054" class="block-content">In this tutorial you will build a simple web application that converts - a dollar amount to an other currency, given the rate of that currency - relative to the dollar. The completed application is shown bellow. - <img src=<%~ example2.png %> class="figure" /> - You can try the application <a href="../currency-converter/index.php">locally</a> or at - <a href="http://www.pradosoft.com/demos/currency-converter/">Pradosoft.com</a>. - Notice that the application still functions exactly the same if javascript - is not available on the user's browser. - </p> - - <h1 id="download">Downloading and Installing Prado</h1> - <p id="80055" class="block-content">To install Prado, simply download the latest version of Prado from - <a href="http://www.pradosoft.com/">http://www.pradosoft.com</a> - and unzip the file to a directory <b>not</b> accessible by your web server - (you may unzip it to a directory accessible by the web server if you wish - to see the demos and test). For further detailed installation, see the - <a href="?page=GettingStarted.Installation">Quickstart Installation</a> guide. - </p> - - <h1 id="16002">Creating a new Prado web Application</h1> - <p id="80056" class="block-content">The quickest and simplest way to create a new Prado web application is - to use the command tool <tt>prado-cli.php</tt> found in the <tt>framework</tt> - directory of the Prado distribution. We create a new application by running - the following command in your - command prompt or console. The command creates a new directory named - <tt>currency-converter</tt> in your current working directory. - You may need to change to the appropriate directory - first. - See the <a href="?page=GettingStarted.CommandLine">Command Line Tool</a> - for more details. - </p> -<com:TTextHighlighter Language="text" CssClass="source block-content" id="code111"> -php prado/framework/prado-cli.php -c currency-converter -</com:TTextHighlighter> - - <p id="80057" class="block-content">The above command creates the necessary directory structure and minimal - files (including "index.php" and "Home.page") to run a Prado web application. - Now you can point your browser's url to the web server to serve up - the <tt>index.php</tt> script in the <tt>currency-converter</tt> directory. - You should see the message "Welcome to Prado!" - </p> - - <h1 id="16003">Creating the Currency Converter User Interface</h1> - <p id="80058" class="block-content">We start by editing the <tt>Home.page</tt> file found in the - <tt>currency-converter/protected/pages/</tt> directory. Files ending - with ".page" are page templates that contains HTML and Prado controls. - We simply add two textboxes, three labels and one button as follows. - </p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="form1"> -<com:TForm> - <fieldset> - <legend>Currency Converter</legend> - <div class="rate-field"> - <com:TLabel ForControl="currencyRate" Text="Exchange Rate per $1:" /> - <com:TTextBox ID="currencyRate" /> - </div> - <div class="dollar-field"> - <com:TLabel ForControl="dollars" Text="Dollars to Convert:" /> - <com:TTextBox ID="dollars" /> - </div> - <div class="total-field"> - <span class="total-label">Amount in Other Currency:</span> - <com:TLabel ID="total" CssClass="result" /> - </div> - <div class="convert-button"> - <com:TButton Text="Convert" /> - </div> - </fieldset> -</com:TForm> -</com:TTextHighlighter> - <p id="refresh" class="block-content"> - If you refresh the page, you should see something similar to the following figure. - It may not look very pretty or orderly, but we shall change that later using CSS. - <img src=<%~ example1.png %> class="figure" /> - </p> - - <p id="80059" class="block-content"> - The first component we add is a - <com:DocLink ClassPath="System.Web.UI.TForm" Text="TForm" /> - that basically corresponds to the HTML <tt><form></tt> element. - In Prado, only <b>one</b> <tt>TForm</tt> element is allowed per page. - </p> - - <p id="80060" class="block-content">The next two pair of component we add is the - <com:DocLink ClassPath="System.Web.UI.WebControls.TLabel" Text="TLabel" /> - and - <com:DocLink ClassPath="System.Web.UI.WebControls.TTextBox" Text="TTextBox" /> - that basically defines a label and a textbox for the user of the application - to enter the currency exchange rate. - The <tt>ForControl</tt> property value determines which component - that the label is for. This allows the user of the application to click - on the label to focus on the field (a good thing). You could have used - a plain HTML <tt><label></tt> element to do the same thing, but - you would have to find the correct <tt>ID</tt> of the textbox (or - <tt><input></tt> in HTML) as Prado components may/will render the - <tt>ID</tt> value differently in the HTML output. - </p> - - <p id="80061" class="block-content">The next pair of components are similar and defines the textbox - to hold the dollar value to be converted. - The <tt>TLabel</tt> with <tt>ID</tt> value "total" defines a simple label. - Notice that the <tt>ForControl</tt> property is absent. This means that this - label is simply a simple label which we are going to use to display the - converted total amount. - </p> - - <p id="80062" class="block-content">The final component is a - <com:DocLink ClassPath="System.Web.UI.WebControls.TButton" Text="TButton" /> - that the user will click to calculate the results. The <tt>Text</tt> - property sets the button label. - </p> - - <h1 id="16004">Implementing Currency Conversion</h1> - - <p id="80063" class="block-content">If you tried clicking on the "Convert" button then the page will refresh - and does not do anything else. For the button to do some work, we need - to add a "Home.php" to where "Home.page" is. The <tt>Home</tt> class - should extends the - <com:DocLink ClassPath="System.Web.UI.TPage" Text="TPage" />, the default base - class for all Prado pages. - </p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code3"> -<?php -class Home extends TPage -{ - -} -</com:TTextHighlighter> - <p id="1111" class="block-content"> - Prado uses PHP's <tt>__autoload</tt> method to load classes. The convention - is to use the class name with ".php" extension as filename. - </p> - - <p id="80064" class="block-content">So far there is nothing interesting about Prado, we just declared some - "web components" in some template file named Home.page and created - a "Home.php" file with a <tt>Home</tt> class. The more interesting - bits are in Prado's event-driven architecture as we shall see next. - </p> - - <p id="80065" class="block-content">We want that when the user click on the "Convert" button, we take the - values in the textbox, do some calculation and present the user with - the converted total. To handle the user clicking of the "Convert" button - we simply add an <tt>OnClick</tt> property to the "Convert" button in - the "Home.page" template and add a corresponding event handler method - in the "Home.php". - </p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code4"> -<com:TButton Text="Convert" OnClick="convert_clicked" /> -</com:TTextHighlighter> - <p id="222" class="block-content"> - The value of the <tt>OnClick</tt>, "<tt>convert_clicked</tt>", will be the method - name in the "Home.php" that will called when the user clicks on the - "Convert" button. - </p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code5"> -class Home extends TPage -{ - public function convert_clicked($sender, $param) - { - $rate = floatval($this->currencyRate->Text); - $dollars = floatval($this->dollars->Text); - $this->total->Text = $rate * $dollars; - } -} -</com:TTextHighlighter> -<div id="3332" class="block-content"> - <p id="333"> - If you run the application in your web browser, enter some values and click - the "Convert" button then you should see that calculated value displayed next - to the "Amount in Other Currency" label. - </p> - - <p id="80066">In the "<tt>convert_clicked</tt>" method the first parameter, <tt>$sender</tt>, - corresponds to the object that raised the event, in this case, - the "Convert" button. The second parameter, <tt>$param</tt> contains - any additional data that the <tt>$sender</tt> object may wish to have added. - </p> - - <p id="80067">We shall now examine, the three lines that implements the simply currency - conversion in the "<tt>convert_clicked</tt>" method. - </p> -</div> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code6" > -$rate = floatval($this->currencyRate->Text); -</com:TTextHighlighter> - <p id="444" class="block-content"> - The statement <tt>$this->currencyRate</tt> corresponds to the - <tt>TTextBox</tt> component with <tt>ID</tt> value "currencyRate" in the - "Home.page" template. The <tt>Text</tt> property of the <tt>TTextBox</tt> - contains the value that the user entered. So, we obtain this - value by <tt>$this->currencyRate->Text</tt> which we convert the - value to a float value. - </p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code7"> -$dollars = floatval($this->dollars->Text); -</com:TTextHighlighter> -<div id="5551" class="block-content"> - <p id="555"> - The next line does a similar things, it takes the user value from - the <tt>TTextBox</tt> with <tt>ID</tt> value "dollars and converts it to - a float value. - </p> - - <p id="80068">The third line calculates the new amount and set this value in the - <tt>Text</tt> property of the <tt>TLabel</tt> with <tt>ID="total"</tt>. - Thus, we display the new amount to the user in the label. - </p> -</div> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code8"> -$this->total->Text = $rate * $dollars; -</com:TTextHighlighter> - - <h1 id="16005">Adding Validation</h1> - <p id="80069" class="block-content">The way we convert the user entered value to float ensures that the - total amount is always a number. So the user is free to enter what - ever they like, they could even enter letters. The user's experience - in using the application can be improved by adding validators - to inform the user of the allowed values in the currency rate and the - amount to be calcuated. - </p> - - <p id="80070">For the currency rate, we should ensure that</p> - <ol id="o111" class="block-content"> - <li>the user enters a value,</li> - <li>the currency rate is a valid number,</li> - <li>the currency rate is positive.</li> - </ol> - <p id="666" class="block-content"> - To ensure 1 we add one - <com:DocLink ClassPath="System.Web.UI.WebControls.TRequiredFieldValidator" Text="TRequiredFieldValidator" />. To ensure 2 and 3, we add one - <com:DocLink ClassPath="System.Web.UI.WebControls.TCompareValidator" Text="TCompareValidator" />. We may add these validators any where within - the "Home.page" template. Further details regarding these validator and other - validators can be found in the - <a href="?page=Controls.Validation">Validation Controls</a> page. - </p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code9"> -<com:TRequiredFieldValidator - ControlToValidate="currencyRate" - ErrorMessage="Please enter a currency rate." /> -<com:TCompareValidator - ControlToValidate="currencyRate" - DataType="Float" - ValueToCompare="0" - Operator="GreaterThan" - ErrorMessage="Please enter a positive currency rate." /> -</com:TTextHighlighter> - - <p id="80071" >For the amount to be calculated, we should ensure that</p> - <ol id="o222" class="block-content"> - <li>the user enters a value,</li> - <li>the value is a valid number (not including any currency or dollar signs).</li> - </ol> - <p id="777" class="block-content"> - To ensure 1 we just add another <tt>TRequiredFieldValidator</tt>, for 2 - we could use a - <com:DocLink ClassPath="System.Web.UI.WebControls.TDataTypeValidator" Text="TDataTypeValidator" />. For simplicity we only allow the user to enter - a number for the amount they wish to convert. - </p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code9a"> -<com:TRequiredFieldValidator - ControlToValidate="dollars" - ErrorMessage="Please enter the amount you wish to calculate." /> -<com:TDataTypeValidator - ControlToValidate="dollars" - DataType="Float" - ErrorMessage="Please enter a number." /> -</com:TTextHighlighter> - </p> - - <p id="80072" class="block-content">Now if you try to enter some invalid data in the application or left out - any of the fields the validators will be activated and present the user - with error messages. Notice that the error messages are presented - without reloading the page. Prado's validators by default validates - using both javascript and server side. The server side validation - is <b>always performed</b>. For the server side, we - should skip the calculation if the validators are not satisfied. This can - done as follows. - </p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code10" > -public function convert_clicked($sender, $param) -{ - if($this->Page->IsValid) - { - $rate = floatval($this->currencyRate->Text); - $dollars = floatval($this->dollars->Text); - $this->total->Text = $rate * $dollars; - } -} -</com:TTextHighlighter> - - <h1 id="16006">Improve User Experience With Active Controls</h1> - <p id="80073" class="block-content">In this simple application we may further improve the user experience - by increasing the responsiveness of the application. One way to achieve - a faster response is calculate and present the results without reloading - the whole page. - </p> - - <p id="80074" class="block-content">We can replace the <tt>TButton</tt> with the Active Control counter part, - <com:DocLink ClassPath="System.Web.UI.ActiveControls.TActiveButton" Text="TActiveButton" />, - that can trigger a server side click event without reloading the page. - In addition, we can change the "totals" <tt>TLabel</tt> with the - Active Control counter part, - <com:DocLink ClassPath="System.Web.UI.ActiveControls.TActiveLabel" Text="TActiveLabel" />, such that the server side can update the browser without - reloading the page. - </p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code11"> -<div class="total-field"> - <span class="total-label">Amount in Other Currency:</span> - <com:TActiveLabel ID="total" CssClass="result" /> - </div> - <div class="convert-button"> - <com:TActiveButton Text="Convert" OnClick="convert_clicked" /> -</div> -</com:TTextHighlighter> - <p id="1232" class="block-content"> - The server side logic remains the same, we just need to import the - Active Controls name space as they are not included by default. We - add the following line to the begin of "Home.php". - </p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code12"> -Prado::using('System.Web.UI.ActiveControls.*'); -</com:TTextHighlighter> - - <p id="80075" class="block-content">If you try the application now, you may notice that the page no longer - needs to reload to calculate and display the converted total amount. - However, since there is not page reload, there is no indication or not obvious - that by clicking on the "Convert" button any has happened. - We can further refine the user experience by change the text of "total" label - to "calculating..." when the user clicks on the "Convert" button. The text of - the "total" label will still be updated with the new calculate amount as before. - </p> - - <p id="80076" class="block-content">To indicate that the calculation is in progress, we can change the text - of the "total" label as follows. We add a <tt>ClientSide.OnLoading</tt> property - to the "Convert" button (since this button is responsible for requesting - the calculation). - </p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code13"> -<com:TActiveButton Text="Convert" OnClick="convert_clicked" > - <prop:ClientSide.OnLoading> - $('<%= $this->total->ClientID %>').innerHTML = "calculating..." - </prop:ClientSide.OnLoading> -</com:TActiveButton> -</com:TTextHighlighter> - - <p id="80077" class="block-content">The <tt>ClientSide.OnLoading</tt> and various - <com:DocLink ClassPath="System.Web.UI.ActiveControls.TCallbackClientSide" Text="other properties" /> accept a javascript block as their content or value. - The javascript code <tt>$('...')</tt> is a javascript function that is - equivalent to <tt>document.getElementById('...')</tt> that takes a string - with the ID of an HTML element. Since Prado renders its components's IDs, we need - to use the rendered ID of the "total" label, that is, <tt>$this->total->ClientID</tt>. We place this bit of code within a <tt><%= %></tt> to obtain the rendered HTML ID for the "total" label. The rest of the - javascript code <tt>innerHTML = "calculating..."</tt> simply changes - the content of the "total" label. - </p> - - <h1 id="16007">Adding Final Touches</h1> - <p id="80078" class="block-content">So far we have built a simple currency converter web application with - little attention of the looks and feel. Now we can add a stylesheet - to improve the overall appearance of the application. We can simply - add the stylesheet inline with the template code or we may create - a "theme". - </p> - - <p id="80079" class="block-content">To create and use a theme with Prado applications, we simply create a new - directory "themes/Basic" in the <tt>currency-converter</tt> directory. - You may need to create the <tt>themes</tt> directory first. Any - directory within the <tt>themes</tt> are considered as a theme with the - name of the theme being the directory name. See the - <a href="?page=Advanced.Themes">Themes and Skins</a> for further details. - </p> - - <p id="80080" class="block-content">We simply create a CSS file named "common.css" and save it in the - <tt>themes/Basic</tt> directory. Then we add the following code - to the beginning of "Home.page" (we add a little more HTML as well). - </p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code14"> -<%@ Theme="Basic" %> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" -"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" > -<com:THead Title="Currency Converter" /> -<body> -</com:TTextHighlighter> - <p id="4334" class="block-content"> - The first line <tt><%@ Theme="Basic" %></tt> defines the - theme to be used for this page. The - <com:DocLink ClassPath="System.Web.UI.WebControls.THead" Text="THead" /> - corresponds to the HTML <tt><head></tt> element. In addition - to display the <tt>Title</tt> property by the <tt>THead</tt>, all CSS - files in the <tt>themes/Basic</tt> directory are also rendered/linked - for the current page. Our final currency converter web application - looks like the following. - <img src=<%~ example2.png %> class="figure" /> - This completes introduction tutorial to the Prado web application framework. - </p> -</com:TContent> diff --git a/demos/quickstart/protected/pages/Tutorial/fr/chat1.png b/demos/quickstart/protected/pages/Tutorial/fr/chat1.png Binary files differdeleted file mode 100755 index 8288b496..00000000 --- a/demos/quickstart/protected/pages/Tutorial/fr/chat1.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Tutorial/fr/chat2.png b/demos/quickstart/protected/pages/Tutorial/fr/chat2.png Binary files differdeleted file mode 100755 index 97cbc51d..00000000 --- a/demos/quickstart/protected/pages/Tutorial/fr/chat2.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Tutorial/fr/example1.png b/demos/quickstart/protected/pages/Tutorial/fr/example1.png Binary files differdeleted file mode 100755 index 0c7da7ba..00000000 --- a/demos/quickstart/protected/pages/Tutorial/fr/example1.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Tutorial/fr/example2.png b/demos/quickstart/protected/pages/Tutorial/fr/example2.png Binary files differdeleted file mode 100755 index 1df56cfb..00000000 --- a/demos/quickstart/protected/pages/Tutorial/fr/example2.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Tutorial/id/AddressBook.page b/demos/quickstart/protected/pages/Tutorial/id/AddressBook.page deleted file mode 100755 index 3e930df1..00000000 --- a/demos/quickstart/protected/pages/Tutorial/id/AddressBook.page +++ /dev/null @@ -1,8 +0,0 @@ -<com:TContent ID="body">
- <h1 id="22007">Buku Alamat Sederhana</h1>
- <p id="110006" class="block-content">Tutorial ini memperkenalkan dasar penyambungan ke sebuah database
- menggunakan <a href="?page=Database.ActiveRecord">ActiveRecord</a>
- dan menggunakan <a href="?page=Database.Scaffold">Kerangka Rekaman Aktif</a> untuk secara cepat membangun sebuah buku alamat sederhana.
- </p>
-
-</com:TContent>
\ No newline at end of file diff --git a/demos/quickstart/protected/pages/Tutorial/id/AjaxChat.page b/demos/quickstart/protected/pages/Tutorial/id/AjaxChat.page deleted file mode 100755 index 50759868..00000000 --- a/demos/quickstart/protected/pages/Tutorial/id/AjaxChat.page +++ /dev/null @@ -1,685 +0,0 @@ -<com:TContent ID="body">
- <h1 id="18008">Membangun Aplikasi Obrolan AJAX</h1>
- <com:RequiresVersion Version="3.1a" />
- <p id="90081" class="block-content">Tutorial ini memperkenalkan kerangka kerja aplikasi web Prado
- <a href="?page=Database.ActiveRecord">ActiveRecord</a>
- dan <a href="?page=ActiveControls.Home">Kontrol Aktif</a> untuk membangun aplikasi web Chat. Diasumsikan bahwa Anda sudah terbiasa dengan PHP dan akan telah mengakses server web yang dapat melayani naskah PHP5.
- Aplikasi chat dasar ini akan memanfaatkan ide/komponen berikut dalam Prado.
- </p>
- <ul id="u1" class="block-content">
- <li>Membangun kelas kustom Manajer Pengguna.</li>
- <li>Mengotentikasi dan menambahkan pengguna ke database.</li>
- <li>Menggunakan ActiveRecord untuk berinteraksi dengan database.</li>
- <li>Menggunakan Kontrol Aktif dan callbacks untuk menerapkan antarmuka pengguna.</li>
- <li>Memisahkan logika aplikasi dan alur aplikasi.</li>
- </ul>
-
- <p id="90082" class="block-content">Dalam tutorial ini Anda akan membangun sebuah aplikasi web Chat AJAX yang membolehkan
- multipel pengguna untuk berkomunikasi melalui web browser mereka.
- Aplikasi terdiri dari dua halaman: halaman masuk yang menanyakan pada
- pengguna untuk memasukkan nama panggilannya dan halaman aplikasi chat utama.
- Anda dapat mencoba aplikasi <a href="../chat/index.php">secara lokal</a> atau di
- <a href="http://www.pradosoft.com/demos/chat/">Pradosoft.com</a>.
- Aplikasi chat utama ditampilkan di bawah ini.
- <img src=<%~ chat1.png %> class="figure" />
- </p>
-
- <h1 id="18009">Download, Instalasi dan Buat Aplikasi Baru</h1>
- <p id="90083" class="block-content">Langkah download dan instalasi mirip dengan
- <a href="?page=Tutorial.CurrencyConverter#download">Tutorial pengubah kurs</a>.
- Untuk membuat aplikasi, kita menjalankan dari baris perintah berikut.
- Lihat <a href="?page=GettingStarted.CommandLine">Piranti Baris Perintah</a>
- untuk lebih jelasnya.
-<com:TTextHighlighter Language="text" CssClass="source block-content" id="code_90027">
-php prado/framework/prado-cli.php -c chat
-</com:TTextHighlighter>
- </p>
-
- <p id="90084" class="block-content">Perintah di atas membuat struktur direktori yang diperlukan dan file minimal (termasuk "index.php" dan "Home.page") untuk menjalankan aplikasi web Prado.
- Sekarang Anda dapat mengarahkan URL browser Anda ke server web untuk melayani
- naskah <tt>index.php</tt> dalam direktori <tt>chat</tt>.
- Anda seharusnya melihat pesan "Welcome to Prado!"
- </p>
-
- <h1 id="18010">Otentikasi dan Otorisasi</h1>
- <p id="90085" class="block-content">Tugas pertama untuk aplikasi ini adalah memastikan bahwa setiap pengguna
- dari aplikasi chat memiliki nama pengguna (dipilih oleh pengguna)
- unik. Untuk melaksanakan ini, kita akan mengamankan halaman aplikasi chat utama
- untuk menolak akses bagai pengguna anonim. Pertama, mari kita membuat halaman <tt>Login</tt>
- dengan kode berikut. Kita simpan <tt>Login.php</tt> dan <tt>Login.page</tt>
- dalam direktori <tt>chat/protected/pages/</tt> (di sana harus ada file <tt>Home.page</tt>
- yang dibuat oleh piranti baris perintah).
- </p>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90028">
-<?php
-class Login extends TPage
-{
-}
-</com:TTextHighlighter>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_90029">
-<!doctype html public "-//W3C//DTD XHTML 1.0 Strict//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
- <title>Prado Chat Demo Login</title>
-</head>
-<body>
-<com:TForm>
- <h1 class="login">Prado Chat Demo Login</h1>
- <fieldset class="login">
- <legend>Please enter your name:</legend>
- <div class="username">
- <com:TLabel ForControl="username" Text="Username:" />
- <com:TTextBox ID="username" MaxLength="20" />
- <com:TRequiredFieldValidator
- ControlToValidate="username"
- Display="Dynamic"
- ErrorMessage="Please provide a username." />
- </div>
- <div class="login-button">
- <com:TButton Text="Login" />
- </div>
-</com:TForm>
-</body>
-</html>
-</com:TTextHighlighter>
- <p id="90086" class="block-content">Halaman login berisi
- a <com:DocLink ClassPath="System.Web.UI.TForm" Text="TForm" />,
- a <com:DocLink ClassPath="System.Web.UI.WebControls.TTextBox" Text="TTextBox" />,
- a <com:DocLink ClassPath="System.Web.UI.WebControls.TRequiredFieldValidator" Text="TRequiredFieldValidator" />
- dan <com:DocLink ClassPath="System.Web.UI.WebControls.TButton" Text="TButton" />. Halaman yang dihasilkan terlihat seperti berikut (setelah menerapkan beberapa style sheet).
- <img src=<%~ chat2.png %> class="figure" />
- Jika Anda mengklik pada tombol <tt>Login</tt> tanpa memasukan teks
- apapun dalam kotak teks nama pengguna, pesan kesalahan ditampilkan. Ini dikarenakan <com:DocLink ClassPath="System.Web.UI.WebControls.TRequiredFieldValidator" Text="TRequiredFieldValidator" />
- memerlukan pengguna untuk memasukan beberapa teks dalam kotak teks sebelum melanjutkan.
- </p>
-<h2 id="18019">Mengamankan halaman <tt>Home</tt></h2>
-<p id="90087" class="block-content">Sekarang kita menginginkan bahwa jika pengguna mencoba untuk mengakses halaman aplikasi utama, <tt>Home.page</tt>, sebelum masuk, pengguna diberi <tt>Login.page</tt> lebih dulu. Kita menambahkan file konfigurasi <tt>chat/protected/application.xml</tt> untuk mengimpor beberapa kelas yang harus kita pakai nanti.
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_90030">
-<?xml version="1.0" encoding="utf-8"?>
-<application id="Chat" Mode="Debug">
- <paths>
- <using namespace="System.Data.*" />
- <using namespace="System.Data.ActiveRecord.*" />
- <using namespace="System.Security.*" />
- <using namespace="System.Web.UI.ActiveControls.*" />
- </paths>
-</application>
-</com:TTextHighlighter>
-Selanjutnya, kita menambahkan file konfigurasi <tt>chat/protected/pages/config.xml</tt> guna mengamankan direktori <tt>pages</tt>.
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_90031">
-<?xml version="1.0" encoding="utf-8"?>
-<configuration>
- <modules>
- <module id="users" class="TUserManager" />
- <module id="auth" class="TAuthManager" UserManager="users" LoginPage="Login" />
- </modules>
- <authorization>
- <allow pages="Login" users="?" />
- <allow roles="normal" />
- <deny users="*" />
- </authorization>
-</configuration>
-</com:TTextHighlighter>
-Kita menyiapkan otentikasi menggunakan kelas standar seperti dijelaskan dalam
-<a href="?page=Advanced.Auth">tutorial cepat otentikasi/otorisasi</a>.
-Dalam definisi otorisasi, kita membolehkan pengguna anonim untuk mengakses halaman <tt>Login</tt> (pengguna anonim dietapkan dengan the <tt>?</tt> tanda tanya).
-Kita membolehkan setiap pengguna dengan aturan yang sama dengan "normal" (didefinisikan nanti) untuk mengakses semua halaman, yakni halaman <tt>Login</tt> dan <tt>Home</tt>.
-Terakhir, kita menolak semua pengguna tanpa aturan apapun untuk mengakses setiap halaman. Aturan otorisasi dijalankan pada basis sama pertama kali.
-</p>
-
-<p id="90088" class="block-content">Jika Anda mencoba untuk mengakses halaman <tt>Home</tt> dengan mengarahkan browser Anda ke
-<tt>index.php</tt> Anda akan dialihkan ke halaman <tt>Login</tt>.
-</p>
-
-<h1 id="18011">Rekaman Aktif untuk tabel <tt>chat_users</tt></h1>
-<p id="90089" class="block-content">Kelas <com:DocLink ClassPath="System.Secutity.TUserManager" Text="TUserManager" />
-hanya menyediakan daftar pengguna hanya-baca. Kita perlu untuk bisa menambah atau memasukan pengguna baru secara dinamis. Maka kita perlu untuk membuat kelas manajer pengguna kita sendiri.
-Pertama, kita menyiapkan database dengan tabel <tt>chat_users</tt> dan membuat sebuah ActiveRecord yang dapat bekerja pada tabel <tt>chat_users</tt> dengan mudah. Untuk demo, kita menggunakan <tt>sqlite</tt> sebagai database kita guna kemudahan menditribusikandemo. Demo dapat diperluas dengan mudah untuk memakai database lain seperti MySQL atau Postgres SQL.
-Kita mendefinisikan tabel <tt>chat_users</tt> sebagai berikut.
-<com:TTextHighlighter Language="text" CssClass="source block-content" id="code_90032">
-CREATE TABLE chat_users
-(
- username VARCHAR(20) NOT NULL PRIMARY KEY,
- last_activity INTEGER NOT NULL DEFAULT "0"
-);
-</com:TTextHighlighter>
-Selanjutnya kita mendefinisikan kelas <tt>ChatUserRecord</tt> dan menyimpannya sebagai <tt>chat/protected/App_Code/ChatUserRecord.php</tt> (Anda perlu untuk membuat direktori <tt>App_Code</tt> juga). Kita juga menyimpan file database sqlite sebagai <tt>App_Code/chat.db</tt>.
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90033">
-class ChatUserRecord extends TActiveRecord
-{
- const TABLE='chat_users';
-
- public $username;
- public $last_activity;
-
- public static function finder($className=__CLASS__)
- {
- return parent::finder($className);
- }
-}
-</com:TTextHighlighter>
-Sebelum menggunakan kelas <tt>ChatUserRecord</tt> kita perlu mengkonfigurasi koneksi database standar agar ActiveRecord berfungsi. Dalam <tt>chat/protected/application.xml</tt>
-kita mengimpor kelas dari direktori <tt>App_Code</tt> dan menambahkan
-<a href="?page=Database.ActiveRecord">modul konfigurasi ActiveRecord</a>.
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_90034">
-<?xml version="1.0" encoding="utf-8"?>
-<application id="Chat" Mode="Debug">
- <paths>
- <using namespace="Application.App_Code.*" />
- <using namespace="System.Data.*" />
- <using namespace="System.Data.ActiveRecord.*" />
- <using namespace="System.Security.*" />
- <using namespace="System.Web.UI.ActiveControls.*" />
- </paths>
- <modules>
- <module class="TActiveRecordConfig" EnableCache="true"
- Database.ConnectionString="sqlite:protected/App_Code/chat.db" />
- </modules>
-</application>
-</com:TTextHighlighter>
-</p>
-
-<h2 id="18020">Kelas Manajer Pengguna Kustom</h2>
-<p id="90090" class="block-content">Untuk menerapkan modul kelas kustom manajer pengguna kita cukup memperluas kelas <tt>TModule</tt> dan menerapkan antarmuka <tt>IUserManager</tt>. Metode <tt>getGuestName()</tt>, <tt>getUser()</tt> dan <tt>validateUser()</tt> diperlukan oleh antarmuka <tt>IUserManager</tt>.
-Kita menyimpan kelas manajer pengguna kustom sebagai <tt>App_Code/ChatUserManager.php</tt>.
-</p>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90035">
-class ChatUserManager extends TModule implements IUserManager
-{
- public function getGuestName()
- {
- return 'Guest';
- }
-
- public function getUser($username=null)
- {
- $user=new TUser($this);
- $user->setIsGuest(true);
- if($username !== null && $this->usernameExists($username))
- {
- $user->setIsGuest(false);
- $user->setName($username);
- $user->setRoles(array('normal'));
- }
- return $user;
- }
-
- public function addNewUser($username)
- {
- $user = new ChatUserRecord();
- $user->username = $username;
- $user->save();
- }
-
- public function usernameExists($username)
- {
- $finder = ChatUserRecord::finder();
- $record = $finder->findByUsername($username);
- return $record instanceof ChatUserRecord;
- }
-
- public function validateUser($username,$password)
- {
- return $this->usernameExists($username);
- }
-}
-</com:TTextHighlighter>
-<p id="90091" class="block-content">
-Metode <tt>getGuestName()</tt>
-mengembalikan nama untuk pengguna tamu dan tidak dipakai dalam aplikasi kita.
-Metode <tt>getUser()</tt> mengembalikan obyek <tt>TUser</tt> jika nama pengguna ada dalam database, obyek <tt>TUser</tt> disetel dengan aturan "normal"
-yang terkait ke aturan <tt><otorisasi></tt> yang didefinisikan dalam file
-<tt>config.xml</tt> kita. </p>
-
-<p id="90092" class="block-content">Metode <tt>addNewUser()</tt> dan <tt>usernameExists()</tt>
-menggunakan ActiveRecord terkait dengan tabel <tt>chat_users</tt> masing-masing untuk menambah pengguna baru dan untuk memeriksa apakah nama pengguna sudah ada atau belum.
-</p>
-
-<p id="90093" class="block-content">Hal berikutnya yang dilakukan adalah mengubah konfigurasi <tt>config.xml</tt> untuk menggunakan kelas manajer pengguna kustom baru kita. Kita cukup mengubah konfigurasi <tt><module></tt>
-dengan <tt>id="users"</tt>.</p>
-<com:TTextHighlighter Language="xml" CssClass="source block-content" id="code_90036">
-<module id="users" class="ChatUserManager" />
-</com:TTextHighlighter>
-
-<h1 id="18012">Otentikasi</h1>
-<p id="90094" class="block-content">Untuk melakukan otentikasi, kita menginginkan pengguna untuk memasukkan nama pengguna unik. Kita menambahkan
-<com:DocLink ClassPath="System.Web.UI.WebControls.TCustomValidator" Text="TCustomValidator" />
-untuk memvalidasi keunikan nama pengguna dan menambahkan pengendali event <tt>OnClick</tt> untuk tombol login.</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_90037">
-<com:TCustomValidator
- ControlToValidate="username"
- Display="Dynamic"
- OnServerValidate="checkUsername"
- ErrorMessage="The username is already taken." />
-
-...
-
-<com:TButton Text="Login" OnClick="createNewUser" />
-</com:TTextHighlighter>
-Dalam file <tt>Login.php</tt>, kita menambahkan 2 metode berikut.
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90038">
-function checkUsername($sender, $param)
-{
- $manager = $this->Application->Modules['users'];
- if($manager->usernameExists($this->username->Text))
- $param->IsValid = false;
-}
-
-function createNewUser($sender, $param)
-{
- if($this->Page->IsValid)
- {
- $manager = $this->Application->Modules['users'];
- $manager->addNewUser($this->username->Text);
-
- //do manual login
- $user = $manager->getUser($this->username->Text);
- $auth = $this->Application->Modules['auth'];
- $auth->updateSessionUser($user);
- $this->Application->User = $user;
-
- $url = $this->Service->constructUrl($this->Service->DefaultPage);
- $this->Response->redirect($url);
- }
-}
-</com:TTextHighlighter>
-Metode <tt>checkUserName()</tt> menggunakan kelas <tt>ChatUserManager</tt>
-(ingat bahwa dalam konfigurasi <tt>config.xml</tt> kita menyetel ID dari kelas manajer pengguna kustom sebagai "users") untuk memvalidasi nama pengguna belum dipakai.
-</p>
-<p id="90095" class="block-content">
-Dalam metode <tt>createNewUser</tt>, Ketika validasi lulus (yaitu ketika nama pengguna belum dipakai) kita menambahkan pengguna baru. Setelah itu kita melakukan proses login secara manual:</p> <ul id="u2" class="block-content">
- <li>Pertama kita peroleh turunan <tt>TUser</tt> dari kelas manajer
-pengguna kita menggunakan metode <tt>$manager->getUser(...)</tt>.</li>
- <li>Menggunakan <tt>TAuthManager</tt> kita menetapkan/memutakhirkan obyek pengguna dalam data sesi saat ini.</li>
- <li>Kemudian kita menetapkan/memutakhirkan turunan <tt>APlikasi</tt> pengguna dengan obyek pengguna baru kita.</li>
-</ul>
-</p>
-<p id="finally" class="block-content">
-Akhirnya, kita mengalihkan klien ke halaman standar <tt>Home</tt>.
-</p>
-
-<h2 id="18021">Nilai Standar untuk ActiveRecord</h2>
-<p id="90096" class="block-content">Jika Anda mencoba untuk melakukan login sekarang, Anda akan menerima pesan kesalahan seperti
-"<i>Property '<tt>ChatUserRecord::$last_activity</tt>' must not be null as defined
-by column '<tt>last_activity</tt>' in table '<tt>chat_users</tt>'.</i>". Ini berarti bahwa nilai properti <tt>$last_activity</tt> adalah null dalam kolom terkait pada tabel dan memboleh nilai null atau menetapkan nilai standar dalam kelas <tt>ChatUserRecord</tt>. Kita akan mendemonstrasikannya nanti dengan mengubah <tt>ChatUserRecord</tt> dengan tambahan dari metode setelan pengambil/pengetap untuk properti <tt>last_activity</tt>.
-
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90039">
-private $_last_activity;
-
-public function getLast_Activity()
-{
- if($this->_last_activity === null)
- $this->_last_activity = time();
- return $this->_last_activity;
-}
-
-public function setLast_Activity($value)
-{
- $this->_last_activity = $value;
-}
-</com:TTextHighlighter>
-Catatan bahwa kita mengganti nama <tt>$last_activity</tt> menjadi <tt>$_last_activity</tt> (perhatikan garis bawah setelah tanda dolar).
-</p>
-
-<h1 id="18013">Aplikasi Chat Utama</h1>
-<p id="90097" class="block-content">Sekarang kita siap untuk membangun aplikasi chat utama. Kita menggunakan tata letak sederhana yang terdiri dari satu panel yang menampung pesan chat, satu panel untuk menampung daftar pengguna, area teks untuk pengguna memasukan pesan teks dan tombol untuk mengirimkan pesan.
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_90040">
-<!doctype html public "-//W3C//DTD XHTML 1.0 Strict//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
- <title>Prado Chat Demo</title>
-<style>
-.messages
-{
- width: 500px;
- height: 300px;
- float: left;
- border: 1px solid ButtonFace;
- overflow: auto;
-}
-.user-list
-{
- margin-left: 2px;
- float: left;
- width: 180px;
- height: 300px;
- border: 1px solid ButtonFace;
- overflow: auto;
- font-size: 0.85em;
-}
-.message-input
-{
- float: left;
-}
-
-.message-input textarea
-{
- margin-top: 3px;
- padding: 0.4em 0.2em;
- width: 493px;
- font-family: Verdana, Geneva, Arial, Helvetica, sans-serif;
- font-size: 0.85em;
- height: 40px;
-}
-.send-button
-{
- margin: 0.5em;
-}
-</style>
-</head>
-<body>
-<com:TForm>
-<h1 id="18014">Prado Chat Demo</h1>
-<div id="messages" class="messages">
- <com:TPlaceHolder ID="messageList" />
-</div>
-<div id="users" class="user-list">
- <com:TPlaceHolder ID="userList" />
-</div>
-<div class="message-input">
- <com:TActiveTextBox ID="userinput"
- Columns="40" Rows="2" TextMode="MultiLine" />
- <com:TActiveButton ID="sendButton" CssClass="send-button"
- Text="Send" />
-</div>
-</com:TForm>
-<com:TJavascriptLogger />
-</body>
-</html>
-</com:TTextHighlighter>
-Kita menambahkan dua komponen Kontrol Aktif: a
-<com:DocLink ClassPath="System.Web.UI.ActiveControls.TActiveTextBox" Text="TActiveTextBox" />
-dan
-<com:DocLink ClassPath="System.Web.UI.ActiveControls.TActiveButton" Text="TActiveButton" />.
-Kita juga menambahkan
-<com:DocLink ClassPath="System.Web.UI.WebControls.TJavascriptLogger" Text="TJavascriptLogger" />
-yang akan sangat berguna untuk mengerti bagaimana Kontrol Aktif bekerja.
-</p>
-
-<h2 id="18022">Menjelajah Kontrol Aktif</h2>
-<p id="90098" class="block-content">Kita sudah mempunyai beberapa kesenangan sebelum kita melanjutkan dengan penyiapan bufer chat. Kita ingin melihat bagaimana kita dapat memutakhirkan halaman saat ini ketika kita menerima sebuah pesan. Pertama, kita menambahkan sebuah tombol
-<tt>OnClick</tt> event handler for the <tt>Send</tt>.
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_90041">
-<com:TActiveButton ID="sendButton" CssClass="send-button"
- Text="Send" OnClick="processMessage"/>
-</com:TTextHighlighter>
-Dan metode pengendali event terkait dalam kelas <tt>Home.php</tt> (kita perlu untuk membuat file baru ini juga).
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90042">
-class Home extends TPage
-{
- function processMessage($sender, $param)
- {
- echo $this->userinput->Text;
- }
-}
-</com:TTextHighlighter>
-Jika Anda sekarang mengetikan sesuatu dalam kotak teks aplikasi utama dan mengklik tombol kirim, Anda seharusnya melihat apapun yang Anda ketikan muncul dalam konsol <tt>TJavascriptLogger</tt>.
-</p>
-
-<p id="90099" class="block-content">Untuk menambah atau menambahkan beberapa konten ke panel daftar pesan, kita perlu memakai beberapa metode dalam kelas
-<com:DocLink ClassPath="System.Web.UI.ActiveControls.TCallbackClientScript" Text="TCallbackClientScript" />
-yang tersedia melalui properti <tt>CallbackClient</tt> property dari obyek <tt>TPage</tt> saat ini. Sebagai contoh, kita kita dapat melakukan
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90043">
-function processMessage($sender, $param)
-{
- $this->CallbackClient->appendContent("messages", $this->userinput->Text);
-}
-</com:TTextHighlighter>
-Ini adalah satu cara untuk memutakhirkan beberapa bagian dari halaman yang sudah ada selama callback (AJAX style event) dan akan menjadi cara utama yang akan kita gunakan untuk menerapkan aplikasi chat.
-</p>
-
-<h1 id="18015">Rekaman Aktif untuk tabel <tt>chat_buffer</tt></h1>
-<p id="90100" class="block-content">Untuk mengirimkan pesan ke seluruh pengguna yang tersambung kita memerlukan bufer atau menyimpan pesan untuk setiap pengguna. Kita dapat menggunakan database untuk membufer pesan. Tabel
-<tt>chat_buffer</tt> didefinisikan sebagai berikut.
-<com:TTextHighlighter Language="text" CssClass="source block-content" id="code_90044">
-CREATE TABLE chat_buffer
-(
- id INTEGER PRIMARY KEY,
- for_user VARCHAR(20) NOT NULL,
- from_user VARCHAR(20) NOT NULL,
- message TEXT NOT NULL,
- created_on INTEGER NOT NULL DEFAULT "0"
-);
-</com:TTextHighlighter>
-Kelas <tt>ChatBufferRecord</tt> terkait disimpan sebagai
-<tt>App_Code/ChatBufferRecord.php</tt>.
-
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90045">
-class ChatBufferRecord extends TActiveRecord
-{
- const TABLE='chat_buffer';
-
- public $id;
- public $for_user;
- public $from_user;
- public $message;
- private $_created_on;
-
- public function getCreated_On()
- {
- if($this->_created_on === null)
- $this->_created_on = time();
- return $this->_created_on;
- }
-
- public function setCreated_On($value)
- {
- $this->_created_on = $value;
- }
-
- public static function finder($className=__CLASS__)
- {
- return parent::finder($className);
- }
-}
-</com:TTextHighlighter>
-</p>
-
-<h1 id="18016">Logika Aplikasi Chat</h1>
-<p id="90101" class="block-content">Akhirnya kita tiba di kanal logika aplikasi chat. Pertama, kita perlu menyimpan pesan yang diterima ke dalam bufer chat untuk <b>semua</b> pengguna saat ini. Kita menambahkan logika ini dalam kelas <tt>ChatBufferRecord</tt>.
-
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90046">
-public function saveMessage()
-{
- foreach(ChatUserRecord::finder()->findAll() as $user)
- {
- $message = new self;
- $message->for_user = $user->username;
- $message->from_user = $this->from_user;
- $message->message = $this->message;
- $message->save();
- if($user->username == $this->from_user)
- {
- $user->last_activity = time(); //update the last activity;
- $user->save();
- }
- }
-}
-</com:TTextHighlighter>
-Terlebih dahulu kita mencari semua pengguna saat ini menggunkan metode penemu <tt>ChatUserRecord</tt>. Kemudian kita gandakan pesan dan menyompannya ke dalam database. Sebagai tambahan, kita mutakhirkan cap waktu aktivitas terakhir pengirim pesan. Kode di atas memperlihatkan kesederhanaan dan keringkasan dari penggunaan ActiveRecords untuk desain database sederhana.
-</p>
-
-<p id="90102" class="block-content">Logika berikutnya adalah untuk mengambil pesan pengguna dari bufer.
-Kita cukup mengambil semua pesan untuk nama pengguna tertentu dan membentuk pesan itu secar benar (ingat untuk meng-escape output guna menghindari serangan Penaskahan Situs-Silang).
-Setelah kita ambil pesan, kita hapus pesan yang diambil dan pesan lainnya yang lebih lama yang mungkin tertinggal dalam bufer.
-</p>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90047">
-public function getUserMessages($user)
-{
- $content = '';
- foreach($this->findAll('for_user = ?', $user) as $message)
- $content .= $this->formatMessage($message);
- $this->deleteAll('for_user = ? OR created_on < ?',
- $user, time() - 300); //5 min inactivity
- return $content;
-}
-
-protected function formatMessage($message)
-{
- $user = htmlspecialchars($message->from_user);
- $content = htmlspecialchars($message->message);
- return "<div class=\"message\"><strong>{$user}:</strong>"
- ." <span>{$content}</span></div>";
-}
-</com:TTextHighlighter>
-
-Untuk mengambil daftar dari pengguna saat ini (terformat), kita menambahkan logika kelas ini
-<tt>ChatUserRecord</tt>. Kita menghapus setiap pengguna yang sudah tidak aktif untuk beberapa waktu.
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90048">
-public function getUserList()
-{
- $this->deleteAll('last_activity < ?', time()-300); //5 min inactivity
- $content = '<ul>';
- foreach($this->findAll() as $user)
- $content .= '<li>'.htmlspecialchars($user->username).'</li>';
- $content .= '</ul>';
- return $content;
-}
-</com:TTextHighlighter>
-
-<div class="note"><b class="tip">Catatan:</b>
-Untuk kemudahan kita membentuk pesan dalam kelas Rekaman Aktif. Untuk aplikasi besar, tugas pembentukan pesan ini harus dilakukan menggunakan komponen Prado (contohnya menggunakan TRepeater dalam template atau komponen kustom).
-</div>
-</p>
-
-<h1 id="18017">Menyatukan Semuanya</h1>
-<p id="90103" class="block-content">Sekarang waktunya untuk menyatukan alur aplikasi secara keseluruhan. Dalam <tt>Home.php</tt> kita memutakhirkan tombol <tt>Send</tt> pengendali event <tt>OnClick</tt> untuk menggunakan logika aplikasi yang baru saja kita implementasikan.
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90049">
-function processMessage($sender, $param)
-{
- if(strlen($this->userinput->Text) > 0)
- {
- $record = new ChatBufferRecord();
- $record->message = $this->userinput->Text;
- $record->from_user = $this->Application->User->Name;
- $record->saveMessage();
-
- $this->userinput->Text = '';
- $messages = $record->getUserMessages($this->Application->User->Name);
- $this->CallbackClient->appendContent("messages", $messages);
- $this->CallbackClient->focus($this->userinput);
- }
-}
-</com:TTextHighlighter>
-Kita cukup menyimpan pesan ke bufer chat dan kemudian meminta semua pesan untuk pengguna saat ini dan memutakhirkan pesan sisi klien menggunakan respon callback
-(gaya AJAX).
-</p>
-
-<p id="90104" class="block-content">Pada titik ini aplikasi sebenarnya sudah berfungsi, cuma tidak bersahabat. Jika Anda membuka dua browser berbeda, Anda seharusnya bisa berkomunikasi diantara dua pengguna kapan saja tombol <tt>Send</tt> diklik.
-</p>
-
-<p id="90105" class="block-content">Bagian berikutnya barangkali lebih rumit dan mengakali daripada tugas lainnya. Kita perlu untuk meningkatkan pengalaman pengguna. Pertama, kita menginginkan daftar pengguna saat ini juga. Maka kita menambahkan metode berikut ke <tt>Home.php</tt>, kita dapat memanggil metode ini kapan saja beberapa event callback dimunculkan, misalnya saat tombol <tt>Send</tt> diklik.
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90050">
-protected function refreshUserList()
-{
- $lastUpdate = $this->getViewState('userList','');
- $users = ChatUserRecord::finder()->getUserList();
- if($lastUpdate != $users)
- {
- $this->CallbackClient->update('users', $users);
- $this->setViewstate('userList', $users);
- }
-}
-</com:TTextHighlighter>
-</p>
-
-<p id="90106" class="block-content">Sebenarnya, kita menginginkan untuk secara
-periodik memutakhirkan pesan dan daftar pengguna saat pengguna baru bergabung
-dan pesan baru yang datang dari pengguna lainnya. Maka kita perlu untuk menyegarkan
-daftar pesan juga.</p>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90051">
-function processMessage($sender, $param)
-{
- ...
- $this->refreshUserList();
- $this->refreshMessageList();
- ...
-}
-
-protected function refreshMessageList()
-{
- //refresh the message list
- $finder = ChatBufferRecord::finder();
- $content = $finder->getUserMessages($this->Application->User->Name);
- if(strlen($content) > 0)
- {
- $anchor = (string)time();
- $content .= "<a href=\"#\" id=\"{$anchor}\"> </a>";
- $this->CallbackClient->appendContent("messages", $content);
- $this->CallbackClient->focus($anchor);
- }
-}
-</com:TTextHighlighter>
-Jangkar menggunakan <tt>time()</tt> sebagai ID untuk titik fokus agar saat daftar
-pesan pada sisi klien diperoleh sangat lama, metode fokus akan menggulung daftar
-pesan ke pesan terbaru (ini bekerja baik pada umumnya browser).
-</p>
-
-<p id="90107" class="block-content">Selanjutnya, kita perlu mengalihkan pengguna
-kembali ke halaman login jika pengguna tidak aktif untuk beberapa waktum
-katakanlah 5 menit, kita menambahkan pemeriksaan ini ke setiap tahap dari masa hidup
-halaman. Mari menambahkannya ke tahapan <tt>onLoad()</tt>.
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90052">
-public function onLoad($param)
-{
- $username = $this->Application->User->Name;
- if(!$this->Application->Modules['users']->usernameExists($username))
- {
- $auth = $this->Application->Modules['auth'];
- $auth->logout();
-
- //redirect to login page.
- $this->Response->Redirect($this->Service->ConstructUrl($auth->LoginPage));
- }
-}
-</com:TTextHighlighter>
-</p>
-
-<h1 id="18018">Memperbaiki Pengalaman Pengguna</h1>
-<p id="90108" class="block-content">Beberapa rincian terakhir secara periodeik memeriksa
-pesan baru dan menyegarkan daftar pengguna. Kita bisa melakukan ini dengan menanyakan
-server menggunakan kontrol
-<com:DocLink ClassPath="System.Web.UI.ActiveControls.TTimeTriggeredCallback" Text="TTimeTriggeredCallback" />.
-Kita menambahkan tt>TTimeTriggeredCallback</tt> ke <tt>Home.page</tt> dan memanggil
-metode pengendali <tt>refresh</tt> yang didefinisikan dalam <tt>Home.php</tt>.
-Kita setel interval pertanyaan menjadi 2 detik.
-<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code_90053">
-<com:TTimeTriggeredCallback OnCallback="refresh"
- Interval="2" StartTimerOnLoad="true" />
-</com:TTextHighlighter>
-<com:TTextHighlighter Language="php" CssClass="source block-content" id="code_90054">
-function refresh($sender, $param)
-{
- $this->refreshUserList();
- $this->refreshMessageList();
-}
-</com:TTextHighlighter>
-</p>
-
-<p id="90109" class="block-content">Langkah terakhir memerlukan kita untuk menggunakan beberapa javascript. Kita menginginkan bahwa saat pengguna mengetikan beberapa teks dalam area teks dan menekan tombol <tt>Enter</tt>, kita menginginkannya untuk mengirimkan pesan tanpa mengklik tombol <tt>Send</tt>. Kita menambahkan beberapa javascript ke
-<tt>Home.page</tt>.
-
-<com:TTextHighlighter Language="javascript" CssClass="source block-content" id="code_90055">
-<com:TClientScript>
-Event.observe($("<%= $this->userinput->ClientID %>"), "keypress", function(ev)
-{
- if(Event.keyCode(ev) == Event.KEY_RETURN)
- {
- if(Event.element(ev).value.length > 0)
- new Prado.Callback("<%= $this->sendButton->UniqueID %>");
- Event.stop(ev);
- }
-});
-</com:TClientScript>
-</com:TTextHighlighter>
-Rincian sehubungan dengan javascript bisa dilihat dalam seksi
-<a href="?page=Advanced.Scripts">Pengenalan Javascript</a> pada tutorial cepat.
-</p>
-
-<p id="90110" class="block-content">Ini melengkapi tutorial untuk membuat aplikasi chat web menggunakan kerangka kerja Prado. Diharapkan Anda menikmatinya.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Tutorial/id/CurrencyConverter.page b/demos/quickstart/protected/pages/Tutorial/id/CurrencyConverter.page deleted file mode 100755 index c1eae035..00000000 --- a/demos/quickstart/protected/pages/Tutorial/id/CurrencyConverter.page +++ /dev/null @@ -1,349 +0,0 @@ -<com:TContent ID="body"> - <h1 id="16001">Membangun Pengubah Kurs Sederhana</h1> - <p id="80053" class="block-content">Tutorial ini memperkenalkan kerangka kerja aplikasi web Prado dan mengajarkan Anda bagaimana untuk - membangun aplikasi web sederhana dalam beberapa langkah sederhana. Tutorial - ini menganggap bahwa Anda terbiasa dengan PHP dan Anda telah mengakses - server web yang dapat melayani naskah PHP5. - </p> - - <p id="80054" class="block-content">Dalam tutorial ini Anda akan membangun aplikasi web sederhana yang mengubah - nilai dolar ke kurs lain, nilai kurs yang disediakan untuk kurs tersebut relatif terhadap dolar. Aplikasi lengkap ditampilkan di bawah ini. - <img src=<%~ example2.png %> class="figure" /> - Anda dapat mencoba aplikasi <a href="../currency-converter/index.php">secara lokal</a> atau di - <a href="http://www.pradosoft.com/demos/currency-converter/">Pradosoft.com</a>. - Catatan bahwa aplikasi masih berfungsi sama persis apabila javascript tidak tersedia pada browser pengguna. - </p> - - <h1 id="download">Men-download dan Menginstalasi Prado</h1> - <p id="80055" class="block-content">Untuk menginstalasi Prado, cukup download versi terbaru Prado dari - <a href="http://www.pradosoft.com/">http://www.pradosoft.com</a> - dan uraikan file ke sebuah direktori yang <b>tidak</b> dapat diakses oleh server web Anda (Anda dapat menguraikannya ke sebuah direktori yang dapat diakses oleh server web jika Anda ingin melihat demo dan pengujian). Untuk instalasi lebih rinci, lihat bimbingan - <a href="?page=GettingStarted.Installation">Instalasi Cepat</a>. - </p> - - <h1 id="16002">Membuat Aplikasi web Prado baru</h1> - <p id="80056" class="block-content">Cara tercepat dan termudah untuk membuat aplikasi web Prado baru adalah menggunakan piranti perintah <tt>prado-cli.php</tt> yang ditemukan dalam direktori <tt>framework</tt> - pada distribusi Prado. Kita membuat aplikasi baru dengan menjalankan perintah berikut dalam prompt perintah atau konsol Anda. Perintah membuat direktori baru bernama <tt>currency-converter</tt> dalam direktori kerja Anda saat ini. - Anda perlu mengubahnya ke direktori yang benar terlebih dahulu. - Lihat <a href="?page=GettingStarted.CommandLine">Piranti Baris Perintah</a> - untuk lebih jelasnya. - </p> -<com:TTextHighlighter Language="text" CssClass="source block-content" id="code111"> -php prado/framework/prado-cli.php -c currency-converter -</com:TTextHighlighter> - - <p id="80057" class="block-content">Perintah di atas membuat struktur direktori yang diperlukan dan file minimal (termasuk "index.php" dan "Home.page") untuk menjalankan aplikasi Prado. - Sekarang Anda dapat mengarahkan url browser Anda ke server web untuk melayani naskah <tt>index.php</tt> dalam direktori <tt>currency-converter</tt>. - Seharusnya Anda melihat pesan "Welcome to Prado!" - </p> - - <h1 id="16003">Membuat Antarmuka Pengguna Pengubah Kurs</h1> - <p id="80058" class="block-content">Kita mulai dengan mengedit file <tt>Home.page</tt> yang ditemukan dalam direktori <tt>currency-converter/protected/pages/</tt>. File yang berakhiran dengan ".page" adalah template halaman yang berisi HTML dan kontrol Prado. - Kita cukup menambah dua kotak teks, tiga label dan satu tombol seperti berikut. - </p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="form1"> -<com:TForm> - <fieldset> - <legend>Currency Converter</legend> - <div class="rate-field"> - <com:TLabel ForControl="currencyRate" Text="Exchange Rate per $1:" /> - <com:TTextBox ID="currencyRate" /> - </div> - <div class="dollar-field"> - <com:TLabel ForControl="dollars" Text="Dollars to Convert:" /> - <com:TTextBox ID="dollars" /> - </div> - <div class="total-field"> - <span class="total-label">Amount in Other Currency:</span> - <com:TLabel ID="total" CssClass="result" /> - </div> - <div class="convert-button"> - <com:TButton Text="Convert" /> - </div> - </fieldset> -</com:TForm> -</com:TTextHighlighter> - <p id="refresh" class="block-content"> - Jika Anda menyegarkan halaman, Anda akan melihat sesuatu mirip dengan gambar berikut. - Ia mungkin terlihat tidak cukup bagus atau berurut, tapi kita akan mengubahnya nanti dengan menggunakan CSS. - <img src=<%~ example1.png %> class="figure" /> - </p> - - <p id="80059" class="block-content"> - Komponen pertama yang kita tambahkan adalah - <com:DocLink ClassPath="System.Web.UI.TForm" Text="TForm" /> - yang pada dasarnya terkait ke elemen HTML <tt><form></tt>. - Dalam Prado, hanya <b>satu</b> elemen <tt>TForm</tt> dibolehkan per halaman. - </p> - - <p id="80060" class="block-content">Dua pasang komponen berikutnya yang kita tambahkan adalah - <com:DocLink ClassPath="System.Web.UI.WebControls.TLabel" Text="TLabel" /> - dan - <com:DocLink ClassPath="System.Web.UI.WebControls.TTextBox" Text="TTextBox" /> - yang pada dasarnya mendefinisikan sebuah label dan kotak teks bagi pengguna aplikasi - untuk memasukan nilai pertukaran kurs. - Nilai properti <tt>ForControl</tt> property menentukan komponen mana label - diperuntukan. Ini membolehkan pengguna aplikasi mengklik pada label - untuk memfokuskan pada field (hal yang baik). Anda mungkin telah menggunakan elemen - biasa HTML <tt><label></tt> untuk melakukan hal yang sama, tapi - Anda harus mencari <tt>ID</tt> yang benar pada kotak teks (atau - <tt><input></tt> dalam HTML) karena komponen Prado dapat/mungkin menyajikan - nilai <tt>ID</tt> secara berbeda dalam output HTML. - </p> - - <p id="80061" class="block-content">Pasangan komponen berikutnya adalah sama dan mendefinisikan - kotak teks guna menampung nilai dolar yang akan dikonversi. - <tt>TLabel</tt> dengan nilai <tt>ID</tt> "total" mendefinisikan label sederhana. - Catatan bahwa properti <tt>ForControl</tt> tidak ada. Ini berarti bahwa label ini - merupakan sebuah label yang akan dipakai untuk menampilkan jumlah total yang dikonversi. - </p> - - <p id="80062" class="block-content">Komponen terakhir adalah - <com:DocLink ClassPath="System.Web.UI.WebControls.TButton" Text="TButton" /> - yang akan diklik oleh pengguna untuk menghitung hasil. Properti <tt>Text</tt> - menetapkan label tombol. - </p> - - <h1 id="16004">Mengimplementasikan Konversi Kurs</h1> - - <p id="80063" class="block-content">Jika Anda mencoba mengklik pada tombol "Convert" kemudian halaman akan menyegarkan - dan tidak melakukan apapun. Agar tombol melakukan beberapa pekerjaan, kita perlu - menambahkan "Home.php" ke di mana "Home.page" berada. Kelas <tt>Home</tt> harus - memperluas <com:DocLink ClassPath="System.Web.UI.TPage" Text="TPage" />, basis kelas standar untuk semua halaman Prado. - </p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code3"> -<?php -class Home extends TPage -{ - -} -</com:TTextHighlighter> - <p id="1111" class="block-content"> - Prado menggunakan metode PHP <tt>__autoload</tt> untuk mengambil kelas. Konvensi - adalah untuk menggunakan nama kelas dengan ekstensi ".php" sebagai nama file. - </p> - - <p id="80064" class="block-content">Sejauh ini tidak ada hal menarik mengenai Prado, kita hanya mendeklarasikan beberapa - "komponen web" dalam beberapa file template bernama Home.page dan membuat - sebuah file "Home.php" dengan kelas <tt>Home</tt>. Sedikit yang lebih menarik adalah - arsitektur kendali-event Prado seperti yang akan kita lihat nanti. - </p> - - <p id="80065" class="block-content">Kita menginginkan bahwa saat pengguna mengklik tombol "Convert", kita mengambil - nilai dalam kotak teks, melakukan beberapa perhitungan dan menyajikan kepada pengguna dengan - total nilai yang dikonversi. Untuk menangani pengguna mengklik pada tombo "Convert", - kita cukup menambahkan sebuah properti <tt>OnClick</tt> ke tombol "Convert" dalam - template "Home.page" dan menambahkan metode pengendali event terkait dalam "Home.php". - </p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code4"> -<com:TButton Text="Convert" OnClick="convert_clicked" /> -</com:TTextHighlighter> - <p id="222" class="block-content"> - Nilai dari <tt>OnClick</tt>, "<tt>convert_clicked</tt>", akan menjadi nama metode - dalam "Home.php" yang akan dipanggil saat pengguna mengklik tombol "Convert". - </p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code5"> -class Home extends TPage -{ - public function convert_clicked($sender, $param) - { - $rate = floatval($this->currencyRate->Text); - $dollars = floatval($this->dollars->Text); - $this->total->Text = $rate * $dollars; - } -} -</com:TTextHighlighter> -<div id="3332" class="block-content"> - <p id="333"> - Jika Anda menjalankan aplikasi dalam web browser Anda, masukkan beberapa nilai - dan klik tombol "Convert" kemudian Anda akan melihat nilai yang dihitung ditampilkan - di dekat label "Amount in Other Currency". - </p> - - <p id="80066">Dalam metode "<tt>convert_clicked</tt>" parameter pertama, <tt>$sender</tt>, - berhubungan dengan obyek yang memunculkan event, dalam hal ini, tombol - "Convert". Parameter kedua, <tt>$param</tt> berisi data tambahan lain - di mana obyek <tt>$sender</tt> yang ingin ditambahkan. - </p> - - <p id="80067">Sekarang kita akan memeriksa, tiga baris yang mengimplementasikan konversi - kurs sederhana dalam metode "<tt>convert_clicked</tt>". - </p> -</div> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code6" > -$rate = floatval($this->currencyRate->Text); -</com:TTextHighlighter> - <p id="444" class="block-content"> - Pernyataan <tt>$this->currencyRate</tt> berhubungan dengan komponen - <tt>TTextBox</tt> dengan nilai <tt>ID</tt> "currencyRate" dalam template - "Home.page". Properti <tt>Text</tt> dari <tt>TTextBox</tt> berisi - nilai yang dimasukan oleh pengguna. Maka kita memperoleh nilai ini dengan - <tt>$this->currencyRate->Text</tt> yang kita konversi nilainya ke nilai - pecahan. - </p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code7"> -$dollars = floatval($this->dollars->Text); -</com:TTextHighlighter> -<div id="5551" class="block-content"> - <p id="555"> - Baris berikutnya melakukan hal yang mirip, ia mengambil nilai pengguna - dari <tt>TTextBox</tt> dengan nilai <tt>ID</tt> "dollars dang mengubahnya - ke nilai pecahan. - </p> - - <p id="80068">Baris ketiga menghitung jumlah baru dan menyetel nilai ini dalam properti - <tt>Text</tt> dari <tt>TLabel</tt> dengan <tt>ID="total"</tt>. - Selanjutnya, kita tampilkan jumlah baru ke pengguna dalam label. - </p> -</div> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code8"> -$this->total->Text = $rate * $dollars; -</com:TTextHighlighter> - - <h1 id="16005">Menambahkan Validasi</h1> - <p id="80069" class="block-content">Cara kita mengubah nilai yang dimasukan oleh pengguna ke pecahan memastikan bahwa jumlah total selalu sebuah angka. Maka pengguna bebas untuk memasukan apapun yang mereka sukai, bahkan mereka dapat memasukan huruf. Pengalaman pengguna dalam pemakaian aplikasi dapat ditingkatkan dengan menambahkan validator untuk memberitahu pengguna atas nilai yang dibolehkan dalam kurs mata uang dan jumlah yang akan dihitung. - </p> - - <p id="80070">Untuk kurs mata uang, kita harus memastikan bahwa</p> - <ol id="o111" class="block-content"> - <li>pengguna memasukan sebuah nilai,</li> - <li>kurs mata uang adalah angka yang benar,</li> - <li>kurs mata uang adalah positif.</li> - </ol> - <p id="666" class="block-content"> - Untuk memastikan poin 1 kita menambahkan satu - <com:DocLink ClassPath="System.Web.UI.WebControls.TRequiredFieldValidator" Text="TRequiredFieldValidator" />. Untuk memastikan poin 2 dan 3, kita menambahkan satu <com:DocLink ClassPath="System.Web.UI.WebControls.TCompareValidator" Text="TCompareValidator" />. Kita dapat menambahkan validator ini di mana saja di dalam template "Home.page". Perincian selanjutnya mengenai validator ini dan validator lainnya dapat ditemukan dalam halaman - <a href="?page=Controls.Validation">Validation Controls</a>. - </p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code9"> -<com:TRequiredFieldValidator - ControlToValidate="currencyRate" - ErrorMessage="Please enter a currency rate." /> -<com:TCompareValidator - ControlToValidate="currencyRate" - DataType="Float" - ValueToCompare="0" - Operator="GreaterThan" - ErrorMessage="Please enter a positive currency rate." /> -</com:TTextHighlighter> - - <p id="80071" >Untuk jumlah yang dihitung, kita harus memastikan bahwa</p> - <ol id="o222" class="block-content"> - <li>pengguna memasukan sebuah nilai,</li> - <li>nilai adalah angka yang benar (tidak menyertakan tanda kurs atau dolar).</li> - </ol> - <p id="777" class="block-content"> - Untuk memastikan 1 kita cukup menambahkan <tt>TRequiredFieldValidator</tt> lainnya, untuk 2 - kita dapat menggunakan - <com:DocLink ClassPath="System.Web.UI.WebControls.TDataTypeValidator" Text="TDataTypeValidator" />. Untuk memudahkan kita hanya membolehkan pengguna untuk memasukan sebuah angka untuk jumlah yang ingin mereka ubah. - </p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code9a"> -<com:TRequiredFieldValidator - ControlToValidate="dollars" - ErrorMessage="Please enter the amount you wish to calculate." /> -<com:TDataTypeValidator - ControlToValidate="dollars" - DataType="Float" - ErrorMessage="Please enter a number." /> -</com:TTextHighlighter> - </p> - - <p id="80072" class="block-content">Sekarang jika Anda mencoba memasukan beberapa data tidak benar dalam aplikasi atau membiarkan field kosong - validators akan diaktifkan dan menyajikan pesan kesalahan kepada pengguna. Catatan bahwa pesan kesalahan disajikan tanpa mengambil ulang halaman. Validator Prado standarnya memvalidasi javascript dan di dalam server. Validasi di dalam server <b>selalu dilakukan</b>. Untuk sisi server, kita harus melewati perhitungan jika validator tidak memuaskan. Ini dapat dilakukan seperti berikut. - </p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code10" > -public function convert_clicked($sender, $param) -{ - if($this->Page->IsValid) - { - $rate = floatval($this->currencyRate->Text); - $dollars = floatval($this->dollars->Text); - $this->total->Text = $rate * $dollars; - } -} -</com:TTextHighlighter> - - <h1 id="16006">Meningkatkan Pengalaman Pengguna Dengan Kontrol Aktif</h1> - - <com:RequiresVersion Version="3.1a" /> - - <p id="80073" class="block-content">Dalam aplikasi sederhana selanjutnya kita dapat -memperbaiki pengalaman pengguna dengan meningkatkan tanggapan aplikasi. Satu cara untuk mencapai respon tercepat adalah menghitung dan menyajikan hasil tanpa mengambil ulang seluruh halaman. - </p> - - <p id="80074" class="block-content">Kita dapat mengganti <tt>TButton</tt> dengan pasangan Kontrol Aktif, - <com:DocLink ClassPath="System.Web.UI.ActiveControls.TActiveButton" Text="TActiveButton" />, - yang dapat memicu event klik di dalam server tanpa mengambil ulang halaman. - Sebagai tambahan, kita dapat mengubah "total" <tt>TLabel</tt> dengan pasangan Kontrol Aktif, - <com:DocLink ClassPath="System.Web.UI.ActiveControls.TActiveLabel" Text="TActiveLabel" />, dengan demikian di dalam server dapat memutakhirkan browser tanpa mengambil ulang halaman. - </p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code11"> -<div class="total-field"> - <span class="total-label">Amount in Other Currency:</span> - <com:TActiveLabel ID="total" CssClass="result" /> - </div> - <div class="convert-button"> - <com:TActiveButton Text="Convert" OnClick="convert_clicked" /> -</div> -</com:TTextHighlighter> - <p id="1232" class="block-content"> - Logika di dalam server tetap sama, kita hanya perlu mengimpor - ruang nama Kontrol Aktif karena secara standar tidak disertakan. Kita menambahkan baris berikut ke awal "Home.php". - </p> -<com:TTextHighlighter Language="php" CssClass="source block-content" id="code12"> -Prado::using('System.Web.UI.ActiveControls.*'); -</com:TTextHighlighter> - - <p id="80075" class="block-content">Jika Anda mencoba aplikasi sekarang, Anda akan melihat bahwa halaman tidak perlu lagi mengambil ulang untuk menghitung dan menampilkan jumlah total yang dikonversi. - Akan tetapi, karena di sana tidak ada pengambilan halaman ulang, tidak ada petunjuk atau tidak jelas bahwa dengan mengklik pada tombol "Convert" telah terjadi. - Selanjutnya kita bisa memperbaiki pengalaman pengguna dengan mengunah label teks "total" menjadi "calculating..." saat pengguna mengklik tombol "Convert". Label teks "total" masih dimutakhirkan dengan jumlah perhitungan baru seperti sebelumnya. - </p> - - <p id="80076" class="block-content">Untuk mengindikasikan bahwa perhitungan sedang berlangsung, kita dapat mengubah label teks "total" sebagai berikut. Kita menambahkan properti <tt>ClientSide.OnLoading</tt> ke tombol "Convert" (karena tombol ini bertanggung jawab terhadap permintaan perhitungan). - </p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code13"> -<com:TActiveButton Text="Convert" OnClick="convert_clicked" > - <prop:ClientSide.OnLoading> - $('<%= $this->total->ClientID %>').innerHTML = "calculating..." - </prop:ClientSide.OnLoading> -</com:TActiveButton> -</com:TTextHighlighter> - - <p id="80077" class="block-content"><tt>ClientSide.OnLoading</tt> dan berbagai - <com:DocLink ClassPath="System.Web.UI.ActiveControls.TCallbackClientSide" Text="properti lainnya" /> menerima blok javascript sebagai konten atau nilainya. - Kode javascript <tt>$('...')</tt> adalah fungsi javascript sama dengan <tt>document.getElementById('...')</tt> yang mengambil string dengan ID dari elemen HTML. Karena Prado menyajikan ID komponennya, kita perlu menggunakan ID yang disajikan dari label "total", yakni <tt>$this->total->ClientID</tt>. Kita tempatkan sedikit kode ini ini di dalam <tt><%= %></tt> untuk memperoleh ID HTML yang disajikan untuk label "total". Kode javascript sisanya <tt>innerHTML = "calculating..."</tt> cukup mengubah konten label "total". - </p> - - <h1 id="16007">Menambahkan Sentuhan Akhir</h1> - <p id="80078" class="block-content">Sejauh ini kita telah membangun aplikasi web pengubah kurs sederhana dengan sedikit perhatian terhadap penampilannya. Sekarang kita dapat menambahkan stylesheet guna meningkatkan penampilan secara keseluruhan aplikasi. Kita cukup menambahkan inline stylesheet dengan kode template atau kita membuat sebuah "tema". - </p> - - <p id="80079" class="block-content">Untuk membuat dan menggunakan tema dengan aplikasi Prado, kita membuat direktori baru "themes/Basic" dalam direktori <tt>currency-converter</tt>. - Anda mungkin perlu untuk membuat direktori <tt>themes</tt> lebih dahulu. Direktori apapun di dalam <tt>themes</tt> dianggap sebagai tema dengan nama temanya adalah nama direktori. Lihat - <a href="?page=Advanced.Themes">Tema dan Skin</a> untuk lebih jelasnya. - </p> - - <p id="80080" class="block-content">Kita cukup dengan membuat file CSS bernama "common.css" dan menyimpannya dalam direktori - <tt>themes/Basic</tt>. Kemudian kita menambahkan kode berikut ke awal "Home.page" (kita menambahkan sedikit kode HTML juga). - </p> -<com:TTextHighlighter Language="prado" CssClass="source block-content" id="code14"> -<%@ Theme="Basic" %> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" -"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" > -<com:THead Title="Currency Converter" /> -<body> -</com:TTextHighlighter> - <p id="4334" class="block-content"> - Baris pertama <tt><%@ Theme="Basic" %></tt> mendefinisikan tema - yang dipakai untuk halaman ini. - <com:DocLink ClassPath="System.Web.UI.WebControls.THead" Text="THead" /> - merujuk ke elemen HTML <tt><head></tt>. Sebagai tambahan terhadap - tampilan properti <tt>Title</tt> pada <tt>THead</tt>, semua file CSS - dalam direktori <tt>themes/Basic</tt> juga disajikan/dikaitkan untuk - halaman saat ini. Aplikasi web pengubah kurs final kita terlihat seperti - berikut. - <img src=<%~ example2.png %> class="figure" /> - Tutorial pengenalan lengkap terhadap kerangka kerja aplikasi web Prado. - </p> -</com:TContent> diff --git a/demos/quickstart/protected/pages/Tutorial/id/chat1.png b/demos/quickstart/protected/pages/Tutorial/id/chat1.png Binary files differdeleted file mode 100755 index 8288b496..00000000 --- a/demos/quickstart/protected/pages/Tutorial/id/chat1.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Tutorial/id/chat2.png b/demos/quickstart/protected/pages/Tutorial/id/chat2.png Binary files differdeleted file mode 100755 index 97cbc51d..00000000 --- a/demos/quickstart/protected/pages/Tutorial/id/chat2.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Tutorial/id/example1.png b/demos/quickstart/protected/pages/Tutorial/id/example1.png Binary files differdeleted file mode 100755 index 0c7da7ba..00000000 --- a/demos/quickstart/protected/pages/Tutorial/id/example1.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/Tutorial/id/example2.png b/demos/quickstart/protected/pages/Tutorial/id/example2.png Binary files differdeleted file mode 100755 index 1df56cfb..00000000 --- a/demos/quickstart/protected/pages/Tutorial/id/example2.png +++ /dev/null diff --git a/demos/quickstart/protected/pages/pl/Construction.page b/demos/quickstart/protected/pages/pl/Construction.page deleted file mode 100755 index dff18284..00000000 --- a/demos/quickstart/protected/pages/pl/Construction.page +++ /dev/null @@ -1,5 +0,0 @@ -<com:TContent ID="body">
-
-Przepraszamy, ta strona jest w trakcie tworzenia. Proszę sprawdź później.
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/pl/Search.page b/demos/quickstart/protected/pages/pl/Search.page deleted file mode 100755 index 859f2619..00000000 --- a/demos/quickstart/protected/pages/pl/Search.page +++ /dev/null @@ -1,29 +0,0 @@ -<com:TContent ID="body">
-<div class="quicksearch">
- <div class="search">
- <com:SearchBox ID="search" />
- </div>
-
- <com:TRepeater id="quickstart_results">
- <prop:HeaderTemplate>
- <div class="searchHeader">
- <%# $this->Parent->DataSource->Count %> znalezionych w Quickstart Tutorial.
- </div>
- </prop:HeaderTemplate>
- <prop:ItemTemplate>
- <div class="searchItem">
- <div class="searchItemLink">
- <%# $this->ItemIndex + 1 %>.
- <a href="<%# $this->DataItem->link %>">
- <%# $this->DataItem->title %>
- </a>
- </div>
- <p class="searchItemBody"><%# $this->Page->HighlightSearch($this->DataItem->text) %></p>
- </div>
- </prop:ItemTemplate>
- </com:TRepeater>
- <com:TPanel id="emptyResult" CssClass="empty_search_result" Visible="false">
- Nie znaleziono żadnych rezultatów dla frazy "<%= htmlentities($this->Page->search->Text) %>".
- </com:TPanel>
-</div>
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/pl/ViewSource.page b/demos/quickstart/protected/pages/pl/ViewSource.page deleted file mode 100755 index 8d5e0574..00000000 --- a/demos/quickstart/protected/pages/pl/ViewSource.page +++ /dev/null @@ -1,31 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" >
-
-<com:THead Title="Podgląd źródeł w PRADO QuickStart">
-<meta http-equiv="content-language" content="en"/>
-</com:THead>
-
-<body>
-<com:TForm>
-<div id="sourceList">
-<table border="0">
-<com:TRepeater ID="SourceList">
-<prop:ItemTemplate>
-<tr>
- <td align="right"><%# $this->DataItem['type']%>:</td>
- <td><a href="<%# $this->DataItem['active']?'':$this->DataItem['url']%>"><%# $this->DataItem['name']%></a></td>
-</tr>
-</prop:ItemTemplate>
-</com:TRepeater>
-</table>
-<com:TCheckBox ID="showNumbers" Text="Pokaż numery linii" Checked="true" AutoPostBack="true" />
-</div>
-<div id="sourceView">
-<h3 style="text-align:center"><%= $this->FilePath %></h3>
-<com:TTextHighlighter ID="Highlighter" ShowLineNumbers=<%= $this->showNumbers->Checked %> CssClass="source">
-<com:TLiteral ID="SourceView" />
-</com:TTextHighlighter>
-</div>
-</com:TForm>
-</body>
-</html>
\ No newline at end of file |
