node.pages.inc 21.9 KB
Newer Older
1
2
3
4
5
6
7
8
9
<?php

/**
 * @file
 * Page callbacks for adding, editing, deleting, and revisions management for content.
 */


/**
10
 * Menu callback; presents the node editing form.
11
 */
12
function node_page_edit($node) {
13
  $type_name = node_type_get_name($node);
14
  drupal_set_title(t('<em>Edit @type</em> @title', array('@type' => $type_name, '@title' => $node->title)), PASS_THROUGH);
15
  return drupal_get_form($node->type . '_node_form', $node);
16
17
18
19
}

function node_add_page() {
  $item = menu_get_item();
20
  $content = system_admin_menu_block($item);
21
22
23
24
25
  // Bypass the node/add listing if only one content type is available.
  if (count($content) == 1) {
    $item = array_shift($content);
    drupal_goto($item['href']);
  }
26
  return theme('node_add_list', array('content' => $content));
27
28
}

29
/**
30
31
32
33
34
 * Returns HTML for a list of available node types for node creation.
 *
 * @param $variables
 *   An associative array containing:
 *   - content: An array of content types.
35
36
37
 *
 * @ingroup themeable
 */
38
39
function theme_node_add_list($variables) {
  $content = $variables['content'];
40
41
42
43
44
  $output = '';

  if ($content) {
    $output = '<dl class="node-type-list">';
    foreach ($content as $item) {
45
      $output .= '<dt>' . l($item['title'], $item['href'], $item['localized_options']) . '</dt>';
46
      $output .= '<dd>' . filter_xss_admin($item['description']) . '</dd>';
47
48
49
    }
    $output .= '</dl>';
  }
50
  else {
51
    $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>';
52
  }
53
54
55
56
57
  return $output;
}


/**
58
 * Returns a node submission form.
59
60
61
62
 */
function node_add($type) {
  global $user;

63
  $types = node_type_get_types();
64
65
66
  $node = (object) array('uid' => $user->uid, 'name' => (isset($user->name) ? $user->name : ''), 'type' => $type, 'language' => LANGUAGE_NONE);
  drupal_set_title(t('Create @name', array('@name' => $types[$type]->name)), PASS_THROUGH);
  $output = drupal_get_form($type . '_node_form', $node);
67
68
69
70
71

  return $output;
}

function node_form_validate($form, &$form_state) {
72
73
74
  // $form_state['node'] contains the actual entity being edited, but we must
  // not update it with form values that have not yet been validated, so we
  // create a pseudo-entity to use during validation.
75
  $node = (object) $form_state['values'];
76
  node_validate($node, $form, $form_state);
77
  entity_form_field_validate('node', $form, $form_state);
78
79
80
81
82
}

/**
 * Generate the node add/edit form array.
 */
