README

这是一个Flarum扩展，强制管理员创建的用户在首次登录时更改密码，并提供实时密码验证反馈。

English

This is a Flarum extension that forces users created by administrators to change their password on their first login, with real-time password validation feedback.

✨ Features

v2.0.0 New Features

🎯 Real-time Password Validation: Live feedback as users type their password
✓ Visual Password Strength Indicator: Green checkmarks for met requirements, gray circles for unmet
⚙️ Comprehensive Admin Settings: Configure password policies in admin panel
🇨🇳 Fully Localized: Complete Chinese interface

Core Features

Forces password change on first login for admin-created users
Customizable password requirements
No email verification required
Clean modal interface
Multi-language support

🔐 Password Policy Settings

Administrators can configure:

Minimum password length (1-100 characters)
Require uppercase letters (A-Z)
Require lowercase letters (a-z)
Require numbers (0-9)
Require special characters (!@#$%^&*...)

📦 Installation

composer require jiushutech/force-password-change
php flarum migrate
php flarum cache:clear

🚀 Usage

Install and enable the extension
Configure password policy in admin panel (optional)
When admin creates a user, they are automatically flagged
On first login, user sees password change modal with requirements
User inputs password and sees real-time validation
Flag is cleared after successful password change

📸 Screenshots

Password Requirements Display:

Password Requirements:
✓ At least 8 characters
✓ At least one uppercase letter (A-Z)
○ At least one lowercase letter (a-z)
✓ At least one number (0-9)
○ At least one special character (!@#$%^&*...)

🛠️ Development

cd js
npm install
npm run dev    # Development mode with watch
npm run build  # Production build

📖 Documentation

CHANGELOG.md - Version history
DEPLOY.md - Deployment guide
UX_IMPROVEMENT.md - UX improvements

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT

简体中文

这是一个Flarum扩展，强制管理员创建的用户在首次登录时更改密码，并提供实时密码验证反馈。

✨ 功能特性

v2.0.0 新功能

🎯 实时密码验证：输入密码时即时反馈验证结果
✓ 可视化密码强度指示器：满足要求显示绿色✓，未满足显示灰色○
⚙️ 完整的后台管理设置：在管理面板配置密码策略
🇨🇳 完全中文化：所有界面均为中文

核心功能

管理员创建用户时自动标记需要修改密码
可自定义密码要求
无需邮箱验证流程
简洁的对话框界面
支持多种语言

🔐 密码策略设置

管理员可配置：

最小密码长度（1-100 字符）
需要大写字母（A-Z）
需要小写字母（a-z）
需要数字（0-9）
需要特殊字符（!@#$%^&*...）

📦 安装方法

composer require jiushutech/force-password-change
php flarum migrate
php flarum cache:clear

🚀 使用说明

安装并启用插件
在后台配置密码策略（可选）
管理员创建用户时自动添加标记
用户首次登录时看到密码修改弹窗和要求
用户输入密码时看到实时验证反馈
修改成功后标记自动清除

📸 界面预览

密码要求显示：

密码要求：
✓ 至少 8 个字符
✓ 至少一个大写字母 (A-Z)
○ 至少一个小写字母 (a-z)
✓ 至少一个数字 (0-9)
○ 至少一个特殊字符 (!@#$%^&*...)

🛠️ 开发

cd js
npm install
npm run dev    # 开发模式（实时监控）
npm run build  # 生产构建

📖 文档

CHANGELOG.md - 版本更新历史
DEPLOY.md - 部署指南
UX_IMPROVEMENT.md - 用户体验改进说明

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

📄 许可证

MIT

支持 / Support

如有问题或建议，请提交 Issue 或 Pull Request。

For issues or suggestions, please submit an Issue or Pull Request.

GitHub Issues: https://github.com/jiushutech/force-password-change/issues
Email: it_admin@ninesure.com

🎉 v2.0.0 - 让密码修改变得简单、直观、安全！

jiushutech / force-password-change

Maintainers

Details