Version 104 vs 157
Version 104 vs 157
Edits
Edits
- Edit by aklapper, Version 157
- Mon, Apr 14 10:14
- Edit by aklapper, Version 104
- Aug 12 2024 09:21
- ·streamline wording; add OGP; add Herald logging; add file patch copy button; add comment removal subscribing
| Edit Older Version 104... | Edit Older Version 157... |
Content Changes
Content Changes
11 May 2024 - ongoing
|--------|-----
| Repo | Hash
|--------|-----
| {rP} | TBD
| {rARC} | TBD
== 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 |
| #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 |
| #ux: Custom Fields show up in search results and with custom icons | D25548 D25549 | T15750 |
| #conduit: allow API `phriction.edit` to modify view and edit policies | T15858 | D25693 |
| #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, #Diffusion: A button in the file header bar allows to copy the file path | D25757 | T15897 |
| #Herald: Warnings about invalid Herald rules are printed in the error log and Dark Console for administrators | D25735, D25736, D25737 | T15869, T15885, T15887 |
| #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 ==
=== Warn if Task is 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.
=== Add Welcome Pages ===
Drydock and Almanac have Welcome pages to help you set up your epic CI/CD infrastructure.
| {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 - ongoing
|--------|-----
| Repo | Hash
|--------|-----
| {rP} | TBD
| {rARC} | TBD
== 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 Auth: Send the Phorge URI as User-Agent string in OAuth and GitHub authentication requests (to avoid captchas when using CDNs) | D25758 | T15848 |
| #ux: remove broken {nav name=Mute,icon=volume-up} button when unsupported (Files, Legalpad, etc.)| #Diffusion: Reduce verbosity of commits in web feeds | D25730824 | T15378 |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|
| #ux: Custom Fields show up in search results and with custom icons| #UX: Allow zooming pages on mobile | D25548 D25549 | T15750 |D25827 |T15945|
| #conduit: allow API `phriction.edit` to modify view and edit policie| #UX: Show table of contents on wide screens | T15858 | |D25790, D25693 |873|T15920|
| #almanac_drydock_harbormaster: add welcome pages | D25675 | T15018 || #UX: Strike through archived projects in navigation crumbs in project view |D25774|T15890|
| Charts: Updated d3.js library from version 5.9.2 to 6.7.0 | Tokens: Allow to filter /token/given/ by type of token | D25631865 | T15820 |988 |
| #Remarkup: make Help a real application to document details| #spam_mitigation in #People: Limit length of cowsay and figlet | D25698 | T15401 |"Real name"|D25841 |T15962|
| #Remarkup: prevent internal links from opening in a new tab | D25118 | T15161 || #spam_mitigation in #Diffusion: Expand identities with //verified// emails by default|D25845|T15965|
| #Phriction: fix drag & drop file visibility | #Remarkup: Improve how we match project names | D25705 | T15106 |D25838|T15371|
| #conpherence: fix drag & drop file visibility | D25709 | T15106 || #Policy: Allow setting default edit policy in Phurl app |D25850|T15970|
| #Arcanist: add missing support for non-English Subversion shells | #Phame: in blog posts, show their code (Jxxx) in the title, only for logged-in users | D25691022 | T15855 |050 |
| Update timezone informa| #Herald action to TZ2024a for the glory of Asia/Bishkek | D25722 | T15876 |s: Allow setting subtype on tasks |D25913|T16022|
| #Files: Remove orphan attachments causing "Unknown Object" in "Referenced Files" | D25051| #bug_reports: Increased compatibility with PHP 8.1+ and 8.4 | | T15110 |064 |
| #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: Leave fullscreen editor when displaying "Upload File" and "Meme" dialogs | D25764 | T15901 |
| #Maniphest: When removing a comment, the actor is not added as a task subscriber| #bug_reports: Fix Packages base URI and add a Console | D25760 | T15899 |881 | |
| #Differential| #bug_reports: Corrected invalid CSS values | D25920, D25921, D25922, D25923, D25924, #Diffusion: A button in the file header bar allows to copy the file path | D25757 | T15897 |D25925 | |
| #Herald: Warnings about invalid Herald rules are printed in the error log and Dark Console for administrators || Vendor-prefixed CSS for pre-2013 browsers removed | D25914, D25915, D25735916, D25736D25927, D25737 | T15869D25928, T15885D25929, T15887 |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 ==
=== Warn if Task is Closed as DuplicateForm Submission in New Tab ===
No need anymore to write "This task is closed as duplicate, do not comment here but on the other task"Forms can now be submitted in a new tab with CTRL+enter. Now this message is bundled in the new comment form:Proudly by keyboard hackers.
{F2243121,size=full}{F2670828}
Related patch: D25546.Discussion and credits: T15914
=== Add Welcome PageShow Table of Contents on Large Screens ===
Drydock and Almanac have Welcome pagesA wild table of contents now appears on your left, to helpsurf you set up your epic CI/CD infrastructurer documents like an hero on wide screens.
| {F2243109, size=full} | {F2243112, size=full} 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 |
|---------------------|---------------------|
| {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