From 93618ed73e1274d4ac01d99bbcc5b57393bcc564 Mon Sep 17 00:00:00 2001 From: Varun Agrawal Date: Wed, 30 Mar 2016 16:55:40 +0530 Subject: [PATCH 1/5] Fixed a typo in configuration-block It is not rendered properly right now (https://symfony.com/doc/current/book/controller.html#route-parameters-as-controller-arguments) I think this should fix it --- book/controller.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/controller.rst b/book/controller.rst index 71e8c88b69c..a837c145aa5 100644 --- a/book/controller.rst +++ b/book/controller.rst @@ -260,7 +260,7 @@ to ``$name``. Just make sure they the name of the placeholder is the same as the name of the argument variable. Take the following more-interesting example, where the controller has two -arguments:: +arguments: .. configuration-block:: From f483209a8be72e41a713b0787543a9ede5ec3e7a Mon Sep 17 00:00:00 2001 From: RickieL Date: Tue, 29 Mar 2016 17:02:02 +0800 Subject: [PATCH 2/5] fixed a typo fixed a typo --- book/controller.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/book/controller.rst b/book/controller.rst index a837c145aa5..22a07737648 100644 --- a/book/controller.rst +++ b/book/controller.rst @@ -704,7 +704,7 @@ The Request and Response Object ------------------------------- As mentioned :ref:`earlier `, the framework will -pass the ``Request`` object to any controller argument taht is type-hinted with +pass the ``Request`` object to any controller argument that is type-hinted with the ``Request`` class:: use Symfony\Component\HttpFoundation\Request; From 1da97477ba5b46797f6da17bec07606bb14df5df Mon Sep 17 00:00:00 2001 From: Christian Flothmann Date: Thu, 31 Mar 2016 17:04:55 +0200 Subject: [PATCH 3/5] fix spelling of the flashBag() method --- book/controller.rst | 2 +- cookbook/session/avoid_session_start.rst | 6 +++--- quick_tour/the_controller.rst | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/book/controller.rst b/book/controller.rst index 71e8c88b69c..37db7424497 100644 --- a/book/controller.rst +++ b/book/controller.rst @@ -671,7 +671,7 @@ read any flash messages from the session: .. code-block:: html+twig - {% for flash_message in app.session.flashbag.get('notice') %} + {% for flash_message in app.session.flashBag.get('notice') %}
{{ flash_message }}
diff --git a/cookbook/session/avoid_session_start.rst b/cookbook/session/avoid_session_start.rst index 87e798b6313..896ed8dd9c1 100644 --- a/cookbook/session/avoid_session_start.rst +++ b/cookbook/session/avoid_session_start.rst @@ -15,14 +15,14 @@ that a session is *always* started: .. code-block:: html+twig - {% for flashMessage in app.session.flashbag.get('notice') %} + {% for flashMessage in app.session.flashBag.get('notice') %}
{{ flashMessage }}
{% endfor %} Even if the user is not logged in and even if you haven't created any flash messages, -just calling the ``get()`` (or even ``has()``) method of the ``flashbag`` will +just calling the ``get()`` (or even ``has()``) method of the ``flashBag`` will start a session. This may hurt your application performance because all users will receive a session cookie. To avoid this behavior, add a check before trying to access the flash messages: @@ -30,7 +30,7 @@ access the flash messages: .. code-block:: html+twig {% if app.request.hasPreviousSession %} - {% for flashMessage in app.session.flashbag.get('notice') %} + {% for flashMessage in app.session.flashBag.get('notice') %}
{{ flashMessage }}
diff --git a/quick_tour/the_controller.rst b/quick_tour/the_controller.rst index b7dc01b672e..b88027df765 100644 --- a/quick_tour/the_controller.rst +++ b/quick_tour/the_controller.rst @@ -331,7 +331,7 @@ And you can display the flash message in the template like this: .. code-block:: html+twig - {% for flashMessage in app.session.flashbag.get('notice') %} + {% for flashMessage in app.session.flashBag.get('notice') %}
{{ flashMessage }}
@@ -344,4 +344,4 @@ That's all there is to it and I'm not even sure you'll have spent the full 10 minutes. You were briefly introduced to bundles in the first part and all the features you've learned about so far are part of the core FrameworkBundle. But thanks to bundles, everything in Symfony can be extended or replaced. -That's the topic of the :doc:`next part of this tutorial `. \ No newline at end of file +That's the topic of the :doc:`next part of this tutorial `. From 153219a34a5d1fc7aef38cf17d70e8d4e1b40934 Mon Sep 17 00:00:00 2001 From: Michael Phillips Date: Fri, 1 Apr 2016 01:41:05 -0500 Subject: [PATCH 4/5] Added tip for optional second parameter for form submissions. --- cookbook/form/direct_submit.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/cookbook/form/direct_submit.rst b/cookbook/form/direct_submit.rst index 108e3504756..7ddc42525b7 100644 --- a/cookbook/form/direct_submit.rst +++ b/cookbook/form/direct_submit.rst @@ -84,6 +84,13 @@ method, pass the submitted data directly to $form->get('firstName')->submit('Fabien'); +.. tip:: + + When submitting a form via a "PATCH" request, you may want to update only a few + submitted fields. To achieve this, you may pass an optional second boolean + parameter to ``submit()``. Passing ``false`` will remove any missing fields + within the form object. Otherwise, the mising fields will be set to ``null``. + .. _cookbook-form-submit-request: Passing a Request to Form::submit() (Deprecated) From 751aa45ef73f6535351766faf891df4c66b48dd2 Mon Sep 17 00:00:00 2001 From: WouterJ Date: Sun, 10 Apr 2016 00:28:48 +0200 Subject: [PATCH 5/5] Added March changelog --- changelog.rst | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) diff --git a/changelog.rst b/changelog.rst index 33e17e4750d..aaf5f355962 100644 --- a/changelog.rst +++ b/changelog.rst @@ -13,6 +13,57 @@ documentation. Do you also want to participate in the Symfony Documentation? Take a look at the ":doc:`/contributing/documentation/overview`" article. +March, 2016 +----------- + +New Documentation +~~~~~~~~~~~~~~~~~ + +* `#5894 `_ [WIP] Added an article to explain how to upgrade third-party bundles to Symfony 3 (javiereguiluz) +* `#6291 `_ fortrabbit deployment guide + index listing (ostark) + +Fixed Documentation +~~~~~~~~~~~~~~~~~~~ + +* `#6366 `_ Removed server:stop code block for 2.3 (theyoux) +* `#6334 `_ Fixed yaml configuration of app.exception_controller (AAstakhov) +* `#6315 `_ Remove third parameter from createFormBuilder call (Hocdoc) + +Minor Documentation Changes +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +* `#6404 `_ fixed a typo (RickieL) +* `#6411 `_ Fixed a typo in configuration-block (VarunAgw) +* `#6414 `_ stick to Sphinx 1.3.x for the moment (xabbuh) +* `#6397 `_ Fix typo in SwitchUserListener file name (luxifer) +* `#6382 `_ unused use instructions (bshevchenko) +* `#6365 `_ Removed the PR table example (this is now included by GitHub template) (javiereguiluz) +* `#6363 `_ Removed info about reducing visibility for private (AAstakhov) +* `#6362 `_ [book] Updated link to Translatable Extension (AAstakhov) +* `#6336 `_ Added minor clarification (ThomasLandauer) +* `#6303 `_ Tweaked the Symfony Releases page (javiereguiluz) +* `#6360 `_ Editing the Doctrine section to improve accuracy and readability (natechicago) +* `#6352 `_ [book] controller ch review, part 3 (Talita Kocjan Zager) +* `#6351 `_ [book] controller ch review, part 2 (Talita Kocjan Zager) +* `#6349 `_ [book] controller ch review, part 1 (Talita Kocjan Zager) +* `#6369 `_ Minor corrections (sfdumi) +* `#6370 `_ Fixed typo (tabbi89) +* `#6371 `_ Fix escaping of backtick inside double back-quotes (guilliamxavier) +* `#6364 `_ [reference] [constraints] added missing colon character for Image constraint documentation in YAML format. (hhamon) +* `#6345 `_ Remove link-local IPv6 address (snoek09) +* `#6219 `_ Point that route parameters are also Request attributes (sfdumi) +* `#6348 `_ [best practices] mostly typos (Talita Kocjan Zager) +* `#6275 `_ [quick tour] mostly typos (Talita Kocjan Zager) +* `#6305 `_ Mention IvoryCKEditorBundle in the Symfony Forms doc (javiereguiluz) +* `#6328 `_ Update extension.rst - added caution box for people trying to remove the default file with services definitions (Pavel Jurecka) +* `#6343 `_ Replace XLIFF number ids by strings (Triiistan) +* `#6344 `_ Altered single / multiple inheritance sentence (outspaced) +* `#6337 `_ Fix configuration.rst typo (gong023) +* `#6295 `_ Update tools.rst (andrewtch) +* `#6267 `_ [Form] fix 'data_class' option in EntityType (HeahDude) +* `#6281 `_ Change isValid to isSubmitted. (mustafaaloko) + + February, 2016 --------------