Page MenuHomePhabricator

Information about the communities nominated collections visible on the CX dashboard.
Open, HighPublic4 Estimated Story Points

Description

Goal

Inform editors of the fact that the community has designated important collections to work on when they land on the Content Translation dashboard.

Design

UX Points: Community vital collection information banner

Visibility
  • Banner appears when vital collection filter is active
  • Since vital collection is auto-selected by default, banner appears on dashboard load
  • Banner hides when user switches to different filter
  • Description text truncated to 2 lines by default, expandable via inline "more/less" links
Banner Content

Note: These are initial points to consider. Final content and structure will be determined based on community discussions and feedback.

Screenshot 2025-11-11 at 11.50.54 PM.png (1×3 px, 353 KB)
Screenshot 2025-11-11 at 11.51.01 PM.png (1×3 px, 431 KB)

Banner Header:

  • Icon: Community icon (user group)
  • Primary label: "Community Priorities"
  • Secondary label: "From [Target Language] Wikipedia"
    • Dynamically updates based on user's selected target language
    • Displays language in native script (e.g., "From हिन्दी Wikipedia")

Banner Content:

    • Community-provided description with 2-line truncation
      • Default: Shows 2 lines with "... more" link at end
      • Expanded: Shows full text with "less" link inline
  • "Learn more" external link (only visible when description expanded)
Placement
  • Positioned directly below filter chips
  • Above suggestions list
Collection chips
  • Collection badges hidden on suggestion cards when that collection is the active filter
  • Prevents redundant display since all visible suggestions are from the same collection
Responsive Behavior

All viewports:

  • Banner always visible with description truncated to 2 lines
  • User can expand/collapse description inline via "more/less" links
Visual Design

Screenshot 2025-11-11 at 11.50.54 PM.png (1×3 px, 353 KB)

Style:

  • Uses Codex design tokens throughout for colors, spacing, typography
  • Background: @background-color-interactive-subtle
  • Top border only: @border-color-subtle
  • Standard border radius

Typography:

  • Primary label: @font-size-medium, @font-weight-bold, @color-base
  • Secondary label: @font-size-small, @color-subtle
  • "more/less" links: @font-size-medium, @font-weight-bold, @color-progressive
  • Description: @font-size-medium, @color-base
  • Link: @font-size-small, @font-weight-bold, @color-progressive

Responsive Spacing:

  • Desktop: @spacing-100
  • Tablet: @spacing-75
  • Mobile: @spacing-50
Answered questions

Is it always visible or only when a nominated collection is selected?
Only visible when a vital collection filter is selected. Since vital collections are auto-selected by default (when available), users typically see it on page load.

Does it include text provided by the community?
Yes, the banner displays community-provided description explaining why they nominated this collection.

Fallback text if community doesn't provide description?
"This collection contains articles the community has identified as vital knowledge. Translating them helps make essential information available to more readers."

Should banner be dismissible?
No. Description is expandable (users can show more/less text inline).

Is Meta-Wiki link always required?
Optional. If provided, appears as "Learn more" link with external link icon. If not provided, link section is hidden.

What's the recommended length for community-provided descriptions?
Recommended: 400-500 characters (approximately 4-5 lines on most viewports). This allows communities to explain context and motivation while keeping the UI manageable with the 2-line truncation.


Community Configuration

Description: max 500 characters, display as a <textarea> if possible
Link: any valid link to a Wiki page

Derived Requirement

Ensure that editors are informed about community-nominated vital collections through a contextual information banner on the Content Translation dashboard, such that the banner appears only when a vital collection filter is active, displays community-provided or fallback descriptive content, dynamically reflects the selected target language, and adapts its visibility and content behavior based on user interactions with filters and banner controls.

Test Steps

Test Case 1: Display banner when vital collection filter is active by default

  1. Open the Content Translation dashboard on beta.
  2. Ensure a language pair is selected where a vital collection is available.
  3. Observe the dashboard on initial page load.
  4. ✅❓❌⬜ AC1: Confirm that the community information banner is visible when the vital collection filter is auto-selected by default.

Test Case 2: Hide banner when switching away from vital collection filter

  1. From the Content Translation dashboard with the banner visible, switch to a non-vital collection filter.
  2. Observe the area below the filter chips.
  3. ✅❓❌⬜ AC2: Confirm that the community information banner is no longer visible when a different filter is selected.

Test Case 3: Display community-provided description or fallback text

  1. Open the Content Translation dashboard for a target language with a vital collection that has a community-provided description.
  2. Observe the banner description text.
  3. Switch to a target language whose vital collection has no community-provided description configured.
  4. Observe the banner description text again.
  5. ✅❓❌⬜ AC3: Confirm that the banner displays the community-provided description when available, and displays the fallback text when no description is provided.