83
function node_form($form, &$form_state, $node) {
84
85
  global $user;

86
87
88
89
90
91
  // During initial form build, add the node entity to the form state for use
  // during form building and processing. During a rebuild, use what is in the
  // form state.
  if (!isset($form_state['node'])) {
    if (!isset($node->title)) {
      $node->title = NULL;
92
    }
93
    node_object_prepare($node);
94
    $form_state['node'] = $node;
95
  }
96
  else {
97
98
99
100
101
102
    $node = $form_state['node'];
  }

  // Some special stuff when previewing a node.
  if (isset($form_state['node_preview'])) {
    $form['#prefix'] = $form_state['node_preview'];
103
    $node->in_preview = TRUE;
104
  }
105
106
107
  else {
    unset($node->in_preview);
  }
108

109
  // Identify this as a node edit form.
110
  // @todo D8: Remove. Modules can implement hook_form_BASE_FORM_ID_alter() now.
111
  $form['#node_edit_form'] = TRUE;
112

113
114
115
  // Override the default CSS class name, since the user-defined node type name
  // in 'TYPE-node-form' potentially clashes with third-party class names.
  $form['#attributes']['class'][0] = drupal_html_class('node-' . $node->type . '-form');
116

117
118
  // Basic node information.
  // These elements are just values so they are not even sent to the client.
119
  foreach (array('nid', 'vid', 'uid', 'created', 'type', 'language') as $key) {
120
    $form[$key] = array(
121
      '#type' => 'value',
122
123
      '#value' => isset($node->$key) ? $node->$key : NULL,
    );
124
125
126
  }

  // Changed must be sent to the client, for later overwrite error checking.
127
  $form['changed'] = array(
128
    '#type' => 'hidden',
129
130
    '#default_value' => isset($node->changed) ? $node->changed : NULL,
  );
131
132
  // Invoke hook_form() to get the node-specific bits. Can't use node_invoke(),
  // because hook_form() needs to be able to receive $form_state by reference.
133
134
  // @todo hook_form() implementations are unable to add #validate or #submit
  //   handlers to the form buttons below. Remove hook_form() entirely.
135
136
  $function = node_type_get_base($node) . '_form';
  if (function_exists($function) && ($extra = $function($node, $form_state))) {
137
138
    $form = array_merge_recursive($form, $extra);
  }
139
140
141
  // If the node type has a title, and the node type form defined no special
  // weight for it, we default to a weight of -5 for consistency.
  if (isset($form['title']) && !isset($form['title']['#weight'])) {
142
143
    $form['title']['#weight'] = -5;
  }
144
  // @todo D8: Remove. Modules should access the node using $form_state['node'].
145
146
  $form['#node'] = $node;

147
148
  $form['additional_settings'] = array(
    '#type' => 'vertical_tabs',
149
    '#weight' => 99,
150
151
  );

152
153
  // Add a log field if the "Create new revision" option is checked, or if the
  // current user has the ability to check that option.
154
155
156
157
158
159
160
  $form['revision_information'] = array(
    '#type' => 'fieldset',
    '#title' => t('Revision information'),
    '#collapsible' => TRUE,
    // Collapsed by default when "Create new revision" is unchecked
    '#collapsed' => !$node->revision,
    '#group' => 'additional_settings',
161
162
163
    '#attributes' => array(
      'class' => array('node-form-revision-information'),
    ),
164
165
166
167
168
169
170
171
172
173
    '#attached' => array(
      'js' => array(drupal_get_path('module', 'node') . '/node.js'),
    ),
    '#weight' => 20,
    '#access' => $node->revision || user_access('administer nodes'),
  );
  $form['revision_information']['revision'] = array(
    '#type' => 'checkbox',
    '#title' => t('Create new revision'),
    '#default_value' => $node->revision,
174
175
176
177
178
179
180
    '#access' => user_access('administer nodes'),
  );
  // Check the revision log checkbox when the log textarea is filled in.
  // This must not happen if "Create new revision" is enabled by default, since
  // the state would auto-disable the checkbox otherwise.
  if (!$node->revision) {
    $form['revision_information']['revision']['#states'] = array(
181
182
      'checked' => array(
        'textarea[name="log"]' => array('empty' => FALSE),
183
      ),
184
185
    );
  }
186
187
188
189
190
  $form['revision_information']['log'] = array(
    '#type' => 'textarea',
    '#title' => t('Revision log message'),
    '#rows' => 4,
    '#default_value' => !empty($node->log) ? $node->log : '',
191
    '#description' => t('Briefly describe the changes you have made.'),
192
  );
193
194
195
196
197
198
199
200

  // Node author information for administrators
  $form['author'] = array(
    '#type' => 'fieldset',
    '#access' => user_access('administer nodes'),
    '#title' => t('Authoring information'),
    '#collapsible' => TRUE,
    '#collapsed' => TRUE,
201
    '#group' => 'additional_settings',
202
203
204
    '#attributes' => array(
      'class' => array('node-form-author'),
    ),
205
    '#attached' => array(
206
207
208
209
210
211
212
      'js' => array(
        drupal_get_path('module', 'node') . '/node.js',
        array(
          'type' => 'setting',
          'data' => array('anonymous' => variable_get('anonymous', t('Anonymous'))),
        ),
      ),
213
    ),
214
    '#weight' => 90,
215
  );
216
  $form['author']['name'] = array(
217
218
219
220
    '#type' => 'textfield',
    '#title' => t('Authored by'),
    '#maxlength' => 60,
    '#autocomplete_path' => 'user/autocomplete',
221
    '#default_value' => !empty($node->name) ? $node->name : '',
222
    '#weight' => -1,
223
224
225
    '#description' => t('Leave blank for %anonymous.', array('%anonymous' => variable_get('anonymous', t('Anonymous')))),
  );
  $form['author']['date'] = array(
226
227
228
    '#type' => 'textfield',
    '#title' => t('Authored on'),
    '#maxlength' => 25,
229
    '#description' => t('Format: %time. The date format is YYYY-MM-DD and %timezone is the time zone offset from UTC. Leave blank to use the time of form submission.', array('%time' => !empty($node->date) ? date_format(date_create($node->date), 'Y-m-d H:i:s O') : format_date($node->created, 'custom', 'Y-m-d H:i:s O'), '%timezone' => !empty($node->date) ? date_format(date_create($node->date), 'O') : format_date($node->created, 'custom', 'O'))),
230
    '#default_value' => !empty($node->date) ? $node->date : '',
231
  );
232
233
234
235
236
237
238
239

  // Node options for administrators
  $form['options'] = array(
    '#type' => 'fieldset',
    '#access' => user_access('administer nodes'),
    '#title' => t('Publishing options'),
    '#collapsible' => TRUE,
    '#collapsed' => TRUE,
240
    '#group' => 'additional_settings',
241
242
243
    '#attributes' => array(
      'class' => array('node-form-options'),
    ),
244
245
246
    '#attached' => array(
      'js' => array(drupal_get_path('module', 'node') . '/node.js'),
    ),
247
    '#weight' => 95,
248
  );
249
  $form['options']['status'] = array(
250
251
    '#type' => 'checkbox',
    '#title' => t('Published'),
252
253
254
    '#default_value' => $node->status,
  );
  $form['options']['promote'] = array(
255
256
    '#type' => 'checkbox',
    '#title' => t('Promoted to front page'),
257
258
259
    '#default_value' => $node->promote,
  );
  $form['options']['sticky'] = array(
260
261
    '#type' => 'checkbox',
    '#title' => t('Sticky at top of lists'),
262
263
    '#default_value' => $node->sticky,
  );
264
265

  // Add the buttons.
266
  $form['actions'] = array('#type' => 'actions');
267
  $form['actions']['submit'] = array(
268
    '#type' => 'submit',
269
    '#access' => variable_get('node_preview_' . $node->type, DRUPAL_OPTIONAL) != DRUPAL_REQUIRED || (!form_get_errors() && isset($form_state['node_preview'])),
270
    '#value' => t('Save'),
271
    '#weight' => 5,
272
    '#submit' => array('node_form_submit'),
273
  );
274
  $form['actions']['preview'] = array(
275
    '#access' => variable_get('node_preview_' . $node->type, DRUPAL_OPTIONAL) != DRUPAL_DISABLED,
276
    '#type' => 'submit',
277
    '#value' => t('Preview'),
278
    '#weight' => 10,
279
    '#submit' => array('node_form_build_preview'),
280
281
  );
  if (!empty($node->nid) && node_access('delete', $node)) {
282
    $form['actions']['delete'] = array(
283
284
285
286
287
288
      '#type' => 'submit',
      '#value' => t('Delete'),
      '#weight' => 15,
      '#submit' => array('node_form_delete_submit'),
    );
  }
289
290
291
292
293
294
  // This form uses a button-level #submit handler for the form's main submit
  // action. node_form_submit() manually invokes all form-level #submit handlers
  // of the form. Without explicitly setting #submit, Form API would auto-detect
  // node_form_submit() as submit handler, but that is the button-level #submit
  // handler for the 'Save' action. To maintain backwards compatibility, a
  // #submit handler is auto-suggested for custom node type modules.
295
  $form['#validate'][] = 'node_form_validate';
296
297
298
299
  if (!isset($form['#submit']) && function_exists($node->type . '_node_form_submit')) {
    $form['#submit'][] = $node->type . '_node_form_submit';
  }
  $form += array('#submit' => array());
300

301
  field_attach_form('node', $node, $form, $form_state, $node->language);
302
303
304
305
  return $form;
}

