/
readme.txt
351 lines (296 loc) · 16.9 KB
/
readme.txt
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
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
==== Readme.txt for Shades Theme ====
=== Contents ===
* FAQ
* Changelog
* Notes
* Review Tickets
=== FAQ ===
Q: Why did my theme stop working in older browsers?
A: I chose to move to more consistent current browser only support (with an expected minimum IE9+ as the benchmark as of the end of 2013). Older browsers should be updated or replaced.
Q: How do you suggest I use the Aside, Quote, and Status post formats?
A: The Aside post format will display with an exclamation mark (!) on its left side. The Quote post format will have a a double-quote ("). The Status post format will use an amphere (at sign). These post format will also have their titles and postmeta data right aligned as well. This will set these posts apart from standard posts and other post formats not currently supported.
I would suggest using the Aside post format for ideas and topics that do not necessarily follow the general flow of your main content; the Quote post format usage would be ideal for quotations; and the Status post format could easily follow a very similar idea to tweets or wall posts. Also note, Status posts will show the date and _time_ the post was published; and if the Status post is modified it will also show that date and time in addition to the original published post and time.
Q: Can I change the symbols used for the post formats?
A: Yes. The symbols are generated by their related function. If you wish to use a different glyph I would recommend creating a Child-Theme and writing an appropriate function to be used in place of the functions being used in the theme. If you need help creating a Child-Theme this article may help: http://wpfirstaid.com/2011/04/wordpress-child-themes/.
Q: How do I link to the single view of posts without a title?
A: The Shades theme (as of version 1.7) has the function `shades_use_posted`. This will use the 'Posted' text of the postmeta data as the anchor text for the link to the single view of a post without a title. This function can also be over-written in Child-Themes if necessary.
Q: Why does `the_shortcode` functionality appear to not work?
A: See core trac ticket: http://core.trac.wordpress.org/ticket/18632
If you are using the default permalink structure; or if you do not have the 'JetPack' plugin, or 'WordPress Stats' (included with JetPack) plugin, installed you may experience problems with `the_shortcode` not behaving as expected.
=== Changelog ===
* Changelog as of June 7, 2015
== 2.4.1 ==
= Code =
* Added "theme_support" for the `title` tag
* Added `shades_loop` function for DRY reasons
* Adjusted output to move arrow symbols outside of i18n implementation
* Created `shades_get_the_author_posts_link` to return the URL link instead of echoing it
* Improved i18n implementations
* Minor code formatting changes
* Minor corrections to i18n implementation
* Moved `$content_width` setting into `shades_setup` function
* Moved the `post-comments` message to below other post meta
* Removed Bookmarks from default sidebar content
= CSS =
* Adjusted the `post-comments` class font size to be slightly larger
= Miscellaneous =
* Added default `shades.po` and English (Canada) translation files
* Moved `changelog.txt` into `readme.txt`
* Updated copyright years
/** ------------------------------------------------------------------------- */
== 2.3 ==
= Code =
* Added filter to allow supported post-formats to be easily extended
* Added function wrapper for widget area registration and hooked it into `widgets_init` action
* Added BNS Login support for dashicons
* Changed `shades-<post-format>.php` templates to `content-<post-format>.php`
* Fixed standard content not displaying post categories
* Removed unused parameter from `shades_wp_title`
* Use consistent code constructs in `shades_theme_version`
= CSS =
* Changed from YUI Reset to normalize.css version 3.0.2
= Miscellaneous =
* Added `Text Domain` to `style.css` header block
* Updated the theme description
/** ------------------------------------------------------------------------- */
== 2.2.1.1 ==
= Code =
* Additional code formatting
* Improve `shades_dynamic_copyright` performance impact by adding transient with one month refresh
= CSS =
* Corrected minor typos
* Updated default Calendar Widget styles
* Updated default Search Widget styles
* Updated `post-password-form` styles
= Miscellaneous =
* Fixed `@internal` link reference to the WordPress Theme repository
* Update copyright years
* Updated `screenshot.png` to current 880x660 standard
/** ------------------------------------------------------------------------- */
== 2.2 ==
= Code =
* Code reformatting to better reflect WordPress Coding Standards (see https://gist.github.com/Cais/8023722)
* Removed default `Search` from sidebar
= CSS =
* Clean up `border-radius` property usages
* Removed the `zoom: 1` property usage
* Removed rule over-writing themselves in elements
* Moved to more complete current browser only support (expect minimum IE9+)
= Miscellaneous
* i18n update for `Permalink to: ` phrases
* Added to `readme.txt` - Q: Why did my theme stop working in older browsers?
/** ------------------------------------------------------------------------- */
== 2.1.1 ==
= Code =
* Added `SHADES_HOME_URL` constant in place of the hardcoded domain URL
* Added `shades_show_featured_image( $size )` for DRY purposes
* Fixed featured image being used in post overflowing content area
* Re-Added Theme Version output for Parent-Theme usage
= CSS =
* Adjusted `img` and `caption` properties
/** ------------------------------------------------------------------------- */
== 2.1 ==
= Code =
* Added 'search.php' template file
* Refactored code formatting and code block termination comments
* Refactored post meta to be more i18n compatible
= CSS =
* Added additional styles for default widgets
= Miscellaneous =
* Change 'style.css' header texts to reflect core trac ticket #16868
/** ------------------------------------------------------------------------- */
== Version 2.0 ==
= CODE =
* Change conditional to show "Threaded Comments" if they are open of closed.
* Refactored conditional checks for "author credits with copyright details"
* Removed deprecated call to `get_theme_data`
= CSS =
* Added classes to inline glyph span styles and moved to style.css
* Added 'editor-style.css' file
= Miscellaneous =
* General code clean-up (typos, etc.)
/** ------------------------------------------------------------------------- */
== Version 1.9 ==
= CODE =
* Added 'image.php' template
* Added "custom background" support
* Enqueue threaded comments script in 'functions.php'
* Update usage of `wp_title`
= Miscellaneous =
* With the addition of the custom background support, the theme now requires WordPress 3.4 to work correctly
/** ------------------------------------------------------------------------- */
== Version 1.8 ==
= CODE =
* Added doc blocks and improved overall code quality and structure
* Added link to modified author's post archive
* Added conditionals to only show website URL (with email) if the address is found in the user profile; and only show biography if it exists on 'author.php' output
* Addressed call to deprecated function `get_userdatabylogin`
* Addressed calls to deprecated function `get_theme_data`
* Addressed call to deprecated function `add_custom_background`
* Renamed `bns_dynamic_copyright` to `shades_dynamic_copyright`
* Renamed `bns_theme_version` to `shades_theme_version`
* Replaced navigation with call to `get_template_part( 'shades-navigation' )`
* Replaced output if no posts are returned by the_Loop with a call to get_template_part( 'shades-no-posts' )
= CSS =
* Added "commenter classes" as defined in 'author.php'
* Added 'no-title' class to post classes if `get_the_title` is empty
* Added 'widget_tag_cloud' element
* Adjusted 'sticky' post related styles
* Adjusted `gallery` `max-width` for better aesthetics
= Miscellaneous =
* Adoption of a 'markdown' / 'phpdoc' style in the changelog (this file)
* Added Review Ticket section to 'readme.txt'
/** ------------------------------------------------------------------------- */
=== Version 1.7 ===
== Public ==
* released September 11, 2011
* published September 13, 2011
== CODE Changes ==
* added support for post formats: aside, quote, status
* added the `shades` loop template
* added theme page for support and a contextual-help readme
* NB: adding the loop template and support for post formats affected the following template files: archive, author, index, page, single
* added `shades_used_posted` function to provide a link to the single view of posts without titles
* updated `BNS_Dynamic_Copyright` function
* updated `BNS_Theme_Version` function
* updated WordPress Required Version to 3.1 to implement post-formats (NB: Theme may still function correctly down to version 3.0)
* removed featured image thumbnail from the single view
* removed direct IE6 support
* removed `show_avatar` function
* removed `shades_page_number` function
== CSS Changes ==
* reduced vertical distance between posts by half
* modified style for tag elements; add bottom-right border to help define the post they are attached to
* set base font-size to 100%; updated most other font-sizes to use percentages creating an over-all easier to read text
* addressed image thumbnail sizes used by gallery shortcode to handle up to 10 columns
* changed 'widgettitle' to 'widget-title' (NB: not currently used by the theme)
== CODE & CSS Changes ==
* updated menu code to better handle parent-child-grandchild etc. structures (NB: menu is no longer centered.)
* moved the "Comments" to be inline with the post title and made minor style changes
* changed #main-blog to #the-loop for more code clarity
--------------------------------------------------------------------------------
==== Older Changelog Details ====
-- Version 1.6
- released: Sept 13, 2010
- added license slug and URI to style.css header block
- added unique prefix to themes functions where appropriate
- added full wp_nav_menu support
- added additional WordPress 3.0 core functionality features i.e.: post thumbnails
- added full drop-down menu functionality with credits to http://matthewjamestaylor.com/blog/centered-dropdown-menus
- added 'the_shortlink()' based on this post: http://wpfirstaid.com/2010/07/add-the_shortlink/
- additional code clean-up
- CSS: adjusted background and font size on allowed tags for comments
- CSS: minor clean up
-- Version 1.5.1
- released: June 19, 2010
- published on WordPress.org: June 22, 2010
- corrections to sidebar.php to remove "second" id=searchform
- WP: changed `the_time( 'M j, Y' )` to `the_time( get_option( 'date_format' ) );`
-- Version 1.5
- released: June 15, 2010
- cleaned up code in functions.php
- clean up code to meet WP Standards
- WP: updated comments.php to use comment_form() function; old comment form will be removed with next theme revision (post WordPress v3.0)
-- Version 1.4
- released: Apr 24, 2010
- published on WordPress.org: Apr 28, 2010
- Shades of Darkness child theme is no longer included
- add revision details to each file
- updated shades_dynamic_copyright() function
- add class and ID to function widget definition
- added WordPress version 3.0 Navigation Menu core widget style elements
- additional modifications to meet current guidelines as found at: http://codex.wordpress.org/Theme_Development_Checklist.
-- Version 1.3.3
- WP: added "GPL2" license statement to style.css
- WP: added 'posted' to page author by-line, now reads 'posted by'
- WP: added shades_dynamic_copyright() to functions.php; replaced 'copyright' code in footer.php
- WP: added shades_theme_version() to functions.php; replaced 'version' code in footer.php
- WP: moved wp_footer into its own 'div'
- CSS: removed most empty elements
- NB: Shades of Darkness will no longer be included with Shades to reduce theme size after version 1.3.3
- NB: Shades of Darkness will be available to download at http://buynowshop.com/themes/shades
-- Version 1.3.2
- added clearing div to end of the_Loop display
-- Version 1.3.1
- WP: added body_class() function
- WP: added author link to page.php
- CSS: added author related elements and properties
- CSS: add '.page p' class
- CSS: added 'blockquote p' element
- CSS: general consolidations and/or removal of duplicate elements
-- Version 1.3
- CSS (new): added "YUI Reset"
- CSS (new): added '.page ol', '.page ul', and '.page li'
- CSS (edit): removed #author 'width' property
- CSS (edit): removed #comments-main 'width' property
- CSS (edit): removed #comments-main code 'width' property
- added comments to the page.php template file
- added support for posts that have multiple pages
- pt_BR language files added - thanks to Habner Costa habnertc@msn.com
-- Version 1.2
- Added Threaded Comments and related CSS elements and properties
- Added support for Sticky Posts - see changes in template files (archive, author, index) -> post="class" to post_class();
- Cleanup code for better readability
- Separated "navigation" links at end of page(s)
- CSS (new): added navigation class
- CSS (new): added sticky class element with example properties
-- Version 1.1.1
- CSS (edit): .widget h2 -> removed 'padding: 22px 0 0;'
- CSS (edit): .widget -> removed 'margin-top:10px;' and 'margin-bottom:20px;'
- re-coded footer.php to correct for issues with fopen() errors
-- Version 1.1
- update search box; added simple scripting
- added "Edit" link to page.php template
- re-coded searchform.php
- edited sidebar.php to use new searchform.php
- CSS (edit): input:focus, textarea:focus -> changed 'padding-bottom: 30px' to 'padding: 1px 0;'
- CSS (new): input#s { width: 70%; }
- CSS (new): .textwidget form {text-align:center;}
- CSS (new): added BNS Plugins section at end of style.css
* child theme Shades of Darkness updated to version 1.0.1
NB: As of version 1.1 the following deprecated files have been removed from the theme core files:
* home.php
* header-home.php
-- Version 1.0.4.1
- name correction - removed "(by BNS)"
-- Version 1.0.4
- added child theme Shades of Darkness in folder "shades-of-darkness"
- added "child-theme-readme.txt" to help with installation
- CSS: Added "WordPress" rules for images and alignments
-- Version 1.0.3.2
- remove mysterious "new line characters from theme files"
-- Version 1.0.3.1
- NB: Removing a core file from a theme will not be reflected within an automatic update of the theme, which is logically correct.
-- The contents of the index.php file have been used to overwrite the contents of the home.php file.
-- The contents of the header.php file have been used to overwrite the contents of the header-home.php file.
-- revision is only to correct this oversight.
-- Version 1.0.3
- deprecated the header-home.php and home.php files by adding a tilde (~) character to the beginning of the file name. The functionalty was merged into the index.php file with additonal PHP code, specifically an IF statement to test for the displayed page being the "home page", or the "front page". This will reduce maintenance and potential errors that cropped up due to the extra files.
-- copies of header-come.php and home.php from version 1.0.2 are still included but will be removed in 1.0.4
- re-coded footer to programtically write the theme name in the credit line, including recognition of child themes.
- added additional internationalization code
- CSS: minor adjustment to ".search-submit" for alignment purposes
- CSS: changed "pre" element's "width:570px;" to "width:auto;"
- CSS: added "overflow:hidden" to #bottom
- CSS: removed 1px border from ".post code" elements to improve readability
- CSS: add "clear: both" to .wp-caption to address larger images in posts
-- Version 1.0.2
- added internationalization (I18n) code as specified at this page: http://codex.wordpress.org/I18n_for_WordPress_Developers
- changed `ul id="menu"...` to `div class="menu"...`; added height, margin, and padding elements to the menu class
- changed sidebar text alignment to left (from center); and, corrected screenshot image.
-- Version 1.0.1
*** first approved version ***
- corrected menu over-run on long page names
-- Version 1.0 -> Initial release
=== Notes ===
* The Shades Theme (as well as all future theme releases) will no longer directly support older browsers. Please use the most current stable version of your browser of choice.
=== Review Tickets ===
* http://themes.trac.wordpress.org/ticket/5224 - v1.7 - September 11, 2011
* http://themes.trac.wordpress.org/ticket/7479 - v1.8 - April 20, 2012
* http://themes.trac.wordpress.org/ticket/8503 - v1.9 - July 5, 2012
* http://themes.trac.wordpress.org/ticket/10265 - v2.0 - December 7, 2012
* http://themes.trac.wordpress.org/ticket/11587 - v2.1 - March 8, 2013
* http://themes.trac.wordpress.org/ticket/13451 - v2.1.1 - July 18, 2013
* http://themes.trac.wordpress.org/ticket/15896 - v2.2 - December 28, 2013
* https://themes.trac.wordpress.org/ticket/19030 - v2.2.1 - June 1, 2014
* https://themes.trac.wordpress.org/ticket/21997 - v2.3 - December 2014