commerce_invoice_ui.invoices.inc in Commerce Invoice 7

Page callbacks and form builder functions for administering invoices.

File

includes/commerce_invoice_ui.invoices.inc

<?php

/**
 * @file
 * Page callbacks and form builder functions for administering invoices.
 */

/**
 * Form callback: edit the global invoice settings.
 */
function commerce_invoice_settings_form($form, &$form_state) {
  $form['commerce_invoice_number_method'] = array(
    '#type' => 'radios',
    '#title' => t('Invoice number creation method'),
    '#description' => t('This determines the way invoice numbers are generated.'),
    '#default_value' => variable_get('commerce_invoice_number_method', COMMERCE_INVOICE_METHOD_YEAR),
    '#options' => array(
      COMMERCE_INVOICE_METHOD_INFINITE => t('Infinite (one single number, that is never reset, and incremented at each invoice generation)'),
      COMMERCE_INVOICE_METHOD_YEAR => t('Reset every year, with an id incremented at each invoice generation (@invoice_number)', array(
        '@invoice_number' => date('Y') . '-[invoice_id]',
      )),
      COMMERCE_INVOICE_METHOD_MONTH => t('Reset every month, with an id incremented at each invoice generation (@invoice_number)', array(
        '@invoice_number' => date('Y-m') . '-[invoice_id]',
      )),
      COMMERCE_INVOICE_METHOD_CALLBACK => t('Invoice number generation is controlled by a callback function that is being passed the invoice object'),
    ),
  );
  $callbacks = module_invoke_all('commerce_invoice_number_callbacks');
  if ($callbacks) {
    $form['commerce_invoice_number_callback'] = array(
      '#type' => 'select',
      '#title' => t('Invoice number creation callback'),
      '#description' => t('This selects the callback function for the callback method.'),
      '#default_value' => variable_get('commerce_invoice_number_callback', ''),
      '#options' => $callbacks,
      '#element_validate' => array(
        'commerce_invoice_ui_validate_invoice_number_callback',
      ),
      '#states' => array(
        'visible' => array(
          ':input[name="commerce_invoice_number_method"]' => array(
            'value' => COMMERCE_INVOICE_METHOD_CALLBACK,
          ),
        ),
      ),
    );
  }
  return system_settings_form($form);
}
function commerce_invoice_ui_validate_invoice_number_callback($element, &$form_state, $form) {
  if ($form_state['values']['commerce_invoice_number_method'] == COMMERCE_INVOICE_METHOD_CALLBACK) {
    if (empty($form_state['values']['commerce_invoice_number_callback'])) {
      form_set_error('commerce_invoice_number_callback', t('Please specify a callback function.'));
    }
    elseif (!function_exists($form_state['values']['commerce_invoice_number_callback'])) {
      form_set_error('commerce_invoice_number_callback', t('"@callback" is not a valid callback function.', array(
        '@callback' => $form_state['values']['commerce_invoice_number_callback'],
      )));
    }
  }
}

Functions

Name	Description
commerce_invoice_settings_form	Form callback: edit the global invoice settings.
commerce_invoice_ui_validate_invoice_number_callback