From 74082b59e60c740ef882bae4b5cb7650b6d16ad9 Mon Sep 17 00:00:00 2001 From: Kevin Pfeifer Date: Tue, 3 Feb 2026 22:57:52 +0100 Subject: [PATCH 1/2] improve SEO --- docs/en/appendices.md | 5 +++ docs/en/appendices/5-0-migration-guide.md | 5 +++ docs/en/appendices/5-0-upgrade-guide.md | 5 +++ docs/en/appendices/5-1-migration-guide.md | 5 +++ docs/en/appendices/5-2-migration-guide.md | 5 +++ docs/en/appendices/5-3-migration-guide.md | 5 +++ .../appendices/cakephp-development-process.md | 5 +++ docs/en/appendices/glossary.md | 37 +++++++++-------- docs/en/appendices/migration-guides.md | 5 +++ docs/en/appendices/phpunit-upgrade.md | 5 +++ docs/en/console-commands.md | 5 +++ docs/en/console-commands/cache.md | 5 +++ docs/en/console-commands/commands.md | 5 +++ docs/en/console-commands/completion.md | 5 +++ docs/en/console-commands/counter-cache.md | 5 +++ docs/en/console-commands/cron-jobs.md | 5 +++ docs/en/console-commands/i18n.md | 5 +++ docs/en/console-commands/input-output.md | 5 +++ docs/en/console-commands/option-parsers.md | 5 +++ docs/en/console-commands/plugin.md | 5 +++ docs/en/console-commands/repl.md | 5 +++ docs/en/console-commands/routes.md | 5 +++ docs/en/console-commands/schema-cache.md | 5 +++ docs/en/console-commands/server.md | 5 +++ docs/en/contributing.md | 5 +++ .../contributing/backwards-compatibility.md | 5 +++ .../cakephp-coding-conventions.md | 41 +++++++++++-------- docs/en/contributing/code.md | 5 +++ docs/en/contributing/documentation.md | 5 +++ docs/en/contributing/tickets.md | 5 +++ docs/en/controllers.md | 5 +++ docs/en/controllers/components.md | 5 +++ .../components/check-http-cache.md | 5 +++ docs/en/controllers/components/flash.md | 5 +++ .../controllers/components/form-protection.md | 13 ++++-- docs/en/controllers/middleware.md | 5 +++ docs/en/controllers/pages-controller.md | 5 +++ docs/en/controllers/pagination.md | 5 +++ docs/en/controllers/request-response.md | 5 +++ docs/en/core-libraries/app.md | 5 +++ docs/en/core-libraries/caching.md | 5 +++ docs/en/core-libraries/collections.md | 5 +++ docs/en/core-libraries/email.md | 5 +++ docs/en/core-libraries/events.md | 5 +++ docs/en/core-libraries/form.md | 5 +++ .../global-constants-and-functions.md | 5 +++ docs/en/core-libraries/hash.md | 7 +++- docs/en/core-libraries/httpclient.md | 5 +++ docs/en/core-libraries/inflector.md | 5 +++ .../internationalization-and-localization.md | 5 +++ docs/en/core-libraries/logging.md | 5 +++ docs/en/core-libraries/number.md | 5 +++ docs/en/core-libraries/plugin.md | 5 +++ docs/en/core-libraries/registry-objects.md | 5 +++ docs/en/core-libraries/security.md | 5 +++ docs/en/core-libraries/text.md | 5 +++ docs/en/core-libraries/time.md | 5 +++ docs/en/core-libraries/validation.md | 5 +++ docs/en/core-libraries/xml.md | 5 +++ docs/en/deployment.md | 5 +++ docs/en/development/application.md | 5 +++ docs/en/development/configuration.md | 5 +++ docs/en/development/debugging.md | 5 +++ docs/en/development/dependency-injection.md | 5 +++ docs/en/development/errors.md | 5 +++ docs/en/development/rest.md | 5 +++ docs/en/development/routing.md | 5 +++ docs/en/development/sessions.md | 5 +++ docs/en/development/testing.md | 5 +++ docs/en/installation.md | 2 +- docs/en/intro.md | 5 +++ docs/en/intro/conventions.md | 5 +++ docs/en/intro/where-to-get-help.md | 5 +++ docs/en/orm.md | 5 +++ docs/en/orm/associations.md | 5 +++ docs/en/orm/behaviors.md | 5 +++ docs/en/orm/behaviors/counter-cache.md | 5 +++ docs/en/orm/behaviors/timestamp.md | 5 +++ docs/en/orm/behaviors/translate.md | 5 +++ docs/en/orm/behaviors/tree.md | 5 +++ docs/en/orm/database-basics.md | 5 +++ docs/en/orm/deleting-data.md | 5 +++ docs/en/orm/entities.md | 5 +++ docs/en/orm/query-builder.md | 5 +++ docs/en/orm/retrieving-data-and-resultsets.md | 5 +++ docs/en/orm/saving-data.md | 5 +++ docs/en/orm/schema-system.md | 5 +++ docs/en/orm/table-objects.md | 5 +++ docs/en/orm/validation.md | 5 +++ docs/en/plugins.md | 5 +++ docs/en/quickstart.md | 5 +++ docs/en/release-policy.md | 5 +++ docs/en/security.md | 5 +++ docs/en/security/content-security-policy.md | 5 +++ docs/en/security/csrf.md | 5 +++ docs/en/security/https-enforcer.md | 5 +++ docs/en/security/security-headers.md | 5 +++ docs/en/standalone-packages.md | 5 +++ docs/en/topics.md | 5 +++ docs/en/tutorials-and-examples.md | 5 +++ .../cms/articles-controller.md | 5 +++ .../cms/articles-model.md | 5 +++ .../cms/authentication.md | 5 +++ .../cms/authorization.md | 5 +++ .../en/tutorials-and-examples/cms/database.md | 5 +++ .../cms/installation.md | 5 +++ .../cms/tags-and-users.md | 5 +++ docs/en/views.md | 5 +++ docs/en/views/cells.md | 5 +++ docs/en/views/helpers.md | 5 +++ docs/en/views/helpers/breadcrumbs.md | 5 +++ docs/en/views/helpers/flash.md | 5 +++ docs/en/views/helpers/form.md | 5 +++ docs/en/views/helpers/html.md | 5 +++ docs/en/views/helpers/number.md | 5 +++ docs/en/views/helpers/paginator.md | 5 +++ docs/en/views/helpers/text.md | 5 +++ docs/en/views/helpers/time.md | 5 +++ docs/en/views/helpers/url.md | 5 +++ docs/en/views/json-and-xml-views.md | 5 +++ docs/en/views/themes.md | 5 +++ 121 files changed, 638 insertions(+), 42 deletions(-) diff --git a/docs/en/appendices.md b/docs/en/appendices.md index 6d3c462562..1920391de9 100644 --- a/docs/en/appendices.md +++ b/docs/en/appendices.md @@ -1,3 +1,8 @@ +--- +title: "Appendices" +description: "Appendices contain information regarding the new features introduced in each version and the migration path between versions." +--- + # Appendices Appendices contain information regarding the new features diff --git a/docs/en/appendices/5-0-migration-guide.md b/docs/en/appendices/5-0-migration-guide.md index e80770dcb9..f0b0e10a15 100644 --- a/docs/en/appendices/5-0-migration-guide.md +++ b/docs/en/appendices/5-0-migration-guide.md @@ -1,3 +1,8 @@ +--- +title: "5.0 Migration Guide" +description: "CakePHP 5.0 contains breaking changes, and is not backwards compatible with 4.x releases." +--- + # 5.0 Migration Guide CakePHP 5.0 contains breaking changes, and is not backwards compatible with 4.x diff --git a/docs/en/appendices/5-0-upgrade-guide.md b/docs/en/appendices/5-0-upgrade-guide.md index 174bb335d1..11efe892d3 100644 --- a/docs/en/appendices/5-0-upgrade-guide.md +++ b/docs/en/appendices/5-0-upgrade-guide.md @@ -1,3 +1,8 @@ +--- +title: "5.0 Upgrade Guide" +description: "First, check that your application is running on latest CakePHP 4.x version." +--- + # 5.0 Upgrade Guide First, check that your application is running on latest CakePHP 4.x version. diff --git a/docs/en/appendices/5-1-migration-guide.md b/docs/en/appendices/5-1-migration-guide.md index 64836865ad..807fb1e032 100644 --- a/docs/en/appendices/5-1-migration-guide.md +++ b/docs/en/appendices/5-1-migration-guide.md @@ -1,3 +1,8 @@ +--- +title: "5.1 Migration Guide" +description: "The 5.1.0 release is backwards compatible with 5.0. It adds new functionality and introduces new deprecations." +--- + # 5.1 Migration Guide The 5.1.0 release is backwards compatible with 5.0. It adds new functionality diff --git a/docs/en/appendices/5-2-migration-guide.md b/docs/en/appendices/5-2-migration-guide.md index 6a59c78b3e..161e0badd3 100644 --- a/docs/en/appendices/5-2-migration-guide.md +++ b/docs/en/appendices/5-2-migration-guide.md @@ -1,3 +1,8 @@ +--- +title: "5.2 Migration Guide" +description: "The 5.2.0 release is backwards compatible with 5.0. It adds new functionality and introduces new deprecations." +--- + # 5.2 Migration Guide The 5.2.0 release is backwards compatible with 5.0. It adds new functionality diff --git a/docs/en/appendices/5-3-migration-guide.md b/docs/en/appendices/5-3-migration-guide.md index 2648a07d3c..e3ccd6d6ae 100644 --- a/docs/en/appendices/5-3-migration-guide.md +++ b/docs/en/appendices/5-3-migration-guide.md @@ -1,3 +1,8 @@ +--- +title: "5.3 Migration Guide" +description: "The 5.3.0 release is backwards compatible with 5.0. It adds new functionality and introduces new deprecations." +--- + # 5.3 Migration Guide The 5.3.0 release is backwards compatible with 5.0. It adds new functionality diff --git a/docs/en/appendices/cakephp-development-process.md b/docs/en/appendices/cakephp-development-process.md index 9853bf98ca..1ee87c9e2d 100644 --- a/docs/en/appendices/cakephp-development-process.md +++ b/docs/en/appendices/cakephp-development-process.md @@ -1,3 +1,8 @@ +--- +title: "CakePHP Development Process" +description: "CakePHP projects broadly follow semver. Minor releases are easier, major releases require some work." +--- + # CakePHP Development Process CakePHP projects broadly follow [semver](https://semver.org/). This means that: diff --git a/docs/en/appendices/glossary.md b/docs/en/appendices/glossary.md index 6b26b2952f..8037a0216d 100644 --- a/docs/en/appendices/glossary.md +++ b/docs/en/appendices/glossary.md @@ -1,31 +1,34 @@ -# Glossary +--- +title: "Glossary" +description: "A list of commonly used abbreviations and names." +--- -
+# Glossary -CDN +## CDN Content Delivery Network. A 3rd party vendor you can pay to help distribute your content to data centers around the world. This helps put your static assets closer to geographically distributed users. -columns +## columns Used in the ORM when referring to the table columns in an database table. -CSRF +## CSRF Cross Site Request Forgery. Prevents replay attacks, double submissions and forged requests from other domains. -DI Container +## DI Container In `Application::services()` you can configure application services and their dependencies. Application services are automatically injected into Controller actions, and Command Constructors. See [Dependency Injection](../development/dependency-injection). -DSN +## DSN Data Source Name. A connection string format that is formed like a URI. CakePHP supports DSNs for Cache, Database, Log and Email connections. -dot notation +## dot notation Dot notation defines an array path, by separating nested levels with `.` For example: @@ -43,17 +46,17 @@ Would point to the following value: ] ``` -DRY +## DRY Don't repeat yourself. Is a principle of software development aimed at reducing repetition of information of all kinds. In CakePHP DRY is used to allow you to code things once and re-use them across your application. -fields +## fields A generic term used to describe both entity properties, or database columns. Often used in conjunction with the FormHelper. -HTML attributes +## HTML attributes An array of key => values that are composed into HTML attributes. For example: ``` php @@ -75,15 +78,15 @@ can be used: checked="checked" ``` -PaaS +## PaaS Platform as a Service. Platform as a Service providers will provide cloud based hosting, database and caching resources. Some popular providers include Heroku, EngineYard and PagodaBox -properties +## properties Used when referencing columns mapped onto an ORM entity. -plugin syntax +## plugin syntax Plugin syntax refers to the dot separated class name indicating classes are part of a plugin: @@ -95,18 +98,16 @@ are part of a plugin: 'AcmeCorp/Tools.Toolbar' ``` -routes.php +## routes.php A file in the `config/` directory that contains routing configuration. This file is included before each request is processed. It should connect all the routes your application needs so requests can be routed to the correct controller + action. -routing array +## routing array An array of attributes that are passed to `Router::url()`. They typically look like: ``` php ['controller' => 'Posts', 'action' => 'view', 5] ``` - -
diff --git a/docs/en/appendices/migration-guides.md b/docs/en/appendices/migration-guides.md index 07578befa6..f23d417238 100644 --- a/docs/en/appendices/migration-guides.md +++ b/docs/en/appendices/migration-guides.md @@ -1,3 +1,8 @@ +--- +title: "Migration Guides" +description: "Migration guides contain information regarding the new features introduced in each version and the migration path between 5.x minor releases." +--- + # Migration Guides Migration guides contain information regarding the new features introduced in diff --git a/docs/en/appendices/phpunit-upgrade.md b/docs/en/appendices/phpunit-upgrade.md index e2de186471..730c3e249c 100644 --- a/docs/en/appendices/phpunit-upgrade.md +++ b/docs/en/appendices/phpunit-upgrade.md @@ -1,3 +1,8 @@ +--- +title: "PHPUnit Upgrade" +description: "This guide covers the PHPUnit version requirements and migration steps for CakePHP 5.x applications. CakePHP 5.x requires PHPUnit ^11.5.3 or ^12.1.3." +--- + # PHPUnit Upgrade This guide covers the PHPUnit version requirements and migration steps for CakePHP 5.x applications. diff --git a/docs/en/console-commands.md b/docs/en/console-commands.md index 5635af6b39..c592cfc1f8 100644 --- a/docs/en/console-commands.md +++ b/docs/en/console-commands.md @@ -1,3 +1,8 @@ +--- +title: "Console Commands" +description: "In addition to a web framework, CakePHP also provides a console framework for creating command line tools & applications." +--- + # Console Commands In addition to a web framework, CakePHP also provides a console framework for diff --git a/docs/en/console-commands/cache.md b/docs/en/console-commands/cache.md index 207543f641..328785e706 100644 --- a/docs/en/console-commands/cache.md +++ b/docs/en/console-commands/cache.md @@ -1,3 +1,8 @@ +--- +title: "Cache Tool" +description: "To help you better manage cached data from a CLI environment, a console command is available for clearing cached data your application has." +--- + # Cache Tool To help you better manage cached data from a CLI environment, a console command diff --git a/docs/en/console-commands/commands.md b/docs/en/console-commands/commands.md index 66b8c61d07..6430d3218d 100644 --- a/docs/en/console-commands/commands.md +++ b/docs/en/console-commands/commands.md @@ -1,3 +1,8 @@ +--- +title: "Command Objects" +description: "The command class comes with a number of built-in commands for speeding up your development, and automating routine tasks." +--- + # Command Objects `class` Cake\\Console\\**Command** diff --git a/docs/en/console-commands/completion.md b/docs/en/console-commands/completion.md index 466d3c12f7..b69952a3d7 100644 --- a/docs/en/console-commands/completion.md +++ b/docs/en/console-commands/completion.md @@ -1,3 +1,8 @@ +--- +title: "Completion Tool" +description: "Working with the console gives the developer a lot of possibilities but having to completely know and write those commands can be tedious." +--- + # Completion Tool Working with the console gives the developer a lot of possibilities but having diff --git a/docs/en/console-commands/counter-cache.md b/docs/en/console-commands/counter-cache.md index d94557d0de..d1c86c1f40 100644 --- a/docs/en/console-commands/counter-cache.md +++ b/docs/en/console-commands/counter-cache.md @@ -1,3 +1,8 @@ +--- +title: "CounterCache Tool" +description: "The CounterCacheCommand provides a CLI tool for rebuilding the counter caches in your application and plugin models." +--- + # CounterCache Tool The CounterCacheCommand provides a CLI tool for rebuilding the counter caches diff --git a/docs/en/console-commands/cron-jobs.md b/docs/en/console-commands/cron-jobs.md index b0d30c533b..53f9374abf 100644 --- a/docs/en/console-commands/cron-jobs.md +++ b/docs/en/console-commands/cron-jobs.md @@ -1,3 +1,8 @@ +--- +title: "Running Shells as Cron Jobs" +description: "A common thing to do with a shell is making it run as a cronjob to clean up the database once in a while or send newsletters." +--- + # Running Shells as Cron Jobs A common thing to do with a shell is making it run as a cronjob to diff --git a/docs/en/console-commands/i18n.md b/docs/en/console-commands/i18n.md index d91c4990cf..1be2c284a1 100644 --- a/docs/en/console-commands/i18n.md +++ b/docs/en/console-commands/i18n.md @@ -1,3 +1,8 @@ +--- +title: "I18N Tool" +description: "The i18n features of CakePHP use po files as their translation source. PO files integrate with commonly used translation tools like Poedit." +--- + # I18N Tool The i18n features of CakePHP use [po files](https://en.wikipedia.org/wiki/GNU_gettext) diff --git a/docs/en/console-commands/input-output.md b/docs/en/console-commands/input-output.md index 86bd52fc93..feaedc6277 100644 --- a/docs/en/console-commands/input-output.md +++ b/docs/en/console-commands/input-output.md @@ -1,3 +1,8 @@ +--- +title: "Command Input/Output" +description: "Formatting console output can be tedious and lead to maintenance issues." +--- + # Command Input/Output `class` Cake\\Console\\**ConsoleIo** diff --git a/docs/en/console-commands/option-parsers.md b/docs/en/console-commands/option-parsers.md index f66cd91ea0..402962e94f 100644 --- a/docs/en/console-commands/option-parsers.md +++ b/docs/en/console-commands/option-parsers.md @@ -1,3 +1,8 @@ +--- +title: "Option Parsers" +description: "Command classes use the getOptionParser() hook method to define their option parser." +--- + # Option Parsers `class` Cake\\Console\\**ConsoleOptionParser** diff --git a/docs/en/console-commands/plugin.md b/docs/en/console-commands/plugin.md index 0848f03db6..993b843cf0 100644 --- a/docs/en/console-commands/plugin.md +++ b/docs/en/console-commands/plugin.md @@ -1,3 +1,8 @@ +--- +title: "Plugin Tool" +description: "The plugin tool allows you to load and unload plugins via the command prompt." +--- + # Plugin Tool diff --git a/docs/en/console-commands/repl.md b/docs/en/console-commands/repl.md index bc0cabc9a2..3a5eb43bb0 100644 --- a/docs/en/console-commands/repl.md +++ b/docs/en/console-commands/repl.md @@ -1,3 +1,8 @@ +--- +title: "Interactive Console (REPL)" +description: "CakePHP offers REPL(Read Eval Print Loop) plugin to let you explore some CakePHP and your application in an interactive console." +--- + # Interactive Console (REPL) CakePHP offers diff --git a/docs/en/console-commands/routes.md b/docs/en/console-commands/routes.md index c0f3607c3e..4839e6ccd1 100644 --- a/docs/en/console-commands/routes.md +++ b/docs/en/console-commands/routes.md @@ -1,3 +1,8 @@ +--- +title: "Routes Tool" +description: "The routes tool provides a simple to use CLI interface for testing and debugging routes. You can quickly see how a URL will be parsed using the check method:" +--- + # Routes Tool The routes tool provides a simple to use CLI interface for testing and debugging diff --git a/docs/en/console-commands/schema-cache.md b/docs/en/console-commands/schema-cache.md index 5fe13e4172..b1eb92ecc9 100644 --- a/docs/en/console-commands/schema-cache.md +++ b/docs/en/console-commands/schema-cache.md @@ -1,3 +1,8 @@ +--- +title: "Schema Cache Tool" +description: "The SchemaCacheCommand provides a simple CLI tool for managing your application's metadata caches." +--- + # Schema Cache Tool The SchemaCacheCommand provides a simple CLI tool for managing your application's diff --git a/docs/en/console-commands/server.md b/docs/en/console-commands/server.md index a92629ab82..a652755271 100644 --- a/docs/en/console-commands/server.md +++ b/docs/en/console-commands/server.md @@ -1,3 +1,8 @@ +--- +title: "Server Tool" +description: "The ServerCommand lets you stand up a simple webserver using the built in PHP webserver." +--- + # Server Tool The `ServerCommand` lets you stand up a simple webserver using the built in PHP diff --git a/docs/en/contributing.md b/docs/en/contributing.md index d6c4fb4aaf..f75e5e2f0e 100644 --- a/docs/en/contributing.md +++ b/docs/en/contributing.md @@ -1,3 +1,8 @@ +--- +title: "Contributing" +description: "There are a number of ways you can contribute to CakePHP. The following sections cover the various ways you can contribute to CakePHP:" +--- + # Contributing There are a number of ways you can contribute to CakePHP. The following sections diff --git a/docs/en/contributing/backwards-compatibility.md b/docs/en/contributing/backwards-compatibility.md index 85615ef2f2..5fb161fbba 100644 --- a/docs/en/contributing/backwards-compatibility.md +++ b/docs/en/contributing/backwards-compatibility.md @@ -1,3 +1,8 @@ +--- +title: "Backwards Compatibility Guide" +description: "Ensuring that you can upgrade your applications easily and smoothly is important to us. That's why we only break compatibility at major release milestones." +--- + # Backwards Compatibility Guide Ensuring that you can upgrade your applications easily and smoothly is important diff --git a/docs/en/contributing/cakephp-coding-conventions.md b/docs/en/contributing/cakephp-coding-conventions.md index 9afa4fe7f2..3ac5a8e11b 100644 --- a/docs/en/contributing/cakephp-coding-conventions.md +++ b/docs/en/contributing/cakephp-coding-conventions.md @@ -1,3 +1,8 @@ +--- +title: "Coding Standards" +description: "CakePHP developers will use the PSR-12 coding style guide in addition to the following rules as coding standards." +--- + # Coding Standards CakePHP developers will use the [PSR-12 coding style guide](https://www.php-fig.org/psr/psr-12/) in addition to the following rules as @@ -406,39 +411,39 @@ be preceded by a newline. Variable types for use in DocBlocks: -Type +Type Description -mixed +mixed A variable with undefined (or multiple) type. -int +int Integer type variable (whole number). -float +float Float type (point number). -bool +bool Logical type (true or false). -string +string String type (any value in " " or ' '). -null +null Null type. Usually used in conjunction with another type. -array +array Array type. -object +object Object type. A specific class name should be used if possible. -resource +resource Resource type (returned by for example mysql_connect()). Remember that when you specify the type as mixed, you should indicate whether it is unknown, or what the possible types are. -callable +callable Callable function. You can also combine types using the pipe char: @@ -565,25 +570,25 @@ for example: For casting we use: -Type +Type Description -(bool) +(bool) Cast to boolean. -(int) +(int) Cast to integer. -(float) +(float) Cast to float. -(string) +(string) Cast to string. -(array) +(array) Cast to array. -(object) +(object) Cast to object. Please use `(int)$var` instead of `intval($var)` and `(float)$var` instead diff --git a/docs/en/contributing/code.md b/docs/en/contributing/code.md index 3aa04b320e..ff95714b89 100644 --- a/docs/en/contributing/code.md +++ b/docs/en/contributing/code.md @@ -1,3 +1,8 @@ +--- +title: "Code" +description: "Patches and pull requests are a great way to contribute code back to CakePHP." +--- + # Code Patches and pull requests are a great way to contribute code back to CakePHP. diff --git a/docs/en/contributing/documentation.md b/docs/en/contributing/documentation.md index 08cdea2308..bfef7a8ab8 100644 --- a/docs/en/contributing/documentation.md +++ b/docs/en/contributing/documentation.md @@ -1,3 +1,8 @@ +--- +title: "Documentation" +description: "Contributing to the documentation is simple. Feel free to fork the repo, add your changes/improvements/translations and give back by issuing a pull request." +--- + # Documentation Contributing to the documentation is simple. The files are hosted on diff --git a/docs/en/contributing/tickets.md b/docs/en/contributing/tickets.md index de28adaf96..052a99aeda 100644 --- a/docs/en/contributing/tickets.md +++ b/docs/en/contributing/tickets.md @@ -1,3 +1,8 @@ +--- +title: "Tickets" +description: "Getting feedback and help from the community in the form of tickets is an extremely important part of the CakePHP development process." +--- + # Tickets Getting feedback and help from the community in the form of tickets is an diff --git a/docs/en/controllers.md b/docs/en/controllers.md index f3ef6aaef6..b2e0a2dcb1 100644 --- a/docs/en/controllers.md +++ b/docs/en/controllers.md @@ -1,3 +1,8 @@ +--- +title: "Controllers" +description: "Controllers are the 'C' in MVC. Controllers can be thought of as middle layer between the Model and View." +--- + # Controllers `class` Cake\\Controller\\**Controller** diff --git a/docs/en/controllers/components.md b/docs/en/controllers/components.md index 2aa2b96af4..12d3b0b10e 100644 --- a/docs/en/controllers/components.md +++ b/docs/en/controllers/components.md @@ -1,3 +1,8 @@ +--- +title: "Components" +description: "Components are packages of logic that are shared between controllers." +--- + # Components Components are packages of logic that are shared between controllers. diff --git a/docs/en/controllers/components/check-http-cache.md b/docs/en/controllers/components/check-http-cache.md index eab42313a9..331af1ed41 100644 --- a/docs/en/controllers/components/check-http-cache.md +++ b/docs/en/controllers/components/check-http-cache.md @@ -1,3 +1,8 @@ +--- +title: "Checking HTTP Cache" +description: "Skip rendering controller actions if the response has not yet changed" +--- + # Checking HTTP Cache `class` **CheckHttpCacheComponent**(ComponentCollection $collection, array $config = []) diff --git a/docs/en/controllers/components/flash.md b/docs/en/controllers/components/flash.md index 47f98bd2df..d655cd32c2 100644 --- a/docs/en/controllers/components/flash.md +++ b/docs/en/controllers/components/flash.md @@ -1,3 +1,8 @@ +--- +title: "Flash" +description: "FlashComponent provides a way to set one-time notification messages to be displayed after processing a form or acknowledging data" +--- + # Flash `class` Cake\\Controller\\Component\\**FlashComponent**(ComponentCollection $collection, array $config = []) diff --git a/docs/en/controllers/components/form-protection.md b/docs/en/controllers/components/form-protection.md index ad54ff8ba8..ecab0869fa 100644 --- a/docs/en/controllers/components/form-protection.md +++ b/docs/en/controllers/components/form-protection.md @@ -1,3 +1,8 @@ +--- +title: "Form Protection Component" +description: "The FormProtection Component provides protection against form data tampering." +--- + # Form Protection Component `class` **FormProtection**(ComponentCollection $collection, array $config = []) @@ -51,21 +56,21 @@ Configuring the form protection component is generally done in the controller's Available options are: -validate +### validate Set to `false` to completely skip the validation of POST requests, essentially turning off form validation. -unlockedFields +### unlockedFields Set to a list of form fields to exclude from POST validation. Fields can be unlocked either in the Component, or with `FormHelper::unlockField()`. Fields that have been unlocked are not required to be part of the POST and hidden unlocked fields do not have their values checked. -unlockedActions +### unlockedActions Actions to exclude from POST validation checks. -validationFailureCallback +### validationFailureCallback Callback to call in case of validation failure. Must be a valid Closure. Unset by default in which case exception is thrown on validation failure. diff --git a/docs/en/controllers/middleware.md b/docs/en/controllers/middleware.md index 7b463619fd..0630085eb6 100644 --- a/docs/en/controllers/middleware.md +++ b/docs/en/controllers/middleware.md @@ -1,3 +1,8 @@ +--- +title: "Middleware" +description: "Middleware objects give you the ability to 'wrap' your application in re-usable, composable layers of Request handling, or response building logic." +--- + # Middleware Middleware objects give you the ability to 'wrap' your application in re-usable, diff --git a/docs/en/controllers/pages-controller.md b/docs/en/controllers/pages-controller.md index 4c7a5e4b13..ee090c2aaf 100644 --- a/docs/en/controllers/pages-controller.md +++ b/docs/en/controllers/pages-controller.md @@ -1,3 +1,8 @@ +--- +title: "The Pages Controller" +description: "This is a simple and optional controller for serving up static content." +--- + # The Pages Controller CakePHP's official skeleton app ships with a default controller **PagesController.php**. diff --git a/docs/en/controllers/pagination.md b/docs/en/controllers/pagination.md index c1ab4b2938..849aa768b2 100644 --- a/docs/en/controllers/pagination.md +++ b/docs/en/controllers/pagination.md @@ -1,3 +1,8 @@ +--- +title: "Pagination" +description: "One of the main obstacles of creating flexible and user-friendly web applications is designing an intuitive user interface." +--- + # Pagination One of the main obstacles of creating flexible and user-friendly web diff --git a/docs/en/controllers/request-response.md b/docs/en/controllers/request-response.md index 7b5466c55d..378405e0cd 100644 --- a/docs/en/controllers/request-response.md +++ b/docs/en/controllers/request-response.md @@ -1,3 +1,8 @@ +--- +title: "Request & Response Objects" +description: "The request and response objects provide an abstraction around HTTP requests and responses." +--- + # Request & Response Objects The request and response objects provide an abstraction around HTTP requests and diff --git a/docs/en/core-libraries/app.md b/docs/en/core-libraries/app.md index df8341f2e4..d061b95dcd 100644 --- a/docs/en/core-libraries/app.md +++ b/docs/en/core-libraries/app.md @@ -1,3 +1,8 @@ +--- +title: "App Class" +description: "The App class is responsible for resource location and path management." +--- + # App Class `class` Cake\\Core\\**App** diff --git a/docs/en/core-libraries/caching.md b/docs/en/core-libraries/caching.md index 40b577410e..01d5f5d4ab 100644 --- a/docs/en/core-libraries/caching.md +++ b/docs/en/core-libraries/caching.md @@ -1,3 +1,8 @@ +--- +title: "Caching" +description: "Caching can be used to make reading from expensive or slow resources faster, by maintaining a second copy of the required data in a faster or closer storage system." +--- + # Caching `class` Cake\\Cache\\**Cache** diff --git a/docs/en/core-libraries/collections.md b/docs/en/core-libraries/collections.md index b7845f972d..e4fdcf302f 100644 --- a/docs/en/core-libraries/collections.md +++ b/docs/en/core-libraries/collections.md @@ -1,3 +1,8 @@ +--- +title: "Collections" +description: "The collection classes provide a set of tools to manipulate arrays or Traversable objects." +--- + # Collections `class` Cake\\Collection\\**Collection** diff --git a/docs/en/core-libraries/email.md b/docs/en/core-libraries/email.md index 7c154bf23e..ecdf6e0bc0 100644 --- a/docs/en/core-libraries/email.md +++ b/docs/en/core-libraries/email.md @@ -1,3 +1,8 @@ +--- +title: "Mailer" +description: "Mailer is a convenience class for sending easily reusable emails." +--- + # Mailer `class` Cake\\Mailer\\**Mailer**(string|array|null $profile = null) diff --git a/docs/en/core-libraries/events.md b/docs/en/core-libraries/events.md index beb6af7f13..bac144ee44 100644 --- a/docs/en/core-libraries/events.md +++ b/docs/en/core-libraries/events.md @@ -1,3 +1,8 @@ +--- +title: "Events System" +description: "Creating maintainable applications is both a science and an art. In the CakePHP implementation, an event object is dispatched to all listeners." +--- + # Events System Creating maintainable applications is both a science and an art. It is diff --git a/docs/en/core-libraries/form.md b/docs/en/core-libraries/form.md index 46dd0e928f..a4cc0d9f20 100644 --- a/docs/en/core-libraries/form.md +++ b/docs/en/core-libraries/form.md @@ -1,3 +1,8 @@ +--- +title: "Modelless Forms" +description: "The most common example of this is a contact form. Generally when using the Form class you'll want to use a subclass to define your form." +--- + # Modelless Forms `class` Cake\\Form\\**Form** diff --git a/docs/en/core-libraries/global-constants-and-functions.md b/docs/en/core-libraries/global-constants-and-functions.md index 038166b208..2330c3c9c0 100644 --- a/docs/en/core-libraries/global-constants-and-functions.md +++ b/docs/en/core-libraries/global-constants-and-functions.md @@ -1,3 +1,8 @@ +--- +title: "Constants & Functions" +description: "CakePHP features a number of global convenience functions that may come in handy." +--- + # Constants & Functions While most of your day-to-day work in CakePHP will be utilizing core classes and diff --git a/docs/en/core-libraries/hash.md b/docs/en/core-libraries/hash.md index ca9fdee3df..771b466ef0 100644 --- a/docs/en/core-libraries/hash.md +++ b/docs/en/core-libraries/hash.md @@ -1,4 +1,9 @@ -# Hash +--- +title: "Hash Utility" +description: "Array management, if done right, can be a very powerful and useful tool for building smarter, more optimized code." +--- + +# Hash Utility `class` Cake\\Utility\\**Hash** diff --git a/docs/en/core-libraries/httpclient.md b/docs/en/core-libraries/httpclient.md index 512a16b3f1..2c3f499ced 100644 --- a/docs/en/core-libraries/httpclient.md +++ b/docs/en/core-libraries/httpclient.md @@ -1,3 +1,8 @@ +--- +title: "Http Client" +description: "CakePHP includes a PSR-18 compliant HTTP client which can be used for making requests and retrieving responses." +--- + # Http Client `class` Cake\\Http\\**Client**(mixed $config = []) diff --git a/docs/en/core-libraries/inflector.md b/docs/en/core-libraries/inflector.md index b96e1ec305..aea8b0db19 100644 --- a/docs/en/core-libraries/inflector.md +++ b/docs/en/core-libraries/inflector.md @@ -1,3 +1,8 @@ +--- +title: "Inflector" +description: "Automatically transform english words to single, plural, camel-cased and other variants." +--- + # Inflector `class` Cake\\Utility\\**Inflector** diff --git a/docs/en/core-libraries/internationalization-and-localization.md b/docs/en/core-libraries/internationalization-and-localization.md index 3c7d8f34e7..e99159c456 100644 --- a/docs/en/core-libraries/internationalization-and-localization.md +++ b/docs/en/core-libraries/internationalization-and-localization.md @@ -1,3 +1,8 @@ +--- +title: "Internationalization & Localization" +description: "One of the best ways for an application to reach a larger audience is to cater to multiple languages." +--- + # Internationalization & Localization One of the best ways for an application to reach a larger audience is to cater diff --git a/docs/en/core-libraries/logging.md b/docs/en/core-libraries/logging.md index b9fc8a9193..650c9e625a 100644 --- a/docs/en/core-libraries/logging.md +++ b/docs/en/core-libraries/logging.md @@ -1,3 +1,8 @@ +--- +title: "Logging" +description: "With technologies like SOAP, AJAX, and REST APIs, debugging can be rather difficult. What search terms are being used? You can also use Log::write() directly." +--- + # Logging While CakePHP core Configure Class settings can really help you see diff --git a/docs/en/core-libraries/number.md b/docs/en/core-libraries/number.md index f152aa7897..34d8749dc0 100644 --- a/docs/en/core-libraries/number.md +++ b/docs/en/core-libraries/number.md @@ -1,3 +1,8 @@ +--- +title: "Number" +description: "Format numbers properly in e.g. your desired currency or a readable size like 20MB" +--- + # Number `class` Cake\\I18n\\**Number** diff --git a/docs/en/core-libraries/plugin.md b/docs/en/core-libraries/plugin.md index 182b41c31b..8632de09b9 100644 --- a/docs/en/core-libraries/plugin.md +++ b/docs/en/core-libraries/plugin.md @@ -1,3 +1,8 @@ +--- +title: "Plugin Class" +description: "The Plugin class is responsible for resource location and path management of plugins." +--- + # Plugin Class `class` Cake\\Core\\**Plugin** diff --git a/docs/en/core-libraries/registry-objects.md b/docs/en/core-libraries/registry-objects.md index a5cd355fa5..82fed27d06 100644 --- a/docs/en/core-libraries/registry-objects.md +++ b/docs/en/core-libraries/registry-objects.md @@ -1,3 +1,8 @@ +--- +title: "Registry Objects" +description: "The registry classes provide a simple way to create and retrieve loaded instances of a given object type. Configuration can also be set on-the-fly." +--- + # Registry Objects The registry classes provide a simple way to create and retrieve loaded diff --git a/docs/en/core-libraries/security.md b/docs/en/core-libraries/security.md index 38471896c7..d5049020c5 100644 --- a/docs/en/core-libraries/security.md +++ b/docs/en/core-libraries/security.md @@ -1,3 +1,8 @@ +--- +title: "Security Utility" +description: "The security library handles basic security measures such as providing methods for hashing and encrypting data." +--- + # Security Utility `class` Cake\\Utility\\**Security** diff --git a/docs/en/core-libraries/text.md b/docs/en/core-libraries/text.md index 7130e7082e..67ba0d19c3 100644 --- a/docs/en/core-libraries/text.md +++ b/docs/en/core-libraries/text.md @@ -1,3 +1,8 @@ +--- +title: "Text" +description: "The Text class includes convenience methods for creating and manipulating strings." +--- + # Text `class` Cake\\Utility\\**Text** diff --git a/docs/en/core-libraries/time.md b/docs/en/core-libraries/time.md index edc6d9aa8f..858400b4fd 100644 --- a/docs/en/core-libraries/time.md +++ b/docs/en/core-libraries/time.md @@ -1,3 +1,8 @@ +--- +title: "Date & Time" +description: "CakePHP offers a powerful set of Date and Time manipulation methods" +--- + # Date & Time `class` Cake\\I18n\\**DateTime** diff --git a/docs/en/core-libraries/validation.md b/docs/en/core-libraries/validation.md index 7c8b84151e..d50f9bb3c5 100644 --- a/docs/en/core-libraries/validation.md +++ b/docs/en/core-libraries/validation.md @@ -1,3 +1,8 @@ +--- +title: "Validation" +description: "The validation package in CakePHP provides features to build validators that can validate arbitrary arrays of data with ease." +--- + # Validation The validation package in CakePHP provides features to build validators that can diff --git a/docs/en/core-libraries/xml.md b/docs/en/core-libraries/xml.md index 2e716b3e95..d3ea3e822f 100644 --- a/docs/en/core-libraries/xml.md +++ b/docs/en/core-libraries/xml.md @@ -1,3 +1,8 @@ +--- +title: "Xml" +description: "The Xml class allows you to transform arrays into SimpleXMLElement or DOMDocument objects, and back into arrays again." +--- + # Xml `class` Cake\\Utility\\**Xml** diff --git a/docs/en/deployment.md b/docs/en/deployment.md index 8de20ce29e..3b092188f5 100644 --- a/docs/en/deployment.md +++ b/docs/en/deployment.md @@ -1,3 +1,8 @@ +--- +title: "Deployment" +description: "Once your app is ready to be deployed there are a few things you should do. Then, run composer install." +--- + # Deployment Once your app is ready to be deployed there are a few things you should do. diff --git a/docs/en/development/application.md b/docs/en/development/application.md index 8a025df7e1..a7675a7961 100644 --- a/docs/en/development/application.md +++ b/docs/en/development/application.md @@ -1,3 +1,8 @@ +--- +title: "Application" +description: "The Application class is the heart of your application." +--- + # Application The `Application` is the heart of your application. It controls diff --git a/docs/en/development/configuration.md b/docs/en/development/configuration.md index a08fd0a73c..2f42b99412 100644 --- a/docs/en/development/configuration.md +++ b/docs/en/development/configuration.md @@ -1,3 +1,8 @@ +--- +title: "Configuration" +description: "While conventions remove the need to configure all of CakePHP, you'll still need to configure a few things like your database credentials." +--- + # Configuration While conventions remove the need to configure all of CakePHP, you'll still need diff --git a/docs/en/development/debugging.md b/docs/en/development/debugging.md index 790d3af329..f40ac897a5 100644 --- a/docs/en/development/debugging.md +++ b/docs/en/development/debugging.md @@ -1,3 +1,8 @@ +--- +title: "Debugging" +description: "Debugging is an inevitable and necessary part of any development cycle." +--- + # Debugging Debugging is an inevitable and necessary part of any development diff --git a/docs/en/development/dependency-injection.md b/docs/en/development/dependency-injection.md index afa6e35381..d2e7614497 100644 --- a/docs/en/development/dependency-injection.md +++ b/docs/en/development/dependency-injection.md @@ -1,3 +1,8 @@ +--- +title: "Dependency Injection" +description: "The CakePHP service container enables you to manage class dependencies for your application services through dependency injection." +--- + # Dependency Injection The CakePHP service container enables you to manage class dependencies for your diff --git a/docs/en/development/errors.md b/docs/en/development/errors.md index 81b61fa347..74b9b55028 100644 --- a/docs/en/development/errors.md +++ b/docs/en/development/errors.md @@ -1,3 +1,8 @@ +--- +title: "Error & Exception Handling" +description: "CakePHP applications come with error and exception handling setup for you. PHP errors are trapped and displayed or logged." +--- + # Error & Exception Handling CakePHP applications come with error and exception handling setup for you. PHP diff --git a/docs/en/development/rest.md b/docs/en/development/rest.md index 855a07e56f..fc51f5d124 100644 --- a/docs/en/development/rest.md +++ b/docs/en/development/rest.md @@ -1,3 +1,8 @@ +--- +title: "REST" +description: "REST is a foundational concept to the open web. It maps certain HTTP methods to certain Controller actions for a given route." +--- + # REST REST is a foundational concept to the open web. CakePHP provides functionality diff --git a/docs/en/development/routing.md b/docs/en/development/routing.md index b85dacf265..3ed1e417f7 100644 --- a/docs/en/development/routing.md +++ b/docs/en/development/routing.md @@ -1,3 +1,8 @@ +--- +title: "Routing" +description: "Routing provides you tools that map URLs to controller actions." +--- + # Routing `class` Cake\\Routing\\**RouteBuilder** diff --git a/docs/en/development/sessions.md b/docs/en/development/sessions.md index a3fd3db602..f1b313c89b 100644 --- a/docs/en/development/sessions.md +++ b/docs/en/development/sessions.md @@ -1,3 +1,8 @@ +--- +title: "Sessions" +description: "CakePHP provides a wrapper and suite of utility features on top of PHP's native session extension." +--- + # Sessions CakePHP provides a wrapper and suite of utility features on top of PHP's native diff --git a/docs/en/development/testing.md b/docs/en/development/testing.md index 6c8cebc823..96ce9f1092 100644 --- a/docs/en/development/testing.md +++ b/docs/en/development/testing.md @@ -1,3 +1,8 @@ +--- +title: "Testing" +description: "CakePHP comes with comprehensive testing support built-in. CakePHP comes with integration for PHPUnit." +--- + # Testing CakePHP comes with comprehensive testing support built-in. CakePHP comes with diff --git a/docs/en/installation.md b/docs/en/installation.md index dff67bf182..d59200356a 100644 --- a/docs/en/installation.md +++ b/docs/en/installation.md @@ -1,6 +1,6 @@ --- title: Installation Guide -description: Learn how to install CakePHP using Composer, Docker, or DDEV. Complete setup guide for PHP 8.2+ with all system requirements and web server configurations. +description: "CakePHP is designed to be easy to install and configure. This guide will walk you through getting CakePHP up and running in just a few minutes." --- # Installation diff --git a/docs/en/intro.md b/docs/en/intro.md index 910cd8306b..b3411d6287 100644 --- a/docs/en/intro.md +++ b/docs/en/intro.md @@ -1,3 +1,8 @@ +--- +title: "CakePHP at a Glance" +description: "CakePHP is designed to make common web-development tasks simple, and easy. The conventions chapter covers the various conventions that CakePHP uses." +--- + # CakePHP at a Glance CakePHP is designed to make common web-development tasks simple, and easy. By diff --git a/docs/en/intro/conventions.md b/docs/en/intro/conventions.md index 408f097b75..df760aae89 100644 --- a/docs/en/intro/conventions.md +++ b/docs/en/intro/conventions.md @@ -1,3 +1,8 @@ +--- +title: "Structure & Conventions" +description: "CakePHP embraces convention over configuration. This guide covers both where files go and how to name them." +--- + # Structure & Conventions CakePHP embraces **convention over configuration**. By following conventions, you get free functionality without tracking config files, and create a uniform codebase that other developers can quickly understand. This guide covers both where files go and how to name them. diff --git a/docs/en/intro/where-to-get-help.md b/docs/en/intro/where-to-get-help.md index 2b0d01a1da..37f02fad04 100644 --- a/docs/en/intro/where-to-get-help.md +++ b/docs/en/intro/where-to-get-help.md @@ -1,3 +1,8 @@ +--- +title: "Where to Get Help" +description: "The Official CakePHP website is always a great place to visit." +--- + # Where to Get Help ## The Official CakePHP website diff --git a/docs/en/orm.md b/docs/en/orm.md index d80c153105..692b58717d 100644 --- a/docs/en/orm.md +++ b/docs/en/orm.md @@ -1,3 +1,8 @@ +--- +title: "Database Access & ORM" +description: "In CakePHP, working with data through the database is done with two primary object types: table objects and entities." +--- + # Database Access & ORM In CakePHP, working with data through the database is done with two primary object types: diff --git a/docs/en/orm/associations.md b/docs/en/orm/associations.md index 753a49555b..d62a496d97 100644 --- a/docs/en/orm/associations.md +++ b/docs/en/orm/associations.md @@ -1,3 +1,8 @@ +--- +title: "Associations - Linking Tables Together" +description: "Defining relations between different objects in your application should be a natural process. Authors may have many articles and comments." +--- + # Associations - Linking Tables Together Defining relations between different objects in your application should be diff --git a/docs/en/orm/behaviors.md b/docs/en/orm/behaviors.md index 803b5507ee..75ed1a652f 100644 --- a/docs/en/orm/behaviors.md +++ b/docs/en/orm/behaviors.md @@ -1,3 +1,8 @@ +--- +title: "Behaviors" +description: "Behaviors are a way to organize and enable horizontal re-use of Model layer logic. Conceptually they are similar to traits." +--- + # Behaviors Behaviors are a way to organize and enable horizontal re-use of Model layer diff --git a/docs/en/orm/behaviors/counter-cache.md b/docs/en/orm/behaviors/counter-cache.md index fa9969d7e3..f25b2f7e58 100644 --- a/docs/en/orm/behaviors/counter-cache.md +++ b/docs/en/orm/behaviors/counter-cache.md @@ -1,3 +1,8 @@ +--- +title: "CounterCache" +description: "Often times web applications need to display counts of related objects." +--- + # CounterCache `class` Cake\\ORM\\Behavior\\**CounterCacheBehavior** diff --git a/docs/en/orm/behaviors/timestamp.md b/docs/en/orm/behaviors/timestamp.md index 4e4fa993dd..812b22cbe5 100644 --- a/docs/en/orm/behaviors/timestamp.md +++ b/docs/en/orm/behaviors/timestamp.md @@ -1,3 +1,8 @@ +--- +title: "Timestamp" +description: "The timestamp behavior allows your table objects to update one or more timestamps on each model event." +--- + # Timestamp `class` Cake\\ORM\\Behavior\\**TimestampBehavior** diff --git a/docs/en/orm/behaviors/translate.md b/docs/en/orm/behaviors/translate.md index 0eccd613e3..81e7fab8dc 100644 --- a/docs/en/orm/behaviors/translate.md +++ b/docs/en/orm/behaviors/translate.md @@ -1,3 +1,8 @@ +--- +title: "Translate" +description: "The Translate behavior allows you to create and retrieve translated copies of your entities in multiple languages." +--- + # Translate `class` Cake\\ORM\\Behavior\\**TranslateBehavior** diff --git a/docs/en/orm/behaviors/tree.md b/docs/en/orm/behaviors/tree.md index 3c32ef1544..c04d87baf6 100644 --- a/docs/en/orm/behaviors/tree.md +++ b/docs/en/orm/behaviors/tree.md @@ -1,3 +1,8 @@ +--- +title: "Tree" +description: "It's fairly common to want to store hierarchical data in a database table." +--- + # Tree `class` Cake\\ORM\\Behavior\\**TreeBehavior** diff --git a/docs/en/orm/database-basics.md b/docs/en/orm/database-basics.md index e22a36b5f2..3a7bf317e0 100644 --- a/docs/en/orm/database-basics.md +++ b/docs/en/orm/database-basics.md @@ -1,3 +1,8 @@ +--- +title: "Database Basics" +description: "The functions described in this chapter illustrate what is possible to do with the lower-level database access API." +--- + # Database Basics The CakePHP database access layer abstracts and provides help with most aspects diff --git a/docs/en/orm/deleting-data.md b/docs/en/orm/deleting-data.md index 1057a23d10..5b33de1db1 100644 --- a/docs/en/orm/deleting-data.md +++ b/docs/en/orm/deleting-data.md @@ -1,3 +1,8 @@ +--- +title: "Deleting Data" +description: "" +--- + # Deleting Data `class` Cake\\ORM\\**Table** diff --git a/docs/en/orm/entities.md b/docs/en/orm/entities.md index e7b41fd9cb..49ca389b0d 100644 --- a/docs/en/orm/entities.md +++ b/docs/en/orm/entities.md @@ -1,3 +1,8 @@ +--- +title: "Entities" +description: "Entities contain methods to manipulate and access the data they contain. Fields can also be accessed as properties on the object." +--- + # Entities `class` Cake\\ORM\\**Entity** diff --git a/docs/en/orm/query-builder.md b/docs/en/orm/query-builder.md index 529e938925..23988ef4d2 100644 --- a/docs/en/orm/query-builder.md +++ b/docs/en/orm/query-builder.md @@ -1,3 +1,8 @@ +--- +title: "Query Builder" +description: "The ORM's query builder provides a simple to use fluent interface for creating and running queries." +--- + # Query Builder `class` Cake\\ORM\\Query\\SelectQuery\\**SelectQuery** diff --git a/docs/en/orm/retrieving-data-and-resultsets.md b/docs/en/orm/retrieving-data-and-resultsets.md index 38d4ed6f0b..a390673d1e 100644 --- a/docs/en/orm/retrieving-data-and-resultsets.md +++ b/docs/en/orm/retrieving-data-and-resultsets.md @@ -1,3 +1,8 @@ +--- +title: "Retrieving Data & Results Sets" +description: "Since the ORM now returns Collections and Entities, debugging these objects can be more complicated than in previous CakePHP versions." +--- + # Retrieving Data & Results Sets `class` Cake\\ORM\\**Table** diff --git a/docs/en/orm/saving-data.md b/docs/en/orm/saving-data.md index 031f96f76c..30d5b2e5db 100644 --- a/docs/en/orm/saving-data.md +++ b/docs/en/orm/saving-data.md @@ -1,3 +1,8 @@ +--- +title: "Saving Data" +description: "After you have loaded your data you will probably want to update and save the changes." +--- + # Saving Data `class` Cake\\ORM\\**Table** diff --git a/docs/en/orm/schema-system.md b/docs/en/orm/schema-system.md index 8684a88f09..ede8288af7 100644 --- a/docs/en/orm/schema-system.md +++ b/docs/en/orm/schema-system.md @@ -1,3 +1,8 @@ +--- +title: "Schema System" +description: "CakePHP features a schema system that is capable of reflecting and generating schema information for tables in SQL datastores." +--- + # Schema System CakePHP features a schema system that is capable of reflecting and generating diff --git a/docs/en/orm/table-objects.md b/docs/en/orm/table-objects.md index 1b730f7798..1f96dc5e7b 100644 --- a/docs/en/orm/table-objects.md +++ b/docs/en/orm/table-objects.md @@ -1,3 +1,8 @@ +--- +title: "Table Objects" +description: "Table objects are the main actors to interact with your database." +--- + # Table Objects `class` Cake\\ORM\\**Table** diff --git a/docs/en/orm/validation.md b/docs/en/orm/validation.md index 3a50d9ebad..2b78c51de9 100644 --- a/docs/en/orm/validation.md +++ b/docs/en/orm/validation.md @@ -1,3 +1,8 @@ +--- +title: "Validating Data" +description: "Before you save your data you will probably want to ensure the data is correct and consistent." +--- + # Validating Data Before you [save your data](../orm/saving-data) you diff --git a/docs/en/plugins.md b/docs/en/plugins.md index 90c8cdd675..3ed93fa264 100644 --- a/docs/en/plugins.md +++ b/docs/en/plugins.md @@ -1,3 +1,8 @@ +--- +title: "Plugins" +description: "CakePHP offers a great plugin ecosystem as well as private plugin functionality." +--- + # Plugins CakePHP allows you to set up a combination of controllers, models, diff --git a/docs/en/quickstart.md b/docs/en/quickstart.md index 446a53300c..000558203d 100644 --- a/docs/en/quickstart.md +++ b/docs/en/quickstart.md @@ -1,3 +1,8 @@ +--- +title: "Quick Start Guide" +description: "The best way to experience and learn CakePHP is to sit down and build something. By the end of this tutorial, you'll have a fully functional CMS" +--- + # Quick Start Guide The best way to experience and learn CakePHP is to sit down and build something. diff --git a/docs/en/release-policy.md b/docs/en/release-policy.md index a5f279c6d4..76ed35ec92 100644 --- a/docs/en/release-policy.md +++ b/docs/en/release-policy.md @@ -1,3 +1,8 @@ +--- +title: "Release Policy" +description: "CakePHP follows Semantic Versioning for all releases. This follows the versioning convention of major.minor.patch." +--- + # Release Policy CakePHP follows Semantic Versioning for all releases. This follows the versioning diff --git a/docs/en/security.md b/docs/en/security.md index 47ed908dd2..fc8ee4eaef 100644 --- a/docs/en/security.md +++ b/docs/en/security.md @@ -1,3 +1,8 @@ +--- +title: "Security" +description: "Overview of CakePHP security features and where to configure them, including the Security utility, CSRF protection, CSP, security headers, and HTTPS." +--- + # Security CakePHP provides you some tools to secure your application. In addition to the diff --git a/docs/en/security/content-security-policy.md b/docs/en/security/content-security-policy.md index 5f933cb263..f0b6f1c617 100644 --- a/docs/en/security/content-security-policy.md +++ b/docs/en/security/content-security-policy.md @@ -1,3 +1,8 @@ +--- +title: "Content Security Policy Middleware" +description: "The CspMiddleware makes it simpler to add Content-Security-Policy headers in your application." +--- + # Content Security Policy Middleware The `CspMiddleware` makes it simpler to add Content-Security-Policy headers in diff --git a/docs/en/security/csrf.md b/docs/en/security/csrf.md index 4857bbdb10..b9ecf266b9 100644 --- a/docs/en/security/csrf.md +++ b/docs/en/security/csrf.md @@ -1,3 +1,8 @@ +--- +title: "CSRF Protection" +description: "Cross-Site Request Forgeries (CSRF) are a class of exploit where unauthorized commands are performed on behalf of an authenticated user without their knowledge or consent." +--- + # CSRF Protection Cross-Site Request Forgeries (CSRF) are a class of exploit where unauthorized diff --git a/docs/en/security/https-enforcer.md b/docs/en/security/https-enforcer.md index 7f5efe51ad..81aeb72b1e 100644 --- a/docs/en/security/https-enforcer.md +++ b/docs/en/security/https-enforcer.md @@ -1,3 +1,8 @@ +--- +title: "HTTPS Enforcer Middleware" +description: "If you want your application to only be available via HTTPS connections you can use the HttpsEnforcerMiddleware" +--- + # HTTPS Enforcer Middleware If you want your application to only be available via HTTPS connections you can diff --git a/docs/en/security/security-headers.md b/docs/en/security/security-headers.md index e427e40c65..17fa3994c9 100644 --- a/docs/en/security/security-headers.md +++ b/docs/en/security/security-headers.md @@ -1,3 +1,8 @@ +--- +title: "Security Header Middleware" +description: "The SecurityHeaderMiddleware layer allows you to apply security related headers to your application." +--- + # Security Header Middleware The `SecurityHeaderMiddleware` layer allows you to apply security related diff --git a/docs/en/standalone-packages.md b/docs/en/standalone-packages.md index 89af45557c..20965e0ac8 100644 --- a/docs/en/standalone-packages.md +++ b/docs/en/standalone-packages.md @@ -1,3 +1,8 @@ +--- +title: "Standalone Packages" +description: "The CakePHP core is split into various standalone packages which can used independently." +--- + # Standalone Packages The CakePHP core is split into various standalone packages which can diff --git a/docs/en/topics.md b/docs/en/topics.md index 3d1b152554..8c2457859d 100644 --- a/docs/en/topics.md +++ b/docs/en/topics.md @@ -1,3 +1,8 @@ +--- +title: "Using CakePHP" +description: "Index to key CakePHP topics, linking to installation, configuration, routing, controllers, views, ORM, security, testing, deployment, and contributing guides." +--- + # Using CakePHP Introduction to all the key parts of CakePHP: diff --git a/docs/en/tutorials-and-examples.md b/docs/en/tutorials-and-examples.md index c9e2d38a90..41dd17be87 100644 --- a/docs/en/tutorials-and-examples.md +++ b/docs/en/tutorials-and-examples.md @@ -1,3 +1,8 @@ +--- +title: "Tutorials & Examples" +description: "Follow step-by-step CakePHP tutorials that build a CMS app, covering setup, database design, models, controllers, tags/users, authentication, and authorization." +--- + # Tutorials & Examples In this section, you can walk through typical CakePHP applications diff --git a/docs/en/tutorials-and-examples/cms/articles-controller.md b/docs/en/tutorials-and-examples/cms/articles-controller.md index a288000d20..ae7bc084c3 100644 --- a/docs/en/tutorials-and-examples/cms/articles-controller.md +++ b/docs/en/tutorials-and-examples/cms/articles-controller.md @@ -1,3 +1,8 @@ +--- +title: "CMS Tutorial - Creating the Articles Controller" +description: "" +--- + # CMS Tutorial - Creating the Articles Controller With our model created, we need a controller for our articles. Controllers in diff --git a/docs/en/tutorials-and-examples/cms/articles-model.md b/docs/en/tutorials-and-examples/cms/articles-model.md index 2b9d6c9994..5d55534354 100644 --- a/docs/en/tutorials-and-examples/cms/articles-model.md +++ b/docs/en/tutorials-and-examples/cms/articles-model.md @@ -1,3 +1,8 @@ +--- +title: "CMS Tutorial - Creating our First Model" +description: "" +--- + # CMS Tutorial - Creating our First Model Models are the heart of CakePHP applications. They enable us to read and diff --git a/docs/en/tutorials-and-examples/cms/authentication.md b/docs/en/tutorials-and-examples/cms/authentication.md index 6ce302c5f2..33f68c52d5 100644 --- a/docs/en/tutorials-and-examples/cms/authentication.md +++ b/docs/en/tutorials-and-examples/cms/authentication.md @@ -1,3 +1,8 @@ +--- +title: "CMS Tutorial - Authentication" +description: "" +--- + # CMS Tutorial - Authentication Now that our CMS has users, we can enable them to login using the diff --git a/docs/en/tutorials-and-examples/cms/authorization.md b/docs/en/tutorials-and-examples/cms/authorization.md index f58ff25c74..ea322e4b35 100644 --- a/docs/en/tutorials-and-examples/cms/authorization.md +++ b/docs/en/tutorials-and-examples/cms/authorization.md @@ -1,3 +1,8 @@ +--- +title: "CMS Tutorial - Authorization" +description: "" +--- + # CMS Tutorial - Authorization With users now able to login to our CMS, we want to apply authorization rules diff --git a/docs/en/tutorials-and-examples/cms/database.md b/docs/en/tutorials-and-examples/cms/database.md index a188664c75..240dcd42fc 100644 --- a/docs/en/tutorials-and-examples/cms/database.md +++ b/docs/en/tutorials-and-examples/cms/database.md @@ -1,3 +1,8 @@ +--- +title: "CMS Tutorial - Creating the Database" +description: "" +--- + # CMS Tutorial - Creating the Database Now that we have CakePHP installed, let's set up the database for our `CMS diff --git a/docs/en/tutorials-and-examples/cms/installation.md b/docs/en/tutorials-and-examples/cms/installation.md index 19a167e149..e41699c366 100644 --- a/docs/en/tutorials-and-examples/cms/installation.md +++ b/docs/en/tutorials-and-examples/cms/installation.md @@ -1,3 +1,8 @@ +--- +title: "Content Management Tutorial" +description: "This tutorial will walk you through the creation of a simple CMS (Content Management System) application." +--- + # Content Management Tutorial This tutorial will walk you through the creation of a simple `CMS (Content diff --git a/docs/en/tutorials-and-examples/cms/tags-and-users.md b/docs/en/tutorials-and-examples/cms/tags-and-users.md index 816a35f3b9..5f25a98da7 100644 --- a/docs/en/tutorials-and-examples/cms/tags-and-users.md +++ b/docs/en/tutorials-and-examples/cms/tags-and-users.md @@ -1,3 +1,8 @@ +--- +title: "CMS Tutorial - Tags and Users" +description: "" +--- + # CMS Tutorial - Tags and Users With the basic article creation functionality built, we need to enable multiple diff --git a/docs/en/views.md b/docs/en/views.md index 7bd0326c50..26a7500f39 100644 --- a/docs/en/views.md +++ b/docs/en/views.md @@ -1,3 +1,8 @@ +--- +title: "Views" +description: "Views are the V in MVC. Views are responsible for generating the specific output required for the request." +--- + # Views `class` Cake\\View\\**View** diff --git a/docs/en/views/cells.md b/docs/en/views/cells.md index af0ef768fb..4909abca14 100644 --- a/docs/en/views/cells.md +++ b/docs/en/views/cells.md @@ -1,3 +1,8 @@ +--- +title: "View Cells" +description: "View cells are small mini-controllers that can invoke view logic and render out templates." +--- + # View Cells View cells are small mini-controllers that can invoke view logic and render out diff --git a/docs/en/views/helpers.md b/docs/en/views/helpers.md index a476139a9d..da6f1b0078 100644 --- a/docs/en/views/helpers.md +++ b/docs/en/views/helpers.md @@ -1,3 +1,8 @@ +--- +title: "Helpers" +description: "Helpers are the component-like classes for the presentation layer of your application." +--- + # Helpers Helpers are the component-like classes for the presentation layer of your diff --git a/docs/en/views/helpers/breadcrumbs.md b/docs/en/views/helpers/breadcrumbs.md index 86a8ea3f45..feda8f6f63 100644 --- a/docs/en/views/helpers/breadcrumbs.md +++ b/docs/en/views/helpers/breadcrumbs.md @@ -1,3 +1,8 @@ +--- +title: "Breadcrumbs" +description: "BreadcrumbsHelper provides a way to easily deal with the creation and rendering of a breadcrumbs trail for your app." +--- + # Breadcrumbs `class` Cake\\View\\Helper\\**BreadcrumbsHelper**(View $view, array $config = []) diff --git a/docs/en/views/helpers/flash.md b/docs/en/views/helpers/flash.md index df82daee3b..c5fbee7ed7 100644 --- a/docs/en/views/helpers/flash.md +++ b/docs/en/views/helpers/flash.md @@ -1,3 +1,8 @@ +--- +title: "Flash" +description: "FlashComponent and FlashHelper primarily use elements to render flash messages." +--- + # Flash `class` Cake\\View\\Helper\\**FlashHelper**(View $view, array $config = []) diff --git a/docs/en/views/helpers/form.md b/docs/en/views/helpers/form.md index 0bd7ce794c..539dfc0dbc 100644 --- a/docs/en/views/helpers/form.md +++ b/docs/en/views/helpers/form.md @@ -1,3 +1,8 @@ +--- +title: "Form" +description: "The FormHelper does most of the heavy lifting in form creation." +--- + # Form `class` Cake\\View\\Helper\\**FormHelper**(View $view, array $config = []) diff --git a/docs/en/views/helpers/html.md b/docs/en/views/helpers/html.md index b1301f5ffa..30afe882f6 100644 --- a/docs/en/views/helpers/html.md +++ b/docs/en/views/helpers/html.md @@ -1,3 +1,8 @@ +--- +title: "Html" +description: "The role of the HtmlHelper in CakePHP is to make HTML-related options easier, faster, and more resilient to change." +--- + # Html `class` Cake\\View\\Helper\\**HtmlHelper**(View $view, array $config = []) diff --git a/docs/en/views/helpers/number.md b/docs/en/views/helpers/number.md index 0fbe4caada..5ae6c981e2 100644 --- a/docs/en/views/helpers/number.md +++ b/docs/en/views/helpers/number.md @@ -1,3 +1,8 @@ +--- +title: "Number" +description: "he NumberHelper contains convenient methods that enable display numbers in common formats in your views." +--- + # Number `class` Cake\\View\\Helper\\**NumberHelper**(View $view, array $config = []) diff --git a/docs/en/views/helpers/paginator.md b/docs/en/views/helpers/paginator.md index 84f224cae9..0ed90c2588 100644 --- a/docs/en/views/helpers/paginator.md +++ b/docs/en/views/helpers/paginator.md @@ -1,3 +1,8 @@ +--- +title: "Paginator" +description: "The PaginatorHelper is used to output pagination controls such as page numbers and next/previous links." +--- + # Paginator `class` Cake\\View\\Helper\\**PaginatorHelper**(View $view, array $config = []) diff --git a/docs/en/views/helpers/text.md b/docs/en/views/helpers/text.md index 5efedd0df5..ca56b07fa2 100644 --- a/docs/en/views/helpers/text.md +++ b/docs/en/views/helpers/text.md @@ -1,3 +1,8 @@ +--- +title: "Text" +description: "The TextHelper contains methods to make text more usable and friendly in your views." +--- + # Text `class` Cake\\View\\Helper\\**TextHelper**(View $view, array $config = []) diff --git a/docs/en/views/helpers/time.md b/docs/en/views/helpers/time.md index 8f407b4c9a..d9b6914cf1 100644 --- a/docs/en/views/helpers/time.md +++ b/docs/en/views/helpers/time.md @@ -1,3 +1,8 @@ +--- +title: "Time" +description: "The TimeHelper allows for the quick processing of time related information." +--- + # Time `class` Cake\\View\\Helper\\**TimeHelper**(View $view, array $config = []) diff --git a/docs/en/views/helpers/url.md b/docs/en/views/helpers/url.md index d83fb0a66e..06a798d831 100644 --- a/docs/en/views/helpers/url.md +++ b/docs/en/views/helpers/url.md @@ -1,3 +1,8 @@ +--- +title: "Url" +description: "The UrlHelper helps you to generate URLs from your other helpers." +--- + # Url `class` Cake\\View\\Helper\\**UrlHelper**(View $view, array $config = []) diff --git a/docs/en/views/json-and-xml-views.md b/docs/en/views/json-and-xml-views.md index 399bceeef4..f807c3d52f 100644 --- a/docs/en/views/json-and-xml-views.md +++ b/docs/en/views/json-and-xml-views.md @@ -1,3 +1,8 @@ +--- +title: "JSON and XML views" +description: "Depending on the Accept header you can render serialized data like json or xml." +--- + # JSON and XML views The `JsonView` and `XmlView` integration with CakePHP's diff --git a/docs/en/views/themes.md b/docs/en/views/themes.md index 36a8f1f93f..a4996a6f0d 100644 --- a/docs/en/views/themes.md +++ b/docs/en/views/themes.md @@ -1,3 +1,8 @@ +--- +title: "Themes" +description: "Themes in CakePHP are simply plugins that focus on providing template files." +--- + # Themes Themes in CakePHP are simply plugins that focus on providing template files. From c2cdcfe977c636581243c0d11227cc4c20c726bf Mon Sep 17 00:00:00 2001 From: Jasper Smet Date: Wed, 4 Feb 2026 08:59:57 +0100 Subject: [PATCH 2/2] update to use summarized descriptions --- docs/en/appendices.md | 2 +- docs/en/appendices/5-0-migration-guide.md | 2 +- docs/en/appendices/5-0-upgrade-guide.md | 2 +- docs/en/appendices/5-1-migration-guide.md | 2 +- docs/en/appendices/5-2-migration-guide.md | 2 +- docs/en/appendices/5-3-migration-guide.md | 2 +- docs/en/appendices/cakephp-development-process.md | 2 +- docs/en/appendices/glossary.md | 2 +- docs/en/appendices/migration-guides.md | 2 +- docs/en/appendices/phpunit-upgrade.md | 2 +- docs/en/console-commands.md | 2 +- docs/en/console-commands/cache.md | 2 +- docs/en/console-commands/commands.md | 2 +- docs/en/console-commands/completion.md | 2 +- docs/en/console-commands/counter-cache.md | 2 +- docs/en/console-commands/cron-jobs.md | 2 +- docs/en/console-commands/i18n.md | 2 +- docs/en/console-commands/input-output.md | 2 +- docs/en/console-commands/option-parsers.md | 2 +- docs/en/console-commands/plugin.md | 2 +- docs/en/console-commands/repl.md | 2 +- docs/en/console-commands/routes.md | 2 +- docs/en/console-commands/schema-cache.md | 2 +- docs/en/console-commands/server.md | 2 +- docs/en/contributing.md | 2 +- docs/en/contributing/backwards-compatibility.md | 2 +- docs/en/contributing/cakephp-coding-conventions.md | 2 +- docs/en/contributing/code.md | 2 +- docs/en/contributing/documentation.md | 2 +- docs/en/contributing/tickets.md | 2 +- docs/en/controllers.md | 2 +- docs/en/controllers/components.md | 2 +- docs/en/controllers/components/check-http-cache.md | 2 +- docs/en/controllers/components/flash.md | 2 +- docs/en/controllers/components/form-protection.md | 2 +- docs/en/controllers/middleware.md | 2 +- docs/en/controllers/pages-controller.md | 2 +- docs/en/controllers/pagination.md | 2 +- docs/en/controllers/request-response.md | 2 +- docs/en/core-libraries/app.md | 2 +- docs/en/core-libraries/caching.md | 2 +- docs/en/core-libraries/collections.md | 2 +- docs/en/core-libraries/email.md | 2 +- docs/en/core-libraries/events.md | 2 +- docs/en/core-libraries/form.md | 2 +- docs/en/core-libraries/global-constants-and-functions.md | 2 +- docs/en/core-libraries/hash.md | 2 +- docs/en/core-libraries/httpclient.md | 2 +- docs/en/core-libraries/inflector.md | 2 +- docs/en/core-libraries/internationalization-and-localization.md | 2 +- docs/en/core-libraries/logging.md | 2 +- docs/en/core-libraries/number.md | 2 +- docs/en/core-libraries/plugin.md | 2 +- docs/en/core-libraries/registry-objects.md | 2 +- docs/en/core-libraries/security.md | 2 +- docs/en/core-libraries/text.md | 2 +- docs/en/core-libraries/time.md | 2 +- docs/en/core-libraries/validation.md | 2 +- docs/en/core-libraries/xml.md | 2 +- docs/en/deployment.md | 2 +- docs/en/development/application.md | 2 +- docs/en/development/configuration.md | 2 +- docs/en/development/debugging.md | 2 +- docs/en/development/dependency-injection.md | 2 +- docs/en/development/errors.md | 2 +- docs/en/development/rest.md | 2 +- docs/en/development/routing.md | 2 +- docs/en/development/sessions.md | 2 +- docs/en/development/testing.md | 2 +- docs/en/intro.md | 2 +- docs/en/intro/conventions.md | 2 +- docs/en/intro/where-to-get-help.md | 2 +- docs/en/orm.md | 2 +- docs/en/orm/associations.md | 2 +- docs/en/orm/behaviors.md | 2 +- docs/en/orm/behaviors/counter-cache.md | 2 +- docs/en/orm/behaviors/timestamp.md | 2 +- docs/en/orm/behaviors/translate.md | 2 +- docs/en/orm/behaviors/tree.md | 2 +- docs/en/orm/database-basics.md | 2 +- docs/en/orm/deleting-data.md | 2 +- docs/en/orm/entities.md | 2 +- docs/en/orm/query-builder.md | 2 +- docs/en/orm/retrieving-data-and-resultsets.md | 2 +- docs/en/orm/saving-data.md | 2 +- docs/en/orm/schema-system.md | 2 +- docs/en/orm/table-objects.md | 2 +- docs/en/orm/validation.md | 2 +- docs/en/plugins.md | 2 +- docs/en/quickstart.md | 2 +- docs/en/release-policy.md | 2 +- docs/en/security.md | 2 +- docs/en/security/content-security-policy.md | 2 +- docs/en/security/csrf.md | 2 +- docs/en/security/https-enforcer.md | 2 +- docs/en/security/security-headers.md | 2 +- docs/en/standalone-packages.md | 2 +- docs/en/tutorials-and-examples/cms/articles-controller.md | 2 +- docs/en/tutorials-and-examples/cms/articles-model.md | 2 +- docs/en/tutorials-and-examples/cms/authentication.md | 2 +- docs/en/tutorials-and-examples/cms/authorization.md | 2 +- docs/en/tutorials-and-examples/cms/database.md | 2 +- docs/en/tutorials-and-examples/cms/tags-and-users.md | 2 +- docs/en/views.md | 2 +- docs/en/views/cells.md | 2 +- docs/en/views/helpers.md | 2 +- docs/en/views/helpers/breadcrumbs.md | 2 +- docs/en/views/helpers/flash.md | 2 +- docs/en/views/helpers/form.md | 2 +- docs/en/views/helpers/html.md | 2 +- docs/en/views/helpers/number.md | 2 +- docs/en/views/helpers/paginator.md | 2 +- docs/en/views/helpers/text.md | 2 +- docs/en/views/helpers/time.md | 2 +- docs/en/views/helpers/url.md | 2 +- docs/en/views/json-and-xml-views.md | 2 +- docs/en/views/themes.md | 2 +- 117 files changed, 117 insertions(+), 117 deletions(-) diff --git a/docs/en/appendices.md b/docs/en/appendices.md index 1920391de9..345f486367 100644 --- a/docs/en/appendices.md +++ b/docs/en/appendices.md @@ -1,6 +1,6 @@ --- title: "Appendices" -description: "Appendices contain information regarding the new features introduced in each version and the migration path between versions." +description: "CakePHP appendices: access migration guides, glossary, upgrade paths, development process info, and version-specific documentation." --- # Appendices diff --git a/docs/en/appendices/5-0-migration-guide.md b/docs/en/appendices/5-0-migration-guide.md index f0b0e10a15..316e412112 100644 --- a/docs/en/appendices/5-0-migration-guide.md +++ b/docs/en/appendices/5-0-migration-guide.md @@ -1,6 +1,6 @@ --- title: "5.0 Migration Guide" -description: "CakePHP 5.0 contains breaking changes, and is not backwards compatible with 4.x releases." +description: "Upgrade to CakePHP 5.0: migrate from 4.x, handle breaking changes, update code, understand new requirements and deprecation removals." --- # 5.0 Migration Guide diff --git a/docs/en/appendices/5-0-upgrade-guide.md b/docs/en/appendices/5-0-upgrade-guide.md index 11efe892d3..77d1fc9d48 100644 --- a/docs/en/appendices/5-0-upgrade-guide.md +++ b/docs/en/appendices/5-0-upgrade-guide.md @@ -1,6 +1,6 @@ --- title: "5.0 Upgrade Guide" -description: "First, check that your application is running on latest CakePHP 4.x version." +description: "Upgrade to CakePHP 5.0 from 4.x. Fix deprecations, update to PHP 8.1+, run rector tool, and update dependencies following this step-by-step guide." --- # 5.0 Upgrade Guide diff --git a/docs/en/appendices/5-1-migration-guide.md b/docs/en/appendices/5-1-migration-guide.md index 807fb1e032..e99f6aae07 100644 --- a/docs/en/appendices/5-1-migration-guide.md +++ b/docs/en/appendices/5-1-migration-guide.md @@ -1,6 +1,6 @@ --- title: "5.1 Migration Guide" -description: "The 5.1.0 release is backwards compatible with 5.0. It adds new functionality and introduces new deprecations." +description: "Migrate to CakePHP 5.1: explore new features, deprecations, improvements, and upgrade your 5.0 application with this comprehensive guide." --- # 5.1 Migration Guide diff --git a/docs/en/appendices/5-2-migration-guide.md b/docs/en/appendices/5-2-migration-guide.md index 161e0badd3..a720a3a5bd 100644 --- a/docs/en/appendices/5-2-migration-guide.md +++ b/docs/en/appendices/5-2-migration-guide.md @@ -1,6 +1,6 @@ --- title: "5.2 Migration Guide" -description: "The 5.2.0 release is backwards compatible with 5.0. It adds new functionality and introduces new deprecations." +description: "Migrate to CakePHP 5.2: understand new features, deprecations, breaking changes, and upgrade your application from 5.0/5.1 smoothly." --- # 5.2 Migration Guide diff --git a/docs/en/appendices/5-3-migration-guide.md b/docs/en/appendices/5-3-migration-guide.md index e3ccd6d6ae..6458e19b2f 100644 --- a/docs/en/appendices/5-3-migration-guide.md +++ b/docs/en/appendices/5-3-migration-guide.md @@ -1,6 +1,6 @@ --- title: "5.3 Migration Guide" -description: "The 5.3.0 release is backwards compatible with 5.0. It adds new functionality and introduces new deprecations." +description: "Upgrade to CakePHP 5.3: discover new features, deprecations, improvements, and migrate from 5.0-5.2 with this detailed guide." --- # 5.3 Migration Guide diff --git a/docs/en/appendices/cakephp-development-process.md b/docs/en/appendices/cakephp-development-process.md index 1ee87c9e2d..fa76feb94e 100644 --- a/docs/en/appendices/cakephp-development-process.md +++ b/docs/en/appendices/cakephp-development-process.md @@ -1,6 +1,6 @@ --- title: "CakePHP Development Process" -description: "CakePHP projects broadly follow semver. Minor releases are easier, major releases require some work." +description: "Understand CakePHP development: release cycles, semantic versioning, contribution workflow, and how the framework evolves over time." --- # CakePHP Development Process diff --git a/docs/en/appendices/glossary.md b/docs/en/appendices/glossary.md index 8037a0216d..6ae9138c3a 100644 --- a/docs/en/appendices/glossary.md +++ b/docs/en/appendices/glossary.md @@ -1,6 +1,6 @@ --- title: "Glossary" -description: "A list of commonly used abbreviations and names." +description: "CakePHP terminology reference: understand common abbreviations, technical terms, and framework-specific vocabulary used in documentation." --- # Glossary diff --git a/docs/en/appendices/migration-guides.md b/docs/en/appendices/migration-guides.md index f23d417238..28185f8820 100644 --- a/docs/en/appendices/migration-guides.md +++ b/docs/en/appendices/migration-guides.md @@ -1,6 +1,6 @@ --- title: "Migration Guides" -description: "Migration guides contain information regarding the new features introduced in each version and the migration path between 5.x minor releases." +description: "Upgrade CakePHP versions: follow migration guides for each release, understand breaking changes, and smoothly transition between versions." --- # Migration Guides diff --git a/docs/en/appendices/phpunit-upgrade.md b/docs/en/appendices/phpunit-upgrade.md index 730c3e249c..6cb5897ecc 100644 --- a/docs/en/appendices/phpunit-upgrade.md +++ b/docs/en/appendices/phpunit-upgrade.md @@ -1,6 +1,6 @@ --- title: "PHPUnit Upgrade" -description: "This guide covers the PHPUnit version requirements and migration steps for CakePHP 5.x applications. CakePHP 5.x requires PHPUnit ^11.5.3 or ^12.1.3." +description: "Upgrade PHPUnit in CakePHP 5.x: migrate tests to PHPUnit 11+, update assertions, configure test suites, and maintain compatibility." --- # PHPUnit Upgrade diff --git a/docs/en/console-commands.md b/docs/en/console-commands.md index c592cfc1f8..c30a883e1c 100644 --- a/docs/en/console-commands.md +++ b/docs/en/console-commands.md @@ -1,6 +1,6 @@ --- title: "Console Commands" -description: "In addition to a web framework, CakePHP also provides a console framework for creating command line tools & applications." +description: "Build CLI tools with CakePHP console framework: create commands, handle I/O, use option parsers, schedule cron jobs, and manage application tasks." --- # Console Commands diff --git a/docs/en/console-commands/cache.md b/docs/en/console-commands/cache.md index 328785e706..f8a367411a 100644 --- a/docs/en/console-commands/cache.md +++ b/docs/en/console-commands/cache.md @@ -1,6 +1,6 @@ --- title: "Cache Tool" -description: "To help you better manage cached data from a CLI environment, a console command is available for clearing cached data your application has." +description: "Manage cache from CLI in CakePHP: clear all caches, specific cache configs, and maintain cached data via console commands." --- # Cache Tool diff --git a/docs/en/console-commands/commands.md b/docs/en/console-commands/commands.md index 6430d3218d..88e9b7140d 100644 --- a/docs/en/console-commands/commands.md +++ b/docs/en/console-commands/commands.md @@ -1,6 +1,6 @@ --- title: "Command Objects" -description: "The command class comes with a number of built-in commands for speeding up your development, and automating routine tasks." +description: "Create CakePHP commands: build custom CLI tools, handle arguments, implement execute logic, and automate development tasks efficiently." --- # Command Objects diff --git a/docs/en/console-commands/completion.md b/docs/en/console-commands/completion.md index b69952a3d7..66a808c736 100644 --- a/docs/en/console-commands/completion.md +++ b/docs/en/console-commands/completion.md @@ -1,6 +1,6 @@ --- title: "Completion Tool" -description: "Working with the console gives the developer a lot of possibilities but having to completely know and write those commands can be tedious." +description: "Enable CakePHP CLI autocompletion: install shell completion, configure for bash/zsh, and improve developer experience with command suggestions." --- # Completion Tool diff --git a/docs/en/console-commands/counter-cache.md b/docs/en/console-commands/counter-cache.md index d1c86c1f40..6abfcb2b75 100644 --- a/docs/en/console-commands/counter-cache.md +++ b/docs/en/console-commands/counter-cache.md @@ -1,6 +1,6 @@ --- title: "CounterCache Tool" -description: "The CounterCacheCommand provides a CLI tool for rebuilding the counter caches in your application and plugin models." +description: "Rebuild counter caches in CakePHP: use CLI tool to recalculate cached counts, fix data inconsistencies, and maintain counter cache integrity." --- # CounterCache Tool diff --git a/docs/en/console-commands/cron-jobs.md b/docs/en/console-commands/cron-jobs.md index 53f9374abf..359444fb0c 100644 --- a/docs/en/console-commands/cron-jobs.md +++ b/docs/en/console-commands/cron-jobs.md @@ -1,6 +1,6 @@ --- title: "Running Shells as Cron Jobs" -description: "A common thing to do with a shell is making it run as a cronjob to clean up the database once in a while or send newsletters." +description: "Schedule CakePHP commands: run console commands as cron jobs, automate tasks, configure scheduling, and manage periodic operations." --- # Running Shells as Cron Jobs diff --git a/docs/en/console-commands/i18n.md b/docs/en/console-commands/i18n.md index 1be2c284a1..74ce6c8f8d 100644 --- a/docs/en/console-commands/i18n.md +++ b/docs/en/console-commands/i18n.md @@ -1,6 +1,6 @@ --- title: "I18N Tool" -description: "The i18n features of CakePHP use po files as their translation source. PO files integrate with commonly used translation tools like Poedit." +description: "Extract translations in CakePHP: generate PO files, extract translatable strings, integrate with Poedit, and manage i18n via CLI." --- # I18N Tool diff --git a/docs/en/console-commands/input-output.md b/docs/en/console-commands/input-output.md index feaedc6277..ffe62286da 100644 --- a/docs/en/console-commands/input-output.md +++ b/docs/en/console-commands/input-output.md @@ -1,6 +1,6 @@ --- title: "Command Input/Output" -description: "Formatting console output can be tedious and lead to maintenance issues." +description: "Handle CLI I/O in CakePHP: format console output, create progress bars, prompt users, display tables, and style terminal text." --- # Command Input/Output diff --git a/docs/en/console-commands/option-parsers.md b/docs/en/console-commands/option-parsers.md index 402962e94f..e1aa2bbca5 100644 --- a/docs/en/console-commands/option-parsers.md +++ b/docs/en/console-commands/option-parsers.md @@ -1,6 +1,6 @@ --- title: "Option Parsers" -description: "Command classes use the getOptionParser() hook method to define their option parser." +description: "Parse CLI options in CakePHP: define command arguments, options, subcommands, help text, and validate console input effectively." --- # Option Parsers diff --git a/docs/en/console-commands/plugin.md b/docs/en/console-commands/plugin.md index 993b843cf0..5ae23f0441 100644 --- a/docs/en/console-commands/plugin.md +++ b/docs/en/console-commands/plugin.md @@ -1,6 +1,6 @@ --- title: "Plugin Tool" -description: "The plugin tool allows you to load and unload plugins via the command prompt." +description: "Manage plugins via CLI in CakePHP: load/unload plugins, configure hooks, enable features, and manage plugin dependencies from terminal." --- diff --git a/docs/en/console-commands/repl.md b/docs/en/console-commands/repl.md index 3a5eb43bb0..f7e06d90b0 100644 --- a/docs/en/console-commands/repl.md +++ b/docs/en/console-commands/repl.md @@ -1,6 +1,6 @@ --- title: "Interactive Console (REPL)" -description: "CakePHP offers REPL(Read Eval Print Loop) plugin to let you explore some CakePHP and your application in an interactive console." +description: "Explore CakePHP interactively: use REPL console to test code, inspect objects, debug queries, and experiment with application logic." --- # Interactive Console (REPL) diff --git a/docs/en/console-commands/routes.md b/docs/en/console-commands/routes.md index 4839e6ccd1..8739ba65e8 100644 --- a/docs/en/console-commands/routes.md +++ b/docs/en/console-commands/routes.md @@ -1,6 +1,6 @@ --- title: "Routes Tool" -description: "The routes tool provides a simple to use CLI interface for testing and debugging routes. You can quickly see how a URL will be parsed using the check method:" +description: "Debug CakePHP routes: test URL parsing, check route matches, inspect routing configuration, and troubleshoot request routing issues via CLI." --- # Routes Tool diff --git a/docs/en/console-commands/schema-cache.md b/docs/en/console-commands/schema-cache.md index b1eb92ecc9..e826bc71ec 100644 --- a/docs/en/console-commands/schema-cache.md +++ b/docs/en/console-commands/schema-cache.md @@ -1,6 +1,6 @@ --- title: "Schema Cache Tool" -description: "The SchemaCacheCommand provides a simple CLI tool for managing your application's metadata caches." +description: "Manage schema caches in CakePHP: clear, build, warm up metadata caches via CLI to improve ORM performance and reduce queries." --- # Schema Cache Tool diff --git a/docs/en/console-commands/server.md b/docs/en/console-commands/server.md index a652755271..e69a9d1998 100644 --- a/docs/en/console-commands/server.md +++ b/docs/en/console-commands/server.md @@ -1,6 +1,6 @@ --- title: "Server Tool" -description: "The ServerCommand lets you stand up a simple webserver using the built in PHP webserver." +description: "Run development server in CakePHP: use built-in PHP webserver, configure host/port, and quickly test applications locally via CLI." --- # Server Tool diff --git a/docs/en/contributing.md b/docs/en/contributing.md index f75e5e2f0e..ed4befe429 100644 --- a/docs/en/contributing.md +++ b/docs/en/contributing.md @@ -1,6 +1,6 @@ --- title: "Contributing" -description: "There are a number of ways you can contribute to CakePHP. The following sections cover the various ways you can contribute to CakePHP:" +description: "Join CakePHP development: contribute code, documentation, report bugs, follow coding standards, submit pull requests, and help build the framework." --- # Contributing diff --git a/docs/en/contributing/backwards-compatibility.md b/docs/en/contributing/backwards-compatibility.md index 5fb161fbba..3168fb1ab3 100644 --- a/docs/en/contributing/backwards-compatibility.md +++ b/docs/en/contributing/backwards-compatibility.md @@ -1,6 +1,6 @@ --- title: "Backwards Compatibility Guide" -description: "Ensuring that you can upgrade your applications easily and smoothly is important to us. That's why we only break compatibility at major release milestones." +description: "Understand CakePHP backwards compatibility: semantic versioning promises, interface stability, class changes, and upgrade guidelines per release." --- # Backwards Compatibility Guide diff --git a/docs/en/contributing/cakephp-coding-conventions.md b/docs/en/contributing/cakephp-coding-conventions.md index 3ac5a8e11b..08564b7253 100644 --- a/docs/en/contributing/cakephp-coding-conventions.md +++ b/docs/en/contributing/cakephp-coding-conventions.md @@ -1,6 +1,6 @@ --- title: "Coding Standards" -description: "CakePHP developers will use the PSR-12 coding style guide in addition to the following rules as coding standards." +description: "Follow CakePHP coding standards: PSR-12 guidelines, indentation rules, line length, control structures, and best practices for contributions." --- # Coding Standards diff --git a/docs/en/contributing/code.md b/docs/en/contributing/code.md index ff95714b89..8fe0b19b53 100644 --- a/docs/en/contributing/code.md +++ b/docs/en/contributing/code.md @@ -1,6 +1,6 @@ --- title: "Code" -description: "Patches and pull requests are a great way to contribute code back to CakePHP." +description: "Contribute code to CakePHP: submit patches, create pull requests, follow coding standards, write tests, and join the development team." --- # Code diff --git a/docs/en/contributing/documentation.md b/docs/en/contributing/documentation.md index bfef7a8ab8..ab4f9a6faf 100644 --- a/docs/en/contributing/documentation.md +++ b/docs/en/contributing/documentation.md @@ -1,6 +1,6 @@ --- title: "Documentation" -description: "Contributing to the documentation is simple. Feel free to fork the repo, add your changes/improvements/translations and give back by issuing a pull request." +description: "Contribute to CakePHP docs: write clear documentation, follow formatting guidelines, translate content, and submit improvements via pull requests." --- # Documentation diff --git a/docs/en/contributing/tickets.md b/docs/en/contributing/tickets.md index 052a99aeda..8a50857fa8 100644 --- a/docs/en/contributing/tickets.md +++ b/docs/en/contributing/tickets.md @@ -1,6 +1,6 @@ --- title: "Tickets" -description: "Getting feedback and help from the community in the form of tickets is an extremely important part of the CakePHP development process." +description: "Report CakePHP bugs: create effective tickets, provide reproduction steps, follow guidelines, and contribute to issue tracking." --- # Tickets diff --git a/docs/en/controllers.md b/docs/en/controllers.md index b2e0a2dcb1..897d5b256e 100644 --- a/docs/en/controllers.md +++ b/docs/en/controllers.md @@ -1,6 +1,6 @@ --- title: "Controllers" -description: "Controllers are the 'C' in MVC. Controllers can be thought of as middle layer between the Model and View." +description: "Learn CakePHP controllers: handle requests, render views, manage components, use middleware, and implement request lifecycle callbacks in MVC architecture." --- # Controllers diff --git a/docs/en/controllers/components.md b/docs/en/controllers/components.md index 12d3b0b10e..1b9a7a10c5 100644 --- a/docs/en/controllers/components.md +++ b/docs/en/controllers/components.md @@ -1,6 +1,6 @@ --- title: "Components" -description: "Components are packages of logic that are shared between controllers." +description: "Use CakePHP components: share controller logic, configure components, load on-the-fly, create custom components, and implement callbacks." --- # Components diff --git a/docs/en/controllers/components/check-http-cache.md b/docs/en/controllers/components/check-http-cache.md index 331af1ed41..ca3a3cb736 100644 --- a/docs/en/controllers/components/check-http-cache.md +++ b/docs/en/controllers/components/check-http-cache.md @@ -1,6 +1,6 @@ --- title: "Checking HTTP Cache" -description: "Skip rendering controller actions if the response has not yet changed" +description: "Optimize with HTTP cache in CakePHP: skip rendering when response unchanged, use ETags, Last-Modified headers for better performance." --- # Checking HTTP Cache diff --git a/docs/en/controllers/components/flash.md b/docs/en/controllers/components/flash.md index d655cd32c2..bcf122001a 100644 --- a/docs/en/controllers/components/flash.md +++ b/docs/en/controllers/components/flash.md @@ -1,6 +1,6 @@ --- title: "Flash" -description: "FlashComponent provides a way to set one-time notification messages to be displayed after processing a form or acknowledging data" +description: "Display flash messages in CakePHP: show notifications, success/error messages, customize flash element rendering for user feedback." --- # Flash diff --git a/docs/en/controllers/components/form-protection.md b/docs/en/controllers/components/form-protection.md index ecab0869fa..6f276aa6ec 100644 --- a/docs/en/controllers/components/form-protection.md +++ b/docs/en/controllers/components/form-protection.md @@ -1,6 +1,6 @@ --- title: "Form Protection Component" -description: "The FormProtection Component provides protection against form data tampering." +description: "Prevent form tampering in CakePHP: use FormProtection to validate form integrity, prevent mass assignment, and secure POST data." --- # Form Protection Component diff --git a/docs/en/controllers/middleware.md b/docs/en/controllers/middleware.md index 0630085eb6..e98b3d0f54 100644 --- a/docs/en/controllers/middleware.md +++ b/docs/en/controllers/middleware.md @@ -1,6 +1,6 @@ --- title: "Middleware" -description: "Middleware objects give you the ability to 'wrap' your application in re-usable, composable layers of Request handling, or response building logic." +description: "Implement CakePHP middleware: wrap requests in reusable layers, handle PSR-15 middleware, configure error handling, and build HTTP pipelines." --- # Middleware diff --git a/docs/en/controllers/pages-controller.md b/docs/en/controllers/pages-controller.md index ee090c2aaf..b031c55a44 100644 --- a/docs/en/controllers/pages-controller.md +++ b/docs/en/controllers/pages-controller.md @@ -1,6 +1,6 @@ --- title: "The Pages Controller" -description: "This is a simple and optional controller for serving up static content." +description: "Serve static content in CakePHP: use PagesController to render simple pages, documentation, and content without database interactions." --- # The Pages Controller diff --git a/docs/en/controllers/pagination.md b/docs/en/controllers/pagination.md index 849aa768b2..3e09624447 100644 --- a/docs/en/controllers/pagination.md +++ b/docs/en/controllers/pagination.md @@ -1,6 +1,6 @@ --- title: "Pagination" -description: "One of the main obstacles of creating flexible and user-friendly web applications is designing an intuitive user interface." +description: "Paginate data in CakePHP: configure pagination, customize queries, sort results, display page numbers, and create user-friendly interfaces." --- # Pagination diff --git a/docs/en/controllers/request-response.md b/docs/en/controllers/request-response.md index 378405e0cd..9a349640af 100644 --- a/docs/en/controllers/request-response.md +++ b/docs/en/controllers/request-response.md @@ -1,6 +1,6 @@ --- title: "Request & Response Objects" -description: "The request and response objects provide an abstraction around HTTP requests and responses." +description: "Handle HTTP in CakePHP: work with Request/Response objects, parse data, set headers, handle uploads, and manage cookies efficiently." --- # Request & Response Objects diff --git a/docs/en/core-libraries/app.md b/docs/en/core-libraries/app.md index d061b95dcd..2a3e65c862 100644 --- a/docs/en/core-libraries/app.md +++ b/docs/en/core-libraries/app.md @@ -1,6 +1,6 @@ --- title: "App Class" -description: "The App class is responsible for resource location and path management." +description: "Locate resources in CakePHP: find paths to plugins, themes, vendors, configure namespace resolution with the App class utility." --- # App Class diff --git a/docs/en/core-libraries/caching.md b/docs/en/core-libraries/caching.md index 01d5f5d4ab..10a9e5e667 100644 --- a/docs/en/core-libraries/caching.md +++ b/docs/en/core-libraries/caching.md @@ -1,6 +1,6 @@ --- title: "Caching" -description: "Caching can be used to make reading from expensive or slow resources faster, by maintaining a second copy of the required data in a faster or closer storage system." +description: "Implement caching in CakePHP: configure cache engines, use Redis/Memcached, cache queries, views, and optimize application performance." --- # Caching diff --git a/docs/en/core-libraries/collections.md b/docs/en/core-libraries/collections.md index e4fdcf302f..0f6a661836 100644 --- a/docs/en/core-libraries/collections.md +++ b/docs/en/core-libraries/collections.md @@ -1,6 +1,6 @@ --- title: "Collections" -description: "The collection classes provide a set of tools to manipulate arrays or Traversable objects." +description: "Manipulate collections in CakePHP: map, filter, reduce, sort arrays and result sets using powerful collection methods and chains." --- # Collections diff --git a/docs/en/core-libraries/email.md b/docs/en/core-libraries/email.md index ecdf6e0bc0..b5aee863ca 100644 --- a/docs/en/core-libraries/email.md +++ b/docs/en/core-libraries/email.md @@ -1,6 +1,6 @@ --- title: "Mailer" -description: "Mailer is a convenience class for sending easily reusable emails." +description: "Send emails in CakePHP: configure SMTP, use Mailer classes, attach files, send HTML emails, and manage email templates efficiently." --- # Mailer diff --git a/docs/en/core-libraries/events.md b/docs/en/core-libraries/events.md index bac144ee44..2ca8ed37f6 100644 --- a/docs/en/core-libraries/events.md +++ b/docs/en/core-libraries/events.md @@ -1,6 +1,6 @@ --- title: "Events System" -description: "Creating maintainable applications is both a science and an art. In the CakePHP implementation, an event object is dispatched to all listeners." +description: "Implement event system in CakePHP: dispatch events, create listeners, use event manager, and decouple application components effectively." --- # Events System diff --git a/docs/en/core-libraries/form.md b/docs/en/core-libraries/form.md index a4cc0d9f20..83997544cf 100644 --- a/docs/en/core-libraries/form.md +++ b/docs/en/core-libraries/form.md @@ -1,6 +1,6 @@ --- title: "Modelless Forms" -description: "The most common example of this is a contact form. Generally when using the Form class you'll want to use a subclass to define your form." +description: "Create model-less forms in CakePHP: build contact forms, search forms, validate data without ORM using standalone Form classes." --- # Modelless Forms diff --git a/docs/en/core-libraries/global-constants-and-functions.md b/docs/en/core-libraries/global-constants-and-functions.md index 2330c3c9c0..557ebac43c 100644 --- a/docs/en/core-libraries/global-constants-and-functions.md +++ b/docs/en/core-libraries/global-constants-and-functions.md @@ -1,6 +1,6 @@ --- title: "Constants & Functions" -description: "CakePHP features a number of global convenience functions that may come in handy." +description: "Use CakePHP global functions: h(), debug(), pr(), env(), config(), and essential helpers available throughout your application." --- # Constants & Functions diff --git a/docs/en/core-libraries/hash.md b/docs/en/core-libraries/hash.md index 771b466ef0..28f5cc653e 100644 --- a/docs/en/core-libraries/hash.md +++ b/docs/en/core-libraries/hash.md @@ -1,6 +1,6 @@ --- title: "Hash Utility" -description: "Array management, if done right, can be a very powerful and useful tool for building smarter, more optimized code." +description: "Work with arrays in CakePHP: extract, combine, sort, filter data using Hash utility for powerful array manipulation and path syntax." --- # Hash Utility diff --git a/docs/en/core-libraries/httpclient.md b/docs/en/core-libraries/httpclient.md index 2c3f499ced..9176c43e84 100644 --- a/docs/en/core-libraries/httpclient.md +++ b/docs/en/core-libraries/httpclient.md @@ -1,6 +1,6 @@ --- title: "Http Client" -description: "CakePHP includes a PSR-18 compliant HTTP client which can be used for making requests and retrieving responses." +description: "Make HTTP requests in CakePHP: use PSR-18 client, send GET/POST requests, handle responses, configure authentication, and test APIs." --- # Http Client diff --git a/docs/en/core-libraries/inflector.md b/docs/en/core-libraries/inflector.md index aea8b0db19..2b1b16c187 100644 --- a/docs/en/core-libraries/inflector.md +++ b/docs/en/core-libraries/inflector.md @@ -1,6 +1,6 @@ --- title: "Inflector" -description: "Automatically transform english words to single, plural, camel-cased and other variants." +description: "Transform words in CakePHP: pluralize, singularize, camelize, underscore, humanize English words with Inflector for consistent naming." --- # Inflector diff --git a/docs/en/core-libraries/internationalization-and-localization.md b/docs/en/core-libraries/internationalization-and-localization.md index e99159c456..5abb9214e7 100644 --- a/docs/en/core-libraries/internationalization-and-localization.md +++ b/docs/en/core-libraries/internationalization-and-localization.md @@ -1,6 +1,6 @@ --- title: "Internationalization & Localization" -description: "One of the best ways for an application to reach a larger audience is to cater to multiple languages." +description: "Internationalize CakePHP apps: translate content, format dates/numbers by locale, manage PO files, and support multiple languages easily." --- # Internationalization & Localization diff --git a/docs/en/core-libraries/logging.md b/docs/en/core-libraries/logging.md index 650c9e625a..2bcda64d8a 100644 --- a/docs/en/core-libraries/logging.md +++ b/docs/en/core-libraries/logging.md @@ -1,6 +1,6 @@ --- title: "Logging" -description: "With technologies like SOAP, AJAX, and REST APIs, debugging can be rather difficult. What search terms are being used? You can also use Log::write() directly." +description: "Log in CakePHP: configure log streams, write messages, use PSR-3 interface, debug AJAX/REST APIs, and monitor application behavior." --- # Logging diff --git a/docs/en/core-libraries/number.md b/docs/en/core-libraries/number.md index 34d8749dc0..6cb4601e24 100644 --- a/docs/en/core-libraries/number.md +++ b/docs/en/core-libraries/number.md @@ -1,6 +1,6 @@ --- title: "Number" -description: "Format numbers properly in e.g. your desired currency or a readable size like 20MB" +description: "Format numbers in CakePHP: display currency, percentages, file sizes, and localized number formats with Number helper utility methods." --- # Number diff --git a/docs/en/core-libraries/plugin.md b/docs/en/core-libraries/plugin.md index 8632de09b9..bdc2903ade 100644 --- a/docs/en/core-libraries/plugin.md +++ b/docs/en/core-libraries/plugin.md @@ -1,6 +1,6 @@ --- title: "Plugin Class" -description: "The Plugin class is responsible for resource location and path management of plugins." +description: "Manage CakePHP plugins: locate plugin resources, resolve paths, configure plugin namespaces, and access plugin class files dynamically." --- # Plugin Class diff --git a/docs/en/core-libraries/registry-objects.md b/docs/en/core-libraries/registry-objects.md index 82fed27d06..6f7ff98ff6 100644 --- a/docs/en/core-libraries/registry-objects.md +++ b/docs/en/core-libraries/registry-objects.md @@ -1,6 +1,6 @@ --- title: "Registry Objects" -description: "The registry classes provide a simple way to create and retrieve loaded instances of a given object type. Configuration can also be set on-the-fly." +description: "Use CakePHP registries: manage object instances, configure on-the-fly, locate tables, helpers, components with the registry pattern." --- # Registry Objects diff --git a/docs/en/core-libraries/security.md b/docs/en/core-libraries/security.md index d5049020c5..a163895584 100644 --- a/docs/en/core-libraries/security.md +++ b/docs/en/core-libraries/security.md @@ -1,6 +1,6 @@ --- title: "Security Utility" -description: "The security library handles basic security measures such as providing methods for hashing and encrypting data." +description: "Encrypt and hash data in CakePHP: use Security library for password hashing, data encryption, HMAC generation, and secure random values." --- # Security Utility diff --git a/docs/en/core-libraries/text.md b/docs/en/core-libraries/text.md index 67ba0d19c3..27f18e9649 100644 --- a/docs/en/core-libraries/text.md +++ b/docs/en/core-libraries/text.md @@ -1,6 +1,6 @@ --- title: "Text" -description: "The Text class includes convenience methods for creating and manipulating strings." +description: "Manipulate strings in CakePHP: generate slugs, truncate text, create excerpts, highlight keywords with Text class convenience methods." --- # Text diff --git a/docs/en/core-libraries/time.md b/docs/en/core-libraries/time.md index 858400b4fd..8598157bd8 100644 --- a/docs/en/core-libraries/time.md +++ b/docs/en/core-libraries/time.md @@ -1,6 +1,6 @@ --- title: "Date & Time" -description: "CakePHP offers a powerful set of Date and Time manipulation methods" +description: "Manipulate dates and times in CakePHP: parse, format, compare, modify timestamps using powerful ChronosTime methods and utilities." --- # Date & Time diff --git a/docs/en/core-libraries/validation.md b/docs/en/core-libraries/validation.md index d50f9bb3c5..9ca0823a2b 100644 --- a/docs/en/core-libraries/validation.md +++ b/docs/en/core-libraries/validation.md @@ -1,6 +1,6 @@ --- title: "Validation" -description: "The validation package in CakePHP provides features to build validators that can validate arbitrary arrays of data with ease." +description: "Validate data in CakePHP: build validators, define rules, create custom validators, validate forms, and ensure data integrity easily." --- # Validation diff --git a/docs/en/core-libraries/xml.md b/docs/en/core-libraries/xml.md index d3ea3e822f..050915f3e0 100644 --- a/docs/en/core-libraries/xml.md +++ b/docs/en/core-libraries/xml.md @@ -1,6 +1,6 @@ --- title: "Xml" -description: "The Xml class allows you to transform arrays into SimpleXMLElement or DOMDocument objects, and back into arrays again." +description: "Work with XML in CakePHP: convert arrays to XML, parse XML to arrays, use SimpleXML/DOMDocument with Xml utility class." --- # Xml diff --git a/docs/en/deployment.md b/docs/en/deployment.md index 3b092188f5..19e3b4a84e 100644 --- a/docs/en/deployment.md +++ b/docs/en/deployment.md @@ -1,6 +1,6 @@ --- title: "Deployment" -description: "Once your app is ready to be deployed there are a few things you should do. Then, run composer install." +description: "Deploy CakePHP applications to production. Configure security, optimize performance, set document root, manage dependencies, and run migrations." --- # Deployment diff --git a/docs/en/development/application.md b/docs/en/development/application.md index a7675a7961..ebda15ce17 100644 --- a/docs/en/development/application.md +++ b/docs/en/development/application.md @@ -1,6 +1,6 @@ --- title: "Application" -description: "The Application class is the heart of your application." +description: "Configure CakePHP Application: bootstrap, load plugins, configure middleware, services, console commands, and manage application lifecycle." --- # Application diff --git a/docs/en/development/configuration.md b/docs/en/development/configuration.md index 2f42b99412..3d63c5bbef 100644 --- a/docs/en/development/configuration.md +++ b/docs/en/development/configuration.md @@ -1,6 +1,6 @@ --- title: "Configuration" -description: "While conventions remove the need to configure all of CakePHP, you'll still need to configure a few things like your database credentials." +description: "Configure CakePHP applications with PHP files, environment variables, and 12-factor app principles. Manage database, security, and CDN settings." --- # Configuration diff --git a/docs/en/development/debugging.md b/docs/en/development/debugging.md index f40ac897a5..736a2d5614 100644 --- a/docs/en/development/debugging.md +++ b/docs/en/development/debugging.md @@ -1,6 +1,6 @@ --- title: "Debugging" -description: "Debugging is an inevitable and necessary part of any development cycle." +description: "Debug CakePHP applications: use DebugKit, configure error handling, inspect queries, variables, and troubleshoot issues effectively." --- # Debugging diff --git a/docs/en/development/dependency-injection.md b/docs/en/development/dependency-injection.md index d2e7614497..cccda1d1c4 100644 --- a/docs/en/development/dependency-injection.md +++ b/docs/en/development/dependency-injection.md @@ -1,6 +1,6 @@ --- title: "Dependency Injection" -description: "The CakePHP service container enables you to manage class dependencies for your application services through dependency injection." +description: "Implement dependency injection in CakePHP: use service container, register services, resolve dependencies, and manage application services." --- # Dependency Injection diff --git a/docs/en/development/errors.md b/docs/en/development/errors.md index 74b9b55028..5bb912796c 100644 --- a/docs/en/development/errors.md +++ b/docs/en/development/errors.md @@ -1,6 +1,6 @@ --- title: "Error & Exception Handling" -description: "CakePHP applications come with error and exception handling setup for you. PHP errors are trapped and displayed or logged." +description: "Configure error and exception handling in CakePHP. Customize error pages, logging, renderers, and manage deprecation warnings for production apps." --- # Error & Exception Handling diff --git a/docs/en/development/rest.md b/docs/en/development/rest.md index fc51f5d124..7557509cc9 100644 --- a/docs/en/development/rest.md +++ b/docs/en/development/rest.md @@ -1,6 +1,6 @@ --- title: "REST" -description: "REST is a foundational concept to the open web. It maps certain HTTP methods to certain Controller actions for a given route." +description: "Build REST APIs in CakePHP with JSON/XML views, content negotiation, and resource routes. Serialize data automatically for modern web services." --- # REST diff --git a/docs/en/development/routing.md b/docs/en/development/routing.md index 3ed1e417f7..78bc126c00 100644 --- a/docs/en/development/routing.md +++ b/docs/en/development/routing.md @@ -1,6 +1,6 @@ --- title: "Routing" -description: "Routing provides you tools that map URLs to controller actions." +description: "Configure CakePHP routing: map URLs to controllers, use route parameters, scopes, prefixes, custom routes, and RESTful routing patterns." --- # Routing diff --git a/docs/en/development/sessions.md b/docs/en/development/sessions.md index f1b313c89b..0a70ec1933 100644 --- a/docs/en/development/sessions.md +++ b/docs/en/development/sessions.md @@ -1,6 +1,6 @@ --- title: "Sessions" -description: "CakePHP provides a wrapper and suite of utility features on top of PHP's native session extension." +description: "Manage sessions in CakePHP: configure session handlers, use database/cache storage, handle session data, and implement secure sessions." --- # Sessions diff --git a/docs/en/development/testing.md b/docs/en/development/testing.md index 96ce9f1092..7062cb987f 100644 --- a/docs/en/development/testing.md +++ b/docs/en/development/testing.md @@ -1,6 +1,6 @@ --- title: "Testing" -description: "CakePHP comes with comprehensive testing support built-in. CakePHP comes with integration for PHPUnit." +description: "Test CakePHP apps: write unit tests, integration tests, use fixtures, mock dependencies, run PHPUnit, and maintain code quality." --- # Testing diff --git a/docs/en/intro.md b/docs/en/intro.md index b3411d6287..c18ccaf7b7 100644 --- a/docs/en/intro.md +++ b/docs/en/intro.md @@ -1,6 +1,6 @@ --- title: "CakePHP at a Glance" -description: "CakePHP is designed to make common web-development tasks simple, and easy. The conventions chapter covers the various conventions that CakePHP uses." +description: "Explore CakePHP's MVC architecture: conventions over configuration, ORM basics, request lifecycle, and rapid web development fundamentals." --- # CakePHP at a Glance diff --git a/docs/en/intro/conventions.md b/docs/en/intro/conventions.md index df760aae89..72e9dfe121 100644 --- a/docs/en/intro/conventions.md +++ b/docs/en/intro/conventions.md @@ -1,6 +1,6 @@ --- title: "Structure & Conventions" -description: "CakePHP embraces convention over configuration. This guide covers both where files go and how to name them." +description: "Follow CakePHP's convention over configuration approach. Learn file structure, naming conventions, and how conventions enable automatic wiring." --- # Structure & Conventions diff --git a/docs/en/intro/where-to-get-help.md b/docs/en/intro/where-to-get-help.md index 37f02fad04..21a2d96eef 100644 --- a/docs/en/intro/where-to-get-help.md +++ b/docs/en/intro/where-to-get-help.md @@ -1,6 +1,6 @@ --- title: "Where to Get Help" -description: "The Official CakePHP website is always a great place to visit." +description: "Get CakePHP support: access documentation, join forums, Slack, Stack Overflow, GitHub issues, and connect with the community." --- # Where to Get Help diff --git a/docs/en/orm.md b/docs/en/orm.md index 692b58717d..8fc77753b2 100644 --- a/docs/en/orm.md +++ b/docs/en/orm.md @@ -1,6 +1,6 @@ --- title: "Database Access & ORM" -description: "In CakePHP, working with data through the database is done with two primary object types: table objects and entities." +description: "Master CakePHP ORM: work with table objects, entities, associations, query builder, validation, and database operations using conventions." --- # Database Access & ORM diff --git a/docs/en/orm/associations.md b/docs/en/orm/associations.md index d62a496d97..24af8b0c4e 100644 --- a/docs/en/orm/associations.md +++ b/docs/en/orm/associations.md @@ -1,6 +1,6 @@ --- title: "Associations - Linking Tables Together" -description: "Defining relations between different objects in your application should be a natural process. Authors may have many articles and comments." +description: "Define CakePHP associations: configure belongsTo, hasMany, hasOne, belongsToMany relationships, eager loading, and manage related data." --- # Associations - Linking Tables Together diff --git a/docs/en/orm/behaviors.md b/docs/en/orm/behaviors.md index 75ed1a652f..b69f0f1525 100644 --- a/docs/en/orm/behaviors.md +++ b/docs/en/orm/behaviors.md @@ -1,6 +1,6 @@ --- title: "Behaviors" -description: "Behaviors are a way to organize and enable horizontal re-use of Model layer logic. Conceptually they are similar to traits." +description: "Implement CakePHP behaviors: reuse model logic, create custom behaviors, use built-in behaviors like Timestamp and Tree across tables." --- # Behaviors diff --git a/docs/en/orm/behaviors/counter-cache.md b/docs/en/orm/behaviors/counter-cache.md index f25b2f7e58..bfffadaecc 100644 --- a/docs/en/orm/behaviors/counter-cache.md +++ b/docs/en/orm/behaviors/counter-cache.md @@ -1,6 +1,6 @@ --- title: "CounterCache" -description: "Often times web applications need to display counts of related objects." +description: "Maintain count caches in CakePHP: use CounterCacheBehavior to automatically update related record counts for better performance." --- # CounterCache diff --git a/docs/en/orm/behaviors/timestamp.md b/docs/en/orm/behaviors/timestamp.md index 812b22cbe5..a0bb97186a 100644 --- a/docs/en/orm/behaviors/timestamp.md +++ b/docs/en/orm/behaviors/timestamp.md @@ -1,6 +1,6 @@ --- title: "Timestamp" -description: "The timestamp behavior allows your table objects to update one or more timestamps on each model event." +description: "Auto-update timestamps in CakePHP: use TimestampBehavior to manage created/modified fields automatically on save operations." --- # Timestamp diff --git a/docs/en/orm/behaviors/translate.md b/docs/en/orm/behaviors/translate.md index 81e7fab8dc..ad4739b17e 100644 --- a/docs/en/orm/behaviors/translate.md +++ b/docs/en/orm/behaviors/translate.md @@ -1,6 +1,6 @@ --- title: "Translate" -description: "The Translate behavior allows you to create and retrieve translated copies of your entities in multiple languages." +description: "Translate entities in CakePHP: store multi-language content, retrieve translations, configure TranslateBehavior for internationalization." --- # Translate diff --git a/docs/en/orm/behaviors/tree.md b/docs/en/orm/behaviors/tree.md index c04d87baf6..77a47c3149 100644 --- a/docs/en/orm/behaviors/tree.md +++ b/docs/en/orm/behaviors/tree.md @@ -1,6 +1,6 @@ --- title: "Tree" -description: "It's fairly common to want to store hierarchical data in a database table." +description: "Store hierarchical data in CakePHP: use TreeBehavior to manage nested sets, move nodes, and query tree structures efficiently." --- # Tree diff --git a/docs/en/orm/database-basics.md b/docs/en/orm/database-basics.md index 3a7bf317e0..9c741d23f8 100644 --- a/docs/en/orm/database-basics.md +++ b/docs/en/orm/database-basics.md @@ -1,6 +1,6 @@ --- title: "Database Basics" -description: "The functions described in this chapter illustrate what is possible to do with the lower-level database access API." +description: "Use low-level database API in CakePHP: execute raw queries, manage connections, use query expressions, and work with database drivers." --- # Database Basics diff --git a/docs/en/orm/deleting-data.md b/docs/en/orm/deleting-data.md index 5b33de1db1..1e36afc82e 100644 --- a/docs/en/orm/deleting-data.md +++ b/docs/en/orm/deleting-data.md @@ -1,6 +1,6 @@ --- title: "Deleting Data" -description: "" +description: "Delete data in CakePHP ORM. Remove single entities, cascade deletes, bulk operations with deleteAll, and handle strict deletes with transactions." --- # Deleting Data diff --git a/docs/en/orm/entities.md b/docs/en/orm/entities.md index 49ca389b0d..48e69719a7 100644 --- a/docs/en/orm/entities.md +++ b/docs/en/orm/entities.md @@ -1,6 +1,6 @@ --- title: "Entities" -description: "Entities contain methods to manipulate and access the data they contain. Fields can also be accessed as properties on the object." +description: "Manage CakePHP entities: access data, implement accessors/mutators, handle mass assignment, virtual fields, and custom entity logic." --- # Entities diff --git a/docs/en/orm/query-builder.md b/docs/en/orm/query-builder.md index 23988ef4d2..3ab593942a 100644 --- a/docs/en/orm/query-builder.md +++ b/docs/en/orm/query-builder.md @@ -1,6 +1,6 @@ --- title: "Query Builder" -description: "The ORM's query builder provides a simple to use fluent interface for creating and running queries." +description: "Build database queries in CakePHP: use fluent interface, select data, apply conditions, joins, unions, subqueries, and optimize performance." --- # Query Builder diff --git a/docs/en/orm/retrieving-data-and-resultsets.md b/docs/en/orm/retrieving-data-and-resultsets.md index a390673d1e..c46edbfeb9 100644 --- a/docs/en/orm/retrieving-data-and-resultsets.md +++ b/docs/en/orm/retrieving-data-and-resultsets.md @@ -1,6 +1,6 @@ --- title: "Retrieving Data & Results Sets" -description: "Since the ORM now returns Collections and Entities, debugging these objects can be more complicated than in previous CakePHP versions." +description: "Retrieve data with CakePHP: find entities, use finders, work with result sets, debug queries, and implement custom finder methods efficiently." --- # Retrieving Data & Results Sets diff --git a/docs/en/orm/saving-data.md b/docs/en/orm/saving-data.md index 30d5b2e5db..b8b6b9d01d 100644 --- a/docs/en/orm/saving-data.md +++ b/docs/en/orm/saving-data.md @@ -1,6 +1,6 @@ --- title: "Saving Data" -description: "After you have loaded your data you will probably want to update and save the changes." +description: "Save data with CakePHP ORM: insert/update records, handle associations, validate entities, use transactions, and manage form data efficiently." --- # Saving Data diff --git a/docs/en/orm/schema-system.md b/docs/en/orm/schema-system.md index ede8288af7..a071ad1edb 100644 --- a/docs/en/orm/schema-system.md +++ b/docs/en/orm/schema-system.md @@ -1,6 +1,6 @@ --- title: "Schema System" -description: "CakePHP features a schema system that is capable of reflecting and generating schema information for tables in SQL datastores." +description: "Manage database schemas in CakePHP: reflect table structure, generate schemas, define columns, indexes, constraints, and migrations." --- # Schema System diff --git a/docs/en/orm/table-objects.md b/docs/en/orm/table-objects.md index 1f96dc5e7b..ec24b8a60f 100644 --- a/docs/en/orm/table-objects.md +++ b/docs/en/orm/table-objects.md @@ -1,6 +1,6 @@ --- title: "Table Objects" -description: "Table objects are the main actors to interact with your database." +description: "Work with CakePHP Table objects: define models, configure associations, implement finders, use behaviors, and handle lifecycle callbacks." --- # Table Objects diff --git a/docs/en/orm/validation.md b/docs/en/orm/validation.md index 2b78c51de9..5c040d0d46 100644 --- a/docs/en/orm/validation.md +++ b/docs/en/orm/validation.md @@ -1,6 +1,6 @@ --- title: "Validating Data" -description: "Before you save your data you will probably want to ensure the data is correct and consistent." +description: "Validate data in CakePHP: create validation rules, use validator objects, validate before save, and implement custom validation methods." --- # Validating Data diff --git a/docs/en/plugins.md b/docs/en/plugins.md index 3ed93fa264..af57564f49 100644 --- a/docs/en/plugins.md +++ b/docs/en/plugins.md @@ -1,6 +1,6 @@ --- title: "Plugins" -description: "CakePHP offers a great plugin ecosystem as well as private plugin functionality." +description: "Extend CakePHP with plugins: create reusable packages, load plugins, configure routes, override templates, and share functionality across apps." --- # Plugins diff --git a/docs/en/quickstart.md b/docs/en/quickstart.md index 000558203d..56b9d02e2a 100644 --- a/docs/en/quickstart.md +++ b/docs/en/quickstart.md @@ -1,6 +1,6 @@ --- title: "Quick Start Guide" -description: "The best way to experience and learn CakePHP is to sit down and build something. By the end of this tutorial, you'll have a fully functional CMS" +description: "Build your first CakePHP app: follow step-by-step tutorial to create a CMS, learn MVC basics, database, authentication, and deployment." --- # Quick Start Guide diff --git a/docs/en/release-policy.md b/docs/en/release-policy.md index 76ed35ec92..b90ef5b60f 100644 --- a/docs/en/release-policy.md +++ b/docs/en/release-policy.md @@ -1,6 +1,6 @@ --- title: "Release Policy" -description: "CakePHP follows Semantic Versioning for all releases. This follows the versioning convention of major.minor.patch." +description: "Understand CakePHP versioning: semantic versioning rules, major/minor/patch releases, backwards compatibility, and experimental feature guidelines." --- # Release Policy diff --git a/docs/en/security.md b/docs/en/security.md index fc8ee4eaef..d11f636913 100644 --- a/docs/en/security.md +++ b/docs/en/security.md @@ -1,6 +1,6 @@ --- title: "Security" -description: "Overview of CakePHP security features and where to configure them, including the Security utility, CSRF protection, CSP, security headers, and HTTPS." +description: "Secure your CakePHP app: implement CSRF protection, CSP headers, HTTPS enforcement, form protection, and security utilities best practices." --- # Security diff --git a/docs/en/security/content-security-policy.md b/docs/en/security/content-security-policy.md index f0b6f1c617..de3fe4addd 100644 --- a/docs/en/security/content-security-policy.md +++ b/docs/en/security/content-security-policy.md @@ -1,6 +1,6 @@ --- title: "Content Security Policy Middleware" -description: "The CspMiddleware makes it simpler to add Content-Security-Policy headers in your application." +description: "Implement CSP in CakePHP: configure Content-Security-Policy headers, manage nonces, directives with CspMiddleware for XSS protection." --- # Content Security Policy Middleware diff --git a/docs/en/security/csrf.md b/docs/en/security/csrf.md index b9ecf266b9..bfada29b4f 100644 --- a/docs/en/security/csrf.md +++ b/docs/en/security/csrf.md @@ -1,6 +1,6 @@ --- title: "CSRF Protection" -description: "Cross-Site Request Forgeries (CSRF) are a class of exploit where unauthorized commands are performed on behalf of an authenticated user without their knowledge or consent." +description: "Protect your CakePHP app from Cross-Site Request Forgery attacks using session-based or cookie-based CSRF protection middleware strategies." --- # CSRF Protection diff --git a/docs/en/security/https-enforcer.md b/docs/en/security/https-enforcer.md index 81aeb72b1e..24d0a14be1 100644 --- a/docs/en/security/https-enforcer.md +++ b/docs/en/security/https-enforcer.md @@ -1,6 +1,6 @@ --- title: "HTTPS Enforcer Middleware" -description: "If you want your application to only be available via HTTPS connections you can use the HttpsEnforcerMiddleware" +description: "Force HTTPS connections in your CakePHP application with HttpsEnforcerMiddleware to ensure secure data transmission and user privacy." --- # HTTPS Enforcer Middleware diff --git a/docs/en/security/security-headers.md b/docs/en/security/security-headers.md index 17fa3994c9..7303145103 100644 --- a/docs/en/security/security-headers.md +++ b/docs/en/security/security-headers.md @@ -1,6 +1,6 @@ --- title: "Security Header Middleware" -description: "The SecurityHeaderMiddleware layer allows you to apply security related headers to your application." +description: "Add security headers in CakePHP: configure X-Frame-Options, HSTS, X-Content-Type-Options with SecurityHeadersMiddleware for protection." --- # Security Header Middleware diff --git a/docs/en/standalone-packages.md b/docs/en/standalone-packages.md index 20965e0ac8..5a2dc5e0ad 100644 --- a/docs/en/standalone-packages.md +++ b/docs/en/standalone-packages.md @@ -1,6 +1,6 @@ --- title: "Standalone Packages" -description: "The CakePHP core is split into various standalone packages which can used independently." +description: "Use CakePHP packages independently: install core components separately, integrate collections, validation, i18n in any PHP project." --- # Standalone Packages diff --git a/docs/en/tutorials-and-examples/cms/articles-controller.md b/docs/en/tutorials-and-examples/cms/articles-controller.md index ae7bc084c3..01bf6e00ba 100644 --- a/docs/en/tutorials-and-examples/cms/articles-controller.md +++ b/docs/en/tutorials-and-examples/cms/articles-controller.md @@ -1,6 +1,6 @@ --- title: "CMS Tutorial - Creating the Articles Controller" -description: "" +description: "Build your first CakePHP controller for articles. Create index, view, add, edit actions with pagination, dynamic finders, and template rendering." --- # CMS Tutorial - Creating the Articles Controller diff --git a/docs/en/tutorials-and-examples/cms/articles-model.md b/docs/en/tutorials-and-examples/cms/articles-model.md index 5d55534354..f3cd739734 100644 --- a/docs/en/tutorials-and-examples/cms/articles-model.md +++ b/docs/en/tutorials-and-examples/cms/articles-model.md @@ -1,6 +1,6 @@ --- title: "CMS Tutorial - Creating our First Model" -description: "" +description: "Create your first CakePHP model with Table and Entity classes. Learn naming conventions, behaviors, mass assignment, and use Bake for code generation." --- # CMS Tutorial - Creating our First Model diff --git a/docs/en/tutorials-and-examples/cms/authentication.md b/docs/en/tutorials-and-examples/cms/authentication.md index 33f68c52d5..5700ce4a59 100644 --- a/docs/en/tutorials-and-examples/cms/authentication.md +++ b/docs/en/tutorials-and-examples/cms/authentication.md @@ -1,6 +1,6 @@ --- title: "CMS Tutorial - Authentication" -description: "" +description: "Add authentication to CakePHP CMS tutorial. Hash passwords securely, configure login/logout, use Authentication plugin with bcrypt password hashing." --- # CMS Tutorial - Authentication diff --git a/docs/en/tutorials-and-examples/cms/authorization.md b/docs/en/tutorials-and-examples/cms/authorization.md index ea322e4b35..49bcb7f32e 100644 --- a/docs/en/tutorials-and-examples/cms/authorization.md +++ b/docs/en/tutorials-and-examples/cms/authorization.md @@ -1,6 +1,6 @@ --- title: "CMS Tutorial - Authorization" -description: "" +description: "Implement authorization in CakePHP CMS with policy classes. Control user permissions, check resource access, and secure articles with the Authorization plugin." --- # CMS Tutorial - Authorization diff --git a/docs/en/tutorials-and-examples/cms/database.md b/docs/en/tutorials-and-examples/cms/database.md index 240dcd42fc..c4f57aac8d 100644 --- a/docs/en/tutorials-and-examples/cms/database.md +++ b/docs/en/tutorials-and-examples/cms/database.md @@ -1,6 +1,6 @@ --- title: "CMS Tutorial - Creating the Database" -description: "" +description: "Create the database for CakePHP CMS tutorial. Configure connections, build schema with migrations or SQL, add seed data, and set up relationships." --- # CMS Tutorial - Creating the Database diff --git a/docs/en/tutorials-and-examples/cms/tags-and-users.md b/docs/en/tutorials-and-examples/cms/tags-and-users.md index 5f25a98da7..4b9b960c98 100644 --- a/docs/en/tutorials-and-examples/cms/tags-and-users.md +++ b/docs/en/tutorials-and-examples/cms/tags-and-users.md @@ -1,6 +1,6 @@ --- title: "CMS Tutorial - Tags and Users" -description: "" +description: "Build tags and users in CakePHP CMS tutorial. Use Bake to generate code, create BelongsToMany associations, and implement tag filtering for articles." --- # CMS Tutorial - Tags and Users diff --git a/docs/en/views.md b/docs/en/views.md index 26a7500f39..f5c9919278 100644 --- a/docs/en/views.md +++ b/docs/en/views.md @@ -1,6 +1,6 @@ --- title: "Views" -description: "Views are the V in MVC. Views are responsible for generating the specific output required for the request." +description: "Create dynamic templates with CakePHP views: render HTML, manage layouts, use helpers, implement blocks, cells, and build reusable UI components." --- # Views diff --git a/docs/en/views/cells.md b/docs/en/views/cells.md index 4909abca14..17030f446b 100644 --- a/docs/en/views/cells.md +++ b/docs/en/views/cells.md @@ -1,6 +1,6 @@ --- title: "View Cells" -description: "View cells are small mini-controllers that can invoke view logic and render out templates." +description: "Build view cells in CakePHP: create mini-controllers for reusable UI components, encapsulate logic, and render self-contained views." --- # View Cells diff --git a/docs/en/views/helpers.md b/docs/en/views/helpers.md index da6f1b0078..42f70019a1 100644 --- a/docs/en/views/helpers.md +++ b/docs/en/views/helpers.md @@ -1,6 +1,6 @@ --- title: "Helpers" -description: "Helpers are the component-like classes for the presentation layer of your application." +description: "Use CakePHP view helpers: render forms, HTML, URLs, create custom helpers, and organize presentation logic across templates." --- # Helpers diff --git a/docs/en/views/helpers/breadcrumbs.md b/docs/en/views/helpers/breadcrumbs.md index feda8f6f63..bff77cfda3 100644 --- a/docs/en/views/helpers/breadcrumbs.md +++ b/docs/en/views/helpers/breadcrumbs.md @@ -1,6 +1,6 @@ --- title: "Breadcrumbs" -description: "BreadcrumbsHelper provides a way to easily deal with the creation and rendering of a breadcrumbs trail for your app." +description: "Create breadcrumbs in CakePHP: use BreadcrumbsHelper to build navigation trails, customize rendering, and improve user navigation." --- # Breadcrumbs diff --git a/docs/en/views/helpers/flash.md b/docs/en/views/helpers/flash.md index c5fbee7ed7..2c6b43835c 100644 --- a/docs/en/views/helpers/flash.md +++ b/docs/en/views/helpers/flash.md @@ -1,6 +1,6 @@ --- title: "Flash" -description: "FlashComponent and FlashHelper primarily use elements to render flash messages." +description: "Display flash messages in CakePHP templates using FlashHelper. Render session-based notifications with custom elements and routing prefix support." --- # Flash diff --git a/docs/en/views/helpers/form.md b/docs/en/views/helpers/form.md index 539dfc0dbc..90bce3b631 100644 --- a/docs/en/views/helpers/form.md +++ b/docs/en/views/helpers/form.md @@ -1,6 +1,6 @@ --- title: "Form" -description: "The FormHelper does most of the heavy lifting in form creation." +description: "Learn to create forms in CakePHP with FormHelper. Build secure, validated forms with automatic data population, context handling, and HTML generation." --- # Form diff --git a/docs/en/views/helpers/html.md b/docs/en/views/helpers/html.md index 30afe882f6..8e8e9c55e6 100644 --- a/docs/en/views/helpers/html.md +++ b/docs/en/views/helpers/html.md @@ -1,6 +1,6 @@ --- title: "Html" -description: "The role of the HtmlHelper in CakePHP is to make HTML-related options easier, faster, and more resilient to change." +description: "Generate HTML in CakePHP: use HtmlHelper for links, images, CSS, JavaScript, meta tags, and create semantic markup easily." --- # Html diff --git a/docs/en/views/helpers/number.md b/docs/en/views/helpers/number.md index 5ae6c981e2..44b513ce49 100644 --- a/docs/en/views/helpers/number.md +++ b/docs/en/views/helpers/number.md @@ -1,6 +1,6 @@ --- title: "Number" -description: "he NumberHelper contains convenient methods that enable display numbers in common formats in your views." +description: "Format numbers, currency, percentages, and data sizes in CakePHP views. NumberHelper provides convenient methods for common display formats." --- # Number diff --git a/docs/en/views/helpers/paginator.md b/docs/en/views/helpers/paginator.md index 0ed90c2588..ddbd907094 100644 --- a/docs/en/views/helpers/paginator.md +++ b/docs/en/views/helpers/paginator.md @@ -1,6 +1,6 @@ --- title: "Paginator" -description: "The PaginatorHelper is used to output pagination controls such as page numbers and next/previous links." +description: "Render pagination in CakePHP: use PaginatorHelper for page numbers, next/previous links, sort controls, and customize pagination display." --- # Paginator diff --git a/docs/en/views/helpers/text.md b/docs/en/views/helpers/text.md index ca56b07fa2..4e44813919 100644 --- a/docs/en/views/helpers/text.md +++ b/docs/en/views/helpers/text.md @@ -1,6 +1,6 @@ --- title: "Text" -description: "The TextHelper contains methods to make text more usable and friendly in your views." +description: "Transform text in CakePHP views with TextHelper. Auto-link URLs and emails, create paragraphs, truncate strings, and highlight keywords easily." --- # Text diff --git a/docs/en/views/helpers/time.md b/docs/en/views/helpers/time.md index d9b6914cf1..04b982ec7c 100644 --- a/docs/en/views/helpers/time.md +++ b/docs/en/views/helpers/time.md @@ -1,6 +1,6 @@ --- title: "Time" -description: "The TimeHelper allows for the quick processing of time related information." +description: "Format dates and times in views: use TimeHelper to display localized timestamps, relative times, and date formatting in templates." --- # Time diff --git a/docs/en/views/helpers/url.md b/docs/en/views/helpers/url.md index 06a798d831..944bb363d3 100644 --- a/docs/en/views/helpers/url.md +++ b/docs/en/views/helpers/url.md @@ -1,6 +1,6 @@ --- title: "Url" -description: "The UrlHelper helps you to generate URLs from your other helpers." +description: "Generate URLs in CakePHP: use UrlHelper to create links, reverse routing, build URLs with parameters, and maintain URL consistency." --- # Url diff --git a/docs/en/views/json-and-xml-views.md b/docs/en/views/json-and-xml-views.md index f807c3d52f..987ddf2a93 100644 --- a/docs/en/views/json-and-xml-views.md +++ b/docs/en/views/json-and-xml-views.md @@ -1,6 +1,6 @@ --- title: "JSON and XML views" -description: "Depending on the Accept header you can render serialized data like json or xml." +description: "Render JSON/XML in CakePHP: serialize data, configure views, use content negotiation, build APIs with JsonView and XmlView classes." --- # JSON and XML views diff --git a/docs/en/views/themes.md b/docs/en/views/themes.md index a4996a6f0d..95569d2a0a 100644 --- a/docs/en/views/themes.md +++ b/docs/en/views/themes.md @@ -1,6 +1,6 @@ --- title: "Themes" -description: "Themes in CakePHP are simply plugins that focus on providing template files." +description: "Create CakePHP themes: organize templates, override views, customize layouts, and build reusable presentation layers as plugins." --- # Themes