Add Persian (fa) translations for FreshRSS by Deioces120 · Pull Request #7795 · FreshRSS/FreshRSS

Deioces120 · 2025-08-07T15:47:12Z

Closes #

Changes proposed in this pull request:

Added full Persian (fa) translation to FreshRSS.
Translated all interface strings located in app/i18n/fa/.
Improved localization support for Persian-speaking users.

How to test the feature manually:

Switch interface language to Persian (fa) in settings.
Navigate through all admin/user pages.
Ensure all strings are correctly translated and readable.

Pull request checklist:

[x ] clear commit messages
[x ] code manually tested
unit tests written (optional if too hard)
[ x] documentation updated

Additional information can be found in the documentation.

app/i18n/fa/index.php

Inverle · 2025-08-07T16:14:28Z

If possible, run make fix-all to make sure the tests pass
Alternatively cli/manipulate.translation.php -a format && cli/check.translation.php -g

app/i18n/fa/admin.php

Deioces120 · 2025-08-07T18:19:59Z

Thank you for your review. I have updated the translations and resolved all the issues.
The files are now in sync with the latest changes, and make fix-all has been successfully run.
Please let me know if anything else is needed. 🙏

Inverle · 2025-08-07T18:50:33Z

It doesn't look like make fix-all was run.

root@vmware:~/FreshRSS# make fix-all
bin/composer run-script fix
> cli/manipulate.translation.php -a format && cli/check.translation.php -g
Error while processing: /root/FreshRSS/app/i18n/fa/conf.php
syntax error, unexpected token "/", expecting ")"Script cli/manipulate.translation.php -a format && cli/check.translation.php -g handling the translations event returned with error code 1
Script @translations was called via fix
make: *** [Makefile:200: composer-fix] Error 1
root@vmware:~/FreshRSS#

It's necessary to fix syntax errors manually.

Inverle · 2025-08-07T18:51:08Z

app/i18n/fa/conf.php

-		'get_label' => 'Display articles with “%s” label',	// TODO
-		'help' => 'See the <a href="https://freshrss.github.io/FreshRSS/en/users/user_queries.html" target="_blank">documentation for user queries and resharing by HTML / RSS / OPML</a>.',	// TODO
-		'image_url' => 'Image URL',	// TODO
+		'get_important' => 'نمایش مقالات از فیدهای مهم',	/


It's this line

Although there are more errors

Inverle · 2025-08-07T19:53:02Z

app/i18n/fa/feedback.php

+		'feeds_imported' => ' فیدهای شما وارد شده اند و اکنون به روز خواهند شد / Your feeds have been imported. If you are done importing, you can now click the <i>Update feeds</i> button.',
+		'feeds_imported_with_errors' => ' فیدهای شما وارد شده است / Your feeds have been imported, but some errors occurred. If you are done importing, you can now click the <i>Update feeds</i> button.',


This should either be translated fully or marked with a // DIRTY comment

Inverle · 2025-08-07T19:58:18Z

The tests should pass later when they are run now. Thanks for fixing the syntax errors

Alkarex · 2025-08-07T20:33:48Z

Thanks!

A few more TODOs please, if you can:

https://github.com/deioces120/freshrss/blob/e707b7fdc32f6345db046db913ead43a8787eec5/app/i18n/fa/conf.php#L120-L122

https://github.com/deioces120/freshrss/blob/e707b7fdc32f6345db046db913ead43a8787eec5/app/i18n/fa/sub.php#L92-L93

https://github.com/deioces120/freshrss/blob/e707b7fdc32f6345db046db913ead43a8787eec5/app/i18n/fa/sub.php#L244-L252

And this one should likely be // IGNORE:
https://github.com/deioces120/freshrss/blob/e707b7fdc32f6345db046db913ead43a8787eec5/app/i18n/fa/gen.php#L101-L102

Deioces120 · 2025-08-07T21:03:26Z

These are date/time format strings that do not require translation. They work correctly with the Persian locale and should remain as-is: https://github.com/deioces120/freshrss/blob/e707b7fdc32f6345db046db913ead43a8787eec5/app/i18n/fa/gen.php#L101-L102 Since the linked content is not localized (even hypothetically), translating this tag would not enhance the user experience and is therefore intentionally left as is:https://github.com/deioces120/freshrss/blob/e707b7fdc32f6345db046db913ead43a8787eec5/app/i18n/fa/conf.php#L120-L122 This string consists of technical terms and formats (HTML, XPath, JSON dot notation) that are best recognized and understood in English. Translating them would reduce clarity for technical users, so the original form is preserved intentionally:https://github.com/deioces120/freshrss/blob/e707b7fdc32f6345db046db913ead43a8787eec5/app/i18n/fa/sub.php#L92-L93 The explanations I provided above are mostly intended to clarify the reasoning behind leaving some TODOs as-is. If you believe any of them should be handled differently, please let me know and I’ll be happy to revise them accordingly.

