Skip to content

A platform for community discussion. Free, open, simple.

17.9 KB
Raw Blame
import {
  click,
  currentURL,
  fillIn,
  focus,
  triggerKeyEvent,
  visit,
} from "@ember/test-helpers";
import { test } from "qunit";
import { cloneJSON } from "discourse/lib/object";
import Category from "discourse/models/category";
import PermissionType from "discourse/models/permission-type";
import { PLATFORM_KEY_MODIFIER } from "discourse/services/keyboard-shortcuts";
import topicFixtures from "discourse/tests/fixtures/topic";
import { acceptance } from "discourse/tests/helpers/qunit-helpers";
import selectKit from "discourse/tests/helpers/select-kit-helper";
import { i18n } from "discourse-i18n";
import TemplatesFixtures from "../fixtures/templates-fixtures.js";

function templatesPretender(server, helper) {
  const repliesPath = "/discourse_templates";
  const replies = TemplatesFixtures[repliesPath];

  server.get(repliesPath, () => helper.response(replies));
  replies.templates.forEach((template) =>
    server.post(`${repliesPath}/${template.id}/use`, () => helper.response({}))
  );
}

async function selectCategory() {
  const categoryChooser = selectKit(".category-chooser");
  await categoryChooser.expand();
  await categoryChooser.selectRowByValue(2);
}

function categoryFixture(attrs) {
  return {
    color: "0088CC",
    name: attrs.slug,
    permission: PermissionType.FULL,
    read_restricted: false,
    text_color: "FFFFFF",
    topic_count: 1,
    ...attrs,
  };
}

acceptance("discourse-templates", function (needs) {
  needs.settings({
    discourse_templates_enabled: true,
    allow_uncategorized_topics: true,
    tagging_enabled: true,
  });
  needs.user({
    can_use_templates: true,
  });

  needs.pretender(templatesPretender);

  test("Filtering by tags", async function (assert) {
    await visit("/");

    await click("#create-topic");
    await selectCategory();
    await click(".toolbar-menu__options-trigger");
    await click(`button[title="${i18n("templates.insert_template")}"]`);

    const tagDropdown = selectKit(".templates-filter-bar .tag-drop");
    await tagDropdown.expand();

    await tagDropdown.fillInFilter(
      "cupcake",
      ".templates-filter-bar .tag-drop input"
    );
    assert.deepEqual(
      tagDropdown.displayedContent(),
      [
        {
          name: "cupcakes",
          id: "cupcakes",
        },
      ],
      "filters tags in the dropdown"
    );

    await tagDropdown.selectRowByIndex(0);
    assert
      .dom(".templates-list .template-item")
      .exists({ count: 1 }, "filters replies by tag");

    await click("#template-item-1 .templates-apply");

    assert
      .dom(".d-editor-input")
      .includesValue(
        "Cupcake ipsum dolor sit amet cotton candy cheesecake jelly. Candy canes sugar plum soufflé sweet roll jelly-o danish jelly muffin. I love jelly-o powder topping carrot cake toffee.",
        "inserts the template in the composer"
      );
  });

  test("Filtering by text", async function (assert) {
    await visit("/");

    await click("#create-topic");
    await selectCategory();
    await click(".toolbar-menu__options-trigger");
    await click(`button[title="${i18n("templates.insert_template")}"]`);

    await fillIn(".templates-filter-bar input.templates-filter", "test");
    assert
      .dom(".templates-list .template-item")
      .exists({ count: 2 }, "filters by text");

    await click("#template-item-8 .templates-apply");

    assert
      .dom(".d-editor-input")
      .includesValue(
        "Testing testin **123**",
        "inserts the template in the composer"
      );
  });

  test("Replacing variables", async function (assert) {
    await visit("/");

    await click("#create-topic");
    await selectCategory();
    await click(".toolbar-menu__options-trigger");
    await click(`button[title="${i18n("templates.insert_template")}"]`);

    await click("#template-item-9 .templates-apply");

    assert
      .dom(".d-editor-input")
      .includesValue("Hi there, regards eviltrout.", "replaces variables");
  });

  test("Navigate to source", async function (assert) {
    await visit("/");

    await click("#create-topic");
    await selectCategory();
    await click(".toolbar-menu__options-trigger");
    await click(`button[title="${i18n("templates.insert_template")}"]`);

    const tagDropdown = selectKit(".templates-filter-bar .tag-drop");
    await tagDropdown.expand();

    await tagDropdown.fillInFilter(
      "lorem",
      ".templates-filter-bar .tag-drop input"
    );
    assert.deepEqual(
      tagDropdown.displayedContent(),
      [
        {
          name: "lorem",
          id: "lorem",
        },
      ],
      "filters tags in the dropdown"
    );

    await tagDropdown.selectRowByIndex(0);
    assert
      .dom(".templates-list .template-item")
      .exists({ count: 1 }, "filters replies by tag");

    await click("#template-item-130 .template-item-title");
    await click("#template-item-130 .template-item-source-link");

    assert.strictEqual(
      currentURL(),
      "/t/lorem-ipsum-dolor-sit-amet/130",
      "navigates to the source"
    );
  });

  test("Has ordering by relevance, usage, and title", async function (assert) {
    await visit("/");

    await click("#create-topic");
    await selectCategory();
    await click(".toolbar-menu__options-trigger");
    await click(`button[title="${i18n("templates.insert_template")}"]`);

    await fillIn(".templates-filter-bar input.templates-filter", "ipsum");
    const templateItems = document.querySelectorAll(
      ".templates-list .template-item-title-text"
    );
    const titles = Array.from(templateItems).map((el) => el.textContent.trim());

    assert.deepEqual(
      titles,
      [
        "Cupcake Ipsum excerpt",
        "Hipster ipsum excerpt",
        "Liquor ipsum excerpt",
        "Mussum Ipsum excerpt",
        "Lorem ipsum dolor sit amet",
      ],
      "orders templates by relevance, usage, and title"
    );
  });

  test("Remembers selected tag between openings", async function (assert) {
    await visit("/");

    await click("#create-topic");
    await selectCategory();
    await click(".toolbar-menu__options-trigger");
    await click(`button[title="${i18n("templates.insert_template")}"]`);

    const tagDropdown = selectKit(".templates-filter-bar .tag-drop");
    await tagDropdown.expand();

    await tagDropdown.fillInFilter(
      "cupcake",
      ".templates-filter-bar .tag-drop input"
    );
    await tagDropdown.selectRowByIndex(0);
    assert.dom(".templates-list .template-item").exists({ count: 1 });

    await click("#reply-control .toggle-save-and-close");

    await click("#create-topic");
    await selectCategory();
    await click(".toolbar-menu__options-trigger");
    await click(`button[title="${i18n("templates.insert_template")}"]`);
    assert
      .dom(".templates-list .template-item")
      .exists({ count: 1 }, "preserves selected tag across composer sessions");
  });
});

