开发者 | timhodson |
---|---|
更新时间 | 2012年3月4日 02:22 |
捐献地址: | 去捐款 |
PHP版本: | 3.0 及以上 |
WordPress版本: | 3.3.1 |
blog-in-blog
directory to the /wp-content/plugins/
directory (or install via wordpress plugins admin menu)[blog_in_blog category_slug='my-category-slug' num=5]
to a new PAGE (not post) on your site.[blog_in_blog category_slug='my-category-slug' num=10]
Yuo must specify the category_slug
. Optionally specify a number of posts, defaults to 10. There are lots of other parameters you can use (see below).
1. You can hide the pagination of the posts.
[blog_in_blog category_slug='my-category-slug' num=10 pagination=off]
1. You can optionally hide specified (multiple) categories from the normal home page and RSS feeds. (There is an admin page for you to do this)
1. You can optionally specify a template to use for an instance of the blog-in-blog shortcode.
[blog_in_blog category_slug='my-category-slug' num=5 template="myfile.tpl"]
This template must exist in the wp-content/uploads
directory or the wp-content/plugins/blog-in-blog
directory.
1. You can customize some of the look and feel elements of the post display, including your own css style for the pagination, on the blog-in-blog admin page.
Tips
wp-content/uploads/
(or wherever you have set your uploads folder) for your template file first before looking in wp-content/plugins/blog-in-blog
(your template will probably be lost when the plugin is upgraded).[blog_in_blog category_slug='my-category-slug']
or to save you typing [blog_in_blog]
every time...
[bib category_slug='my-category-slug']
All shortcode paramaters:
These shortcode parameters can be combined in any way you like (except post_id
) to target specific posts:
category_id=<integer>
The ID of the category you wish to showcategory_slug=<category_slug>
The slug of the category you wish to showcustom_post_type=<post_type>
Posts with a custom post type that you want to showtag_slug=<tag_slug>
Posts of this tag slug will be shown. You can do OR (slug1,slug2,slug3) and AND (slug1+slug2+slug3)author=<author id>
Posts from this author, identified by a numeric author id.author_name=<author user_nicename>
Posts from this author, identified by their user nicename.post_id=<a post id>
If specified only shows a single post. All other selection or sort parameters are ignored.num=<integer>
Number of posts per page. Defaults to 10 if not setpagination=<on or off>
Defaults to on.order_by=<a valid option>
Defaults to date. Valid options are those supported by Template Tag query_posts() so things like date, title, rand (for random). Overidden by custom_order_by
custom_order_by=<custom field>
Name a custom field to order by. If the field contains dates, they must be entered YYYY-MM-DD
or sorting by date will not work. If you want the dates to show in the template and be formated, you can select the custom field to be formatted using the default date format in Wordpress. If set, overides order_by
.sort=<sort direction>
Sort (the direction to sort the order by field) can be one of the following values (brackets show direction):sort=oldest
(ASC)sort=newest
(DESC).sort=ascending
(ASC)sort=descending
(DESC)sort=ASC
sort=DESC
template=<template_name>
Specify a template name. First we assume that this is a named template in the database. Then we look for a file in the following locations, in the order shown:WP_CONTENT_DIR/uploads/<your filename>
(or whever your uploads directory is)WP_CONTENT_DIR/plugins/blog-in-blog/<your filename>
thumbnail_size=<size>
For use with `%post_thumbnail% template tag. Where is one of:%post_title%
- The title of the post.%post_permalink%
- The post permalink.%post_id%
- The post id.%post_author%
- The post author.%post_author_avatar%
- The post author's avatar (uses wordpress avatar functionality).%post_categories%
- The categories that the post belongs to.%post_content%
- The content of the post.%post_excerpt%
- The excerpt of the post. Either the excerpt if specifically defined or the <!--more-->
tag in your content, or the default wordpress excerpt, in that order.%post_comments%
- A comments link.%post_thumbnail%
- The thumbnail of the wordpress featured image for the post. Will supply a full <img>
tag.%post_tags%
- A list of tags assigned to the post. Will have a link to the wordpress tag space for your site. Delimited by the text delimiter in your blog-in-blog options.%post_date%
- The date of the post as defined by the format string in the admin page.%post_day%
- The day of the month as 2 digits, i.e. 09
or 31
.%post_dw%
- The day of the week short, i.e. Mon
.%post_dow%
- The day of the week long, i.e. Monday
.%post_mon%
- The month short, i.e. Jan
.%post_month%
- The month long, i.e. January
.%post_m%
- The month numeric leading zero, i.e. 01
.%post_n%
- The month numeric, i.e. 1
.%post_year%
- The year in 4 digits, i.e. 2009
.%post_yr%
- The year in 2 digits, i.e. 09
.%...%
- All custom fields attached to a post can be used in the template. Simply place your custom field name between percent (%) marks,Writing this plugin is not the whole of my life. Therefore if you email, I may not get back to you straight away. Additionally the support forums on wordpress don't tell me when there is a new post, so there may be a delay in response. You need to use the template features of blog-in-blog to get your posts to show using the same HTML and CSS structure that your theme uses. You will need to learn some CSS and HTML then update the template. I cannot do this for you.
Yes, but only if you have already done the following and sent me the answers.
Yes, and I will even try to answer your question! If you are atempting to contact me with Skype Chat, I only accept contact resquests if it is obvious you are asking about this plugin (try not to look too much like spam!), so don't be offended if it seems I ignore you. Try an email instead :) . And I do have a day job too... Tim Hodson
Thanks to the folowing people for providing translations, and feel free to send me yours if you don't see your language listed here.
be_BY
- FatCownl_NL
- Mark Strookerde_DE
- Christian Schmitterno
- Geir A Granvikenfr_FR
- Stef Walter%post_excerpt%
should now be fixed and always displaying based on either excerpt, moretag or default in that order.hidefirst
shortcode parameter to offset the first n posts in the query.author
and author_name
selectors fpr posts by an author.apply_filter()
calls on the_title and the_author template tags.category_slug=<slug>
in a shortcode if you know the category slug.tag_slug=<slug>
in a shortcode if you know the tag slug.custom_post_type=<post_type>
in a shortcode if you know the post type name you want to use.blog_in_blog()
added for direct use of the plugin in themes as well as posts/pages.<br>
tags now correct.[bib]
as a shortcode to save you typing [blog_in_blog]
every time!post_id=
option for shortcode, will show a single post based on its post id.apply_fiters()
issues.[blog_in_blog]
shortcodes on a single page are supported.apply_fiters()
issues. Basically other plugins and themes were calling the_content
and attempting to reapply the blog-in-blog shortcode, causing max nested loops errors or infinite loops.appy_filters()
on the_content
which will cause shortcode to be re-applied again and again.order_by
parameter to choose the field to sort on.%post_tags%
.%post_tags%
template tag.%post_excerpt%' tag (will only show anything if you actualy have an excerpt). blog-in-blog already recognises the
` quicktag.[blog_in_blog category_id=3 sort=newest ]
sort can be one of oldest first (ASC) or newest (DESC). Default is always newest first.bib_post_template.tpl
. It is still overwritten but when loading the template we look for the template file in wp-content/uploads
first. So that's where you should put yours!<!--more-->
tags to posts.