/**
306
 * Button submit function: handle the 'Delete' button on the node form.
307
308
 */
function node_form_delete_submit($form, &$form_state) {
309
  $destination = array();
310
  if (isset($_GET['destination'])) {
311
    $destination = drupal_get_destination();
312
    unset($_GET['destination']);
313
314
  }
  $node = $form['#node'];
315
  $form_state['redirect'] = array('node/' . $node->nid . '/delete', array('query' => $destination));
316
317
318
319
}


function node_form_build_preview($form, &$form_state) {
320
  $node = node_form_submit_build_node($form, $form_state);
321
  $form_state['node_preview'] = node_preview($node);
322
  $form_state['rebuild'] = TRUE;
323
324
325
326
327
}

/**
 * Generate a node preview.
 */
328
function node_preview($node) {
329
  if (node_access('create', $node) || node_access('update', $node)) {
330
    _field_invoke_multiple('load', 'node', array($node->nid => $node));
331
    // Load the user's name when needed.
332
333
334
    if (isset($node->name)) {
      // The use of isset() is mandatory in the context of user IDs, because
      // user ID 0 denotes the anonymous user.
335
      if ($user = user_load_by_name($node->name)) {
336
337
338
339
340
341
342
        $node->uid = $user->uid;
        $node->picture = $user->picture;
      }
      else {
        $node->uid = 0; // anonymous user
      }
    }
343
    elseif ($node->uid) {
344
      $user = user_load($node->uid);
345
346
347
348
      $node->name = $user->name;
      $node->picture = $user->picture;
    }

349
    $node->changed = REQUEST_TIME;
350
351
    $nodes = array($node->nid => $node);
    field_attach_prepare_view('node', $nodes, 'full');
352

353
    // Display a preview of the node.
354
    if (!form_get_errors()) {
355
356
357
      $node->in_preview = TRUE;
      $output = theme('node_preview', array('node' => $node));
      unset($node->in_preview);
358
    }
359
    drupal_set_title(t('Preview'), PASS_THROUGH);
360
361
362
363
364
365

    return $output;
  }
}

