Welcome to the DBTS Login Tools Extensions suite, a set of plug ins for the WB6

Login System.

These tools are intended to replace OR to implement the standard WB6 Login
Tools. The tools (extensions) available as of June 20, 2010, are the following:

DBTS Admin Extension:

This version of the extension will work either with a flat file database, or with a
MySQL Database. It was created with the main scope to provide a means of
changing the Administrator Password through the script itself, so as to render it
independent from WB6. Main use of it is for web designers that need to deliver a
Login script with the ability to change the Administrator Password without need to
use WB6. However, it only uses the standard fields of the WB6 login script. If your
hosting account doesn’t offer MySQL Database support, or if the standard fields of
the WB are enough for you, you can use this version.

Main Features:

1. Automatic creation of the database file or the database table.

2. Automatic creation of a file or a DB table for storage of the administrator
password and email address.
3. “Forgot Password” feature.
4. Error reporting system that allows you to view any error or any
confirmation messages created by the script.
5. Customization of the labels, buttons and linked texts.
6. Password check: it will check if the users password already exists in the
database. WB’s standard object only checked the username.

DBTS Admin MySQL Extension:

This version of the extension will only work with a MySQL Database. The reason
for this is that it would be extremely difficult to implement the additional features
added in this version, with a flat file database engine.

Main features are:

 1. Automatic creation of the database table.
2. Automatic creation of a DB table for storage of the administrator password
and email address.
3. “Forgot Password” feature.
4. Error reporting system that allows you to view any error or any
confirmation messages created by the script.
5. Customization of the labels, buttons and linked texts.
6. Password check: it will check if the users password already exists in the
database. WB’s standard object only checked the username.
7. Added as standard Creation Date field, Expiry Date field, and User Redirect
field.
8. Ability to add as many fields (columns) you want in the database, and
manage them through the extension. As an example, you can add fields for
User group, Comments, Departments, Website, or anything else.
9. Ability to set the type of form controls that control each field. Supported
formcontrol types are: Editbox (default), Textarea, Combobox, Multiple
Choice Listbox, Radio Buttons, and Checkboxes. Values of options are fed in
directly in WB6.
10.Ability to add fields in the same Database table whenever you like. Just add
the fields in WB, the script will automatically add them in the Database
table.

DBTS MySQL Login Extension:

This tool is NOT independent. In fact it should be used TOGETHER with WB6’s
Login tool, or with a standard WB form that allows the user to login. It adds Expiry
Date check and User Specific Redirect. It ONLY works with the DBTS MySQL
Admin Extension. Please see details in the related paragraph.

DBTS MySQL Protect Page Extension:

This tool also ONLY works with the DBTS MySQL Admin Extension. It adds
Usergroup control thus allowing different access levels. It replaces the standard
WB6 Protect Page tool. Please see details in the related paragraph.

Please read carefully instructions. Since this is a fresh release, I suggest that you
first install and run in testing environment, until everything proves to work
efficiently. If your hosting account provides you with MySQL database, I
recommend that you select a MySQL database as storage media.

Thank you

DBTechnosystems.com
Requirements

The DBTS Admin Object Extension requires PHP 4.3 or higher and MySQL 5.0.1 or
higher support.

In case you use the flat file database, Safe Mode must be OFF and the folder in
which they are used should have read and write permissions if you want to use a
flat file database

If you intend to use a MySQL Database, you must create it (as well as a database
user / password) before you can run the script in your browser.

Installation

The DBTS Login Tools Extensions for WB6 are installed just as any other WB
extension: you simply copy the relevant extension files in your WYSIWYG WB6
installation folder on your computer. The zip also contains the Unicode version of
the extensions.

Using the DBTS Admin Extension

The DBTS Admin extension will add an icon in your extensions Toolbar.

