Newer
Older
<?php
/**
* Renderer class for all In-Place Editor (IPE) behavior.
*/
class panels_renderer_ipe extends panels_renderer_editor {
// The IPE operates in normal render mode, not admin mode.
var $admin = FALSE;
// Whether or not the user has access.
var $access = NULL;
function invoke_panels_ipe_access() {
if (user_access('bypass access in place editing')) {
return TRUE;
}
// Modules can return TRUE, FALSE or NULL, for allowed, disallowed,
// or don't care - respectively. On the first FALSE, we deny access,
// otherwise allow.
foreach (module_invoke_all('panels_ipe_access', $this->display) as $result) {
if ($result === FALSE) {
return FALSE;
}
}
return TRUE;
}
function access() {
if (is_null($this->access)) {
$this->access = $this->invoke_panels_ipe_access();
}
return $this->access;
}
function render() {
$output = parent::render();
if ($this->access()) {
return "<div id='panels-ipe-display-{$this->clean_key}' class='panels-ipe-display-container'>$output</div>";
}
return $output;
}
function add_meta() {
if (!$this->access()) {
return parent::add_meta();
}
ctools_include('display-edit', 'panels');
ctools_include('content');
if (empty($this->display->cache_key)) {
$this->cache = panels_edit_cache_get_default($this->display);
}
// @todo we may need an else to load the cache, but I am not sure we
// actually need to load it if we already have our cache key, and doing
// so is a waste of resources.
ctools_include('cleanstring');
$this->clean_key = ctools_cleanstring($this->display->cache_key);
$button = array(
'#type' => 'link',
'#title' => t('Customize this page'),
'#href' => $this->get_url('save_form'),
'#options' => array('query' => drupal_get_destination()),
'#id' => 'panels-ipe-customize-page',
'#attributes' => array(
'class' => array('panels-ipe-startedit', 'panels-ipe-pseudobutton'),
),
'#ajax' => array(
'progress' => 'throbber',
'ipe_cache_key' => $this->clean_key,
),
Earl Miles
committed
'#prefix' => '<div class="panels-ipe-pseudobutton-container">',
'#suffix' => '</div>',
Kris Vanderwater
committed
panels_ipe_toolbar_add_button($this->display->cache_key, 'panels-ipe-startedit', $button);
// @todo this actually should be an IPE setting instead.
if (user_access('change layouts in place editing')) {
$button = array(
'#type' => 'link',
'#title' => t('Change layout'),
'#href' => $this->get_url('change_layout'),
'#options' => array('query' => drupal_get_destination()),
'#attributes' => array(
'class' => array('panels-ipe-change-layout', 'panels-ipe-pseudobutton', 'ctools-modal-layout'),
),
'#ajax' => array(
'progress' => 'throbber',
'ipe_cache_key' => $this->clean_key,
),
Earl Miles
committed
'#prefix' => '<div class="panels-ipe-pseudobutton-container">',
'#suffix' => '</div>',
Kris Vanderwater
committed
panels_ipe_toolbar_add_button($this->display->cache_key, 'panels-ipe-change-layout', $button);
Earl Miles
committed
}
ctools_include('ajax');
ctools_include('modal');
ctools_modal_add_js();
ctools_add_css('panels_dnd', 'panels');
ctools_add_css('panels_admin', 'panels');
ctools_add_js('panels-base', 'panels');
ctools_add_js('panels_ipe', 'panels_ipe');
ctools_add_css('panels_ipe', 'panels_ipe');
drupal_add_js(array('PanelsIPECacheKeys' => array($this->clean_key)), 'setting');
drupal_add_library('system', 'ui.draggable');
drupal_add_library('system', 'ui.droppable');
drupal_add_library('system', 'ui.sortable');
parent::add_meta();
}
/**
* Override & call the parent, then pass output through to the dnd wrapper
* theme function.
*
* @param $pane
*/
Earl Miles
committed
function render_pane(&$pane) {
$output = parent::render_pane($pane);
if (empty($output)) {
return;
}
if (!$this->access()) {
return $output;
}
// If there are region locks, add them.
if (!empty($pane->locks['type']) && $pane->locks['type'] == 'regions') {
static $key = NULL;
$javascript = &drupal_static('drupal_add_js', array());
// drupal_add_js breaks as we add these, but we can't just lump them
// together because panes can be rendered independently. So game the system:
if (empty($key)) {
$settings['Panels']['RegionLock'][$pane->pid] = $pane->locks['regions'];
drupal_add_js($settings, 'setting');
// These are just added via [] so we have to grab the last one
// and reference it.
$keys = array_keys($javascript['settings']['data']);
$key = end($keys);
}
else {
$javascript['settings']['data'][$key]['Panels']['RegionLock'][$pane->pid] = $pane->locks['regions'];
}
}
if (empty($pane->IPE_empty)) {
// Add an inner layer wrapper to the pane content before placing it into
$output = "<div class=\"panels-ipe-portlet-content\">$output</div>";
}
else {
$output = "<div class=\"panels-ipe-portlet-content panels-ipe-empty-pane\">$output</div>";
}
// Hand it off to the plugin/theme for placing draggers/buttons.
$output = theme('panels_ipe_pane_wrapper', array('output' => $output, 'pane' => $pane, 'display' => $this->display, 'renderer' => $this));
if (!empty($pane->locks['type']) && $pane->locks['type'] == 'immovable') {
return "<div id=\"panels-ipe-paneid-{$pane->pid}\" class=\"panels-ipe-nodrag panels-ipe-portlet-wrapper panels-ipe-portlet-marker\">" . $output . "</div>";
}
return "<div id=\"panels-ipe-paneid-{$pane->pid}\" class=\"panels-ipe-portlet-wrapper panels-ipe-portlet-marker\">" . $output . "</div>";
}
Earl Miles
committed
function prepare_panes($panes) {
if (!$this->access()) {
return parent::prepare_panes($panes);
}
Earl Miles
committed
// Set to admin mode just for this to ensure all panes are represented.
$this->admin = TRUE;
$panes = parent::prepare_panes($panes);
$this->admin = FALSE;
}
function render_pane_content(&$pane) {
if (!$this->access()) {
return parent::render_pane_content($pane);
}
Earl Miles
committed
if (!empty($pane->shown) && panels_pane_access($pane, $this->display)) {
$content = parent::render_pane_content($pane);
}
// Ensure that empty panes have some content.
if (empty($content) || empty($content->content)) {
Earl Miles
committed
if (empty($content)) {
$content = new stdClass();
}
// Get the administrative title.
$content_type = ctools_get_content_type($pane->type);
$title = ctools_content_admin_title($content_type, $pane->subtype, $pane->configuration, $this->display->context);
Earl Miles
committed
$content->content = t('Placeholder for empty or inaccessible "@title"', array('@title' => html_entity_decode($title, ENT_QUOTES)));
// Add these to prevent notices.
$content->type = 'panels_ipe';
$content->subtype = 'panels_ipe';
$pane->IPE_empty = TRUE;
}
return $content;
}
/**
* Add an 'empty' pane placeholder above all the normal panes.
*
* @param $region_id
* @param $panes
*/
function render_region($region_id, $panes) {
if (!$this->access()) {
return parent::render_region($region_id, $panes);
}
// Generate this region's 'empty' placeholder pane from the IPE plugin.
$empty_ph = theme('panels_ipe_placeholder_pane', array('region_id' => $region_id, 'region_title' => $this->plugins['layout']['regions'][$region_id]));
// Wrap the placeholder in some guaranteed markup.
$control = '<div class="panels-ipe-placeholder panels-ipe-on panels-ipe-portlet-marker panels-ipe-portlet-static">' . $empty_ph . theme('panels_ipe_add_pane_button', array('region_id' => $region_id, 'display' => $this->display, 'renderer' => $this)) . "</div>";
$output = parent::render_region($region_id, $panes);
$output = theme('panels_ipe_region_wrapper', array('output' => $output, 'region_id' => $region_id, 'display' => $this->display, 'controls' => $control, 'renderer' => $this));
$classes = 'panels-ipe-region';
return "<div id='panels-ipe-regionid-$region_id' class='panels-ipe-region'>$output</div>";
}
/**
* This is a generic lock test.
function ipe_test_lock($url, $break) {
if (!empty($this->cache->locked)) {
if ($break != 'break') {
$account = user_load($this->cache->locked->uid);
$name = format_username($account);
$lock_age = format_interval(time() - $this->cache->locked->updated);
$message = t("This panel is being edited by user !user, and is therefore locked from editing by others. This lock is !age old.\n\nClick OK to break this lock and discard any changes made by !user.", array('!user' => $name, '!age' => $lock_age));
$this->commands[] = array(
'command' => 'unlockIPE',
'message' => $message,
'break_path' => url($this->get_url($url, 'break')),
'key' => $this->clean_key,
}
// Break the lock.
panels_edit_cache_break_lock($this->cache);
}
function get_panels_storage_op_for_ajax($method) {
switch ($method) {
case 'ajax_unlock_ipe':
case 'ajax_save_form':
return 'update';
case 'ajax_change_layout':
case 'ajax_set_layout':
return 'change layout';
}
return parent::get_panels_storage_op_for_ajax($method);
}
/**
* AJAX callback to unlock the IPE.
*
* This is called whenever something server side determines that editing
* has stopped and cleans up no longer needed locks.
*
* It has no visible return value as this is considered a background task
* and the client side has already given all indications that things are
* now in a 'normal' state.
*/
function ajax_unlock_ipe() {
panels_edit_cache_clear($this->cache);
$this->commands[] = array();
}
/**
* AJAX entry point to create the controller form for an IPE.
*/
function ajax_save_form($break = NULL) {
if ($this->ipe_test_lock('save-form', $break)) {
return;
}
// Reset the $_POST['ajax_html_ids'] values to preserve
// proper IDs on form elements when they are rebuilt
$_POST['ajax_html_ids'] = array();
$form_state = array(
Earl Miles
committed
'renderer' => $this,
'display' => &$this->display,
'content_types' => $this->cache->content_types,
'rerender' => FALSE,
'no_redirect' => TRUE,
// Panels needs this to make sure that the layout gets callbacks.
'layout' => $this->plugins['layout'],
);
$output = drupal_build_form('panels_ipe_edit_control_form', $form_state);
if (empty($form_state['executed'])) {
// At this point, we want to save the cache to ensure that we have a lock.
$this->cache->ipe_locked = TRUE;
panels_edit_cache_set($this->cache);
$this->commands[] = array(
'command' => 'initIPE',
'key' => $this->clean_key,
'data' => drupal_render($output),
Earl Miles
committed
'lockPath' => url($this->get_url('unlock_ipe')),
);
return;
}
// Check to see if we have a lock that was broken. If so we need to
// inform the user and abort.
if (empty($this->cache->ipe_locked)) {
$this->commands[] = ajax_command_alert(t('A lock you had has been externally broken, and all your changes have been reverted.'));
$this->commands[] = array(
'command' => 'cancelIPE',
'key' => $this->clean_key,
);
return;
}
// Otherwise it was submitted.
if (!empty($form_state['clicked_button']['#save-display'])) {
// Saved. Save the cache.
panels_edit_cache_save($this->cache);
Earl Miles
committed
// A rerender should fix IDs on added panes as well as ensure style changes are
// rendered.
$this->meta_location = 'inline';
$this->commands[] = ajax_command_replace("#panels-ipe-display-{$this->clean_key}", panels_render_display($this->display, $this));
David Snopek
committed
$buttons = &drupal_static('panels_ipe_toolbar_buttons', array());
$output = theme('panels_ipe_toolbar', array('buttons' => $buttons));
$this->commands[] = ajax_command_replace('#panels-ipe-control-container', $output);
Alexey Beloglazov
committed
$storage_id = $this->cache->display->storage_id;
cache_clear_all('panels_mini_load:' . $storage_id, 'cache_panels', TRUE);
}
else {
// Cancelled. Clear the cache.
panels_edit_cache_clear($this->cache);
}
$this->commands[] = array(
'command' => 'endIPE',
'key' => $this->clean_key,
);
}
/**
* AJAX entry point to create the controller form for an IPE.
*/
function ajax_change_layout($break = NULL) {
if ($this->ipe_test_lock('change_layout', $break)) {
return;
}
// At this point, we want to save the cache to ensure that we have a lock.
$this->cache->ipe_locked = TRUE;
panels_edit_cache_set($this->cache);
ctools_include('plugins', 'panels');
ctools_include('common', 'panels');
// @todo figure out a solution for this, it's critical
if (isset($this->display->allowed_layouts)) {
$layouts = $this->display->allowed_layouts;
}
else {
$layouts = panels_common_get_allowed_layouts('panels_page');
}
$layouts = array_filter($layouts, '_panels_builder_filter');
Michael Mol
committed
// Let other modules filter the layouts.
drupal_alter('panels_layouts_available', $layouts);
Earl Miles
committed
$current_layout = $this->plugins['layout']['name'];
$output = panels_common_print_layout_links($layouts, $this->get_url('set_layout'), array('attributes' => array('class' => array('use-ajax'))), $current_layout);
$this->commands[] = ctools_modal_command_display(t('Change layout'), $output);
$this->commands[] = array(
'command' => 'IPEsetLockState',
'key' => $this->clean_key,
Earl Miles
committed
'lockPath' => url($this->get_url('unlock_ipe')),
);
}
function ajax_set_layout($layout) {
ctools_include('context');
ctools_include('display-layout', 'panels');
$form_state = array(
'layout' => $layout,
'display' => $this->display,
'finish' => t('Save'),
'no_redirect' => TRUE,
);
Matthew Cheney
committed
// Reset the $_POST['ajax_html_ids'] values to preserve
// proper IDs on form elements when they are rebuilt
Matthew Cheney
committed
$_POST['ajax_html_ids'] = array();
$output = drupal_build_form('panels_change_layout', $form_state);
$output = drupal_render($output);
if (!empty($form_state['executed'])) {
if (isset($form_state['back'])) {
return $this->ajax_change_layout();
}
if (!empty($form_state['clicked_button']['#save-display'])) {
// Saved. Save the cache.
panels_edit_cache_save($this->cache);
// Since the layout changed, we have to update these things in the
// renderer in order to get the right settings.
$layout = panels_get_layout($this->display->layout);
$this->plugins['layout'] = $layout;
if (!isset($layout['regions'])) {
$this->plugins['layout']['regions'] = panels_get_regions($layout, $this->display);
}
$this->meta_location = 'inline';
$this->commands[] = ajax_command_replace("#panels-ipe-display-{$this->clean_key}", panels_render_display($this->display, $this));
$this->commands[] = ctools_modal_command_dismiss();
return;
}
}
$this->commands[] = ctools_modal_command_display(t('Change layout'), $output);
}
/**
* Create a command array to redraw a pane.
*/
function command_update_pane($pid) {
if (is_object($pid)) {
$pane = $pid;
}
else {
$pane = $this->display->content[$pid];
}
$this->commands[] = ajax_command_replace("#panels-ipe-paneid-$pane->pid", $this->render_pane($pane));
$this->commands[] = ajax_command_changed("#panels-ipe-display-{$this->clean_key}");
}
/**
* Create a command array to add a new pane.
*/
function command_add_pane($pid) {
if (is_object($pid)) {
$pane = $pid;
}
else {
$pane = $this->display->content[$pid];
}
$this->commands[] = array(
'command' => 'insertNewPane',
'regionId' => $pane->panel,
'renderedPane' => $this->render_pane($pane),
);
$this->commands[] = ajax_command_changed("#panels-ipe-display-{$this->clean_key}");
Earl Miles
committed
$this->commands[] = array(
'command' => 'addNewPane',
'key' => $this->clean_key,
);
}
/**
* FAPI callback to create the Save/Cancel form for the IPE.
*/
function panels_ipe_edit_control_form($form, &$form_state) {
$display = &$form_state['display'];
// @todo -- this should be unnecessary as we ensure cache_key is set in add_meta()
// $display->cache_key = isset($display->cache_key) ? $display->cache_key : $display->did;
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
// Annoyingly, theme doesn't have access to form_state so we have to do this.
$form['#display'] = $display;
$layout = panels_get_layout($display->layout);
$layout_panels = panels_get_regions($layout, $display);
$form['panel'] = array('#tree' => TRUE);
$form['panel']['pane'] = array('#tree' => TRUE);
foreach ($layout_panels as $panel_id => $title) {
// Make sure we at least have an empty array for all possible locations.
if (!isset($display->panels[$panel_id])) {
$display->panels[$panel_id] = array();
}
$form['panel']['pane'][$panel_id] = array(
// Use 'hidden' instead of 'value' so the js can access it.
'#type' => 'hidden',
'#default_value' => implode(',', (array) $display->panels[$panel_id]),
);
}
$form['buttons']['submit'] = array(
'#type' => 'submit',
'#value' => t('Save'),
'#id' => 'panels-ipe-save',
'#attributes' => array('class' => array('panels-ipe-save')),
'#submit' => array('panels_edit_display_form_submit'),
'#save-display' => TRUE,
);
$form['buttons']['cancel'] = array(
'#type' => 'submit',
'#id' => 'panels-ipe-cancel',
'#attributes' => array('class' => array('panels-ipe-cancel')),