PHPackages                             momokoudai/flarum-ext-i18n-settings - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization & i18n](/categories/localization)
4. /
5. momokoudai/flarum-ext-i18n-settings

ActiveFlarum-extension[Localization & i18n](/categories/localization)

momokoudai/flarum-ext-i18n-settings
===================================

Flarum 后台设置内容国际化插件|Flarum Extension i18n Settings

00PHP

Since Apr 10Pushed 4mo agoCompare

[ Source](https://github.com/momokoudai/flarum-ext-i18n-settings)[ Packagist](https://packagist.org/packages/momokoudai/flarum-ext-i18n-settings)[ RSS](/packages/momokoudai-flarum-ext-i18n-settings/feed)WikiDiscussions main Synced 6d ago

READMEChangelogDependenciesVersions (1)Used By (0)

[中文文档](README_zh.md)

Flarum Extension i18n Settings
==============================

[](#flarum-extension-i18n-settings)

> Add multilingual display support to selected Flarum core settings and extension fields that normally only support a single language input. For example, the `title` and `url` fields of the `fof/links` extension. The backend supports setting titles and links, but can only set one language, which does not support multi-language input. This extension provides front-end multi-language display support. By entering specific tags, you can support multi-language input.

---

English
-------

[](#english)

### Features

[](#features)

- ✅ Frontend-only replacement, admin values remain editable in raw form
- ✅ Supports Flarum core basics settings
- ✅ Supports selected third-party extensions
- ✅ Supports JSON format and legacy `中文|English` format
- ✅ Explicit target control via `Enabled Plugins`
- ✅ Empty target list disables replacement by default for better stability

### Supported targets

[](#supported-targets)

TargetScopeFields`flarum-core`Flarum core `/admin#/basics``forum_title`, `forum_description`, `welcome_title`, `welcome_message`, `custom_header`, `custom_footer``fof-links``fof/links``title`, `url``flarum-tags``flarum/tags``name`, `description`> Only targets listed in `Enabled Plugins` will be replaced.

### Installation

[](#installation)

```
composer require momokoudai/flarum-ext-i18n-settings
php flarum cache:clear
```

### Configuration

[](#configuration)

Open the extension settings in the Flarum admin panel.

#### 1. Filter Pattern

[](#1-filter-pattern)

Default:

```
$$$

```

This marker identifies content that should be processed for multilingual replacement.

#### 2. Enabled Plugins

[](#2-enabled-plugins)

Examples:

```
flarum-core

```

```
flarum-core, fof-links, flarum-tags

```

If left empty, **replacement is disabled by default**.

### Usage

[](#usage)

#### Recommended JSON format

[](#recommended-json-format)

```
$$${"zh-Hans":"简体中文","en":"English","ja":"日本語"}$$$

```

#### Legacy format

[](#legacy-format)

```
$$$中文|English$$$

```

### Examples

[](#examples)

#### Forum title

[](#forum-title)

```
$$${"zh-Hans":"我的社区","en":"My Community"}$$$

```

#### Welcome banner

[](#welcome-banner)

```
$$${"zh-Hans":"欢迎来到社区","en":"Welcome to the community"}$$$

```

#### Custom header / footer with HTML

[](#custom-header--footer-with-html)

```
$$${"zh-Hans":"中文公告","en":"English Notice"}$$$

```

> For HTML content, prefer single quotes inside attributes to keep JSON easier to write.

### Behavior and safety

[](#behavior-and-safety)

- Replacement runs only on the **forum frontend**
- Admin forms keep the original marker content for editing
- User-generated discussions, posts, and replies are **not** replaced
- Unsupported extensions are not modified unless explicit compatibility is added

### Compatibility

[](#compatibility)

- Flarum `^1.8`

### Notes

[](#notes)

This extension is designed as a **targeted compatibility layer**, not a site-wide text replacement engine.

If you need support for another extension with admin-managed text fields, it can be added through a dedicated adapter.

---

中文说明
----

[](#中文说明)

### 功能特点

[](#功能特点)

- ✅ 仅在前台进行替换，后台仍保留原始标记内容，方便编辑
- ✅ 支持 Flarum 核心基础设置
- ✅ 支持部分第三方扩展字段
- ✅ 支持 JSON 格式和旧版 `中文|English` 格式
- ✅ 可通过 `Enabled Plugins` 精确控制生效目标
- ✅ 为提高稳定性，目标列表留空时默认不启用替换

### 已支持目标

[](#已支持目标)

目标范围字段`flarum-core`Flarum 核心 `/admin#/basics``forum_title`、`forum_description`、`welcome_title`、`welcome_message`、`custom_header`、`custom_footer``fof-links``fof/links``title`、`url``flarum-tags``flarum/tags``name`、`description`> 只有在 `Enabled Plugins` 中明确填写的目标才会被替换。

### 安装

[](#安装)

```
composer require momokoudai/flarum-ext-i18n-settings
php flarum cache:clear
```

### 配置

[](#配置)

在 Flarum 后台扩展设置中进行配置。

#### 1. 过滤标记（Filter Pattern）

[](#1-过滤标记filter-pattern)

默认值：

```
$$$

```

该标记用于识别需要进行多语言替换的内容。

#### 2. 启用的目标（Enabled Plugins）

[](#2-启用的目标enabled-plugins)

示例：

```
flarum-core

```

```
flarum-core, fof-links, flarum-tags

```

如果留空，**默认不启用替换**。

### 使用方式

[](#使用方式)

#### 推荐 JSON 格式

[](#推荐-json-格式)

```
$$${"zh-Hans":"简体中文","en":"English","ja":"日本語"}$$$

```

#### 旧版兼容格式

[](#旧版兼容格式)

``text $$$中文|English$$$

```

### 示例

#### 论坛标题

```text
$$${"zh-Hans":"我的社区","en":"My Community"}$$$

```

#### Welcome Banner

[](#welcome-banner-1)

```
$$${"zh-Hans":"欢迎来到社区","en":"Welcome to the community"}$$$

```

#### 带 HTML 的 custom header / footer

[](#带-html-的-custom-header--footer)

```
$$${"zh-Hans":"中文公告","en":"English Notice"}$$$

```

> 对于 HTML 内容，建议属性值里优先使用单引号，便于书写 JSON。

### 行为与安全性

[](#行为与安全性)

- 只在**论坛前台**进行替换
- 后台表单仍显示原始标记内容，方便继续编辑
- 不会替换用户发布的主题、帖子和回复
- 未适配的扩展不会被自动修改，除非后续添加专门兼容代码

### 兼容性

[](#兼容性)

- Flarum `^1.8`

### 说明

[](#说明)

本扩展的定位是 **“定点兼容层”**，而不是全站字符串自动翻译引擎。

如果你还希望支持其它带后台文本设置的扩展，可以继续按适配器方式扩展。

---

License
-------

[](#license)

MIT

###  Health Score

18

—

LowBetter than 7% of packages

Maintenance52

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity12

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/4e97009a1fe527fab72500fadc4bc78112051b7882fa99710f0dc58fbc71c5fe?d=identicon)[momokoudai](/maintainers/momokoudai)

---

Top Contributors

[![momokoudai](https://avatars.githubusercontent.com/u/33850943?v=4)](https://github.com/momokoudai "momokoudai (8 commits)")

### Embed Badge

![Health badge](/badges/momokoudai-flarum-ext-i18n-settings/health.svg)

```
[![Health](https://phpackages.com/badges/momokoudai-flarum-ext-i18n-settings/health.svg)](https://phpackages.com/packages/momokoudai-flarum-ext-i18n-settings)
```

###  Alternatives

[smarty-gettext/smarty-gettext

Gettext plugin enabling internationalization in Smarty Package files

752.5M8](/packages/smarty-gettext-smarty-gettext)[devaslanphp/auto-translate

Auto generate translation JSON files

6627.3k](/packages/devaslanphp-auto-translate)[renatomarinho/laravel-multi-language

Laravel Multi Language

235.1k](/packages/renatomarinho-laravel-multi-language)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)