faq-8.x-1.0-alpha1/templates/faq-category-questions-top.html.twig

{#
/**
 * @file
 * Template file for the questions section of the FAQ page if set to show
 * categorized questions at the top of the page.
 * 
 * Available variables:
 * - display_header: Boolean value controlling whether a header should be displayed.
 * - header_title: The category title.
 * - category_name: The name of the category.
 * - answer_category_name: Whether the category name should be displayed with the answers.
 * - group_questions_top: Whether the questions and answers should be grouped together.
 * - category_depth: The term or category depth.
 * - description: The current page's description.
 * - term_image: The HTML for the category image. This is empty if the taxonomy image module 
 *   is not enabled or there is no image associated with the term.
 * - display_faq_count: Boolean value controlling whether or not the number of faqs in a category should be displayed.
 * - question_count: The number of questions in category.
 * - nodes: The array of nodes to be displayed. Each node stored in the $nodes array has the following information:
 *   - question: The question text.
 *   - body: The answer text.
 *   - links: Represents the node links, e.g. "Read more".
 * - use_teaser: Tells whether node.body contains the full body or just the teaser
 * - container_class: The class attribute of the element containing the sub-categories, either 'faq-qa' or 'faq-qa-hide'. 
 *   This is used by javascript to open/hide a category's faqs.
 * - question_list: An array of question links.
 * - question_list_style: The style of the question list, ul for unordered, ol for ordered.
 * - subcat_list: An array of sub-categories.  Each sub-category stored in the subcat_list array has the following information:
 *   - subcat.link: The link to the sub-category.
 *   - subcat.description: The sub-category description.
 *   - subcat.count: The number of questions in the sub-category.
 *   - subcat.term_image: The sub-category (taxonomy) image.
 * - subcat_list_style: The style of the sub-category list, either ol or ul (ordered or unordered).
 * - subcat_body_list: The sub-categories faqs, recursively themed (by this template).
 * 
 * @see template_preprocess_faq_category_questions_top()
 * 
 * @ingroup themable
 */
#}

{% if category_depth > 0 %}
    {% set hdr = 'h4' %}
{% else %}
    {% set hdr = 'h3' %}
{% endif %}

<a id="top"></a>
<div class="faq-category-menu">
    <!-- category header with title, link, image, description, and count of questions inside -->
    <div class="faq-qa-header">
        {% if display_header %}
            <{{ hdr }} class="faq-header">
                {{ term_image }}
                {{ header_title }}
                {% if display_faq_count %}
                    ({{ question_count }})
                {% endif %}
            </{{ hdr }}>
        {% else %}
            {{ term_image }}
        {% endif %}
        {% if description is not empty %}
            <div class="faq-qa-description">{{ description }}</div>
        {% endif %}
        {% if term_image is not empty %}
            <div class="clear-block"></div>
        {% endif %}
    </div><!-- Close div: faq-qa-header -->
    
    {% if subcat_list is not empty %}
        <!-- list subcategories, with title, link, description, count -->
        <div class="item-list">
            <{{ subcat_list_style }} class="faq-category-list">
            {% for subcat in subcat_list %}
                <li>
                    {{ subcat.link }}
                    {% if display_faq_count %}
                        ({{ subcat.count }})
                    {% endif %}
                    {% if subcat.description is not empty %}
                        <div class="faq-qa-description">{{ subcat.description }}</div>
                    {% endif %}
                    <div class="clear-block"></div>
                </li>
            {% endfor %}
            </{{ subcat_list_style }}>
        </div>
    {% endif %}
    
    <div class="{{ container_class }}">
        {% if subcat_body_list|length > 0 %}
        {% for subcat_html in subcat_body_list %}
            <div class="faq-category-indent">{{ subcat_html }}</div>
        {% endfor %}
        {% endif %}
        
        {# list question links #}
        {% if question_list is not empty %}
            <div class="item-list">
                <{{ question_list_style }} class="faq-ul-questions-top">
                    {% for question_link in question_list %}
                        <li>
                            {{ question_link }}
                        </li>
                    {% endfor %}
                </{{ question_list_style }}>
            </div>
        {% endif %}
        
{% if not group_questions_top or category_display != 'hide_qa' %}
    </div> <!-- Close div: faq-qa / faq-qa-hide -->
</div> <!-- Close div: faq-category-menu -->
{% endif %}
        
        {% if answer_category_name %}
            <!-- Display header before answers in some layouts. -->
            <{{ hdr }} class="faq-header">
                {{ term_image }}
                {{ category_name }}
            </{{ hdr }}>
            <div class="clear-block"></div>
        {% endif %}
        
        {# List questions (in title link) and answers (in body). #}
        <div class="faq-category-group">
            <div>
                {% if nodes|length > 0 %}
                {% for node in nodes %}
                    <div class="faq-question">
                        {% if question_label is not empty %}
                            <strong class="faq-question-label">
                                {{ question_label}}
                            </strong>
                        {% endif %}
                        {{ node.question }}
                    </div><!-- Close div: faq-question -->
                    
                    <div class="faq-answer">
                        {% if answer_label is not empty %}
                            <strong class="faq-answer-label">
                                {{ answer_label }}
                            </strong>
                        {% endif %}
                        {{ node.body }}
                        {% if node.links is defined %}
                            {{ node.links }}
                        {% endif %}
                    </div><!-- Close div: faq-answer -->
                {% endfor %}
                {% endif %}
            </div><!-- Close div -->
        </div><!-- Close div: faq-category-group -->
{% if group_questions_top and category_display == 'hide_qa' %}
    </div> <!-- Close div: faq-qa / faq-qa-hide -->
</div> <!-- Close div: faq-category-menu -->
{% endif %}