array( 'title' => t('Administer panel nodes'), 'description' => t('Full administrative access to panel nodes including create, update and delete all'), ), ); } /** * Implementation of hook_ctools_plugin_directory(). */ function panels_node_ctools_plugin_directory($module, $plugin) { if ($module == 'panels' && $plugin == 'panels_storage') { return 'plugins/' . $plugin; } } /** * Implementation of hook_menu(). */ function panels_node_menu() { // Safety: go away if CTools is not at an appropriate version. if (!defined('PANELS_REQUIRED_CTOOLS_API') || !module_invoke('ctools', 'api_version', PANELS_REQUIRED_CTOOLS_API)) { return array(); } $items['admin/structure/panels/settings/panel-node'] = array( 'title' => 'Panel nodes', 'description' => 'Configure which content is available to add to panel node displays.', 'access arguments' => array('administer panel-nodes'), 'page callback' => 'panels_node_settings', 'type' => MENU_LOCAL_TASK, ); // Avoid some repetition on these: $base = array( 'access callback' => 'panels_node_edit_node', 'access arguments' => array(1), 'page arguments' => array(1), 'type' => MENU_LOCAL_TASK, ); $items['node/%node/panel_layout'] = array( 'title' => 'Panel layout', 'page callback' => 'panels_node_edit_layout', 'weight' => 2, ) + $base; $items['node/%node/panel_content'] = array( 'title' => 'Panel content', 'page callback' => 'panels_node_edit_content', 'weight' => 3, ) + $base; $items['node/add/panel/choose-layout'] = array( 'title' => 'Choose layout', 'access callback' => 'panels_add_panel_access_callback', 'page callback' => 'panels_node_add', 'type' => MENU_CALLBACK, ); return $items; } /** * Access callback to determine if a user has edit access */ function panels_node_edit_node($node) { if (!isset($node->panels_node)) { return FALSE; } return node_access('update', $node); } /** * Access callback to determine if user has access to add panel nodes. */ function panels_add_panel_access_callback() { return user_access('create panel content') || user_access('administer panel-nodes'); } /** * Override of node add page to force layout selection prior * to actually editing a node. */ function panels_node_add() { $output = ''; ctools_include('plugins', 'panels'); ctools_include('common', 'panels'); $layouts = panels_common_get_allowed_layouts('panels_node'); return panels_common_print_layout_links($layouts, 'node/add/panel', array('query' => drupal_get_query_parameters())); } // --------------------------------------------------------------------------- // Node hooks /** * Implementation of hook_node_info(). */ function panels_node_node_info() { // Safety: go away if CTools is not at an appropriate version. if (!defined('PANELS_REQUIRED_CTOOLS_API') || !module_invoke('ctools', 'api_version', PANELS_REQUIRED_CTOOLS_API)) { return array(); } return array( 'panel' => array( 'name' => t('Panel'), // We use panels_node_hook so that panels_node private // callbacks do not get confused with panels versions of // nodeapi callbacks. 'base' => 'panels_node_hook', 'body_label' => t('Teaser'), 'description' => t("A panel layout broken up into rows and columns."), ), ); } /** * Implementation of hook_access(). */ function panels_node_node_access($node, $op, $account) { if ($op == 'create' && $node != 'panel') { return NODE_ACCESS_IGNORE; } if (is_object($node) && $node->type != 'panel') { return NODE_ACCESS_IGNORE; } if (user_access('administer panel-nodes', $account)) { return NODE_ACCESS_ALLOW; } } /** * Implementation of hook_form(). */ function panels_node_hook_form(&$node, &$form_state) { ctools_include('plugins', 'panels'); $form['panels_node']['#tree'] = TRUE; if (empty($node->nid) && arg(0) == 'node' && arg(1) == 'add') { // Grab our selected layout from the $node, If it doesn't exist, try arg(3) // and if that doesn't work present them with a list to pick from. $panel_layout = isset($node->panel_layout) ? $node->panel_layout : arg(3); if (empty($panel_layout)) { drupal_goto('node/add/panel/choose-layout', array('query' => drupal_get_query_parameters())); } $layout = panels_get_layout($panel_layout); if (empty($layout)) { return MENU_NOT_FOUND; } $form['panels_node']['layout'] = array( '#type' => 'value', '#value' => $panel_layout, ); } $type = node_type_get_type($node); $form['title'] = array( '#type' => 'textfield', '#title' => check_plain($type->title_label), '#required' => TRUE, '#default_value' => $node->title, ); $css_id = ''; if (!empty($node->panels_node['css_id'])) { $css_id = $node->panels_node['css_id']; } $form['panels_node']['css_id'] = array( '#type' => 'textfield', '#title' => t('CSS ID'), '#size' => 30, '#description' => t('An ID that can be used by CSS to style the panel.'), '#default_value' => $css_id, ); // Support for different rendering pipelines // Mostly borrowed from panel_context.inc $pipelines = panels_get_renderer_pipelines(); $options = array(); foreach ($pipelines as $name => $pipeline) { $options[$name] = check_plain($pipeline->admin_title) . '
' . check_plain($pipeline->admin_description) . '
'; } $form['panels_node']['pipeline'] = array( '#type' => 'radios', '#options' => $options, '#title' => t('Renderer'), '#default_value' => isset($node->panels_node['pipeline']) ? $node->panels_node['pipeline'] : variable_get('panels_renderer_default', 'standard'), ); return $form; } /** * Implementation of hook_validate(). */ function panels_node_hook_validate($node, $form, &$form_state) { if (!$node->nid && empty($node->panels_node['layout'])) { form_error($form['panels_node']['layout'], t('Please select a layout.')); } } /** * Implementation of hook_load(). * * Panels does not use revisions for nodes because that would open us up * to have completely separate displays, and we'd have to copy them, * and that's going to be a LOT of data. */ function panels_node_hook_load($nodes) { // We shortcut this because only in some really drastic corruption circumstance will this // not work. $result = db_query("SELECT * FROM {panels_node} WHERE nid IN (:nids)", array(':nids' => array_keys($nodes))); foreach ($result as $record) { $nodes[$record->nid]->panels_node = (array) $record; } } /** * Implementation of hook_insert(). */ function panels_node_hook_insert(&$node) { // Create a new display and record that. $display = panels_new_display(); $display->layout = $node->panels_node['layout']; $display->storage_type = 'panels_node'; $display->storage_id = $node->nid; // Special handling for nodes being imported from an export.module data dump. if (!empty($node->export_display)) { // This works by overriding the $display set above eval($node->export_display); unset($node->export_display); } panels_save_display($display); $node->panels_node['did'] = $display->did; db_insert('panels_node') ->fields(array( 'nid' => $node->nid, 'did' => $display->did, 'css_id' => $node->panels_node['css_id'], 'pipeline' => $node->panels_node['pipeline'], )) ->execute(); } /** * Implementation of hook_delete(). */ function panels_node_hook_delete(&$node) { db_delete('panels_node')->condition('nid', $node->nid)->execute(); if (!empty($node->panels_node['did'])) { panels_delete_display($node->panels_node['did']); } } /** * Implementation of hook_update(). */ function panels_node_hook_update($node) { db_update('panels_node') ->condition('nid', $node->nid) ->fields(array( 'css_id' => $node->panels_node['css_id'], 'pipeline' => $node->panels_node['pipeline'], )) ->execute(); } /** * Implementation of hook_view(). */ function panels_node_hook_view($node, $view_mode) { static $rendering = array(); // Prevent loops if someone foolishly puts the node inside itself: if (!empty($rendering[$node->nid])) { return $node; } $rendering[$node->nid] = TRUE; ctools_include('plugins', 'panels'); if ($view_mode == 'teaser') { // Because our teasier is never the same as our content, *always* provide // the read more flag. $node->readmore = TRUE; } else { if (!empty($node->panels_node['did'])) { $display = panels_load_display($node->panels_node['did']); $display->css_id = $node->panels_node['css_id']; // TODO: Find a way to make sure this can't node_view. $display->context = panels_node_get_context($node); $display->cache_key = 'panels_node:' . $node->nid; $renderer = panels_get_renderer($node->panels_node['pipeline'], $display); $node->content['body'] = array( '#markup' => panels_render_display($display, $renderer), '#weight' => 0, ); } } unset($rendering[$node->nid]); return $node; } // --------------------------------------------------------------------------- // Administrative pages /** * Settings for panel nodes. */ function panels_node_settings() { ctools_include('common', 'panels'); return drupal_get_form('panels_common_settings', 'panels_node'); } // --------------------------------------------------------------------------- // Meat of the Panels API; almost completely passing through to panels.module /** * Pass through to the panels layout editor. */ function panels_node_edit_layout($node) { // ctools_include('plugins', 'panels'); ctools_include('context'); $display = panels_load_display($node->panels_node['did']); $display->context = panels_node_get_context($node); return panels_edit_layout($display, t('Save'), "node/$node->nid/panel_layout", 'panels_node'); } /** * Pass through to the panels content editor. */ function panels_node_edit_content($node) { ctools_include('context'); $display = panels_load_display($node->panels_node['did']); $display->context = panels_node_get_context($node); ctools_include('common', 'panels'); $content_types = panels_common_get_allowed_types('panels_node', $display->context); return panels_edit($display, "node/$node->nid/panel_content", $content_types); } /** * Build the context to use for a panel node. */ function panels_node_get_context(&$node) { ctools_include('context'); $context = ctools_context_create('node', $node); $context->identifier = t('This node'); $context->keyword = 'node'; return array('panel-node' => $context); } /** * Implementation of hook_export_node_alter() * * Integrate with export.module for saving panel_nodes into code. */ function panels_node_export_node_alter(&$node, $original_node, $method) { if ($method == 'export') { $node_export_omitted = variable_get('node_export_omitted', array()); if (variable_get('node_export_method', '') != 'save-edit' && (array_key_exists('panel', $node_export_omitted) && !$node_export_omitted['panel'])) { drupal_set_message(t("NOTE: in order to import panel_nodes you must first set the export.module settings to \"Save as a new node then edit\", otherwise it won't work.")); } $display = panels_load_display($node->panels_node['did']); $export = panels_export_display($display); $node->export_display = $export; } } /** * Implementation of hook_panels_dashboard_blocks(). * * Adds panel nodes information to the Panels dashboard. */ function panels_node_panels_dashboard_blocks(&$vars) { $vars['links']['panels_node'] = array( 'title' => l(t('Panel node'), 'node/add/panel'), 'description' => t('Panel nodes are node content and appear in your searches, but are more limited than panel pages.'), 'weight' => -1, ); } /** * Implements hook_panels_ipe_access(). */ function panels_node_panels_ipe_access($display) { // We only care about Panels displays from panels_node. if (isset($display->context['panel-node'])) { // Only allow access to use the IPE if the user has 'update' access to // the underlying node. $node = $display->context['panel-node']->data; return node_access('update', $node); } } // --------------------------------------------------------------------------- // Callbacks for panel caching. /** * Get display edit cache for a panel node being edited. * * The key is the second half of the key in this form: * panels_node:NID; */ function panels_node_panels_cache_get($nid) { ctools_include('object-cache'); $cache = ctools_object_cache_get('panels_node_display_cache', $nid); if (empty($cache)) { $cache = new stdClass(); $node = node_load($nid); if (empty($node)) { return; } ctools_include('common', 'panels'); $cache->display = panels_load_display($node->panels_node['did']); $cache->display->css_id = $node->panels_node['css_id']; $cache->display->context = panels_node_get_context($node); $cache->display->cache_key = 'panels_node:' . $node->nid; $cache->content_types = panels_common_get_allowed_types('panels_node', $cache->display->context); $cache->allwed_layouts = panels_common_get_allowed_layouts('panels_node'); } return $cache; } /** * Store a display edit in progress in the panels cache. */ function panels_node_panels_cache_set($nid, $cache) { ctools_include('object-cache'); ctools_object_cache_set('panels_node_display_cache', $nid, $cache); } /** * Clear all changes made to a display using the panels cache. */ function panels_node_panels_cache_clear($nid, $cache) { ctools_include('object-cache'); ctools_object_cache_clear('panels_node_display_cache', $nid); } /** * React to a cache save and save the display and clear cache. */ function panels_node_panels_cache_save($nid, $cache) { panels_save_display($cache->display); ctools_include('object-cache'); ctools_object_cache_clear('panels_node_display_cache', $nid); }