empty_page.admin.inc in Empty Page 7

Administrative functionality for Empty Page module.

File

empty_page.admin.inc

<?php

/**
 *
 * @file
 * Administrative functionality for Empty Page module.
 *
 */

/**
 * Container for the callback management interface.
 *
 * @return string $output (rendered html)
 */
function empty_page_admin_overview() {
  $output = theme('fieldset', array(
    'element' => array(
      '#title' => t('Manage'),
      '#children' => theme('empty_page_callbacks_manage_render'),
    ),
  ));
  return $output;
}

/**
 * Theme function to render the callback management admin interface.
 *
 * @return string $output (rendered html)
 */
function theme_empty_page_callbacks_manage_render() {
  $callbacks = empty_page_get_callbacks();
  $edit_access = user_access(EMPTY_PAGE_PERM_ADMIN_CALLBACKS);
  $rows = array();
  foreach ($callbacks as $cid => $callback) {
    $rows[$cid][] = '<strong>' . $callback->path . '</strong>';
    $rows[$cid][] = l(t('View'), $callback->path);
    if ($edit_access) {
      $rows[$cid][] = l(t('Edit'), 'admin/structure/empty-page/' . $callback->cid . '/edit');
      $rows[$cid][] = l(t('Delete'), 'admin/structure/empty-page/' . $callback->cid . '/delete');
    }
  }
  $header = array();
  if ($edit_access) {
    $header = array(
      t('Internal Path'),
      t('View'),
      t('Edit'),
      t('Delete'),
    );
  }
  $admin_add = t('<a href="@url">Add one now!</a>', array(
    '@url' => url('admin/structure/empty-page/add'),
  ));
  if (count($callbacks)) {
    $output = theme('table', array(
      'header' => $header,
      'rows' => $rows,
    ));
  }
  else {
    $output = '<p style="padding:10px 0;margin:0;">' . t('No callbacks exist yet.') . ($edit_access ? ' ' . $admin_add : '') . '</p>';
  }
  return $output;
}

/**
 * The Empty Page callback delete confirmation form.
 *
 * @param array $form_state
 * @param int $cid
 * @return array $form
 */
function empty_page_admin_delete_form($form, &$form_state, $cid) {

  // Get current editor properties.
  $callback = empty_page_get_callback($cid);
  if (!$callback) {
    drupal_goto('admin/structure/empty-page');
  }
  drupal_set_title('Delete callback');
  $form = confirm_form(array(
    'callback' => array(
      '#type' => 'value',
      '#value' => $callback,
    ),
  ), t('Are you sure you want to delete the callback for <em>!path</em>?', array(
    '!path' => $callback->path,
  )), 'admin/structure/empty-page', t('This action cannot be undone.'), t('Delete callback'), t('Cancel'));
  $form_state['#redirect'] = 'admin/structure/empty-page';
  return $form;
}

/**
 * Form submit handler for deleting an Empty Page callback.
 *
 * @param array $form
 * @param array $form_state
 */
function empty_page_admin_delete_form_submit($form, &$form_state) {
  empty_page_delete_callback($form_state['values']['callback']->cid);

  // Clear menu cache.
  empty_page_clear_menu_cache();
  drupal_set_message(t('Callback <em>!path</em> deleted.', array(
    '!path' => $form_state['values']['callback']->path,
  )));
}

/**
 * The Empty Page callback add / edit form.
 *
 * @param array $form_state
 * @param int $cid
 * @return array $form
 */
function empty_page_callbacks_form($form, &$form_state, $cid = NULL) {
  $callback = NULL;

  // If $cid exists, we're editing.
  if (isset($cid)) {
    $callback = empty_page_get_callback($cid);
  }
  if ($callback) {
    $form['empty_page_callback_cid'] = array(
      '#type' => 'hidden',
      '#value' => $callback->cid,
    );
    $form_title = t('Edit callback');
  }
  else {
    $form_title = t('Create a new callback');
  }
  $form['empty_page_basic'] = array(
    '#type' => 'fieldset',
    '#title' => $form_title,
    '#description' => '',
    '#collapsible' => TRUE,
  );
  $form['empty_page_basic']['empty_page_callback_path'] = array(
    '#type' => 'textfield',
    '#title' => t('Internal path'),
    '#description' => '',
    '#required' => 1,
    '#default_value' => $callback ? $callback->path : '',
  );
  $form['empty_page_basic']['empty_page_callback_page_title'] = array(
    '#type' => 'textfield',
    '#title' => t('Page title'),
    '#description' => '',
    '#default_value' => $callback ? $callback->page_title : '',
  );
  $form['empty_page_basic']['buttons']['submit'] = array(
    '#type' => 'submit',
    '#value' => $callback ? t('Save') : t('Add'),
  );
  return $form;
}

/**
 * Form validate handler for adding / editing an Empty Page callback.
 *
 * @param array $form
 * @param array $form_state
 */
function empty_page_callbacks_form_validate($form, &$form_state) {
  if (empty($form_state['values']['empty_page_callback_path'])) {
    form_set_error('empty_page_callback_path', t('You must provide an <em>Internal path</em> for your callback.'));
  }
}

/**
 * Form submit handler for adding / editing an Empty Page callback.
 *
 * @param array $form
 * @param array $form_state
 */
function empty_page_callbacks_form_submit($form, &$form_state) {
  $is_existing_callback = isset($form_state['values']['empty_page_callback_cid']);
  $callback = new stdClass();
  if ($is_existing_callback) {

    // We're editing an existing callback.
    $callback->cid = $form_state['values']['empty_page_callback_cid'];
  }
  else {

    // This is a new editor.
    $callback->created = REQUEST_TIME;
  }
  $data = array();
  $callback->path = $form_state['values']['empty_page_callback_path'];
  $callback->page_title = $form_state['values']['empty_page_callback_page_title'];

  // TODO: Handle saving of custom perms.
  $callback->changed = REQUEST_TIME;
  empty_page_save_callback($callback);
  empty_page_clear_menu_cache();
  drupal_set_message(t('Changes saved.'));
  $redirect = 'admin/structure/empty-page';
  drupal_goto($redirect);
}

Functions

Name	Description
empty_page_admin_delete_form	The Empty Page callback delete confirmation form.
empty_page_admin_delete_form_submit	Form submit handler for deleting an Empty Page callback.
empty_page_admin_overview	Container for the callback management interface.
empty_page_callbacks_form	The Empty Page callback add / edit form.
empty_page_callbacks_form_submit	Form submit handler for adding / editing an Empty Page callback.
empty_page_callbacks_form_validate	Form validate handler for adding / editing an Empty Page callback.
theme_empty_page_callbacks_manage_render	Theme function to render the callback management admin interface.