Журнал изменений
Replace inline HTML <div> strings with standardized UI helper functions (getTplAdminHintLabel, getTplAdminSmallNote) in the blocks, configuration, and account modules to ensure consistent styling and encapsulation.
Core changes:
- Blocks management (admin/modules/blocks.php):
- Use getTplAdminSmallNote for RSS lines information row
- Configuration (admin/modules/config.php):
Replace inline <div> hints with getTplAdminHintLabel for captcha, SEO, and graph settings to maintain visual consistency
- User accounts (modules/account/admin/index.php):
- Update the mail password text panel to use the admin-admins-mail-panel fragment
Benefits:
- Consistent presentation of hints and small notes across admin forms
- Cleaner module templates that focus on structure rather than inline HTML
- Improved maintainability through encapsulated presentation logic
Technical notes:
- Uses helpers defined in core/helpers.php
- Fragments are loaded via the standard getHtmlFrag() method
- Backward compatible: visual output remains consistent with the previous implementation
Unify error message rendering across various admin modules by replacing inline implode('<br>', ...) with the shared getStopText() helper. Ensures consistent handling of empty error array entries and line breaks.
Core changes:
- Admin modules (modules/*/admin/index.php):
- Replace inline implode('<br>', \) with getStopText((array)\)
- Affected modules: auto_links, clients, files, help, jokes, links, media, money, news, order, pages, shop
Benefits:
- Centralized logic for formatting error messages
- Improved code readability across multiple modules
- Consistent UI presentation for warnings and error alerts
Technical notes:
- getStopText is a core helper from core/helpers.php
- (array) cast added for safety where \ variable might be null or scalar
- No functional change to the rendered HTML output
Introduce two new Mustache-style HTML fragment files that render a checkbox table for selecting news items associated with a record, keeping the markup out of PHP and in the template layer.
Core changes:
- Associated news table wrapper (admin-news-asso-table.html):
Renders an sl_form table element with {{{ rows_html }}} slot
- rows_html is populated by iterating admin-news-asso-cell fragments
- Associated news cell (admin-news-asso-cell.html):
Renders a single <td> with a named checkbox input
- name: associated[], value: {{ cid }}, checked state: {{{ checked }}}
- Displays article title {{ ctitle }} as inline label text
Benefits:
- Separates HTML structure from PHP controller logic
- Reusable fragments composable via getHtmlFrag() calls
- Consistent with existing admin fragment template conventions
Technical notes:
- Triple-brace {{{ }}} used for pre-rendered HTML slots (rows_html, checked)
- Double-brace {{ }} used for plain-text values (cid, ctitle) requiring escaping
- Backward compatible: fragments are new additions, no existing files changed
--------------------------------------------------------------------
Types: Refactor | Feature | Fix | Docs | Style | Test | Chore | Perf
Bullets: - main point, * sub-detail
--------------------------------------------------------------------
Unify stop/error message rendering across modules by replacing ad-hoc inline implode('<br>', ...) calls with the new shared getStopText() helper introduced in core/helpers.php, removing the now-redundant local getAdmintext() wrapper from admins.php.
Core changes:
- Admin admins module (admin/modules/admins.php):
- Remove local getAdmintext(array \) function (replaced by getStopText)
- Replace getAdmintext(\) call with getStopText(\) in add()
- Whois admin module (modules/whois/admin/index.php):
- Replace inline implode('<br>', \) with getStopText((array)\)
- Private messages (core/user.php):
- Replace inline implode('<br>', (array)\) with getStopText((array)\)
Benefits:
- Single source of truth for error message formatting
- Eliminates duplicate logic across three independent modules
- Consistent handling of empty/null stop entries via array_filter
Technical notes:
- getStopText filters empty strings via array_filter before joining
- Cast to (array) preserved where \ may be a scalar at call site
- Backward compatible: output is identical to previous inline logic
--------------------------------------------------------------------
Types: Refactor | Feature | Fix | Docs | Style | Test | Chore | Perf
Bullets: - main point, * sub-detail
--------------------------------------------------------------------
Add a set of small, focused helper functions that generate reusable HTML fragments for admin panels, keeping presentation logic in helpers and out of individual module files.
Core changes:
- New UI helper functions (core/helpers.php):
- getTplAdminSmallNote(text): standalone sl_small note div for label-less form rows
- getStopText(stop): joins non-empty error/stop messages with <br> separators
- getTplAdminTextLink(href, label, ...): safe anchor tag for use inside raw HTML slots
- getTplAdminTipLine(key, val): one key-value line for tooltip content_html strings
- getTplAdminInfoLine(label, value): one label-value line for info block content
- getTplAdminTableHead(cols): builds <th> head_html from column label arrays
- getTplAdminTableCells(cells): builds <td> cells_html from pre-rendered cell content array
- getTplSpan(class, raw_content, title): inline span with CSS class and optional title
- getTplAdminStatusBadge(state, yes, no): sl_green/sl_red badge span for status display
Benefits:
- Eliminates repetitive inline HTML string construction across modules
- Centralises HTML-escaping rules in one place, reducing XSS risk
- Provides a consistent API for all admin panel fragment generation
Technical notes:
- All attribute values are escaped via htmlspecialchars with ENT_QUOTES/UTF-8
- raw_content in getTplSpan is intentionally not escaped (caller responsibility)
- Backward compatible: no existing signatures changed
--------------------------------------------------------------------
Types: Refactor | Feature | Fix | Docs | Style | Test | Chore | Perf
Bullets: - main point, * sub-detail
--------------------------------------------------------------------
Same %20 space-encoding issue as the Migration badge. Replaced %20 with _ for consistency and reliable rendering on GitHub.
Core changes:
- Badge URL (README.md):
- Replace %20 with _ in Status badge URL
Technical notes:
- shields.io treats _ as space in path-based badge URLs
shields.io path badges on GitHub were rendering incorrectly due to double percent-encoding of the space character (%20). Replaced %20 with underscore (_) which shields.io treats as a space and GitHub does not mangle.
Core changes:
- Badge URL (README.md):
Replace %20 with _ in Migration badge URL
- Prevents double-decoding of percent-encoded space by GitHub
Benefits:
- Badge renders correctly on GitHub
Technical notes:
- shields.io treats _ as space in path-based badge URLs
- %25 encoding for % sign is unaffected and remains correct
Miscellaneous updates accompanying the jQuery removal and getTpl* migration: lang constants for new editor operations, expanded test coverage, documentation refresh, robots.txt hardening, and vanilla BxSlider replacement in lib.js.
Core changes:
- JS vanilla migration (templates/lite/assets/js/lib.js):
- Replaced jQuery BxSlider slider init with standalone vanilla carousel/slider implementation
- No jQuery dependency remaining in lib.js
- Language constants (admin/lang/*.php - all 6 locales):
- Added _EROBSTD (robots.txt standard label) and _ESAVED (file saved confirmation)
- Test suite (tests/):
- PhpFileFormatTest.php: expanded PHP file format checks
- TemplateValidationTest.php: added testSharedFrontendFragmentsStayInSyncAcrossThemes
- Added tests/TextFileEncodingTest.php: new encoding validation for all text files
- Documentation (docs/, README.md):
- docs/RAW_SLOTS_ADMIN.md: updated raw slot usage reference for admin templates
- docs/TEMPLATES.md: updated template system documentation
- docs/TEMPLATE_STATUS.md: updated migration status
- docs/TESTS.md: added test run reference
- README.md: updated migration progress badge (85% -> 90%), removed jQuery from stack list
- Infrastructure:
- robots.txt: added Disallow for /setup/, /setup.php, /storage/; added Sitemap directive
- config/comments.php, config/fields.php: whitespace normalization
Benefits:
- Full jQuery removal from lit theme frontend JS
- New test covers UTF-8 encoding and cross-theme fragment sync
- robots.txt now blocks sensitive paths from crawlers
Technical notes:
- lib.js vanilla implementation replaces #slider-head and #slaed_sites BxSlider instances
- No behavior change for end users
Introduce missing fragment and partial files required by the template engine after the admin helper and module migration, and add complete new layout and page files for lite and simple themes.
Core changes:
- Admin fragments (templates//fragments/admin-.html):
- Added admin-box, admin-form, admin-form-row, admin-form-wide, admin-table, admin-table-row
- Added admin-text-input, admin-textarea, admin-number-input, admin-email-input, admin-url-input
- Added admin-select, admin-select-option, admin-hidden-input, admin-color-label
- Added admin-image-preview, admin-hr-line, admin-info-box, admin-placeholder-box
- Added admin-rows-table, admin-tab-content, admin-tabs-setup
- Added to all three frontend themes: default, lite, simple
- Frontend fragments (templates/simple/fragments/):
- Added account-, assoc-, basic-, block-, forum-, liste-, login-, shop-, voting-, users-, messagebox, navi, privat-message
- Added to templates/default/fragments/ and templates/lite/fragments/ where missing
- Layouts and partials:
- Added templates/lite/layouts/main.html, templates/lite/pages/error.html
- Added templates/lite/partials/alerts.html, login-logged.html, login-without.html
- Added templates/simple/layouts/main.html
- Added templates/simple/partials/contact-block.html, forum-teaser.html, menu.html
- Added templates/default/partials/contact-block.html, forum-teaser.html
- Modified existing fragments:
- templates/*/fragments/account-view.html: updated slot names to match new helper output
- templates/*/fragments/shop-client-row.html: updated slot names
- templates/admin/fragments/: updated admin-voting, admin-shop, admin-security, admin-rss, admin-replace, admin-media, admin-lang, admin-fields, admin-account fragments
Benefits:
- All template fragments required by migrated PHP helpers are now present
- Consistent fragment set across default, lite, simple themes
- No missing fragment errors at runtime after getTpl* migration
Technical notes:
- Fragments follow Mustache {{ }} and {{{ }}} slot conventions
- New admin fragments are identical across all three frontend themes
Standardize the naming convention for all template-rendering helper functions by migrating from the mixed getAdmin/getCat/getBlock* prefix set to a single getTpl* prefix, making the template layer explicit and consistent.
Core changes:
- Helper definitions (core/helpers.php, core/admin.php):
- Renamed getAdminTable -> getTplAdminTable, getAdminTableRow -> getTplAdminTableRow
- Renamed getAdminForm -> getTplAdminForm, getAdminFormRow -> getTplAdminFormRow
- Renamed getAdminFormWide -> getTplAdminFormWide, getAdminBox -> getTplBox
- Renamed getAdminTextInput -> getTplTextInput, getAdminSelect -> getTplSelect
- Renamed getAdminHidden -> getTplHiddenInput, getAdminOption -> getTplOption
- Renamed getAdminHintLabel -> getTplAdminHintLabel, getAdminPlaceholderBox -> getTplAdminPlaceholder
- Renamed getCategoriesSearch -> getTplAdminCatSearch, getCategoryImageSelect -> getTplCategorySelect
- Renamed getCategoryImgPreview -> getTplCategoryPreview, getCatPermRow -> getTplCatPermRow
- Renamed getAdminTabName -> getTplAdminTabName, getAdminTabsSetup -> getTplAdminTabsSetup
- Renamed getBlockViewGrid -> getTplAdminBlockGrid, getBlockRefreshSelect -> getTplBlockRefresh
- Renamed getBlockActionSelect -> getTplBlockAction
- core/admin.php: extracted canonical implementations to helpers.php; wrappers remain for backward compat
- core/classes/template.php: added dev-mode template error reporting and debug comments
- Call site migration (admin/modules/.php, modules//.php, blocks/*.php, core/user.php):
- Updated all 88 call sites to use new getTpl* names
- No behavior change; pure mechanical rename
Benefits:
- Single coherent getTpl* namespace for all template helpers
- Canonical implementations live in core/helpers.php; admin.php retains thin wrappers
- Template error reporting improves debuggability in dev mode
Technical notes:
- Backward-compatible: old admin wrappers in admin.php still delegate to getTpl canonical functions
- No DB or API changes