It will be easier if you drag the extension icon close to the standard Admin object
so you have it in the same toolbar as the rest of the Login tools. To use the
extension simply click and place the object in your page. Position the object as
required and give it the desired dimensions. Since the extension was built
complete with Render HTML, it will display directly in the page with your own
settings (colors, fonts, etc)

To setup the processor properties double click the DBTS Admin Object so the
properties dialog box will appear:
The first settings are those relevant to the storage media (flat file database or
MySQL database ) as well as the I-frame name.

The MySQL details (Host, database name, user, password, table name) are only
necessary if you select MySQL as storage media.

The second category of settings are visual settings, pretty explanatory.

The third category are the labels used by the script so you can customize it to
your own language if necessary.

Please note that error messages and confirmation messages are not yet
customizable.

Automatic Database File or Database Table creation

The script doesn’t require you to create the database file or the database table
manually. It will automatically attempt to create them the very first time it is run
in your browser, using the database filename or table name that you have
specified.

It will also create automatically a second, auxiliary file, named

“dbts_admin_pass.php” that holds the Administrator password and email address,
or, in the case of MySQL, a table named “admin” that will hold the same details.

(in the case of the MySQL only version, the Administrator details table will be
named “admin_details”)

The first version will automatically create the password “admin” and a virtual
emails address email@yourdomain.com.

After you login with the default password “admin” the first time, you can change
both the password and the email address to whatever you want. The email
address is used for the “forgot password” feature that will email you your details.

The MySQL only version instead, allows you to set the initial admin password and
email address through WB6. Of course you can still change it through the script
itself.

It is logical, based on the above, that the easiest way to create a login
system is to start directly from the Admin object, as it will create all
necessary files / tables for you. Run it on your browser, so it does so. Then
you will only need to create the pages with the other objects (Signup, Login etc)
without any need to worry about database creation.

Using the DBTS Admin MySQL Extension

This version is similar to the previous one, however it only works with a MySQL
Database. The main difference is that it allows you to add as many fields you want
in your Database table, and manage them through the script itself.

Custom Fields and Form Controls customization

Customization is achieved through the last section of properties: D. Custom Fields.

As you can see, there are 4 columns that you need to fill in:
1. FIELDNAME This is the form field name. The database column will have a
similar (but all lowercase characters) name. The script also removes any
whitespaces from the column names, replacing them with underscores.

2. DATATYPE: this is the MySQL Datatype for each form field. Supported types
are VARCHAR, TEXT, INT and DATE. Here is a brief description, but if you
wish to read some more info, please visit
http://dev.mysql.com
http://dev.mysql.com/doc/refman/5.0/en/data-types.html

VARCHAR is the most common type. It is used for strings, which means
that it can also store numbers, symbols etc. Until MySQL 5.02 this type of
data could hold up to 255 chrs, since MySQL 5.03 it can hold up to 65535
chrs .

TEXT type also holds strings, up to 65535 chrs.

If your server MySQL version is 5.02 or lower, and you need to store more
than 255 chrs, you will need to use TEXT, if, instead, you are running
MySQL 5.03 or later, VARCHAR will also do the job.

INT is for integers

DATE type is for storing dates in the standard yyyy-mm-dd

yyyy dd format.

3. LENGTHS: this is the max length of each record. Only useful for VARCHAR
type.
4. OPTIONVALUES: If your form controls need to be Radiobuttons,
Checkboxes, or Comboboxes, here
here you can provide the values that will be
used for each. Separate each other using commas.
A small problem

For some reason, that I have not been able to find out, the extension seems to
create a blank strip at the right part. This, plus some more issues, have obliged
me to add, in the visual settings, a “width in pixels” property. Give it the actual
value that you want your Admin i-frame to have, and you will have no issues at
all.

Using the DBTS Login Extension

As already mentioned, this tool is used TOGETHER with the standard WB6 Login
tool. In fact, it has no Visual output in the page, it only adds the necessary PHP
code.

Whan you drag the object in the page, it will add this image in
your WB workarea.

You can use either the standard WB6 Login tool, to create the Login form in your
page, OR you can simply create a normal form.

