summaryrefslogtreecommitdiff
path: root/www/wiki/skins/chameleon/docs/release-notes.md
blob: 27c174b90c5e24afa5d4157718cb49e35e22e747 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
## Release Notes

### Chameleon 1.7.1

Released on 10-May-2018

Fixes the reported version in Special:Version.

### Chameleon 1.7

Released on 29-Apr-2018

Changes:
* (#49) Allows skins that build on top of Chameleon to set a specific layout
  file without the need to manipulate the global config variables.
  ([Robert Vogel (HalloWelt)](https://github.com/osnard)
* (#60) Add PageToolsAdaptable, an adaptable NavbarHorizontal/PageTools
  component ([Tobias Oetterer](https://github.com/oetterer))

Fixes:
* Create a stacking context on the main content to avoid elements with `z-index`
  messing up the nav elements (e.g. being shown in front of a sticky navbar
  instead of going behind it)
* (#65) Fix z-index for Echo notifications
* Remove usage of functions deprecated in MediaWiki 1.31

### Chameleon 1.6

Released on 08-Oct-2017

Changes:
* Grid: Add `mode` attribute. This allows to switch the grid to fluid mode.
  ([Robert Vogel (HalloWelt)](https://github.com/osnard)
* Allow full qualified class names as component type. This allows to use custom
  components. ([Robert Vogel (HalloWelt)](https://github.com/osnard)
* Searchbar: Add 'buttons' attribute. This allows to hide one of the Searchbar
  buttons. Allowed values are `search`, `go` and `search go`.
* Initial integration of the Echo extension. Mostly styles fixes to avoid
  breaking the skin.
* Improve documentation

Fixes:
* (#2) Fix font size and z-index of Echo popup
* (#31) The Pencil button triggers "Edit with form" when
  `$wgPageFormsRenameEditTabs` of PageForms is set
* (#32) Sticky elements now appear on top of MW Indicators
* (#34) Some MediaWiki styles (mw-headline and mw-body) interfered with
  Bootstrap styles ([Dennis Groenewegen](https://github.com/D-Groenewegen))
* (#35) Subcomponents of NavbarHorizontal have dedicated classes now and use
  the central component factory now. This allows to us Modifications on them.

### Chameleon 1.5

Released on 23-Nov-2016

Changes:
* Move from WMF server to GitHub: Updates of documentation, some scripts,
  registration with [translatewiki](https://translatewiki.net)
* Improve documentation
* Replace [jquery-sticky](https://github.com/garand/sticky) by
  [sticky-kit](http://leafo.net/sticky-kit/)
* Use sticky for the navbar of the fixedhead layout
* NavbarHorizontal: Allow custom types and classes for Navbar elements
* PersonalTools: Add attribute *hideNewtalkNotifier*
* Standard layout: Use separate NewtalkNotifier and PersonalTools components
* Add schema description for layout files: [layout.rng](../layouts/layout.rng)
* Add validation script for layout files:<br>
  Call `php maintenance/validateLayout.php <layout.xml>`
* Add composer scripts: test, phpunit, build
* Add JS linting for better code quality

Fixes:
* Javascript modules were not loading in MW 1.28+
* Logo: Link to main page when *addLink* attribute is not present

### Chameleon 1.4

Released on 20-Sep-2016

Changes:
* Logo: add *addLink* attribute to Logo component

Fixes:
* Restore "Edit with form" link for Semantic Forms 3.5 and later
* Show dropdown menus of NavBar in front of maps (Maps extension)

### Chameleon 1.3

Released on 08-Mar-2016

Changes:
* Add URL parameter 'uselayout'
* Add attributes 'showTools' and 'showLanguages' for the NavMenu
* Add attributes 'hideTools' and 'hideLanguages' for the ToolbarHorizontal
* Add support for [Page status indicators]
  (https://www.mediawiki.org/wiki/Help:Page_status_indicators)

Fixes:
* Correctly follow symlinks
  ([Bug: T124714](https://phabricator.wikimedia.org/T124714))
* Provide correct box-sizing model and z-index for VisualEditor components
* Float the VisualEditor UI toolbar below a fixed or sticky navbar

### Chameleon 1.2

Released on 16-Jan-2016

This release may break customized styles for the NavbarHorizontal component.

Changes:
* Restructured the Page Tools on Navbars: The 'Edit' action and the Page Tools'
  menu button got icons and were offset from the rest of the menus.
* 'Edit' link links to the proper Visual Editor action if the
  [VE extension](https://www.mediawiki.org/wiki/VisualEditor) is present
* 'Edit' link links to the proper Semantic Forms action if the
  [SF extension](https://www.mediawiki.org/wiki/Extension:Semantic_Forms) is
  present and `$sfgRenameEditTabs` is set
* Improve styleability of tool buttons in NavbarHorizontal (wrap the button
  label in a span) and rework styling of the buttons
* Add ChameleonNavbarHorizontalPersonalToolsLinkText hook
* Add ChameleonNavbarHorizontalNewTalkLinkText hook
* New less style variables @toolbar-height, @toolbar-padding-vertical,
  @toolbar-padding-horizontal

Fixes:
* Use variable @hr-border for color of lower border of first heading
* Some style issues for VisualEditor
* The 'Page' link was not shown in Edit mode
* Some themes (e.g. spacelab, cerulian) overrode the toolbar padding when the
  mouse hovered over links

### Chameleon 1.1.4

Released on 27-May-2015

Fixes:
* Do not show mw-headline-anchor
* Fix Message icon linking to non-existent page
  ([Bug: T100550](https://phabricator.wikimedia.org/T100550))

### Chameleon 1.1.3

Released on 01-Mar-2015

Bump minimum Bootstrap extension version to 1.1

Fixes:
* Set @navbar-default-link-active-bg to @navbar-default-bg color
* Bullets for ULs respond to list-style:none again 
* Align personal tools drop-down with lower edge of navbar
* Let .tleft float left 
* Let jumped-to section heads appear below fixed/sticky header 
* Add mediawiki.sectionAnchor module (for compatibility with MW 1.25)
* Fix i18n for page tools link 

Other changes:
* Minor doc fixes
* Add integration test StylesCompileTest
* Restructure test file layout 

### Chameleon 1.1.2

Released on 19-Nov-2014

Fixes:
* Load shared.css with correct remote base path, so ref'd images are found
* Display lists in File namespace without bullets
* Set padding for td.mw-label and td.mw-input to have more space in between
* Enable mw-phpunit-runner.php when started from outside dir
* Use an
  [spdx-compliant license identifier](https://getcomposer.org/doc/04-schema.md#license)
  in composer.json
* Set padding of mw-ui-input and -button on Special:Search so they have the
  same height ([Bug: 73509](https://bugzilla.wikimedia.org/73509))
* Remove table positioning from personal tools.
  ([Bug: 73514](https://bugzilla.wikimedia.org/73514))

Other changes:
* Add [detailed installation instructions for Linux](installation-linux.md)
* Introduce relative file paths throughout the skin to enable installation in
  other directories then the standard .../skins. However it still expects some
  layout assumptions to be true.
* Reorganize directories
* Refactor several components and helper classes
* Refactor Menu package (+ add some testing)

### Chameleon 1.1.1

Released on 08-Nov-2014

Fixes:
* Fix styles for Special pages
  ([Bug: 72872](https://bugzilla.wikimedia.org/72872))
* Include dataAfterContent in bodyContent
  ([Bug: 72869](https://bugzilla.wikimedia.org/72869))

Other changes:
* Some refactoring of the MainContent component

### Chameleon 1.1

Released on 06-Nov-2014

New layouts:
* __clean__: This is a minimalist layout intended for wikis that are not open
  for general editing. A use case might be a blogging platform. For users, that
  do not have edit rights, the layout will show only the main content of a wiki
  page (and the site notice, if set). For users that do have edit rights it will
  additionally show a sticky full-width navbar above, and a toolbar and an info
  footer below the main content.

New components and modifications:
* __Silent__: Does nothing. Mainly intended for internal purposes, but may also
  be used in custom layouts, e.g. as a placeholder during layout development
* __HideFor__: Modification that allows to hide the parent component if the
  condition specified by the attributes is fulfilled.
  See its [description](Components/Modifications/HideFor.md)
* __ShowOnlyFor__: Modification that allows to show the parent
  component only if the condition specified by the attributes is fulfilled.
  See its [description](Components/Modifications/ShowOnlyFor.md)

Other changes:
* Update CI test setup
* Update localisation
* Update documentation

Known issues:
* This version will identify as 1.1-alpha on Special:Version

### Chameleon 1.0.1

Released on 22-Oct-2014

Fixes:
* Fix TOC layout

Other changes:
* Add basic testing for Menu component (and fix a small bug)
* Update documentation

### Chameleon 1.0

Released on 19-Oct-2014

After nearly 1.5 years in development status, this is the first official version
of the Chameleon skin for MediaWiki.

It contains the following layouts:
* __standard__ features a big logo, a horizontal nav bar containing the
  sidebar navigation links to Main Page, Recent changes, etc. The personal tools
  (user page, preferences, etc.) and the page tools (discussion, edit, history)
  are kept as textual links above and below the nav bar. Same goes for the
  search bar, it is kept above the nav bar on the right side of the page.
* __navhead__ integrates the (now smaller) logo, page tools, personal tools,
  and the search bar in the nav bar, leading to a more content oriented look.
* __fixedhead__ takes the nav bar out of the content grid and puts it at the
  top of the page over the full width of the browser window. The nav bar stays
  fixed at its position when the page is scrolled.
* __stickyhead__ is similar to fixedhead, only it has a secondary menu bar on
  top of the main nav bar. When the page is scrolled, the secondary menu will
  scroll with the page, while the main menu will scroll only up to the upper
  window border and then stay there.

This version contains the following components:
* Cell
* Container
* FooterIcons
* FooterInfo
* FooterPlaces
* Grid
* Html
* Logo
* MainContent
* Menu
* NavbarHorizontal
* NavMenu
* NewtalkNotifier
* PageTools
* PersonalTools
* Row
* SearchBar
* SiteNotice
* Structure
* ToolbarHorizontal

Known Issues:
* The available documentation is insufficient. For now, if you have questions,
  just [ask](contact.md).
* Many of the lesser used page elements are not properly styled yet.

Compatibility:
* Tests have been run against MediaWiki 1.22 and 1.25