JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
metaform: added pulldown support, added leftcheck
[wfpl.git] / metaform / template.php
index 754b710..890c49b 100644 (file)
@@ -8,44 +8,67 @@
 #
 # ~metaform_url~
 
-# This code can send form results by e-mail and/or save them to a database. See
-# the next two comments to enable either or both.
 
+# SETUP
+<!--~opt_email_1 start~-->
 # To send results by e-mail, all you have to do is set your e-mail address here:
 $GLOBALS['~form_name~_form_recipient'] = "fixme@example.com";
-<!--~upload_settings start~-->
+<!--~end~--><!--~opt_db_1 start~-->
+# To save results to a database, you'll need to create the ~form_name~ table
+# (the file ~form_name~.sql should help with this), and create a file called
+# 'db_connect.php' or 'code/db_connect.php' which calls db_connect() see:
+# code/wfpl/examples/db_connect.php
+#
+# if you rename any of the database fields, you'll need to update this:
+
+define('~form_name.upper~_DB_FIELDS', '~db_fields~');
+<!--~end~--><!--~upload_settings start~-->
 # Set this to the path to your uploads directory. It can be relative to the
 # location of this script. IT MUST END WITH A SLASH
 $GLOBALS['upload_directory'] = 'uploads/';
+<!--~end~--><!--~opt_http_pass_1 start~-->
+# Define the username and password required to view this form:
+define('AUTH_REALM', '~form_name~ administration area');
+define('AUTH_USER', 'fixme');
+define('AUTH_PASS', 'fixme');
 <!--~end~-->
-# To save results to a database, you'll need to create the ~form_name~ table
-# (the file ~form_name~.sql should help with this), and create a file called
-# 'db_connect.php' which calls db_connect() see:
-# code/wfpl/examples/db_connect.php
 
 if(!file_exists('code/wfpl/template.php')) { die('This form requires <a href="http://jasonwoof.org/wfpl">wfpl</a>.'); }
 require_once('code/wfpl/template.php');
 require_once('code/wfpl/format.php');
 require_once('code/wfpl/messages.php');
-require_once('code/wfpl/email.php');
-require_once('code/wfpl/db.php');<!--~image_include start~-->
+require_once('code/wfpl/email.php');<!--~opt_db_2 start~-->
+require_once('code/wfpl/db.php');<!--~end~--><!--~image_include start~-->
 require_once('code/wfpl/upload.php');<!--~end~-->
 
