auditioneer.module

<?php

function _auditioneer_display_bits(){
  drupal_add_js(drupal_get_path('module', 'auditioneer') . '/auditioneer.js', array('type' => 'file', 'scope' => 'footer'));
  drupal_add_css(drupal_get_path('module', 'auditioneer') . '/auditioneer.css', array('group' => CSS_DEFAULT, 'type' => 'file'));
  $settings = array(
    'timeblock_checked' => variable_get('auditioneer_timeblock_checked', "PaleGreen"),
    'timeblock_unchecked' => variable_get('auditioneer_timeblock_unchecked', "LightPink"),
    'timeblock_checked_text' => variable_get('auditioneer_timeblock_checked_text', "black"),
    'timeblock_unchecked_text' => variable_get('auditioneer_timeblock_unchecked_text', "white"),
  );
  drupal_add_js(array('auditioneer' => $settings), 'setting');
}

foreach (array("manage", "signup", "content_type") as $file){
  module_load_include('inc', 'auditioneer', 'includes/'.$file);
}

/**
 * Implements hook_help().
 *
 * Displays help and module information.
 *
 * @param path 
 *   Which path of the site we're using to display help
 * @param arg 
 *   Array that holds the current path as returned from arg() function
 */
function auditioneer_help($path, $arg) {
  _auditioneer_display_bits();
  switch ($path) {
  case "admin/help#auditioneer":
    return '<p>' . t("Content types and other code for auditions") . '</p>';
    break;
  }
}

function auditioneer_element_validate_css_color($element, &$form_state){
  $css_colors = array("AliceBlue", "AntiqueWhite", "Aqua", "Aquamarine", "Azure", "Beige", "Bisque", "Black", "BlanchedAlmond", "Blue", "BlueViolet", "Brown", "BurlyWood", "CadetBlue", "Chartreuse", "Chocolate", "Coral", "CornflowerBlue", "Cornsilk", "Crimson", "Cyan", "DarkBlue", "DarkCyan", "DarkGoldenRod", "DarkGray", "DarkGrey", "DarkGreen", "DarkKhaki", "DarkMagenta", "DarkOliveGreen", "DarkOrange", "DarkOrchid", "DarkRed", "DarkSalmon", "DarkSeaGreen", "DarkSlateBlue", "DarkSlateGray", "DarkSlateGrey", "DarkTurquoise", "DarkViolet", "DeepPink", "DeepSkyBlue", "DimGray", "DimGrey", "DodgerBlue", "FireBrick", "FloralWhite", "ForestGreen", "Fuchsia", "Gainsboro", "GhostWhite", "Gold", "GoldenRod", "Gray", "Grey", "Green", "GreenYellow", "HoneyDew", "HotPink", "IndianRed", "Indigo", "Ivory", "Khaki", "Lavender", "LavenderBlush", "LawnGreen", "LemonChiffon", "LightBlue", "LightCoral", "LightCyan", "LightGoldenRodYellow", "LightGray", "LightGrey", "LightGreen", "LightPink", "LightSalmon", "LightSeaGreen", "LightSkyBlue", "LightSlateGray", "LightSlateGrey", "LightSteelBlue", "LightYellow", "Lime", "LimeGreen", "Linen", "Magenta", "Maroon", "MediumAquaMarine", "MediumBlue", "MediumOrchid", "MediumPurple", "MediumSeaGreen", "MediumSlateBlue", "MediumSpringGreen", "MediumTurquoise", "MediumVioletRed", "MidnightBlue", "MintCream", "MistyRose", "Moccasin", "NavajoWhite", "Navy", "OldLace", "Olive", "OliveDrab", "Orange", "OrangeRed", "Orchid", "PaleGoldenRod", "PaleGreen", "PaleTurquoise", "PaleVioletRed", "PapayaWhip", "PeachPuff", "Peru", "Pink", "Plum", "PowderBlue", "Purple", "RebeccaPurple", "Red", "RosyBrown", "RoyalBlue", "SaddleBrown", "Salmon", "SandyBrown", "SeaGreen", "SeaShell", "Sienna", "Silver", "SkyBlue", "SlateBlue", "SlateGray", "SlateGrey", "Snow", "SpringGreen", "SteelBlue", "Tan", "Teal", "Thistle", "Tomato", "Turquoise", "Violet", "Wheat", "White", "WhiteSmoke", "Yellow", "YellowGreen");
  if(!preg_match("/^#[abcdef0-9]{6}$/i", $element['#value']) &&
     !preg_grep("/^".$element['#value']."$/i", $css_colors)
    ){
    form_error($element, t('You must enter a valid CSS color.'));
  }
}

