README

A Flarum extension. Tag discussions with the language they are written in, filter the discussion list by language, and optionally auto-detect a visitor's preferred language to show relevant content by default.

Features

Language tagging — Assign a language (with optional country flag) to each discussion. Authors are prompted to choose a language when composing, moderators can change it at any time.
Discussion list filtering — A language dropdown appears on the index page. Discussions are filtered by language automatically based on the visitor's browser locale, cookie, or user preference — or they can manually pick "Any Language".
Search gambit — Filter search results by language using language:<code> in the search bar.
Composer pre-selection — Optionally pre-fill the language picker in the composer with the user's current Flarum locale.
Country flags — Display emoji flags alongside language names (backed by twemoji). Uses ISO 639-2 language codes and country data.
Native language names — Optionally display language names in their own script (e.g. "Deutsch" instead of "German").
Tags page integration — Optionally show only the most recent discussion in the user's locale on the tags page instead of the overall most recent discussion.
fof/follow-tags integration — When fof/follow-tags is enabled, users can choose, for each tag they follow, which discussion language they want to be notified about. Choosing it needs fof/follow-tags 2.0.0 or later; with an earlier version, the language chosen before still applies.

Installation

composer require fof/discussion-language:"*"

Updating

composer update fof/discussion-language
php flarum assets:publish
php flarum migrate

Configuration

All settings are available under the extension's admin page:

Setting	Description	Default
Use native language names	Show language names in their own script	Off
Show country flags	Display emoji flags next to language names	On
Pre-select current locale in composer	Automatically pick the user's Flarum locale when starting a discussion	Off
Use detected language for default filter	Redirect visitors to their detected language on page load	Off
Show "Any Language" option	Add an option to the dropdown to view all discussions regardless of language	On
Only show locale discussions on tags page	Replace the tag's last discussion link with the most recent one in the user's locale	Off

Languages and their associated countries (for flag display) are managed from the Languages section of the extension's admin page.

Permissions

Allow language editing — How long authors can change the language of their own discussions: indefinitely, for 10 minutes after posting, or until someone else replies.
Change discussion language — Which groups can change the language of any discussion at any time.

Links

An extension by FriendsOfFlarum, commissioned by mailcow.

fof / discussion-language

Package info

Security

Fund package maintenance!

Statistics