New user field system HOW TO

As you in v6 it is difficult to add new user fields. Thanks to the new modular system in v7 it's now quite simple. No mdifications are required, but in order to add fields you have to create include files, these are stored in the folder includes/user_fields. There is a format to the construct of the filenames:

user_FIELD_include_var.php - carries the database field name & info
user_FIELD_include.php - controls input, display and data validation

If you want to have locale support you can create a file called user_FIELD.php and place it in the folder locale/langauge/user_fieds.

* replace the word field with the name of your field, e.g. user_skype_include_var.php

Lets suppose we're adding a skype field.

1. Create a locale file called user_skype.php which contains the following code:

<?php
// Field Name (appears in edit/profile and user field admin)
$locale['uf_skype'] = "Skype:";
// Description (appears in user field admin)
$locale['uf_skype_desc'] = "Skype Voice Communicator";
?>

2. Create a file called user_skype_include_var.php which contains the following code

<?php
if (!defined("IN_FUSION")) { die("Access Denied"); }

// Field display name
$user_field_name = $locale['uf_skype'];
// Field Description
$user_field_desc = $locale['uf_skype_desc'];
// The name of the database field used to ADD or DROP
$user_field_dbname = "user_skype";
// The group the field appears under; 1 = Contact, 2 = Information, 3 = Options and 4 = Statistics
$user_field_group = 1;
// The database properties used when ADDing the above field
$user_field_dbinfo = "VARCHAR(50) NOT NULL DEFAULT ''";
?>

3. With the admin side of things taken care of, now we need to handle input, display and data validation. Create a file called user_skype_include.php with the following code:

<?php
if (!defined("IN_FUSION")) { die("Access Denied"); }

if ($profile_method == "input") {
// Create the input field for registration and edit profile
echo "<tr>\n";
echo "<td class='tbl'>".$locale['uf_skype'].":</td>\n";
echo "<td class='tbl'><input type='text' name='user_skype' value='".(isset($user_data['user_skype']) ? $user_data['user_skype'] : "")."' maxlength='16' class='textbox' style='width:200px;' /></td>\n";
echo "</tr>\n";
} elseif ($profile_method == "display") {
// Create the display for the user profile
if ($user_data['user_skype']) {
echo "<tr>\n";
echo "<td width='1%' class='tbl1' style='white-space:nowrap'>".$locale['uf_skype']."</td>\n";
echo "<td align='right' class='tbl1'>".$user_data['user_skype']."</td>\n";
echo "</tr>\n";
}
} elseif ($profile_method == "validate_insert") {
// Validate the insert data field & value for our field
$db_fields .= ", user_skype";
$db_values .= ", '".(isset($_POST['user_skype']) ? stripinput(trim($_POST['user_skype'])) : "")."'";
} elseif ($profile_method == "validate_update") {
// Validate the update data value for our field
$db_values .= ", user_skype='".(isset($_POST['user_skype']) ? stripinput(trim($_POST['user_skype'])) : "")."'";
}
?>

Important points
#1 All user_field files must start with same name i.e. user_skype.
#2 The data field and input name must be the same as point #1.
#3 The locale files go in locale/English/user_fields (or whichever language you use).
#4 The 2 include files go in includes/user_fields.

Once you have completed all of the above you should be able to see and enable your new field under Admin => User Fields.

Any questions, please reply to this thread.