function constant_contact_settings in Constant Contact 6.3
Same name and namespace in other branches
- 6.2 system.admin.inc \constant_contact_settings()
- 7.3 admin.system.inc \constant_contact_settings()
Displays the module settings page in the admin
1 string reference to 'constant_contact_settings'
- constant_contact_menu in ./
constant_contact.module - Adds an admin menu for the Cnstant Contact module
File
- ./
admin.system.inc, line 45
Code
function constant_contact_settings() {
//user_roles()
drupal_add_js(drupal_get_path('module', 'constant_contact') . '/constant_contact.js');
$form = array();
$lists = array();
// if we have an object get the users contact lists
$cc = constant_contact_create_object();
if (is_object($cc)) {
$lists = constant_contact_get_lists($cc);
}
// register page settings
$form['constant_contact']['form'] = array(
'#type' => 'fieldset',
'#title' => t('Register Page and Update User Page Settings'),
'#collapsible' => TRUE,
'#collapsed' => true,
'#tree' => false,
'#description' => t('Customize register page and update user page settings, these settings apply to both register and update user pages, drupal also makes the same features available within the drupal admin interface'),
);
$form['constant_contact']['form']['cc_register_page_method'] = array(
'#type' => 'radios',
'#title' => t('Subscribe Method'),
'#description' => t('Choose to either display a checkbox and automatically subscribe users to the contact lists you select below or display a contact list selection for the users to choose which lists to subscribe to and choose which lists to exclude below'),
'#default_value' => variable_get('cc_register_page_method', CC_REGISTER_PAGE_METHOD),
'#options' => array(
'none' => 'Disabled',
'checkbox' => 'Checkbox - check a checkbox to subscribe',
'lists' => 'List Selection - select one or more contact lists to subscribe',
),
);
$form['constant_contact']['form']['cc_list_selection_format'] = array(
'#type' => 'radios',
'#title' => t('List Selection Format'),
'#default_value' => variable_get('cc_list_selection_format', CC_LIST_SELECTION_FORMAT),
'#options' => array(
'select' => 'Multi-Select',
'checkbox' => 'Checkboxes',
),
'#description' => t('If you use the "List Selection" method above you can change the format of the list selection to either checkboxes or a multi-select drop down, the default is a multi-select drop down.'),
);
$form['constant_contact']['form']['cc_default_opt_in'] = array(
'#type' => 'checkbox',
'#title' => t('Opt-in users by default?'),
'#description' => t('This determines if the register page checkbox is checked by default or if using the "List Selection" method the user will have all lists selected by default, uncheck this box if you want users to have to manually subscribe'),
'#default_value' => variable_get('cc_default_opt_in', CC_DEFAULT_OPT_IN),
);
if ($lists) {
$form['constant_contact']['form']['cc_lists'] = array(
'#type' => 'select',
'#title' => t('Contact lists'),
'#default_value' => variable_get('cc_lists', ''),
'#options' => $lists,
'#multiple' => true,
'#size' => 10,
'#description' => t('If you use the checkbox method you can choose which lists the subscriber will be automatically added or if you use the list selection method choose which lists to hide from the user, this relates to the "Register Page Subscribe Method" option above.'),
);
}
$form['constant_contact']['form']['cc_signup_title'] = array(
'#type' => 'textfield',
'#title' => t('Signup Title Text'),
'#description' => t("The title text displayed on the register page, if enabled"),
'#default_value' => variable_get('cc_signup_title', CC_SIGNUP_TITLE),
'#size' => 60,
);
$form['constant_contact']['form']['cc_signup_description'] = array(
'#type' => 'textfield',
'#title' => t('Signup Description Text'),
'#description' => t("The description text displayed on the register page, if enabled"),
'#default_value' => variable_get('cc_signup_description', CC_SIGNUP_DESCRIPTION),
'#size' => 60,
'#maxlength' => NULL,
);
$form['constant_contact']['form']['cc_extra_field_mappings'] = array(
'#type' => 'textarea',
'#title' => t('Extra Field Mappings'),
'#description' => t('Specify the mappings for your extra fields, if these fields are found in your registration form they will be sent to Constant Contact. You should define these in the format <em>FirstName:ActualFieldname</em> and separate with a comma. You will only need to change the second value to match your form field names. If using with the Drupal profile module, this would typically be entered as <em>FirstName:profile_first_name</em>.'),
'#default_value' => variable_get('cc_extra_field_mappings', ''),
'#rows' => 6,
);
// synchronization settings
$form['constant_contact']['synchronization'] = array(
'#type' => 'fieldset',
'#title' => t('Synchronization Settings'),
'#collapsible' => TRUE,
'#collapsed' => true,
'#tree' => false,
'#description' => t('Customize how the module synchronizes data with Constant Contact'),
);
$form['constant_contact']['synchronization']['cc_sync_unsubscribed_users'] = array(
'#type' => 'checkbox',
'#title' => t('Synchronize unsubscribed users?'),
'#description' => t('Checking this means the module will automatically synchronize users who have unsubscribed directly with the constant contact service with those users in your drupal database, this is necessary because people can unsubscribe from your mailing list through the constant contact website. This feature has only been tested with a small amount of users, use this option with extreme caution, if you have a large site consider running the drupal cron jobs more often to ensure it does not overload the server, likewise if you have a small site run the cron jobs less often to avoid checking for users with the API, alternatively disable this feature altogether and always use the Constant Contact website to get the latest subscribers data'),
'#default_value' => variable_get('cc_sync_unsubscribed_users', CC_SYNC_UNSUBSCRIBED_USERS),
);
// form block settings
$form['constant_contact']['block'] = array(
'#type' => 'fieldset',
'#title' => t('Form Block Settings'),
'#collapsible' => TRUE,
'#collapsed' => true,
'#tree' => false,
'#description' => t('Change settings for the custom form that is shown using the block method'),
);
$form['constant_contact']['block']['cc_block_show_list_selection'] = array(
'#type' => 'radios',
'#title' => t('Show List Selection'),
'#default_value' => variable_get('cc_block_show_list_selection', CC_BLOCK_SHOW_LIST_SELECTION),
'#options' => array(
'0' => 'No',
'1' => 'Yes',
),
'#description' => t('If you show the list selection you can exclude certain contact lists by selecting them below, if you don\'t show the list selection you can select which contact lists the subscribers are automatically added to.'),
);
$form['constant_contact']['block']['cc_block_list_selection_format'] = array(
'#type' => 'radios',
'#title' => t('List Selection Format'),
'#default_value' => variable_get('cc_block_list_selection_format', CC_LIST_SELECTION_FORMAT),
'#options' => array(
'select' => 'Multi-Select',
'checkbox' => 'Checkboxes',
),
'#description' => t('You can change the format of the list selection to either checkboxes or a multi-select drop down, the default is a multi-select drop down.'),
);
if ($lists) {
$form['constant_contact']['block']['cc_block_lists'] = array(
'#type' => 'select',
'#title' => t('Contact lists'),
'#default_value' => variable_get('cc_block_lists', ''),
'#options' => $lists,
'#multiple' => true,
'#size' => 10,
);
}
$form['constant_contact']['block']['cc_block_redirect_url'] = array(
'#type' => 'textfield',
'#title' => t('Thank You Page'),
'#description' => t('After a user submits the form you can send them to a URL, enter the full website address here or leave blank for no redirect'),
'#default_value' => variable_get('cc_block_redirect_url', ''),
);
$extra_fields = array_slice(variable_get('cc_extra_fields', array()), 0, 18);
$options = $extra_fields ? array_combine(array_values($extra_fields), array_values($extra_fields)) : array();
$form['constant_contact']['block']['cc_form_block_fields'] = array(
'#type' => 'checkboxes',
'#title' => t('Extra Fields'),
'#description' => t('Select which extra fields you would like to display in the form, these will be sent along to Constant Contact with the subscribers email'),
'#default_value' => variable_get('cc_form_block_fields', array()),
'#options' => $options,
);
$form['constant_contact']['block']['cc_email_field_position'] = array(
'#type' => 'textfield',
'#title' => t('Position of email field'),
'#description' => t('Enter the position of the email field in the form, numbers only, depending which extra fields you choose above you may not need to configure this option'),
'#default_value' => variable_get('cc_email_field_position', 1),
'#size' => 10,
);
// Other settings
$form['constant_contact']['other'] = array(
'#type' => 'fieldset',
'#title' => t('Other Settings'),
'#collapsible' => TRUE,
'#collapsed' => true,
'#tree' => false,
'#description' => t('Other settings you can configure'),
);
$form['constant_contact']['other']['cc_subscribe_format'] = array(
'#type' => 'radios',
'#title' => t('Default Email Format'),
'#description' => t('You can choose the format of email for new subscribers, HTML or Text, if you select to show a selection to the user below it will ask them what format email they would like to receive and the option you choose here will be selected by default'),
'#default_value' => variable_get('cc_subscribe_format', CC_SUBSCRIBE_FORMAT),
'#options' => array(
'HTML' => 'HTML',
'Text' => 'Text',
),
);
$form['constant_contact']['other']['cc_show_format_choice'] = array(
'#type' => 'checkbox',
'#title' => t('Show Email Format Selection'),
'#description' => t('Should we show an email format selection to subscribers, if you check this box it will show a selection to the user allowing them to choose between HTML and Text email'),
'#default_value' => variable_get('cc_show_format_choice', CC_SHOW_FORMAT_CHOICE),
);
$form['constant_contact']['other']['cc_contact_list_sort_order'] = array(
'#type' => 'select',
'#title' => t('Sort contact lists by'),
'#description' => t('You can change the way contact lists are sorted, Name sorts them alphabetically, id sorts them newest to oldest, Sort Order sorts them using the custom Order you have defined'),
'#default_value' => variable_get('cc_contact_list_sort_order', CC_CONTACT_LIST_SORT_ORDER),
'#options' => array(
'SortOrder' => 'Sort Order',
'id' => 'ID',
'Name' => 'Name',
),
);
$form['constant_contact']['other']['cc_lists_cache_expire'] = array(
'#type' => 'select',
'#title' => t('Contact lists expire after'),
'#description' => t('This defines how long the contact lists are kept in the cache'),
'#default_value' => variable_get('cc_lists_cache_expire', CC_CONTACT_LISTS_CACHE_EXPIRE),
'#options' => array(
3600 => '1 hour',
3600 * 2 => '2 hours',
3600 * 3 => '3 hours',
3600 * 4 => '4 hours',
3600 * 5 => '5 hours',
3600 * 10 => '10 hours',
3600 * 24 => '24 hours',
),
);
$form['#redirect'] = 'admin/settings/constant_contact/intro';
return system_settings_form($form);
}