About this plugin
This simple plugin allows you to easily post short messages such as thoughts and updates. These messages will not appear in your stream of posts; instead you can display them in a widget in yours sidebar. You can also display them in any post or page by using the [microblog] shortcode.
To get started, just look for the new Microposts administration panel in your dashboard. Click Add new and then compose a short message in the same way that you normally compose your posts. If you give the micropost a title, then it will be displayed in bold and used as the first few words of the micropost.
Then, either add the widget to your sidebar or add the [microblog] shortcode into your site, and that’s it!
The [microblog] shortcode supports several options:
-
num: The number of microposts to show. Defaults to 5. Use -1 to show all microposts.
-
null_text: If no results are returned, shows this text. Defaults to (none).
-
show_date: If defined, the creation date will precede the microposts.
-
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", which displays as “May 12”.
-
use_excerpt: If defined, use the post excerpt instead of the entire contents. We recommend writing short microposts, but if you prefer to write longer ones, this can be used to truncate them. Unfortunately, WordPress excerpts don’t allow links or other html, use the plugin Advanced Excerpt to remedy this!
-
q: Arbitrary &-separated arguments to add to the query. See the WP_Query page for available syntax. For example, to show only posts from author sam in ascending instead of descending order, you would write [microblog q="author_name=sam&order=ASC"].
The output can then be further formatted using CSS. We recommend the plugin Improved Simpler CSS for quickly styling your post list (and your site)!
Report bugs, give feedback, or fork this plugin on GitHub.
If you are having trouble viewing your microposts, try visiting your permalinks preference pane and clicking Save changes.
It is a known issue that some permalink structures do not work with Simple microblogging when the plugin Salmon for wordpress is installed.