diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index ae73b7f..f2d7b21 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,6 +1,6 @@ # Contributing to cssHolmes -Submit focused pull requests to [mambax7/cssholmes](https://github.com/mambax7/cssholmes). +Submit focused pull requests to [XoopsModules27x/cssholmes](https://github.com/XoopsModules27x/cssholmes). Use PSR-12, preserve public APIs and existing request/CSRF validation, and add a regression test beside the affected behavior. Describe the problem, behavior change, compatibility impact and commands actually run. Include screenshots for diff --git a/README.md b/README.md index bf56589..792d7a2 100644 --- a/README.md +++ b/README.md @@ -22,9 +22,7 @@ Back up the site's files and database before an installed-module upgrade. ## Development checks -Use a complete source checkout, including the testing/tooling files supplied by -[the final QA change](https://github.com/XoopsModules25x/cssholmes/pull/9). -Documentation-only review branches are incomplete; release ZIPs intentionally +Use a complete source checkout from the repository. Release ZIPs intentionally exclude `tests/`, PHPUnit configuration and other development files. If `tests/run.php` is absent, obtain the complete source before running these commands. @@ -34,7 +32,7 @@ regressions plus the analyzer, CLI and diagnostic PHPUnit tests using shared to that shared vendor directory. `php tests/run.php --browser` also runs the browser regressions with an existing Playwright/Chromium installation. -Source and issues: [XoopsModules25x/cssholmes](https://github.com/XoopsModules25x/cssholmes). +Source and issues: [XoopsModules27x/cssholmes](https://github.com/XoopsModules27x/cssholmes). The repository's CI checks PHP 8.4/8.5; release tags run CI before creating a clean module ZIP. Qodana is optional and explicitly skips its scan when `QODANA_TOKEN` is unavailable. A skipped scan is not a quality result. diff --git a/class/Common/VersionChecks.php b/class/Common/VersionChecks.php index 509fe42..ef0e233 100644 --- a/class/Common/VersionChecks.php +++ b/class/Common/VersionChecks.php @@ -96,8 +96,7 @@ public static function checkVerModule(\Xmf\Module\Helper $helper, ?string $sourc $moduleDirName = \basename(\dirname(__DIR__, 2)); $moduleDirNameUpper = \mb_strtoupper($moduleDirName); $update = ''; - $repository = 'XoopsModules25x/' . $moduleDirName; - // $repository = 'XoopsModules25x/publisher'; //for testing only + $repository = 'XoopsModules27x/' . $moduleDirName; $ret = null; $infoReleasesUrl = "https://api.github.com/repos/$repository/releases"; if ('github' === $source) { diff --git a/docs/RELEASE-3.3.0-alpha.1.md b/docs/RELEASE-3.3.0-alpha.1.md index 1ae8067..3e2f648 100644 --- a/docs/RELEASE-3.3.0-alpha.1.md +++ b/docs/RELEASE-3.3.0-alpha.1.md @@ -16,7 +16,7 @@ An alpha prerelease for testing theme inspection, visual editing and reusable st 2. Extract the release ZIP so its `cssholmes` directory is under `htdocs/modules/`. 3. Install or update cssHolmes through XOOPS module administration. Existing permissions are preserved on update; review legacy Registered Users overlay/diagnostics grants. Workbench history migrates from `data/workbench/*.json` to `XOOPS_VAR_PATH/configs/cssholmes/workbench/`. Keep these private files in backups. If both locations contain different histories, the update stops for manual reconciliation rather than overwriting either copy. Legacy text patches without a saved revision must be restored manually. -4. For the new gallery controls, also deploy the xStyles `feat/cssholmes-integration` update and update that module. cssHolmes works independently without xStyles. +4. For the new gallery controls, also install or update [xStyles 1.5.0 Beta 3](https://github.com/XoopsModules27x/xstyles) or a later compatible version. cssHolmes works independently without xStyles. 5. Read `docs/TUTORIAL-xStyles.md` in the package for the illustrated workflow. No module-local Composer or vendor installation is needed. Saving a named set does not publish changes; **Save to theme** does and may affect visitors. @@ -26,3 +26,5 @@ No module-local Composer or vendor installation is needed. Saving a named set do PHP 8.4/8.5 are the QA targets. Clean installation and upgrade from 3.0.0 passed on a disposable XOOPS 2.7.4-RC2 site with PHP 8.4.27, including authenticated save/reload, anonymous published styles, permission checks and restoration. See `docs/compatibility.md` for precise test evidence. The retained XOOPS 2.5.12 installer minimum is not a claim that all older core/PHP combinations were tested. This alpha does not publish admin-theme changes or provide a native XOOPS 4 port. Contrast readings are conservative estimates, not an accessibility certificate. Legacy Common PHPUnit tests still need modernization; they are outside the documented standalone suite. Qodana is optional and requires a repository token. + +Source, issues and future releases: [XoopsModules27x/cssholmes](https://github.com/XoopsModules27x/cssholmes). diff --git a/docs/changelog.txt b/docs/changelog.txt index 0d0015d..15b0e75 100644 --- a/docs/changelog.txt +++ b/docs/changelog.txt @@ -1,6 +1,7 @@
3.3.0 Alpha 1 [2026-10-26]
Requires PHP 8.4+. Alpha prerelease for testing; see docs/compatibility.md for tested environments and limitations.
+- Moved the official repository to XoopsModules27x/cssholmes and updated source, help and release links. - Added a visual theme designer with scoped selectors, colors, typography, spacing, live preview, undo/redo and explicit Save to theme publication. - Added private per-theme override storage, export, previous-save restoration and optimistic conflict checks without rewriting theme source files. - Added a named style-set library with preview, categories, likes and validated portable import/export; saving a set does not publish it. diff --git a/docs/compatibility.md b/docs/compatibility.md index 14c3e06..789c820 100644 --- a/docs/compatibility.md +++ b/docs/compatibility.md @@ -15,8 +15,8 @@ that every legacy core/PHP combination has been tested. ## Local tooling verification, 2026-10-26 The results below describe the complete candidate, including the test suite in -[QA PR #9](https://github.com/XoopsModules25x/cssholmes/pull/9), not a documentation-only -review branch. Release ZIPs omit development tests and configuration. Follow +[QA PR #9](https://github.com/XoopsModules27x/cssholmes/pull/9). +Release ZIPs omit development tests and configuration. Follow [Development checks](../README.md#development-checks) to obtain the source needed to reproduce these results. diff --git a/docs/visual-designer.md b/docs/visual-designer.md index 8395fae..4624262 100644 --- a/docs/visual-designer.md +++ b/docs/visual-designer.md @@ -142,8 +142,7 @@ the stored JSON by hand while editors are saving. ## Verification Use the complete source checkout described in [Development checks](../README.md#development-checks). -These scripts arrive with the final QA change; documentation-only branches and -release ZIPs do not contain the test suite. +Release ZIPs do not contain the test suite. Run `php tests/designer-access.php`, `php tests/designer-store.php`, and `php tests/designer-http.php`. The HTTP check builds an isolated temporary test diff --git a/docs/xoops4-migration.md b/docs/xoops4-migration.md index 7522b6c..fc18946 100644 --- a/docs/xoops4-migration.md +++ b/docs/xoops4-migration.md @@ -59,9 +59,8 @@ are not XTF token overrides and must remain separate. ## Evidence -The commands below require the complete source checkout, including the final QA -change. They are not available in documentation-only branches or release ZIPs; -see [Development checks](../README.md#development-checks). +The commands below require the complete source checkout described in +[Development checks](../README.md#development-checks). Release ZIPs omit these tests. The separate xStyles module's `tests/fixtures.php` checks real core rendering without site sessions or a database; cssHolmes does not ship that script. diff --git a/language/english/help/help.tpl b/language/english/help/help.tpl index de583fe..53f2411 100644 --- a/language/english/help/help.tpl +++ b/language/english/help/help.tpl @@ -107,10 +107,10 @@

DEVELOPMENT


- This module is Open Source and we would love your help in making it better. You can fork this module on GitHub

+ This module is Open Source and we would love your help in making it better. You can fork this module on GitHub

But there is more happening on GitHub:

- XOOPS Core
- - XOOPS Modules
+ - XOOPS Modules
- XOOPS Themes

cssHolmes is particularly interested in contributions around XTF theme analysis, widget diagnostics, admin-theme coverage, documentation, and tests.

Go check it out, and GET INVOLVED diff --git a/language/french/help/help.tpl b/language/french/help/help.tpl index 84cd9e3..7250d94 100644 --- a/language/french/help/help.tpl +++ b/language/french/help/help.tpl @@ -47,10 +47,10 @@

DEVELOPMENT


- This module is Open Source and we would love your help in making it better! You can fork this module on GitHub

+ This module is Open Source and we would love your help in making it better! You can fork this module on GitHub

But there is more happening on GitHub:

- XOOPS Core
- - XOOPS Modules
+ - XOOPS Modules
- XOOPS Themes

Go check it out, and GET INVOLVED