/**
 * Implements hook_menu().
 */
function auditioneer_admin() {
  _auditioneer_display_bits();
  $form = array();

  $form['auditioneer_signup_path'] = array(
    '#type' => 'textfield',
    '#title' => t('Signup page path'),
    '#default_value' => variable_get('auditioneer_signup_path'),
    '#description' => t("The path to the signup page where all pending auditions will be visible to users (currently <a href='/".variable_get('auditioneer_signup_path')."'>/".variable_get('auditioneer_signup_path')."</a>). <strong>You may need to clear the site cache for changes to this setting to take effect.</strong>"),
    '#required' => TRUE
  );
  $form['auditioneer_notify_from'] = array(
    '#type' => 'textfield',
    '#title' => t('Send notification emails from:'),
    '#size' => 25,
    '#default_value' => variable_get('auditioneer_notify_from'),
    '#description' => t("Sets the <strong>From</strong> address for notification emails. Set to an address that will be read by a live person, able to answer questions from auditioners."),
    '#required' => TRUE
  );
  $form['auditioneer_resume_upload_path'] = array(
    '#type' => 'textfield',
    '#title' => t('Resum&eacute;  upload path'),
    '#size' => 25,
    '#default_value' => variable_get('auditioneer_resume_upload_path'),
    '#description' => t("Where to store uploaded headshots/resum&eacute;s, as a Drupal file URI. Recommended value: <strong>private://</strong>. You must first ensure that the Private file system path is correctly configured at <a href='/admin/config/media/file-system'>/admin/config/media/file-system</a>. Uploaded resum&eacute;s will be anonymously accessible if this is set to <strong>public://</strong>."),
    '#required' => TRUE
  );
  $form['auditioneer_firstname_field'] = array(
    '#type' => 'textfield',
    '#title' => t('Given name field:'),
    '#size' => 25,
    '#default_value' => variable_get('auditioneer_firstname_field'),
    '#description' => t("If user accounts on this site have extra fields for storign a user's real name, set this to the field name of the first name/given name (e.g. field_firstname))"),
    '#required' => FALSE
  );
  $form['auditioneer_lastname_field'] = array(
    '#type' => 'textfield',
    '#title' => t('Surname field:'),
    '#size' => 25,
    '#default_value' => variable_get('auditioneer_lastname_field'),
    '#description' => t("If user accounts on this site have extra fields for storign a user's real name, set this to the field name of the last name/surname (e.g. field_lastname)"),
    '#required' => FALSE
  );

  $form['auditioneer_messaging'] = array(
    '#type' => 'fieldset',
    '#collapsed' => true,
    '#collapsible' => true,
    '#title' => "Signup Form Messages"
  );
  $form['auditioneer_messaging']['auditioneer_signup_open_message'] = array(
    '#type' => 'textarea',
    '#title' => t('Open signup instructions'),
    '#default_value' => variable_get('auditioneer_signup_open_message'),
    '#cols' => 50,
    '#rows' => 3,
    '#maxlength' => 300,
    '#description' => t("The message to show on an audition signup form when the signups are open and the user has not yet signed up."),
    '#required' => TRUE,
  );
  $form['auditioneer_messaging']['auditioneer_signup_signedup_message'] = array(
    '#type' => 'textarea',
    '#title' => t('Instructions to update an existing audition signup'),
    '#default_value' => variable_get('auditioneer_signup_signedup_message'),
    '#cols' => 50,
    '#rows' => 3,
    '#maxlength' => 300,
    '#description' => t("The message to show on an audition signup form when the signups are open and the user HAS signed up."),
    '#required' => TRUE,
  );
  $form['auditioneer_messaging']['auditioneer_signup_closed_message'] = array(
    '#type' => 'textarea',
    '#title' => t('Closed signup message'),
    '#default_value' => variable_get('auditioneer_signup_closed_message'),
    '#cols' => 50,
    '#rows' => 3,
    '#maxlength' => 300,
    '#description' => t("The message to show on an audition signup form when the signups are closed, the user has signed up, and the assignments have not yet been drawn."),
    '#required' => TRUE,
  );

  $form['auditioneer_messaging']['auditioneer_signup_closed_nosignup_message'] = array(
    '#type' => 'textarea',
    '#title' => t('Closed signup message for users who have not signed up'),
    '#default_value' => variable_get('auditioneer_signup_closed_nosignup_message'),
    '#cols' => 50,
    '#rows' => 3,
    '#maxlength' => 300,
    '#description' => t("The message to show on a lottery audition signup form when the lottery is closed and the user has NOT signed up."),
    '#required' => TRUE,
  );
  $form['auditioneer_messaging']['auditioneer_signup_finalized_waitlisted_message'] = array(
    '#type' => 'textarea',
    '#title' => t('Signup form message for users who have been assigned to the waitlist'),
    '#default_value' => variable_get('auditioneer_signup_finalized_waitlisted_message'),
    '#cols' => 50,
    '#rows' => 3,
    '#maxlength' => 300,
    '#required' => TRUE,
  );
  $form['auditioneer_messaging']['auditioneer_signup_finalized_ineligible_message'] = array(
    '#type' => 'textarea',
    '#title' => t('Signup form message for users who have been marked ineligible.'),
    '#default_value' => variable_get('auditioneer_signup_finalized_ineligible_message'),
    '#cols' => 50,
    '#rows' => 3,
    '#maxlength' => 300,
    '#required' => TRUE,
  );

  $form['auditioneer_corner_banner'] = array(
    '#type' => 'fieldset',
    '#collapsed' => true,
    '#collapsible' => true,
    '#title' => "Signup Form Corner Banner"
  );
  $form['auditioneer_corner_banner']['auditioneer_signup_open_banner'] = array(
    '#type' => 'textfield',
    '#title' => t('Banner text for open auditions.'),
    '#default_value' => variable_get('auditioneer_signup_open_banner'),
    '#size' => 15,
    '#maxlength' => 18,
    '#description' => t("The text for the corner banner on a lottery audition signup form when the lottery is open and the user has not yet signed up."),
    '#required' => false,
  );
  $form['auditioneer_corner_banner']['auditioneer_signup_open_color'] = array(
    '#type' => 'textfield',
    '#title' => t('Banner background color for open auditions.'),
    '#default_value' => variable_get('auditioneer_signup_open_color'),
    '#size' => 20,
    '#maxlength' => 15,
    '#element_validate' => array('auditioneer_element_validate_css_color'),
    '#description' => t("The background color for the corner banner on a lottery audition signup form when the lottery is open and the user has not yet signed up."),
    '#required' => TRUE,
  );
  $form['auditioneer_corner_banner']['auditioneer_signup_signedup_banner'] = array(
    '#type' => 'textfield',
    '#title' => t('Banner text for auditions the user has entered.'),
    '#default_value' => variable_get('auditioneer_signup_signedup_banner'),
    '#size' => 15,
    '#maxlength' => 18,
    '#description' => t("The text for the corner banner on a lottery audition signup form when the user HAS signed up."),
    '#required' => false,
  );
  $form['auditioneer_corner_banner']['auditioneer_signup_signedup_color'] = array(
    '#type' => 'textfield',
    '#title' => t('Banner background color for auditions the user has entered.'),
    '#default_value' => variable_get('auditioneer_signup_signedup_color'),
    '#size' => 20,
    '#maxlength' => 15,
    '#element_validate' => array('auditioneer_element_validate_css_color'),
    '#description' => t("The background color for the corner banner on a lottery audition signup form when the user HAS signed up."),
    '#required' => TRUE,
  );
  $form['auditioneer_corner_banner']['auditioneer_signup_closed_nosignup_banner'] = array(
    '#type' => 'textfield',
    '#title' => t('Banner text for closed auditions.'),
    '#default_value' => variable_get('auditioneer_signup_closed_nosignup_banner'),
    '#size' => 15,
    '#maxlength' => 18,
    '#description' => t("The text for the corner banner on a lottery audition signup form when the lottery is closed and the user has NOT signed up."),
    '#required' => false,
  );
  $form['auditioneer_corner_banner']['auditioneer_signup_closed_nosignup_color'] = array(
    '#type' => 'textfield',
    '#title' => t('Banner background color for closed auditions.'),
    '#default_value' => variable_get('auditioneer_signup_closed_nosignup_color'),
    '#size' => 20,
    '#maxlength' => 15,
    '#element_validate' => array('auditioneer_element_validate_css_color'),
    '#description' => t("The background color for the corner banner on a lottery audition signup form when the lottery is closed and the user has NOT signed up."),
    '#required' => TRUE,
  );
  $form['auditioneer_corner_banner']['auditioneer_signup_unfinalized_banner'] = array(
    '#type' => 'textfield',
    '#title' => t('Banner text for auditions past the signup deadline but not yet finalized.'),
    '#default_value' => variable_get('auditioneer_signup_unfinalized_banner'),
    '#size' => 15,
    '#maxlength' => 18,
    '#required' => false,
  );

  $form['auditioneer_corner_banner']['auditioneer_signup_unfinalized_color'] = array(
    '#type' => 'textfield',
    '#title' => t('Banner background color for auditions past the signup deadline but not yet finalized.'),
    '#default_value' => variable_get('auditioneer_signup_unfinalized_color'),
    '#size' => 20,
    '#maxlength' => 15,
    '#element_validate' => array('auditioneer_element_validate_css_color'),
    '#required' => TRUE,
  );
  $form['auditioneer_corner_banner']['auditioneer_signup_gotslot_banner'] = array(
    '#type' => 'textfield',
    '#title' => t('Banner text for finalized auditions where the user has been assigned a definite slot.'),
    '#default_value' => variable_get('auditioneer_signup_gotslot_banner'),
    '#size' => 15,
    '#maxlength' => 18,
    '#description' => t("The text for the corner banner on a lottery audition signup form when the lottery is finalized and the user has been assigned a definite slot."),
    '#required' => false,
  );

  $form['auditioneer_corner_banner']['auditioneer_signup_gotslot_color'] = array(
    '#type' => 'textfield',
    '#title' => t('Banner background color for auditions for which the user has been assigned a definite slot.'),
    '#default_value' => variable_get('auditioneer_signup_gotslot_color'),
    '#size' => 20,
    '#maxlength' => 15,
    '#element_validate' => array('auditioneer_element_validate_css_color'),
    '#description' => t("The background color for the corner banner on a lottery audition signup form when the lottery is finalized and the user has been assigned a slot."),
    '#required' => TRUE,
  );
  $form['auditioneer_corner_banner']['auditioneer_signup_waitlist_banner'] = array(
    '#type' => 'textfield',
    '#title' => t('Banner text for finalized auditions where the user has been assigned to the waitlist.'),
    '#default_value' => variable_get('auditioneer_signup_waitlist_banner'),
    '#size' => 15,
    '#maxlength' => 18,
    '#description' => t("The text for the corner banner on a lottery audition signup form when the lottery is finalized and the user has been assigned to the waitlist."),
    '#required' => false,
  );
  $form['auditioneer_corner_banner']['auditioneer_signup_waitlist_color'] = array(
    '#type' => 'textfield',
    '#title' => t('Banner background color for auditions for which the user has been assigned to the waitlist.'),
    '#default_value' => variable_get('auditioneer_signup_waitlist_color'),
    '#size' => 20,
    '#maxlength' => 15,
    '#element_validate' => array('auditioneer_element_validate_css_color'),
    '#description' => t("The background color for the corner banner on a lottery audition signup form when the lottery is finalized and the user has been assigned to the waitlist."),
    '#required' => TRUE,
  );
  $form['auditioneer_corner_banner']['auditioneer_signup_ineligible_banner'] = array(
    '#type' => 'textfield',
    '#title' => t('Banner text for finalized auditions where the user has been marked ineligible.'),
    '#default_value' => variable_get('auditioneer_signup_ineligible_banner'),
    '#size' => 15,
    '#maxlength' => 18,
    '#description' => t("The text for the corner banner on a lottery audition signup form when the lottery is finalized and the user has been marked ineligible."),
    '#required' => false,
  );
  $form['auditioneer_corner_banner']['auditioneer_signup_ineligible_color'] = array(
    '#type' => 'textfield',
    '#title' => t('Banner background color for auditions for which the user has been marked ineligible.'),
    '#default_value' => variable_get('auditioneer_signup_ineligible_color'),
    '#size' => 20,
    '#maxlength' => 15,
    '#element_validate' => array('auditioneer_element_validate_css_color'),
    '#description' => t("The background color for the corner banner on a lottery audition signup form when the lottery is finalized and the user has been marked ineligible."),
    '#required' => TRUE,
  );

  $form['auditioneer_timeblock'] = array(
    '#type' => 'fieldset',
    '#collapsed' => true,
    '#collapsible' => true,
    '#title' => "Signup Form Time Block Styling"
  );
  $form['auditioneer_timeblock']['auditioneer_timeblock_checked_text'] = array(
    '#type' => 'textfield',
    '#title' => t('Foreground color for time blocks the user has selected.'),
    '#default_value' => variable_get('auditioneer_timeblock_checked_text'),
    '#size' => 15,
    '#maxlength' => 20,
    '#element_validate' => array('auditioneer_element_validate_css_color'),
    '#required' => TRUE,
  );
  $form['auditioneer_timeblock']['auditioneer_timeblock_checked'] = array(
    '#type' => 'textfield',
    '#title' => t('Background color for time blocks the user has selected.'),
    '#default_value' => variable_get('auditioneer_timeblock_checked'),
    '#size' => 15,
    '#maxlength' => 20,
    '#element_validate' => array('auditioneer_element_validate_css_color'),
    '#required' => TRUE,
  );
  $form['auditioneer_timeblock']['auditioneer_timeblock_unchecked_text'] = array(
    '#type' => 'textfield',
    '#title' => t('Foreground color for time blocks the user has NOT selected.'),
    '#default_value' => variable_get('auditioneer_timeblock_unchecked_text'),
    '#size' => 15,
    '#maxlength' => 20,
    '#element_validate' => array('auditioneer_element_validate_css_color'),
    '#required' => TRUE,
  );
  $form['auditioneer_timeblock']['auditioneer_timeblock_unchecked'] = array(
    '#type' => 'textfield',
    '#title' => t('Background color for time blocks the user has NOT selected.'),
    '#default_value' => variable_get('auditioneer_timeblock_unchecked'),
    '#size' => 15,
    '#maxlength' => 20,
    '#element_validate' => array('auditioneer_element_validate_css_color'),
    '#required' => TRUE,
  );
  $form['css_colors_guide'] = array(
    '#type' => 'item',
    '#markup' => '<em>Color fields accept any valid CSS color string. See the <a href="http://www.w3schools.com/colors/default.asp" target="_blank">W3 Schools</a> guide on CSS/HTML colors for more information.</em>',
    '#weight' => 9
  );

  return system_settings_form($form);
}


