phpbb-crowdin

Shared Crowdin sync tooling for phpBB extensions maintained by phpBB Modders. Given an extension directory, it creates or updates the extension's Crowdin project (including phpBB's custom formal/casual honorific language variants), then uploads source strings to Crowdin or downloads completed translations back into the extension.

Contents

• crowdin-init.sh — the sync script. Run with -h/--help for the full option list.
• crowdin.conf — shared configuration applied to every phpBB extension (source language, source-sync toggle, CLI template path).
• crowdin.yml.template — Crowdin CLI configuration template; crowdin-init.sh fills in the phpBB language directory mappings at runtime.

Requirements

• bash, curl, jq
• Crowdin CLI (only required for source upload / translation download)

Usage

export CROWDIN_API_TOKEN=your-personal-access-token
./crowdin-init.sh /path/to/phpbb-extension

Add -n/--dry-run to preview project changes without applying them, or --download/--download-dry-run to pull completed translations back into the extension.

Contributing

Contributions are welcome!

• Bug reports: Open an issue.
• Everything else (questions, feature requests, ideas, general discussion): open an issue as well — this repository does not currently use Discussions.
• Pull requests are welcome for bug fixes or discussed features.

Acknowledgments

• Code review, bug fixes, and documentation assisted by Claude.

License

This project is licensed under the GNU General Public License v2.0.

See LICENSE for more information.