Last modified by Vincent Massol on 2024/02/26 17:52

Hide last authors
Ecaterina Moraru (Valica) 1.3 1 {{toc start="2"/}}
2
Ecaterina Moraru (Valica) 2.10 3 (% class="row" %)
4 (((
5 (% class="col-xs-12 col-sm-4" %)
6 (((
Ecaterina Moraru (Valica) 6.2 7 == General ==
Ecaterina Moraru (Valica) 1.2 8
Ecaterina Moraru (Valica) 4.8 9 {{usecase}}
Ecaterina Moraru (Valica) 19.5 10 Use [[auto-complete>>Proposal.AutocompleteOnReference]] for "List of strings" type parameter that expect Pages, Wikis, Users
Ecaterina Moraru (Valica) 4.8 11 {{/usecase}}
Ecaterina Moraru (Valica) 2.8 12
Ecaterina Moraru (Valica) 4.8 13 {{usecase}}
Ecaterina Moraru (Valica) 14.4 14 Use checkboxes for any "Boolean" type parameter
Ecaterina Moraru (Valica) 4.8 15 {{/usecase}}
Ecaterina Moraru (Valica) 6.6 16
17 {{usecase}}
Ecaterina Moraru (Valica) 14.4 18 Use select if there are multiple allowed values
Ecaterina Moraru (Valica) 6.6 19 {{/usecase}}
Ecaterina Moraru (Valica) 14.4 20
21 {{usecase}}
22 Provide the default value as placeholder for any "String or numerical value" type parameter
23 {{/usecase}}
24
25 {{usecase}}
26 Display the available macro parameters options in more usable controls, allowing faster usage
27 {{/usecase}}
28
29 {{usecase}}
30 Good Defaults: Provide demo content examples that work and can be experimented
31 {{/usecase}}
Ecaterina Moraru (Valica) 1.2 32 )))
33
Ecaterina Moraru (Valica) 2.10 34 (% class="col-xs-12 col-sm-4" %)
35 (((
Ecaterina Moraru (Valica) 6.2 36
Ecaterina Moraru (Valica) 1.2 37 )))
38
Ecaterina Moraru (Valica) 2.10 39 (% class="col-xs-12 col-sm-4" %)
40 (((
Ecaterina Moraru (Valica) 6.2 41
Ecaterina Moraru (Valica) 1.2 42 )))
43 )))
44
Ecaterina Moraru (Valica) 10.2 45 === Macros Count ===
Ecaterina Moraru (Valica) 4.6 46
Ecaterina Moraru (Valica) 2.10 47 (% class="row" %)
48 (((
49 (% class="col-xs-12 col-sm-4" %)
50 (((
Ecaterina Moraru (Valica) 4.8 51 {{usecase}}
52 Know how many available macros there are
53 {{/usecase}}
Ecaterina Moraru (Valica) 4.6 54
Ecaterina Moraru (Valica) 4.7 55 * There are 51 macros available in 10 categories (##All## + ##Other## + 8)
Ecaterina Moraru (Valica) 4.6 56 )))
57
58 (% class="col-xs-12 col-sm-4" %)
59 (((
Ecaterina Moraru (Valica) 6.2 60 Before
Ecaterina Moraru (Valica) 4.6 61 [[image:attach:macros.png]]
62 )))
63
64 (% class="col-xs-12 col-sm-4" %)
65 (((
Ecaterina Moraru (Valica) 6.2 66 After
Ecaterina Moraru (Valica) 4.9 67 [[image:attach:macros_count_after.png]]
Ecaterina Moraru (Valica) 5.2 68 [[image:attach:macros_count_after_expanded.png]]
Ecaterina Moraru (Valica) 4.6 69 )))
70 )))
71
Ecaterina Moraru (Valica) 10.2 72 === Back to Gallery ===
Ecaterina Moraru (Valica) 8.2 73
74 (% class="row" %)
75 (((
76 (% class="col-xs-12 col-sm-4" %)
77 (((
78 {{usecase}}
79 Have a button that takes the user back to the gallery
80 {{/usecase}}
81
82 * The button exists, but because of position / naming, users don't use it and they redo the steps from the start
83 )))
84
85 (% class="col-xs-12 col-sm-4" %)
86 (((
87 Before
88 [[image:attach:macros_back.png]]
89 )))
90
91 (% class="col-xs-12 col-sm-4" %)
92 (((
93 After
94 [[image:attach:macros_back_after.png]]
95 )))
96 )))
97
Ecaterina Moraru (Valica) 10.2 98 === Macros Documentation ===
Ecaterina Moraru (Valica) 6.3 99
Ecaterina Moraru (Valica) 4.6 100 (% class="row" %)
101 (((
102 (% class="col-xs-12 col-sm-4" %)
103 (((
Ecaterina Moraru (Valica) 6.3 104 {{usecase}}
105 Know how many available macros there are
106 {{/usecase}}
107
Ecaterina Moraru (Valica) 6.5 108 {{jira url="https://jira.xwiki.org" style="list"}}
Ecaterina Moraru (Valica) 6.3 109 XWIKI-4448
110 {{/jira}}
111 )))
112
113 (% class="col-xs-12 col-sm-4" %)
114 (((
115 Before
116 [[image:attach:macros_doc.png]]
117 )))
118
119 (% class="col-xs-12 col-sm-4" %)
120 (((
121 After
122 [[image:attach:macros_doc_after.png]]
123 )))
124 )))
125
Ecaterina Moraru (Valica) 23.2 126 === Deprecated Macros ===
127
128 {{usecase}}
129 Remove these macros
130 {{/usecase}}
131
132 * Space Index Macro
Ecaterina Moraru (Valica) 23.3 133 * Spaces Macro
134 * Workspaces Legacy
Ecaterina Moraru (Valica) 23.2 135
Ecaterina Moraru (Valica) 23.3 136 === Move Macros ===
137
138 * Move from ##Content## to ##Development## category
139 ** Display, Include Macros
140 ** Translation Macro
141
142 * Move from ##Content## to ##Notifications## category
143 ** Activity Macro
144 ** Watch List Macro
145 ** RSS Macro ?
146
Ecaterina Moraru (Valica) 23.5 147 * Move from ##Social## to ##Notifications## category
148 ** Message Sender - being the only one listed
149
Ecaterina Moraru (Valica) 10.2 150 == Macros ==
151
Ecaterina Moraru (Valica) 6.3 152 (% class="row" %)
153 (((
154 (% class="col-xs-12 col-sm-4" %)
155 (((
Ecaterina Moraru (Valica) 10.2 156 === Macro: Activity ===
Ecaterina Moraru (Valica) 1.2 157
Ecaterina Moraru (Valica) 2.10 158 * [[URL>>doc:extensions:Extension.Activity Macro]]
Ecaterina Moraru (Valica) 4.3 159 * Placeholders
Ecaterina Moraru (Valica) 4.5 160 * Wiki/Page/Authors/(Tags) references autocomplete
Ecaterina Moraru (Valica) 2.10 161 )))
Ecaterina Moraru (Valica) 1.2 162
Ecaterina Moraru (Valica) 2.10 163 (% class="col-xs-12 col-sm-4" %)
164 (((
165 [[image:attach:activity_before.png]]
Ecaterina Moraru (Valica) 1.2 166 )))
167
Ecaterina Moraru (Valica) 2.10 168 (% class="col-xs-12 col-sm-4" %)
169 (((
170 [[image:attach:activity_after.png]]
171 )))
172 )))
Ecaterina Moraru (Valica) 1.2 173
Ecaterina Moraru (Valica) 10.6 174 (% class="row" %)
175 (((
176 (% class="col-xs-12 col-sm-4" %)
177 (((
178 === Macro: Chart ===
Ecaterina Moraru (Valica) 12.2 179
180 * [[URL>>doc:extensions:Extension.Chart Macro]]
Ecaterina Moraru (Valica) 14.6 181 * Good Defaults that have a demo example that can be tested
Ecaterina Moraru (Valica) 12.2 182 * Placeholders
Ecaterina Moraru (Valica) 14.3 183 * Select control instead of input for ##type## and ##source## params
Ecaterina Moraru (Valica) 10.6 184 )))
Ecaterina Moraru (Valica) 2.10 185
Ecaterina Moraru (Valica) 10.6 186 (% class="col-xs-12 col-sm-4" %)
187 (((
Ecaterina Moraru (Valica) 10.7 188 [[image:attach:chart_before.png]]
Ecaterina Moraru (Valica) 10.6 189 )))
190
191 (% class="col-xs-12 col-sm-4" %)
192 (((
Ecaterina Moraru (Valica) 14.9 193 {{gallery}}
194 image:chart_after.png
195 image:chart_types.png
196 image:chart_after_2.png
197 {{/gallery}}
Ecaterina Moraru (Valica) 10.9 198
199 {{code}}
200 <select>
Ecaterina Moraru (Valica) 10.8 201 <option disabled="" selected="">Select an option</option>
Ecaterina Moraru (Valica) 15.4 202 <option>area </option>
203 <option>bar </option>
204 <option>bar3D </option>
205 <option>line </option>
206 <option>line3D </option>
207 <option>pie </option>
208 <option>stackedbar </option>
209 <option>stackedbar3D </option>
210 <option>xy_area </option>
211 <option>xy_line_and_shape </option>
212 <option>xy_line3D </option>
213 <option>xy_step </option>
Ecaterina Moraru (Valica) 10.9 214 </select>
215 {{/code}}
Ecaterina Moraru (Valica) 12.3 216
Ecaterina Moraru (Valica) 13.2 217 {{code}}
218 {{chart type="pie" params="range:B2-D5" source="inline"}}
219 |=|=X|=Y|=Z
220 |Q1|1.2|3.4|1.3
221 |Q2|4.5|3.4|2.3
222 |Q3|1.2|4.5|9.0
223 |Q4|3.4|1.2|1.2
224 {{/chart}}
225
226 {{/code}}
Ecaterina Moraru (Valica) 10.6 227 )))
228 )))
229
Ecaterina Moraru (Valica) 15.2 230 (% class="row" %)
231 (((
232 (% class="col-xs-12 col-sm-4" %)
233 (((
234 === Macro: Content ===
235
Ecaterina Moraru (Valica) 15.3 236 * [[URL>>doc:extensions:Extension.Content Macro]]
Ecaterina Moraru (Valica) 15.7 237 * Good Default
238 * Select control for ##syntax## param
Ecaterina Moraru (Valica) 15.2 239 )))
240
241 (% class="col-xs-12 col-sm-4" %)
242 (((
243 [[image:attach:content_before.png]]
244 )))
245
246 (% class="col-xs-12 col-sm-4" %)
247 (((
248 [[image:attach:content_after.png]]
249 )))
250 )))
251
Ecaterina Moraru (Valica) 17.2 252 (% class="row" %)
253 (((
254 (% class="col-xs-12 col-sm-4" %)
255 (((
Ecaterina Moraru (Valica) 19.7 256 === Macro: Display, Include ===
Ecaterina Moraru (Valica) 17.2 257
Ecaterina Moraru (Valica) 19.2 258 * [[URL Display>>doc:extensions:Extension.Display Macro]]
259 * [[URL Include>>doc:extensions:Extension.Include Macro]]
Ecaterina Moraru (Valica) 19.7 260 * Auto-complete
Ecaterina Moraru (Valica) 17.2 261 )))
262
263 (% class="col-xs-12 col-sm-4" %)
264 (((
265 [[image:attach:display_before.png]]
266 )))
267
268 (% class="col-xs-12 col-sm-4" %)
269 (((
270 [[image:attach:display_after.png]]
271 )))
272 )))
273
Ecaterina Moraru (Valica) 19.7 274
275 (% class="row" %)
276 (((
277 (% class="col-xs-12 col-sm-4" %)
278 (((
279 === Macro: Office Document Viewer ===
280
281 * [[URL>>doc:extensions:Extension.Office Macro]]
282 * Auto-complete
283 )))
284
285 (% class="col-xs-12 col-sm-4" %)
286 (((
Ecaterina Moraru (Valica) 19.8 287 [[image:attach:office_before.png]]
Ecaterina Moraru (Valica) 19.7 288 )))
289
290 (% class="col-xs-12 col-sm-4" %)
291 (((
Ecaterina Moraru (Valica) 19.8 292 [[image:attach:office_after.png]]
Ecaterina Moraru (Valica) 19.7 293 )))
294 )))
295
Ecaterina Moraru (Valica) 23.6 296 === etc. ===
297
Ecaterina Moraru (Valica) 10.6 298 ----
299
Ecaterina Moraru (Valica) 2.10 300 (% class="row" %)
301 (((
302 (% class="col-xs-12 col-sm-4" %)
303 (((
304
Ecaterina Moraru (Valica) 1.2 305 )))
306
Ecaterina Moraru (Valica) 2.10 307 (% class="col-xs-12 col-sm-4" %)
308 (((
Ecaterina Moraru (Valica) 1.2 309
310 )))
311
Ecaterina Moraru (Valica) 2.10 312 (% class="col-xs-12 col-sm-4" %)
313 (((
314
Ecaterina Moraru (Valica) 1.2 315 )))
Ecaterina Moraru (Valica) 2.10 316 )))

Get Connected