-function ~form_name~_get_fields() {
-       <!--~formats start~-->
-       $~name~ = format_~format~($_REQUEST['~name~']);<!--~end~--><!--~image_upload start~-->
+function ~form_name~_get_fields() {<!--~formats start~-->
+       $~name~ = format_~format~($_REQUEST['~name~']<!--~pulldown_format_extra start~-->, '~name~'<!--~end~-->);<!--~end~--><!--~image_upload start~-->
        if($_FILE['~name~'] && $_FILE['~name~']['error'] == 0) {
                $~name~ = substr(save_uploaded_image('~name~', $GLOBALS['upload_directory']), strlen($GLOBALS['upload_directory']));
        } else {
                $~name~ = format_filename($_REQUEST['old_~name~']);
        }<!--~end~-->
-       <!--~tem_sets start~-->
-       tem_set('~name~', $~name~);<!--~end~-->
+
+       ~form_name~_tem_sets(~php_fields~);
 
        return array(~php_fields~);
 }
 
-function ~form_name~() {
+function ~form_name~_tem_sets(~php_fields~) {<!--~tem_sets start~-->
+       tem_set('~name~', $~name~);<!--~end~-->
+}
+
+function ~form_name~() {<!--~opt_http_pass_2 start~-->
+       # To remove password protection, just delete this block:
+       if (!isset($_SERVER['PHP_AUTH_USER']) || $_SERVER['PHP_AUTH_USER'] != AUTH_USER || $_SERVER['PHP_AUTH_PW'] != AUTH_PASS) {
+               header('WWW-Authenticate: Basic realm="' . AUTH_REALM . '"');
+               header('HTTP/1.0 401 Unauthorized');
+               echo '401 Unauthorized';
+               exit;
+       }
+       <!--~end~--><!--~pulldowns start~-->
+       pulldown('~name~', array('option 1', 'option 2', 'option 3'));
+       <!--~end~--><!--~opt_db_3 start~-->
        $edit_id = format_int($_REQUEST['~form_name~_edit_id']);
        unset($_REQUEST['~form_name~_edit_id']);
        if($edit_id) {
@@ -67,33 +90,27 @@ function ~form_name~() {
 
        if(!$edit_id && !$delet_id) {
                tem_sub('new_msg');
-       }
+       }<!--~end~-->
 
        if(isset($_REQUEST['~always_field~'])) {
                list(~php_fields~) = ~form_name~_get_fields();
 
-               if("you're happy with the POSTed values") {
-                       # to enable saving to a database, create a file called 'db_connect.php'
-                       # see: code/wfpl/examples/db_connect.php
-                       if(file_exists('db_connect.php') || file_exists('code/db_connect.php')) {
-                               if(file_exists('db_connect.php') {
-                                       require_once('db_connect.php');
-                               } else {
-                                       require_once('code/db_connect.php');
-                               }
+               if("you're happy with the POSTed values") {<!--~opt_db_4 start~-->
+                       if(file_exists($db_connector = 'db_connect.php') || file_exists($db_connector = 'code/db_connect.php')) {
+                               require_once($db_connector);
                                if($edit_id) {<!--~image_db start~-->
                                        # uploading nothing means leaving it as is.
                                        if(!$~name~ && $delete_~name~ != 'Yes') {
                                                $~name~ = db_get_value('~form_name~', '~name~', 'where id=%i', $edit_id);
                                        }
                                        <!--~end~-->
-                                       db_update('~form_name~', '~db_fields~', ~php_fields~, 'where id=%i', $edit_id);
+                                       db_update('~form_name~', ~form_name.upper~_DB_FIELDS, ~php_fields~, 'where id=%i', $edit_id);
                                        message('Entry updated.');
                                } else {
-                                       db_insert('~form_name~', '~db_fields~', ~php_fields~);
+                                       db_insert('~form_name~', ~form_name.upper~_DB_FIELDS, ~php_fields~);
                                        message('Entry saved.');
                                }
-                       }
+                       }<!--~end~--><!--~opt_email_2 start~-->
                        if($GLOBALS['~form_name~_form_recipient'] != "fixme@example.com") {
                                $to = $GLOBALS['~form_name~_form_recipient'];
                                if(isset($_REQUEST['email']) and valid_email($_REQUEST['email'])) {
@@ -109,11 +126,10 @@ function ~form_name~() {
                                $cc = '';
                                $bcc = '';
                                if(email($from, $to, $subject, $message, $cc, $bcc)) {
-                                       tem_set('error_message', 'Due to an internal error, your message could not be sent. Please try again later.');
-                                       tem_sub('error');
+                                       message('Due to an internal error, your message could not be sent. Please try again later.');
                                        $error = true;
                                }
-                       }
+                       }<!--~end~-->
                        if($error !== true) {
                                tem_load('~form_name~.html');
                                tem_sub('thankyou');
@@ -124,11 +140,11 @@ function ~form_name~() {
                # otherwise, we display the form again. ~form_name~_get_fields() has
                # already put the posted values back into the template engine, so they will
                # show up in the form fields. You should add some message asking people to
-               # fix their entry in whatever way you require.
+               # fix their entry in whatever way you require.<!--~opt_db_5 start~-->
        } elseif($edit_id) {
                # we've recieved an edit id, but no data. So we grab the values to be edited from the database
-               list(~php_fields~) = db_get_row('~form_name~', '~db_fields~', 'where id=%i', $edit_id);
-               ~tem_sets.tab~
+               list(~php_fields~) = db_get_row('~form_name~', ~form_name.upper~_DB_FIELDS, 'where id=%i', $edit_id);
+               ~form_name~_tem_sets(~php_fields~);<!--~end~-->
        } else {
                # form not submitted, you can set default values like so:
                #tem_set('~always_field~', 'Yes');
@@ -136,6 +152,7 @@ function ~form_name~() {
 
        tem_set('upload_max_filesize', upload_max_filesize());<!--~end~-->
 
+       display_messages();
        tem_sub('form');
 }