Wiki source code of Macro Options

Version 6.15 by Ecaterina Valica on 2012/06/12 18:36
Show last authors
1 {{velocity}}
2 $xwiki.ssx.use("Improvements.WebHome")
3 $xwiki.ssx.use("Standards.WebHome")
4 {{/velocity}}
5
6 == Community Feedback ==
7
8 {{info}}
9 [UX][Idea]
10 [users] Making it user-friendly to edit pages with macros for new users (was Re: Need some Help & Explanations) http://xwiki.markmail.org/thread/rnhe6tl3x7snquz7
11 {{/info}}
12
13 (% class="left column40 dashboardleft" %)
14 (((
15 == Issues ==
16 * the include macro rendering is confusing because the user might think he can in-line edit the content
17 * trying to delete some words in the welcome message results in deleting the macro
18 * we need to make clear that the home page content is just using an include macro to display the content located in another place
19
20 == Solution ==
21 * Have all macros collapsed by default
22 * Add collapsed/extended functionality inside the toolbar
23 * Make macros actions (edit, delete, +custom) more visible
24
25 )))
26
27 (% class="dashboardright right column60 " %)
28 (((
29 == Current ==
30 (% class="left column50 dashboardleft"%)
31 (((
32 Default: Macro Expanded
33 [[[[image:current.png||style="max-width: 98%; margin-bottom: 3em;"]]>>attach:current.png]]
34 )))
35
36 (% class="left column50 dashboardleft"%)
37 (((
38 Macro Collapsed
39 [[[[image:currentCollapsed.png||style="max-width: 98%; margin-bottom: 3em;"]]>>attach:currentCollapsed.png]]
40 )))
41
42 (%class='clearfloats'%)((()))
43
44 == Proposal ==
45
46 {{toc start='3' depth='3'/}}
47
48 === 1. Macros collapsed by default ===
49
50 (% class="left column50 dashboardleft"%)
51 (((
52 Default: Macros Collapsed
53 [[[[image:collapsedByDefault.png||style="max-width: 98%; margin-bottom: 3em;"]]>>attach:collapsedByDefault.png]]
54 The collapse/expanded functionality could be also added in the toolbar in order to be more discoverable
55 )))
56
57 (% class="left column50 dashboardleft"%)
58 (((
59 Expand Macros on demand
60 [[[[image:expandedOnDemand.png||style="max-width: 98%; margin-bottom: 3em;"]]>>attach:expandedOnDemand.png]]
61 Even in the expanded form, keep the macro header and have a special background color for the content in order to show it's a macro
62 )))
63
64 (%class='clearfloats'%)((()))
65
66 === 2. Macro Parameters ===
67
68 (% class="left column50 dashboardleft"%)
69 (((
70
71 [[[[image:macrosNoParams.png||style="max-width: 98%; margin-bottom: 3em;"]]>>attach:macrosNoParams.png]]
72 The macro's header contains at least the macro's name
73 )))
74
75 (% class="left column50 dashboardleft"%)
76 (((
77
78 [[[[image:macrosParams.png||style="max-width: 98%; margin-bottom: 3em;"]]>>attach:macrosParams.png]]
79 We could also display the macro params in the header
80
81 )))
82
83 (%class='clearfloats'%)((()))
84
85 === 2. Macro Actions ===
86
87 (% class="left column50 dashboardleft"%)
88 (((
89
90 [[[[image:macrosActionsV1.png||style="max-width: 98%; margin-bottom: 3em;"]]>>attach:macrosActionsV1.png]]
91
92 )))
93
94 (% class="left column50 dashboardleft"%)
95 (((
96
97 [[[[image:macrosActionsV2.png||style="max-width: 98%; margin-bottom: 3em;"]]>>attach:macrosActionsV2.png]]
98
99
100 )))
101
102 (%class='clearfloats'%)((()))
103
104 === x. Nested macros ===
105
106 (% class="left column50 dashboardleft"%)
107 (((
108
109 [[[[image:nestedMacrosCollapsed.png||style="max-width: 98%; margin-bottom: 3em;"]]>>attach:nestedMacrosCollapsed.png]]
110
111 Specially useful for macros like: {{columns}}, etc.
112 )))
113
114 (% class="left column50 dashboardleft"%)
115 (((
116
117 [[[[image:nestedMacrosExpanded.png||style="max-width: 98%; margin-bottom: 3em;"]]>>attach:nestedMacrosExpanded.png]]
118
119 )))
120
121 (%class='clearfloats'%)((()))
122
123 )))