Test Case 4: Truncate and expand community description content

  1. With the banner visible, observe the description text on initial load.
  2. Select the inline "more" link.
  3. Observe the expanded description.
  4. Select the inline "less" link.
  5. ✅❓❌⬜ AC4: Confirm that the description is truncated to two lines by default, expands to show the full text when "more" is selected, and collapses back to two lines when "less" is selected.

Test Case 5: Conditionally display the external "Learn more" link

  1. Open the Content Translation dashboard for a vital collection that has an external link configured.
  2. Expand the banner description.
  3. Observe the presence of the "Learn more" link.
  4. Repeat steps 1–3 for a vital collection without an external link configured.
  5. ✅❓❌⬜ AC5: Confirm that the "Learn more" link is visible only when a link is configured and the description is expanded, and hidden otherwise.

Test Case 6: Update banner language label based on selected target language

  1. Open the Content Translation dashboard with the vital collection banner visible.
  2. Note the secondary label indicating the source wiki language.
  3. Change the target language to another language with a vital collection.
  4. Observe the secondary label again.
  5. ✅❓❌⬜ AC6: Confirm that the banner’s secondary label dynamically updates to reflect the selected target language and displays the language name in its native script.

Test Case 7: Hide collection badges on suggestion cards when vital collection filter is active

  1. Open the Content Translation dashboard with the vital collection filter active.
  2. Observe the suggestion cards in the list.
  3. Switch to a non-vital collection filter.
  4. Observe the suggestion cards again.
  5. ✅❓❌⬜ AC7: Confirm that collection badges are hidden on suggestion cards when the active filter is the vital collection, and visible again when a different filter is selected.

QA Results - TestWiki

Event Timeline

SBisson triaged this task as High priority.
SBisson moved this task from Needs Triage to Dashboard on the ContentTranslation board.
SBisson moved this task from Incoming to In-progress on the LPL Hypothesis board.
SBisson updated the task description. (Show Details)
Nikerabbit set the point value for this task to 4.Nov 17 2025, 2:23 PM

Change #1204990 had a related patch set uploaded (by Eamedina; author: Eamedina):

[mediawiki/extensions/ContentTranslation@master] CX: Featured collection banner

https://gerrit.wikimedia.org/r/1204990

Secondary label: "From [Target Language] Wikipedia"
Dynamically updates based on user's selected target language
Displays language in native script (e.g., "From हिन्दी Wikipedia")

This does not work at all in some languages, and even in English it looks weird. @SGautam_WMF I think we need to find some alternative that works better for all languages.

E.g. in Finnish this would be "Suomenkielisestä Wikipediasta" or "Suomenkielisen Wikipedian suositus" but the parameter would be "suomi" for message like "$1 Wikipediasta".

Secondary label: "From [Target Language] Wikipedia"
Dynamically updates based on user's selected target language
Displays language in native script (e.g., "From हिन्दी Wikipedia")

This does not work at all in some languages, and even in English it looks weird. @SGautam_WMF I think we need to find some alternative that works better for all languages.

E.g. in Finnish this would be "Suomenkielisestä Wikipediasta" or "Suomenkielisen Wikipedian suositus" but the parameter would be "suomi" for message like "$1 Wikipediasta".

Thanks @Nikerabbit, how about we use native Wikipedia name? Like "हिन्दी विकिपीडिया" but without "From" if not, I think then we can even consider removing secondary label entirely

Thanks @Nikerabbit, how about we use native Wikipedia name? Like "हिन्दी विकिपीडिया" but without "From" if not, I think then we can even consider removing secondary label entirely

That is okay in my opinion, as long as it is technically possible to re-use the existing project name translations.

Change #1204990 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] CX: Featured collection banner

https://gerrit.wikimedia.org/r/1204990

Change #1207239 had a related patch set uploaded (by Eamedina; author: Eamedina):

[mediawiki/extensions/ContentTranslation@master] CX: minor followup up to featured collection banner

https://gerrit.wikimedia.org/r/1207239

"Learn more" external link (only visible when description expanded)

One quick clarification regarding this point: if the screen is wide enough to not need text truncation, should the "Learn more" link still be visible (if provided by user)?

TruncatedExpandedWide-enough screen
image.png (1×1 px, 213 KB)
image.png (1×1 px, 220 KB)
image.png (1×1 px, 243 KB)

Change #1207239 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] CX: minor followup up to featured collection banner

https://gerrit.wikimedia.org/r/1207239

Change #1207249 had a related patch set uploaded (by Sbisson; author: Sbisson):

[mediawiki/extensions/ContentTranslation@master] Show collection ships only for 'all collections' filters

https://gerrit.wikimedia.org/r/1207249

Change #1207249 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] Show collection chips only for 'all collections' filters

https://gerrit.wikimedia.org/r/1207249

"Learn more" external link (only visible when description expanded)

One quick clarification regarding this point: if the screen is wide enough to not need text truncation, should the "Learn more" link still be visible (if provided by user)?

