forked from billerickson/display-posts-shortcode
/
readme.txt
150 lines (100 loc) · 5.57 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
=== Display Posts Shortcode ===
Contributors: billerickson
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=MQKRBRFVRUV8C
Tags: shortcode, pages, posts, page, query, display, list
Requires at least: 3.0
Tested up to: 4.5.2
Stable tag: 2.7.0
Display a listing of posts using the [display-posts] shortcode
== Description ==
The *Display Posts Shortcode* was written to allow users to easily display listings of posts without knowing PHP or editing template files.
Add the shortcode in a post or page, and use the arguments to query based on tag, category, post type, and many other possibilities. You can also customize the output with parameters like: include_date, include_excerpt, and image_size.
* [Available Parameters](https://github.com/billerickson/display-posts-shortcode/blob/master/README.md#parameters)
* [Customization with Filters](https://github.com/billerickson/display-posts-shortcode/wiki#customization-with-filters)
* [Extension Plugins](https://github.com/billerickson/display-posts-shortcode/wiki#extension-plugins)
* [Full Change Log](https://github.com/billerickson/display-posts-shortcode/blob/master/CHANGELOG.md)
* [View on GitHub](https://github.com/billerickson/display-posts-shortcode)
== Installation ==
1. Upload `display-posts-shortcode` to the `/wp-content/plugins/` directory.
1. Activate the plugin through the *Plugins* menu in WordPress.
1. Add the shortcode to a post or page.
== Changelog ==
**Version 2.7.0**
* Added support for [Co-Authors Plus Addon](https://github.com/billerickson/dps-coauthor-addon).
* Added parameter to exclude children terms in tax queries, [more information](https://github.com/billerickson/display-posts-shortcode/issues/120)
* Added a filter to display the full version of manual excerpt, regardless of excerpt_length. [more information](https://github.com/billerickson/display-posts-shortcode/issues/123)
* Removed shortcodes from custom excerpts, [more information](https://github.com/billerickson/display-posts-shortcode/issues/113)
* Fixed private post visibility, [more information](https://github.com/billerickson/display-posts-shortcode/issues/115)
**Version 2.6.2**
* More improvements to excerpts, see #110
* Added content_class parameter
* Fix date query bug, see #108
* Fixed undefined variable notice if include_title="false"
**Version 2.6.1**
* Fix issue with manually specified excerpts
**Version 2.6**
* Add support for author="current"
* Add support for multiple wrapper classes
* Add support for excerpt_length parameter
* Add support for excerpt_more parameter
**Version 2.5.1**
* Fix an issue with manually specified excerpts
**Version 2.5**
* Add support for date queries
* Exclude child pages with post_parent="0"
* Query by current taxonomy terms. Ex: [display-posts taxonomy="category" tax_term="current"]
* Display the post's categories with [display-posts category_display="true"]
* Many more fixes. See GitHub for a full list of changes.
**Version 2.4**
* Add 'include_author' parameter
* Add 'exclude_current' parameter for excluding the current post from the results
* If you display the full content of results, additional uses of the shortcode within those posts are now turned off
* Other minor improvements
**Version 2.3**
* Include the shortcode attributes on wrapper filter
* Add 'no_posts_message' parameter to specify content displayed if no posts found
* Add filters to the title and permalink
* Limit private posts to logged in users
* Add support for excluding sticky posts
* Add support for ordering by meta_key
**Version 2.2**
* Use original attributes for filters
* Add support for multiple taxonomy queries
* Add filter for post classes
* Add support for post content in the post loop
**Version 2.1**
* Add support for post status
* Add support for post author
* Add support for post offset
**Version 2.0**
* Explicitly declare arguments, props danielbachhuber
* Sanitize each shortcode attribute for security, props danielbachhuber
**Version 1.9**
* Add 'date_format' parameter, so you can customize how dates are displayed
* Added a class of .excerpt-dash so CSS can be used to remove the dash
* Cleaned up the codebase according to WordPress coding standards
**Version 1.8**
* Added `display_posts_shortcode_no_results` filter for displaying content if there's no posts matching current query.
* Add support for multiple post types. [display-posts post_type="page, post"]
**Version 1.7**
* Added `id` argument to specify specific post IDs
* Added `display_posts_shortcode_args` filter in case the arguments you want aren't already included in the shortcode. See example: http://www.billerickson.net/code/display-posts-shortcode-exclude-posts/
**Version 1.6**
* Added `post_parent` where you can specify a parent by ID, or you can say `post_parent=current` and it will use the current page's ID.
* Added `wrapper` where you can decide if the posts are an unordered list, ordered list, or div's
* Added support for multiple taxonomy terms (comma separated) and taxonomy operator (IN, NOT IN, or AND).
**Version 1.5**
* For the sake of clarity I'm changing version numbers. No feature changes
**Version 0.1.5**
* Added a filter (display_posts_shortcode_output) so you can modify the output of individual posts however you like.
**Version 0.1.4**
* Added post_type, taxonomy, tax_term, and include_excerpt
* Added classes to each part of the listing (image, title, date, excerpt) to make it easier to change the look using CSS
**Version 0.1.3**
* Updated Readme
**Version 0.1.2**
* Added image_size option
**Version 0.1.1**
* Fix spacing issue in plugin
**Version 0.1**
* This is version 0.1. Everything's new!