Version 109 vs 157
Version 109 vs 157
Content Changes
Content Changes
11 May 2024 -24 August 2024
|--------|-----
| Repo | Hash
|--------|-----
| {rP} | b02615bd5027ee51ac68d48a0a64306b75285789
| {rARC} | 04e3e250f7da6a55c908d373a0df9949eeea6d7b
== Highlights ==
* Custom Fields can be displayed in search results - see [[ https://we.phorge.it/book/phorge/article/custom_fields/ | Custom Fields manual]] for details.
* Flags show in Maniphest search results, and Repository will be shown in Differential search results.
* The Remarkup {icon book} Help button takes you to a real application installed locally (instead of a wiki page located here).
* When intending to comment on a task that is Closed as Duplicate, a warning is shown in the comment field.
* Workboard columns can be collapsed by clicking on their header (allows faster scrolling on mobile to the next column).
== General ==
| Change summary (with main Tag) | Patch | Main Task |
|----------------------------------------------------------------------------------|--------|-----------|
| #ux: Feed: fix "created this task" to always be the first one | D25626 | T15816 |
| #ux: Remove broken {nav name=Mute,icon=volume-up} button when unsupported (Files, Legalpad, etc.)| D25730 | T15378 |
| #ux: Custom Fields show up in search results and with custom icons | D25548 D25549 | T15750 |
| #Workboard: Add new column triggers: Add Subscribers + Remove Subscribers | D25080 | T15162 |
| #Workboard: Column content can be collapsed (e.g. in mobile view) for faster scrolling | D25672 | T15843 |
| #bug_reports: Fix legacy search bugs causing exceptions instead of login page | D25621 | T15704 |
| #conduit: Allow API `phriction.edit` to modify view and edit policies | D25693 | T15858 |
| #almanac_drydock_harbormaster: Add welcome pages | D25675 | T15018 |
| Charts: Updated d3.js library from version 5.9.2 to 6.7.0 | D25631 | T15820 |
| #Remarkup: Make Help a real application to document details of cowsay and figlet | D25698 | T15401 |
| #Remarkup: Prevent internal links from opening in a new tab | D25118 | T15161 |
| #Phriction: Fix drag & drop file visibility | D25705 | T15106 |
| #conpherence: Fix drag & drop file visibility | D25709 | T15106 |
| #Arcanist: Add missing support for non-English Subversion shells | D25691 | T15855 |
| Update timezone information to TZ2024a for the glory of Asia/Bishkek | D25722 | T15876 |
| #Files: Remove orphan attachments causing "Unknown Object" in "Referenced Files" | D25051 | T15110 |
| #Maniphest: Tasks in public Phorge installations include [Open Graph protocol](https://ogp.me/) HTML meta tags, allowing other web applications to show a task preview | D25668 | T15472 |
| #Maniphest: When removing a comment, the actor is not added as a task subscriber | D25760 | T15899 |
| #Differential: A button in the file header bar allows to copy the file path | D25757 | T15897 |
| #Herald: Invalid Herald rules are logged (see Dark Console) for easier investigation | D25735 D25736 D25737 | T15921 |
| #Diffusion: improve support for Subversion commit pages: fix "Authored On" date | D25796 | T15612 |
| #bug_reports: Various legacy bugs fixed | | |
| #bug_reports: Increased compatibility with PHP 8.1+ | | |
== Breaking Changes for Third-Party Code ==
* The `buildStandardPageView()` and `buildStandardPageResponse()` methods were removed from the [PhabricatorController](https://we.phorge.it/source/phorge/browse/master/src/applications/base/controller/PhabricatorController.php) class in D25634. These methods were deprecated since 2015. Custom code which calls these methods must be ported to use the `newPage()` method from the same class.
* The included copy of the d3 JavaScript library to render charts was updated from version 5.9.2 to 6.7.0. Custom code to render charts relying on Phorge's Facts application or on calling d3 methods directly may require API adjustments. See the [upstream d3 migration guide](https://observablehq.com/@d3/d3v6-migration-guide#event-management).
== Database Upgrades ==
NOTE: As usual, follow [[ https://we.phorge.it/book/phorge/article/upgrading/ | Upgrading Phorge ]]. In short, don't forget `./bin/storage upgrade`.
| Database Script | Rationale | Details |
|-----------------------------------------|-----------|---------|
| `20230917.fileattachment.01.delete.sql` | Remove legacy orphan references from the table `phabricator_file.phabricator_attachment` related to already-deleted files. | D25051 |
On average hardware, if you have 1M+ files and 10K file attachments, it may delete 200K rows in **1.5 seconds**.
== Visual Changes ==
=== Tasks Closed as Duplicate ===
No need anymore to write "This task is closed as duplicate, do not comment here but on the other task". Now this message is bundled in the new comment form:
{F2243121,size=full}
Related patch: D25546.
=== More Welcome Pages for Continuous Integration ===
Drydock and Almanac have Welcome pages to help you set up your epic CI/CD infrastructure.
Don't worry, it's not you, it is really still very over-complicated. But using your own infrastructure is worth it!
| {F2243109, size=full} | {F2243112, size=full} |
| {F2243110, size=full} | {F2243111, size=full} |
Related patch: D25675
24 August 2024 - ongoing
|--------|-----
| Repo | Hash
|--------|-----
| {rP} | TBD
| {rARC} | TBD
== Highlights ==
IMPORTANT: Phorge now requires PHP version 7.2.25+
Additionally, see the Proposed Maintenance section.
== General ==
| Change summary (with main Tag) | Patch | Main Task |
|----------------------------------------------------------------------------------|--------|-----------|
| #Auth: Send the Phorge URI as User-Agent string in OAuth and GitHub authentication requests (to avoid captchas when using CDNs) | D25758 | T15848 |
| #Diffusion: Reduce verbosity of commits in web feeds | D25824 | T15489 |
| #Diffusion: Show the disclaimer of {nav icon=times,name=Delete Repository} to all curious users|D25843|T15964|
| #Diffusion: Better support of non-English POSIX environments (especially for SVN) | D25846 | T15966 |
| #UX: Allow to submit forms in new tab with CTRL+enter |D25773 |T15914|
| #UX: Allow zooming pages on mobile |D25827 |T15945|
| #UX: Show table of contents on wide screens |D25790, D25873|T15920|
| #UX: Strike through archived projects in navigation crumbs in project view |D25774|T15890|
| Tokens: Allow to filter /token/given/ by type of token | D25865 | T15988 |
| #spam_mitigation in #People: Limit length of "Real name"|D25841 |T15962|
| #spam_mitigation in #Diffusion: Expand identities with //verified// emails by default|D25845|T15965|
| #Remarkup: Improve how we match project names |D25838|T15371|
| #Policy: Allow setting default edit policy in Phurl app |D25850|T15970|
| #Phame: in blog posts, show their code (Jxxx) in the title, only for logged-in users | D25022 | T15050 |
| #Herald actions: Allow setting subtype on tasks |D25913|T16022|
| #bug_reports: Increased compatibility with PHP 8.1+ and 8.4 | | T15064 |
| #bug_reports: Leave fullscreen editor when displaying "Upload File" and "Meme" dialogs | D25764 | T15901 |
| #bug_reports: Fix Packages base URI and add a Console | D25881 | |
| #bug_reports: Corrected invalid CSS values | D25920, D25921, D25922, D25923, D25924, D25925 | |
| Vendor-prefixed CSS for pre-2013 browsers removed | D25914, D25915, D25916, D25927, D25928, D25929, D25930 | |
| Update mimemailparser library version for incoming mail to upstream 8.0.4 |D25829 |T15940|
| Increased minimum PHP version from 5.2.3 to 7.2.25 | D25815, D25946, D25947, D25948, D25956 | T15047 |
== Breaking Changes ==
Phorge now requires PHP version 7.2.25 (released November 2019). Phorge previously required PHP version 5.2.3 (released May 2007). The newer version is needed to support PHP version 8.4 which requires syntax introduced in PHP 7.1. See T15047#19338 for details.
== Proposed Maintenance ==
After the update, to cleanup some potential legacy spam in Diffusion identities (page `/diffusion/identity/`) and especially if you have a Phorge with open registration, we suggest to run this one-shoot command:
```bash
./bin/repository rebuild-identities --all-identities
```
The command is safe to be executed also probably when your Phorge is running and, as usual, will not touch any manually-assigned identity. It will just avoid to propose //unverified// emails as automatic identities (T15965).
== Visual Changes ==
=== Form Submission in New Tab ===
Forms can now be submitted in a new tab with CTRL+enter. Proudly by keyboard hackers.
{F2670828}
Discussion and credits: T15914
=== Show Table of Contents on Large Screens ===
A wild table of contents now appears on your left, to surf your documents like an hero on wide screens.
| Before | After |
|--------------------|--------------------|
|{F2408032,size=full}|{F2490442,size=full}|
Discussion and credits: T15920
=== Less Verbose Commits ===
We save hackers' concentration by not duplicating anymore the commit title from the feed title and its body.
| Before | After |
|---------------------|---------------------|
| {F313288,size=full} | {F313289,size=full} |
Discussion and credits: T15489
11 May24 August 2024 -24 August 2024 ongoing
|--------|-----
| Repo | Hash
|--------|-----
| {rP} | b02615bd5027ee51ac68d48a0a64306b75285789TBD
| {rARC} | 04e3e250f7da6a55c908d373a0df9949eeea6d7bTBD
== Highlights ==
* Custom Fields can be displayed in search results - see [[ https://we.phorge.it/book/phorge/article/custom_fields/ | Custom Fields manual]] for details.
* Flags show in Maniphest search results, and Repository will be shown in Differential search results.
* The Remarkup {icon book} Help button takes you to a real application installed locally (instead of a wiki page located here).
* When intending to comment on a task that is Closed as DuplicateIMPORTANT: Phorge now requires PHP version 7.2.25+
Additionally, a warning is shown in the comment field.
* Workboard columns can be collapsed by clicking on their header (allows faster scrolling on mobile to the next column).
see the Proposed Maintenance section.
== General ==
| Change summary (with main Tag) | Patch | Main Task |
|----------------------------------------------------------------------------------|--------|-----------|
| #ux: Feed: fix "created this task" to always be the first one | D25626 | T15816 |
| #ux: Remove broken {nav name=Mute,icon=volume-up} button when unsupported (Files, Legalpad, etc.)| D25730 | T15378 Auth: Send the Phorge URI as User-Agent string in OAuth and GitHub authentication requests (to avoid captchas when using CDNs) | D25758 | T15848 |
| #ux: Custom Fields show up in search results and with custom icons| #Diffusion: Reduce verbosity of commits in web feeds | D25548 | D25549824 | T15750 |489 |
| #Workboard: Add new column triggers: Add Subscribers + Remove Subscribers | D25080 | T15162 || #Diffusion: Show the disclaimer of {nav icon=times,name=Delete Repository} to all curious users|D25843|T15964|
| #Workboard: Column content can be collapsed (e.g. in mobile view) for faster scrolling | #Diffusion: Better support of non-English POSIX environments (especially for SVN) | D25672846 | T15843 |966 |
| #bug_reports: Fix legacy search bugs causing exceptions instead of login page | #UX: Allow to submit forms in new tab with CTRL+enter | D25621 | T15704 |D25773 |T15914|
| #conduit| #UX: Allow API `phriction.edit` to modify view and edit policieszooming pages on mobile | D25693 | T15858 |D25827 |T15945|
| #almanac_drydock_harbormaster: Add welcome pages | #UX: Show table of contents on wide screens ||D25790, D25675 | T15018 |873|T15920|
| Charts: Updated d3.js library from version 5.9.2 to 6.7.0 | D25631 | | #UX: Strike through archived projects in navigation crumbs in project view |D25774|T15820 |90|
| #Remarkup: Make Help a real application to document details| Tokens: Allow to filter /token/given/ by type of cowsay and figlettoken | D25698865 | T15401 |988 |
| #Remarkup: Prevent internal links from opening in a new tab | D25118 | T15161 || #spam_mitigation in #People: Limit length of "Real name"|D25841 |T15962|
| #Phric| #spam_mitigation: Fix drag & drop file visibility | D25705 | T15106 | in #Diffusion: Expand identities with //verified// emails by default|D25845|T15965|
| #conpherence: Fix drag & drop file visibility | #Remarkup: Improve how we match project names | D25709 | T15106 |D25838|T15371|
| #Arcanist: Add miss| #Policy: Allow setting support for non-English Subversion shells | D25691 | T15855 |default edit policy in Phurl app |D25850|T15970|
| Update timezone information to TZ2024a for| #Phame: in blog posts, show their code (Jxxx) in the glory of Asia/Bishkek title, only for logged-in users | D257022 | T15876 |050 |
| #Files: Remove orphan attachments causing "Unknown Object" in "Referenced Files" | D25051 | T15110 || #Herald actions: Allow setting subtype on tasks |D25913|T16022|
| #Maniphest: Tasks in public Phorge installations include [Open Graph protocol](https://ogp.me/) HTML meta tags, allowing other web applications to show a task preview | D25668 | T15472bug_reports: Increased compatibility with PHP 8.1+ and 8.4 | | T15064 |
| #Maniphest: When removing a comment, the actor is not added as a task subscriber| #bug_reports: Leave fullscreen editor when displaying "Upload File" and "Meme" dialogs | D257604 | T15899 |901 |
| #Differential: A button in the file header bar allows to copy the file path | #bug_reports: Fix Packages base URI and add a Console | D25757 | T15897 |881 | |
| #Herald: Invalid Herald rules are logged (see Dark Console) for easier investigation || #bug_reports: Corrected invalid CSS values | D25920, D25921, D25735922, D25736923, D25737 | T15921 |924, D25925 | |
| #Diffusion: improve support for Subversion commit pages: fix "Authored On" date || Vendor-prefixed CSS for pre-2013 browsers removed | D25914, D25915, D25916, D25927, D25928, D25796 | T15612 |929, D25930 | |
| #bug_reports: Various legacy bugs fixed | | || Update mimemailparser library version for incoming mail to upstream 8.0.4 |D25829 |T15940|
| #bug_reports: Increased compatibility with PHP 8.1+| Increased minimum PHP version from 5.2.3 to 7.2.25 | | || D25815, D25946, D25947, D25948, D25956 | T15047 |
== Breaking Changes for Third-Party Code ==
* The `buildStandardPageView()` and `buildStandardPageResponse()` methods were removed from the [PhabricatorController](https://we.phorge.it/source/phorge/browse/master/src/applications/base/controller/PhabricatorController.php) class in D25634. These methods were deprecated since 2015Phorge now requires PHP version 7.2.25 (released November 2019). Custom code which calls these methods must be ported to use the `newPage()` method from the same class.
* The included copy of the d3 JavaScript library to render charts was updated from version 5.9.2 to 6.7.0. Custom code to render charts relying on Phorge's Facts application or on calling d3 methods directly may require API adjustmentsPhorge previously required PHP version 5.2.3 (released May 2007). The newer version is needed to support PHP version 8.4 which requires syntax introduced in PHP 7.1. See the [upstream d3 migration guide](https://observablehq.com/@d3/d3v6-migration-guide#event-management)T15047#19338 for details.
== Database Upgrades ==== Proposed Maintenance ==
NOTE: As usual, follow [[ https://we.phorge.it/book/phorge/article/upgrading/ | Upgrading Phorge ]].After the update, In shortto cleanup some potential legacy spam in Diffusion identities (page `/diffusion/identity/`) and especially if you have a Phorge with open registration, don't forget `./bin/storage upgrade`.we suggest to run this one-shoot command:
| Database Script | Rationale | Details |```bash
|-----------------------------------------|-----------|---------|./bin/repository rebuild-identities --all-identities
| `20230917.fileattachment.01.delete.sql` | Remove legacy orphan references from the table `phabricator_file.phabricator_attachment` related to already-deleted files. | D25051 |```
On average hardwareThe command is safe to be executed also probably when your Phorge is running and, if you have 1M+ files and 10K file attachmentsas usual, it may delete 200K rows in **1.5 seconds**will not touch any manually-assigned identity. It will just avoid to propose //unverified// emails as automatic identities (T15965).
== Visual Changes ==
=== Tasks Closed as Duplicate ===Form Submission in New Tab ===
Forms can now be submitted in a new tab with CTRL+enter. Proudly by keyboard hackers.
No need anymore to write "This task is closed as duplicate, do not comment here but on the other task". Now this message is bundled in the new comment form:{F2670828}
{F2243121,size=full}Discussion and credits: T15914
Related patch: D25546.=== Show Table of Contents on Large Screens ===
=== More Welcome Pages for Continuous Integration ===A wild table of contents now appears on your left, to surf your documents like an hero on wide screens.
Drydock and Almanac have Welcome pages to help you set up your epic CI/CD infrastructure.| Before | After |
|--------------------|--------------------|
|{F2408032,size=full}|{F2490442,size=full}|
Don't worry, it's not you, it is really still very over-complicated. But using your own infrastructure is worth it!Discussion and credits: T15920
| {F2243109, size=full} | {F2243112, size=full} === Less Verbose Commits ===
We save hackers' concentration by not duplicating anymore the commit title from the feed title and its body.
| Before | After |
|---------------------|---------------------|
| {F2243110, 313288,size=full} | {F2243111, 313289,size=full} |
Related patch: D25675Discussion and credits: T15489
Content licensed under Creative Commons Attribution-ShareAlike 4.0 (CC-BY-SA) unless otherwise noted; code licensed under Apache 2.0 or other open source licenses. · CC BY-SA 4.0 · Apache 2.0