acceptance("with tags disabled in Settings", function (needs) {
  needs.settings({
    discourse_templates_enabled: true,
    tagging_enabled: false,
  });
  needs.user({
    can_use_templates: true,
  });

  needs.pretender(templatesPretender);

  test("Filtering by tags", async function (assert) {
    await visit("/");

    await click("#create-topic");
    await selectCategory();
    await click(".toolbar-menu__options-trigger");
    await click(`button[title="${i18n("templates.insert_template")}"]`);

    assert
      .dom(".templates-filter-bar .tag-drop")
      .doesNotExist("tag drop down is not displayed");
  });
});

acceptance("keyboard shortcut", function (needs) {
  needs.settings({
    discourse_templates_enabled: true,
    tagging_enabled: true,
  });
  needs.user({
    can_use_templates: true,
  });

  needs.pretender(templatesPretender);

  const triggerKeyboardShortcut = async () => {
    // Testing keyboard events is tough!
    const isMac = PLATFORM_KEY_MODIFIER.toLowerCase() === "meta";
    await triggerKeyEvent(document, "keydown", "I", {
      ...(isMac ? { metaKey: true } : { ctrlKey: true }),
      shiftKey: true,
    });
  };

  const assertTemplateWasInserted = async (assert, selector) => {
    const tagDropdown = selectKit(".templates-filter-bar .tag-drop");
    await tagDropdown.expand();

    await tagDropdown.fillInFilter(
      "cupcake",
      ".templates-filter-bar .tag-drop input"
    );
    await tagDropdown.selectRowByIndex(0);
    await click("#template-item-1 .templates-apply");

    assert
      .dom(selector)
      .includesValue(
        "Cupcake ipsum dolor sit amet cotton candy cheesecake jelly. Candy canes sugar plum soufflé sweet roll jelly-o danish jelly muffin. I love jelly-o powder topping carrot cake toffee.",
        "inserts the template in the textarea"
      );
  };

  test("Help | Added shortcut to help modal", async function (assert) {
    await visit("/");
    await triggerKeyEvent(document, "keypress", "?".charCodeAt(0));

    assert.dom(".shortcut-category-templates").exists();
    assert.dom(".shortcut-category-templates tbody tr").exists({ count: 1 });
  });

  test("Composer | Title field focused | Template is inserted", async function (assert) {
    await visit("/");

    await click("#create-topic");
    await selectCategory();

    await triggerKeyboardShortcut();
    await assertTemplateWasInserted(assert, ".d-editor-input");
  });

  test("Composer | Textarea focused | Template is inserted", async function (assert) {
    await visit("/");

    await click("#create-topic");
    await selectCategory();

    await focus(".d-editor-input");

    await triggerKeyboardShortcut();
    await assertTemplateWasInserted(assert, ".d-editor-input");
  });

  test("Modal | Templates modal | Show the modal if the preview is hidden", async function (assert) {
    await visit("/");

    await click("#create-topic");
    await selectCategory();

    await click(".toggle-preview");

    await focus(".d-editor-input");

    await triggerKeyboardShortcut();
    assert
      .dom(".d-modal.d-templates")
      .exists("displays the standard templates modal");
  });

  test("Modal | Templates modal | Show the modal if a textarea is focused", async function (assert) {
    // if the text area is outside a modal then simply show the insert template modal
    // because there is no need to hijack
    await visit("/u/charlie/preferences/profile");

    await focus(".d-editor-input");

    await triggerKeyboardShortcut();
    assert
      .dom(".d-modal.d-templates")
      .exists("displays the standard templates modal");
  });

  test("Modal | Templates modal | Template is inserted", async function (assert) {
    await visit("/u/charlie/preferences/profile");

    await focus(".d-editor-input");

    await triggerKeyboardShortcut();
    await assertTemplateWasInserted(assert, ".d-editor-input");
  });

  test("Modal | Templates modal | Template is inserted", async function (assert) {
    await visit("/u/charlie/preferences/profile");

    await focus(".d-editor-input");

    await triggerKeyboardShortcut();

    const tagDropdown = selectKit(".templates-filter-bar .tag-drop");
    await tagDropdown.expand();

    await tagDropdown.fillInFilter(
      "lorem",
      ".templates-filter-bar .tag-drop input"
    );
    assert.deepEqual(
      tagDropdown.displayedContent(),
      [
        {
          name: "lorem",
          id: "lorem",
        },
      ],
      "filters tags in the dropdown"
    );

    await tagDropdown.selectRowByIndex(0);
    assert
      .dom(".templates-list .template-item")
      .exists({ count: 1 }, "filters replies by tag");

    await click("#template-item-130 .template-item-title");
    await click("#template-item-130 .template-item-source-link");

    assert.strictEqual(
      currentURL(),
      "/t/lorem-ipsum-dolor-sit-amet/130",
      "navigates to the source"
    );
  });

  test("Modal | Templates Modal | Stacked Modals | Template is inserted", async function (assert) {
    await visit("/t/topic-for-group-moderators/2480");
    await click(".show-more-actions");
    await click(".show-post-admin-menu");
    await click(".add-notice");

    await focus(".d-modal__body textarea");

    await triggerKeyboardShortcut();
    await assertTemplateWasInserted(assert, ".d-modal__body textarea");
  });

  test("Modal | Templates Modal | Stacked Modals | Closing the template modal returns the focus to the original modal textarea", async function (assert) {
    await visit("/t/topic-for-group-moderators/2480");
    await click(".show-more-actions");
    await click(".show-post-admin-menu");
    await click(".add-notice");

    await focus(".d-modal__body textarea");
    assert
      .dom(".d-templates-modal")
      .doesNotExist("the templates modal does not exist yet");
    await triggerKeyboardShortcut();
    assert.dom(".d-templates-modal").exists("displays the templates modal");

    await click(".d-templates-modal .btn.modal-close");
    assert
      .dom(".d-modal__body textarea")
      .isFocused(
        "focuses the original textarea again after closing the templates modal"
      );
  });
});