/**
 * Implements hook_menu().
 */
function auditioneer_menu() {
  global $user;
  _auditioneer_display_bits();
  $items = array();

  $items['admin/config/people/auditions'] = array(
    'title' => 'Auditions',
    'description' => 'Manage slot assignments and settings for the Auditions module.',
    'type' => MENU_NORMAL_ITEM,
    'access callback' => 'user_access',
    'access arguments' => array('administer auditions')
  );
  $auditions = node_load_multiple(array(), array('type' => "auditioneer_audition"));

  uasort($auditions, '_auditioneer_sort_by_date');
  foreach ($auditions as $nid => $audition){
    list($start, $end) = _auditioneer_get_times($audition);
    if($end < time()){
      continue;
    }
    $items['admin/config/people/auditions/'.$nid] = array(
      'title' => "Audition: ".$audition->title,
      'description' => drupal_render(field_view_field('node', $audition, 'field_auditioneer_time_blocks', 'auditioneer_audition_signup_form')),
      'page callback' => 'auditioneer_manage',
      'page arguments' => array(4, 5),
      'access callback' => 'user_access',
      'access arguments' => array('administer auditions'),
      'type' => MENU_NORMAL_ITEM
    );
  }

  $items['admin/config/people/auditions/audition_settings'] = array(
    'title' => 'Global Audition Settings',
    'weight' => -100,
    'description' => 'Configuration settings for the Auditioneer module. Use this to customize signup messaging, colors, etc.',
    'page callback' => 'drupal_get_form',
    'page arguments' => array('auditioneer_admin'),
    'access callback' => 'user_access',
    'access arguments' => array('administer auditions'),
    'type' => MENU_NORMAL_ITEM
  );

  $items[variable_get('auditioneer_signup_path')] = array(
    'title' => 'Audition Signups',
    'description' => 'Sign up for pending auditions.',
    'page callback' => 'auditioneer_signup_page',
    'access callback' => 'user_access',
    'access arguments' => array('view and sign up for auditions')
  );
  return $items;
}


