node.inc

Same filename in this branch
  1. 7.x-1.x plugins/content_types/node/node.inc
Same filename in other branches
  1. 8.x-3.x plugins/access/node.inc
  2. 4.0.x plugins/access/node.inc

Plugin to provide a node context. A node context is a node wrapped in a context object that can be utilized by anything that accepts contexts.

File

plugins/contexts/node.inc

View source
<?php


/**
 * @file
 * Plugin to provide a node context. A node context is a node wrapped in a
 * context object that can be utilized by anything that accepts contexts.
 */

/**
 * Plugins are described by creating a $plugin array which will be used
 * by the system that includes this file.
 */
$plugin = array(
    'title' => t("Node"),
    'description' => t('A node object.'),
    'context' => 'ctools_context_create_node',
    'edit form' => 'ctools_context_node_settings_form',
    'defaults' => array(
        'nid' => '',
    ),
    'keyword' => 'node',
    'context name' => 'node',
    'convert list' => 'ctools_context_node_convert_list',
    'convert' => 'ctools_context_node_convert',
    'placeholder form' => array(
        '#type' => 'textfield',
        '#description' => t('Enter the node ID of a node for this context.'),
    ),
    // This context is deprecated and should not be usable in the UI.
'no ui' => TRUE,
    'no required context ui' => TRUE,
    'superceded by' => 'entity:node',
);

/**
 * It's important to remember that $conf is optional here, because contexts
 * are not always created from the UI.
 */
function ctools_context_create_node($empty, $data = NULL, $conf = FALSE) {
    $context = new ctools_context('node');
    $context->plugin = 'node';
    if ($empty) {
        return $context;
    }
    if ($conf) {
        $nid = is_array($data) && isset($data['nid']) ? $data['nid'] : (is_object($data) ? $data->nid : 0);
        if (module_exists('translation')) {
            if ($translation = module_invoke('translation', 'node_nid', $nid, $GLOBALS['language']->language)) {
                $nid = $translation;
                $reload = TRUE;
            }
        }
        if (is_array($data) || !empty($reload)) {
            $data = node_load($nid);
        }
    }
    if (!empty($data)) {
        $context->data = $data;
        $context->title = $data->title;
        $context->argument = $data->nid;
        $context->restrictions['type'] = array(
            $data->type,
        );
        return $context;
    }
}
function ctools_context_node_settings_form($form, &$form_state) {
    $conf =& $form_state['conf'];
    $form['node'] = array(
        '#title' => t('Enter the title or NID of a node'),
        '#type' => 'textfield',
        '#maxlength' => 512,
        '#autocomplete_path' => 'ctools/autocomplete/node',
        '#weight' => -10,
    );
    if (!empty($conf['nid'])) {
        $info = db_query('SELECT * FROM {node} WHERE nid = :nid', array(
            ':nid' => $conf['nid'],
        ))->fetchObject();
        if ($info) {
            $link = l(t("'%title' [node id %nid]", array(
                '%title' => $info->title,
                '%nid' => $info->nid,
            )), "node/{$info->nid}", array(
                'attributes' => array(
                    'target' => '_blank',
                    'title' => t('Open in new window'),
                ),
                'html' => TRUE,
            ));
            $form['node']['#description'] = t('Currently set to !link', array(
                '!link' => $link,
            ));
        }
    }
    $form['nid'] = array(
        '#type' => 'value',
        '#value' => $conf['nid'],
    );
    $form['set_identifier'] = array(
        '#type' => 'checkbox',
        '#default_value' => FALSE,
        '#title' => t('Reset identifier to node title'),
        '#description' => t('If checked, the identifier will be reset to the node title of the selected node.'),
    );
    return $form;
}

/**
 * Validate a node.
 */
function ctools_context_node_settings_form_validate($form, &$form_state) {
    // Validate the autocomplete.
    if (empty($form_state['values']['nid']) && empty($form_state['values']['node'])) {
        form_error($form['node'], t('You must select a node.'));
        return;
    }
    if (empty($form_state['values']['node'])) {
        return;
    }
    $nid = $form_state['values']['node'];
    $preg_matches = array();
    $match = preg_match('/\\[id: (\\d+)\\]/', $nid, $preg_matches);
    if (!$match) {
        $match = preg_match('/^id: (\\d+)/', $nid, $preg_matches);
    }
    if ($match) {
        $nid = $preg_matches[1];
    }
    if (is_numeric($nid)) {
        $node = db_query('SELECT nid, status FROM {node} WHERE nid = :nid', array(
            ':nid' => $nid,
        ))->fetchObject();
    }
    else {
        $node = db_query('SELECT nid, status FROM {node} WHERE LOWER(title) = LOWER(:title)', array(
            ':title' => $nid,
        ))->fetchObject();
    }
    // Do not allow unpublished nodes to be selected by unprivileged users.
    if (!$node || empty($node->status) && !user_access('administer nodes')) {
        form_error($form['node'], t('Invalid node selected.'));
    }
    else {
        form_set_value($form['nid'], $node->nid, $form_state);
    }
}
function ctools_context_node_settings_form_submit($form, &$form_state) {
    if ($form_state['values']['set_identifier']) {
        $node = node_load($form_state['values']['nid']);
        $form_state['values']['identifier'] = $node->title;
    }
    // This will either be the value set previously or a value set by the
    // validator.
    $form_state['conf']['nid'] = $form_state['values']['nid'];
}

/**
 * Provide a list of ways that this context can be converted to a string.
 */
function ctools_context_node_convert_list() {
    $tokens = token_info();
    foreach ($tokens['tokens']['node'] as $id => $info) {
        if (!isset($list[$id])) {
            $list[$id] = $info['name'];
        }
    }
    return $list;
}

/**
 * Convert a context into a string.
 */
function ctools_context_node_convert($context, $type) {
    $tokens = token_info();
    if (isset($tokens['tokens']['node'][$type])) {
        $values = token_generate('node', array(
            $type => $type,
        ), array(
            'node' => $context->data,
        ));
        if (isset($values[$type])) {
            return $values[$type];
        }
    }
}

Functions

Title Deprecated Summary
ctools_context_create_node It's important to remember that $conf is optional here, because contexts are not always created from the UI.
ctools_context_node_convert Convert a context into a string.
ctools_context_node_convert_list Provide a list of ways that this context can be converted to a string.
ctools_context_node_settings_form
ctools_context_node_settings_form_submit
ctools_context_node_settings_form_validate Validate a node.