Официальный сайт SLAED CMS
Журнал изменений
Every writer in the project emitted PHP_EOL, so the same code produced CRLF on a Windows host and LF on a Linux one - in JSON log records, in generated PHP files and in the configuration the installer writes. All of them now emit "\n", and CRLF is produced only where a protocol requires it. The two hand-repair SQL files are gone with everything that referenced them.
Core changes:
- Log writers emit LF (core/classes/logger.php, admin/modules/database.php, core/security.php, core/system.php):
The JSONL record terminator of all six channels, database.log, log.log and days.log
- A record separator that depends on the host makes one machine format two ways
- The reader was already tolerant, splitting on any break, so no stored log breaks
- Generated files emit LF (setup/index.php, admin/modules/lang.php, admin/modules/editor.php, admin/modules/blocks.php):
The installer carried its own copy of setConfigFile() and wrote the same config files with CRLF
- A configuration file therefore ended up mixed, depending on whether the installer or the panel touched it last
- Language files, block files, editor templates and robots.txt follow the same rule
- The block generator loses the hardcoded CRLF around its heredoc marker, which also removes a parser risk
- The admin IP filter stops missing a break (admin/modules/security.php):
- strtr() stripped PHP_EOL and therefore missed a lone LF on Linux and a lone CR on Windows
- It now strips CR, LF and space, so the stored list cannot carry a stray break on either host
- Mail bodies and assembled text emit LF (core/classes/mail.php, core/security.php, admin/modules/*, modules/help):
- The SMTP transport already normalises a body to CRLF before the dialogue, so that boundary is the only place CRLF belongs
- The retired repair files leave the tree (setup/sql/, docs/VERSIONS.md, tests/):
- update6_3_patch.sql and update6_3_text_once.sql are gone, and nothing references them any more
- The upgrade matrix drops to two rows, the hand-patch section and its recount route are removed
- The splitter scenario moves onto the shipped upgrade channel instead of the deleted file
- The privat probe drives one channel, and its expectation follows
Benefits:
- A log, a generated file and a configuration read the same on every host the project runs on
- One rule instead of a per-call-site choice: LF inside the application, CRLF only at the protocol boundary
- The suite covers seven scenarios that were silently skipping on the missing files
Technical notes:
- Existing logs stay mixed; old CRLF records are still read, because the reader splits on any break
- A raw editor file written by the previous code on Windows shows its guard prefix once, and the first save repairs it
- No schema change, no route contract change, and no compatibility layer for the removed files
The shipped configuration carried a live master secret, and the route walk still addressed the upload record by positions that moved a release ago. Both are corrected here, together with the leftovers the audit of the editor upload plan surfaced.
Core changes:
- The master secret becomes per installation (config/security.php):
The shipped secret is emptied, so getSecret() generates one on first use
- core/security.php already carries that branch; it never fired while a value shipped
- setup/index.php writes back the value it reads, so every installation ran on the same secret
- The secret feeds csrf, dynreg, captcha, field, stats and upload
- The route walk addresses fields by name (tools/upload-route-check.php):
setUploadSwitch() reads the key order out of setUploadRuleData() instead of naming positions
- The record lost adminlist and holds twelve fields; the walk still wrote to positions ten and eleven
- The access matrix and the guest isolation skipped silently, and the run still exited zero
A skipped row can be marked required, and a required skip now fails the run
- Skips shaped by the stand stay non fatal: no remote URL, captcha left on, no image on the page
- The configuration cache is dropped without suppression (core/system.php):
- The suppressed unlink becomes a guarded one, so a missing cache is no error and a real one is not hidden
- Documentation and the avatar library (UPGRADING.md, templates/lite/images/avatars):
- The runtime cache step deletes config/local.php, which no fingerprint ever invalidates
- The two closed plan documents leave the tree
- The 0-NEW staging tree is gone; presets holds the library and system holds user, guest and deleted
- Tests and one locale (tests/Unit, admin/lang/fr.php):
- CommentWriteTest passes over a module with no writable target, which carries no delta to compare
- Two file manager tests lose the double quoted string the formatter rejected
- _EDFILEG takes the single quoted form the constant rules require
Benefits:
- Two installations no longer share one secret, so a token forged against one does not travel
- The acceptance walk of the editor upload runs its access matrix and its guest isolation again
- A green suite: no formatter finding and no PHPUnit warning
Technical notes:
- The secret is regenerated per installation; the previous value remains in the history of this file
- Every session and CSRF token is invalidated once the configuration cache is rebuilt
- No schema change, no route contract change and no runtime compatibility layer added
The editor windows are moved by their whole head and show the handle where a hand looks for one, the upload preferences stop hiding half of themselves behind a sub-tab, and the documentation of the section is written against the screens as they are. The one writing route that reached the disk without a record now leaves one behind.
Core changes:
- Head of the editor windows (templates/{admin,lite}/partials/editor-toastui-*.html, plugins/editors/toastui/assets/editor-upload.js, templates/{admin,lite}/assets/editors/toastui/skin.css):
The whole plate of the head carries the window, under the left button alone
- A button of the head keeps its own press, so closing still closes and expanding expands
- An expanded window hides the handle and drops the cursor: it has nowhere left to move
The handle moved to the right beside the other two buttons and became a grip
- The computed styles of the three icons were compared first: no overlay and no filter
- arrows-move draws four arrows and a crossing at sixteen pixels and reads as a blot
- Hovering paints the button in a system tone by the chip formula: green, blue, red
- The caption carries the icon of the button that opens the window, in the folder family
- Upload preferences on one page (admin/modules/uploads.php):
The sub-tabs are gone: the general block and the module blocks stand in the one form they always shared, under the one save button they always had
The directory picker is drawn on the catalogue alone, which is the screen it navigates
- getUploadsSearch() loses the argument it never received and the dead branch behind it
- Captions that name what a field does (admin/lang/{locale}.php, lang/{locale}.php):
The general block speaks of attachments and their output template, not of applications
- The width and the height name the placeholder they are substituted into
- The note of the link section of the rail matches its neighbours in length and in ending
- Journal of the editor upload (core/system.php):
addEditorUpload() writes one record per submitted file, as the two other routes of the window already did for deletion and packing
- A refusal is recorded with the reason the upload service answered
- Until now this was the one route of the project that stored a file and left no trace
- Documentation of the section (admin/info/uploads/ru.md):
Rewritten against the screens: the system files tab it never described, the desk conveniences, the policy of closed paths, the source editor and the window of the editor
- The removed sub-tabs, the retired setting and the paginator leave the text with them
- The opening names the tabs in one sentence, the way the newest help documents do
Benefits:
A window says by its cursor and its handle exactly what it can do, and hides both where it cannot do it
- One page of preferences instead of two panels behind a switch nobody needed
- A caption that names its own effect instead of a word that means nothing here
- Every route that puts a file on the disk can be accounted for afterwards
Technical notes:
- No schema change, no configuration change and no route contract changed
- tests/Unit/FileManagerCatalogTest.php gains the journal of the editor upload
uploads/files/files-WGVl13gb5m-7885.png is a test image found in the working tree; it is committed with the set because the tree is committed whole and may be removed
Stages 8 and 9 of docs/FILE-MANAGER-CONCEPT-2026.md close the plan. Both screens answer the pointer and the keyboard the way a file manager on a desktop does, the last duplicate list and the last legacy download helper are gone, and the catalogue scrolls with the page while holding nothing back from an administrator.
Core changes:
- Desk conveniences on both screens (plugins/system/slaed.js, templates/admin/assets/js/admin-ui.js, plugins/editors/toastui/assets/editor-upload.js):
The right button opens the fan of the object under the pointer, where the pointer stands
- The owner is the box holding exactly one fan, so the empty ground of a tile grid keeps the browser menu
- The direction is read off the theme instead of being known by the client
A modifier marks instead of navigating: Ctrl one object, Shift the whole span
- The marking press is caught in the capture phase, so a row does not follow its own address
- The current object does not move, because the panel beside the list describes it
- Arrows walk what is visible, Space marks, Enter does what a press does
A file dropped anywhere reaches the shown directory, an object dropped on a directory is moved
- The move opens the same operation form with the target filled in, because a moved file loses its published address
- The window of the editor opens on the first available rail section and returns the focus that opened it
- Cleanup of the file layer (core/admin.php, admin/modules/uploads.php, index.php, core/system.php):
getAdminUploadFiles() and the two quick lists it fed are gone together with their go=5 route
- The catalogue is now the only list of the upload tree the administration has
- The directory selector stays, because it is what walks the browser to a module
stream() becomes getFileStream(), the single download path of the project
- The opaque type replaces application/force-download and the empty Content-Range
- The name reaches the header encoded and reduced to its own last segment
- A missing or unreadable file answers 404 instead of an empty attachment
- getAdminFileDownload() decides the right and hands the file over; four callers outside the file manager follow the same path
- modules/files takes a streaming branch only for a file that lies on this server
- The catalogue scrolls with the page (core/admin.php, templates/admin/partials/*, templates/admin/assets/css/theme.css):
- No pager and no box of its own: a directory stands at its full length
The tree, the properties, the column titles and the bulk bar hold themselves in the window
- The card and the admin wrapper clip with overflow: clip, because hidden makes a scroll container and kills every sticky inside it
- An administrator is answered the whole directory; what may not be seen is decided by the path policy and never by a number
- The retired list length leaves the project (core/system.php, admin/modules/uploads.php, config/uploads.php, admin/lang/*):
- adminlist was the page size of the removed quick list and had no reader left
- The module rule drops the field and carries twelve, config/uploads.php is migrated record by record
- The settings form loses the input, six locales lose _F_5, _UPLOADS_SEEN and _UPLOADS_CUT
- Visual corrections against the approved mockup (templates/admin/, demo/):
- The tile leaves room for its fan, marks on a plate under the name the editor window already uses, and names size and day
- The fan of a tile opens as one row, the shape it has in a list and in the editor window
- The tree step is 8px, both side columns are 250px, the filter group stands over the properties column
- The type column is gone: the extension is in the name and the kind is in the icon
- bi-folder replaces bi-folder2, and bi-folder-fill marks the open node
- Tests and plan (tests/Unit/, tools/upload-route-check.php, docs/):
- DeskKeysTest holds the context menu, the modifiers, the keys, the focus and the two kinds of dragging
- FileManagerCatalogTest holds the single list, the single download path and the scrolled directory
- The plan marks stages 8 and 9 closed and records every decision taken after them, with its price
Benefits:
- One download path writes the headers of every download in the project, so a stored file can no longer be answered with a type that executes
- One list of the upload tree instead of three, and one place where a directory turns into rows and tiles
- An administrator sees a directory whole, and the settings that count files stay where they belong: the editor window and the visitor
- The two screens carry the same components under the same names, so a component fixed once is fixed on both
Technical notes:
- Breaking change: the module upload rule loses adminlist and holds twelve pipe-separated fields; config/uploads.php is migrated in this commit and a rule written for the previous format would be read shifted
- A rule written short by hand still answers the guest limit with the user one, because zero in that position would mean no limit for the one role that never had one
- New helper getFileStream() replaces stream(); admin/modules/security.php, modules/clients, modules/files and modules/shop are migrated to it
- Removed route: index.php go=5 getAdminUploadFiles; no other route changed its contract
- No schema change; no stored file is touched or renamed
Stages 4 through 7 of docs/FILE-MANAGER-CONCEPT-2026.md close together: the system area can be edited and rewritten under one lock protocol, the upload catalogue and the editor window are both drawn from the same descriptor, and every changing action of either screen travels by POST with a token and leaves an entry in the journal behind it.
Core changes:
- Source editor of the system area (core/classes/filemanager.php, admin/modules/uploads.php):
getFileBody() and setFileBody() read and replace the body of one text file
- the version is the digest of the bytes on disk and is compared inside the directory lock
- a mismatch answers 409, writes nothing and hands the fresh version back to the author
- the line separator is taken from the file, so a save never rewrites every line of it
- fmedit() and fmsave() put the editor in the place of the list while the tree stays
- the guard of an unsaved edit reaches htmx swaps, links and beforeunload alike
- Writing operations of the system area (core/classes/filemanager.php, admin/modules/uploads.php):
addFileEntry(), addDirectory(), updateFileName(), addFileCopy(), updateFilePath(), deleteFileEntry(), addFileArchive() and addFilesArchive()
- both sides of a compound path are asked of the policy separately
- two directories are locked in sorted order, so two writers never wait on each other
- a name already taken is refused inside the lock, where the answer is still current
- one form of the browser carries the argument of a rename, a copy and a move
- Catalogue of the administration (core/admin.php, admin/modules/uploads.php, templates/admin/*):
the whole upload tree is browsed with the rights of an administrator: tree, crumbs, rows and tiles, properties, fan, marks, bulk bar, gallery, upload queue and pager
- deletion and archiving left their GET links for POST routes of the module
- the server path moved out of the heading of the section into a property of the object
- Window of the editor (plugins/editors/toastui/, templates/lite|admin/partials/):
- editorFiles answers the descriptor of the file layer together with capabilities and quota
- getEditorRouteRule() asks the three questions every route of go=4 asks
- editorDelete and editorArchive hand a module moderator the two operations section 14 named
the window follows the approved mock-up: a rail of insertion ways, sections that state the rights they were given, compact and expanded catalogue, filter, fan, marks, gallery and an upload queue, with the five states of the process each carrying its own words
- Language constants (lang/{locale}.php, admin/lang/{locale}.php):
- EDITOR for the window and UPLOADS for the catalogue, in all six locales
- _RETRY becomes a global constant and its scoped copy is dropped
Benefits:
- one file layer answers three screens, so a path, a name and a lock are decided in one place
- a permission is read off the descriptor of the object instead of a role derived in the client
- every changing action is a POST with a token and an entry in storage/logs/error_file.log
- the two themes carry the same components under the same names
Technical notes:
new routes: index.php go=4 editorDelete and editorArchive; the contract of editorUpload and editorFiles is otherwise unchanged and their token now travels in the body
the JSON of the editor never carries an absolute server path; only the administrative context receives realpath, and it is shown in the properties of the selected object
getEditorImageData() is gone together with the row it used to build; the one list of embeddable types is read from Parser::EMBEDIMG by the editor driver
- _UPLOADS_RETRY is removed in favour of the global _RETRY
- no schema change, no configuration change, backward compatible
Stages 1, 2a, 2b and 3 of docs/FILE-MANAGER-CONCEPT-2026.md: FileManager reads one filesystem area below a server-chosen root, the managed name format and the lock protocol leave Upload for it, and a System files tab browses BASE_DIR and writes nothing.
Core changes:
- File layer (core/classes/filemanager.php):
Three contexts over one root the server chooses: uploads, editor, system
- Canonicalization refuses traversal, absolute paths, stream wrappers and symlink escape
- One policy method answers list, read, download, write and delete for every path
- The descriptor carries the absolute path in administrative contexts and never in the editor
The managed name format lives here alone
- SALTLEN, checkFileName() and getFileOwner() replace the two former regular expressions
getPathLock() and deletePathLock() are the one lock protocol of the project
- The key is the directory, because the upload service draws a free name below it
- Upload service (core/classes/upload.php, core/system.php):
- Upload requires the file layer and takes the shared lock when it publishes and when it deletes
- The name pattern and the salt length come from FileManager, and the constructor drops its lock argument
- getEditorFileJson() reads the owner through FileManager::getFileOwner()
- System files tab (admin/modules/uploads.php, core/admin.php, index.php):
- sysfiles() draws the browser: tree along the open path, crumbs, list, tiles, properties
Four go=5 routes: getAdminFileList, getAdminFileData, getAdminFilePreview, getAdminFileDownload
- Every one of them asks isAdmin(true) and checkFileAccess() again before it answers
- A download is always application/octet-stream, because a guessed type executes in the admin origin
- An image preview takes its type from a closed table and answers under a sandbox policy
- The tab carries no upload directory selector and no writing action
- Templates and theme (templates/admin/*):
- New partials file-browser, file-browser-tree, file-browser-list
- New fragments file-browser-row, file-browser-tile, file-browser-props
- The theme gets the three columns, the tree, the tiles, the properties panel and the empty states
- admin-ui.js holds the view, the current object, the way back and the filter of the open directory
- Language constants (admin/lang/, lang/):
- 29 UPLOADS* names in six locales, plus _FRESET and _DOWNLOAD in the site scope
- Mockups, tests and plan (demo/, tests/Unit/, docs/FILE-MANAGER-CONCEPT-2026.md):
- Both mockups show the states of the process: queue, skeleton, empty, failed, busy and rename
- FileManagerPathTest covers the path list of the plan, the policy rows and the capability tables
- FileManagerLockTest proves that two writers serialize on one key through one protocol
- The plan marks stages 1, 2a, 2b and 3 closed and names the routes that exist
Benefits:
- One filesystem layer serves the administration, the editor window and the upload service
- Path traversal, symlink escape and closed paths are refused in one place instead of per route
- The system area is readable through the browser without a link that would execute a file
- Two writers of the same directory wait for each other, because there is only one lock protocol
The file manager concept becomes an implementation plan: every stage carries its own reading map, acceptance rule and stop condition, so one session opens the document, reads its stage and works. The mockups both screens are built from are committed beside it, and the theme gaps found while building them are closed in the themes rather than patched in the mockups.
Core changes:
- Implementation plan (docs/FILE-MANAGER-CONCEPT-2026.md):
The document turns from a concept into a plan of ten stages
- Every stage names why it comes now, what to do, how to verify, what to
commit and when to stop and ask
- Every stage carries a reading map: the plan sections, the source files with
line numbers and the tests it needs, so a session reads about 500 lines
instead of the whole document
- Stage 2 is split: 2a builds the class, 2b moves the managed name and the
lock out of Upload and migrates both callers
The FileManager contract is renamed to the project rule
- getFileList, getFileData, getFileBody, setFileBody, addFileEntry,
addDirectory, deleteFileEntry, updateFileName, addFileCopy, updateFilePath,
addFileArchive, getFileOwner, checkFileAccess, isFileEditable
- list, stat, read and write are refused as names: none of them passes the
verb plus noun rule and half are taken by PHP itself
Three mechanisms are described once and shared by both screens: the sl-dial action fan, the sl-modal preview gallery, and the checkbox selection with its bulk bar
The save protocol takes the lock around the whole compare and replace, because a version check beside the lock protects nothing
The path policy answers per operation instead of hiding entries from a listing, and rename, copy and move check both sides of the path
System files gain their own download route: a direct link would let the server execute index.php instead of handing it over
Language constants go to UPLOADS and EDITOR, each matching its own configuration namespace
- Editor uploads plan (docs/EDITOR-UPLOADS-2026.md):
The plan is closed: the editor mode of tools/upload-route-check.php was walked against a live stand with every row passing
- The access matrix of four settings combinations against three roles
- The guest isolation of two sessions
- The write guard over real HTTP
The walk needs two accounts and not four: is_moder() reads the admin session only, so one account answers as moderator in one cookie jar and as a member in the other
- Admin theme (templates/admin/assets/css/theme.css):
sl-but-mini drops the browser chrome that drew a second border over its round fill, as the lite theme already did
sl-is-muted, the disabled state, sl-bulk-bar and sl-bulk-count arrive under the names they already carry in lite
- sl-modal-wide and sl-modal-image arrive so a gallery has a frame to open in
- A selected table row is now distinguishable from a hovered one
- Lite theme (templates/lite/assets/css/theme.css):
- sl-bulk-count joins sl-bulk-bar under the name the admin theme uses
- Approved mockups (demo/filemanager-*.html):
filemanager-v2-rail.html is the editor window: a side rail of three insert ways, the module storage, four permission scenarios, the action fan, the gallery and multiple selection
filemanager-admin-2026.html is the admin full mode: file catalogue and system files on one shell, built from existing theme components
- Eight earlier variants are kept as the record of why the rail was chosen
Benefits:
- A session can work on one stage without reading the whole plan
The mockups are a working reference, not a picture: they use production classes, so moving them into code is mechanical
The two themes now carry the same component set under the same names, which removes the need to redefine anything locally
Technical notes:
- No PHP was touched; the file manager itself is not implemented yet
The theme additions are new rules only, no existing selector changed its meaning, verified against the live admin and front pages
- The next stage is 1: the loading and error states in the mockups
The content editor no longer keeps rules of its own beside the module upload settings. Access is answered by one function, the width of the target column decides whether a field may carry an embedded image, and one guard holds every write to the room its column has instead of letting the database answer with a lost post. Batches 1 to 6 of docs/EDITOR-UPLOADS-2026.md land together.
Core changes:
- Settings and ownership (core/system.php, core/classes/upload.php, admin/modules/uploads.php):
The module rule gains the key guestfiles, appended so a stored rule keeps working
- A rule written before this release normalises on its first write and keeps every value it carried
- The new key falls back to userfiles when its position is absent, because zero means no limit
A guest owns the own uploads by a token derived from the session, never by the shared zero
- The owner segment of a stored name widened from an integer to alphanumerics
- The listing compares it as a string, so one guest can no longer match another
The guest guard on the listing route is gone; checkEditorUploadAccess() alone decides
- The one role rule left is its first line, a moderator of the module
- Which of the three listing limits applies is role, what each is worth is settings
- The storage contract (core/helpers.php, setup/sql/*.sql, 18 modules):
- Every one of the 54 editor call sites declares where its text is stored
getEditorRoomData() turns that name into a column type, and the type into bytes
- Seventeen body columns are MEDIUMTEXT, so an embed at the cap fits
- Summary columns and signatures stay TEXT, which is how a field says it holds no data URI
- auto_links.intro and users.sig leave VARCHAR, where a rich editor never belonged
checkEditorTextRoom() refuses before the query and answers a ready message
- Length is measured in bytes, because bytes are what a column bounds
- Embedded weight and media type are measured beside it
- The content feed writer keeps the stored body and logs the reason instead of failing
- One window and one bounded embed path (plugins/editors/toastui/, templates//partials/*):
The image dialog and the file catalogue became one window behind one icon
- setImageChrome() and setPopupChrome() are gone with the popup they measured
- The icon is there for every visitor, because the address field inside it always is
The blob hook is registered unconditionally
- A denied upload no longer falls through to the vendor default, which embedded with no bound at all
- Picked, dropped and pasted files reach one guarded path that checks room, type and size
- The cap and the list of embeddable types reach the editor from PHP
- The proof (tests/Unit/EditorRoomTest.php, tests/Support/editor_probe.php, tools/upload-route-check.php):
The room table is held against setup/sql/table.sql in both directions
- No store may resolve to a column that is neither TEXT nor MEDIUMTEXT
- Every call site names a storage the table carries
- The write guard runs against the real core in an isolated process
The tool gained an editor mode for what only exists as a request handler
- The access matrix, the guest isolation and the write guard over real HTTP
Benefits:
- A setting the administrator changes is the setting the editor obeys
- A refusal reaches the author at the moment they act instead of as ERROR 1406
- One definition each for the cap, the embeddable types and the room a field has
- A wrong column name fails a test rather than costing an author a post
Technical notes:
- Storage: seventeen columns widened to MEDIUMTEXT, auto_links.intro and users.sig to TEXT, in all three schema paths
- Config: one key appended to the upload rule; no migration needed and no value reordered
- Files stored under the old name pattern keep resolving; no migration of stored files
- The editor mode of tools/upload-route-check.php needs a stand and four credentials and is not run by the suite
The parser decides escaping from a trust boundary instead of a stored flag, comments and private messages gain their own runtime, and every column an author writes into is wide enough for what the editor is allowed to produce. Three schema paths — fresh install, 6.2 upgrade and the deployed patch — now agree column for column and index for index.
Core changes:
- Trust boundary and tag policy (core/security.php, core/classes/parser.php):
filterTrustedTags() becomes the single authority over [usehtml] and [usephp]
- both tags are reserved for the super administrator and stripped for everyone else
- filterText() and filterHtml() pass the capability, comments and messages never do
the pipeline runs filterCode() before filterBbBlocks(), so a documented example is quoted rather than executed
- a breaks format renders a single newline as a line break without touching authored text
the persistent parse cache moves from the news module into the parser and keys on the configuration hash
- Comment runtime (core/classes/comment.php, core/user.php):
format, iphash and the materialised path are gone; branches resolve through recursive CTEs over pid, and tombstones survive by an upward keep walk
reqkey is BINARY(16) under a unique index, so a repeated submit returns the first row instead of writing a second
- the flood window reads (ip, time, id) and the edit mark reaches the rendered view
- Private messages (core/classes/privat.php):
four independent states replace one overloaded status column, with a single owner per side and no shared flag between inbox and outbox
- Room for embedded images (setup/sql/*.sql):
fifteen columns that hold an authored text widen to MEDIUMTEXT
- EMBEDMAX allows 65536 bytes of binary, which is 87384 characters of base64 before the
data URI prefix, while TEXT holds 65535
- with STRICT_TRANS_TABLES the overflow is a lost post, not a lost image
the summary columns stay TEXT on purpose, because a list query draws twenty of them onto one page and an image referenced by address still fits there in a few dozen characters
users.sig moves from VARCHAR(255) to TEXT: of 828 stored signatures the longest is exactly 255 and 95 sit above 240
- Deployment and tooling (setup/sql/update6_3_patch.sql, setup/sql/update6_3_text_once.sql):
one idempotent patch carries a deployed 6.3 to full parity, including the mail queue and the campaign columns it never received
a one-time text repair normalises stored break markup and entities in comment and message bodies, ordered so that authored text is never mistaken for writer output
the address policy, the upload rule reader and getImgText() stop guessing the module and take it explicitly
Benefits:
an author capability decides what may be written, and the escaping policy decides how it is rendered; neither can be reached through the other
- a repeated submit, a lost connection or a double click can no longer duplicate a comment
- a branch and its tombstones are answered by one query instead of a maintained path column
- an embedded image can no longer end a post with ERROR 1406
- fresh install, upgrade and patch produce the same 38 tables, 494 columns and 172 indexes
Technical notes:
- reqkey is stored as raw bytes; the query interpolator renders non-UTF-8 values as 0x hex
comment.body, privat.body and thirteen further columns are MEDIUMTEXT; intro columns, users.block and order.info stay TEXT
- update6_3_patch.sql and update6_3_text_once.sql are both idempotent and safe to re-run
deployment order: files, update6_3_patch.sql, update6_3_text_once.sql, then clear storage/cache/pages
- no breaking change for stored content: every existing body renders unchanged
Stage 2 of docs/PRIVAT-2026.md: private messages now store the source the author wrote and render it safely by format, replacing the write-time filterHtml() encoding and the admin-side getDecodedText() compensation. Closes steps 11 and 12 of the plan.
Core changes:
- Safe rendering onto the format contract (core/classes/privat.php):
- format joins the field list and every row a read answers
addMessage() normalizes both fields and resolves the format once before the first attempt, so a retry rewrites nothing
- getBodyFormat() refuses an html editor and keeps the body as markdown source
- filterMessageText() keeps the trusted-html tokens, autolinker and censor,
drops only the write-time escape
- addMessageRow() stores format with the row
- Frontend and admin adapters (core/user.php, core/admin.php):
- detail view renders filterContent($body, true, ..., $view['format'])
- the send hands both fields over as submitted; the compose form refills unescaped
- getDecodedText() removed; the admin popover renders the same safe call
- Migration parity fix (setup/sql/table_update6_3.sql):
the bare MODIFY on _privat id/title/body becomes modcol(), so a table already on the final definition is not rewritten
- Documentation:
docs/VERSIONS.md: stage 2 entry with the deployment sequence, the mandatory tool run, the gate, and the maintenance-window requirement
- docs/PRIVAT-2026.md, docs/PARSER.md: stage 2 recorded
docs/CONTENT-CONTRACT-2026.md: handover note carrying the "without format" decision and a separately-tracked unauthenticated preview RCE finding
- Tests (tests/Support/privat_class_probe.php, tests/Unit/PrivatClassTest.php):
what a send stores per editor format, what the renderer answers, what the template does to the title, and what the writer still filters
Benefits:
No stored private-message value is trusted HTML; both frontend and admin render through Parser::filterContent() with safe = true
- The title is plain source escaped at the template boundary
- The upgrade no longer rebuilds a table that already carries the final schema
Technical notes:
Storage is source; format names plain or markdown; the '' state exists only inside the stage 2 maintenance window and the gate clears it before code is live
- tools/privat-migrate.php is mandatory and needs a closed site and a rehearsed restore
Verified: composer analyse, composer test (698 tests), php-cs-fixer --dry-run, 47 Privat tests, and a 48-check authenticated HTTPS route matrix, all passing