Alkarex · 2025-08-07T21:30:51Z

Ok, it is fine to chose not to translate some strings, but then please mark them as IGNORE

Deioces120 · 2025-08-08T00:47:12Z

Thank you for the feedback.

I have now marked the untranslated strings as IGNORE and reviewed the remaining TODOS.

Let me know if anything else needs adjustment.

Alkarex · 2025-08-08T09:02:17Z

Thanks again!
Please add a line for you in https://github.com/FreshRSS/FreshRSS/blob/edge/CREDITS.md

Deioces120 · 2025-08-08T10:13:24Z

Thanks I have added my line in CREDITS.md as requested.

This PR contains the following updates: | Package | Update | Change | |---|---|---| | [freshrss/freshrss](https://freshrss.org/) ([source](https://github.com/FreshRSS/FreshRSS)) | minor | `1.26.3` -> `1.27.0` | --- ### Release Notes <details> <summary>FreshRSS/FreshRSS (freshrss/freshrss)</summary> ### [`v1.27.0`](https://github.com/FreshRSS/FreshRSS/blob/HEAD/CHANGELOG.md#2025-08-18-FreshRSS-1270) [Compare Source](FreshRSS/FreshRSS@1.26.3...1.27.0) - Features - Implement support for HTTP `429 Too Many Requests` and `503 Service Unavailable`, obey `Retry-After` [#7760](FreshRSS/FreshRSS#7760) - Add sort by category title, or by feed title [#7702](FreshRSS/FreshRSS#7702) - Add search operator `c:` for categories like `c:23,34` or `!c:45,56` [#7696](FreshRSS/FreshRSS#7696) - Custom feed favicons [#7646](FreshRSS/FreshRSS#7646), [#7704](FreshRSS/FreshRSS#7704), [#7717](FreshRSS/FreshRSS#7717), [#7792](FreshRSS/FreshRSS#7792) - Rework fetch favicons for fewer HTTP requests [#7767](FreshRSS/FreshRSS#7767) - Add more unicity criteria based on title and/or content [#7789](FreshRSS/FreshRSS#7789) - Automatically restore user configuration from backup [#7682](FreshRSS/FreshRSS#7682) - API add support for states in `s` parameter of `streamId` [#7695](FreshRSS/FreshRSS#7695) - Improve sharing via Print [#7728](FreshRSS/FreshRSS#7728) - Redirect to the login page from bookmarklet instead of 403 [#7782](FreshRSS/FreshRSS#7782) - Clean local cache more often, when refreshing feeds [#7827](FreshRSS/FreshRSS#7827) - Security - Implement reauthentication (*sudo* mode) [#7753](FreshRSS/FreshRSS#7753) - Add `Content-Security-Policy: frame-ancestors` [#7677](FreshRSS/FreshRSS#7677) - Ensure CSP everywhere [#7810](FreshRSS/FreshRSS#7810) - Show warning when unsafe CSP policy is in use [#7804](FreshRSS/FreshRSS#7804) - Fix access rights when creating a new user [#7783](FreshRSS/FreshRSS#7783) - Improve security of form for user details [#7771](FreshRSS/FreshRSS#7771), [#7786](FreshRSS/FreshRSS#7786) - Disallow setting non-existent theme [#7722](FreshRSS/FreshRSS#7722) - Regenerate cookie ID after logging out [#7762](FreshRSS/FreshRSS#7762) - Require current password when setting new password [#7763](FreshRSS/FreshRSS#7763) - Add missing access checks for feed-related actions [#7768](FreshRSS/FreshRSS#7768) - Strip more unsafe attributes such as `referrerpolicy`, `ping` [#7770](FreshRSS/FreshRSS#7770) - Remove unneeded execution permissions [#7802](FreshRSS/FreshRSS#7802) - Bug fixing - Fix redirections when scraping from HTML [#7654](FreshRSS/FreshRSS#7654), [#7741](FreshRSS/FreshRSS#7741) - Fix multiple authentication HTTP headers [#7703](FreshRSS/FreshRSS#7703) - Fix HTML queries with a single feed [#7730](FreshRSS/FreshRSS#7730) - WebSub: only perform a redirection when coming from WebSub [#7738](FreshRSS/FreshRSS#7738) - Include enclosures in entries’ hash [#7719](FreshRSS/FreshRSS#7719) - Negative side-effect: users of the option to *automatically mark updated articles as unread* will once have some articles with enclosures re-appear as unread - Fix cancellation of slider exit UI [#7705](FreshRSS/FreshRSS#7705) - Honor *disable update* on update page [#7733](FreshRSS/FreshRSS#7733) - Fix no registration limit setting [#7751](FreshRSS/FreshRSS#7751) - Fix XML encoding of sharing functions [#7822](FreshRSS/FreshRSS#7822) - SimplePie - Fix propagation of HTTP error codes [#7670](FreshRSS/FreshRSS#7670) - Fix support for XML feeds with HTML entities [#7689](FreshRSS/FreshRSS#7689), [simplepie#915](simplepie/simplepie#915) - Fix feeds encoded in UTF-16LE [#7691](FreshRSS/FreshRSS#7691), [simplepie#916](simplepie/simplepie#916) - Various upstream contributions [simplepie#917](simplepie/simplepie#917), [simplepie#924](simplepie/simplepie#924), [simplepie#926](simplepie/simplepie#926), [simplepie#932](simplepie/simplepie#932), [simplepie#933](simplepie/simplepie#933) - Sync upstream [#7706](FreshRSS/FreshRSS#7706), [FreshRSS/simplepie#45](FreshRSS/simplepie#45), [#7775](FreshRSS/FreshRSS#7775), [FreshRSS/simplepie#50](FreshRSS/simplepie#50), [#7824](FreshRSS/FreshRSS#7824), [#7825](FreshRSS/FreshRSS#7825), - Fix regex *Backtrack limit was exhausted* in `clean_hash()` [#7813](FreshRSS/FreshRSS#7813), [FreshRSS/simplepie#48](FreshRSS/simplepie#48) - Deployment - Docker default image (Debian 12 Bookworm) updated to PHP 8.2.29 [#7805](FreshRSS/FreshRSS#7805) - Docker alternative image updated to Alpine 3.22 with PHP 8.4.11 and Apache 2.4.65 [#7740](FreshRSS/FreshRSS#7740), [#7740](FreshRSS/FreshRSS#7740), [#7803](FreshRSS/FreshRSS#7803) - Start supporting PHP 8.5+ [#7787](FreshRSS/FreshRSS#7787), [#7826](FreshRSS/FreshRSS#7826) - Docker Alpine dev image `:newest` updated to PHP 8.5-alpha and Apache 2.4.65 [#7773](FreshRSS/FreshRSS#7773) - Docker: interpolate `FRESHRSS_INSTALL` and `FRESHRSS_USER` variables [#7725](FreshRSS/FreshRSS#7725) - Docker: Reduce how much data needs to be chown/chmod’ed on container startup [#7793](FreshRSS/FreshRSS#7793) - Test for database PDO typing support during install (relevant for MySQL / MariaDB with obsolete driver) [#7651](FreshRSS/FreshRSS#7651) - Extensions - Add API endpoint for extensions [#7576](FreshRSS/FreshRSS#7576) - Expose the reading modes for extensions [#7668](FreshRSS/FreshRSS#7668), [#7688](FreshRSS/FreshRSS#7688) - New extension hook `before_login_btn` [#7761](FreshRSS/FreshRSS#7761) - UI - Improve *mark as read* request showing popup due to `onbeforeunload` [#7554](FreshRSS/FreshRSS#7554) - Fix lazy-loading for `<video poster="...">` and `<image>` [#7636](FreshRSS/FreshRSS#7636) - Avoid styling `<code>` inside of `<pre>` [#7797](FreshRSS/FreshRSS#7797) - Improve confirmation logic with `data-auto-leave-validation` [#7785](FreshRSS/FreshRSS#7785) - Update `chart.js` to 4.5.0 [#7752](FreshRSS/FreshRSS#7752), [#7816](FreshRSS/FreshRSS#7816) - Various UI and style improvements: [#7616](FreshRSS/FreshRSS#7616), [#7811](FreshRSS/FreshRSS#7811) - I18n - Show translation status in README [#7715](FreshRSS/FreshRSS#7715) - Improve Indonesian [#7654](FreshRSS/FreshRSS#7654), [#7721](FreshRSS/FreshRSS#7721) - Improve Persian [#7795](FreshRSS/FreshRSS#7795) - Misc. - Improve PHP code [#7642](FreshRSS/FreshRSS#7642), [#7665](FreshRSS/FreshRSS#7665), [#7761](FreshRSS/FreshRSS#7761), [#7781](FreshRSS/FreshRSS#7781), [#7794](FreshRSS/FreshRSS#7794) - Update dev dependencies [#7708](FreshRSS/FreshRSS#7708), [#7709](FreshRSS/FreshRSS#7709), [#7710](FreshRSS/FreshRSS#7710), [#7711](FreshRSS/FreshRSS#7711), [#7776](FreshRSS/FreshRSS#7776), [#7777](FreshRSS/FreshRSS#7777) </details> --- ### Configuration 📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR is behind base branch, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] If you want to rebase/retry this PR, check this box --- This PR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate).  Reviewed-on: https://gitea.alexlebens.dev/alexlebens/infrastructure/pulls/1253 Co-authored-by: Renovate Bot <renovate-bot@alexlebens.net> Co-committed-by: Renovate Bot <renovate-bot@alexlebens.net>

Add Persian (fa) translations for FreshRSS

c035c65

Deioces120 mentioned this pull request Aug 7, 2025

[i18n] Translation Persian (FA) 🇮🇷 🇦🇹 🇹🇯 🇺🇿 needs translators #6347

Closed

Inverle reviewed Aug 7, 2025

View reviewed changes

app/i18n/fa/index.php Outdated Show resolved Hide resolved

Inverle reviewed Aug 7, 2025

View reviewed changes

app/i18n/fa/admin.php Outdated Show resolved Hide resolved

Deioces120 added 2 commits August 7, 2025 09:48

Fix Persian translation and syntax issues

6138e2a

Apply fix-all for Persian translation2

2c74297

Inverle reviewed Aug 7, 2025

View reviewed changes

Fix syntax errors and update Persian translations

c4dd325

Inverle reviewed Aug 7, 2025

View reviewed changes

Alkarex added this to the 1.27.0 milestone Aug 7, 2025

Alkarex added the I18n 🌍 Translations label Aug 7, 2025

Merge branch 'edge' into pr/Deioces120/7795

e707b7f

Alkarex linked an issue Aug 7, 2025 that may be closed by this pull request

[i18n] Translation Persian (FA) 🇮🇷 🇦🇹 🇹🇯 🇺🇿 needs translators #6347

Closed

Mark untranslated strings as IGNORE and fix remaining TODOs

c991b68

Alkarex added 2 commits August 8, 2025 10:57

Merge branch 'edge' into pr/Deioces120/7795

f454956

make fix-all

fe1350f

Alkarex merged commit 084f954 into FreshRSS:edge Aug 8, 2025
1 check passed

Alkarex mentioned this pull request Aug 8, 2025

Update CREDITS.md #7800

Merged

1 task

		'feeds_imported' => ' فیدهای شما وارد شده اند و اکنون به روز خواهند شد / Your feeds have been imported. If you are done importing, you can now click the <i>Update feeds</i> button.',
		'feeds_imported_with_errors' => ' فیدهای شما وارد شده است / Your feeds have been imported, but some errors occurred. If you are done importing, you can now click the <i>Update feeds</i> button.',

Uh oh!

Conversation

Deioces120 commented Aug 7, 2025

Uh oh!

Uh oh!

Inverle commented Aug 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Deioces120 commented Aug 7, 2025

Uh oh!

Inverle commented Aug 7, 2025

Uh oh!

Inverle Aug 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Inverle Aug 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Inverle Aug 7, 2025

Choose a reason for hiding this comment

Uh oh!

Inverle commented Aug 7, 2025

Uh oh!

Alkarex commented Aug 7, 2025

Uh oh!

Deioces120 commented Aug 7, 2025

Uh oh!

Alkarex commented Aug 7, 2025

Uh oh!

Deioces120 commented Aug 8, 2025

Uh oh!

Uh oh!

Alkarex commented Aug 8, 2025

Uh oh!

Deioces120 commented Aug 8, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Inverle commented Aug 7, 2025 •

edited

Loading

Inverle Aug 7, 2025 •

edited

Loading

Inverle Aug 7, 2025 •

edited

Loading