Blog-in-Blog allows you to use the WordPress platform for it’s CMS features, but still have a blog page on your site. Posts selected by category, post_type, tag or any combination thereof, can be used to feed the ‘special’ blog page, and can optionally be hidden from the home page.
You can have more than one category hidden from the homepage (not post_types or tags).
You can also use this plugin to show posts on the same page from different categories, post_types or tags, but in several different blocks and using different layout templates.
If you find this plugin useful (especially if it gets you out of a fix in a commercial setting), please feel free to leave feedback via the donate button.
I am grateful for those people who have already bought me a beer 🙂
Important: In previous versions of the Blog-in-Blog plugin you might have edited bib_post_template.tpl. If you are upgrading, we will copy this to a textbox so you can edit the template from the plugin page. The bib_post_template.pl file is no longer used and may vanish in a future release.
How to install the plugin and get it working.
- Upload the
blog-in-blogdirectory to the
/wp-content/plugins/directory (or install via wordpress plugins admin menu)
- Activate the plugin through the ‘Plugins’ menu in WordPress
- Add a shotcode such as
[blog_in_blog category_slug='my-category-slug' num=5]to a new PAGE (not post) on your site.
- Optionally, use the admin page to select which category(ies) to hide from the home page.
- Therefore, any posts with the chosen category are shown only on your new page and not on the home page, so if you use WordPress as a CMS, you now have a blog within a blog.
NOTE: Don’t copy any code from here and paste into the visual editor, as you will be copying some HTML too, and you may not want that. Use the HTML editor to paste you shortcode and make sure it is not wrapped in extra HTML.
How it works:
Add the shortcode in the body of a new PAGE (not post) to select a number of posts within a specified category. This page with the shortcode becomes your ‘blog in blog’ page (you can of course call it what you will). i.e:
[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).
You can hide the pagination of the posts.
[blog_in_blog category_slug='my-category-slug' num=10 pagination=off]
- 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)
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/uploadsdirectory or the
- 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.
- The category list in the blog-in-blog admin page ONLY shows categories with posts. You need to create some content first!
- You can specify the name of the template in the shortcode (applies to that shortcode instance only). First we look in the database for a user template, then we always look in
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).
- Using the blog-in-blog shortcode on a page which is designated as a static shortcode will work, BUT pagination will not work as you expect it. I know this, but have not been able to fix yet. It is all to do with the way that WordPress builds it’s URLs on the fly, and that is very complex!
What shortcode options are there?
NOTE: Don’t copy any code from here and paste into the visual editor, as you may be copying some HTML too, and you may not want that. Use the HTML editor to paste you shortcode and make sure it is not wrapped in extra HTML.
As a minimum you need the following shortcode:
or to save you typing
[blog_in_blog] every time…
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 show
category_slug=<category_slug>The slug of the category you wish to show
custom_post_type=<post_type>Posts with a custom post type that you want to show
tag_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.
These parameters affect the pagination display:
num=<integer>Number of posts per page. Defaults to 10 if not set
pagination=<on or off>Defaults to on.
These parameters affect the order of the posts:
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 field>Name a custom field to order by. If the field contains dates, they must be entered
YYYY-MM-DDor 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
sort=<sort direction>Sort (the direction to sort the order by field) can be one of the following values (brackets show direction):
- Oldest first:
- Newest first:
- Default is always newest (DESC) first.
- Oldest first:
These parameters affect the look of your posts.
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:
- Uploads directory:
WP_CONTENT_DIR/uploads/<your filename>(or whever your uploads directory is)
- Plugin directiry:
- Uploads directory:
thumbnail_size=<size>For use with `%post_thumbnail% template tag. Where is one of:
- NxN – Optionally specify a height/width. The longest side of the image will be as specified. (i.e. 134×134 or 182×182)
What template tags are available?
%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
%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.
%post_dw%– The day of the week short, i.e.
%post_dow%– The day of the week long, i.e.
%post_mon%– The month short, i.e.
%post_month%– The month long, i.e.
%post_m%– The month numeric leading zero, i.e.
%post_n%– The month numeric, i.e.
%post_year%– The year in 4 digits, i.e.
%post_yr%– The year in 2 digits, i.e.
%...%– 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.
- How do I get my posts displayed via blog-in-blog to look like the rest of my wacky theme?
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.
- There is a problem can you help?
Yes, but only if you have already done the following and sent me the answers.
- Send me a link to your site where i can see the problem live.
- Switch to the default wordpress theme
- Disable all plugins except for blog-in-blog. Does the problem still show?
If not, switch back to your theme.
Does the problem show now? If so, tell me what the theme is.
Add other plugins back one by one. After each test to see if the problem is still there.
Which plugin caused the conflict with blog-in-blog?
- Can I ask you a question?
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…
- What Translations are available?
Thanks to the folowing people for providing translations, and feel free to send me yours if you don’t see your language listed here.
nl_NL– Mark Strooker
de_DE– Christian Schmitter
no– Geir A Granviken
fr_FR– Stef Walter
The .pot file was extensively rewritten as of version 1.0.3. You may wish to send me your new translations?
Used this plugin for several years and its working great even if no update has occured in past 4 years. Perhaps author can update plugins that its actually working for higher releases then 3….
Contributors & Developers
“Blog-in-Blog” is open source software. The following people have contributed to this plugin.Contributors
- Fixed: Read more links for post excerpts are now fixed.
- Fixed: Better calculation of offset if hidefirst n posts is used.
%post_excerpt%should now be fixed and always displaying based on either excerpt, moretag or default in that order.
- Added: Additional css classnames to the prev/next links
- Added: bib-shortcode-in-post infinite loop protection.
hidefirstshortcode parameter to offset the first n posts in the query.
author_nameselectors fpr posts by an author.
- Fixed: Bug where user templates were not being saved to the database.
- Fixed: Bug where Entity encoded chars in a template were decoded then causing problems on save.
- Fixed: Bug where excerpts were not shown.
- Fixed: (hopefully) issue with redeclaration of Markdown().
- Fixed: issues with single post shortcodes.
- Added: Tidied debug code: now shown in a textarea after the normal output of the plugin.
apply_filter()calls on the_title and the_author template tags.
- Added: User template creation within the database. You don’t need to use files ever again!
- Added: You can now use
category_slug=<slug>in a shortcode if you know the category slug.
- Added: You can now use
tag_slug=<slug>in a shortcode if you know the tag slug.
- Added: You can now use
custom_post_type=<post_type>in a shortcode if you know the post type name you want to use.
- Added: You can combine custom_post_type, category_id, category_slug and tag_slug in any combination to select the posts you want.
- Added: WordPress theme template tag function
blog_in_blog()added for direct use of the plugin in themes as well as posts/pages.
- Fixed: Looking for templates in non standard places.
- Added: Category hiding under WordPress 3.1 is slightly different, both methods returned for backwards compatability.
- Fixed: POST_ID showing unecessarily. Don’t you love debug code!
- Fixed: Markdown clashes with wpautop()
<br>tags now correct.
- Fixed: We now look in whichever folder your uploads is set to.
- Added: Uninstallation now removes bib options from database.
- Added: Editing of template in the blog-in-blog admin page. Your existing default template will have been copied here when you upgraded
- Added: This readme.txt as a help tab on the admin page.
- Added: Lots of new explanation in readme.txt and admin page based on your support queries. (please use the new .pot file if you are a translation author)
- Added: French translation.
- Changed: The admin page has been revamped with a tabbed menu.
- Changed: File extension for Dutch translation becomes nl_NL.
- Added: German translation.
- Fixed: some minor bugs.
Finally released version 1.0!
- Added: Custom fields are now picked up as template tags that are available in the bib_post_template.tpl.
- Added: Sorting on a custom field is now possible. Will sort alpha/numeric or dates.
- Added: Registered
[bib]as a shortcode to save you typing
- Added: `%post_thumbnail%’ template tag for those wanting to use the WordPress featured image functionality.
post_id=option for shortcode, will show a single post based on its post id.
- Fixed: Galleries will now be corectly shown in the output from Blog-in-Blog.
- Trying yet another fix for
- Now multiple
[blog_in_blog]shortcodes on a single page are supported.
- Tried a different fix for
apply_fiters()issues. Basically other plugins and themes were calling
the_contentand attempting to reapply the blog-in-blog shortcode, causing max nested loops errors or infinite loops.
- Fixed issue causing infinite loop with other plugins that call
the_contentwhich will cause shortcode to be re-applied again and again.
order_byparameter to choose the field to sort on.
- Added: Debug option on the admin page, blog-in-blog will then dump stuff to your browser window. You can send enable this is you need help.
- FIxed: spacing of tags in
- Updated: translation (pot) file.
- Fixed: pagination now shows when there are more than one categories selected.
- Fixed: A ridiculously silly bug introduced while implementing the Settings API which meant you couldn’t change/initially set the categories hidden from the home page!
%post_excerpt%' tag (will only show anything if you actualy have an excerpt). blog-in-blog already recognises the` quicktag.
- Updated: Admin page now uses the WordPress Settings API.
- Added: Shortcode sort order option:
[blog_in_blog category_id=3 sort=newest ]sort can be one of oldest first (ASC) or newest (DESC). Default is always newest first.
- Fixed: overwriting of
bib_post_template.tpl. It is still overwritten but when loading the template we look for the template file in
wp-content/uploadsfirst. So that’s where you should put yours!
- Updated: explanation in the readme.txt
- Added: Admin page option to hide categories from feeds.
- Added: More template tags for use in the default template.
- Added: ‘Potential overwrite’ warning if you are using the default template file.
- Added: Hide page navigation option. (see installation notes)
- Added: Include user templates for different blog-in-blog pages. See “Installation” for details.
- Added: Author and Author Avatar are now available in the default template.
- Fixed: page navigation bug when permalinks are used.
- Added: A category tag to the template so that if a post appears in other categories the categories are displayed.
- Added: i18n support
Further Bug fixes around initial installation: dealing with no categories and no posts to display.
- Added: Application of the
<!--more-->tags to posts.
- Added: Hiding of multiple categories from home page, you can now have as many blog-in-blog pages as you like.
- Fixed: Bugs with empty arrays when blog-in-blog first installed.
- Added: Paging of posts if more posts than will fit on page
- Early point release with minor bugfixes