Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 287 lines (194 sloc) 14.382 kb
a265695 Adding version 0.1 of the plugin
fernandobt authored
1 === List category posts ===
2 Contributors: fernandobt
e15430a Lots of small fixes
fernandobt authored
3 Donate Link: http://picandocodigo.net/programacion/wordpress/list-category-posts-wordpress-plugin-english/#support
a265695 Adding version 0.1 of the plugin
fernandobt authored
4 Tags: list, categories, posts, cms
cbf53f7 Working on widget
fernandobt authored
5 Requires at least: 2.8
1260e89 Short fix release
fernandobt authored
6 Tested up to: 3.1
e15430a Lots of small fixes
fernandobt authored
7 Stable tag: 0.18.3
a265695 Adding version 0.1 of the plugin
fernandobt authored
8
9 == Description ==
e15430a Lots of small fixes
fernandobt authored
10 List Category Posts allows you to list posts from a category into a post/page using the [catlist] shortcode.
11
12 The shortcode accepts a category name or id, the order in which you want the posts to display, and the number of posts to display. You can also display the post author, date, excerpt, custom field values, even the content! The [catlist] shortcode can be used as many times as needed with different arguments on each post/page.
cbf53f7 Working on widget
fernandobt authored
13
7dc0ab5 Added comment count and updated readme file
fernandobt authored
14 Great to use WordPress as a CMS, and create pages with several categories posts.
15
16 The plugin includes a widget, which works pretty much the same as the plugin. Just add as many widgets as you want, and select all the available options from the Appearence > Widgets page.
cbf53f7 Working on widget
fernandobt authored
17
e15430a Lots of small fixes
fernandobt authored
18 Works correctly with WordPress 3.1 and default Twenty Ten theme
19 (http://wordpress.org/support/topic/399754)
a265695 Adding version 0.1 of the plugin
fernandobt authored
20
e15430a Lots of small fixes
fernandobt authored
21 **Usage**: `[catlist argument1=value1 argument2=value2]`
9db0f21 Ready to merge into trunk, if SVN allows me to...
fernandobt authored
22
e15430a Lots of small fixes
fernandobt authored
23 **Tell us how you use this plugin!**
cee8772 Version 0.14 coming up
fernandobt authored
24 http://foro.picandocodigo.net/discussion/261/do-you-like-list-category-posts-read-me
cbf53f7 Working on widget
fernandobt authored
25
e15430a Lots of small fixes
fernandobt authored
26 **Support the plugin**
27 If you've found the plugin useful, consider making a [donation via PayPal](http://picandocodigo.net/programacion/wordpress/list-category-posts-wordpress-plugin-english/ "Donate via PayPal") or visit my [Amazon Wishlist](http://www.amazon.com/gp/registry/wishlist/2HU1JYOF7DX5Q/ref=wl_web "Amazon Wishlist").
28
29
92b5732 Fixed readme for wordpress.org
fernandobt authored
30 ==Installation==
31
32 * Upload listcat directory into you wp-content/plugins/ directory.
33 * Login to your WordPress Admin menu, go to Plugins, and activate it.
41e9c9d Version 0.7 ready for tag
fernandobt authored
34 * Edit the default.php file on templates to customize the way the categories are displayed, or use the default one included in the plugin's code. You can use several different templates if you want.
cbf53f7 Working on widget
fernandobt authored
35 * You can find the ListCategoryPostsWidget in the Appearence > Widgets section on your WordPress Dashboard.
92b5732 Fixed readme for wordpress.org
fernandobt authored
36
37 ==Other notes==
38
39 **Usage**
169688f Implemented shortcode arguments
fernandobt authored
40 The arguments you can use are:
2bfff68 Added new version 0.4, with lots of changes including WP 2.7 testing.
fernandobt authored
41
d71f9ed Added stuff to 0.6
fernandobt authored
42 * **name** - To display posts from a category using the category's name. Ex: [catlist name=mycategory]
2bfff68 Added new version 0.4, with lots of changes including WP 2.7 testing.
fernandobt authored
43
d71f9ed Added stuff to 0.6
fernandobt authored
44 * **id** - To display posts from a category using the category's id. Ex: [catlist id=24]. You can **include several categories**: Ex: [catlist id=17,24,32] or **exclude** a category with the minus (-)
45 If you use both arguments (wrong!), List Category Posts will show the posts from the category in 'name'.
2bfff68 Added new version 0.4, with lots of changes including WP 2.7 testing.
fernandobt authored
46
cee8772 Version 0.14 coming up
fernandobt authored
47 * **tags** - Tag support, you can display posts from a certain tag.
2c2718c Version 0.9 ready
fernandobt authored
48
d71f9ed Added stuff to 0.6
fernandobt authored
49 * **orderby** - To customize the order. Valid values are:
50 * **author** - Sort by the numeric author IDs.
51 * **category** - Sort by the numeric category IDs.
52 * **content** - Sort by content.
53 * **date** - Sort by creation date.
54 * **ID** - Sort by numeric post ID.
55 * **menu_order** - Sort by the menu order. Only useful with pages.
56 * **mime_type** - Sort by MIME type. Only useful with attachments.
57 * **modified** - Sort by last modified date.
58 * **name** - Sort by stub.
59 * **parent** - Sort by parent ID.
60 * **password** - Sort by password.
61 * **rand** - Randomly sort results.
62 * **status** - Sort by status.
63 * **title** - Sort by title.
64 * **type** - Sort by type. Ex: [catlist name=mycategory orderby=date]
2c2718c Version 0.9 ready
fernandobt authored
65
66 * **order** - How to sort **orderby**. Valid values are:
d71f9ed Added stuff to 0.6
fernandobt authored
67 * **ASC** - Ascending (lowest to highest).
68 * **DESC** - Descending (highest to lowest). Ex: [catlist name=mycategory orderby=title order=asc]
2bfff68 Added new version 0.4, with lots of changes including WP 2.7 testing.
fernandobt authored
69
d71f9ed Added stuff to 0.6
fernandobt authored
70 * **numberposts** - Number of posts to return. Set to 0 to use the max number of posts per page. Set to -1 to remove the limit. Default: 5. Ex: [catlist name=mycategory numberposts=10]
2bfff68 Added new version 0.4, with lots of changes including WP 2.7 testing.
fernandobt authored
71
d71f9ed Added stuff to 0.6
fernandobt authored
72 * **date** - Display post's date next to the title. Default is 'no', use date=yes to activate it.
2bfff68 Added new version 0.4, with lots of changes including WP 2.7 testing.
fernandobt authored
73
d71f9ed Added stuff to 0.6
fernandobt authored
74 * **author** - Display the post's author next to the title. Default is 'no', use author=yes to activate it.
169688f Implemented shortcode arguments
fernandobt authored
75
ca78e21 Committing changes on 0.13
fernandobt authored
76 * **dateformat** - Format of the date output. Default is get_option('date_format'). Check http://codex.wordpress.org/Formatting_Date_and_Time for possible formats.
66bac8d added excerpt, template and dateformat
fernandobt authored
77
9db0f21 Ready to merge into trunk, if SVN allows me to...
fernandobt authored
78 * **template** - File name of template from templates directory without extension. Example: For 'template.php' value is only 'template'. Default is 'default', which displays an unordered list (ul html tag) with a CSS class. This class can be passed as a parameter or by default it's: 'lcp_catlist'. You can also use the default 'div' value. This will output a div with the 'lcp_catlist' CSS class (or one you pass as parameter with the class argument). The inner items (posts) will be displayed between p tags.
66bac8d added excerpt, template and dateformat
fernandobt authored
79
d71f9ed Added stuff to 0.6
fernandobt authored
80 * **excerpt** - Display the post's excerpt. Default is 'no', use excerpt=yes to activate it.
169688f Implemented shortcode arguments
fernandobt authored
81
776c428 Working on version 0.7. New parameters.
fernandobt authored
82 * **excludeposts** - IDs of posts to exclude from the list. Ex: [catlist excludeposts=12,52,37]
83
84 * **offset** - You can displace or pass over one or more initial posts which would normally be collected by your query through the use of the offset parameter.
85
86 * **content** - Show the full content of the post. Default is 'no'. Ex: [catlist content=yes]
87
661abcf Added branch for OOP version
fernandobt authored
88 * **catlink** - Show the title of the category with a link to the category. Use the template system to customize its display using the variable $cat_link_string. Default is 'no'. Ex: [catlist catlink=yes]. The way it's programmed, it should only display the title for the first category you chose, and include the posts from all of the categories. I thought of this parameter mostly for using several shortcodes on one page or post, so that each group of posts would have the title of that group's category. If you need to display several titles with posts, you should use one [catlist] shortcode for each category you want to display.
776c428 Working on version 0.7. New parameters.
fernandobt authored
89
7dc0ab5 Added comment count and updated readme file
fernandobt authored
90 * **comments** - Show comments count for each post. Default is 'no'. Ex: [catlist comments=yes].
2bfff68 Added new version 0.4, with lots of changes including WP 2.7 testing.
fernandobt authored
91
17c5eee Some changes on thumbnail
fernandobt authored
92 * **thumbnail** - Show post thumbnail (http://markjaquith.wordpress.com/2009/12/23/new-in-wordpress-2-9-post-thumbnail-images/). Default is 'no'. Ex: [catlist thumbnail=yes].
ca78e21 Committing changes on 0.13
fernandobt authored
93
cee8772 Version 0.14 coming up
fernandobt authored
94 * **post_type** - The type of post to show. Available options are: post - Default, page, attachment, any - all post types.
95
96 * **post_parent** - Show only the children of the post with this ID. Default: None.
97
98 * **class** - CSS class for the default UL generated by the plugin.
99
3b9f809 Ok, version 0.16 ready to go...
fernandobt authored
100 * **custom fields** - To use custom fields, you must specify two values: customfield_name and customfield_value. Using this only show posts that contain a custom field with this name and value. Both parameters must be defined, or neither will work.
101
102 * **customfield_display** - Display custom field(s). You can specify many fields to show, separating them with a coma.
47d05b1 Added custom fields support
fernandobt authored
103
104
e15430a Lots of small fixes
fernandobt authored
105 Your comments and feedback are welcome at:
106 http://foro.picandocodigo.net/categories/list-category-posts
a265695 Adding version 0.1 of the plugin
fernandobt authored
107
7dc0ab5 Added comment count and updated readme file
fernandobt authored
108 **New Code is welcome too** :D
03b2312 Tagging version 0.5
fernandobt authored
109
66bac8d added excerpt, template and dateformat
fernandobt authored
110 == Frequently Asked Questions ==
cee8772 Version 0.14 coming up
fernandobt authored
111 * **Instructions** on how to use the plugin: http://foro.picandocodigo.net/discussion/251/list-category-posts-documentation/
112 * **Template system** how to customize the way the posts are shown: http://foro.picandocodigo.net/discussion/253/list-category-posts-using-templates/
3b9f809 Ok, version 0.16 ready to go...
fernandobt authored
113 * **New feature requests** - Contact me on fernando at picandocodigo dot net or check out the forum.
05f1f6e Committing some stuff and to-do's to checkout tomorrow...
fernandobt authored
114 * **Support** I've decided to use WordPress Answers (http://meta.wordpress.stackexchange.com/) as the place for support. It's a great place with a large community of WordPress users and developers. Just ask your question with the tag 'plugin-list-category-post'.
66bac8d added excerpt, template and dateformat
fernandobt authored
115
6082325 Improved template system, general small fixes
fernandobt authored
116 * **FAQ**
117
118 Plugin could not be activated because it triggered a fatal error.
119 Parse error: syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or '}' in /.../wp-content/plugins/list-category-posts/include/CatListDisplayer.php on line 10
120
121 Please check:
122 http://wordpress.stackexchange.com/questions/9338/list-category-posts-plugin-upgrade-fails-fatal-error/9340#9340
123
0e2d75a Fixed category link, changed template system
fernandobt authored
124 == Upgrade Notice ==
125
6082325 Improved template system, general small fixes
fernandobt authored
126 = 0.18 =
127 Template system was upgraded with new options. Backwards compatible, but you can better customize the way the post contents are displayed. Check templates/default.php.
128
9db0f21 Ready to merge into trunk, if SVN allows me to...
fernandobt authored
129 = 0.17 =
130 Upgrade your templates: Templates system was rewritten, so your current templates will probably not work. Check out the new default.php file on /templates to see the simpler new way to work with templates.
131
17c5eee Some changes on thumbnail
fernandobt authored
132 = 0.13.2 =
133 Thumbnail parameter 'thumbnails' changed to 'thumbnail.
134
0e2d75a Fixed category link, changed template system
fernandobt authored
135 = 0.7.2 =
8eb70d0 Modified readme
fernandobt authored
136 Template system has changed. Now the posts loop must be defined inside the template. Check templates/default.php for an example.
0e2d75a Fixed category link, changed template system
fernandobt authored
137
cbf53f7 Working on widget
fernandobt authored
138 = 0.8 =
139 Widget built for WordPress 2.8's Widget API, so you need at least WP 2.8 to use the widget.
140
2c2718c Version 0.9 ready
fernandobt authored
141 = 0.9 =
9db0f21 Ready to merge into trunk, if SVN allows me to...
fernandobt authored
142 Template system has changed. Custom templates should be stored in WordPress theme folder.
0e2d75a Fixed category link, changed template system
fernandobt authored
143
66bac8d added excerpt, template and dateformat
fernandobt authored
144 == Changelog ==
a265695 Adding version 0.1 of the plugin
fernandobt authored
145
e15430a Lots of small fixes
fernandobt authored
146 = 0.18.3 =
147 * Small excerpt fix, some readme file fixing too.
148
fb7c408 Small fixes
fernandobt authored
149 = 0.18.2 =
150 * Small fixes. Should work for name parameter in all cases now.
151
7f23094 Added small fix for category id
fernandobt authored
152 = 0.18.1 =
153 * Added slug and name to the fetching of category id from previous update.
154
6082325 Improved template system, general small fixes
fernandobt authored
155 = 0.18 =
156 * Fixed category id bug. Reported and fixed by Eric Celeste / http://eric.clst.org, thanks!
157 * Improved template system a liitle bit, now you can pass an HTML tag and a CSS class to sorround each field on your template.
158 * Added category link which wasn't working after previous big update.
159
90ae27b Quick fix release
fernandobt authored
160 = 0.17.1 =
161 * Fixed displaying of "Author:" even when not being called.
162
9db0f21 Ready to merge into trunk, if SVN allows me to...
fernandobt authored
163 = 0.17 =
164 * Major rewrite. The whole code was rewritten using objects. It's easier now to develop for List Category Posts.
165 * Both STYLESHEETPATH and TEMPLATEPATH are checked for templates.
166
1260e89 Short fix release
fernandobt authored
167 = 0.16.1 =
168 * Fixed shortcode nesting.
169
2cd6872 Some more stuff, building 0.16
fernandobt authored
170 = 0.16 =
171 * Changed STYLESHEETPATH to TEMPLATEPATH to point to the parent theme.
3b9f809 Ok, version 0.16 ready to go...
fernandobt authored
172 * Added support to display custom fields. (http://picod.net/wp03)
173 * Tested with WordPress 3.1.
2cd6872 Some more stuff, building 0.16
fernandobt authored
174
25ce89b Fixed variable declaration bug and tagged 0.15.1
fernandobt authored
175 = 0.15.1 =
176 * Fixed a bug with undeclared variable. (Check http://picod.net/walcp, thanks Das!)
177
47d05b1 Added custom fields support
fernandobt authored
178 = 0.15 =
179 * Added custom fields support. Define both custom field (customfield_name) and value (customfield_value) to use it.
180
5f41d8e Fixed catlink bug
fernandobt authored
181 = 0.14.1 =
182 * Fixed "Show the title of the category with a link to the category" code (catlink param), it broke on some previous update, but now it's working again. Thanks Soccerwidow on the WP Forums for pointing this out.
183
cee8772 Version 0.14 coming up
fernandobt authored
184 = 0.14 =
185 * Added "post_type" and "post_parent" from the underlining "get_posts()" API to be usable within the short-code. By Martin Crawford, thanks!
186 * Added the "class" parameter to style the default ul. You can pass a class name, or the plugin will use "lcp_catlist" bby default. Thanks Chocolaterebel (http://wordpress.org/support/topic/plugin-list-category-posts-sharing-my-own-template-in-lcp).
187 * Fixed "tags" parameter on the documentation, it used to say "tag", and the plugin looks for "tags".
188
17c5eee Some changes on thumbnail
fernandobt authored
189 = 0.13.2 =
190 * Fixed thumbnail code, added it to default.php template as example.
191
8545539 Fixed dateformat
fernandobt authored
192 = 0.13.1 =
193 * Fixed broken dateformat.
194
ca78e21 Committing changes on 0.13
fernandobt authored
195 = 0.13 =
196 * Show post thumbnails, should be tested, feedback on styling is welcome. Thanks to Sebastian from http://www.avantix.com.ar/
197
7dc0ab5 Added comment count and updated readme file
fernandobt authored
198 = 0.12 =
199 * Added comments count.
200 * Updated readme file
201
29e5b4e Version 0.11.2 with another small bug fix
fernandobt authored
202 = 0.11.2 =
203 * Another minimal bug fixed with the excerpt...
204
1378dfa Fixed small bug with the excerpt, release 0.11.1
fernandobt authored
205 = 0.11.1 =
206 * Fixed small bug which made the excerpt show up everytime... (Sorry :S)
207
2e7cceb Version 0.11 done :D
fernandobt authored
208 = 0.11 =
209 * Automatic excerpt added in case the user didn't specifically write an excerpt.
210 * Widget has been finally fixed. The attributes finally save themselves, and the widget works as expected :D
211
212
65d6206 Small fixes
fernandobt authored
213 = 0.10.1 =
214 * Small fix - added ul tags to default template.
215 * Compatible WordPress 3.0 with Twenty Ten theme (thanks again Doug Joseph :) )
216
02f7079 Added version 0.10 with content filtering
fernandobt authored
217 = 0.10 =
218 * Code for the_content was fixed so that the content to output filtered content (thanks DougJoseph http://wordpress.org/support/topic/399754)
219
2c2718c Version 0.9 ready
fernandobt authored
220 = 0.9 =
221 * admin parameter now shows "display name" instead of "user nice name".
222 * Template system has changed: In older version, custom templates got deleted if an automatic upgrade was done. Now templates are stored in the theme folder. (Thanks Paul Clark)
e15430a Lots of small fixes
fernandobt authored
223 * Added tag support
2c2718c Version 0.9 ready
fernandobt authored
224
bd2d8a8 Version 0.8.1
fernandobt authored
225 = 0.8.1 =
226 * Fixed bug for 'content'.
227 * There's new stuff on the widget options. I'm still working on it, so some bugs may appear.
228
cbf53f7 Working on widget
fernandobt authored
229 = 0.8 =
230 * Widget implements WP 2.8 Widget API, so at least 2.8 is required. Now you can use as many widgets as necessary, with new params.
231 * Updated readme file.
232
0e2d75a Fixed category link, changed template system
fernandobt authored
233 = 0.7.2 =
234 * Fixed link to category.
235 * Improved template system.
236
cbd9387 changed version and readme
fernandobt authored
237 = 0.7.1 =
238 * Fixed uber stupid bug with offset... Sorry about that!
239
776c428 Working on version 0.7. New parameters.
fernandobt authored
240 = 0.7 =
241 * Exclude posts. Contribution by acub.
242 * Offset parameter on shortcode to start listing posts with an offset. Contribution by Levi Vasquez
243 * Content of the post can now be displayed. Contribution by Lang Zerner.
244 * Link to the category available. By request on the plugin's forum.
e6e06a3 Fixed small bug on Cat string
fernandobt authored
245 * Fixed small bug when using category name.
776c428 Working on version 0.7. New parameters.
fernandobt authored
246
d71f9ed Added stuff to 0.6
fernandobt authored
247 = 0.6 =
248 * Minor fix for unclosed ul if not using templates.
249 * Added option to list posts from many categories at once.
250 * Added option to exclude categories.
251
66bac8d added excerpt, template and dateformat
fernandobt authored
252 = 0.5 =
253 * Readme.txt validation.
254 * Added 'excerpt' parameter. You can now show the excerpt for each post.
255 * Added 'dateformat' parameter. Format of the date output. Default is get_option('date_format') - by Verex
256 * Added 'template' parameter. Now you can choose template for output of the plugin. File name of template from templates directory without extension. Example: For 'template.php' value is only 'template'. Default is 'default' that means template in code of plugin not in template file -by Verex
169688f Implemented shortcode arguments
fernandobt authored
257
66bac8d added excerpt, template and dateformat
fernandobt authored
258 = 0.4.1 =
80b3563 Fixed compatibility issue with php 4
fernandobt authored
259
260 * Fixed some code to enable PHP 4 compatibility. Shouldn't hosting services update to PHP 5?
261
66bac8d added excerpt, template and dateformat
fernandobt authored
262 = 0.4 =
2bfff68 Added new version 0.4, with lots of changes including WP 2.7 testing.
fernandobt authored
263
264 * Added 'date' parameter. Now you can show the post's date when listed.
265 * Added 'author' parameter. You can also show the post's author.
266 * Sidebar Widget now allows you to add a title in h2 tags.
267 * Changed some variable names, to keep better compatibility with other plugins/wordpress variables.
268 * Tested with Wordpress 2.7.
269
66bac8d added excerpt, template and dateformat
fernandobt authored
270 = 0.3 =
2bfff68 Added new version 0.4, with lots of changes including WP 2.7 testing.
fernandobt authored
271
6c437c3 Fixed readme for wordpress.org
fernandobt authored
272 * Broke backwards compatibility. Users of version 0.1 should update their pages and posts for the new shortcode formatting.
273 * Option to pass arguments to the plugin, in order to use name of category instead of ID, orderby, order and number of posts are passed through parameters.
169688f Implemented shortcode arguments
fernandobt authored
274
66bac8d added excerpt, template and dateformat
fernandobt authored
275 = 0.2 =
2bfff68 Added new version 0.4, with lots of changes including WP 2.7 testing.
fernandobt authored
276
6c437c3 Fixed readme for wordpress.org
fernandobt authored
277 * Added experimental sidebar widget (use at your own risk, not ready for prime-time yet since it hasn't been tested :P )
5c85d22 Added 0.1.1 tag with major fix for 404 bug in Options page
fernandobt authored
278
66bac8d added excerpt, template and dateformat
fernandobt authored
279 = 0.1.1 =
2bfff68 Added new version 0.4, with lots of changes including WP 2.7 testing.
fernandobt authored
280
6c437c3 Fixed readme for wordpress.org
fernandobt authored
281 * Fixed major bug, which gave 404 error when trying to use "Options" page.
5c85d22 Added 0.1.1 tag with major fix for 404 bug in Options page
fernandobt authored
282
66bac8d added excerpt, template and dateformat
fernandobt authored
283 = 0.1 =
2bfff68 Added new version 0.4, with lots of changes including WP 2.7 testing.
fernandobt authored
284
6c437c3 Fixed readme for wordpress.org
fernandobt authored
285 * Option page to limit number of posts.
2bfff68 Added new version 0.4, with lots of changes including WP 2.7 testing.
fernandobt authored
286 * Working using [category=ID] for posts and pages, with several categories support.
Something went wrong with that request. Please try again.