Skip to content

Add affiliate / clan shop link to the Clan detail page #6217

Open

Description

@LoSt543215543

Problem Description

Currently, clans and creator communities often have branded cosmetics (clan flags, skins, patterns, crowns, effects) with dedicated affiliateCodes in the OpenFront cosmetic catalog. The in-game store supports an affiliate mode (storeModal.open({ affiliateCode }) / #affiliate=CODE) that filters the catalog to display only items attributed to a specific creator or clan.

However, on the clan profile page (ClanDetailView):

  1. There is no link, button, or card for players and clan members to access their clan's affiliate shop or view clan cosmetics.
  2. Players must already know the clan's affiliate code out-of-band and either manually type it into the store's code bar or use an external URL. On the Steam desktop client (which has no browser address bar), finding a clan's affiliate items is especially unintuitive.
  3. While clan leaders can configure an official discordUrl in ClanManageView (which renders a rich card on the clan detail page), there is currently no way to link a clan's affiliate code / shop.

Proposed Solution

  1. Clan Page UI (ClanDetailView):

    • Add a "Clan Shop" button or card on the clan detail page (e.g., in the action buttons or alongside the Discord card).
    • Clicking it opens the in-game Store modal in affiliate mode (storeModal.open({ affiliateCode })), immediately showing all cosmetics and bundles attributed to that clan.
  2. Clan Settings (ClanManageView) & Schema:

    • Add an optional affiliateCode field to ClanInfoSchema (in packages/shared/src/ClanApiSchemas.ts).
    • Allow clan leaders to configure their clan's affiliate code in ClanManageView, matching the existing discordUrl pattern.
    • Alternatively (or as fallback), automatically display the Clan Shop button if the catalog contains cosmetics whose affiliateCode matches the clan tag.
  3. Steam & In-Game Integration:

    • Directly opening store-modal with the affiliate code provides a native 1-click in-game flow on both web and the Steam desktop shell.

Alternatives Considered

  • External web link only: Doesn't integrate with in-game cosmetic purchases or work well in desktop shells.
  • In-game store search only: Requires players to manually search/type codes rather than discovering them on the clan page.

Additional Context

  • Builds on the affiliate store view implemented in src/client/Store.ts and src/client/Cosmetics.ts.

  • I'd like to be assigned to this issue and work on it myself

Activity

  1. github-actions commented on Oct 29, 2026

    @github-actions
    Contributor

    Hi @LoSt543215543, thanks for opening this issue. It hasn't been approved by a maintainer yet — we'll get back to you shortly to either milestone it (approval) or close it.

    — Automated. See CONTRIBUTING.md.

  2. JB940 commented on Oct 29, 2026

    @JB940
    Contributor

    I see no duplicates for this, I think adding it in the meantime is a nice accessibility feature as it's completely inaccessible on steam - however chances are this will NOT be configurable by clans itself, just managed by staff. They are relatively rare and custom made, and it'd just be confusing for the hundreds of clans who don't have this, as it can't even change without staff.

    I do think we should consider a small re-design of clan pages itself, in the future.

  3. added this to the Backlog milestone on Oct 29, 2026
  4. added
    approvedApproved for a PR, if you assigned to the issue.
    and removed
    not-approvedThis issue has NOT been approved by the maintainers.
    on Oct 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

approvedApproved for a PR, if you assigned to the issue.

Type

No type

Projects

Relationships

None yet

Development

No branches or pull requests

Issue actions