This repository has been archived by the owner on Jan 4, 2020. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 39
/
index.php
172 lines (143 loc) · 7.97 KB
/
index.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
<?php
session_start();
error_reporting(E_ALL);
include("PFBC/Form.php");
if(isset($_POST["form"])) {
Form::isValid($_POST["form"]);
header("Location: " . $_SERVER["PHP_SELF"]);
exit();
}
include("header.php");
$version = file_get_contents("version");
?>
<div class="hero-unit">
<h1>PHP Form Builder Class</h1>
<p>This project promotes rapid development of HTML forms through an object-oriented PHP framework.</p>
<p><a href="http://code.google.com/p/php-form-builder-class/downloads/list" class="btn btn-primary btn-large"><i class="icon-download icon-white"></i> Download PFBC <?php echo $version; ?></a></p>
</div>
<a name="whats-new-in-3x"></a>
<h2>What's New in 3.x</h2>
<p>Unlike the 2.x branch, version 3.x doesn't represent a complete rewrite from its previous version. In fact, most of the PHP code for creating
and validating forms has remained unchanged in this new major version release. So, what's different?</p>
<p>The most significant enhancement is the integration with <a href="http://twitter.github.com/bootstrap/">Bootstrap</a> - a front-end
framework from Twitter. Bootstrap incorporates responsive CSS, which means your forms not only look and behave great in the latest
desktop browser, but in tablet and smartphone browsers as well. To see responsive CSS in action, resize your browser window and watch how the
login form in the <a href="#getting-started">Getting Started </a> section responds.</p>
<p>Another enhancement in version 3.x is the addition of 13 HTML5 elements, which you can check out in our <a href="examples/html5.php">HTML5
example</a>. HTML5 form elements and attributes improve your form's usability - especially on tablets and smartphones where data is entered
with virtual keyboards.</p>
<p>Here are a few more differences between PFBC 3.x and 2.x to be aware of if you're planning on upgrading.</p>
<ul>
<li>In version 3.x, the Form class constructor no longer includes the width parameter.</li>
<li>PFBC 3.x contains new view classes - SideBySide, Vertical, Inline, and Search. The views used in version 2.x are no longer supported.</li>
<li>The description element property that existed in PFBC 2.x has been replaced by two properties in 3.x - shortDesc and longDesc. ShortDesc
is displayed inline while longDesc is displayed block.</li>
<li>jQuery UI js/css files are no longer included by default. The js/css files will only be added when an elements that make use of jQuery
UI (jQueryUIDate, Checksort, and Sort) is added to the form.</li>
<li>The Date element in PFBC 2.x has been renamed to jQueryUIDate. The new Date element in version 3.x is HTML5's input type="date".</li>
<li>The Email element now uses input type="email" as apposed to type="text".</li>
<li>The required Element property now sets the HTML5 required attribute triggering client-side validation when supported by the web browser.</li>
<li>Validation errors have been restyled using Bootstrap specific classes.</li>
</ul>
<a name="getting-started"></a>
<h2>Getting Started</h2>
<p>Before writing any code, you'll first need to download the latest version of PFBC, extract the contents of the zip file,
and upload the PFBC directory within the document root of your web server. The other files/directories outside of the PFBC
folder (like this one) that are included in the download are provided only for instruction and can be omitted from your production environment.</p>
<p><span class="label label-important">Important</span> This project maintains two separate code bases - one for
<a href="http://code.google.com/p/php-form-builder-class/source/browse/#svn%2Fbranches%2F3.x-php5">PHP 5</a> and another for
<a href="http://code.google.com/p/php-form-builder-class/source/browse/#svn%2Ftrunk">PHP 5 >= 5.3.0</a>. The primary
difference is the use of namespaces in PFBC <?php echo $version; ?> (PHP 5 >= 5.3.0). Namespaces weren't introduced in PHP until version 5.3.0, so if you're
web server is running an older version of PHP 5, then you will need to use PFBC <?php echo $version; ?> (PHP 5).</p>
<p>Once the PFBC directory is up on your web server, you're ready to create your first form. Below you'll find a sample login
form that we'll talk through in detail.
</p>
<ul class="nav nav-tabs">
<li class="active"><a href="#php53" data-toggle="tab">PFBC <?php echo $version; ?> (PHP 5 >= 5.3.0)</a></li>
<li><a href="#php5" data-toggle="tab">PFBC <?php echo $version; ?> (PHP 5)</a></li>
</ul>
<div class="tab-content">
<div id="php53" class="tab-pane active">
<?php
prettyprint('<?php
session_start();
use PFBC\Form;
use PFBC\Element;
include("PFBC/Form.php");
$form = new Form("login");
$form->addElement(new Element\HTML(\'<legend>Login</legend>\'));
$form->addElement(new Element\Hidden("form", "login"));
$form->addElement(new Element\Email("Email Address:", "Email", array(
"required" => 1
)));
$form->addElement(new Element\Password("Password:", "Password", array(
"required" => 1
)));
$form->addElement(new Element\Checkbox("", "Remember", array(
"1" => "Remember me"
)));
$form->addElement(new Element\Button("Login"));
$form->addElement(new Element\Button("Cancel", "button", array(
"onclick" => "history.go(-1);"
)));
$form->render();');
?>
</div>
<div id="php5" class="tab-pane">
<?php
prettyprint('<?php
session_start();
include("PFBC/Form.php");
$form = new Form("login");
$form->addElement(new Element_HTML(\'<legend>Login</legend>\'));
$form->addElement(new Element_Hidden("form", "login"));
$form->addElement(new Element_Email("Email Address:", "Email", array(
"required" => 1
)));
$form->addElement(new Element_Password("Password:", "Password", array(
"required" => 1
)));
$form->addElement(new Element_Checkbox("", "Remember", array(
"1" => "Remember me"
)));
$form->addElement(new Element_Button("Login"));
$form->addElement(new Element_Button("Cancel", "button", array(
"onclick" => "history.go(-1);"
)));
$form->render();');
?>
</div>
</div>
<?php
use PFBC\Form;
use PFBC\Element;
$form = new Form("login");
$form->configure(array(
"prevent" => array("bootstrap", "jQuery", "focus")
));
$form->addElement(new Element\HTML('<legend>Login</legend>'));
$form->addElement(new Element\Hidden("form", "login"));
$form->addElement(new Element\Email("Email Address:", "Email", array("required" => 1)));
$form->addElement(new Element\Password("Password:", "Password", array("required" => 1)));
$form->addElement(new Element\Checkbox("", "Remember", array("1" => "Remember me")));
$form->addElement(new Element\Button("Login"));
$form->addElement(new Element\Button("Cancel", "button", array(
"onclick" => "history.go(-1);"
)));
$form->render();
?>
<p><strong>Line 2:</strong> PFBC uses PHP sessions in the validation process, so you'll need to ensure you have session_start(); in your
webpage - before outputting anything to the browser. If you forget, you'll be reminded by an error message displayed above your form.</p>
<p><strong>Lines 4-5:</strong> As previously mentioned, PFBC <?php echo $version; ?> (PHP 5 >= 5.3.0) makes use of namespaces. The <em>use</em>
operator creates aliases for the various namespaces we're going to use within our form. This way, we don't have to include the <em>PFBC\</em>
prefix each time we reference one of the project's classes.</p>
<p><strong>Line 7:</strong> In order to create an instance of the Form class, you'll need to first include PFBC/Form.php. Any other files (elements, views, etc)
will be autoloaded on-demand.</p>
<p><strong>Line 8:</strong> In the Form class' constructor, a unique identifier is supplied - <em>login</em> in this sample. You'll reference
this same identifier in the validation process.</p>
<p><strong>Lines 9-23:</strong> Fields are added to the form with the addElement method.</p>
<p><strong>Line 24:</strong> The render method outputs the form's HTML, CSS, and javascript to the web browser.</p>
<p>Now that you've had a crash course in PFBC, go check out the example files that are included in the navigation above. They demonstrate
how the validation process works, what form elements are supported, and much more.</p>
<?php
include("footer.php");