/**
 * Implements hook_theme_registry_alter().
 */
function auditioneer_theme_registry_alter(&$theme_registry) {
  _auditioneer_display_bits();
  // Defined path to the current module.
  $module_path = drupal_get_path('module', 'auditioneer')."/templates";
  // Find all .tpl.php files in this module's folder recursively.
  $template_file_objects = drupal_find_theme_templates($theme_registry, '.tpl.php', $module_path);
  // Iterate through all found template file objects.
  foreach ($template_file_objects as $key => $template_file_object) {
    // If the template has not already been overridden by a theme.
    if (!isset($theme_registry[$key]['theme path']) || !preg_match('#/themes/#', $theme_registry[$key]['theme path'])) {
      // Alter the theme path and template elements.
      $theme_registry[$key]['theme path'] = $module_path;
      $theme_registry[$key] = array_merge($theme_registry[$key], $template_file_object);
      $theme_registry[$key]['type'] = 'module';
    }
  }
}

/**
 * Manipulate our plain old lottery object into a signup form for itself. This
 * is what should always be displayed to end users, whatever the context (page,
 * views, etc), so give the templatessomething they can render.
 */
function auditioneer_preprocess_node(&$variables){
  if($variables['type'] == "auditioneer_audition"){
    $variables['audition_signup_form'] = auditioneer_signup_page($variables['nid'], $variables['elements']);
  }
}

