From 104e2835a7ec1998607b6fde3d9753f00c8d82ee Mon Sep 17 00:00:00 2001 From: braedinski Date: Fri, 21 Jul 2017 11:28:16 +1000 Subject: [PATCH] Update plugins.rst Changed opening paragraphs regarding plugin functionality, maybe it has a better flow. --- en/plugins.rst | 22 ++++++++++++---------- 1 file changed, 12 insertions(+), 10 deletions(-) diff --git a/en/plugins.rst b/en/plugins.rst index 95a99eeeea..2a7044fe8b 100644 --- a/en/plugins.rst +++ b/en/plugins.rst @@ -2,16 +2,18 @@ Plugins ####### CakePHP allows you to set up a combination of controllers, models, -and views and release them as a packaged application plugin that -others can use in their CakePHP applications. Have a great user -management module, simple blog, or web services module in one of -your applications? Package it as a CakePHP plugin so you can reuse it -in other applications and share with the community. - -The main tie between a plugin and the application it has been -installed into is the application's configuration (database -connection, etc.). Otherwise it operates in its own space, -behaving much like it would if it were an application on its own. +and views and release them as a pre-packaged application plugin that +others can use in their CakePHP applications. If you've created +a great user management, simple blog, or web services module in one of +your applications, why not package it as a CakePHP plugin? This way you +can reuse it in your other applications, and share with the community! + +A CakePHP plugin is ultimately separate from the host application itself +and generally provides some well-defined functionality that can be packaged up neatly, +and reused with little effort in other applications. The application and the plugin +operate in their own respective spaces, but share application-specific +properties (e.g. database connectivity parameters) which are defined and shared +through the application's configuration. In CakePHP 3.0 each plugin defines its own top-level namespace. For example: ``DebugKit``. By convention, plugins use their package name as their namespace.