TruncatedExpandedWide-enough screen
image.png (1×1 px, 213 KB)
image.png (1×1 px, 220 KB)
image.png (1×1 px, 243 KB)

Yes, then we can show it there

Change #1208412 had a related patch set uploaded (by Eamedina; author: Eamedina):

[mediawiki/extensions/ContentTranslation@master] CX: featured collection banner followup

https://gerrit.wikimedia.org/r/1208412

Change #1208412 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] CX: featured collection banner followup

https://gerrit.wikimedia.org/r/1208412

Change #1210670 had a related patch set uploaded (by Eamedina; author: Eamedina):

[mediawiki/extensions/ContentTranslation@master] CX3 Build 1.0.0+20251124

https://gerrit.wikimedia.org/r/1210670

Change #1210682 had a related patch set uploaded (by Sbisson; author: Sbisson):

[mediawiki/extensions/ContentTranslation@master] Increase specificity of learn more icon style

https://gerrit.wikimedia.org/r/1210682

Change #1210682 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] Increase specificity of learn more icon style

https://gerrit.wikimedia.org/r/1210682

Change #1210670 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] CX3 Build 1.0.0+20251124

https://gerrit.wikimedia.org/r/1210670

@eamedina Confirmed Information about the communities nominated collections visible on the CX dashboard, as seen in the videos and screenshot. I will move this to Sign-off. Thanks for all your work!

Test Result - TestWiki

Status: ✅ PASS
Environment: TestWiki
OS: macOS Tahoe 26.1
Browser: Chrome 143
Device: MBA
Emulated Device: NA

Test Artifact(s):
https://test.wikipedia.org/w/index.php?title=Special:ContentTranslation&active-list=suggestions&filter-id=Software&filter-type=collections&from=ha&to=en#/
https://test.wikipedia.org/w/index.php?title=Special:ContentTranslation&active-list=suggestions&filter-id=Software&filter-type=collections&useformat=mobile&from=ha&to=en#/
https://test.wikipedia.org/w/index.php?title=Special:ContentTranslation&active-list=suggestions&filter-id=Software&filter-type=collections&from=en&to=ha#/

Test Steps

Test Case 1: Display banner when vital collection filter is active by default

  1. Open the Content Translation dashboard on beta.
  2. Ensure a language pair is selected where a vital collection is available.
  3. Observe the dashboard on initial page load.
  4. AC1: Confirm that the community information banner is visible when the vital collection filter is auto-selected by default.
DesktopDifferent SizesMobile

Test Case 2: Hide banner when switching away from vital collection filter

  1. From the Content Translation dashboard with the banner visible, switch to a non-vital collection filter.
  2. Observe the area below the filter chips.
  3. AC2: Confirm that the community information banner is no longer visible when a different filter is selected.

SEE AC1

Test Case 3: Display community-provided description or fallback text

  1. Open the Content Translation dashboard for a target language with a vital collection that has a community-provided description.
  2. Observe the banner description text.
  3. Switch to a target language whose vital collection has no community-provided description configured.
  4. Observe the banner description text again.
  5. AC3: Confirm that the banner displays the community-provided description when available, and displays the fallback text when no description is provided.

Test Case 4: Truncate and expand community description content

  1. With the banner visible, observe the description text on initial load.
  2. Select the inline "more" link.
  3. Observe the expanded description.
  4. Select the inline "less" link.
  5. AC4: Confirm that the description is truncated to two lines by default, expands to show the full text when "more" is selected, and collapses back to two lines when "less" is selected.

SEE AC1

Test Case 5: Conditionally display the external "Learn more" link

  1. Open the Content Translation dashboard for a vital collection that has an external link configured.
  2. Expand the banner description.
  3. Observe the presence of the "Learn more" link.
  4. Repeat steps 1–3 for a vital collection without an external link configured.
  5. AC5: Confirm that the "Learn more" link is visible only when a link is configured and the description is expanded, and hidden otherwise.

Test Case 6: Update banner language label based on selected target language

  1. Open the Content Translation dashboard with the vital collection banner visible.
  2. Note the secondary label indicating the source wiki language.
  3. Change the target language to another language with a vital collection.
  4. Observe the secondary label again.
  5. AC6: Confirm that the banner’s secondary label dynamically updates to reflect the selected target language and displays the language name in its native script.

Test Case 7: Hide collection badges on suggestion cards when vital collection filter is active

  1. Open the Content Translation dashboard with the vital collection filter active.
  2. Observe the suggestion cards in the list.
  3. Switch to a non-vital collection filter.
  4. Observe the suggestion cards again.
  5. AC7: Confirm that collection badges are hidden on suggestion cards when the active filter is the vital collection, and visible again when a different filter is selected.

GMikesell-WMF updated the task description. (Show Details)
GMikesell-WMF moved this task from Needs QA to Design Signoff on the LPL Hypothesis board.