WP_BoilerPlate
Download
WP_BoilerPlate
WP_BoilerPlate is a free WordPress plug-in that allows you to add frequently used sentences, phrases or paragraphs into your posts or pages easily with inclusion of one simple tag. The “boilerplate” text is stored as a page in your blog, and is inserted into the post or page on display, giving you ability to change blocks of text in all your posts easily. WP_BoilerPlate has the ability to do a search and replace on the “boilerplate” text before it is inserted, giving you the ability to make things a little more specific. WP_BoilerPlate can be used recursively.
Installation
- Download the required plug-in.
- Unzip file if required.
- Copy to your ‘wp-content/plugins‘ directory.
- Log in with an administration account.
- Select the ‘Plugins‘ tab.
- Scroll down to ‘WP_BoilerPlate’ and click ‘activate‘.
Upgrading
With the release of WordPress 2.5, WordPress now supports BBCode style shortcodes. Which means the preferred method of inserting content into is post via a plugin is with [] instead of <!– –>. With this in mind WP_BoilerPlate now has support for this method. Once WordPress 2.5 is the predominant version, the <!– –>method will be dropped, and the plug-in rewritten to use the internal API calls, hopefully meaning for a more efficient plugin.
To upgrade previous boilerplate already in you posts
- Log in to WordPress
- Go to ‘Update->Boilerplate’
You can choose to either manually update posts from the list provided or choose to autoupdate.
Usage
To use WP_BoilerPlate insert the following BBCode shortcode into your post where you would like the “boilerplate” text form to appear.
[boilerplate post = "post" {text} = "text"]
The Attributes
- post
- Purpose: The page to use as the “boilerplate” text.
- {text}
- Purpose: This is an optional attribute, you can also have as many of this attribute as you require. It tells WP_BoilerPlate what text is to be replace in the “boilerplate” text before it is inserted into you post or page. In the example replace {text} with the text to be replaced. {text} should only be one word and it is recommended that it you make it unique, for example by prefixing it with @.
Filters
The following filters will be automatically replaced in the text.
@@post_rss_title@@ , @@post_author@@ , @@post_author_description@@ , @@post_author_email@@ , @@post_author_firstname@@ , @@post_author_lastname@@ , @@post_author_nickname@@ , @@post_author_url@@ , @@post_url@@ , @@post_date@@ , @@post_time@@ , @@post_title@@ , @@blog_url@@ , @@blog_name@@ , @@blog_desc@@ , @@blog_home@@.
Version History
- 1.0.0
- Initial public release.
- 2.0.0
- Added search and replace support
- 2.0.1
- Solved problem with case sensitive file names.
- 3.0.0
- Changed to BBCode style tags
- Added update.
- Added standard filters.
- 3.1.0
- Reapplied filters to allow recursion and better filtering
- 3.1.1
- Removed filters on nested text due to problems with footers being applied to the text
- Added new technique for doing recursion
Bugs & Suggestions
If you have questions, have found any bugs, or you would like to see features added to WP_BoilerPlate please feel free to use the form at the bottom of the page to contact us.
Other Plug-ins
If you liked this plug-in visits our download area where you will find many more.
Development
If you have need for a custom plug-in, feel free to contact us on our contact page to discuss a specially commissioned plug-in.
Donation
If you liked this plug-in and would like to support its development please make a donation. Any amount you wish.
October 30th, 2007 at 4:34 pm
I am finding it difficult to use this plugin. Can you simplify the usage steps and post it here?
Where can I find the postname? I checked Manage section but there is no column named postname.
October 30th, 2007 at 7:29 pm
The post name is the just the title, internally its referred to as the post name. I’ll change to documentation to reflect this.
November 2nd, 2007 at 11:25 am
I created a private post with the title Boiler and added few information. I then edited a published post and added the following HTML using code editor
The boiler plate content is not shown inside the post when I viewed it.
Please let me know if this is the correct format.
Waiting for your reply.
November 2nd, 2007 at 11:38 am
Unfortunately it would appear that t the tag has been removed from the comment. If you post it again substitute [] or the <>.
December 27th, 2007 at 7:15 am
Your instructions appear to be rather cryptic!
Insert [!–boilerplate post=”{postname}” {text} = “{new text}”–]
Assume I name my post “boilerplate”. Assume somehow that I have cut and paste some text into “new text” which I want to duplicate. I’ve named “text” “bp_start”. How do I select the text to duplicate in another post?
Is the “new text” placed in the new post when I enter [!-boilerplate post="boilerplate" bp_start -]
Hope you can understand my question as I’m sure you know your plugin - just that the instructions to use it are currently inadequate. Please take this on board as a constructive critique.
Regards
Gary O
December 27th, 2007 at 2:39 pm
Gary O: Thanks for the comments, taken on board as meant. I often find it hard to write simple instructions to something I’ve spent so much time with.
In answer to your questions.
boilerplate is the name of the tag used to identify the tag to be replaced, and has no affect on the text being inserted.
Your post can be called anything.
You indicate what post you want to insert with the
post = “[postname}”
where {postname} is the name of the post you want to insert. This means you can choose different posts buy changing the postname.
The text IS inserted where you insert the tag.
The bp_start that you have in your tag will not do anything.
The other optional attributes in the tag are text that will be replaced in the post you are inserting.
so:
word1 = “this is a text”
will replace all occurrences of word1 with this is a test before inserting the text. You can have as many of these attribute as you like, not just one as shown in the example.
I hope this has answered you questions. I will be rewriting the instructions soon, thanks to you questions.