/**
366
 * Returns HTML for a node preview for display during node creation and editing.
367
 *
368
369
370
 * @param $variables
 *   An associative array containing:
 *   - node: The node object which is being previewed.
371
372
 *
 * @ingroup themeable
373
 */
374
375
376
function theme_node_preview($variables) {
  $node = $variables['node'];

377
  $output = '<div class="preview">';
378

379
  $preview_trimmed_version = FALSE;
380

381
382
383
384
  $elements = node_view(clone $node, 'teaser');
  $trimmed = drupal_render($elements);
  $elements = node_view($node, 'full');
  $full = drupal_render($elements);
385
386
387

  // Do we need to preview trimmed version of post as well as full version?
  if ($trimmed != $full) {
388
    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>'));
389
    $output .= '<h3>' . t('Preview trimmed version') . '</h3>';
390
    $output .= $trimmed;
391
    $output .= '<h3>' . t('Preview full version') . '</h3>';
392
    $output .= $full;
393
394
  }
  else {
395
    $output .= $full;
396
397
398
399
400
401
402
  }
  $output .= "</div>\n";

  return $output;
}

function node_form_submit($form, &$form_state) {
403
  $node = node_form_submit_build_node($form, $form_state);
404
405
  $insert = empty($node->nid);
  node_save($node);
406
  $node_link = l(t('view'), 'node/' . $node->nid);
407
408
  $watchdog_args = array('@type' => $node->type, '%title' => $node->title);
  $t_args = array('@type' => node_type_get_name($node), '%title' => $node->title);
409
410

  if ($insert) {
411
    watchdog('content', '@type: added %title.', $watchdog_args, WATCHDOG_NOTICE, $node_link);
412
    drupal_set_message(t('@type %title has been created.', $t_args));
413
414
  }
  else {
415
    watchdog('content', '@type: updated %title.', $watchdog_args, WATCHDOG_NOTICE, $node_link);
416
    drupal_set_message(t('@type %title has been updated.', $t_args));
417
418
  }
  if ($node->nid) {
419
    $form_state['values']['nid'] = $node->nid;
420
    $form_state['nid'] = $node->nid;
421
    $form_state['redirect'] = 'node/' . $node->nid;
422
423
424
425
  }
  else {
    // In the unlikely case something went wrong on save, the node will be
    // rebuilt and node form redisplayed the same way as in preview.
426
    drupal_set_message(t('The post could not be saved.'), 'error');
427
    $form_state['rebuild'] = TRUE;
428
  }
429
430
  // Clear the page and block caches.
  cache_clear_all();
431
432
433
}

