Newer
Older
* The core module that allows content to be submitted to the site.
*
* Modules and scripts may programmatically submit nodes using the usual form
* API pattern.
Angie Byron
committed
use Drupal\Component\Utility\String;
use Drupal\Core\Language\Language;
use Symfony\Component\HttpFoundation\Response;
use Drupal\Core\Cache\Cache;
use Drupal\Core\Database\Query\AlterableInterface;
use Drupal\Core\Database\Query\SelectInterface;
use Drupal\node\NodeTypeInterface;
use Drupal\node\NodeInterface;
use Drupal\Core\Entity\EntityInterface;
use Drupal\Core\Entity\Display\EntityViewDisplayInterface;
use Drupal\Core\Entity\Display\EntityFormDisplayInterface;
Angie Byron
committed
use Drupal\Core\Template\Attribute;
use Drupal\file\Entity\File;
catch
committed
use Symfony\Cmf\Component\Routing\RouteObjectInterface;
Dries Buytaert
committed
/**
* Denotes that the node is not published.
Dries Buytaert
committed
*/
const NODE_NOT_PUBLISHED = 0;
Dries Buytaert
committed
/**
* Denotes that the node is published.
Dries Buytaert
committed
*/
const NODE_PUBLISHED = 1;
Dries Buytaert
committed
/**
* Denotes that the node is not promoted to the front page.
Dries Buytaert
committed
*/
const NODE_NOT_PROMOTED = 0;
Dries Buytaert
committed
/**
* Denotes that the node is promoted to the front page.
Dries Buytaert
committed
*/
const NODE_PROMOTED = 1;
Dries Buytaert
committed
/**
* Denotes that the node is not sticky at the top of the page.
Dries Buytaert
committed
*/
const NODE_NOT_STICKY = 0;
Dries Buytaert
committed
/**
* Denotes that the node is sticky at the top of the page.
Dries Buytaert
committed
*/
const NODE_STICKY = 1;
Dries Buytaert
committed
Dries Buytaert
committed
/**
* Denotes that access is allowed for a node.
*
* Modules should return this value from hook_node_access() to allow access to a
* node.
Dries Buytaert
committed
*/
Dries Buytaert
committed
const NODE_ACCESS_ALLOW = TRUE;
Dries Buytaert
committed
/**
* Denotes that access is denied for a node.
*
* Modules should return this value from hook_node_access() to deny access to a
* node.
Dries Buytaert
committed
*/
Dries Buytaert
committed
const NODE_ACCESS_DENY = FALSE;
Dries Buytaert
committed
/**
* Denotes that access is unaffected for a node.
*
* Modules should return this value from hook_node_access() to indicate no
* effect on node access.
Dries Buytaert
committed
*/
const NODE_ACCESS_IGNORE = NULL;
Dries Buytaert
committed
Dries Buytaert
committed
* Implements hook_help().
Gábor Hojtsy
committed
function node_help($path, $arg) {
// Remind site administrators about the {node_access} table being flagged
// for rebuild. We don't need to issue the message on the confirm form, or
// while the rebuild is being processed.
if ($path != 'admin/reports/status/rebuild' && $path != 'batch' && strpos($path, '#') === FALSE
&& user_access('access administration pages') && node_access_needs_rebuild()) {
if ($path == 'admin/reports/status') {
$message = t('The content access permissions need to be rebuilt.');
}
else {
$message = t('The content access permissions need to be rebuilt. <a href="!node_access_rebuild">Rebuild permissions</a>.', array('!node_access_rebuild' => \Drupal::url('node.configure_rebuild_confirm')));
}
drupal_set_message($message, 'error');
}
Gábor Hojtsy
committed
switch ($path) {
$output = '';
$output .= '<h3>' . t('About') . '</h3>';
$output .= '<p>' . t('The Node module manages the creation, editing, deletion, settings, and display of the main site content. Content items managed by the Node module are typically displayed as pages on your site, and include a title, some meta-data (author, creation time, content type, etc.), and optional fields containing text or other data (fields are managed by the <a href="!field">Field module</a>). For more information, see <a href="!node">the online documentation for the Node module</a>.', array('!node' => 'https://drupal.org/documentation/modules/node', '!field' => \Drupal::url('help.page', array('name' => 'field')))) . '</p>';
$output .= '<h3>' . t('Uses') . '</h3>';
$output .= '<dl>';
$output .= '<dt>' . t('Creating content') . '</dt>';
$output .= '<dd>' . t('When new content is created, the Node module records basic information about the content, including the author, date of creation, and the <a href="!content-type">Content type</a>. It also manages the <em>publishing options</em>, which define whether or not the content is published, promoted to the front page of the site, and/or sticky at the top of content lists. Default settings can be configured for each <a href="!content-type">type of content</a> on your site.', array('!content-type' => \Drupal::url('node.overview_types'))) . '</dd>';
$output .= '<dt>' . t('Creating custom content types') . '</dt>';
$output .= '<dd>' . t('The Node module gives users with the <em>Administer content types</em> permission the ability to <a href="!content-new">create new content types</a> in addition to the default ones already configured. Creating custom content types allows you the flexibility to add <a href="!field">fields</a> and configure default settings that suit the differing needs of various site content.', array('!content-new' => \Drupal::url('node.type_add'), '!field' => \Drupal::url('help.page', array('name' => 'field')))) . '</dd>';
$output .= '<dt>' . t('Administering content') . '</dt>';
$output .= '<dd>' . t('The <a href="!content">Content administration page</a> allows you to review and bulk manage your site content.', array('!content' => \Drupal::url('node.content_overview'))) . '</dd>';
$output .= '<dt>' . t('Creating revisions') . '</dt>';
$output .= '<dd>' . t('The Node module also enables you to create multiple versions of any content, and revert to older versions using the <em>Revision information</em> settings.') . '</dd>';
$output .= '<dt>' . t('User permissions') . '</dt>';
$output .= '<dd>' . t('The Node module makes a number of permissions available for each content type, which can be set by role on the <a href="!permissions">permissions page</a>.', array('!permissions' => \Drupal::url('user.admin_permissions', array(), array('fragment' => 'module-node')))) . '</dd>';
return $output;
Angie Byron
committed
Dries Buytaert
committed
case 'admin/structure/types/add':
return '<p>' . t('Individual content types can have different fields, behaviors, and permissions assigned to them.') . '</p>';
Angie Byron
committed
Alex Pott
committed
case 'admin/structure/types/manage/%/form-display':
Alex Pott
committed
$type = entity_load('node_type', $arg[4]);
return '<p>' . t('Content items can be edited using different form modes. Here, you can define which fields are shown and hidden when %type content is edited in each form mode, and define how the field form widgets are displayed in each form mode.', array('%type' => $type->label())) . '</p>' ;
Alex Pott
committed
Angie Byron
committed
case 'admin/structure/types/manage/%/display':
$type = entity_load('node_type', $arg[4]);
Angie Byron
committed
return '<p>' . t('Content items can be displayed using different view modes: Teaser, Full content, Print, RSS, etc. <em>Teaser</em> is a short format that is typically used in lists of multiple content items. <em>Full content</em> is typically used when the content is displayed on its own page.') . '</p>' .
'<p>' . t('Here, you can define which fields are shown and hidden when %type content is displayed in each view mode, and define how the fields are displayed in each view mode.', array('%type' => $type->label())) . '</p>';
Angie Byron
committed
Gábor Hojtsy
committed
case 'node/%/revisions':
return '<p>' . t('Revisions allow you to track differences between multiple versions of your content, and revert back to older versions.') . '</p>';
Angie Byron
committed
Gábor Hojtsy
committed
case 'node/%/edit':
$node = node_load($arg[1]);
Alex Pott
committed
$type = node_type_load($node->bundle());
Angie Byron
committed
return (!empty($type->help) ? filter_xss_admin($type->help) : '');
Gábor Hojtsy
committed
if ($arg[0] == 'node' && $arg[1] == 'add' && $arg[2]) {
$type = node_type_load($arg[2]);
Angie Byron
committed
return (!empty($type->help) ? filter_xss_admin($type->help) : '');
Dries Buytaert
committed
}
Dries Buytaert
committed
/**
Dries Buytaert
committed
* Implements hook_theme().
Dries Buytaert
committed
*/
function node_theme() {
return array(
Dries Buytaert
committed
'node' => array(
'render element' => 'elements',
'template' => 'node',
Dries Buytaert
committed
),
Dries Buytaert
committed
'node_search_admin' => array(
'render element' => 'form',
Dries Buytaert
committed
),
'node_add_list' => array(
'variables' => array('content' => NULL),
'file' => 'node.pages.inc',
'template' => 'node-add-list',
Dries Buytaert
committed
),
'node_preview' => array(
'variables' => array('node' => NULL),
'file' => 'node.pages.inc',
'template' => 'node-preview',
Dries Buytaert
committed
),
Dries Buytaert
committed
'node_edit_form' => array(
'render element' => 'form',
'template' => 'node-edit-form',
),
'field__node__title' => array(
'base hook' => 'field',
),
Dries Buytaert
committed
);
}
Dries Buytaert
committed
/**
* Implements hook_entity_bundle_info().
*/
function node_entity_bundle_info() {
$bundles = array();
// Bundles must provide a human readable name so we can create help and error
Alex Pott
committed
// messages.
foreach (node_type_get_names() as $id => $label) {
$bundles['node'][$id]['label'] = $label;
}
Dries Buytaert
committed
return $bundles;
Dries Buytaert
committed
/**
Alex Pott
committed
* Implements hook_entity_view_display_alter().
Dries Buytaert
committed
*/
Alex Pott
committed
function node_entity_view_display_alter(EntityViewDisplayInterface $display, $context) {
if ($context['entity_type'] == 'node') {
// Hide field labels in search index.
if ($context['view_mode'] == 'search_index') {
foreach ($display->getComponents() as $name => $options) {
if (isset($options['label'])) {
$options['label'] = 'hidden';
$display->setComponent($name, $options);
}
}
}
}
}
/**
* Implements hook_entity_form_display_alter().
*/
function node_entity_form_display_alter(EntityFormDisplayInterface $form_display, $context) {
if ($context['entity_type'] == 'node') {
$node_type = node_type_load($context['bundle']);
// @todo Reconsider when per-bundle overrides of field definitions are
// possible - https://drupal.org/node/2114707.
if (!$node_type->has_title) {
$form_display->removeComponent('title');
}
Dries Buytaert
committed
}
}
Angie Byron
committed
/**
Angie Byron
committed
* Entity URI callback.
* @param \Drupal\node\NodeInterface $node
* A node entity.
*
* @return array
Jennifer Hodgdon
committed
* An array with 'path' as the key and the path to the node as its value.
Angie Byron
committed
*/
function node_uri(NodeInterface $node) {
Angie Byron
committed
return array(
Alex Pott
committed
'route_name' => 'node.view',
'route_parameters' => array(
'node' => $node->id(),
),
Angie Byron
committed
);
Angie Byron
committed
}
/**
Dries Buytaert
committed
* Implements hook_admin_paths().
*/
function node_admin_paths() {
if (\Drupal::config('node.settings')->get('use_admin_theme')) {
Dries Buytaert
committed
$paths = array(
'node/*/edit' => TRUE,
'node/*/delete' => TRUE,
'node/*/revisions' => TRUE,
'node/*/revisions/*/revert' => TRUE,
'node/*/revisions/*/delete' => TRUE,
Angie Byron
committed
'node/*/translations' => TRUE,
'node/*/translations/*' => TRUE,
Dries Buytaert
committed
'node/add' => TRUE,
'node/add/*' => TRUE,
);
return $paths;
}
}
Dries Buytaert
committed
* Gathers a listing of links to nodes.
* A database result object from a query to fetch node entities. If your
* query joins the {comment_entity_statistics} table so that the comment_count
* field is available, a title attribute will be added to show the number of
* comments.
* (optional) A heading for the resulting list.
Dries Buytaert
committed
* A renderable array containing a list of linked node titles fetched from
* $result, or FALSE if there are no rows in $result.
Dries Buytaert
committed
$items = array();
Dries Buytaert
committed
$num_rows = FALSE;
Dries Buytaert
committed
foreach ($result as $node) {
Angie Byron
committed
// Do not use $node->label() here, because $node comes from the database.
$items[] = l($node->title, 'node/' . $node->nid, !empty($node->comment_count) ? array('attributes' => array('title' => format_plural($node->comment_count, '1 comment', '@count comments'))) : array());
Dries Buytaert
committed
$num_rows = TRUE;
Dries Buytaert
committed
return $num_rows ? array('#theme' => 'item_list__node', '#items' => $items, '#title' => $title) : FALSE;
Jennifer Hodgdon
committed
* Determines the type of marker to be displayed for a given node.
* @param $nid
* Node ID whose history supplies the "last viewed" timestamp.
* @param $timestamp
* Time which is compared against node's "last viewed" timestamp.
Dries Buytaert
committed
* @return
* One of the MARK constants.
Dries Buytaert
committed
function node_mark($nid, $timestamp) {
Angie Byron
committed
$cache = &drupal_static(__FUNCTION__, array());
if (\Drupal::currentUser()->isAnonymous() || !\Drupal::moduleHandler()->moduleExists('history')) {
Dries Buytaert
committed
return MARK_READ;
}
Dries Buytaert
committed
$cache[$nid] = history_read($nid);
Dries Buytaert
committed
if ($cache[$nid] == 0 && $timestamp > HISTORY_READ_LIMIT) {
Dries Buytaert
committed
return MARK_NEW;
}
Dries Buytaert
committed
elseif ($timestamp > $cache[$nid] && $timestamp > HISTORY_READ_LIMIT) {
Dries Buytaert
committed
return MARK_UPDATED;
}
return MARK_READ;
Angie Byron
committed
/**
* Returns a list of all the available node types.
*
Dries Buytaert
committed
* This list can include types that are queued for addition or deletion.
*
* @return array
* An array of node type entities, keyed by ID.
Dries Buytaert
committed
*
* @see node_type_load()
Angie Byron
committed
*/
function node_type_get_types() {
return entity_load_multiple('node_type');
Angie Byron
committed
}
/**
Dries Buytaert
committed
* Returns a list of available node type names.
*
* This list can include types that are queued for addition or deletion.
Angie Byron
committed
*
* @return array
* An array of node type labels, keyed by the node type name.
Angie Byron
committed
*/
function node_type_get_names() {
$cid = 'node_type:names:' . \Drupal::languageManager()->getCurrentLanguage()->id;
if ($cache = \Drupal::cache()->get($cid)) {
return $cache->data;
}
// Not using node_type_get_types() or entity_load_multiple() here, to allow
// this function being used in hook_entity_type_build() implementations.
// @todo Consider to convert this into a generic config entity helper.
$config_names = config_get_storage_names_with_prefix('node.type.');
$names = array();
foreach ($config_names as $config_name) {
$config = \Drupal::config($config_name);
$names[$config->get('type')] = $config->get('name');
}
\Drupal::cache()->set($cid, $names, Cache::PERMANENT, array(
'node_type' => array_keys($names),
'node_types' => TRUE,
));
return $names;
}
/**
* Returns the node type label for the passed node.
*
* @param \Drupal\node\NodeInterface $node
* A node entity to return the node type's label for.
*
* @return string|false
* The node type label or FALSE if the node type is not found.
* @todo Add this as generic helper method for config entities representing
* entity bundles.
function node_get_type_label(NodeInterface $node) {
$type = entity_load('node_type', $node->bundle());
return $type ? $type->label() : FALSE;
}
/**
* Description callback: Returns the node type description.
*
* @param \Drupal\node\NodeTypeInterface $node_type
* The node type object.
*
* @return string
* The node type description.
*/
function node_type_get_description(NodeTypeInterface $node_type) {
return $node_type->description;
}
Angie Byron
committed
/**
* Menu argument loader: Loads a node type by string.
Angie Byron
committed
*
* @param $name
* The machine name of a node type to load.
Angie Byron
committed
*
* @return \Drupal\node\NodeTypeInterface
Dries Buytaert
committed
* A node type object or NULL if $name does not exist.
Angie Byron
committed
*/
function node_type_load($name) {
return entity_load('node_type', $name);
}
Dries Buytaert
committed
Dries Buytaert
committed
/**
* Adds the default body field to a node type.
Dries Buytaert
committed
*
* @param \Drupal\node\NodeTypeInterface $type
* A node type object.
* @param $label
* (optional) The label for the body instance.
Dries Buytaert
committed
*
* @return
* Body field instance.
Dries Buytaert
committed
*/
function node_add_body_field(NodeTypeInterface $type, $label = 'Body') {
Dries Buytaert
committed
// Add or remove the body field, as needed.
$field = field_info_field('node', 'body');
$instance = field_info_instance('node', 'body', $type->id());
if (empty($field)) {
$field = entity_create('field_config', array(
'name' => 'body',
'entity_type' => 'node',
'type' => 'text_with_summary',
));
$field->save();
Dries Buytaert
committed
}
if (empty($instance)) {
$instance = entity_create('field_instance_config', array(
'field_name' => 'body',
'entity_type' => 'node',
'bundle' => $type->id(),
'label' => $label,
'settings' => array('display_summary' => TRUE),
));
$instance->save();
Alex Pott
committed
// Assign widget settings for the 'default' form mode.
entity_get_form_display('node', $type->type, 'default')
->setComponent('body', array(
Alex Pott
committed
'type' => 'text_textarea_with_summary',
))
->save();
// Assign display settings for the 'default' and 'teaser' view modes.
entity_get_display('node', $type->type, 'default')
->setComponent('body', array(
'label' => 'hidden',
'type' => 'text_default',
))
->save();
entity_get_display('node', $type->type, 'teaser')
->setComponent('body', array(
'label' => 'hidden',
'type' => 'text_summary_or_trimmed',
))
->save();
Dries Buytaert
committed
}
Dries Buytaert
committed
return $instance;
Dries Buytaert
committed
/**
* Implements hook_field_extra_fields().
*/
function node_field_extra_fields() {
$extra = array();
$module_language_enabled = \Drupal::moduleHandler()->moduleExists('language');
Angie Byron
committed
$description = t('Node module element');
foreach (node_type_get_types() as $bundle) {
// Add the 'language' select if Language module is enabled and the bundle
// has multilingual support.
// Visibility of the ordering of the language selector is the same as on the
Angie Byron
committed
// node/add form.
if ($module_language_enabled) {
$configuration = language_get_default_configuration('node', $bundle->type);
Dries Buytaert
committed
if ($configuration['language_show']) {
Angie Byron
committed
$extra['node'][$bundle->type]['form']['langcode'] = array(
Angie Byron
committed
'label' => t('Language'),
'description' => $description,
'weight' => 0,
);
}
}
Angie Byron
committed
$extra['node'][$bundle->type]['display']['langcode'] = array(
Angie Byron
committed
'label' => t('Language'),
'description' => $description,
'weight' => 0,
'visible' => FALSE,
);
}
Dries Buytaert
committed
}
/**
Neil Drumm
committed
* Updates all nodes of one type to be of another type.
*
* @param string $old_id
Neil Drumm
committed
* The current node type of the nodes.
* @param string $new_id
Neil Drumm
committed
* The new node type of the nodes.
*
* @return
Neil Drumm
committed
* The number of nodes whose node type field was modified.
*/
function node_type_update_nodes($old_id, $new_id) {
return db_update('node')
->fields(array('type' => $new_id))
->condition('type', $old_id)
Dries Buytaert
committed
->execute();
/**
* Loads node entities from the database.
*
* This function should be used whenever you need to load more than one node
Jennifer Hodgdon
committed
* from the database. Nodes are loaded into memory and will not require database
* access if loaded again during the same page request.
* @param array $nids
* (optional) An array of entity IDs. If omitted, all entities are loaded.
* @param bool $reset
* (optional) Whether to reset the internal node_load() cache. Defaults to
* FALSE.
* @return \Drupal\node\NodeInterface[]
* An array of node entities indexed by nid.
Angie Byron
committed
*
* @see entity_load_multiple()
Alex Pott
committed
* @see \Drupal\Core\Entity\Query\EntityQueryInterface
function node_load_multiple(array $nids = NULL, $reset = FALSE) {
catch
committed
return entity_load_multiple('node', $nids, $reset);
}
/**
* Loads a node entity from the database.
*
* @param int $nid
* The node ID.
* @param bool $reset
* (optional) Whether to reset the node_load_multiple() cache. Defaults to
* FALSE.
*
* @return \Drupal\node\NodeInterface|null
* A fully-populated node entity, or NULL if the node is not found.
*/
function node_load($nid = NULL, $reset = FALSE) {
catch
committed
return entity_load('node', $nid, $reset);
}
/**
* Loads a node revision from the database.
*
* @param int $vid
* The node revision id.
*
* @return \Drupal\node\NodeInterface|null
* A fully-populated node entity, or NULL if the node is not found.
*/
function node_revision_load($vid = NULL) {
return entity_revision_load('node', $vid);
Dries Buytaert
committed
/**
* Deletes a node revision.
Dries Buytaert
committed
*
* @param $revision_id
* The revision ID to delete.
* TRUE if the revision deletion was successful; otherwise, FALSE.
Dries Buytaert
committed
*/
function node_revision_delete($revision_id) {
Angie Byron
committed
entity_revision_delete('node', $revision_id);
Dries Buytaert
committed
}
Dries Buytaert
committed
/**
* Checks whether the current page is the full page view of the passed-in node.
Dries Buytaert
committed
*
* @param \Drupal\node\NodeInterface $node
* A node entity.
*
* @return
* The ID of the node if this is a full page view, otherwise FALSE.
Dries Buytaert
committed
*/
function node_is_page(NodeInterface $node) {
catch
committed
$request = \Drupal::request();
if ($request->attributes->get(RouteObjectInterface::ROUTE_NAME) == 'node.view') {
$page_node = $request->attributes->get('node');
}
Alex Pott
committed
return (!empty($page_node) ? $page_node->id() == $node->id() : FALSE);
Dries Buytaert
committed
}
/**
* Implements hook_preprocess_HOOK() for HTML document templates.
*/
function node_preprocess_html(&$variables) {
// If on an individual node page, add the node type to body classes.
catch
committed
if (($node = \Drupal::request()->attributes->get('node')) && $node instanceof NodeInterface) {
$variables['attributes']['class'][] = drupal_html_class('node-type-' . $node->getType());
}
}
Jennifer Hodgdon
committed
/**
Angie Byron
committed
* Implements hook_preprocess_HOOK() for block templates.
*/
function node_preprocess_block(&$variables) {
if ($variables['configuration']['module'] == 'node') {
switch ($variables['elements']['#plugin_id']) {
Dries Buytaert
committed
case 'node_syndicate_block':
Dries Buytaert
committed
$variables['attributes']['role'] = 'complementary';
break;
}
}
}
/**
* Implements hook_theme_suggestions_HOOK().
*/
function node_theme_suggestions_node(array $variables) {
$suggestions = array();
$node = $variables['elements']['#node'];
$suggestions[] = 'node__' . $node->bundle();
$suggestions[] = 'node__' . $node->id();
return $suggestions;
}
Dries Buytaert
committed
/**
Alex Pott
committed
* Prepares variables for node templates.
Dries Buytaert
committed
*
Alex Pott
committed
* Default template: node.html.twig.
Dries Buytaert
committed
*
Alex Pott
committed
* Most themes utilize their own copy of node.html.twig. The default is located
* inside "/core/modules/node/templates/node.html.twig". Look in there for the full
* list of variables.
*
* @param array $variables
Jennifer Hodgdon
committed
* An associative array containing:
* - elements: An array of elements to display in view mode.
* - node: The node object.
* - view_mode: View mode; e.g., 'full', 'teaser'...
Dries Buytaert
committed
*/
function template_preprocess_node(&$variables) {
$variables['view_mode'] = $variables['elements']['#view_mode'];
// Provide a distinct $teaser boolean.
$variables['teaser'] = $variables['view_mode'] == 'teaser';
Dries Buytaert
committed
$variables['node'] = $variables['elements']['#node'];
/** @var \Drupal\node\NodeInterface $node */
Dries Buytaert
committed
$node = $variables['node'];
Alex Pott
committed
$variables['date'] = format_date($node->getCreatedTime());
catch
committed
$username = array(
'#theme' => 'username',
'#account' => $node->getOwner(),
Alex Pott
committed
'#link_options' => array('attributes' => array('rel' => 'author')),
catch
committed
);
$variables['name'] = drupal_render($username);
Dries Buytaert
committed
Alex Pott
committed
$variables['node_url'] = $node->url();
$variables['label'] = $variables['elements']['title'];
unset($variables['elements']['title']);
Alex Pott
committed
$variables['page'] = $variables['view_mode'] == 'full' && node_is_page($node);
Angie Byron
committed
// Helpful $content variable for templates.
Angie Byron
committed
$variables += array('content' => array());
Angie Byron
committed
foreach (element_children($variables['elements']) as $key) {
$variables['content'][$key] = $variables['elements'][$key];
}
Dries Buytaert
committed
// Display post information only on certain node types.
// Avoid loading the entire node type config entity here that may not exist.
$node_type_config = \Drupal::config('node.type.' . $node->bundle());
// Display submitted by default.
$variables['display_submitted'] = $node_type_config->isNew() || $node_type_config->get('settings.node.submitted');
if ($variables['display_submitted']) {
Angie Byron
committed
$variables['submitted'] = t('Submitted by !username on !datetime', array('!username' => $variables['name'], '!datetime' => $variables['date']));
if (theme_get_setting('features.node_user_picture')) {
// To change user picture settings (e.g. image style), edit the 'compact'
Alex Pott
committed
// view mode on the User entity. Note that the 'compact' view mode might
// not be configured, so remember to always check the theme setting first.
$variables['user_picture'] = user_view($node->getOwner(), 'compact');
}
else {
$variables['user_picture'] = array();
}
Dries Buytaert
committed
}
else {
Angie Byron
committed
$variables['submitted'] = '';
Angie Byron
committed
$variables['user_picture'] = '';
Dries Buytaert
committed
}
Angie Byron
committed
catch
committed
// Add article ARIA role.
Dries Buytaert
committed
$variables['attributes']['role'] = 'article';
catch
committed
Angie Byron
committed
// Gather node classes.
Dries Buytaert
committed
$variables['attributes']['class'][] = 'node';
Alex Pott
committed
$variables['attributes']['class'][] = drupal_html_class('node-' . $node->bundle());
if ($node->isPromoted()) {
Dries Buytaert
committed
$variables['attributes']['class'][] = 'promoted';
Angie Byron
committed
}
Alex Pott
committed
if ($node->isSticky()) {
Dries Buytaert
committed
$variables['attributes']['class'][] = 'sticky';
Angie Byron
committed
}
Alex Pott
committed
if (!$node->isPublished()) {
Dries Buytaert
committed
$variables['attributes']['class'][] = 'unpublished';
Angie Byron
committed
}
Jennifer Hodgdon
committed
if ($variables['view_mode']) {
Dries Buytaert
committed
$variables['attributes']['class'][] = drupal_html_class('view-mode-' . $variables['view_mode']);
Angie Byron
committed
}
if (isset($variables['preview'])) {
Dries Buytaert
committed
$variables['attributes']['class'][] = 'preview';
Angie Byron
committed
}
Alex Pott
committed
$variables['content_attributes']['class'][] = 'content';
Dries Buytaert
committed
}
/**
* Returns HTML for the node title field.
*
* This is an override of theme_field() for the node title field. See that
* function for documentation about its details and overrides.
*
* @param array $variables
* An associative array. See theme_field() for details.
*
* @see theme_field()
*
* @ingroup themeable
*/
function theme_field__node__title($variables) {
return '<span' . $variables['attributes'] . '>' . drupal_render($variables['items']) . '</span>';
}
Dries Buytaert
committed
* Implements hook_permission().
function node_permission() {
$perms = array(
'bypass node access' => array(
'title' => t('Bypass content access control'),
'description' => t('View, edit and delete all content regardless of permission restrictions.'),
'restrict access' => TRUE,
),
Angie Byron
committed
'administer content types' => array(
'title' => t('Administer content types'),
Dries Buytaert
committed
'restrict access' => TRUE,
Angie Byron
committed
),
'administer nodes' => array(
'title' => t('Administer content'),
Dries Buytaert
committed
'restrict access' => TRUE,
Angie Byron
committed
),
Dries Buytaert
committed
'access content overview' => array(
Alex Pott
committed
'title' => t('Access the Content overview page'),
'description' => user_access('access content overview')
? t('Get an overview of <a href="@url">all content</a>.', array('@url' => url('admin/content')))
: t('Get an overview of all content.'),
Dries Buytaert
committed
),
'access content' => array(
'title' => t('View published content'),
),
'view own unpublished content' => array(
'title' => t('View own unpublished content'),
Angie Byron
committed
),
'view all revisions' => array(
'title' => t('View all revisions'),
Angie Byron
committed
),
'revert all revisions' => array(
'title' => t('Revert all revisions'),
'description' => t('Role requires permission <em>view revisions</em> and <em>edit rights</em> for nodes in question, or <em>administer nodes</em>.'),
Angie Byron
committed
),
'delete all revisions' => array(
'title' => t('Delete all revisions'),
'description' => t('Role requires permission to <em>view revisions</em> and <em>delete rights</em> for nodes in question, or <em>administer nodes</em>.'),
Angie Byron
committed
),
);
Neil Drumm
committed
Dries Buytaert
committed
// Generate standard node permissions for all applicable node types.
foreach (node_permissions_get_configured_types() as $type) {
Dries Buytaert
committed
$perms += node_list_permissions($type);
Neil Drumm
committed
}
return $perms;
Dries Buytaert
committed
/**
Dries Buytaert
committed
* Implements hook_ranking().
Dries Buytaert
committed
*/
function node_ranking() {
// Create the ranking array and add the basic ranking options.
$ranking = array(
'relevance' => array(
'title' => t('Keyword relevance'),
// Average relevance values hover around 0.15
'score' => 'i.relevance',
),
'sticky' => array(
'title' => t('Content is sticky at top of lists'),
// The sticky flag is either 0 or 1, which is automatically normalized.
'score' => 'n.sticky',
),
'promote' => array(
'title' => t('Content is promoted to the front page'),
// The promote flag is either 0 or 1, which is automatically normalized.
'score' => 'n.promote',
),
);
// Add relevance based on creation or changed date.
if ($node_cron_last = \Drupal::state()->get('node.cron_last')) {
Dries Buytaert
committed
$ranking['recent'] = array(
'title' => t('Recently posted'),
// Exponential decay with half-life of 6 months, starting at last indexed node
Dries Buytaert
committed
'score' => 'POW(2.0, (GREATEST(n.created, n.changed) - :node_cron_last) * 6.43e-8)',
'arguments' => array(':node_cron_last' => $node_cron_last),
Dries Buytaert
committed
);
}
return $ranking;
}
Gerhard Killesreiter
committed
/**
Dries Buytaert
committed
* Implements hook_user_cancel().
Gerhard Killesreiter
committed
*/
function node_user_cancel($edit, $account, $method) {
Angie Byron
committed
switch ($method) {
case 'user_cancel_block_unpublish':
// Unpublish nodes (current revisions).
module_load_include('inc', 'node', 'node.admin');
$nodes = db_select('node_field_data', 'n')
->distinct()
Dries Buytaert
committed
->fields('n', array('nid'))
Dries Buytaert
committed
->condition('uid', $account->id())
Dries Buytaert
committed
->execute()
->fetchCol();
node_mass_update($nodes, array('status' => 0), NULL, TRUE);
Angie Byron
committed
break;
case 'user_cancel_reassign':
// Anonymize nodes (current revisions).
module_load_include('inc', 'node', 'node.admin');
$nodes = db_select('node_field_data', 'n')
->distinct()
Dries Buytaert
committed
->fields('n', array('nid'))
Dries Buytaert
committed
->condition('uid', $account->id())
Dries Buytaert
committed
->execute()
->fetchCol();
node_mass_update($nodes, array('uid' => 0), NULL, TRUE);
Angie Byron
committed
// Anonymize old revisions.
db_update('node_field_revision')
Dries Buytaert
committed
->fields(array('uid' => 0))
Dries Buytaert
committed
->condition('uid', $account->id())
Dries Buytaert
committed
->execute();
Angie Byron
committed
break;
Dries Buytaert
committed
}
}
Angie Byron
committed
Dries Buytaert
committed
/**
catch
committed
* Implements hook_user_predelete().
Dries Buytaert
committed
*/
catch
committed
function node_user_predelete($account) {
Dries Buytaert
committed
// Delete nodes (current revisions).
// @todo Introduce node_mass_delete() or make node_mass_update() more flexible.
$nodes = db_select('node_field_data', 'n')
->distinct()
Dries Buytaert
committed
->fields('n', array('nid'))
Dries Buytaert
committed
->condition('uid', $account->id())
Dries Buytaert
committed
->execute()
->fetchCol();
entity_delete_multiple('node', $nodes);
Dries Buytaert
committed
// Delete old revisions.
Dries Buytaert
committed
$revisions = db_query('SELECT DISTINCT vid FROM {node_field_revision} WHERE uid = :uid', array(':uid' => $account->id()))->fetchCol();
Dries Buytaert
committed
foreach ($revisions as $revision) {
node_revision_delete($revision);
Angie Byron
committed
}
Gerhard Killesreiter
committed
}
Gábor Hojtsy
committed
/**
* Returns HTML for the content ranking part of the search settings admin page.
*
* @param $variables
* An associative array containing:
* - form: A render element representing the form.
Gábor Hojtsy
committed
*
* @see node_search_admin()
Gábor Hojtsy
committed
* @ingroup themeable
*/
Dries Buytaert
committed
function theme_node_search_admin($variables) {
$form = $variables['form'];
Dries Buytaert
committed
$output = drupal_render($form['info']);
Angie Byron
committed
$header = array(t('Factor'), t('Influence'));
foreach (element_children($form['factors']) as $key) {
$row = array();
$row[] = $form['factors'][$key]['#title'];
Dries Buytaert
committed
$form['factors'][$key]['#title_display'] = 'invisible';
Dries Buytaert
committed
$row[] = drupal_render($form['factors'][$key]);
$rows[] = $row;
}
catch
committed
$table = array(
'#theme' => 'table',
'#header' => $header,
'#rows' => $rows,
);
$output .= drupal_render($table);
$output .= drupal_render_children($form);
return $output;
}
/**
* Access callback: Checks node revision access.
*
* @param \Drupal\node\NodeInterface $node
* The node to check.
* @param $op
* (optional) The specific operation being checked. Defaults to 'view.'
Angie Byron
committed
* @param object $account
* (optional) A user object representing the user for whom the operation is
* to be performed. Determines access for a user other than the current user.
* Defaults to NULL.
Dries Buytaert
committed
* @param $langcode
* (optional) Language code for the variant of the node. Different language
* variants might have different permissions associated. If NULL, the
* original langcode of the node is used. Defaults to NULL.
Angie Byron
committed
* TRUE if the operation may be performed, FALSE otherwise.
*
* @see node_menu()
*/
function _node_revision_access(NodeInterface $node, $op = 'view', $account = NULL, $langcode = NULL) {
if ($account === NULL) {
$account = \Drupal::currentUser();
}
return \Drupal::service('access_check.node.revision')->checkAccess($node, $account, $op, $langcode);
Dries Buytaert
committed
}
/**
* Implements hook_menu_link_defaults().
*/
function node_menu_link_defaults() {
$links['node.admin.content'] = array(
'link_title' => 'Content',
'route_name' => 'node.content_overview',
'parent' => 'system.admin',
'description' => 'Find and manage content.',
'weight' => -10,
);
$links['node.admin.structure.types'] = array(
'link_title' => 'Content types',
'parent' => 'system.admin.structure',
'description' => 'Manage content types, including default status, front page promotion, comment settings, etc.',
'route_name' => 'node.overview_types',
);
$links['node.add'] = array(
'link_title' => 'Add content',
'route_name' => 'node.add_page',
);
return $links;
}
* Title callback: Displays the node's title.
*
* @param \Drupal\node\NodeInterface $node
* The node entity.
* @return
* An unsanitized string that is the title of the node.
*
function node_page_title(NodeInterface $node) {
Angie Byron
committed
return $node->label();
}
/**
* Finds the last time a node was changed.
*
* @param $nid
* The ID of a node.
* @param string $langcode
* (optional) The language the node has been last modified in. Defaults to the
* node language.
*
* @return string
* A unix timestamp indicating the last time the node was changed.
*/
function node_last_changed($nid, $langcode = NULL) {
if (isset($langcode)) {
$result = db_query('SELECT changed FROM {node_field_data} WHERE nid = :nid AND langcode = :langcode', array(':nid' => $nid, ':langcode' => $langcode))->fetch();
}
else {
$result = db_query('SELECT changed FROM {node_field_data} WHERE nid = :nid AND default_langcode = :default_langcode', array(':nid' => $nid, ':default_langcode' => 1))->fetch();
}
return is_object($result) ? $result->changed : FALSE;