**/
define('_AM_CSSHOLMES_MANAGER_INDEX', 'Index');
define('_AM_CSSHOLMES_MANAGER_ABOUT', 'About');
define('_AM_CSSHOLMES_MANAGER_PREFERENCES', 'Settings');
define('_AM_CSSHOLMES_MANAGER_UPDATE', 'Update');
-define('_AM_CSSHOLMES_MANAGER_FOOTER', "");
+// Permissions
+define('_AM_CSSHOLMES_PERMISSIONS', 'Permissions');
+
+define('_AM_CSSHOLMES_TAB_OVERLAY', 'Overlay');
+define('_AM_CSSHOLMES_PERM_OVERLAY', 'Use Overlay');
+define('_AM_CSSHOLMES_PERM_OVERLAY_DESC', 'Permission to see the toolbar, toggle profiles, and use inspect/measure/widget/slot tools.');
+
+define('_AM_CSSHOLMES_TAB_DIAGNOSE', 'Diagnostics');
+define('_AM_CSSHOLMES_PERM_DIAGNOSE', 'Use Diagnostics');
+define('_AM_CSSHOLMES_PERM_DIAGNOSE_DESC', 'Permission to use overflow detection, z-index overlay, grid overlay, and color blindness simulation.');
+
+define('_AM_CSSHOLMES_TAB_EDIT', 'Editing');
+define('_AM_CSSHOLMES_PERM_EDIT', 'Use Editors');
+define('_AM_CSSHOLMES_PERM_EDIT_DESC', 'Permission to use the token editor, typography editor, text editor, and undo. Edits are local previews only.');
+
+define('_AM_CSSHOLMES_TAB_EXPORT', 'Export');
+define('_AM_CSSHOLMES_PERM_EXPORT', 'Export Data');
+define('_AM_CSSHOLMES_PERM_EXPORT_DESC', 'Permission to copy inspection JSON and export structured payloads for the admin workbench.');
+
+define('_AM_CSSHOLMES_TAB_WORKBENCH', 'Workbench');
+define('_AM_CSSHOLMES_PERM_WORKBENCH', 'Admin Workbench');
+define('_AM_CSSHOLMES_PERM_WORKBENCH_DESC', 'Permission to use the admin scanner, theme/widget scans, import review, and patch drafts. Admin-only by default.');
+
+define('_AM_CSSHOLMES_PERM_USERS_NOTICE', 'Registered Users can still use the cssHolmes overlay or diagnostics. Earlier versions granted this on install; since 3.0.0 Alpha 2 new installs grant every tool to Webmasters only, and updates leave existing permissions unchanged. Remove the Registered Users ticks under Permissions unless you want members to see the toolbar.');
+
+//define('_AM_CSSHOLMES_MANAGER_FOOTER', "");
// Index.php
define(
'_AM_CSSHOLMES_MANAGER_INDEX_TXT1',
- "Holmes is stand-alone diagnostic CSS stylesheet that can highlight potentially invalid, inaccessible or erroneous HTML(5) markup by adding one class.
holmes.css is useful for checking the quality of your code (up to W3C HTML5 standards), nitpicking over ensuring markup is valid and semantic and accessility guidelines are met, and when you are tasked to fix up and debug an old, OLD website. It has a simple implementation and a mostly unobtrusive effect on your page. Not recommended for live enviroments.
Remember too that these are just guidelines: if something is flagged but you can't change it for a good reason, don't worry about it :) Also use a validator if you want to be 100% sure.
Inspired by InuitCss , Eric Meyer , NealGrossKopf and procrastination from coursework!
"
+ "Holmes is stand-alone diagnostic CSS stylesheet that can highlight potentially invalid, inaccessible or erroneous HTML(5) markup by adding one class.
holmes.css is useful for checking the quality of your code (up to W3C HTML5 standards), nitpicking over ensuring markup is valid and semantic and accessility guidelines are met, and when you are tasked to fix up and debug an old, OLD website. It has a simple implementation and a mostly unobtrusive effect on your page. Not recommended for live enviroments.
Remember too that these are just guidelines: if something is flagged but you can't change it for a good reason, don't worry about it :) Also use a validator if you want to be 100% sure.
Inspired by InuitCss , Eric Meyer , NealGrossKopf and procrastination from coursework!
"
);
// About.php
@@ -56,3 +80,77 @@
define('_AM_CSSHOLMES_ERROR_BAD_REMOVE', 'Could not delete %s');
define('_AM_CSSHOLMES_ERROR_NO_PLUGIN', 'Could not load plugin');
+// Theme set library
+define('_AM_CSSHOLMES_SETS_TITLE', 'Theme sets');
+define('_AM_CSSHOLMES_SETS_INTRO', 'Browse named style sets by installed theme. Preview a set before activating it for site visitors.');
+define('_AM_CSSHOLMES_SETS_JAVASCRIPT', 'Enable JavaScript to browse the theme set library.');
+define('_AM_CSSHOLMES_SETS_LOADING', 'Loading…');
+define('_AM_CSSHOLMES_SETS_READY', 'Library ready. Preview and import do not activate theme styles.');
+define('_AM_CSSHOLMES_SETS_THEME', 'Theme');
+define('_AM_CSSHOLMES_SETS_ALL_THEMES', 'All themes');
+define('_AM_CSSHOLMES_SETS_FILTER', 'Find a set');
+define('_AM_CSSHOLMES_SETS_FILTER_HINT', 'Filter by set name');
+define('_AM_CSSHOLMES_SETS_SORT', 'Sort sets');
+define('_AM_CSSHOLMES_SETS_SORT_NAME', 'Name, A–Z');
+define('_AM_CSSHOLMES_SETS_SORT_MODIFIED', 'Recently modified');
+define('_AM_CSSHOLMES_SETS_SORT_LIKES', 'Most liked');
+define('_AM_CSSHOLMES_SETS_RELOAD', 'Reload library');
+define('_AM_CSSHOLMES_SETS_TABLE_CAPTION', 'Named sets by theme');
+define('_AM_CSSHOLMES_SETS_NAME', 'Set name');
+define('_AM_CSSHOLMES_SETS_AUTHOR', 'Author');
+define('_AM_CSSHOLMES_SETS_CREATED', 'Date created');
+define('_AM_CSSHOLMES_SETS_MODIFIED', 'Date modified');
+define('_AM_CSSHOLMES_SETS_LIKES', 'Likes');
+define('_AM_CSSHOLMES_SETS_ACTIONS', 'Actions');
+define('_AM_CSSHOLMES_SETS_PREVIEW', 'Preview');
+define('_AM_CSSHOLMES_SETS_PREVIEW_NEW_TAB', 'Preview in a new tab');
+define('_AM_CSSHOLMES_SETS_EXPORT', 'Export JSON');
+define('_AM_CSSHOLMES_SETS_EXPORTED', 'Set exported.');
+define('_AM_CSSHOLMES_SETS_ACTIVATE', 'Activate');
+define('_AM_CSSHOLMES_SETS_ACTIVATE_CONFIRM', 'Activate {name} for {theme}? This replaces the active style overrides shown to site visitors.');
+define('_AM_CSSHOLMES_SETS_ACTIVATED', 'Set activated.');
+define('_AM_CSSHOLMES_SETS_DELETE', 'Delete');
+define('_AM_CSSHOLMES_SETS_DELETE_CONFIRM', 'Delete the named set {name}? This cannot be undone. Active theme styles are kept.');
+define('_AM_CSSHOLMES_SETS_DELETED', 'Named set deleted.');
+define('_AM_CSSHOLMES_SETS_LIKE', 'Like');
+define('_AM_CSSHOLMES_SETS_UNLIKE', 'Unlike');
+define('_AM_CSSHOLMES_SETS_LIKED', 'Like updated.');
+define('_AM_CSSHOLMES_SETS_RESET', 'Reset to original');
+define('_AM_CSSHOLMES_SETS_RESET_CONFIRM', 'Reset {theme} to its original theme styles? Active style overrides will be removed. Named sets are kept.');
+define('_AM_CSSHOLMES_SETS_RESET_DONE', 'Original theme styles restored. Named sets are kept.');
+define('_AM_CSSHOLMES_SETS_CANCELLED', 'Action cancelled.');
+define('_AM_CSSHOLMES_SETS_EMPTY', 'No named sets for this theme.');
+define('_AM_CSSHOLMES_SETS_NO_MATCHES', 'No sets match this name.');
+define('_AM_CSSHOLMES_SETS_NO_THEMES', 'No installed front-end themes are available.');
+define('_AM_CSSHOLMES_SETS_PALETTES', 'Starter palettes');
+define('_AM_CSSHOLMES_SETS_PALETTE_NOTE', 'These built-in color pairs are a starting point. Contrast results describe only the listed pairs, not whole-theme WCAG conformance. Preview on your target theme and check its content before saving.');
+define('_AM_CSSHOLMES_SETS_PALETTE_THEME', 'Preview palette on theme');
+define('_AM_CSSHOLMES_SETS_PAIR_PASS', 'passes 4.5:1 for normal text');
+define('_AM_CSSHOLMES_SETS_PAIR_FAIL', 'below 4.5:1 for normal text');
+define('_AM_CSSHOLMES_SETS_IMPORT_TITLE', 'Import a named set');
+define('_AM_CSSHOLMES_SETS_IMPORT_NOTE', 'Choose a target theme and review the validated import. Importing creates a named set without activating it. Maximum JSON file size: 128 KiB.');
+define('_AM_CSSHOLMES_SETS_IMPORT_THEME', 'Import into theme');
+define('_AM_CSSHOLMES_SETS_IMPORT_NAME', 'Set name (optional)');
+define('_AM_CSSHOLMES_SETS_JSON_FILE', 'JSON file');
+define('_AM_CSSHOLMES_SETS_REVIEW_IMPORT', 'Review import');
+define('_AM_CSSHOLMES_SETS_IMPORT_CONFIRM', 'Import named set');
+define('_AM_CSSHOLMES_SETS_RULE_COUNT', '{count} validated style rules.');
+define('_AM_CSSHOLMES_SETS_REVIEW_READY', 'Review the rules and warnings, then import the named set.');
+define('_AM_CSSHOLMES_SETS_IMPORTED', 'Named set imported. It has not been activated.');
+define('_AM_CSSHOLMES_SETS_CHOOSE_IMPORT', 'Choose a JSON file and a target theme.');
+define('_AM_CSSHOLMES_SETS_TOO_LARGE', 'Choose a JSON file no larger than 128 KiB.');
+define('_AM_CSSHOLMES_SETS_INVALID_JSON', 'The selected file is not valid JSON.');
+define('_AM_CSSHOLMES_SETS_REQUEST_FAILED', 'Could not load or save theme sets. Reload the library and try again.');
+define('_AM_CSSHOLMES_SETS_CONFLICT', 'Settings changed elsewhere. Reload and review before trying again.');
+define('_AM_CSSHOLMES_SETS_SHOW_SAMPLES', 'Show sample rows');
+define('_AM_CSSHOLMES_SETS_SAMPLE_NOTE', 'Sample rows for empty themes use Admin and illustrative dates/likes. They are not saved or published. Edit starts a draft; Clone creates a real set under your account.');
+define('_AM_CSSHOLMES_SETS_SAMPLE_NAME', 'Original defaults');
+define('_AM_CSSHOLMES_SETS_SAMPLE', 'Sample');
+define('_AM_CSSHOLMES_SETS_SAMPLE_READONLY', 'This is an unsaved sample. Clone it to create a real set.');
+define('_AM_CSSHOLMES_SETS_EDIT', 'Edit');
+define('_AM_CSSHOLMES_SETS_EDIT_NEW_TAB', 'Edit in the designer without publishing changes');
+define('_AM_CSSHOLMES_SETS_CLONE', 'Clone');
+define('_AM_CSSHOLMES_SETS_CLONE_PROMPT', 'Name for the cloned set');
+define('_AM_CSSHOLMES_SETS_COPY_NAME', '{name} copy');
+define('_AM_CSSHOLMES_SETS_CLONED', 'Set cloned. It has not been activated.');
+define('_AM_CSSHOLMES_SETS_NAME_REQUIRED', 'Enter a name for the new set.');
diff --git a/language/english/common.php b/language/english/common.php
index e266c43..f0e093d 100644
--- a/language/english/common.php
+++ b/language/english/common.php
@@ -1,4 +1,4 @@
-
*/
-$moduleDirName = basename(dirname(dirname(__DIR__)));
-$moduleDirNameUpper = mb_strtoupper($moduleDirName);
-
-define('CO_' . $moduleDirNameUpper . '_GDLIBSTATUS', 'GD library support: ');
-define('CO_' . $moduleDirNameUpper . '_GDLIBVERSION', 'GD Library version: ');
-define('CO_' . $moduleDirNameUpper . '_GDOFF', "Disabled (No thumbnails available)");
-define('CO_' . $moduleDirNameUpper . '_GDON', "Enabled (Thumbsnails available)");
-define('CO_' . $moduleDirNameUpper . '_IMAGEINFO', 'Server status');
-define('CO_' . $moduleDirNameUpper . '_MAXPOSTSIZE', 'Max post size permitted (post_max_size directive in php.ini): ');
-define('CO_' . $moduleDirNameUpper . '_MAXUPLOADSIZE', 'Max upload size permitted (upload_max_filesize directive in php.ini): ');
-define('CO_' . $moduleDirNameUpper . '_MEMORYLIMIT', 'Memory limit (memory_limit directive in php.ini): ');
-define('CO_' . $moduleDirNameUpper . '_METAVERSION', "Downloads meta version: ");
-define('CO_' . $moduleDirNameUpper . '_OFF', "OFF ");
-define('CO_' . $moduleDirNameUpper . '_ON', "ON ");
-define('CO_' . $moduleDirNameUpper . '_SERVERPATH', 'Server path to XOOPS root: ');
-define('CO_' . $moduleDirNameUpper . '_SERVERUPLOADSTATUS', 'Server uploads status: ');
-define('CO_' . $moduleDirNameUpper . '_SPHPINI', "Information taken from PHP ini file: ");
-define('CO_' . $moduleDirNameUpper . '_UPLOADPATHDSC', 'Note. Upload path *MUST* contain the full server path of your upload folder.');
-
-define('CO_' . $moduleDirNameUpper . '_PRINT', "Print ");
-define('CO_' . $moduleDirNameUpper . '_PDF', "Create PDF ");
-
-define('CO_' . $moduleDirNameUpper . '_UPGRADEFAILED0', "Update failed - couldn't rename field '%s'");
-define('CO_' . $moduleDirNameUpper . '_UPGRADEFAILED1', "Update failed - couldn't add new fields");
-define('CO_' . $moduleDirNameUpper . '_UPGRADEFAILED2', "Update failed - couldn't rename table '%s'");
-define('CO_' . $moduleDirNameUpper . '_ERROR_COLUMN', 'Could not create column in database : %s');
-define('CO_' . $moduleDirNameUpper . '_ERROR_BAD_XOOPS', 'This module requires XOOPS %s+ (%s installed)');
-define('CO_' . $moduleDirNameUpper . '_ERROR_BAD_PHP', 'This module requires PHP version %s+ (%s installed)');
-define('CO_' . $moduleDirNameUpper . '_ERROR_TAG_REMOVAL', 'Could not remove tags from Tag Module');
-
-define('CO_' . $moduleDirNameUpper . '_FOLDERS_DELETED_OK', 'Upload Folders have been deleted');
+$moduleDirName = \basename(\dirname(__DIR__, 2));
+$moduleDirNameUpper = \mb_strtoupper($moduleDirName);
+
+\define('CO_' . $moduleDirNameUpper . '_' . 'GDLIBSTATUS', 'GD library support: ');
+\define('CO_' . $moduleDirNameUpper . '_' . 'GDLIBVERSION', 'GD Library version: ');
+\define('CO_' . $moduleDirNameUpper . '_' . 'GDOFF', "Disabled (No thumbnails available)");
+\define('CO_' . $moduleDirNameUpper . '_' . 'GDON', "Enabled (Thumbsnails available)");
+\define('CO_' . $moduleDirNameUpper . '_' . 'IMAGEINFO', 'Server status');
+\define('CO_' . $moduleDirNameUpper . '_' . 'MAXPOSTSIZE', 'Max post size permitted (post_max_size directive in php.ini): ');
+\define('CO_' . $moduleDirNameUpper . '_' . 'MAXUPLOADSIZE', 'Max upload size permitted (upload_max_filesize directive in php.ini): ');
+\define('CO_' . $moduleDirNameUpper . '_' . 'MEMORYLIMIT', 'Memory limit (memory_limit directive in php.ini): ');
+\define('CO_' . $moduleDirNameUpper . '_' . 'METAVERSION', "Downloads meta version: ");
+\define('CO_' . $moduleDirNameUpper . '_' . 'OFF', "OFF ");
+\define('CO_' . $moduleDirNameUpper . '_' . 'ON', "ON ");
+\define('CO_' . $moduleDirNameUpper . '_' . 'SERVERPATH', 'Server path to XOOPS root: ');
+\define('CO_' . $moduleDirNameUpper . '_' . 'SERVERUPLOADSTATUS', 'Server uploads status: ');
+\define('CO_' . $moduleDirNameUpper . '_' . 'SPHPINI', "Information taken from PHP ini file: ");
+\define('CO_' . $moduleDirNameUpper . '_' . 'UPLOADPATHDSC', 'Note. Upload path *MUST* contain the full server path of your upload folder.');
+
+\define('CO_' . $moduleDirNameUpper . '_PRINT', "Print ");
+\define('CO_' . $moduleDirNameUpper . '_PDF', "Create PDF ");
+
+\define('CO_' . $moduleDirNameUpper . '_' . 'UPGRADEFAILED0', "Update failed - couldn't rename field '%s'");
+\define('CO_' . $moduleDirNameUpper . '_' . 'UPGRADEFAILED1', "Update failed - couldn't add new fields");
+\define('CO_' . $moduleDirNameUpper . '_' . 'UPGRADEFAILED2', "Update failed - couldn't rename table '%s'");
+\define('CO_' . $moduleDirNameUpper . '_' . 'ERROR_COLUMN', 'Could not create column in database : %s');
+\define('CO_' . $moduleDirNameUpper . '_' . 'ERROR_BAD_XOOPS', 'This module requires XOOPS %s+ (%s installed)');
+\define('CO_' . $moduleDirNameUpper . '_' . 'ERROR_BAD_PHP', 'This module requires PHP version %s+ (%s installed)');
+\define('CO_' . $moduleDirNameUpper . '_' . 'ERROR_TAG_REMOVAL', 'Could not remove tags from Tag Module');
+
+\define('CO_' . $moduleDirNameUpper . '_' . 'FOLDERS_DELETED_OK', 'Upload Folders have been deleted');
// Error Msgs
-define('CO_' . $moduleDirNameUpper . '_ERROR_BAD_DEL_PATH', 'Could not delete %s directory');
-define('CO_' . $moduleDirNameUpper . '_ERROR_BAD_REMOVE', 'Could not delete %s');
-define('CO_' . $moduleDirNameUpper . '_ERROR_NO_PLUGIN', 'Could not load plugin');
+\define('CO_' . $moduleDirNameUpper . '_' . 'ERROR_BAD_DEL_PATH', 'Could not delete %s directory');
+\define('CO_' . $moduleDirNameUpper . '_' . 'ERROR_BAD_REMOVE', 'Could not delete %s');
+\define('CO_' . $moduleDirNameUpper . '_' . 'ERROR_NO_PLUGIN', 'Could not load plugin');
//Help
-define('CO_' . $moduleDirNameUpper . '_DIRNAME', basename(dirname(dirname(__DIR__))));
-define('CO_' . $moduleDirNameUpper . '_HELP_HEADER', __DIR__ . '/help/helpheader.tpl');
-define('CO_' . $moduleDirNameUpper . '_BACK_2_ADMIN', 'Back to Administration of ');
-define('CO_' . $moduleDirNameUpper . '_OVERVIEW', 'Overview');
+\define('CO_' . $moduleDirNameUpper . '_' . 'DIRNAME', basename(dirname(__DIR__, 2)));
+\define('CO_' . $moduleDirNameUpper . '_' . 'HELP_HEADER', __DIR__ . '/help/helpheader.tpl');
+\define('CO_' . $moduleDirNameUpper . '_' . 'BACK_2_ADMIN', 'Back to Administration of ');
+\define('CO_' . $moduleDirNameUpper . '_' . 'OVERVIEW', 'Overview');
+
+//\define('CO_' . $moduleDirNameUpper . '_HELP_DIR', __DIR__);
+
+//help multipage
+\define('CO_' . $moduleDirNameUpper . '_' . 'DISCLAIMER', 'Disclaimer');
+\define('CO_' . $moduleDirNameUpper . '_' . 'LICENSE', 'License');
+\define('CO_' . $moduleDirNameUpper . '_' . 'SUPPORT', 'Support');
+
+//Sample Data
+\define('CO_' . $moduleDirNameUpper . '_' . 'LOAD_SAMPLEDATA', 'Import Sample Data (will delete ALL current data)');
+\define('CO_' . $moduleDirNameUpper . '_' . 'LOAD_SAMPLEDATA_CONFIRM', 'Are you sure to Import Sample Data? (It will delete ALL current data)');
+\define('CO_' . $moduleDirNameUpper . '_' . 'LOAD_SAMPLEDATA_SUCCESS', 'Sample Date imported successfully');
+\define('CO_' . $moduleDirNameUpper . '_' . 'SAVE_SAMPLEDATA', 'Export Tables to YAML');
+\define('CO_' . $moduleDirNameUpper . '_' . 'SAVE_SAMPLEDATA_SUCCESS', 'Export Tables to YAML successfully');
+\define('CO_' . $moduleDirNameUpper . '_' . 'CLEAR_SAMPLEDATA', 'Clear Sample Data');
+\define('CO_' . $moduleDirNameUpper . '_' . 'CLEAR_SAMPLEDATA_OK', 'The Sample Data has been cleared');
+\define('CO_' . $moduleDirNameUpper . '_' . 'CLEAR_SAMPLEDATA_CONFIRM', 'Are you sure to Clear Sample Data? (It will delete ALL current data)');
+\define('CO_' . $moduleDirNameUpper . '_' . 'EXPORT_SCHEMA', 'Export DB Schema to YAML');
+\define('CO_' . $moduleDirNameUpper . '_' . 'EXPORT_SCHEMA_SUCCESS', 'Export DB Schema to YAML was a success');
+\define('CO_' . $moduleDirNameUpper . '_' . 'EXPORT_SCHEMA_ERROR', 'ERROR: Export of DB Schema to YAML failed');
+\define('CO_' . $moduleDirNameUpper . '_' . 'SHOW_SAMPLE_BUTTON', 'Show Sample Button?');
+\define('CO_' . $moduleDirNameUpper . '_' . 'SHOW_SAMPLE_BUTTON_DESC', 'If yes, the "Add Sample Data" button will be visible to the Admin. It is Yes as a default for first installation.');
+\define('CO_' . $moduleDirNameUpper . '_' . 'HIDE_SAMPLEDATA_BUTTONS', 'Hide the Import buttons)');
+\define('CO_' . $moduleDirNameUpper . '_' . 'SHOW_SAMPLEDATA_BUTTONS', 'Show the Import buttons)');
+
+\define('CO_' . $moduleDirNameUpper . '_' . 'LOAD_SAMPLEDATA_FAILURE', 'Sample Date import failed');
+
+\define('CO_' . $moduleDirNameUpper . '_' . 'CONFIRM', 'Confirm');
+
+//letter choice
+\define('CO_' . $moduleDirNameUpper . '_' . 'BROWSETOTOPIC', "Browse items alphabetically ");
+\define('CO_' . $moduleDirNameUpper . '_' . 'OTHER', 'Other');
+\define('CO_' . $moduleDirNameUpper . '_' . 'ALL', 'All');
+
+// block defines
+\define('CO_' . $moduleDirNameUpper . '_' . 'ACCESSRIGHTS', 'Access Rights');
+\define('CO_' . $moduleDirNameUpper . '_' . 'ACTION', 'Action');
+\define('CO_' . $moduleDirNameUpper . '_' . 'ACTIVERIGHTS', 'Active Rights');
+\define('CO_' . $moduleDirNameUpper . '_' . 'BADMIN', 'Block Administration');
+\define('CO_' . $moduleDirNameUpper . '_' . 'BLKDESC', 'Description');
+\define('CO_' . $moduleDirNameUpper . '_' . 'CBCENTER', 'Center Middle');
+\define('CO_' . $moduleDirNameUpper . '_' . 'CBLEFT', 'Center Left');
+\define('CO_' . $moduleDirNameUpper . '_' . 'CBRIGHT', 'Center Right');
+\define('CO_' . $moduleDirNameUpper . '_' . 'SBLEFT', 'Left');
+\define('CO_' . $moduleDirNameUpper . '_' . 'SBRIGHT', 'Right');
+\define('CO_' . $moduleDirNameUpper . '_' . 'SIDE', 'Alignment');
+\define('CO_' . $moduleDirNameUpper . '_' . 'TITLE', 'Title');
+\define('CO_' . $moduleDirNameUpper . '_' . 'VISIBLE', 'Visible');
+\define('CO_' . $moduleDirNameUpper . '_' . 'VISIBLEIN', 'Visible In');
+\define('CO_' . $moduleDirNameUpper . '_' . 'WEIGHT', 'Weight');
+
+\define('CO_' . $moduleDirNameUpper . '_' . 'PERMISSIONS', 'Permissions');
+\define('CO_' . $moduleDirNameUpper . '_' . 'BLOCKS', 'Blocks Admin');
+\define('CO_' . $moduleDirNameUpper . '_' . 'BLOCKS_DESC', 'Blocks/Group Admin');
+
+\define('CO_' . $moduleDirNameUpper . '_' . 'BLOCKS_MANAGMENT', 'Manage');
+\define('CO_' . $moduleDirNameUpper . '_' . 'BLOCKS_ADDBLOCK', 'Add a new block');
+\define('CO_' . $moduleDirNameUpper . '_' . 'BLOCKS_EDITBLOCK', 'Edit a block');
+\define('CO_' . $moduleDirNameUpper . '_' . 'BLOCKS_CLONEBLOCK', 'Clone a block');
+
+//myblocksadmin
+\define('CO_' . $moduleDirNameUpper . '_' . 'AGDS', 'Admin Groups');
+\define('CO_' . $moduleDirNameUpper . '_' . 'BCACHETIME', 'Cache Time');
+\define('CO_' . $moduleDirNameUpper . '_' . 'BLOCKS_ADMIN', 'Blocks Admin');
+\define('CO_' . $moduleDirNameUpper . '_' . 'UPDATE_SUCCESS', 'Update successful');
+
+//Template Admin
+\define('CO_' . $moduleDirNameUpper . '_' . 'TPLSETS', 'Template Management');
+\define('CO_' . $moduleDirNameUpper . '_' . 'GENERATE', 'Generate');
+\define('CO_' . $moduleDirNameUpper . '_' . 'FILENAME', 'File Name');
+
+//Menu
+\define('CO_' . $moduleDirNameUpper . '_' . 'ADMENU_MIGRATE', 'Migrate');
+\define('CO_' . $moduleDirNameUpper . '_' . 'FOLDER_YES', 'Folder "%s" exist');
+\define('CO_' . $moduleDirNameUpper . '_' . 'FOLDER_NO', 'Folder "%s" does not exist. Create the specified folder with CHMOD 777.');
+\define('CO_' . $moduleDirNameUpper . '_' . 'SHOW_DEV_TOOLS', 'Show Development Tools Button?');
+\define('CO_' . $moduleDirNameUpper . '_' . 'SHOW_DEV_TOOLS_DESC', 'If yes, the "Migrate" Tab and other Development tools will be visible to the Admin.');
+\define('CO_' . $moduleDirNameUpper . '_' . 'ADMENU_FEEDBACK', 'Feedback');
+\define('CO_' . $moduleDirNameUpper . '_' . 'MIGRATE_OK', 'Database migrated to current schema.');
+\define('CO_' . $moduleDirNameUpper . '_' . 'MIGRATE_WARNING', 'Warning! This is intended for developers only. Confirm write schema file from current database.');
+\define('CO_' . $moduleDirNameUpper . '_' . 'MIGRATE_SCHEMA_OK', 'Current schema file written');
+
+//Latest Version Check
+\define('CO_' . $moduleDirNameUpper . '_' . 'NEW_VERSION', 'New Version: ');
+
+//DirectoryChecker
+\define('CO_' . $moduleDirNameUpper . '_' . 'AVAILABLE', "Available ");
+\define('CO_' . $moduleDirNameUpper . '_' . 'NOTAVAILABLE', "Not available ");
+\define('CO_' . $moduleDirNameUpper . '_' . 'NOTWRITABLE', "Should have permission ( %d ), but it has ( %d ) ");
+\define('CO_' . $moduleDirNameUpper . '_' . 'CREATETHEDIR', 'Create it');
+\define('CO_' . $moduleDirNameUpper . '_' . 'SETMPERM', 'Set the permission');
+\define('CO_' . $moduleDirNameUpper . '_' . 'DIRCREATED', 'The directory has been created');
+\define('CO_' . $moduleDirNameUpper . '_' . 'DIRNOTCREATED', 'The directory cannot be created');
+\define('CO_' . $moduleDirNameUpper . '_' . 'PERMSET', 'The permission has been set');
+\define('CO_' . $moduleDirNameUpper . '_' . 'PERMNOTSET', 'The permission cannot be set');
+
+//FileChecker
+//\define('CO_' . $moduleDirNameUpper . '_' . 'AVAILABLE', "Available ");
+//\define('CO_' . $moduleDirNameUpper . '_' . 'NOTAVAILABLE', "Not available ");
+//\define('CO_' . $moduleDirNameUpper . '_' . 'NOTWRITABLE', "Should have permission ( %d ), but it has ( %d ) ");
+//\define('CO_' . $moduleDirNameUpper . '_' . 'COPYTHEFILE', 'Copy it');
+//\define('CO_' . $moduleDirNameUpper . '_' . 'CREATETHEFILE', 'Create it');
+//\define('CO_' . $moduleDirNameUpper . '_' . 'SETMPERM', 'Set the permission');
+
+\define('CO_' . $moduleDirNameUpper . '_' . 'FILECOPIED', 'The file has been copied');
+\define('CO_' . $moduleDirNameUpper . '_' . 'FILENOTCOPIED', 'The file cannot be copied');
+
+//\define('CO_' . $moduleDirNameUpper . '_' . 'PERMSET', 'The permission has been set');
+//\define('CO_' . $moduleDirNameUpper . '_' . 'PERMNOTSET', 'The permission cannot be set');
+
+//image config
+\define('CO_' . $moduleDirNameUpper . '_' . 'CONFIG_EXT_IMAGE', 'EXTERNAL Image configuration');
+
+\define('CO_' . $moduleDirNameUpper . '_' . 'CONFIG_STYLING_START', ':: ');
+\define('CO_' . $moduleDirNameUpper . '_' . 'CONFIG_STYLING_END', ' :: ');
+\define('CO_' . $moduleDirNameUpper . '_' . 'CONFIG_STYLING_DESC_START', '');
+\define('CO_' . $moduleDirNameUpper . '_' . 'CONFIG_STYLING_DESC_END', ' ');
+
+\define('CO_' . $moduleDirNameUpper . '_' . 'PREFERENCE_BREAK_CONFIG_IMAGE', constant('CO_' . $moduleDirNameUpper . '_' . 'CONFIG_STYLING_START') . constant('CO_' . $moduleDirNameUpper . '_' . 'CONFIG_EXT_IMAGE') . constant('CO_' . $moduleDirNameUpper . '_' . 'CONFIG_STYLING_END'));
+\define('CO_' . $moduleDirNameUpper . '_' . 'IMAGE_WIDTH', 'Image Display Width');
+\define('CO_' . $moduleDirNameUpper . '_' . 'IMAGE_WIDTH_DSC', 'Display width for image');
+\define('CO_' . $moduleDirNameUpper . '_' . 'IMAGE_HEIGHT', 'Image Display Height');
+\define('CO_' . $moduleDirNameUpper . '_' . 'IMAGE_HEIGHT_DSC', 'Display height for image');
+\define('CO_' . $moduleDirNameUpper . '_' . 'IMAGE_CONFIG', '--- EXTERNAL Image configuration --- ');
+\define('CO_' . $moduleDirNameUpper . '_' . 'IMAGE_CONFIG_DSC', '');
+\define('CO_' . $moduleDirNameUpper . '_' . 'IMAGE_UPLOAD_PATH', 'Image Upload path');
+\define('CO_' . $moduleDirNameUpper . '_' . 'IMAGE_UPLOAD_PATH_DSC', 'Path for uploading images');
+
+\define('CO_' . $moduleDirNameUpper . '_' . 'IMAGE_FILE_SIZE', 'Image File Size (in Bytes)');
+\define('CO_' . $moduleDirNameUpper . '_' . 'IMAGE_FILE_SIZE_DSC','The maximum file size of the image file (in Bytes)');
+
+//Module Stats
+\define('CO_' . $moduleDirNameUpper . '_' . 'STATS_SUMMARY', 'Module Statistics');
+\define('CO_' . $moduleDirNameUpper . '_' . 'TOTAL_CATEGORIES', 'Categories:');
+\define('CO_' . $moduleDirNameUpper . '_' . 'TOTAL_ITEMS', 'Items');
+\define('CO_' . $moduleDirNameUpper . '_' . 'TOTAL_OFFLINE', 'Offline');
+\define('CO_' . $moduleDirNameUpper . '_' . 'TOTAL_PUBLISHED', 'Published');
+\define('CO_' . $moduleDirNameUpper . '_' . 'TOTAL_REJECTED', 'Rejected');
+\define('CO_' . $moduleDirNameUpper . '_' . 'TOTAL_SUBMITTED', 'Submitted');
+
+\define('CO_' . $moduleDirNameUpper . '_' . 'ERROR403', 'You are not allowed to view this page!');
+
+//Preferences
+\define('CO_' . $moduleDirNameUpper . '_' . 'TRUNCATE_LENGTH', 'Number of Characters to truncate to the long text field');
+\define('CO_' . $moduleDirNameUpper . '_' . 'TRUNCATE_LENGTH_DESC', 'Set the maximum number of characters to truncate the long text fields');
+
+\define('CO_' . $moduleDirNameUpper . '_' . 'DELETE_BLOCK_CONFIRM', 'Are you sure to delete this Block?');
+
+//Cloning
+\define('CO_' . $moduleDirNameUpper . '_' . 'CLONE', 'Clone');
+\define('CO_' . $moduleDirNameUpper . '_' . 'CLONE_DSC', 'Cloning a module has never been this easy! Just type in the name you want for it and hit submit button!');
+\define('CO_' . $moduleDirNameUpper . '_' . 'CLONE_TITLE', 'Clone %s');
+\define('CO_' . $moduleDirNameUpper . '_' . 'CLONE_NAME', 'Choose a name for the new module');
+\define('CO_' . $moduleDirNameUpper . '_' . 'CLONE_NAME_DSC', 'Do not use special characters!
Holmes is stand-alone diagnostic CSS stylesheet that can highlight potentially invalid, inaccessible or erroneous HTML(5) markup by adding one class.
- holmes.css is useful for checking the quality of your code (up to W3C HTML5 standards), nitpicking over ensuring markup is valid and semantic and accessibility guidelines are met, and when you are tasked to fix up and debug an old, OLD website.
- It has a simple implementation and a mostly unobtrusive effect on your page. Not recommended for live environments.
- Remember too that these are just guidelines: if something is flagged but you can't change it for a good reason, don't worry about it :) Also use a validator if you want to be 100% sure.
- Inspired by InuitCss , Eric Meyer , NealGrossKopf and procrastination from coursework!
+
cssHolmes is now a XOOPS design and diagnostics workbench, not just a wrapper around holmes.css.
+
It combines two complementary tools:
+
+ a live in-browser overlay for inspection, measurement, quick local edits, and export
+ an admin-side workbench for theme scans, widget scans, import review, patch drafts, preview/apply, and rollback
+
+
It is especially useful for:
+
+ creating new XTF themes
+ editing or repairing existing XTF themes
+ building and validating XMF widgets
+ debugging admin-theme UI, spacing, semantics, and accessibility
+
+
On plain XOOPS installs without XTF manifests, cssHolmes still works in a reduced generic XOOPS mode for HTML5, accessibility, layout, inspect, measure, copy, export, and widget HTML diagnostics.
+
INSTALL/UNINSTALL
@@ -21,20 +31,70 @@
OPERATING INSTRUCTIONS
- This module and its operations are very simple.Chapter 2.8 of our XOOPS Operations Manual
+
+
1. Enable the overlay
+
The overlay is opt-in and is activated by query string for groups with the Use Overlay permission (Webmasters by default). Typical examples:
+
+ ?holmes=html5?holmes=xtf-theme,a11y,layout?holmes=xtf-theme,xtf-widget?holmes=all
+
Available profiles:
+
+ html5xtf-themextf-widgeta11ylayout
+
+
2. Use the live toolbar
+
The toolbar supports the main day-to-day visual workflow:
+
+ inspect and measuretoken editing for token-aware color preview when an XTF theme.json manifest is availabletypo editing for font size, line height, letter spacing, weight, and alignmenttext for quick local text experimentswidget and slot jumps to the nearest wrappercopy text, copy json, and export selundo for local changes
+
Keyboard shortcuts I, M, T, P and U work while the toolbar is open, never together with Ctrl, Cmd or Alt, and never while you type in a form field. Esc leaves inspect and measure mode; minimising the toolbar does the same.
+
+
3. Review results in the admin workbench
+
The admin side supports:
+
+ theme scans for XTF themes with theme.json and for normal (generic) XOOPS themes; the same scan runs on the command line with bin/holmes-scan.php
+ widget HTML scans
+ importing toolbar JSON exports
+ reviewing imported changes and marking them accepted or rejected
+ file suggestions, patch drafts, preview/apply, and rollback
+ saved workbench history
+
+
+
4. Workflows where cssHolmes is most useful
+
+ finding which token is driving a rendered color in a XTF theme
+ jumping from a nested DOM node to the real widget or slot wrapper
+ testing typography and spacing ideas before touching templates or CSS
+ reviewing widget HTML for accessibility and wrapper issues
+ turning designer experiments into structured developer handoff data
+
+
+
Detailed instructions on configuring the access rights for user groups are available in the
+ Chapter 2.8 of our XOOPS Operations Manual .
+
TUTORIAL
- Tutorial has been started, but we might need your help! Please check out the status of the tutorial here .
- please fork it on GitHub .
- Documentation Process and it will help you to understand how to contribute.
- XOOPS Tutorial Repository on GitBook .
-
+
+
The current local tutorial for designers and developers is:
+
docs/TUTORIAL-cssholmes-XTF-XMF-v2.md
+
It focuses on XTF themes, XMF widgets, admin themes, inspection/export workflow, and the cases where cssHolmes becomes indispensable.
+
Additional strategic planning material is also available locally in:
+
docs/PROPOSAL-cssholmes-v2.md
+
TRANSLATIONS DEVELOPMENT
- This module is Open Source and we would love your help in making it better! You can fork this module on GitHub GitHub XOOPS Core XOOPS Modules XOOPS Themes GET INVOLVED
diff --git a/language/english/help/helpheader.tpl b/language/english/help/helpheader.tpl
index 6aed9f8..0fd5fae 100644
--- a/language/english/help/helpheader.tpl
+++ b/language/english/help/helpheader.tpl
@@ -1,6 +1,6 @@
diff --git a/language/english/help/index.html b/language/english/help/index.html
deleted file mode 100644
index 990cbd6..0000000
--- a/language/english/help/index.html
+++ /dev/null
@@ -1 +0,0 @@
-
\ No newline at end of file
diff --git a/language/english/help/index.php b/language/english/help/index.php
new file mode 100644
index 0000000..2ea9b7d
--- /dev/null
+++ b/language/english/help/index.php
@@ -0,0 +1,3 @@
+history.go(-1);
diff --git a/language/english/index.php b/language/english/index.php
new file mode 100644
index 0000000..b295ab9
--- /dev/null
+++ b/language/english/index.php
@@ -0,0 +1,3 @@
+
+ * @copyright 2000-2026 XOOPS Project (https://xoops.org)
+ * @license GNU GPL 2.0 or later (https://www.gnu.org/licenses/gpl-2.0.html)
+ * @author kris
+ * @author XOOPS Development Team, Mamba
**/
+
+// Guided theme designer.
+define('_MD_CSSHOLMES_DESIGNER_TITLE', 'Theme designer');
+define('_MD_CSSHOLMES_DESIGNER_OPEN', 'Design theme');
+define('_MD_CSSHOLMES_DESIGNER_CLOSE', 'Close');
+define('_MD_CSSHOLMES_DESIGNER_THEME', 'Theme');
+define('_MD_CSSHOLMES_DESIGNER_PICK', 'Pick element');
+define('_MD_CSSHOLMES_DESIGNER_CANCEL_PICK', 'Cancel picking');
+define('_MD_CSSHOLMES_DESIGNER_PICK_HINT', 'Click an element, or focus it and press Enter. Escape cancels.');
+define('_MD_CSSHOLMES_DESIGNER_EMPTY', 'Pick an element to edit its theme styles.');
+define('_MD_CSSHOLMES_DESIGNER_SELECTOR', 'Selector');
+define('_MD_CSSHOLMES_DESIGNER_SELECTED', 'Selected element');
+define('_MD_CSSHOLMES_DESIGNER_MATCHES', '{count} matching elements');
+define('_MD_CSSHOLMES_DESIGNER_SCOPE_NOTE', 'Changes apply to every matching element in this theme.');
+define('_MD_CSSHOLMES_DESIGNER_INVALID_SELECTOR', 'Use up to four tag, class or ID selectors joined by spaces or >. Gallery controls cannot be selected.');
+define('_MD_CSSHOLMES_DESIGNER_NO_MATCHES', 'This selector has no editable matches on this page.');
+define('_MD_CSSHOLMES_DESIGNER_INVALID_VALUE', 'Enter a supported CSS value, or leave blank to remove the override.');
+define('_MD_CSSHOLMES_DESIGNER_INVALID_CONTROLS', 'Correct the highlighted value before continuing.');
+define('_MD_CSSHOLMES_DESIGNER_RULE_LIST', 'Saved and draft rules');
+define('_MD_CSSHOLMES_DESIGNER_CHOOSE_RULE', 'Choose a rule');
+define('_MD_CSSHOLMES_DESIGNER_MODE', 'Color mode');
+define('_MD_CSSHOLMES_DESIGNER_BREAKPOINT', 'Screen size');
+define('_MD_CSSHOLMES_DESIGNER_STATE', 'Element state');
+define('_MD_CSSHOLMES_DESIGNER_ALL', 'All');
+define('_MD_CSSHOLMES_DESIGNER_LIGHT', 'Light');
+define('_MD_CSSHOLMES_DESIGNER_DARK', 'Dark');
+define('_MD_CSSHOLMES_DESIGNER_MOBILE', 'Mobile (up to 575px)');
+define('_MD_CSSHOLMES_DESIGNER_TABLET', 'Tablet (576–991px)');
+define('_MD_CSSHOLMES_DESIGNER_DESKTOP', 'Desktop (992px and up)');
+define('_MD_CSSHOLMES_DESIGNER_NORMAL', 'Normal');
+define('_MD_CSSHOLMES_DESIGNER_HOVER', 'Hover');
+define('_MD_CSSHOLMES_DESIGNER_FOCUS', 'Keyboard focus');
+define('_MD_CSSHOLMES_DESIGNER_PREVIEW_NOTE', 'Preview follows the page color mode, current screen size and actual hover or focus state.');
+define('_MD_CSSHOLMES_DESIGNER_TYPOGRAPHY', 'Typography');
+define('_MD_CSSHOLMES_DESIGNER_COLORS', 'Colors');
+define('_MD_CSSHOLMES_DESIGNER_SPACING', 'Spacing');
+define('_MD_CSSHOLMES_DESIGNER_SIZE', 'Size');
+define('_MD_CSSHOLMES_DESIGNER_BORDER', 'Border');
+define('_MD_CSSHOLMES_DESIGNER_LAYOUT', 'Layout');
+define('_MD_CSSHOLMES_DESIGNER_COLOR', 'Text color');
+define('_MD_CSSHOLMES_DESIGNER_BACKGROUND_COLOR', 'Background color');
+define('_MD_CSSHOLMES_DESIGNER_BORDER_COLOR', 'Border color');
+define('_MD_CSSHOLMES_DESIGNER_FONT_SIZE', 'Font size');
+define('_MD_CSSHOLMES_DESIGNER_LINE_HEIGHT', 'Line height');
+define('_MD_CSSHOLMES_DESIGNER_LETTER_SPACING', 'Letter spacing');
+define('_MD_CSSHOLMES_DESIGNER_FONT_WEIGHT', 'Font weight');
+define('_MD_CSSHOLMES_DESIGNER_FONT_FAMILY', 'Font family');
+define('_MD_CSSHOLMES_DESIGNER_TEXT_ALIGN', 'Text alignment');
+define('_MD_CSSHOLMES_DESIGNER_TEXT_TRANSFORM', 'Text case');
+define('_MD_CSSHOLMES_DESIGNER_TEXT_DECORATION', 'Text decoration');
+define('_MD_CSSHOLMES_DESIGNER_FONT_STYLE', 'Font style');
+define('_MD_CSSHOLMES_DESIGNER_WIDTH', 'Width');
+define('_MD_CSSHOLMES_DESIGNER_HEIGHT', 'Height');
+define('_MD_CSSHOLMES_DESIGNER_MAX_WIDTH', 'Maximum width');
+define('_MD_CSSHOLMES_DESIGNER_MIN_WIDTH', 'Minimum width');
+define('_MD_CSSHOLMES_DESIGNER_MARGIN_TOP', 'Top margin');
+define('_MD_CSSHOLMES_DESIGNER_MARGIN_RIGHT', 'Right margin');
+define('_MD_CSSHOLMES_DESIGNER_MARGIN_BOTTOM', 'Bottom margin');
+define('_MD_CSSHOLMES_DESIGNER_MARGIN_LEFT', 'Left margin');
+define('_MD_CSSHOLMES_DESIGNER_MARGIN_INLINE_START', 'Start margin');
+define('_MD_CSSHOLMES_DESIGNER_MARGIN_INLINE_END', 'End margin');
+define('_MD_CSSHOLMES_DESIGNER_MARGIN_BLOCK_START', 'Block start margin');
+define('_MD_CSSHOLMES_DESIGNER_MARGIN_BLOCK_END', 'Block end margin');
+define('_MD_CSSHOLMES_DESIGNER_PADDING_TOP', 'Top padding');
+define('_MD_CSSHOLMES_DESIGNER_PADDING_RIGHT', 'Right padding');
+define('_MD_CSSHOLMES_DESIGNER_PADDING_BOTTOM', 'Bottom padding');
+define('_MD_CSSHOLMES_DESIGNER_PADDING_LEFT', 'Left padding');
+define('_MD_CSSHOLMES_DESIGNER_PADDING_INLINE_START', 'Start padding');
+define('_MD_CSSHOLMES_DESIGNER_PADDING_INLINE_END', 'End padding');
+define('_MD_CSSHOLMES_DESIGNER_PADDING_BLOCK_START', 'Block start padding');
+define('_MD_CSSHOLMES_DESIGNER_PADDING_BLOCK_END', 'Block end padding');
+define('_MD_CSSHOLMES_DESIGNER_GAP', 'Gap');
+define('_MD_CSSHOLMES_DESIGNER_BORDER_WIDTH', 'Border width');
+define('_MD_CSSHOLMES_DESIGNER_BORDER_RADIUS', 'Corner radius');
+define('_MD_CSSHOLMES_DESIGNER_BORDER_STYLE', 'Border style');
+define('_MD_CSSHOLMES_DESIGNER_DISPLAY', 'Display');
+define('_MD_CSSHOLMES_DESIGNER_ALIGN_ITEMS', 'Align items');
+define('_MD_CSSHOLMES_DESIGNER_JUSTIFY_CONTENT', 'Justify content');
+define('_MD_CSSHOLMES_DESIGNER_DEFAULT_VALUE', 'Theme default');
+define('_MD_CSSHOLMES_DESIGNER_COMPUTED', 'Current: {value}');
+define('_MD_CSSHOLMES_DESIGNER_COLOR_PICKER', '{label} picker');
+define('_MD_CSSHOLMES_DESIGNER_UNDO', 'Undo');
+define('_MD_CSSHOLMES_DESIGNER_REDO', 'Redo');
+define('_MD_CSSHOLMES_DESIGNER_RESET', 'Reset selected');
+define('_MD_CSSHOLMES_DESIGNER_SAVE', 'Save to theme');
+define('_MD_CSSHOLMES_DESIGNER_DISCARD', 'Discard draft');
+define('_MD_CSSHOLMES_DESIGNER_RESTORE', 'Restore previous save');
+define('_MD_CSSHOLMES_DESIGNER_RESTORE_CONFIRM', 'Restore the previous saved theme configuration? This replaces the current saved styles and any draft.');
+define('_MD_CSSHOLMES_DESIGNER_MORE_ACTIONS', 'More actions');
+define('_MD_CSSHOLMES_DESIGNER_RELOAD', 'Reload saved settings');
+define('_MD_CSSHOLMES_DESIGNER_RELOAD_CONFIRM', 'Discard this draft and load the latest saved theme settings?');
+define('_MD_CSSHOLMES_DESIGNER_EXPORT_CSS', 'Export CSS');
+define('_MD_CSSHOLMES_DESIGNER_EXPORT_JSON', 'Export JSON');
+define('_MD_CSSHOLMES_DESIGNER_LOADING', 'Loading theme styles…');
+define('_MD_CSSHOLMES_DESIGNER_READY', 'Ready. Changes preview here until you save.');
+define('_MD_CSSHOLMES_DESIGNER_UNSAVED', 'Unsaved theme changes.');
+define('_MD_CSSHOLMES_DESIGNER_SAVED', 'Saved to theme.');
+define('_MD_CSSHOLMES_DESIGNER_DISCARDED', 'Draft discarded.');
+define('_MD_CSSHOLMES_DESIGNER_RESTORED', 'Previous save restored.');
+define('_MD_CSSHOLMES_DESIGNER_SAVING', 'Saving…');
+define('_MD_CSSHOLMES_DESIGNER_RESTORING', 'Restoring…');
+define('_MD_CSSHOLMES_DESIGNER_REQUEST_FAILED', 'Could not load or save theme styles. Your draft is retained.');
+define('_MD_CSSHOLMES_DESIGNER_PREVIEW_ONLY', 'Preview only. Saving requires workbench permission.');
+define('_MD_CSSHOLMES_DESIGNER_CHANGES', '{count} style rules');
+define('_MD_CSSHOLMES_DESIGNER_UNSUPPORTED', 'This browser cannot open the theme designer.');
+define('_MD_CSSHOLMES_DESIGNER_TARGET_COMMENT_TITLES', 'Comment titles');
+define('_MD_CSSHOLMES_DESIGNER_TARGET_COMMENT_BODY', 'Comment text');
+define('_MD_CSSHOLMES_DESIGNER_TARGET_ARTICLE_TITLES', 'Article titles');
+define('_MD_CSSHOLMES_DESIGNER_TARGET_ARTICLE_BODY', 'Article text');
+define('_MD_CSSHOLMES_DESIGNER_TARGET_BUTTON', 'Buttons');
+define('_MD_CSSHOLMES_DESIGNER_TARGET_INPUT', 'Form fields');
+define('_MD_CSSHOLMES_DESIGNER_TARGET_LABEL', 'Form labels');
+define('_MD_CSSHOLMES_DESIGNER_TARGET_TABLE', 'Tables');
+define('_MD_CSSHOLMES_DESIGNER_TARGET_TABLE_HEADER', 'Table headings');
+define('_MD_CSSHOLMES_DESIGNER_TARGET_MESSAGE', 'Messages');
+define('_MD_CSSHOLMES_DESIGNER_TARGET_QUOTE', 'Quotations');
+define('_MD_CSSHOLMES_DESIGNER_TARGET_LINK', 'Links');
+define('_MD_CSSHOLMES_DESIGNER_LIBRARY', 'Library');
+define('_MD_CSSHOLMES_DESIGNER_STYLE_SETS', 'Style sets');
+define('_MD_CSSHOLMES_DESIGNER_CHOOSE_SET', 'Choose a set or palette');
+define('_MD_CSSHOLMES_DESIGNER_CURRENT_THEME_SETS', 'Current theme');
+define('_MD_CSSHOLMES_DESIGNER_OTHER_THEME_SETS', 'Other themes');
+define('_MD_CSSHOLMES_DESIGNER_STARTER_PALETTES', 'Starter palettes');
+define('_MD_CSSHOLMES_DESIGNER_SET_NAME', 'Set name');
+define('_MD_CSSHOLMES_DESIGNER_SAVE_NEW_SET', 'Save as new set');
+define('_MD_CSSHOLMES_DESIGNER_UPDATE_SET', 'Update selected set');
+define('_MD_CSSHOLMES_DESIGNER_PREVIEW_SET', 'Preview selected');
+define('_MD_CSSHOLMES_DESIGNER_LIKE', 'Like');
+define('_MD_CSSHOLMES_DESIGNER_UNLIKE', 'Unlike');
+define('_MD_CSSHOLMES_DESIGNER_SET_DETAILS', '{author} · {count} likes');
+define('_MD_CSSHOLMES_DESIGNER_LIBRARY_NOTE', 'Library saves do not change the theme. Preview first, then use Save to theme to publish.');
+define('_MD_CSSHOLMES_DESIGNER_SET_SAVED', 'Set saved in library. Theme unchanged.');
+define('_MD_CSSHOLMES_DESIGNER_SET_PREVIEWED', 'Set previewed. Use Save to theme to publish.');
+define('_MD_CSSHOLMES_DESIGNER_REPLACE_DRAFT_CONFIRM', 'Discard the current draft, including invalid values, and preview this selection?');
+define('_MD_CSSHOLMES_DESIGNER_TRANSFER_SETS', 'Import / export');
+define('_MD_CSSHOLMES_DESIGNER_IMPORT_FILE', 'Import set JSON');
+define('_MD_CSSHOLMES_DESIGNER_PREVIEW_IMPORT', 'Preview import');
+define('_MD_CSSHOLMES_DESIGNER_SAVE_IMPORT', 'Save imported set');
+define('_MD_CSSHOLMES_DESIGNER_EXPORT_PORTABLE', 'Export portable set');
+define('_MD_CSSHOLMES_DESIGNER_IMPORT_SIZE', 'Choose a JSON file no larger than 128 KiB.');
+define('_MD_CSSHOLMES_DESIGNER_IMPORT_INVALID', 'Choose a file containing valid JSON.');
+define('_MD_CSSHOLMES_DESIGNER_IMPORT_PREVIEWED', 'Import previewed. Save imported set adds it to the library only.');
+define('_MD_CSSHOLMES_DESIGNER_SET_NAME_REQUIRED', 'Enter a set name.');
+define('_MD_CSSHOLMES_DESIGNER_ORIGINAL_THEME', 'Original theme');
+define('_MD_CSSHOLMES_DESIGNER_COMPARE_ORIGINAL', 'Compare original');
+define('_MD_CSSHOLMES_DESIGNER_PREVIEW_ORIGINAL', 'Preview original defaults');
+define('_MD_CSSHOLMES_DESIGNER_RESET_ORIGINAL', 'Reset theme to original');
+define('_MD_CSSHOLMES_DESIGNER_RESET_ORIGINAL_CONFIRM', 'Remove all published designer overrides and discard this draft? This restores the untouched theme. Library sets are kept.');
+define('_MD_CSSHOLMES_DESIGNER_ORIGINAL_PREVIEWED', 'Original theme previewed. Use Save to theme to publish.');
+define('_MD_CSSHOLMES_DESIGNER_ORIGINAL_RESET', 'Theme reset to original. Library sets kept.');
+define('_MD_CSSHOLMES_DESIGNER_PALETTE_CONTRAST', '{name}: {ratio}:1 · {result}');
+define('_MD_CSSHOLMES_DESIGNER_CONTRAST_PASS', 'Pass');
+define('_MD_CSSHOLMES_DESIGNER_CONTRAST_FAIL', 'Fail');
+
+// xStyles draft previews.
+define('_MD_CSSHOLMES_DESIGNER_GALLERY_TITLE', 'Preview your changes');
+define('_MD_CSSHOLMES_DESIGNER_GALLERY_NOTE', 'Draft previews stay in this tab. Only Save to theme publishes changes for visitors.');
+define('_MD_CSSHOLMES_DESIGNER_GALLERY_VIEW', 'Preview');
+define('_MD_CSSHOLMES_DESIGNER_GALLERY_COMPARE', 'Published vs draft');
+define('_MD_CSSHOLMES_DESIGNER_GALLERY_RESPONSIVE', 'Draft at three screen sizes');
+define('_MD_CSSHOLMES_DESIGNER_GALLERY_WIDTH', 'Viewport width');
+define('_MD_CSSHOLMES_DESIGNER_GALLERY_REFRESH', 'Refresh previews');
+define('_MD_CSSHOLMES_DESIGNER_GALLERY_PUBLISHED', 'Published');
+define('_MD_CSSHOLMES_DESIGNER_GALLERY_DRAFT', 'Unsaved draft');
+define('_MD_CSSHOLMES_DESIGNER_GALLERY_READY', 'Preview ready');
+define('_MD_CSSHOLMES_DESIGNER_GALLERY_LOADING', 'Loading preview...');
+define('_MD_CSSHOLMES_DESIGNER_GALLERY_FAILED', 'Preview unavailable. Refresh to try again.');
+define('_MD_CSSHOLMES_DESIGNER_GALLERY_NO_TARGET', 'Choose an element with Pick element in the designer.');
+define('_MD_CSSHOLMES_DESIGNER_GALLERY_OPEN', 'Open theme designer');
+define('_MD_CSSHOLMES_DESIGNER_GALLERY_CURRENT', 'Current draft');
+define('_MD_CSSHOLMES_DESIGNER_GALLERY_WAIT', 'Open the designer to load your draft.');
diff --git a/language/english/modinfo.php b/language/english/modinfo.php
index 16f3ff2..78e0b90 100644
--- a/language/english/modinfo.php
+++ b/language/english/modinfo.php
@@ -1,4 +1,4 @@
-
+ * @copyright 2000-2026 XOOPS Project (https://xoops.org)
+ * @license GNU GPL 2.0 or later (https://www.gnu.org/licenses/gpl-2.0.html)
+ * @author kris
+ * @author XOOPS Development Team, Mamba
**/
// Module Info
// The name of this module
-define('_MI_CSSHOLMES_NAME', 'Css Holmes');
+define('_MI_CSSHOLMES_NAME', 'cssHolmes');
// A brief description of this module
-define('_MI_CSSHOLMES_DESC', 'CssHolmes is stand-alone diagnostic CSS stylesheet that can highlight potentially invalid or erroneous HTML(5) markup by adding one class');
+define('_MI_CSSHOLMES_DESC', 'cssHolmes is an opt-in XTF theme and widget diagnostics module with profile-based frontend overlays');
// Admin menu links
define('_MI_CSSHOLMES_MANAGER_INDEX', 'Index');
@@ -35,16 +34,21 @@
define('MI_CSSHOLMES_EDITOR_ADMIN_DESC', 'Select the Editor to use by the Admin');
define('MI_CSSHOLMES_EDITOR_USER', 'Editor: User');
define('MI_CSSHOLMES_EDITOR_USER_DESC', 'Select the Editor to use by the User');
+define('_MI_CSSHOLMES_QUERY_KEY', 'Overlay query key');
+define('_MI_CSSHOLMES_QUERY_KEY_DESC', 'Query-string key that activates the cssHolmes overlay, for example ?holmes=html5. It only works for groups with the Use Overlay permission (Webmasters by default).');
//Help
-define('_MI_CSSHOLMES_DIRNAME', basename(dirname(dirname(__DIR__))));
+define('_MI_CSSHOLMES_DIRNAME', basename(dirname(__DIR__, 2)));
define('_MI_CSSHOLMES_HELP_HEADER', __DIR__ . '/help/helpheader.tpl');
define('_MI_CSSHOLMES_BACK_2_ADMIN', 'Back to Administration of ');
define('_MI_CSSHOLMES_OVERVIEW', 'Overview');
//define('_MI_CSSHOLMES_HELP_DIR', __DIR__);
-//help multi-page
+//help multipage
define('_MI_CSSHOLMES_DISCLAIMER', 'Disclaimer');
define('_MI_CSSHOLMES_LICENSE', 'License');
define('_MI_CSSHOLMES_SUPPORT', 'Support');
+
+define('_MI_CSSHOLMES_MANAGER_THEME_SETS', 'Theme sets');
+define('_MI_CSSHOLMES_MANAGER_THEME_SETS_DESC', 'Browse, preview, share and activate named theme sets');
diff --git a/language/french/admin.php b/language/french/admin.php
index a233a54..08c43cc 100644
--- a/language/french/admin.php
+++ b/language/french/admin.php
@@ -1,4 +1,4 @@
-
+ * @copyright 2000-2026 XOOPS Project (https://xoops.org)
+ * @license GNU GPL 2.0 or later (https://www.gnu.org/licenses/gpl-2.0.html)
+ * @author kris
**/
define('_AM_CSSHOLMES_MANAGER_INDEX', 'Index');
define('_AM_CSSHOLMES_MANAGER_ABOUT', 'A propos');
define('_AM_CSSHOLMES_MANAGER_PREFERENCES', 'XooFoo.org');
define('_AM_CSSHOLMES_MANAGER_UPDATE', 'Mise à jour');
-define('_AM_CSSHOLMES_MANAGER_FOOTER', "");
+define('_AM_CSSHOLMES_MANAGER_FOOTER', "");
// Index.php
define(
'_AM_CSSHOLMES_MANAGER_INDEX_TXT1',
- "Holmes est une feuille de style CSS autonome de diagnostic qui peut mettre en évidence des éléments HTML potentiellement incorrects, inaccessible ou erronée.
holmes.css est utile pour vérifier la qualité de votre code (aux standards W3C HTML5), il analyse par balayage le code qui est valide et sémantique et que les lignes directrices d'accessibilité soient remplies. Très utile quand vous êtes chargé de fixer et déboguer votre site. Il possède une implémentation simple et un effet généralement discret sur vos pages. Il n'est pas recommandé pour les environnements de production, bien que les messages ne soient accessibles qu'aux administrateurs.
Rappelez-vous aussi que ce ne sont que des lignes directrices: si quelque chose est indiqué, mais que vous ne pouvez pas le changer pour une bonne raison, ne vous inquiétez pas ! De plus, utilisez un validateur, si vous voulez être sûr à 100%.
Inspiré par InuitCss , Eric Meyer , NealGrossKopf et les altermoiements de travaux de cours!
"
+ "Holmes est une feuille de style CSS autonome de diagnostic qui peut mettre en évidence des éléments HTML potentiellement incorrects, inaccessible ou erronée.
holmes.css est utile pour vérifier la qualité de votre code (aux standards W3C HTML5), il analyse par balayage le code qui est valide et sémantique et que les lignes directrices d'accessibilité soient remplies. Très utile quand vous êtes chargé de fixer et déboguer votre site. Il possède une implémentation simple et un effet généralement discret sur vos pages. Il n'est pas recommandé pour les environnements de production, bien que les messages ne soient accessibles qu'aux administrateurs.
Rappelez-vous aussi que ce ne sont que des lignes directrices: si quelque chose est indiqué, mais que vous ne pouvez pas le changer pour une bonne raison, ne vous inquiétez pas ! De plus, utilisez un validateur, si vous voulez être sûr à 100%.
Inspiré par InuitCss , Eric Meyer , NealGrossKopf et les altermoiements de travaux de cours!
"
);
// About.php
@@ -41,7 +39,6 @@
define('_AM_CSSHOLMES_ABOUT_MODULE_INFO', 'Information sur le module');
define('_AM_CSSHOLMES_ABOUT_AUTHOR_INFO', "Informations sur l'auteur");
-
define('_AM_CSSHOLMES_UPGRADEFAILED0', "Update failed - couldn't rename field '%s'");
define('_AM_CSSHOLMES_UPGRADEFAILED1', "Update failed - couldn't add new fields");
define('_AM_CSSHOLMES_UPGRADEFAILED2', "Update failed - couldn't rename table '%s'");
@@ -57,3 +54,5 @@
define('_AM_CSSHOLMES_ERROR_BAD_REMOVE', 'Could not delete %s');
define('_AM_CSSHOLMES_ERROR_NO_PLUGIN', 'Could not load plugin');
+// Permissions
+define('_AM_CSSHOLMES_PERM_USERS_NOTICE', "Les utilisateurs enregistrés peuvent encore utiliser l'overlay ou les diagnostics de cssHolmes. Les versions précédentes accordaient ce droit à l'installation ; depuis la 3.0.0 Alpha 2, une nouvelle installation réserve tous les outils aux webmestres et une mise à jour ne modifie pas les permissions existantes. Retirez les coches des utilisateurs enregistrés dans Permissions, sauf si vous voulez que les membres voient la barre d'outils.");
diff --git a/language/french/help/help.tpl b/language/french/help/help.tpl
index 2631328..84cd9e3 100644
--- a/language/french/help/help.tpl
+++ b/language/french/help/help.tpl
@@ -7,7 +7,7 @@
holmes.css is useful for checking the quality of your code (up to W3C HTML5 standards), nitpicking over ensuring markup is valid and semantic and accessibility guidelines are met, and when you are tasked to fix up and debug an old, OLD website.
It has a simple implementation and a mostly unobtrusive effect on your page. Not recommended for live environments.
Remember too that these are just guidelines: if something is flagged but you can't change it for a good reason, don't worry about it :) Also use a validator if you want to be 100% sure.
- Inspired by InuitCss , Eric Meyer , NealGrossKopf and procrastination from coursework!
Inspired by InuitCss , Eric Meyer , NealGrossKopf and procrastination from coursework!
INSTALL/UNINSTALL
diff --git a/language/french/help/helpheader.tpl b/language/french/help/helpheader.tpl
index 6aed9f8..0fd5fae 100644
--- a/language/french/help/helpheader.tpl
+++ b/language/french/help/helpheader.tpl
@@ -1,6 +1,6 @@
diff --git a/language/french/help/index.html b/language/french/help/index.html
deleted file mode 100644
index 990cbd6..0000000
--- a/language/french/help/index.html
+++ /dev/null
@@ -1 +0,0 @@
-
\ No newline at end of file
diff --git a/language/french/help/index.php b/language/french/help/index.php
new file mode 100644
index 0000000..2ea9b7d
--- /dev/null
+++ b/language/french/help/index.php
@@ -0,0 +1,3 @@
+history.go(-1);
diff --git a/language/french/index.php b/language/french/index.php
new file mode 100644
index 0000000..b295ab9
--- /dev/null
+++ b/language/french/index.php
@@ -0,0 +1,3 @@
+
+ * @copyright 2000-2026 XOOPS Project (https://xoops.org)
+ * @license GNU GPL 2.0 or later (https://www.gnu.org/licenses/gpl-2.0.html)
+ * @author kris
**/
diff --git a/language/french/modinfo.php b/language/french/modinfo.php
index 3d5e4ea..b3c6616 100644
--- a/language/french/modinfo.php
+++ b/language/french/modinfo.php
@@ -1,4 +1,4 @@
-
+ * @copyright 2000-2026 XOOPS Project (https://xoops.org)
+ * @license GNU GPL 2.0 or later (https://www.gnu.org/licenses/gpl-2.0.html)
+ * @author kris
**/
// Module Info
// The name of this module
-define('_MI_CSSHOLMES_NAME', 'Css Holmes');
+define('_MI_CSSHOLMES_NAME', 'cssHolmes');
// A brief description of this module
-define('_MI_CSSHOLMES_DESC', 'Css Holmes est une feuille de style CSS autonome de diagnostic qui peut mettre en évidence des élements du code HTML potentiellement incorrects ou erronés.');
+define('_MI_CSSHOLMES_DESC', "cssHolmes est un module de diagnostic XTF a activation explicite avec superpositions frontend par profil.");
// Admin menu links
define('_MI_CSSHOLMES_MANAGER_INDEX', 'Index');
@@ -35,16 +33,18 @@
define('MI_CSSHOLMES_EDITOR_ADMIN_DESC', 'Select the Editor to use by the Admin');
define('MI_CSSHOLMES_EDITOR_USER', 'Editor: User');
define('MI_CSSHOLMES_EDITOR_USER_DESC', 'Select the Editor to use by the User');
+define('_MI_CSSHOLMES_QUERY_KEY', "Cle de requete d'overlay");
+define('_MI_CSSHOLMES_QUERY_KEY_DESC', "Cle d'URL qui active l'overlay cssHolmes, par exemple ?holmes=html5. Elle ne fonctionne que pour les groupes ayant la permission Utiliser l'overlay (les webmestres par defaut).");
//Help
-define('_MI_CSSHOLMES_DIRNAME', basename(dirname(dirname(__DIR__))));
+define('_MI_CSSHOLMES_DIRNAME', basename(dirname(__DIR__, 2)));
define('_MI_CSSHOLMES_HELP_HEADER', __DIR__ . '/help/helpheader.tpl');
define('_MI_CSSHOLMES_BACK_2_ADMIN', 'Back to Administration of ');
define('_MI_CSSHOLMES_OVERVIEW', 'Overview');
//define('_MI_CSSHOLMES_HELP_DIR', __DIR__);
-//help multi-page
+//help multipage
define('_MI_CSSHOLMES_DISCLAIMER', 'Disclaimer');
define('_MI_CSSHOLMES_LICENSE', 'License');
define('_MI_CSSHOLMES_SUPPORT', 'Support');
diff --git a/language/index.html b/language/index.html
deleted file mode 100644
index 2c5cdd3..0000000
--- a/language/index.html
+++ /dev/null
@@ -1 +0,0 @@
-
diff --git a/language/index.php b/language/index.php
new file mode 100644
index 0000000..b295ab9
--- /dev/null
+++ b/language/index.php
@@ -0,0 +1,3 @@
+
+
+
+
+ tests/Unit/class/Analyzer
+ tests/Unit/class/Cli
+ tests/Unit/class/Diagnostics
+
+
+
diff --git a/preloads/autoloader.php b/preloads/autoloader.php
index b0c8e17..f8de47d 100644
--- a/preloads/autoloader.php
+++ b/preloads/autoloader.php
@@ -1,15 +1,15 @@
-
+ * @author kris
+ * @author XOOPS Development Team, Mamba
**/
-class CssHolmesCorePreload extends \XoopsPreloadItem
+class CssholmesCorePreload extends \XoopsPreloadItem
{
// to add PSR-4 autoloader
-
/**
- * @param $args
+ * @param array $args
*/
- public static function eventCoreIncludeCommonEnd($args)
+ public static function eventCoreIncludeCommonEnd(array $args): void
{
require_once __DIR__ . '/autoloader.php';
}
- public static function eventCoreHeaderAddmeta()
+ public static function eventCoreHeaderAddmeta(): void
+ {
+ self::injectAssets('site');
+ }
+
+ public static function eventSystemClassGuiHeader(mixed $args): void
{
+ self::injectAssets('admin');
+ }
+
+ /**
+ * Check if the current user has a specific cssHolmes permission.
+ */
+ private static function hasPermission(string $permName, int $moduleId): bool
+ {
+ global $xoopsUser;
+
+ if (!is_object($xoopsUser)) {
+ return false;
+ }
+
+ // Module admins always have all permissions
+ if ($xoopsUser->isAdmin($moduleId)) {
+ return true;
+ }
+
+ /** @var \XoopsGroupPermHandler $grouppermHandler */
+ $grouppermHandler = xoops_getHandler('groupperm');
+ $userGroups = $xoopsUser->getGroups();
+
+ return $grouppermHandler->checkRight($permName, 1, $userGroups, $moduleId);
+ }
+
+ private static function injectAssets(string $scope): void
+ {
+ if (defined('XSTYLES_PREVIEW_FRAME') && XSTYLES_PREVIEW_FRAME === true) {
+ return;
+ }
global $xoTheme, $xoopsUser;
- $xoopsModule = XoopsModule::getByDirname('cssholmes');
- // Add scripts and Css if only User is xoopsAdmin
- if (!is_object($xoopsUser) || !is_object($xoopsModule) || !$xoopsUser->isAdmin($xoopsModule->mid())) {
- $xoTheme->addStylesheet(XOOPS_URL . '/modules/cssholmes/assets/css/style.css');
- } else {
- $xoTheme->addStylesheet(XOOPS_URL . '/modules/cssholmes/assets/css/holmes.css');
- $xoTheme->addScript(XOOPS_URL . '/modules/cssholmes/assets/js/holmes.js');
+
+ if (!is_object($xoTheme) || !is_object($xoopsUser)) {
+ return;
}
+
+ static $injectedScopes = [];
+ if (isset($injectedScopes[$scope])) {
+ return;
+ }
+
+ $moduleDirName = basename(\dirname(__DIR__));
+ $moduleId = null;
+ if (\function_exists('xoops_getHandler')) {
+ $moduleHandler = xoops_getHandler('module');
+ if (is_object($moduleHandler) && method_exists($moduleHandler, 'getByDirname')) {
+ $xoopsModule = $moduleHandler->getByDirname($moduleDirName);
+ if (is_object($xoopsModule) && method_exists($xoopsModule, 'getVar')) {
+ $moduleId = (int)$xoopsModule->getVar('mid');
+ }
+ }
+ }
+
+ if ($moduleId === null) {
+ return;
+ }
+
+ // Must have at least overlay permission to see anything
+ if (!self::hasPermission($moduleDirName . '_overlay', $moduleId)) {
+ return;
+ }
+
+ // Build permission flags to pass to JS
+ $perms = [
+ 'overlay' => true,
+ 'edit' => self::hasPermission($moduleDirName . '_edit', $moduleId),
+ 'diagnose' => self::hasPermission($moduleDirName . '_diagnose', $moduleId),
+ 'export' => self::hasPermission($moduleDirName . '_export', $moduleId),
+ 'workbench' => self::hasPermission($moduleDirName . '_workbench', $moduleId),
+ ];
+
+ $helper = \XoopsModules\Cssholmes\Helper::getInstance();
+ $queryKey = (string)$helper->getConfig('holmes_query_key');
+ if ('' === trim($queryKey)) {
+ $queryKey = 'holmes';
+ }
+
+ $moduleUrl = XOOPS_URL . '/modules/' . $moduleDirName;
+ $themeKey = '';
+ $themeManifestPath = '';
+ $themeManifestUrl = '';
+ if ('admin' === $scope && isset($xoTheme->folderName) && is_string($xoTheme->folderName) && '' !== trim($xoTheme->folderName)) {
+ $themeKey = trim($xoTheme->folderName);
+ $themeManifestPath = XOOPS_ADMINTHEME_PATH . '/' . $themeKey . '/theme.json';
+ $themeManifestUrl = XOOPS_ADMINTHEME_URL . '/' . $themeKey . '/theme.json';
+ } elseif ('site' === $scope) {
+ $themeKey = trim((string)($GLOBALS['xoopsConfig']['theme_set'] ?? ($xoTheme->folderName ?? '')));
+ if ('' !== $themeKey) {
+ $themeManifestPath = XOOPS_THEME_PATH . '/' . $themeKey . '/theme.json';
+ $themeManifestUrl = XOOPS_THEME_URL . '/' . $themeKey . '/theme.json';
+ }
+ }
+ $hasThemeManifest = '' !== $themeManifestPath && is_file($themeManifestPath);
+ if (!$hasThemeManifest) {
+ $themeManifestUrl = '';
+ }
+
+ $overlay = \XoopsModules\Cssholmes\Diagnostics\OverlayConfig::fromRequest(
+ \Xmf\Request::getString($queryKey, '', 'GET')
+ );
+ $initialProfiles = $overlay->profiles();
+ if (!$hasThemeManifest) {
+ $initialProfiles = array_values(array_filter(
+ $initialProfiles,
+ static fn (string $profile): bool => !in_array($profile, ['xtf-theme', 'xtf-widget'], true)
+ ));
+ }
+
+ if ([] !== $initialProfiles) {
+ foreach ($initialProfiles as $profile) {
+ $stylesheetPath = 'assets/css/profiles/' . $profile . '.css';
+ $xoTheme->addStylesheet($moduleUrl . '/' . $stylesheetPath);
+ }
+ }
+
+ $permString = implode(',', array_keys(array_filter($perms)));
+
+ $xoTheme->addScript(
+ $moduleUrl
+ . '/assets/js/holmes.js?queryKey=' . rawurlencode($queryKey)
+ . '&initialProfiles=' . rawurlencode(implode(',', $initialProfiles))
+ . '&moduleUrl=' . rawurlencode($moduleUrl)
+ . '&scope=' . rawurlencode($scope)
+ . '&themeKey=' . rawurlencode($themeKey)
+ . '&themeManifestUrl=' . rawurlencode($themeManifestUrl)
+ . '&perms=' . rawurlencode($permString)
+ );
+
+ $injectedScopes[$scope] = true;
}
}
diff --git a/preloads/designer.php b/preloads/designer.php
new file mode 100644
index 0000000..2966892
--- /dev/null
+++ b/preloads/designer.php
@@ -0,0 +1,57 @@
+folderName;
+ try {
+ $store = cssholmes_designer_store();
+ $state = $store->load($active);
+ $styleUrl = $moduleUrl . '/theme-style.php?' . http_build_query(['theme' => $active]);
+ if ($state['rules'] !== []) {
+ $theme->addStylesheet($styleUrl . '&v=' . rawurlencode($state['revision']), ['id' => 'cssholmes-theme-style']);
+ }
+ if (defined('XSTYLES_PREVIEW_FRAME') && XSTYLES_PREVIEW_FRAME === true) {
+ $theme->template->assign('cssholmes_designer_available', false);
+ return;
+ }
+ $access = cssholmes_designer_access();
+ $theme->template->assign('cssholmes_designer_available', $access['edit']);
+ if (!$access['edit']) {
+ return;
+ }
+ $config = [
+ 'theme' => $active, 'endpoint' => $moduleUrl . '/designer.php',
+ 'styleUrl' => $styleUrl, 'stylesheetUrl' => $moduleUrl . '/assets/css/designer.css',
+ 'token' => '', 'canSave' => $access['save'], 'canExport' => $access['export'], 'labels' => cssholmes_designer_labels(),
+ 'autoOpen' => \Xmf\Request::getString('designer', '0', 'GET') === '1',
+ 'properties' => $store::properties(),
+ 'libraryEndpoint' => $moduleUrl . '/sets.php',
+ 'initialSetId' => \Xmf\Request::getString('theme_set', '', 'GET'),
+ ];
+ // addScript wraps inline content in JavaScript comments, which are invalid JSON.
+ $theme->htmlHeadStrings[] = '';
+ $theme->addScript($moduleUrl . '/assets/js/designer-diagnostics.js', ['defer' => 'defer']);
+ $theme->addScript($moduleUrl . '/assets/js/designer.js', ['defer' => 'defer']);
+ $theme->addScript($moduleUrl . '/assets/js/gallery-designer.js', ['defer' => 'defer']);
+ $theme->addStylesheet($moduleUrl . '/assets/css/gallery-designer.css', ['id' => 'cssholmes-gallery-style']);
+ } catch (\Throwable $error) {
+ // A bad configuration must not take the public site offline.
+ $GLOBALS['xoopsLogger']->addExtra('Theme Designer', 'Saved theme configuration could not be loaded.');
+ }
+ }
+}
diff --git a/preloads/index.html b/preloads/index.html
index 2c5cdd3..990cbd6 100644
--- a/preloads/index.html
+++ b/preloads/index.html
@@ -1 +1 @@
-
+
\ No newline at end of file
diff --git a/qodana.yaml b/qodana.yaml
new file mode 100644
index 0000000..ad7484c
--- /dev/null
+++ b/qodana.yaml
@@ -0,0 +1,16 @@
+version: '1.0'
+image: jetbrains/qodana-php:2026.2
+profile:
+ name: qodana.recommended
+php:
+ version: '8.4'
+exclude:
+ - name: All
+ paths:
+ - vendor
+ - node_modules
+ - .build
+ - .qodana
+ - coverage
+ - templates_c
+ - uploads
diff --git a/sets.php b/sets.php
new file mode 100644
index 0000000..f75caa8
--- /dev/null
+++ b/sets.php
@@ -0,0 +1,226 @@
+activated = false;
+ $GLOBALS['xoopsLogger']->renderingEnabled = false;
+}
+header('Content-Type: application/json; charset=UTF-8');
+header('Cache-Control: no-store');
+header('X-Content-Type-Options: nosniff');
+$reply = static function (int $status, array $data): never {
+ http_response_code($status);
+ echo json_encode($data, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_THROW_ON_ERROR);
+ exit;
+};
+$access = cssholmes_designer_access();
+if (!$access['edit']) {
+ $signedIn = is_object($GLOBALS['xoopsUser'] ?? null);
+ $reply(403, [
+ 'ok' => false, 'code' => $signedIn ? 'permission_denied' : 'auth_required',
+ 'error' => $signedIn ? 'Theme designer access is required.' : 'Sign in again in another tab, then retry this action. Your draft is kept.',
+ ]);
+}
+$method = $_SERVER['REQUEST_METHOD'] ?? 'GET';
+if (!in_array($method, ['GET', 'POST'], true)) {
+ header('Allow: GET, POST');
+ $reply(405, ['ok' => false, 'error' => 'Use GET or POST.']);
+}
+
+try {
+ $actor = ['id' => (int) $GLOBALS['xoopsUser']->getVar('uid'), 'name' => (string) $GLOBALS['xoopsUser']->getVar('uname', 'n')];
+ if ($actor['id'] < 1) {
+ $reply(403, ['ok' => false, 'error' => 'A registered designer account is required.']);
+ }
+ $module = xoops_getHandler('module')->getByDirname('cssholmes');
+ $admin = $GLOBALS['xoopsUser']->isAdmin((int) $module->getVar('mid'));
+ $store = cssholmes_designer_store();
+ $format = new SetFormat($store);
+ $library = new SetLibrary(XOOPS_VAR_PATH . '/configs/cssholmes/designer');
+ $palettes = $format->builtins();
+ $extra = [];
+ $data = [];
+ if ($method === 'POST') {
+ if ((int) ($_SERVER['CONTENT_LENGTH'] ?? 0) > 131072) {
+ $reply(413, ['ok' => false, 'error' => 'Configuration sets must be smaller than 128 KiB.']);
+ }
+ $input = fopen('php://input', 'rb');
+ $raw = $input === false ? false : stream_get_contents($input, 131073);
+ if (is_resource($input)) {
+ fclose($input);
+ }
+ if ($raw === false || strlen($raw) > 131072) {
+ $reply(413, ['ok' => false, 'error' => 'Configuration sets must be smaller than 128 KiB.']);
+ }
+ $data = json_decode($raw, true, 32, JSON_THROW_ON_ERROR);
+ if (!is_array($data) || array_is_list($data)) {
+ throw new InvalidArgumentException('A JSON object is required.');
+ }
+ $token = $data['token'] ?? null;
+ if (!is_string($token) || !$GLOBALS['xoopsSecurity']->check(false, $token, 'CSSHOLMES_DESIGNER')) {
+ $reply(403, [
+ 'ok' => false, 'code' => 'csrf_expired',
+ 'error' => 'Your editing token was renewed. Try the action again. Your draft is kept.',
+ 'token' => $GLOBALS['xoopsSecurity']->createToken(1800, 'CSSHOLMES_DESIGNER'),
+ ]);
+ }
+ }
+ $theme = $method === 'GET' ? \Xmf\Request::getString('theme', (string) ($GLOBALS['xoopsConfig']['theme_set'] ?? 'default'), 'GET') : ($data['theme'] ?? null);
+ if (!is_string($theme)) {
+ throw new InvalidArgumentException('A theme is required.');
+ }
+ $state = $store->load($theme);
+ $resolve = static function (string $id) use ($library, $palettes, $format, $theme): array {
+ if ($id === 'original') {
+ return ['rules' => [], 'warnings' => [], 'document' => $format->fromRules($theme, 'Original defaults', [])];
+ }
+ foreach ($palettes as $palette) {
+ if ($palette['id'] === $id) {
+ return $format->resolve($palette['payload'], $theme) + ['document' => $palette['payload']];
+ }
+ }
+ $record = $library->get($id);
+ return $format->resolve($record['payload'], $theme) + ['document' => $record['payload'],
+ 'set' => ['id' => $record['id'], 'revision' => $record['revision']]];
+ };
+ if ($method === 'GET') {
+ $action = \Xmf\Request::getString('action', 'list', 'GET');
+ if ($action === 'export' && !$access['export']) {
+ $reply(403, ['ok' => false, 'error' => 'Export permission is required.']);
+ }
+ if (in_array($action, ['preview', 'export'], true)) {
+ $preview = $resolve(\Xmf\Request::getString('id', '', 'GET'));
+ $extra[$action === 'export' ? 'exported' : 'preview'] = $action === 'export' ? $preview['document'] : $preview;
+ } elseif ($action !== 'list') {
+ throw new InvalidArgumentException('Unknown library action.');
+ }
+ } else {
+ $operation = $data['op'] ?? null;
+ if (!is_string($operation)) {
+ throw new InvalidArgumentException('An operation is required.');
+ }
+ if ($operation === 'exportCurrent' && !$access['export']) {
+ $reply(403, ['ok' => false, 'error' => 'Export permission is required.']);
+ }
+ if (!$access['save'] && !in_array($operation, ['like', 'exportCurrent', 'previewImport'], true)) {
+ $reply(403, ['ok' => false, 'error' => 'Workbench permission is required to change saved sets or the active theme.']);
+ }
+ $string = static function (string $key, string $default = '') use ($data): string {
+ $value = $data[$key] ?? $default;
+ if (!is_string($value)) {
+ throw new InvalidArgumentException('Invalid ' . $key . '.');
+ }
+ return $value;
+ };
+ $document = static function () use ($data, $format): array {
+ if (!is_array($data['document'] ?? null)) {
+ throw new InvalidArgumentException('A configuration document is required.');
+ }
+ $document = $data['document'];
+ if (array_diff(array_keys($document), ['theme', 'rules']) === []
+ && is_string($document['theme'] ?? null) && is_array($document['rules'] ?? null)) {
+ return $format->fromRules($document['theme'], 'Imported theme set', $document['rules']);
+ }
+ return $format->normalize($document);
+ };
+ if (in_array($operation, ['saveSet', 'updateSet', 'exportCurrent'], true)) {
+ if (!is_array($data['rules'] ?? null)) {
+ throw new InvalidArgumentException('A rules list is required.');
+ }
+ $name = $string('name', 'My theme set');
+ if ($operation === 'exportCurrent' && trim($name) === '') {
+ $name = 'Theme configuration';
+ }
+ $payload = $format->fromRules($theme, $name, $data['rules']);
+ if ($operation === 'exportCurrent') {
+ $extra['document'] = $payload;
+ } elseif ($operation === 'saveSet') {
+ $extra['set'] = $library->create($theme, $payload['name'], $payload, $actor);
+ } else {
+ $existing = $library->get($string('id'));
+ if (!$admin && $existing['author']['id'] !== $actor['id']) {
+ $reply(403, ['ok' => false, 'error' => 'Only the author or a module administrator can update this set.']);
+ }
+ if ($existing['theme'] !== $theme) {
+ throw new InvalidArgumentException('Save a new set to keep an adapted copy in another theme.');
+ }
+ $extra['set'] = $library->update($existing['id'], $payload['name'], $payload, $actor, $admin, $string('setRevision'));
+ }
+ } elseif ($operation === 'importSet' || $operation === 'previewImport') {
+ $payload = $document();
+ if (isset($data['name']) && $string('name') !== '') {
+ $payload['name'] = $string('name');
+ $payload = $format->normalize($payload);
+ }
+ $extra['preview'] = $format->resolve($payload, $theme) + ['document' => $payload];
+ if ($operation === 'importSet') {
+ $extra['set'] = $library->create($theme, $payload['name'], $payload, $actor);
+ }
+ } elseif ($operation === 'cloneSet') {
+ $payload = $resolve($string('id'))['document'];
+ $payload['name'] = $string('name');
+ $payload = $format->normalize($payload);
+ $extra['set'] = $library->create($theme, $payload['name'], $payload, $actor);
+ } elseif ($operation === 'like') {
+ if (!is_bool($data['liked'] ?? null)) {
+ throw new InvalidArgumentException('The liked value must be true or false.');
+ }
+ $extra['set'] = $library->like($string('id'), $actor['id'], $data['liked']);
+ } elseif ($operation === 'deleteSet') {
+ $existing = $library->get($string('id'));
+ if (!$admin && $existing['author']['id'] !== $actor['id']) {
+ $reply(403, ['ok' => false, 'error' => 'Only the author or a module administrator can delete this set.']);
+ }
+ $library->delete($existing['id'], $actor, $admin, $string('setRevision'));
+ } elseif ($operation === 'activate' || $operation === 'reset') {
+ $rules = $operation === 'reset' ? [] : $resolve($string('id'))['rules'];
+ $state = $store->save($theme, $rules, $string('revision'));
+ } else {
+ throw new InvalidArgumentException('Unknown library operation.');
+ }
+ }
+ $summary = static function (array $record) use ($actor, $admin): array {
+ $record['likes'] = count($record['likedBy']);
+ $record['liked'] = in_array($actor['id'], $record['likedBy'], true);
+ $record['editable'] = $admin || $record['author']['id'] === $actor['id'];
+ unset($record['payload'], $record['likedBy']);
+ return $record;
+ };
+ if (isset($extra['set'])) {
+ $extra['set'] = $summary($extra['set']);
+ }
+ $themes = [];
+ foreach (new DirectoryIterator(XOOPS_ROOT_PATH . '/themes') as $folder) {
+ if (!$folder->isDot() && $folder->isDir() && !$folder->isLink()
+ && preg_match('/^[A-Za-z0-9_][A-Za-z0-9_.-]{0,79}$/D', $folder->getFilename())
+ && (is_file($folder->getPathname() . '/theme.tpl') || is_file($folder->getPathname() . '/theme.html'))) {
+ $themes[] = $folder->getFilename();
+ }
+ }
+ natcasesort($themes);
+ $reply(200, $extra + [
+ 'ok' => true, 'state' => $state, 'canSave' => $access['save'], 'canExport' => $access['export'], 'isAdmin' => $admin,
+ 'token' => $GLOBALS['xoopsSecurity']->createToken(1800, 'CSSHOLMES_DESIGNER'),
+ 'library' => [
+ 'themes' => array_values($themes), 'sets' => array_map($summary, $library->all()),
+ 'palettes' => array_map(static function (array $palette): array {
+ unset($palette['payload']);
+ return $palette;
+ }, $palettes),
+ ],
+ ]);
+} catch (ConflictException $error) {
+ $reply(409, ['ok' => false, 'error' => 'These settings changed elsewhere. Reload the library before saving again.']);
+} catch (InvalidArgumentException | JsonException $error) {
+ $reply(422, ['ok' => false, 'error' => $error instanceof JsonException ? 'Invalid JSON configuration.' : $error->getMessage()]);
+} catch (Throwable $error) {
+ $reply(500, ['ok' => false, 'error' => 'The theme-set library could not be read or saved. Check its private storage permissions.']);
+}
diff --git a/templates/admin/index.html b/templates/admin/index.html
deleted file mode 100644
index 2c5cdd3..0000000
--- a/templates/admin/index.html
+++ /dev/null
@@ -1 +0,0 @@
-
diff --git a/templates/admin/index.php b/templates/admin/index.php
new file mode 100644
index 0000000..b295ab9
--- /dev/null
+++ b/templates/admin/index.php
@@ -0,0 +1,3 @@
+*}>
+
+
+
cssHolmes Test Suites
+
+ cssHolmes now has two complementary reference pages: the legacy HTML5 markup suite and a modern XTF/XMF theme and widget suite.
+ Use the first for baseline markup diagnostics and the second for XTF tokens, slots, widgets, admin-style cards, and export-oriented inspection work.
+
+
+ On plain XOOPS installs without XTF manifests, cssHolmes still runs in a reduced generic mode for inspect, measure, HTML5, accessibility, layout, and widget HTML diagnostics.
+
+
-<{include file="db:cssholmes_testsuite.tpl"}>
+
+
+
Legacy HTML5 Suite
+
+ Original markup-oriented checks for links, forms, deprecated elements, and baseline HTML smells.
+
+
+ Open HTML5 Suite
+
+
-<{*<{include file="db:cssholmes_footer.tpl"}>*}>
+
+
Modern XTF/XMF Suite
+
+ Practical samples for tokens, slots, widgets, admin-style cards, accessibility hints, and export-friendly inspection.
+
+
+ Open XTF/XMF Suite
+
+
+
+
+
Admin Workbench
+
+ Theme scans, widget scans, import review, patch drafts, preview/apply/rollback flow, and workbench history.
+
+
+ Open Workbench
+
+
+
+
holmes.css - Test Suite (v 1.0)
- cssHolmes - HTML5 Profile Test Suite
+
@@ -123,15 +123,15 @@
Normal Input
-
Input with no name
-
Input with empty name
-
Normal Select
diff --git a/templates/cssholmes_xtf_testsuite.tpl b/templates/cssholmes_xtf_testsuite.tpl
new file mode 100644
index 0000000..d610f72
--- /dev/null
+++ b/templates/cssholmes_xtf_testsuite.tpl
@@ -0,0 +1,551 @@
+
+ cssHolmes - XTF/XMF Test Suite
+
+
+ cssHolmes Modern Test Suite
+ XTF Themes, XMF Widgets, Slots, Tokens, and Admin-Like UI
+
+ Use this page with the cssHolmes toolbar to exercise token matching, slot and widget jumps, typography edits,
+ layout checks, widget diagnostics, accessibility hints, and export-ready inspection context.
+
+
+
+
+
+ Suggested Flow
+
+ Inspect a card or widget root.
+ Jump to the nearest widget or slot wrapper.
+ Try token or typography changes locally.
+ Export the useful result to the workbench.
+
+
+
+ Toolbar Targets
+ Cards below include token-backed accents, nested widgets, deliberate spacing differences, and common admin-style UI elements.
+
+
+ Expected Behavior
+ Most cards are intended to be clean for `xtf-theme`. The `Known Problems` cards and `Problem Form` intentionally trigger warnings.
+
+
+
+
+
+
+
+
+
Feature Card
+
Token-aware theme surface
+
This widget uses token-like values, content spacing, and nested text so you can test inspect, token matching, typo edits, and export flow in one place.
+
+
+
+ Stable wrapper class for widget selection
+ Nested text for text replacement preview
+ Visible accent color for token inspection
+
+
+
+
+
+ Stats
+ 128
+ Published widget instances
+
+
+ Warning Card
+ Useful for checking contrast, spacing, and message hierarchy.
+
+
+
+
+ Admin-like Module List
+
+
+
+ Module
+ Status
+ Owner
+
+
+
+
+ Menus
+ Healthy Core
+
+
+ BlocksAdmin
+ Review Admin UI
+
+
+ Widgets
+ New XMF
+
+
+
+
+
+
+
+ Known Problems
+ Accessibility and Content Smells
+ Ambiguous link
+ This card intentionally mixes an empty button, missing image alt, and placeholder link target.
+
+
+
+ Known Problems
+ Layout and Widget Edge Cases
+
+
+
+
SVG without width/height attributes
+
+
+
+
Deep wrapper nesting for layout inspection
+
+
+
Useful for widget SVG checks, wrapper depth checks, and spacing inspection.
+
+
+
+
]*)>/', $html, $match));
+ $this->assertStringContainsString('alt=', $match[1]);
+ }
+
+ public function testCommentsAreRemovedAndLineBreaksKept(): void
+ {
+ $source = "a<{* one\n two class="on"<{/if}>><{$smarty.const.LABEL}> ';
+
+ $this->assertSame('SMARTY ', SmartySource::neutralise($source));
+ }
+
+ public function testQuotedStringsMayContainTheClosingDelimiter(): void
+ {
+ $source = 'b"}>">t
';
+
+ $this->assertSame('t
', SmartySource::neutralise($source));
+ }
+
+ public function testLiteralBlocksKeepTheirContent(): void
+ {
+ $source = '<{literal}><{/literal}><{$x}>';
+
+ $this->assertSame('SMARTY', SmartySource::neutralise($source));
+ }
+
+ public function testHtmlViewBlanksScriptsStylesAndComments(): void
+ {
+ $source = "";
+
+ $this->assertSame("", SmartySource::htmlView($source));
+ }
+
+ public function testDynamicAttributesAreDetectedOnlyOutsideQuotes(): void
+ {
+ $this->assertTrue(SmartySource::hasDynamicAttributes(' src="x" SMARTY'));
+ $this->assertFalse(SmartySource::hasDynamicAttributes(' src="SMARTY" alt="SMARTY"'));
+ }
+
+ public function testLineNumbersSurviveNeutralising(): void
+ {
+ $source = "<{if \$a\n && \$b}>\nassertSame(3, SmartySource::lineAt($view, $offset));
+ }
+}
diff --git a/tests/Unit/class/Analyzer/TemplateIncludeResolverTest.php b/tests/Unit/class/Analyzer/TemplateIncludeResolverTest.php
new file mode 100644
index 0000000..93fa6bf
--- /dev/null
+++ b/tests/Unit/class/Analyzer/TemplateIncludeResolverTest.php
@@ -0,0 +1,91 @@
+resolve('"$theme_name/tpl/header.tpl"');
+
+ $this->assertSame(TemplateIncludeResolver::STATUS_THEME, $result['status']);
+ $this->assertSame('tpl/header.tpl', $result['path']);
+ $this->assertTrue($result['exists']);
+ }
+
+ public function testCustomVariableAssignedFromFolderNameIsLearnt(): void
+ {
+ $resolver = new TemplateIncludeResolver(self::FIXTURES . '/smartytheme');
+
+ $this->assertContains('tname', $resolver->themeVariables());
+ $this->assertSame('tpl/header.tpl', $resolver->resolve('"$tname/tpl/header.tpl"')['path']);
+ $this->assertSame('tpl/header.tpl', $resolver->resolve('"{$tname}/tpl/header.tpl"')['path']);
+ }
+
+ public function testFolderNamePatternsAreResolved(): void
+ {
+ $resolver = new TemplateIncludeResolver(self::FIXTURES . '/cleantheme');
+
+ $arguments = [
+ '"`$xoTheme->folderName`/tpl/header.tpl"',
+ '"$xoTheme->folderName/tpl/header.tpl"',
+ "\$xoTheme->folderName|cat:'/tpl/header.tpl'",
+ "\$theme_name|cat:'/tpl/'|cat:'header.tpl'",
+ ];
+ foreach ($arguments as $argument) {
+ $result = $resolver->resolve($argument);
+ $this->assertSame('tpl/header.tpl', $result['path'], $argument);
+ $this->assertTrue($result['exists'], $argument);
+ }
+ }
+
+ public function testPlainRelativeNamesResolveInsideTheTheme(): void
+ {
+ $resolver = new TemplateIncludeResolver(self::FIXTURES . '/cleantheme');
+
+ $this->assertTrue($resolver->resolve('"tpl/header.tpl"')['exists']);
+ $this->assertTrue($resolver->resolve('"header.tpl"', 'tpl/other.tpl')['exists']);
+ $this->assertSame('cleantheme/tpl/header.tpl', $resolver->themeName() . '/' . $resolver->resolve("'cleantheme/tpl/header.tpl'")['path']);
+ }
+
+ public function testModuleAndDynamicIncludesAreNeverMissing(): void
+ {
+ $resolver = new TemplateIncludeResolver(self::FIXTURES . '/cleantheme');
+
+ $this->assertSame(TemplateIncludeResolver::STATUS_MODULE, $resolver->resolve("'db:system_block_user.tpl'")['status']);
+ $this->assertSame(TemplateIncludeResolver::STATUS_DYNAMIC, $resolver->resolve('"db:system_block_$block.template"')['status']);
+ $this->assertSame(TemplateIncludeResolver::STATUS_DYNAMIC, $resolver->resolve('$block.template')['status']);
+ $this->assertSame(TemplateIncludeResolver::STATUS_EXTERNAL, $resolver->resolve('"file:/var/www/x.tpl"')['status']);
+ }
+
+ public function testIncludesInReportsLineAndStatus(): void
+ {
+ $resolver = new TemplateIncludeResolver(self::FIXTURES . '/smartytheme');
+ $source = (string)file_get_contents(self::FIXTURES . '/smartytheme/theme.tpl');
+ $includes = $resolver->includesIn($source, 'theme.tpl');
+
+ $this->assertCount(3, $includes);
+ $this->assertSame([8, true], [$includes[0]['line'], $includes[0]['exists']]);
+ $this->assertSame([9, false, 'tpl/missing.tpl'], [$includes[1]['line'], $includes[1]['exists'], $includes[1]['path']]);
+ $this->assertSame(TemplateIncludeResolver::STATUS_MODULE, $includes[2]['status']);
+ }
+
+ public function testExpandedPageInlinesThePartials(): void
+ {
+ $resolver = new TemplateIncludeResolver(self::FIXTURES . '/cleantheme');
+ $page = $resolver->expandedPage();
+
+ $this->assertStringContainsString(' 
\n" . "