/**
434
435
 * Updates the form state's node entity by processing this submission's values.
 *
436
 * This is the default builder function for the node form. It is called
437
438
439
440
441
442
 * during the "Save" and "Preview" submit handlers to retrieve the entity to
 * save or preview. This function can also be called by a "Next" button of a
 * wizard to update the form state's entity with the current step's values
 * before proceeding to the next step.
 *
 * @see node_form()
443
444
 */
function node_form_submit_build_node($form, &$form_state) {
445
446
447
448
449
450
451
  // @todo Legacy support for modules that extend the node form with form-level
  //   submit handlers that adjust $form_state['values'] prior to those values
  //   being used to update the entity. Module authors are encouraged to instead
  //   adjust the node directly within a hook_node_submit() implementation. For
  //   Drupal 8, evaluate whether the pattern of triggering form-level submit
  //   handlers during button-level submit processing is worth supporting
  //   properly, and if so, add a Form API function for doing so.
452
  unset($form_state['submit_handlers']);
453
454
  form_execute_handlers('submit', $form, $form_state);

455
456
  $node = $form_state['node'];
  entity_form_submit_build_entity('node', $node, $form, $form_state);
Dries's avatar
   
Dries committed
457

458
459
460
461
462
  node_submit($node);
  foreach (module_implements('node_submit') as $module) {
    $function = $module . '_node_submit';
    $function($node, $form, $form_state);
  }
463
464
465
466
467
468
  return $node;
}

/**
 * Menu callback -- ask for confirmation of node deletion
 */
469
function node_delete_confirm($form, &$form_state, $node) {
470
471
472
  $form['#node'] = $node;
  // Always provide entity id in the same form key as in the entity edit form.
  $form['nid'] = array('#type' => 'value', '#value' => $node->nid);
473
  return confirm_form($form,
474
    t('Are you sure you want to delete %title?', array('%title' => $node->title)),
475
    'node/' . $node->nid,
476
    t('This action cannot be undone.'),
477
    t('Delete'),
478
479
    t('Cancel')
  );
480
481
482
483
484
485
486
}

/**
 * Execute node deletion
 */
