node.pages.inc 12.6 KB
Newer Older
1 2 3 4
<?php

/**
 * @file
5 6 7 8 9
 * Callbacks for adding, editing, and deleting content and managing revisions.
 *
 * Also includes validation, submission and other helper functions.
 *
 * @see node_menu()
10 11
 */

12
use Drupal\node\Node;
13 14

/**
15 16
 * Page callback: Presents the node editing form.
 *
17 18 19 20 21 22
 * @param object $node
 *   A node object.
 *
 * @return array
 *   A form array as expected by drupal_render().
 *
23
 * @see node_menu()
24
 */
25
function node_page_edit($node) {
26
  drupal_set_title(t('<em>Edit @type</em> @title', array('@type' => node_get_type_label($node), '@title' => $node->label())), PASS_THROUGH);
27
  return entity_get_form($node);
28 29
}

30
/**
31 32 33
 * Page callback: Displays add content links for available content types.
 *
 * Redirects to node/add/[type] if only one content type is available.
34
 *
35 36 37 38 39
 * @return array
 *   A render array for a list of the node types that can be added; however, if
 *   there is only one node type defined for the site, the function redirects
 *   to the node add page for that one node type and does not return at all.
 *
40 41
 * @see node_menu()
 */
42
function node_add_page() {
43 44 45 46 47 48 49
  $content = array();
  // Only use node types the user has access to.
  foreach (node_type_get_types() as $type) {
    if (node_hook($type->type, 'form') && node_access('create', $type->type)) {
      $content[$type->type] = $type;
    }
  }
50 51
  // Bypass the node/add listing if only one content type is available.
  if (count($content) == 1) {
52 53
    $type = array_shift($content);
    drupal_goto('node/add/' . $type->type);
54
  }
55
  return array('#theme' => 'node_add_list', '#content' => $content);
56 57
}

58
/**
59 60 61 62 63
 * Returns HTML for a list of available node types for node creation.
 *
 * @param $variables
 *   An associative array containing:
 *   - content: An array of content types.
64
 *
65 66 67
 * @return string
 *   An HTML-formatted string.
 *
68
 * @see node_add_page()
69
 *
70 71
 * @ingroup themeable
 */
72 73
function theme_node_add_list($variables) {
  $content = $variables['content'];
74 75 76 77
  $output = '';

  if ($content) {
    $output = '<dl class="node-type-list">';
78 79 80
    foreach ($content as $type) {
      $output .= '<dt>' . l($type->name, 'node/add/' . $type->type) . '</dt>';
      $output .= '<dd>' . filter_xss_admin($type->description) . '</dd>';
81 82 83
    }
    $output .= '</dl>';
  }
84
  else {
85
    $output = '<p>' . t('You have not created any content types yet. Go to the <a href="@create-content">content type creation page</a> to add a new content type.', array('@create-content' => url('admin/structure/types/add'))) . '</p>';
86
  }
87 88 89 90 91
  return $output;
}


/**
92 93
 * Page callback: Provides the node submission form.
 *
94 95
 * @param $node_type
 *   The node type object for the submitted node.
96
 *
97 98
 * @return array
 *   A node submission form.
99 100
 *
 * @see node_menu()
101
 */
102
function node_add($node_type) {
103 104
  global $user;

105
  $type = $node_type->type;
106 107 108 109
  $node = entity_create('node', array(
    'uid' => $user->uid,
    'name' => (isset($user->name) ? $user->name : ''),
    'type' => $type,
110
    'langcode' => node_type_get_default_langcode($type)
111
  ));
112
  drupal_set_title(t('Create @name', array('@name' => $node_type->name)), PASS_THROUGH);
113
  $output = entity_get_form($node);
114 115 116 117 118

  return $output;
}

/**
119 120
 * Generates a node preview.
 *
121
 * @param Drupal\node\Node $node
122 123 124
 *   The node to preview.
 *
 * @return
125
 *   An HTML-formatted string of a node preview.
126 127
 *
 * @see node_form_build_preview()
128
 */
129
function node_preview(Node $node) {
130
  if (node_access('create', $node) || node_access('update', $node)) {
131
    _field_invoke_multiple('load', 'node', array($node->nid => $node));
132
    // Load the user's name when needed.
133 134 135
    if (isset($node->name)) {
      // The use of isset() is mandatory in the context of user IDs, because
      // user ID 0 denotes the anonymous user.
136
      if ($user = user_load_by_name($node->name)) {
137 138 139 140 141 142 143
        $node->uid = $user->uid;
        $node->picture = $user->picture;
      }
      else {
        $node->uid = 0; // anonymous user
      }
    }
144
    elseif ($node->uid) {
145
      $user = user_load($node->uid);
146 147 148 149
      $node->name = $user->name;
      $node->picture = $user->picture;
    }

150
    $node->changed = REQUEST_TIME;
151 152
    $nodes = array($node->nid => $node);
    field_attach_prepare_view('node', $nodes, 'full');
153

154
    // Display a preview of the node.
155
    if (!form_get_errors()) {
156 157 158
      $node->in_preview = TRUE;
      $output = theme('node_preview', array('node' => $node));
      unset($node->in_preview);
159 160 161 162 163 164 165
    }

    return $output;
  }
}

