Version 1

[yaffs-website] / web / core / modules / comment / comment.api.php

diff --git a/web/core/modules/comment/comment.api.php b/web/core/modules/comment/comment.api.php
new file mode 100644 (file)
index 0000000..ec6b4ce
--- /dev/null
+++ b/web/core/modules/comment/comment.api.php
@@ -0,0 +1,48 @@
+<?php
+
+/**
+ * @file
+ * Hooks provided by the Comment module.
+ */
+
+use Drupal\comment\CommentInterface;
+use Drupal\Core\Url;
+
+/**
+ * @addtogroup hooks
+ * @{
+ */
+
+/**
+ * Alter the links of a comment.
+ *
+ * @param array &$links
+ *   A renderable array representing the comment links.
+ * @param \Drupal\comment\CommentInterface $entity
+ *   The comment being rendered.
+ * @param array &$context
+ *   Various aspects of the context in which the comment links are going to be
+ *   displayed, with the following keys:
+ *   - 'view_mode': the view mode in which the comment is being viewed
+ *   - 'langcode': the language in which the comment is being viewed
+ *   - 'commented_entity': the entity to which the comment is attached
+ *
+ * @see \Drupal\comment\CommentViewBuilder::renderLinks()
+ * @see \Drupal\comment\CommentViewBuilder::buildLinks()
+ */
+function hook_comment_links_alter(array &$links, CommentInterface $entity, array &$context) {
+  $links['mymodule'] = [
+    '#theme' => 'links__comment__mymodule',
+    '#attributes' => ['class' => ['links', 'inline']],
+    '#links' => [
+      'comment-report' => [
+        'title' => t('Report'),
+        'url' => Url::fromRoute('comment_test.report', ['comment' => $entity->id()], ['query' => ['token' => \Drupal::getContainer()->get('csrf_token')->get("comment/{$entity->id()}/report")]]),
+      ],
+    ],
+  ];
+}
+
+/**
+ * @} End of "addtogroup hooks".
+ */