From 94a6dd399797f498c7238f2720de4d60f9c0aba4 Mon Sep 17 00:00:00 2001 From: Steve Boyd Date: Thu, 30 Jan 2025 10:17:36 +1300 Subject: [PATCH 1/4] DOC Deprecate FormField Value --- en/08_Changelogs/5.4.0.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/en/08_Changelogs/5.4.0.md b/en/08_Changelogs/5.4.0.md index ec0969a8..e500d058 100644 --- a/en/08_Changelogs/5.4.0.md +++ b/en/08_Changelogs/5.4.0.md @@ -320,6 +320,8 @@ See [indexes](/developer_guides/model/indexes/) to learn about indexes in Silver - The `$join` parameter for the [`Subsite::get_from_all_subsites()`](api:SilverStripe\Subsites\Model\Subsite::get_from_all_subsites()) method has been deprecated. Use [leftJoin($table, $joinClause)](api:SilverStripe\ORM\DataList::leftJoin()) instead. - Passing a boolean value to the `$mergeStrategy` argument in [`Form::loadDataFrom()`](api:Silverstripe\Forms\Form::loadDataFrom()) has been deprecated. Pass [`Form::MERGE_CLEAR_MISSING`](api:Silverstripe\Forms\Form::MERGE_CLEAR_MISSING) instead of `true` and `0` instead of `false`. - The [`HTTP.ignoreDeprecatedCaching`](api:SilverStripe\Control\HTTP->ignoreDeprecatedCaching) configuration property has been deprecated. It will be removed without equivalent functionality to replace it. +- [`FormField::Value()`](api:SilverStripe\Forms\FormField::Value()) has been deprecated. It will be replaced by getFormattedValue() and getValue(). +- [`TextareaField::ValueEntities()`](api:SilverStripe\Forms\TextareaField::ValueEntities()) has been deprecated. It will be replaced by getFormattedValueEntities(). ## Bug fixes From 4a4fb2f6f634b2db807944a6eb8da59367a4527e Mon Sep 17 00:00:00 2001 From: Steve Boyd Date: Thu, 30 Jan 2025 10:14:04 +1300 Subject: [PATCH 2/4] DOC Deprecate passing null paramters for Form and ValidationResult methods --- en/08_Changelogs/5.4.0.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/en/08_Changelogs/5.4.0.md b/en/08_Changelogs/5.4.0.md index e500d058..83a370d0 100644 --- a/en/08_Changelogs/5.4.0.md +++ b/en/08_Changelogs/5.4.0.md @@ -322,6 +322,17 @@ See [indexes](/developer_guides/model/indexes/) to learn about indexes in Silver - The [`HTTP.ignoreDeprecatedCaching`](api:SilverStripe\Control\HTTP->ignoreDeprecatedCaching) configuration property has been deprecated. It will be removed without equivalent functionality to replace it. - [`FormField::Value()`](api:SilverStripe\Forms\FormField::Value()) has been deprecated. It will be replaced by getFormattedValue() and getValue(). - [`TextareaField::ValueEntities()`](api:SilverStripe\Forms\TextareaField::ValueEntities()) has been deprecated. It will be replaced by getFormattedValueEntities(). +- Passing `null` for the `$code` parameter in [`ValidationResult::addError()`](api:SilverStripe\ORM\ValidationResult::addError()) is deprecated. Pass a blank string instead. +- Passing `null` for the `$cast` parameter in [`ValidationResult::addError()`](api:SilverStripe\ORM\ValidationResult::addError()) is deprecated. Pass a ValidationResult::CAST_* constant instead. +- Passing `null` for the `$code` parameter in [`ValidationResult::addFieldError()`](api:SilverStripe\ORM\ValidationResult::addFieldError()) is deprecated. Pass a blank string instead. +- Passing `null` for the `$cast` parameter in [`ValidationResult::addFieldError()`](api:SilverStripe\ORM\ValidationResult::addFieldError()) is deprecated. Pass a ValidationResult::CAST_* constant instead. +- Passing `null` for the `$code` parameter in [`ValidationResult::addMessage()`](api:SilverStripe\ORM\ValidationResult::addMessage()) is deprecated. Pass a blank string instead. +- Passing `null` for the `$cast` parameter in [`ValidationResult::addMessage()`](api:SilverStripe\ORM\ValidationResult::addMessage()) is deprecated. Pass a ValidationResult::CAST_* constant instead. +- Passing `null` for the `$code` parameter in [`ValidationResult::addFieldMessage()`](api:SilverStripe\ORM\ValidationResult::addFieldMessage()) is deprecated. Pass a blank string instead. +- Passing `null` for the `$cast` parameter in [`ValidationResult::addFieldMessage()`](api:SilverStripe\ORM\ValidationResult::addFieldMessage()) is deprecated. Pass a ValidationResult::CAST_* constant instead. +- Passing `null` for the `$cast` parameter in [`Form::sessionMessage()`](api:SilverStripe\Forms\Form::sessionMessage()) is deprecated. Pass a ValidationResult::CAST_* constant instead. +- Passing `null` for the `$cast` parameter in [`Form::sessionError()`](api:SilverStripe\Forms\Form::sessionError()) is deprecated. Pass a ValidationResult::CAST_* constant instead. +- Passing `null` for the `$cast` parameter in [`Form::sessionFieldError()`](api:SilverStripe\Forms\Form::sessionFieldError()) is deprecated. Pass a ValidationResult::CAST_* constant instead. ## Bug fixes From 59efc68eb9eedb6c9702b154af2610ade5b95fd4 Mon Sep 17 00:00:00 2001 From: Simon Erkelens Date: Mon, 3 Feb 2025 12:51:05 +1300 Subject: [PATCH 3/4] DOC Remove "warning" about "fulltextsearch" (#681) --- en/02_Developer_Guides/12_Search/02_FulltextSearch.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/en/02_Developer_Guides/12_Search/02_FulltextSearch.md b/en/02_Developer_Guides/12_Search/02_FulltextSearch.md index aa33293e..1115c510 100644 --- a/en/02_Developer_Guides/12_Search/02_FulltextSearch.md +++ b/en/02_Developer_Guides/12_Search/02_FulltextSearch.md @@ -10,11 +10,6 @@ Fulltext search allows advanced search criteria for searching words within a tex Fulltext search can be achieved using the built-in [MySQLDatabase](api:SilverStripe\ORM\Connect\MySQLDatabase) class a more powerful wrapper for Fulltext search is provided through a module. -> [!WARNING] -> See the [FulltextSearch Module](https://github.com/silverstripe-labs/silverstripe-fulltextsearch/). This module provides -> a high level wrapper for running advanced search services such as Solr, Lucene or Sphinx in the backend rather than -> `MySQL` search. - ## Adding fulltext support to `MySQLDatabase` The [MySQLDatabase](api:SilverStripe\ORM\Connect\MySQLDatabase) class defaults to creating tables using the InnoDB storage engine. As Fulltext search in MySQL From 254c4e4695f0ff7af63b2adf8c3268630a7054c5 Mon Sep 17 00:00:00 2001 From: Guy Sartorelli <36352093+GuySartorelli@users.noreply.github.com> Date: Wed, 5 Feb 2025 12:52:50 +1300 Subject: [PATCH 4/4] DOC Document new startup theme (#683) --- en/00_Getting_Started/02_Composer.md | 4 ++-- en/00_Getting_Started/04_Directory_Structure.md | 2 +- .../01_Templates/03_Requirements.md | 6 +++--- .../15_Customising_the_Admin_Interface/06_Preview.md | 6 +++--- en/08_Changelogs/6.0.0.md | 11 +++++++++++ en/12_Project_Governance/07_Supported_Modules.md | 2 +- 6 files changed, 21 insertions(+), 10 deletions(-) diff --git a/en/00_Getting_Started/02_Composer.md b/en/00_Getting_Started/02_Composer.md index 5d2cb33d..eb00f39b 100644 --- a/en/00_Getting_Started/02_Composer.md +++ b/en/00_Getting_Started/02_Composer.md @@ -187,7 +187,7 @@ file. It will appear in your project root, and by default, it will look somethin "silverstripe/recipe-plugin": "~2.0.1@stable", "silverstripe/vendor-plugin": "~3.0.0@stable", "silverstripe/recipe-cms": "~6.0.0@stable", - "silverstripe-themes/simple": "~3.2.0@stable", + "silverstripe/startup-theme": "~1.0.0@stable", "silverstripe/login-forms": "~6.0.0@stable" }, "require-dev": { @@ -343,7 +343,7 @@ Open `composer.json`, and find the module's `require`. Then put `as (core versio "php": "^8.3", "silverstripe/recipe-cms": "~6.0.0@stable", "silverstripe/framework": "dev-myproj as 6.0.0", - "silverstripe-themes/simple": "~3.2.0" + "silverstripe/startup-theme": "~1.0.0" } } ``` diff --git a/en/00_Getting_Started/04_Directory_Structure.md b/en/00_Getting_Started/04_Directory_Structure.md index bae022b0..ed1a8ec3 100644 --- a/en/00_Getting_Started/04_Directory_Structure.md +++ b/en/00_Getting_Started/04_Directory_Structure.md @@ -58,7 +58,7 @@ Silverstripe core modules. | Directory | Description | | ------------------ | --------------------------- | -| `themes/simple/` | Standard "simple" theme | +| `themes/startup-theme/` | Default theme | | `themes//` | Custom theme base directory | | `themes//templates` | Theme templates | | `themes//css` | Theme CSS files | diff --git a/en/02_Developer_Guides/01_Templates/03_Requirements.md b/en/02_Developer_Guides/01_Templates/03_Requirements.md index 3bc37374..70bfc7e7 100644 --- a/en/02_Developer_Guides/01_Templates/03_Requirements.md +++ b/en/02_Developer_Guides/01_Templates/03_Requirements.md @@ -67,7 +67,7 @@ use SilverStripe\View\Requirements; Requirements::javascript('app/client/dist/bundle.js'); // When referencing theme files, use a path relative to the root of your project -Requirements::javascript('themes/simple/javascript/script.js'); +Requirements::javascript('themes/my-theme/javascript/script.js'); // When referencing files from a module, you need to prefix the path with the module name. Requirements::javascript('silverstripe/admin:client/dist/js/bundle.js'); @@ -446,8 +446,8 @@ If you want to get a resource for a *specific* theme or from somewhere that is n ```ss - - + + ``` > [!TIP] diff --git a/en/02_Developer_Guides/15_Customising_the_Admin_Interface/06_Preview.md b/en/02_Developer_Guides/15_Customising_the_Admin_Interface/06_Preview.md index ebff2cc6..728bad92 100644 --- a/en/02_Developer_Guides/15_Customising_the_Admin_Interface/06_Preview.md +++ b/en/02_Developer_Guides/15_Customising_the_Admin_Interface/06_Preview.md @@ -354,10 +354,10 @@ class MyAdmin extends ModelAdmin > > <%-- body tag is needed for javascript to be injected --%> > -> <%-- these two divs are just here to comply with styling from the simple theme, replace them with your own theme markup --%> ->
+> <%-- these HTML elements are just here to comply with styling from the default theme, replace them with your own theme markup --%> +>