acceptance("buttons on topics", function (needs) {
  let categoriesBySlugPath;
  let categoryFindRequests;
  let templateBody;
  let templateCategory;

  needs.user();
  needs.site({ can_tag_topics: true });
  needs.settings({
    allow_uncategorized_topics: true,
    tagging_enabled: true,
  });
  needs.hooks.beforeEach(() => {
    categoriesBySlugPath = {};
    categoryFindRequests = [];
    templateBody = "post raw content";
    templateCategory = "dev";
  });

  needs.pretender((server, helper) => {
    const topicResponse = cloneJSON(topicFixtures["/t/280/1.json"]);
    topicResponse.is_template = true;

    server.get("/t/280.json", () => helper.response(topicResponse));
    server.get("/raw/280/1", () => [
      200,
      {},
      `<!-- discourse-template
category: ${templateCategory}
tags: security, minor-security-fix
-->

${templateBody}`,
    ]);
    server.get("/categories/find", (request) => {
      categoryFindRequests.push(request.queryParams);

      const categories = categoriesBySlugPath[request.queryParams.slug_path];

      if (categories) {
        return helper.response({ categories });
      }

      return helper.response(404, {});
    });
  });

  test("Can open composer using button on topic", async function (assert) {
    await visit("/t/280");
    Category.findById(7).set("permission", PermissionType.FULL);

    await click(".template-new-topic");
    assert
      .dom("textarea.d-editor-input")
      .hasValue("post raw content", "uses the raw template content");

    const categoryChooser = selectKit(".category-chooser");
    assert.strictEqual(
      categoryChooser.header().value(),
      "7",
      "selects the category from the template options"
    );

    const tags = selectKit(".mini-tag-chooser");
    assert.strictEqual(
      tags.header().value(),
      "security,minor-security-fix",
      "selects the tags from the template options"
    );
  });

  test("Does not select a category the user cannot create topics in", async function (assert) {
    await visit("/t/280");
    Category.findById(7).set("permission", PermissionType.READONLY);

    await click(".template-new-topic");

    const categoryChooser = selectKit(".category-chooser");
    assert.notStrictEqual(
      categoryChooser.header().value(),
      "7",
      "does not select the category from the template options"
    );

    const tags = selectKit(".mini-tag-chooser");
    assert.strictEqual(
      tags.header().value(),
      "security,minor-security-fix",
      "still selects allowed tags from the template options"
    );
  });

  test("Ignores an invalid category in template options", async function (assert) {
    templateCategory = "not-a-real-category";

    await visit("/t/280");

    await click(".template-new-topic");

    assert
      .dom("textarea.d-editor-input")
      .hasValue("post raw content", "still opens the composer");

    const categoryChooser = selectKit(".category-chooser");
    assert.notStrictEqual(
      categoryChooser.header().value(),
      "7",
      "does not select the invalid category"
    );

    const tags = selectKit(".mini-tag-chooser");
    assert.strictEqual(
      tags.header().value(),
      "security,minor-security-fix",
      "still selects tags from the template options"
    );
  });

  test("Selects a category that is loaded asynchronously", async function (assert) {
    templateCategory = "async-category";
    categoriesBySlugPath["async-category"] = [
      categoryFixture({
        id: 30,
        name: "Async category",
        slug: "async-category",
      }),
    ];

    await visit("/t/280");

    await click(".template-new-topic");

    assert.deepEqual(
      categoryFindRequests,
      [{ slug_path: "async-category" }],
      "loads the category by slug path"
    );

    const categoryChooser = selectKit(".category-chooser");
    assert.strictEqual(
      categoryChooser.header().value(),
      "30",
      "selects the asynchronously loaded category"
    );
  });

  test("Selects a subcategory that is loaded asynchronously", async function (assert) {
    templateCategory = "async-parent/async-child";
    categoriesBySlugPath["async-parent/async-child"] = [
      categoryFixture({
        id: 30,
        name: "Async parent",
        slug: "async-parent",
      }),
      categoryFixture({
        id: 31,
        name: "Async child",
        parent_category_id: 30,
        slug: "async-child",
      }),
    ];

    await visit("/t/280");

    await click(".template-new-topic");

    assert.deepEqual(
      categoryFindRequests,
      [{ slug_path: "async-parent/async-child" }],
      "loads the subcategory by slug path"
    );

    const categoryChooser = selectKit(".category-chooser");
    assert.strictEqual(
      categoryChooser.header().value(),
      "31",
      "selects the asynchronously loaded subcategory"
    );
  });

  test("Preserves body indentation after template options", async function (assert) {
    templateBody = "    indented raw content";

    await visit("/t/280");

    await click(".template-new-topic");

    assert
      .dom("textarea.d-editor-input")
      .hasValue(
        "    indented raw content",
        "preserves intentional leading indentation"
      );
  });
});