mailchimp_campaign.admin.inc in Mailchimp 7.2

Administration pages for mailchimp_campaign module.

File

modules/mailchimp_campaign/mailchimp_campaign.admin.inc

View source

<?php

/**
 * @file
 * Administration pages for mailchimp_campaign module.
 */

/**
 * Returns a form for creating a campaign.
 */
function mailchimp_campaign_campaign_form($form, &$form_state, MailChimpCampaign $campaign = NULL) {
  $form_state['campaign'] = $campaign;
  $form['title'] = array(
    '#type' => 'textfield',
    '#title' => t('Title'),
    '#description' => t('An internal name to use for this campaign. By default, the campaign subject will be used.'),
    '#required' => FALSE,
    '#default_value' => $campaign ? $campaign->mc_data['title'] : '',
  );
  $form['subject'] = array(
    '#type' => 'textfield',
    '#title' => t('Subject'),
    '#required' => TRUE,
    '#default_value' => $campaign ? $campaign->mc_data['subject'] : '',
  );
  $form['list_id'] = array(
    '#type' => 'select',
    '#title' => t('List'),
    '#description' => t('Select the list this campaign should be sent to.'),
    '#options' => _mailchimp_campaign_build_option_list(mailchimp_get_lists()),
    '#default_value' => $campaign ? $campaign->mc_data['list_id'] : -1,
    '#required' => TRUE,
  );
  $form['from_email'] = array(
    '#type' => 'textfield',
    '#title' => t('From Email'),
    '#description' => t('the From: email address for your campaign message.'),
    '#default_value' => $campaign ? $campaign->mc_data['from_email'] : variable_get('site_mail'),
    '#size' => 40,
    '#maxlength' => 255,
    '#required' => TRUE,
  );
  $form['from_name'] = array(
    '#type' => 'textfield',
    '#title' => t('From Name'),
    '#description' => t('the From: name for your campaign message (not an email address)'),
    '#default_value' => $campaign ? $campaign->mc_data['from_name'] : variable_get('site_name'),
    '#size' => 40,
    '#maxlength' => 255,
  );
  $form['template_id'] = array(
    '#type' => 'select',
    '#title' => t('Template'),
    '#description' => t('Select a MailChimp user template to use. Due to a limitation in the API, only templates that do not contain repeating sections are available. If empty, the default template will be applied.'),
    '#options' => _mailchimp_campaign_build_option_list(mailchimp_campaign_get_templates()),
    '#default_value' => $campaign ? $campaign->mc_data['template_id'] : -1,
    '#ajax' => array(
      'callback' => 'mailchimp_campaign_template_callback',
      'wrapper' => 'content-sections',
    ),
  );
  $form['content'] = array(
    '#id' => 'content-sections',
    '#type' => 'fieldset',
    '#title' => t('Content sections'),
    '#description' => t('The HTML content or, if a template is selected, the content for each section.'),
    '#collapsible' => TRUE,
    '#collapsed' => FALSE,
    '#tree' => TRUE,
  );
  $mc_template = NULL;
  if (!empty($form_state['values']['template_id'])) {
    $mc_template = mailchimp_campaign_get_templates($form_state['values']['template_id']);
  }
  else {
    if ($campaign && $campaign->mc_template) {
      $mc_template = $campaign->mc_template;
    }
  }
  if ($mc_template) {
    foreach ($mc_template['info']['default_content'] as $section => $content) {

      // Set the default value and text format to either saved campaign values
      // or defaults coming from the MC template.
      $default_value = $content;
      $format = 'mailchimp_campaign';
      if ($campaign && $campaign->template['html_' . $section]) {
        $default_value = $campaign->template['html_' . $section]['value'];
        $format = $campaign->template['html_' . $section]['format'];
      }
      $form['content']['html_' . $section] = array(
        '#type' => 'text_format',
        '#format' => $format,
        '#title' => drupal_ucfirst($section),
        '#default_value' => $default_value,
      );
    }
  }
  else {
    $form['content']['html'] = array(
      '#type' => 'text_format',
      '#format' => $campaign ? $campaign->template['html']['format'] : 'mailchimp_campaign',
      '#title' => t('Content'),
      '#description' => t('The HTML content of the campaign.'),
      '#access' => empty($form_state['values']['template_id']),
      '#default_value' => $campaign ? $campaign->template['html']['value'] : '',
    );
  }

  // Message preview
  if (isset($form_state['mailchimp_campaign_campaign_preview'])) {
    $form['preview_wrapper'] = array(
      '#title' => t('Campaign content preview'),
      '#type' => 'fieldset',
      '#collapsible' => TRUE,
      '#collapsed' => FALSE,
    );
    $form['preview_wrapper']['preview'] = array(
      '#markup' => $form_state['mailchimp_campaign_campaign_preview'],
    );
  }
  $form['actions']['preview'] = array(
    '#type' => 'submit',
    '#value' => t('Preview content'),
    '#weight' => 10,
    '#submit' => array(
      'mailchimp_campaign_campaign_preview',
    ),
  );
  $form['actions']['save'] = array(
    '#type' => 'submit',
    '#value' => t('Save as draft'),
  );
  return $form;
}

/**
 * AJAX callback when changing template id.
 *
 * @param $form
 * @param $form_state
 *
 * @return mixed
 */
