Журнал изменений
Relocated ten admin-specific templates from fragments/ to partials/ to enforce the project convention that partials/ holds independently renderable blocks while fragments/ holds inline atoms. Simplified the preview pipeline by inlining the full preview layout into partials/preview.html and removing the now-redundant preview-content intermediaries.
Core changes:
- Renamed fragments → partials (templates/admin/):
- fragments/basic-monitor.html → partials/basic-monitor.html
- fragments/dashboard-panel.html → partials/dashboard-panel.html
- fragments/div.html → partials/div.html
- fragments/foot-controls.html → partials/foot-controls.html
- fragments/form.html → partials/form.html
- fragments/menu-grid.html → partials/menu-grid.html
- fragments/module-head.html → partials/module-head.html
- fragments/sidebar-block.html → partials/sidebar-block.html
- fragments/tabs.html → partials/tabs.html
- fragments/toggle-form-block.html → partials/toggle-form-block.html
- Preview pipeline (templates/admin/):
- Deleted: pages/preview-content.html, partials/preview-content.html
- partials/preview.html: expanded from a stub include to full inline implementation
- pages/preview.html: updated include path from preview-content to partials/preview.html
Benefits:
- Clear fragments/partials boundary maintained across the admin theme
- Preview render path reduced from three files to one partial
Technical notes:
- All callers must now use getHtmlPart() instead of getHtmlFrag() for these ten templates
- No behavior change; structural reorganization only
Extended the template compiler to resolve dot-path notation such as {{ user.name }} into PHP array access ($user['name']), enabling partials to consume nested data contracts directly. Added filemtime(FILE) to the cache check so changing template.php itself invalidates all compiled caches.
Core changes:
- Template compiler (core/classes/template.php):
filterEcho: regex extended to a.b.c paths; compiler walks path to nested array access
- {{ field.iso }} compiles to <?= $this->getSafe($field['iso'] ?? null); ?>
- filterRaw: same extension for {{{ ... }}} raw output
parseIfCondition: regex and compiler both updated to support dot-path in conditions
- {% if date_badge.iso %} is now valid
- writeCache: filemtime(FILE) added so engine upgrades auto-invalidate all caches
Benefits:
- Partials receive nested data objects and dereference them without PHP preprocessing
- Cache rebuilt automatically after engine upgrades
- Backward compatible: single-word variables work unchanged
Technical notes:
- Dot-path: first segment is a PHP variable, remaining segments are string array keys
- Only lowercase snake_case identifiers allowed in each path segment
Migrate every call site away from the removed admin fragments and onto
the consolidated atomic contracts (link, div, hidden, button,
select, inline-badge, save-action, title-tip, message-block
with details, flat menu-grid items). Also switch two public theme
helpers (pager-dots, radio-group) to the flag-based variants and make
small variable-name cleanups along the way.
Core changes:
- core/helpers.php:
getTplPager / getPageNumbers: pager-dots now emits
inline-badgewithis_pager_dots- getTplRadioGroup: uses
post-divwithis_radio_groupflag getTplTitleTip: builds an
itemsarray and hands it totitle-tipdirectly (no per-item include)- getRatingAsync: drops the deleted
rating-wrapin favour ofdiv - core/admin.php:
- admininfo row actions switch from
row-actions-itemtolink - All ~20 admin info row constructions realigned to the new contract
- core/system.php:
getUserSessionInfo / getUserSessionAdminInfo: supply
name_linkandmodule_linkstructured objects alongside the legacy fields so session-row can render links via the consolidatedlinkfragment- adminblock: add
admin_link/logout_linkobjects - renderFootControls: add
top_linkobject for the upper anchor - encode_php: use
divwithis_codeflag instead ofcode-block - getAsyncPager: pager-dots switches to
inline-badgevariant getCartSummary: rename
$titleLinkto$titlinkto satisfy the variable-name rule (letters only, ≤8 chars)- admin/index.php (admin dashboard):
getAdminMenu: compose
image_link,title_link,link(grid) objects consumed by the new menu-grid-item / menu-list-item contractsgetAdminPanel: feed
items_htmldirectly to the flattenedmenu-grid(no per-row chunking; CSS now wraps)- admin/modules/*.php:
admins, blocks, categories, editor, groups, monitor, scheduler, security: migrate emissions from removed fragments (row-actions-item, user-search, multi-select, etc.) to the consolidated fragments and pass
linkobjects where needed- modules/*/admin/index.php:
account, auto_links, changelog, content, news, search: migrate admin-side emissions the same way; notably content/admin and news/admin switch comment/action groupings to the new contracts
- modules/money/index.php (send):
Build message-block
detailsas a structured list (label + value_html) instead of concatenatingtitle-tip-itemoutput intodetails_html- modules/shop/index.php:
edit-tipcallers passedit_link/delete_linkobjects withconfirm_textflag instead of the old flatedit_*/delete_*scalar fields
Benefits:
Every admin emission now goes through the same atomic fragment set; no hidden fragment-specific logic
- Dashboard menu-grid is a single flat list; layout is CSS-driven
Session and footer rendering work off structured link objects, matching how the rest of the codebase composes links
Pager-dots and radio-group callers stop depending on deleted per-purpose fragments
Technical notes:
Closes the multi-commit refactor series: admin fragment consolidation + public fragment contract extension + admin CSS update + caller migration
link/div-based recomposition matches the HTML emitted previously; no visible output change expectedA CRLF warning is emitted on core/admin.php during staging; Git normalizes the file to LF on commit as per
.gitattributes
Align the three public themes (default, lite, simple) with the same
fragment contracts used on the admin side: inline items loop inside
title-tip, pager-dots variant on inline-badge, radio-group flag on
post-div, and optional structured details list on message-block.
Core changes:
- title-tip fragment (default/lite/simple):
Replace the single-content emission with a multi-branch contract: content_html / content / items (with inline label+value+is_last loop) / label_text
Remove the per-theme title-tip-item fragment; the item loop is inlined into title-tip to match the admin contract
- inline-badge fragment (default/lite/simple):
Add
is_pager_dotsflag: renders the ellipsis pager placeholder (sl_num_exitspan) directly from inline-badge- Matches admin-side pager-dots consolidation
- post-div fragment (default/lite/simple):
Add
is_radio_groupflag that appends thesl-radio-groupclass when the caller composes a radio group via post-div- message-block partial (default/lite/simple):
Accept a structured
detailslist (label + value/value_html) in addition to the existing free-formdetails_htmlCallers building a key/value detail table can now skip manual
<br>composition
Benefits:
Single contract for title-tip across admin and public themes, eliminating the per-item include round-trip
- Shared pager-dots visual uses one fragment definition across stacks
Message-block rendering works from structured data instead of pre-concatenated strings
Technical notes:
Pairs with the core/helpers
getTplTitleTipswitch toitemsand the modules/money/send switch todetails(see caller migration commit)No visible HTML change when callers supply the same data in the new format; the rendered markup matches prior output
Rework the admin stylesheet to match the consolidated fragment
contracts: drop rules that belonged to removed fragments, add rules
for the atomic variants now emitted by select, div, save-action,
and flatten menu-grid to remove the row wrapper.
Core changes:
- Admin stylesheet (templates/admin/assets/css/new.css):
- Add
.sl-save-action-selectfor save-action's composed select Add
.sl-debug-section,.sl-debug-section-success,.sl-debug-section-warn,.sl-debug-section-dangerto drive the debug-section fragment's tone variantsAdd
.sl-code-row-odd,.sl-code-row-even,.sl-code-row-num,.sl-code-row-cellto style the code-row fragment directlyFlatten
.sl-menu-grid: it is now a flex wrap container, with the former.sl-menu-grid-rowwrapper removed from markupRemove
.sl-menu-grid-row,.sl-user-search*rules tied to the deletedmenu-grid-rowanduser-searchfragments
Benefits:
- Stylesheet stays aligned with the current admin fragment set
Menu-grid renders from a single flat
items_htmlwithout per-row wrappers, matching the admin/index.php caller change
Technical notes:
Pure CSS change; no JS or template contract implications beyond what the admin fragment refactor already introduced
Collapse ~35 single-purpose admin fragments into shared atomic ones
(link, div, hidden, button, select, inline-badge, etc.) and
extend the surviving fragments with the flags their consolidated
callers need. Three admin partials are realigned to the new contracts.
Core changes:
- Removed obsolete fragments (templates/admin/fragments/):
Wrappers collapsed into
link/div:- alpha-nav-link, alpha-nav-text, category-sub-item, comment-*-link,
comment-avatar, comment-num-link, comment-text, comment-list-form,
geo-ip-flag, label-item, row-actions-item, view-field,
title-tip-item, table-cell, table-row-content, span-raw,
navi-tab-link, navi-tab-content, tabs-* helpers
Form/list wrappers collapsed into shared
form/select/hidden:- ajax-textarea-form, comment-list-form, edit-list-select,
forum-reply-form, money-calculator-form, multi-select,
radio-group, radio-option, user-search
Display wrappers collapsed into
inline-badge/div:- graphic, img-preview, pdo-error-badge, rating-wrap, code-block,
code-table, div-collapse, session-admin-summary, list-bottom,
menu-grid-row, msg-center, warning-list, checkbox-input,
pager-dots (now an inline-badge flag)
- Extended surviving fragment contracts (templates/admin/fragments/):
- title-tip: inline
itemsloop replaces the title-tip-item include table: single
<table>emission withis_wrapless+disable_sortbranches handled via boolean flags instead of 4-way duplicationform: accept either raw
actions_html+submit_labelor a structuredactionsblock that defers to save-action- save-action: compose from
hidden+select+buttonfragments - inline-badge: add
is_pager_dotsflag (replaces pager-dots) post-div, div, link, span, button, hidden, input, checkbox, radio, select, textarea, file-input, foot-controls, module-foot, admin-block-links, menu-grid, menu-grid-item, menu-list-item, debug-section, code-row, edit-tip, session-row, tabs-link, toggle-form-block, table-cells: tighten markup, add boolean flags required by migrated call sites
- Realigned partials (templates/admin/partials/):
changelog.html, login.html, registration.html: update to match new contract of underlying fragments (link/hidden/button composition)
Benefits:
One atomic fragment per concept; admins stop carrying 3-4 near duplicates for the same tag
- Flag-driven variants keep markup consistent across callers
Contracts converge between admin and public themes (title-tip, inline-badge, save-action etc.)
Technical notes:
Pairs with the
core + admin + modulescaller migration commit below; intermediate checkouts are not expected to render cleanlyNo behavioural change in the final output; the emitted HTML matches the previous markup once callers pass the new flag/link arrays
Empty the per-language blocks help pages. Their contents described the
previous block-<name>.php naming convention and the old fly/standard
block mechanics, none of which match the current implementation after
the recent block filename normalization and block-rendering refactor.
Core changes:
- Legacy help pages (admin/info/blocks/):
- Empty de.html, en.html, fr.html, pl.html, uk.html
Files are kept in place (they are loaded by the admin help viewer) but carry no body until rewritten against the current architecture
Benefits:
- Stops shipping documentation that contradicts the current code
- Clears the slate for a rewrite aligned with the new naming and APIs
Technical notes:
No code changes and no path changes; the admin help viewer simply renders an empty help body for this section
New documentation for blocks will land separately once the stack settles
Refresh _meta.base_fingerprint in local config to reflect the new
baseline after the block-filename normalization, slim form-add partial
and liste/form-add caller migration.
Core changes:
- Local config snapshot (config/local.php):
- Update
_meta.base_fingerprintfrom9bac3d77…tof005dfd5…
Benefits:
- Keeps the deploy fingerprint consistent with the current tree state
- Prevents the integrity check from flagging the refactor as drift
Technical notes:
- Value-only change; no structural or behavioural impact
Align call sites with two consolidated template contracts:
listepartial absorbs table-open/rows/table-close/empty-alert/pager, replacing the old table + table-row + alert branching in callersform-addpartial accepts a singlefieldsstring; callers now compose token, name, email, title, category, text, site fields from atomic fragments themselves
Core changes:
- core/user.php (getPrivateMessageView):
- Introduce local
$messageListhelper that emitslistepartial Convert inbox/outbox/saved lists to build
$rowsarrays and hand them to the helper instead of manual table + alert branching- Switch row loop to
while ($row = ...)pattern used elsewhere - Module callers (modules/*/index.php):
form-add contract migration:
- account, contact, recommend, shop.kasse: inject token via
getHtmlFrag('hidden') inside `fields` instead of `token` param
- money, order: drop redundant empty
tokenparam - whois.add, help.add/addview, auto_links.add: replace lbl_*, emailval,
titleval, catselect, hometext, siteval, has_name/is_user with
composed `fields` built from form-field-row fragments
liste partial migration (table + alert + pager collapsed to one call):
- auto_links.send, clients.*, content, faq, files, jokes, links,
media, news, pages, shop.kasse/clients/partners, users.*,
account.last/asetup
Consistently switch list loops to
while ($row = $db->getSqlRow())with array destructuring for readability and alignment with existing patterns
Benefits:
- One template contract for listings; callers stop emitting scaffolding
Token injection is visible at the call site, matching how all other form fields are composed
- Empty-result branches no longer duplicate alert scaffolding
- Smaller modules files overall (-362 lines vs +405 lines removed)
Technical notes:
- Pairs with the preceding
templates/partials — slim form-addcommit No behavioural change in output structure; visible HTML matches the previous table/alert markup (liste is a wrapper around the same table/table-row/alert fragments)
getHtmlPart('liste', ...)accepts:rows,table_open,table_close, optionalempty_alert, optionalpager_html
Drop all inline field rendering from form-add partials. The partial now only renders the form shell, extrafields, fields and the submit row; per-field scaffolding (token, name, email, title, category, hometext, bodytext, fields_before/after_text, site) is no longer the partial's responsibility.
Core changes:
- Form shell partial (templates/default/partials/form-add.html):
- Remove inline {% if token %} hidden input
- Remove inline {% if has_name %}/{% if is_user %} username blocks
- Remove inline {% if emailval %}, {% if lbl_title %}, {% if lbl_cat %}
- Remove inline {% if hometext %}, {% if bodytext %}, {% if siteval %}
- Remove {% if fields_before_text %} / {% if fields_after_text %} hooks
- Keep: form tag,
extrafields,fields, submit row - Same change applied to templates/lite/partials/form-add.html
- Same change applied to templates/simple/partials/form-add.html
Benefits:
- Single rendering contract across themes (no divergent inline markup)
- Callers compose the body from atomic fragments they already own
No surprise required fields hidden in the partial; form semantics (required, placeholder, names) live where the data lives
Technical notes:
Breaking contract: callers must now inject token, name, email, title, category, text/body, site fields via
fields(see accompanying modules refactor commit)Unused params (
token,has_name,lbl_*,emailval,hometext,bodytext,siteval, etc.) are simply ignored by the thinner partial