If you use the WB6 login tool, there is NO NEED to feed in the MySQL Database
details, neither the success (redirect) or error (access denied) page urls. This is
because you will type them in the DBTS Login extension, that will override the WB
one.

It is, however, recommended, that you use, instead, a normal WB6 form. You
have to add the following fields:

username (all lowercase) editbox

password (all lowercase) editbox

rememberme (all lowercase) checkbox

and, of course, a submit button.

Important: if you use the DBTS Login tool TOGETHER with the standard WB Login
tool, please right click the DBTS Login Object and select Move to Back. This is
ABSOLUTELY necessary so that the code it adds in Start of Page becomes the very
first code of the page.

Using the DBTS Protect Page Extension

This tool replaces the standard WB6 Protect Page tool.

When you drag the object in the page, it will add this image in
your WB workarea.

The difference is that it checks not only if the user is logged in, but also if he has
enough privileges to reach the specific page.

This is done by assigning each user a “usergroup”. The script will see if the user is
assigned a usergroup that is authorized to view the specific page, and will act
accordingly.

It is obvious, that you MUST create, in the Admin area, a field (column) in the
database that will contain the “usergroup” info.

As standard practice, I advise that you call this custom field “usergroup”
(Datatype: VARCHAR, Length: 255 should be enough in normal conditions,
FORMCONTROLTYPE: Checkboxes or Text Area Multiple Choices)

This way you can assign each user one or more usergroups. Let’s suppose that
you create the following usergroups: Guests, Members, Moderators,
Supermoderators, Administrators. Through the Protect Page tool you can define,
for each page, the groups that are allowed access.

A Moderator, in example, may have the following usergroups: Guests, Members,

Moderators.

An Administrator will have Guests, Members, Moderators, Administrators.

This way, if you define in a page as allowed usergroups “Moderators,

Administrators”, only they will be able to view that page.

If you define in a page as allowed usergroups “Supermoderators” only those that

have been assigned this usergroup will be able to view the page.

As you see, this method allows to follow not only the classic hierarchical
permissions system, but also a per user permissions system. In example, if a
Supermoderator is NOT assigned also the “Moderators” usergroup, he will NOT be
able to view pages intended for the Moderators only, even though, logically, a
Supermoderator is hierarchically superior to a Moderator. This way the script
allows the maximum flexibility.

Making a Reporting Page

The scripts above use an “error” or “report” page to display appropriate messages.

This page ALSO needs to be PHP. To correctly display the error message, add this
text in your page:

'.$_GET['msg'].'

Right click it and add the following codes in the Before and After tags:

Before Tag:
<?php echo'

After Tag:

‘;

?>

License:

The PHP code used in this extension has been developed by DB

Technosystems.com . The extensions are freely available to all WB users, and can
be embedded in any work, personal or commercial. You are not allowed to
redistribute or sell this extension. Please address to our download page anyone
interested in using this extension:

http://www.dbtechnosystems.com/wb6/forms/dbts_form_processor.php

This software is delivered AS IS. By installing and using it, you agree that Pablo
Software Solutions or DB Technosystems will not be held liable for ANY damage,
of ANY type, caused by the use of this software. Installing and using this software
implies that you fully and unconditionally accept these terms. USE AT YOUR OWN
RISK. Please fully test before using it.

Paid for Tools

On Request I can supply additional tools like Signup Tool, Edit Account Tool, List
Tool, PayPal Subscription tool (automatically updates expiry date), Email account
verification/activation tool, and more. Please note that these tools are License
based extensions that will ONLY work on a per domain / license basis. For any info
please contact me at http://www.dbtechnosystems.com/contact.php

Credits:

Credits go to Pablo Software Solutions for making (and further improving) their
Extension Builder! And for continuously improving their WYSIWYG WB6.

Many thanks also to WB forum members for their support!

Have fun!

George (Forum nickname Navaldesign)