function mailchimp_campaign_template_callback($form, $form_state) {
  return $form['content'];
}

/**
 * Preview callback for mailchimp_campaign_campaign_form().
 *
 * @param $form
 * @param $form_state
 */
function mailchimp_campaign_campaign_preview($form, &$form_state) {
  $text = '';
  $content = mailchimp_campaign_render_template($form_state['values']['content']);
  foreach ($content as $key => $section) {
    $text .= "<h3>{$key}</h3>" . $section;
  }
  $form_state['mailchimp_campaign_campaign_preview'] = $text;
  $form_state['rebuild'] = TRUE;
}

/**
 * Validation callback for mailchimp_campaign_campaign_form().
 *
 * @param $form
 * @param $form_state
 */
function mailchimp_campaign_campaign_form_validate($form, &$form_state) {
  if (!valid_email_address($form_state['values']['from_email'])) {
    form_set_error('from_email', t('Please provide a valid From email address.'));
  }
}

/**
 * Submit handler for mailchimp_campaign_campaign_form().
 *
 * @param $form
 * @param $form_state
 */
function mailchimp_campaign_campaign_form_submit($form, &$form_state) {
  $values = $form_state['values'];
  $options = array(
    'title' => $values['title'],
    'subject' => $values['subject'],
    'list_id' => $values['list_id'],
    'from_email' => $values['from_email'],
    'from_name' => check_plain($values['from_name']),
    'template_id' => $values['template_id'],
  );
  $campaign_id = isset($form_state['campaign']) ? $form_state['campaign']->mc_campaign_id : NULL;
  mailchimp_campaign_save_campaign($values['content'], $options, $campaign_id);
  cache_clear_all('mailchimp_campaign_campaigns', 'cache');
  $form_state['redirect'][] = 'admin/config/services/mailchimp/campaigns';
}

/**
 * Returns an options list for a given array of items.
 */
function _mailchimp_campaign_build_option_list($list) {
  $options = array(
    '' => t('-- Select --'),
  );
  foreach ($list as $item) {
    $options[$item['id']] = $item['name'];
  }
  return $options;
}

/**
 * List deletion form.
 *
 * @param string $form
 * @param string $form_state
 * @param object $list
 */
function mailchimp_campaign_delete_form($form, &$form_state, MailChimpCampaign $campaign) {
  $form_state['campaign'] = $campaign;
  return confirm_form($form, t('Are you sure you want to delete %name?', array(
    '%name' => $campaign
      ->label(),
  )), 'admin/config/services/mailchimp/campaigns/' . $campaign->mc_campaign_id, t('This action will delete both the MailChimp campaign and Drupal entity and cannot be undone.'), t('Delete campaign'));
}

/**
 * Submit handler for mailchimp_campaign_delete_list_form();
 *
 * @param string $form
 * @param string $form_state
 */
function mailchimp_campaign_delete_form_submit($form, &$form_state) {
  $campaign = $form_state['campaign'];
  mailchimp_campaign_delete_campaign($campaign->mc_campaign_id);
  drupal_set_message(t('Campaign %name has been deleted.', array(
    '%name' => $campaign
      ->label(),
  )));
  drupal_goto('admin/config/services/mailchimp/campaigns');
}

/**
 * List deletion form.
 *
 * @param string $form
 * @param string $form_state
 * @param object $list
 */
function mailchimp_campaign_send_form($form, &$form_state, MailChimpCampaign $campaign) {
  $form_state['campaign'] = $campaign;
  return confirm_form($form, t('Are you sure you want to send %name?', array(
    '%name' => $campaign
      ->label(),
  )), 'admin/config/services/mailchimp/campaigns/' . $campaign->mc_campaign_id, t('This action will send the campaign through MailChimp and cannot be undone.'), t('Send campaign'));
}

/**
 * Submit handler for mailchimp_campaign_delete_list_form();
 *
 * @param string $form
 * @param string $form_state
 */
function mailchimp_campaign_send_form_submit($form, &$form_state) {
  $campaign = $form_state['campaign'];
  mailchimp_campaign_send_campaign($campaign);
  drupal_set_message(t('Campaign %name has been sent.', array(
    '%name' => $campaign
      ->label(),
  )));
  drupal_goto('admin/config/services/mailchimp/campaigns');
}

Functions

Name	Description
mailchimp_campaign_campaign_form	Returns a form for creating a campaign.
mailchimp_campaign_campaign_form_submit	Submit handler for mailchimp_campaign_campaign_form().
mailchimp_campaign_campaign_form_validate	Validation callback for mailchimp_campaign_campaign_form().
mailchimp_campaign_campaign_preview	Preview callback for mailchimp_campaign_campaign_form().
mailchimp_campaign_delete_form	List deletion form.
mailchimp_campaign_delete_form_submit	Submit handler for mailchimp_campaign_delete_list_form();
mailchimp_campaign_send_form	List deletion form.
mailchimp_campaign_send_form_submit	Submit handler for mailchimp_campaign_delete_list_form();
mailchimp_campaign_template_callback	AJAX callback when changing template id.
_mailchimp_campaign_build_option_list	Returns an options list for a given array of items.

You are here

mailchimp_campaign.admin.inc in Mailchimp 7.2

File

Functions

API Navigation