/**
166
 * Returns HTML for a node preview for display during node creation and editing.
167
 *
168 169
 * @param $variables
 *   An associative array containing:
170
 *   - node: The node entity which is being previewed.
171
 *
172
 * @see NodeFormController::preview()
173
 *
174
 * @ingroup themeable
175
 */
176 177 178
function theme_node_preview($variables) {
  $node = $variables['node'];

179
  $output = '';
180

181
  $preview_trimmed_version = FALSE;
182

183 184 185 186
  $elements = node_view(clone $node, 'teaser');
  $trimmed = drupal_render($elements);
  $elements = node_view($node, 'full');
  $full = drupal_render($elements);
187 188 189

  // Do we need to preview trimmed version of post as well as full version?
  if ($trimmed != $full) {
190
    drupal_set_message(t('The trimmed version of your post shows what your post looks like when promoted to the main page or when exported for syndication.<span class="no-js"> You can insert the delimiter "&lt;!--break--&gt;" (without the quotes) to fine-tune where your post gets split.</span>'));
191
    $output .= '<h3>' . t('Preview trimmed version') . '</h3>';
192
    $output .= $trimmed;
193
    $output .= '<h3>' . t('Preview full version') . '</h3>';
194
    $output .= $full;
195 196
  }
  else {
197
    $output .= $full;
198 199 200 201 202 203
  }

  return $output;
}

/**
204 205
 * Page callback: Form constructor for node deletion confirmation form.
 *
206 207 208 209 210 211
 * @param object $node
 *   A node object.
 *
 * @return array
 *   A form array.
 *
212
 * @see node_menu()
213
 */
214
function node_delete_confirm($form, &$form_state, $node) {
215 216
  // Always provide entity id in the same form key as in the entity edit form.
  $form['nid'] = array('#type' => 'value', '#value' => $node->nid);
217
  return confirm_form($form,
218
    t('Are you sure you want to delete %title?', array('%title' => $node->label())),
219
    'node/' . $node->nid,
220
    t('This action cannot be undone.'),
221
    t('Delete'),
222 223
    t('Cancel')
  );
224 225 226
}

/**
227
 * Form submission handler for node_delete_confirm().
228 229 230
 */
function node_delete_confirm_submit($form, &$form_state) {
  if ($form_state['values']['confirm']) {
231
    $node = node_load($form_state['values']['nid']);
232
    node_delete($form_state['values']['nid']);
233
    watchdog('content', '@type: deleted %title.', array('@type' => $node->type, '%title' => $node->label()));
234
    drupal_set_message(t('@type %title has been deleted.', array('@type' => node_get_type_label($node), '%title' => $node->label())));
235 236 237 238 239 240
  }

  $form_state['redirect'] = '<front>';
}

/**
241 242
 * Page callback: Generates an overview table of older revisions of a node.
 *
243 244 245 246 247 248
 * @param object $node
 *   A node object.
 *
 * @return array
 *   An array as expected by drupal_render().
 *
249
 * @see node_menu()
250
 */
251
function node_revision_overview($node) {
252
  drupal_set_title(t('Revisions for %title', array('%title' => $node->label())), PASS_THROUGH);
253

254
  $header = array(t('Revision'), t('Operations'));
255 256 257 258 259 260 261 262 263

  $revisions = node_revision_list($node);

  $rows = array();
  $revert_permission = FALSE;
  if ((user_access('revert revisions') || user_access('administer nodes')) && node_access('update', $node)) {
    $revert_permission = TRUE;
  }
  $delete_permission = FALSE;
264
  if ((user_access('delete revisions') || user_access('administer nodes')) && node_access('delete', $node)) {
265 266 267 268 269
    $delete_permission = TRUE;
  }
  foreach ($revisions as $revision) {
    $row = array();
    if ($revision->current_vid > 0) {
270
      $row[] = array('data' => t('!date by !username', array('!date' => l(format_date($revision->timestamp, 'short'), "node/$node->nid"), '!username' => theme('username', array('account' => $revision))))
271
                               . (($revision->log != '') ? '<p class="revision-log">' . filter_xss($revision->log) . '</p>' : ''),
272
                     'class' => array('revision-current'));
273
      $row[] = array('data' => drupal_placeholder(t('current revision')), 'class' => array('revision-current'));
274 275
    }
    else {
276
      $row[] = t('!date by !username', array('!date' => l(format_date($revision->timestamp, 'short'), "node/$node->nid/revisions/$revision->vid/view"), '!username' => theme('username', array('account' => $revision))))
277
               . (($revision->log != '') ? '<p class="revision-log">' . filter_xss($revision->log) . '</p>' : '');
278
      if ($revert_permission) {
279 280 281 282
        $links['revert'] = array(
          'title' => t('revert'),
          'href' => "node/$node->nid/revisions/$revision->vid/revert",
        );
283 284
      }
      if ($delete_permission) {
285 286 287 288
        $links['delete'] = array(
          'title' => t('delete'),
          'href' => "node/$node->nid/revisions/$revision->vid/delete",
        );
289
      }
290 291 292 293 294 295
      $row[] = array(
        'data' => array(
          '#type' => 'operations',
          '#links' => $links,
        ),
      );
296
    }
297
    $rows[] = $row;
298
  }
299

300 301 302 303
  $build['node_revisions_table'] = array(
    '#theme' => 'table',
    '#rows' => $rows,
    '#header' => $header,
304 305 306
    '#attached' => array (
      'css' => array(drupal_get_path('module', 'node') . '/node.admin.css'),
    ),
307
  );
308

309
  return $build;
310 311
}

