/**
* Convert an array of details into a form element.
* @param String $fieldName The name of the form element
* @param Array $fieldDetails The list of details for the form element.
*/
protected function createElementObject($fieldName, $fieldDetails)
{
// Extract fields
$label = $this->formObj->getArrayValue($fieldDetails, 'label');
$type = $this->formObj->getArrayValue($fieldDetails, 'type');
// Required 'true' or true are valid
$required = $this->formObj->getArrayValue($fieldDetails, 'required');
$required = $required == 'true' || $required == '1';
// Start creating form element if anything other than a break.
$elem = false;
if ($type != 'break') {
$elem = new FormElement($fieldName, $label, $required);
}
// Handle specific types
switch ($type) {
// Text Area
case 'textarea':
$rows = $this->formObj->getArrayValue($fieldDetails, 'rows') + 0;
if ($rows == 0) {
$rows = 5;
}
$elem->setTypeAsTextArea($rows, 70);
break;
// Select/Dropdown
// Select/Dropdown
case 'select':
$options = false;
if (isset($fieldDetails['data']) && is_array($fieldDetails['data'])) {
$options = $fieldDetails['data'];
}
$elem->setTypeAsComboBox($options);
break;
// Radio Buttons
// Radio Buttons
case 'radio':
$options = false;
if (isset($fieldDetails['data']) && is_array($fieldDetails['data'])) {
$options = $fieldDetails['data'];
}
$elem->setTypeAsRadioButtons($options);
break;
// Checkbox
// Checkbox
case 'checkbox':
$label = false;
if (isset($fieldDetails['extralabel'])) {
$label = $fieldDetails['extralabel'];
}
$elem->setTypeAsCheckbox($label);
break;
// Checkbox List
// Checkbox List
case 'checkboxlist':
$options = false;
if (isset($fieldDetails['data']) && is_array($fieldDetails['data'])) {
$options = $fieldDetails['data'];
}
$elem->setTypeAsCheckboxList($options);
break;
// Merged Fields - process each sub element
// Merged Fields - process each sub element
case 'merge':
$elementList = array();
if (!empty($fieldDetails['merge'])) {
foreach ($fieldDetails['merge'] as $fieldName => $fieldDetails) {
$elementList[] = $this->createElementObject($fieldName, $fieldDetails);
}
}
$elem->setTypeAsMergedElements($elementList);
break;
// File upload
// File upload
case 'uploadfile':
$elem->setTypeAsUploadFile($this->formObj->getArrayValue($fieldDetails, 'show_existing'), $this->formObj->getArrayValue($fieldDetails, 'valid_if_value'));
break;
// Custom HTML
// Custom HTML
case 'custom':
$elem->setTypeAsCustom($this->formObj->getArrayValue($fieldDetails, 'html'));
break;
// Hidden field
// Hidden field
case 'hidden':
$elem->setTypeAsHidden();
break;
// Section break
// Section break
case 'break':
$this->formObj->addBreak($fieldName, $this->formObj->getArrayValue($fieldDetails, 'html'));
break;
// Text box
// Text box
default:
break;
}
// Add optional fields
if ($type != 'break') {
// Element description
if ($desc = $this->formObj->getArrayValue($fieldDetails, 'desc')) {
$elem->description = $desc;
}
// Extra CSS
if ($cssclass = $this->formObj->getArrayValue($fieldDetails, 'cssclass')) {
$elem->cssclass = $cssclass;
}
// Add extra HTML if provided.
$extraHTML = $this->formObj->getArrayValue($fieldDetails, 'extrahtml');
if ($extraHTML) {
$elem->afterFormElementHTML = $extraHTML;
}
// Add custom error message if there is one
$elem->errorMessage = $this->formObj->getArrayValue($fieldDetails, 'errormsg');
// Validation rules
if (isset($fieldDetails['validate']) && is_array($fieldDetails['validate'])) {
// Is it a custom function? If so, get the function name.
if ($this->formObj->getArrayValue($fieldDetails['validate'], 'type') == 'function') {
$elem->validationFn = $this->formObj->getArrayValue($fieldDetails['validate'], 'fname');
$elem->errorMessage = $this->formObj->getArrayValue($fieldDetails['validate'], 'error');
} else {
$elem->setValidationRules($fieldDetails['validate']);
}
}
// See if there are any suffix items? If so, parse them.
// See wiki for documentation on how to structure this.
if (!empty($fieldDetails['suffix_subitems'])) {
$suffixItems = array();
// suffix_subitems contains a list of 'position' => array(fieldName => fieldDetails)
foreach ($fieldDetails['suffix_subitems'] as $position => $elementDetails) {
$suffixItems[$position] = array();
// Need to process each field now we know the position.
foreach ($elementDetails as $fieldName => $fieldDetails) {
// Add the position of this item (in order), with the object for this element.
$suffixItems[$position][] = $this->createElementObject($fieldName, $fieldDetails);
}
}
// Update the form element with the subitems
$elem->setSuffixItems($suffixItems);
}
}
return $elem;
}
/**
* Shows the page that allows a group to be modified.
*/
function WPPortfolio_modify_group()
{
// Determine if we're in edit mode. Ensure we get correct mode regardless of where it is.
$editmode = false;
if (isset($_POST['editmode'])) {
$editmode = $_POST['editmode'] == 'edit';
} else {
if (isset($_GET['editmode'])) {
$editmode = $_GET['editmode'] == 'edit';
}
}
// Get the Group ID. Ensure we get ID regardless of where it is.
$groupid = 0;
if (isset($_POST['group_groupid'])) {
$groupid = is_numeric($_POST['group_groupid']) ? $_POST['group_groupid'] + 0 : 0;
} else {
if (isset($_GET['groupid'])) {
$groupid = is_numeric($_GET['groupid']) ? $_GET['groupid'] + 0 : 0;
}
}
$verb = __("Add New", 'wp-portfolio');
if ($editmode) {
$verb = __("Modify", 'wp-portfolio');
}
// Show title to determine action
?>
<div class="wrap">
<div id="icon-edit" class="icon32">
<br/>
</div>
<h2><?php
echo $verb . __(' Group Details', 'wp-portfolio');
?>
</h2>
<?php
// Check id is a valid number if editing $editmode
if ($editmode && $groupid == 0) {
WPPortfolio_showMessage(sprintf(__('Sorry, but no group with that ID could be found. Please click <a href="%s">here</a> to return to the list of groups.', 'wp-portfolio'), WPP_GROUP_SUMMARY), true);
return;
}
$groupdetails = false;
// ### EDIT ### Check if we're adding or editing a group
if ($editmode && $groupid > 0) {
// Get details from the database
$groupdetails = WPPortfolio_getGroupDetails($groupid);
// False alarm, couldn't find it.
if (count($groupdetails) == 0) {
$editmode = false;
}
}
// end of editing check
// Check if group is being updated/added.
if (isset($_POST) && isset($_POST['update'])) {
// Grab specified details
$data = array();
$data['groupid'] = $groupid;
$data['groupname'] = strip_tags($_POST['group_groupname']);
$data['groupdescription'] = $_POST['group_groupdescription'];
$data['grouporder'] = $_POST['group_grouporder'] + 0;
// Add zero to convert to number
// Keep track of errors for validation
$errors = array();
// Ensure all fields have been completed
if (!($data['groupname'] && $data['groupdescription'])) {
array_push($errors, __("Please check that you have completed the group name and description fields.", 'wp-portfolio'));
}
// Continue if there are no errors
if (count($errors) == 0) {
global $wpdb;
$table_name = $wpdb->prefix . TABLE_WEBSITE_GROUPS;
// Change query based on add or edit
if ($editmode) {
$query = arrayToSQLUpdate($table_name, $data, 'groupid');
} else {
unset($data['groupid']);
// Don't need id for an insert
$query = arrayToSQLInsert($table_name, $data);
}
// Try to put the data into the database
$wpdb->show_errors();
$wpdb->query($query);
// When editing, show what we've just been editing.
if ($editmode) {
WPPortfolio_showMessage(__("Group details successfully updated.", 'wp-portfolio'));
// Retrieve the details from the database again
$groupdetails = WPPortfolio_getGroupDetails($groupid);
} else {
WPPortfolio_showMessage(__("Group details successfully added.", 'wp-portfolio'));
$groupdetails['groupid'] = false;
$groupdetails['groupname'] = false;
$groupdetails['groupdescription'] = false;
$groupdetails['grouporder'] = false;
}
} else {
$message = __("Sorry, but unfortunately there were some errors. Please fix the errors and try again.", 'wp-portfolio') . '<br><br>';
$message .= "<ul style=\"margin-left: 20px; list-style-type: square;\">";
// Loop through all errors in the $error list
foreach ($errors as $errormsg) {
$message .= "<li>{$errormsg}</li>";
}
$message .= "</ul>";
WPPortfolio_showMessage($message, true);
$groupdetails = $data;
}
}
$form = new FormBuilder();
$formElem = new FormElement("group_groupname", __("Group Name", 'wp-portfolio'));
$formElem->value = WPPortfolio_getArrayValue($groupdetails, 'groupname');
$formElem->description = __("The name for this group of websites.", 'wp-portfolio');
$form->addFormElement($formElem);
$formElem = new FormElement("group_groupdescription", __("Group Description", 'wp-portfolio'));
$formElem->value = WPPortfolio_getArrayValue($groupdetails, 'groupdescription');
$formElem->description = __("The description of your group. HTML is permitted.", 'wp-portfolio');
$formElem->setTypeAsTextArea(4, 70);
$form->addFormElement($formElem);
$formElem = new FormElement("group_grouporder", __("Group Order", 'wp-portfolio'));
$formElem->value = WPPortfolio_getArrayValue($groupdetails, 'grouporder');
$formElem->description = '• ' . __("The number to use for ordering the groups. Groups are rendered in ascending order, first by this order value (lowest value first), then by group name.", 'wp-portfolio') . '<br/>' . '• ' . __('e.g. Groups (A, B, C, D) with ordering (50, 100, 0, 50) will be rendered as (C, A, D, B).', 'wp-portfolio') . '<br/>' . '• ' . __("If all groups have 0 for ordering, then the groups are rendered in alphabetical order.", 'wp-portfolio');
$form->addFormElement($formElem);
// Hidden Elements
$formElem = new FormElement("group_groupid", false);
$formElem->value = WPPortfolio_getArrayValue($groupdetails, 'groupid');
$formElem->setTypeAsHidden();
$form->addFormElement($formElem);
$formElem = new FormElement("editmode", false);
$formElem->value = $editmode ? "edit" : "add";
$formElem->setTypeAsHidden();
$form->addFormElement($formElem);
$form->setSubmitLabel(($editmode ? __("Update", 'wp-portfolio') : __("Add", 'wp-portfolio')) . " " . __("Group Details", 'wp-portfolio'));
echo $form->toString();
?>
<br><br>
</div><!-- wrap -->
<?php
}
/**
* Convert an array of details into a form element.
* @param String $fieldName The name of the form element
* @param Array $fieldDetails The list of details for the form element.
*/
protected function createElementObject($fieldName, $fieldDetails)
{
// Extract fields
$label = $this->formObj->getArrayValue($fieldDetails, 'label');
$type = $this->formObj->getArrayValue($fieldDetails, 'type');
// Required 'true' or true are valid
$required = $this->formObj->getArrayValue($fieldDetails, 'required');
$required = $required == 'true' || $required == '1';
// Start creating form element if anything other than a break.
$elem = false;
if ($type != 'break') {
$elem = new FormElement($fieldName, $label, $required);
}
// Handle specific types
switch ($type) {
// Text Area
case 'textarea':
$rows = $this->formObj->getArrayValue($fieldDetails, 'rows') + 0;
if ($rows == 0) {
$rows = 5;
}
$elem->setTypeAsTextArea($rows, 70);
break;
// Select/Dropdown
// Select/Dropdown
case 'select':
$options = false;
if (isset($fieldDetails['data']) && is_array($fieldDetails['data'])) {
$options = $fieldDetails['data'];
}
$elem->setTypeAsComboBox($options);
break;
// Radio Buttons
// Radio Buttons
case 'radio':
$options = false;
if (isset($fieldDetails['data']) && is_array($fieldDetails['data'])) {
$options = $fieldDetails['data'];
}
$elem->setTypeAsRadioButtons($options);
break;
// Checkbox
// Checkbox
case 'checkbox':
$label = false;
if (isset($fieldDetails['extralabel'])) {
$label = $fieldDetails['extralabel'];
}
$elem->setTypeAsCheckbox($label);
break;
// Checkbox List
// Checkbox List
case 'checkboxlist':
$options = false;
if (isset($fieldDetails['data']) && is_array($fieldDetails['data'])) {
$options = $fieldDetails['data'];
}
$elem->setTypeAsCheckboxList($options);
break;
// Merged Fields - process each sub element
// Merged Fields - process each sub element
case 'merge':
$elementList = array();
if (!empty($fieldDetails['merge'])) {
foreach ($fieldDetails['merge'] as $fieldName => $fieldDetails) {
$elementList[] = $this->createElementObject($fieldName, $fieldDetails);
}
}
$elem->setTypeAsMergedElements($elementList);
break;
// Custom HTML
// Custom HTML
case 'custom':
$elem->setTypeAsCustom($this->formObj->getArrayValue($fieldDetails, 'html'));
break;
// Hidden field
// Hidden field
case 'hidden':
$elem->setTypeAsHidden();
break;
// Section break
// Section break
case 'break':
$this->formObj->addBreak($fieldName, $this->formObj->getArrayValue($fieldDetails, 'html'));
break;
// Text box
// Text box
default:
break;
}
// Add optional fields
if ($type != 'break') {
// Element description
if ($desc = $this->formObj->getArrayValue($fieldDetails, 'desc')) {
$elem->description = $desc;
}
// Extra CSS
if ($cssclass = $this->formObj->getArrayValue($fieldDetails, 'cssclass')) {
$elem->cssclass = $cssclass;
}
// Add extra HTML if provided.
$extraHTML = $this->formObj->getArrayValue($fieldDetails, 'extrahtml');
if ($extraHTML) {
$elem->afterFormElementHTML = $extraHTML;
}
// Validation rules
if (isset($fieldDetails['validate']) && is_array($fieldDetails['validate'])) {
// Is it a custom function? If so, get the function name.
if ($this->formObj->getArrayValue($fieldDetails['validate'], 'type') == 'function') {
$elem->validationFn = $this->formObj->getArrayValue($fieldDetails['validate'], 'fname');
$elem->errorMessage = $this->formObj->getArrayValue($fieldDetails['validate'], 'error');
} else {
$elem->setValidationRules($fieldDetails['validate']);
}
}
}
return $elem;
}
