added TDbUserManager and TDbUser.

3 files changed, 35 insertions, 2 deletions

diff --git a/demos/quickstart/protected/pages/Advanced/Auth.page b/demos/quickstart/protected/pages/Advanced/Auth.page
index 2c335f88..c8380901 100644
--- a/demos/quickstart/protected/pages/Advanced/Auth.page
+++ b/demos/quickstart/protected/pages/Advanced/Auth.page
@@ -89,4 +89,32 @@ We have seen in the above example that two users are specified in the applicatio
 <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>

+

 <div class="last-modified">$Id$</div></com:TContent>
\ No newline at end of file
diff --git a/demos/quickstart/protected/pages/GettingStarted/Introduction.page b/demos/quickstart/protected/pages/GettingStarted/Introduction.page
index 0871921a..e48360d6 100644
--- a/demos/quickstart/protected/pages/GettingStarted/Introduction.page
+++ b/demos/quickstart/protected/pages/GettingStarted/Introduction.page
@@ -4,12 +4,15 @@
 <p id="10001">

 This Quickstart tutorial is provided to help you quickly start building your own Web applications based on PRADO version 3.x.

 </p>

+<p>

+If you are an existing PRADO 3.x user and would like to learn what enhancements are available for each new version, please check out the <a href="?page=GettingStarted.NewFeatures">new features</a> page. Otherwise, the following sections are helpful for newbies.

+</p>

 <div class="start-page">

 	<div class="concepts start-block">

-	<h2>How Prado Works</h2>

+	<h2>How PRADO Works</h2>

 	<p>Concepts and fundamentals</p>

 	<ol>

-		<li><a href="#">Building web applications with Prado</a></li>

+		<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>

diff --git a/demos/quickstart/protected/pages/GettingStarted/NewFeatures.page b/demos/quickstart/protected/pages/GettingStarted/NewFeatures.page
index cfbb3e8e..4aff6d47 100644
--- a/demos/quickstart/protected/pages/GettingStarted/NewFeatures.page
+++ b/demos/quickstart/protected/pages/GettingStarted/NewFeatures.page
@@ -19,6 +19,8 @@ This page summarizes the main new features that are introduced in each PRADO rel
 

 <li>Added support to allow <a href="?page=Configurations.AppConfig">including external application configurations</a>. Enhanced template syntax to facilitate <a href="?page=Configurations.Templates1">subproperty configuration</a>.</li>

 

+<li>Added TDbUserManager and TDbUser to simplify <a href="?page=Advanced.Auth">authentication and authorization</a> with user accounts stored in a database.</li>

+

 </ul>

 

 <div class="last-modified">$Id$</div>