Title: Simple upcoming
Author: Samuel Coskey
Published: Du 23, 2011
Last modified: Gortheren 19, 2012
---
Search plugins
This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.
# Simple upcoming
By [Samuel Coskey](https://profiles.wordpress.org/sgcoskey/)
[Download](https://downloads.wordpress.org/plugin/simple-upcoming.0.3.zip)
* [Details](https://cor.wordpress.org/plugins/simple-upcoming/#description)
* [Reviews](https://cor.wordpress.org/plugins/simple-upcoming/#reviews)
* [Installation](https://cor.wordpress.org/plugins/simple-upcoming/#installation)
* [Development](https://cor.wordpress.org/plugins/simple-upcoming/#developers)
[Support](https://wordpress.org/support/plugin/simple-upcoming/)
## Description
This is another simple plugin to add a little functionality of a
calendar to your
blog. With this plugin you can specify, for any of your posts, an associated “Event
Date” using a new widget in the post editor. Then, elsewhere on your site, you can
retrieve a list of future events using the `[upcoming]` shortcode on any post or
page.
The shortcode supports several options:
* **category_name**: If defined, show posts only from these
categories. You can
provide multiple comma-separated category identifiers (slugs).
* **days_old**: Show events whose Event Date is no more than this many
days past.
The default is `0`, which shows only events taking place today or later. If you
enter a non-numeric value such as **infinity**, then all matching events will
be shown regardless of the Event Date.
* **style**: One of _list_ (default) or _post_. If it is _list_, then
the list
style is indented and bulleted. If it is _post_ then the title is promoted to`
` and the list style is plain.
* **text**: One of _none_ (default), _excerpt_, or _normal_. If it is
_excerpt_,
then the post excerpt is shown, similar to search results. If it is _normal_
then the full post (up to the `[more]` tag) is shown.
* **null_text**: If no results are returned, shows this text.
Defaults to `(none)`.
* **class_name**: If defined, adds this class name to the generated ``
tag.
Useful for custom styling.
* **show_date**: If defined, the date will precede the post title
* **date_format**: If showing the date, this php date format will be
used. The
default is the Date Format value from the General Settings page. I recommend `"
F j, Y"`, which displays as “May 12, 2012”.
* **q**: Arbitrary additional arguments to pass to the query. See the
[WP_Query](https://codex.wordpress.org/Class_Reference/WP_Query/#Parameters)
page for available syntax. For example, to show only events with tag “workshop”,
and only 3 such events, you would write `[upcoming q="posts_per_page=3&tag=workshop"].
The output can then be further formatted using CSS. We recommend the
plugin [Improved Simpler
CSS for quickly styling your upcoming events list (and your site)!
Report bugs, give feedback, or fork this plugin on
[GitHub](http://github.com/scoskey/Simple-upcoming-wordpress-plugin).
## Installation
Nothing unusual here!
## Reviews
There are no reviews for this plugin.
## Contributors & Developers
“Simple upcoming” is open source software. The following people have contributed
to this plugin.
Contributors
* [ Samuel Coskey ](https://profiles.wordpress.org/sgcoskey/)
* [ Victoria Gitman ](https://profiles.wordpress.org/vgitman/)
[Translate “Simple upcoming” into your language.](https://translate.wordpress.org/projects/wp-plugins/simple-upcoming)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/simple-upcoming/),
check out the [SVN repository](https://plugins.svn.wordpress.org/simple-upcoming/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/simple-upcoming/)
by [RSS](https://plugins.trac.wordpress.org/log/simple-upcoming/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
0.3 added shortcode parameter **days_old**.
```
0.2.1 bug fix: the default event date was the start of 1970 rather
```
than no date at all.
```
0.2 Unfortunately I have changed the way dates are stored in the
```
database. This means you will have to open and re-save any posts you
have with
the “Event Date” set. I have also changed the shortcode parameters slightly with**
style** becoming both **style** and **text**. Please have a look at the syntax.
I apologize for the inconvenience!
big fixes: dates in different years were sorted incorrectly. the
timezone was not
respected.
new features: added the q and text parameters
```
0.1.3 bug fix: added nopaging so all relevant posts appear
0.1.2 bug fix: sticky posts were always appearing
0.1.1 bug fix: non-empty input to the "event date" box wasn't working
```
(accidentally introduced in the last bug fix)
```
0.1 bug fix: empty input to the "event date" box wasn't working
0.0 initial release
```
## Meta
* Version **0.3**
* Last updated **14 years ago**
* Active installations **10+**
* WordPress version ** 3.0 or higher **
* Tested up to **3.4.2**
* Language
* [English (US)](https://wordpress.org/plugins/simple-upcoming/)
* Tags
* [calendar](https://cor.wordpress.org/plugins/tags/calendar/)[Event](https://cor.wordpress.org/plugins/tags/event/)
[events](https://cor.wordpress.org/plugins/tags/events/)[upcoming](https://cor.wordpress.org/plugins/tags/upcoming/)
* [Advanced View](https://cor.wordpress.org/plugins/simple-upcoming/advanced/)
## Ratings
5 out of 5 stars.
* [ 2 5-star reviews ](https://wordpress.org/support/plugin/simple-upcoming/reviews/?filter=5)
* [ 0 4-star reviews ](https://wordpress.org/support/plugin/simple-upcoming/reviews/?filter=4)
* [ 0 3-star reviews ](https://wordpress.org/support/plugin/simple-upcoming/reviews/?filter=3)
* [ 0 2-star reviews ](https://wordpress.org/support/plugin/simple-upcoming/reviews/?filter=2)
* [ 0 1-star reviews ](https://wordpress.org/support/plugin/simple-upcoming/reviews/?filter=1)
[Add my review](https://wordpress.org/support/plugin/simple-upcoming/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/simple-upcoming/reviews/)
## Contributors
* [ Samuel Coskey ](https://profiles.wordpress.org/sgcoskey/)
* [ Victoria Gitman ](https://profiles.wordpress.org/vgitman/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/simple-upcoming/)
## Donate
Would you like to support the advancement of this plugin?
[ Donate to this plugin ](http://boolesrings.org)