function _auditioneer_form_builder($form, &$form_state, $args){
  _auditioneer_display_bits();
  if(preg_match("/^audition_signup_\d+$/", $form_state['build_info']['form_id'])){
    return(_auditioneer_signup_form($form, $form_state, $args));
  } else if(preg_match("/^audition_mgmt_\d+$/", $form_state['build_info']['form_id'])){
    return(_auditioneer_mgmt_form($form, $form_state, $args));
  }
  return($form);
}

function auditioneer_theme($existing, $type, $theme, $path){
  $themes = array(
    'auditioneer_components' => array(
      'render element' => 'element'
    ),
  );
  return $themes;
}

/**
 */
function auditioneer_permission(){
  return array(
    'administer auditions' => array(
      'title' => t('Administer Auditioneer'),
      'description' => t('Adjust style settings for audition signups and administer auditions'),
    ),
    'view and sign up for auditions' => array(
      'title' => t('Sign up for Auditioneer auditions'),
      'description' => t('Users with this permission can see pending auditions and sign up for them. If this permission is granted to anonymous users, name, email, and headshot/resumes will be automatically collected.'),
    )
  );
}

/*
 * Workaround for nitwit hosting providers still on PHP 5.2 (?!!!)
 */
class AuditioneerDateTime extends DateTime
{
    public function setTimestamp( $timestamp )
    {
        $date = getdate( ( int ) $timestamp );
        $this->setDate( $date['year'] , $date['mon'] , $date['mday'] );
        $this->setTime( $date['hours'] , $date['minutes'] , $date['seconds'] );
    }

    public function getTimestamp()
    {
        return $this->format( 'U' );
    }
}