312
/**
313 314 315 316
 * Page callback: Form constructor for the reversion confirmation form.
 *
 * This form prevents against CSRF attacks.
 *
317 318 319 320 321 322
 * @param int $node_revision
 *   The node revision ID.
 *
 * @return array
 *   An array as expected by drupal_render().
 *
323 324
 * @see node_menu()
 * @see node_revision_revert_confirm_submit()
325
 */
326
function node_revision_revert_confirm($form, $form_state, $node_revision) {
327
  $form['#node_revision'] = $node_revision;
328
  return confirm_form($form, t('Are you sure you want to revert to the revision from %revision-date?', array('%revision-date' => format_date($node_revision->revision_timestamp))), 'node/' . $node_revision->nid . '/revisions', '', t('Revert'), t('Cancel'));
329 330
}

331 332 333
/**
 * Form submission handler for node_revision_revert_confirm().
 */
334 335 336
function node_revision_revert_confirm_submit($form, &$form_state) {
  $node_revision = $form['#node_revision'];
  $node_revision->revision = 1;
337 338
  // Make this the new default revision for the node.
  $node_revision->isDefaultRevision = TRUE;
339 340 341 342 343 344

  // The revision timestamp will be updated when the revision is saved. Keep the
  // original one for the confirmation message.
  $original_revision_timestamp = $node_revision->revision_timestamp;

  $node_revision->log = t('Copy of the revision from %date.', array('%date' => format_date($original_revision_timestamp)));
345

346
  $node_revision->save();
347

348
  watchdog('content', '@type: reverted %title revision %revision.', array('@type' => $node_revision->type, '%title' => $node_revision->label(), '%revision' => $node_revision->vid));
349
  drupal_set_message(t('@type %title has been reverted back to the revision from %revision-date.', array('@type' => node_get_type_label($node_revision), '%title' => $node_revision->label(), '%revision-date' => format_date($original_revision_timestamp))));
350
  $form_state['redirect'] = 'node/' . $node_revision->nid . '/revisions';
351
}
352

353 354 355 356 357
/**
 * Page callback: Form constructor for the revision deletion confirmation form.
 *
 * This form prevents against CSRF attacks.
 *
358 359 360 361 362 363
 * @param $node_revision
 *   The node revision ID.
 *
 * @return
 *   An array as expected by drupal_render().
 *
364 365 366
 * @see node_menu()
 * @see node_revision_delete_confirm_submit()
 */
367
function node_revision_delete_confirm($form, $form_state, $node_revision) {
368
  $form['#node_revision'] = $node_revision;
369
  return confirm_form($form, t('Are you sure you want to delete the revision from %revision-date?', array('%revision-date' => format_date($node_revision->revision_timestamp))), 'node/' . $node_revision->nid . '/revisions', t('This action cannot be undone.'), t('Delete'), t('Cancel'));
370 371
}

372 373 374
/**
 * Form submission handler for node_revision_delete_confirm().
 */
375 376
function node_revision_delete_confirm_submit($form, &$form_state) {
  $node_revision = $form['#node_revision'];
377 378
  node_revision_delete($node_revision->vid);

379
  watchdog('content', '@type: deleted %title revision %revision.', array('@type' => $node_revision->type, '%title' => $node_revision->label(), '%revision' => $node_revision->vid));
380
  drupal_set_message(t('Revision from %revision-date of @type %title has been deleted.', array('%revision-date' => format_date($node_revision->revision_timestamp), '@type' => node_get_type_label($node_revision), '%title' => $node_revision->label())));
381
  $form_state['redirect'] = 'node/' . $node_revision->nid;
382
  if (db_query('SELECT COUNT(vid) FROM {node_revision} WHERE nid = :nid', array(':nid' => $node_revision->nid))->fetchField() > 1) {
383 384 385
    $form_state['redirect'] .= '/revisions';
  }
}