[TASK] Update tags for all rst files for 8.0
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / 8.0 / Breaking-73698-StreamlineLayoutOfFlashMessages.rst
1
2 .. include:: ../../Includes.txt
3
4 =====================================================
5 Breaking: #73698 - Streamline layout of FlashMessages
6 =====================================================
7
8 See :issue:`73698`
9
10 Description
11 ===========
12
13 The layout and usage of FlashMessages has been streamlined in the TYPO3 backend.
14 All FlashMessages in the TYPO3 backend are now rendered as <div> markup and
15 contain an icon, the message and an optional title.
16
17 Example:
18
19 .. code-block:: html
20
21    <div class="alert alert-danger">
22       <div class="media">
23          <div class="media-left">
24             <span class="fa-stack fa-lg">
25                <i class="fa fa-circle fa-stack-2x"></i>
26                <i class="fa fa-times fa-stack-1x"></i>
27             </span>
28          </div>
29          <div class="media-body">
30             <h4 class="alert-title">The optional title</h4>
31             <p class="alert-message">The message goes here</p>
32          </div>
33       </div>
34    </div>
35
36
37 FlashMessages that are used as inline notification should be removed and replaced with custom HTML code.
38 For the core we have defined output and usage for messages:
39
40 1) FlashMessages
41 ----------------
42
43 FlashMessages are designed to inform a user about success or failure of an action, which was **triggered** by the user.
44 Example: If the user deletes a record, a FlashMessage informs the user about success or failure.
45 This kind of information is not static, it is a temporary and volatile information and triggered by a user action.
46
47 Keep in mind that you **must not** use HTML markup here, since this information
48 might be shown in a context different from HTML, like processing it via Javascript or
49 showing the message on the command line.
50
51 2) Callouts (InfoBox-ViewHelper)
52 --------------------------------
53 Callouts are designed to display permanent information, a very good example is the usage in the Page-Module.
54 If a user opens a system folder with the page module, the callout explains: 'Hey, you try to use the page module on a sys folder, please switch to the list module'.
55 This ViewHelper can also be used to show some help or instruction how to use a backend module.
56
57
58 3) Any other information
59 ------------------------
60 For any other information e.g. a list of files which has changed, must be handled in the action / view of the module or plugin. This is not a use case for a FlashMessage or Callout!
61 Example: Display a list of a hundred files within a FlashMessage or Callout is a bad idea, build custom markup in the view to handle this kind of message.
62
63
64 Impact
65 ======
66
67 Extensions which use the FlashMessageViewHelper with the default rendering will now get a list of <div>-messages instead of a <ul>-list.
68
69
70 Migration
71 =========
72
73 No migration needed, the generated output should be as expected. If the rendering is broken please consider about the correct usage of FlashMessages and read the explanation about message types above.
74
75 .. index:: Backend, Fluid