function node_delete_confirm_submit($form, &$form_state) {
  if ($form_state['values']['confirm']) {
487
    $node = node_load($form_state['values']['nid']);
488
    node_delete($form_state['values']['nid']);
489
490
    watchdog('content', '@type: deleted %title.', array('@type' => $node->type, '%title' => $node->title));
    drupal_set_message(t('@type %title has been deleted.', array('@type' => node_type_get_name($node), '%title' => $node->title)));
491
492
493
494
495
496
497
498
  }

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

/**
 * Generate an overview table of older revisions of a node.
 */
499
function node_revision_overview($node) {
500
  drupal_set_title(t('Revisions for %title', array('%title' => $node->title)), PASS_THROUGH);
501
502
503
504
505
506
507
508
509
510
511

  $header = array(t('Revision'), array('data' => t('Operations'), 'colspan' => 2));

  $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;
512
  if ((user_access('delete revisions') || user_access('administer nodes')) && node_access('delete', $node)) {
513
514
515
516
517
518
519
    $delete_permission = TRUE;
  }
  foreach ($revisions as $revision) {
    $row = array();
    $operations = array();

    if ($revision->current_vid > 0) {
520
      $row[] = array('data' => t('!date by !username', array('!date' => l(format_date($revision->timestamp, 'short'), "node/$node->nid"), '!username' => theme('username', array('account' => $revision))))
521
                               . (($revision->log != '') ? '<p class="revision-log">' . filter_xss($revision->log) . '</p>' : ''),
522
                     'class' => array('revision-current'));
523
      $operations[] = array('data' => drupal_placeholder(t('current revision')), 'class' => array('revision-current'), 'colspan' => 2);
524
525
    }
    else {
526
      $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))))
527
               . (($revision->log != '') ? '<p class="revision-log">' . filter_xss($revision->log) . '</p>' : '');
528
529
530
531
532
533
534
535
536
      if ($revert_permission) {
        $operations[] = l(t('revert'), "node/$node->nid/revisions/$revision->vid/revert");
      }
      if ($delete_permission) {
        $operations[] = l(t('delete'), "node/$node->nid/revisions/$revision->vid/delete");
      }
    }
    $rows[] = array_merge($row, $operations);
  }
537

538
539
540
541
542
  $build['node_revisions_table'] = array(
    '#theme' => 'table',
    '#rows' => $rows,
    '#header' => $header,
  );
543

544
  return $build;
545
546
}

547
548
549
/**
 * Ask for confirmation of the reversion to prevent against CSRF attacks.
 */
550
function node_revision_revert_confirm($form, $form_state, $node_revision) {
551
  $form['#node_revision'] = $node_revision;
552
  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'));
553
554
555
556
557
558
559
560
561
}

function node_revision_revert_confirm_submit($form, &$form_state) {
  $node_revision = $form['#node_revision'];
  $node_revision->revision = 1;
  $node_revision->log = t('Copy of the revision from %date.', array('%date' => format_date($node_revision->revision_timestamp)));

  node_save($node_revision);

562
563
  watchdog('content', '@type: reverted %title revision %revision.', array('@type' => $node_revision->type, '%title' => $node_revision->title, '%revision' => $node_revision->vid));
  drupal_set_message(t('@type %title has been reverted back to the revision from %revision-date.', array('@type' => node_type_get_name($node_revision), '%title' => $node_revision->title, '%revision-date' => format_date($node_revision->revision_timestamp))));
564
  $form_state['redirect'] = 'node/' . $node_revision->nid . '/revisions';
565
}
566

567
function node_revision_delete_confirm($form, $form_state, $node_revision) {
568
  $form['#node_revision'] = $node_revision;
569
  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'));
570
571
572
573
}

function node_revision_delete_confirm_submit($form, &$form_state) {
  $node_revision = $form['#node_revision'];
574
575
  node_revision_delete($node_revision->vid);

576
577
  watchdog('content', '@type: deleted %title revision %revision.', array('@type' => $node_revision->type, '%title' => $node_revision->title, '%revision' => $node_revision->vid));
  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_type_get_name($node_revision), '%title' => $node_revision->title)));
578
  $form_state['redirect'] = 'node/' . $node_revision->nid;
579
  if (db_query('SELECT COUNT(vid) FROM {node_revision} WHERE nid = :nid', array(':nid' => $node_revision->nid))->fetchField() > 1) {
580
581
582
    $form_state['redirect'] .= '/revisions';
  }
}