forum-list.html.twig

Same filename in this branch
  1. 9 core/profiles/demo_umami/themes/umami/templates/classy/dataset/forum-list.html.twig
  2. 9 core/themes/olivero/templates/dataset/forum-list.html.twig
  3. 9 core/themes/seven/templates/classy/dataset/forum-list.html.twig
  4. 9 core/themes/claro/templates/classy/dataset/forum-list.html.twig
  5. 9 core/themes/bartik/templates/classy/dataset/forum-list.html.twig
  6. 9 core/themes/stable/templates/dataset/forum-list.html.twig
  7. 9 core/themes/classy/templates/dataset/forum-list.html.twig
  8. 9 core/modules/forum/templates/forum-list.html.twig
Same filename in other branches
  1. 8.9.x core/profiles/demo_umami/themes/umami/templates/classy/dataset/forum-list.html.twig
  2. 8.9.x core/themes/seven/templates/classy/dataset/forum-list.html.twig
  3. 8.9.x core/themes/claro/templates/classy/dataset/forum-list.html.twig
  4. 8.9.x core/themes/bartik/templates/classy/dataset/forum-list.html.twig
  5. 8.9.x core/themes/stable/templates/dataset/forum-list.html.twig
  6. 8.9.x core/themes/classy/templates/dataset/forum-list.html.twig
  7. 8.9.x core/modules/forum/templates/forum-list.html.twig
  8. 10 core/profiles/demo_umami/themes/umami/templates/classy/dataset/forum-list.html.twig
  9. 10 core/themes/olivero/templates/dataset/forum-list.html.twig
  10. 10 core/themes/stable9/templates/dataset/forum-list.html.twig
  11. 10 core/themes/claro/templates/classy/dataset/forum-list.html.twig
  12. 10 core/modules/forum/templates/forum-list.html.twig
  13. 11.x core/profiles/demo_umami/themes/umami/templates/classy/dataset/forum-list.html.twig
  14. 11.x core/themes/olivero/templates/dataset/forum-list.html.twig
  15. 11.x core/themes/stable9/templates/dataset/forum-list.html.twig
  16. 11.x core/themes/claro/templates/classy/dataset/forum-list.html.twig
  17. 11.x core/modules/forum/templates/forum-list.html.twig

Theme override to display a list of forums and containers.

Available variables:

  • forums: A collection of forums and containers to display. It is keyed to the numeric IDs of all child forums and containers. Each forum in forums contains:

    • is_container: A flag indicating if the forum can contain other forums. Otherwise, the forum can only contain topics.
    • depth: How deep the forum is in the current hierarchy.
    • zebra: 'even' or 'odd', used for row class.
    • icon_class: 'default' or 'new', used for forum icon class.
    • icon_title: Text alternative for the forum icon.
    • name: The name of the forum.
    • link: The URL to link to this forum.
    • description: The description field for the forum, containing:
      • value: The descriptive text for the forum.
    • new_topics: A flag indicating if the forum contains unread posts.
    • new_url: A URL to the forum's unread posts.
    • new_text: Text for the above URL, which tells how many new posts.
    • old_topics: A count of posts that have already been read.
    • num_posts: The total number of posts in the forum.
    • last_reply: Text representing the last time a forum was posted or commented in.
  • forum_id: Forum ID for the current forum. Parent to all items within the forums array.

See also

template_preprocess_forum_list()

1 theme call to forum-list.html.twig
template_preprocess_forums in core/modules/forum/forum.module
Prepares variables for forums templates.

File

core/themes/stable9/templates/dataset/forum-list.html.twig

View source
  1. {#
  2. /**
  3. * @file
  4. * Theme override to display a list of forums and containers.
  5. *
  6. * Available variables:
  7. * - forums: A collection of forums and containers to display. It is keyed to
  8. * the numeric IDs of all child forums and containers. Each forum in forums
  9. * contains:
  10. * - is_container: A flag indicating if the forum can contain other
  11. * forums. Otherwise, the forum can only contain topics.
  12. * - depth: How deep the forum is in the current hierarchy.
  13. * - zebra: 'even' or 'odd', used for row class.
  14. * - icon_class: 'default' or 'new', used for forum icon class.
  15. * - icon_title: Text alternative for the forum icon.
  16. * - name: The name of the forum.
  17. * - link: The URL to link to this forum.
  18. * - description: The description field for the forum, containing:
  19. * - value: The descriptive text for the forum.
  20. * - new_topics: A flag indicating if the forum contains unread posts.
  21. * - new_url: A URL to the forum's unread posts.
  22. * - new_text: Text for the above URL, which tells how many new posts.
  23. * - old_topics: A count of posts that have already been read.
  24. * - num_posts: The total number of posts in the forum.
  25. * - last_reply: Text representing the last time a forum was posted or
  26. * commented in.
  27. * - forum_id: Forum ID for the current forum. Parent to all items within the
  28. * forums array.
  29. *
  30. * @see template_preprocess_forum_list()
  31. */
  32. #}
  33. <table>
  34. <thead>
  35. <tr>
  36. <th>{{ 'Forum'|t }}</th>
  37. <th>{{ 'Topics'|t }}</th>
  38. <th>{{ 'Posts'|t }}</th>
  39. <th>{{ 'Last post'|t }}</th>
  40. </tr>
  41. </thead>
  42. <tbody>
  43. {% for child_id, forum in forums %}
  44. <tr>
  45. <td{% if forum.is_container == true %} colspan="4"{% endif %}>
  46. {#
  47. Enclose the contents of this cell with X divs, where X is the
  48. depth this forum resides at. This will allow us to use CSS
  49. left-margin for indenting.
  50. #}
  51. {% if forum.depth > 0 %}{% for i in 1..forum.depth %}<div class="indent">{% endfor %}{% endif %}
  52. <div title="{{ forum.icon_title }}">
  53. <span class="visually-hidden">{{ forum.icon_title }}</span>
  54. </div>
  55. <div><a href="{{ forum.link }}">{{ forum.label }}</a></div>
  56. {% if forum.description.value %}
  57. <div>{{ forum.description.value }}</div>
  58. {% endif %}
  59. {% if forum.depth > 0 %}{% for i in 1..forum.depth %}</div>{% endfor %}{% endif %}
  60. </td>
  61. {% if forum.is_container == false %}
  62. <td>
  63. {{ forum.num_topics }}
  64. {% if forum.new_topics == true %}
  65. <br />
  66. <a href="{{ forum.new_url }}">{{ forum.new_text }}</a>
  67. {% endif %}
  68. </td>
  69. <td>{{ forum.num_posts }}</td>
  70. <td>{{ forum.last_reply }}</td>
  71. {% endif %}
  72. </tr>
  73. {% endfor %}
  74. </tbody>
  75. </table>

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.