=== Plugin Name ===
Contributors: Easwy Yang
Donate link:
Tags: Posts, post, plugin, url, ads, copyright, credits, license
Requires at least: 2.7
Tested up to: 3.3.1
Stable tag: 2.0

This plugin allows you to insert a user specific text (such as copyright,
credit, advertisement, etc.) at the beginning/ending of your posts.

== Description ==

This plugin allows you to insert a user specific text at the beginning and/or
ending of all your post.  The text can be a copyright declaration,
advertisement codes, etc. HTML codes are allowed.
You can select which pages (home/single/feed/category/tag/archive page) to
display the specific text. You also can decide which posts display the text.

It accepts following macros in user specific text:

* %site_url% - the URI of your site
* %site_name% - the name of your site
* %post_url% - the URI of the post where the text is displayed
* %post_title% - the title of the post where the text is displayed

If the header text is not empty, it will be inserted to the head of your post;
otherwise no head text will be inserted.

If the footer text is not empty, it will be inserted to the foot of your post;
otherwise no footer text will be inserted.

You can choose which pages to display the header text and/or footer text.
It includes:

* Blog Home - the header/footer text will be displayed on blog home
* Page      - the header/footer text will be displayed on pages
* Category  - the header/footer text will be displayed on category
* Tag       - the header/footer text will be displayed on tags
* Archive   - the header/footer text will be displayed on archives
* Single    - the header/footer text will be displayed on single
* Feed      - the header/footer text will be displayed in feed

When you add a new post, you can decide whether or not to add the header text
and/or footer text to this post. You do this by selecting "Add Post URL?"
option in the editor page.  This option is saved as a Custom Field, named
"posturl_add_url".

For posts without this Custom Field, you can define the default behavior. If
you select "By default, add text to post", then all posts without this Custom
Field will add the header text and/or footer text; otherwise those posts will
not add the header text and/or footer text.

If you don't want to help promote WP-PostURL plugin, you can uncheck this
checkbox. The credit of WP-PostURL will not be displayed.

More information about this plugin, please access [WP-PostURL Plugin Page](http://easwy.com/blog/wordpress/wp-posturl/ "WP-PostURL Plugin") on [Easwy's Blog](http://easwy.com/blog/).

I also want to thanks [Lester "GaMerZ" Chan](http://lesterchan.net), the author of [WP-PageNavi](http://lesterchan.net/portfolio/programming/php/). Most
codes of this plugin are derived from his WP-PageNavi plugin.

== Installation ==

1. Upload whole `wp-posturl` directory to the `/wp-content/plugins/` directory;
1. Activate the plugin through the 'Plugins' menu in WordPress;
1. Goto "Setting --> Add Post URL" page to define your user specific text;

Your original configuration will be totally kept during upgrading. But please
backup before upgrading to avoid configuration lost.

You can completely uninstall WP-PostURL plugin.
It will remove all the option settings created by this plugin, and deactive
this plugin at the same time. 

== Frequently Asked Questions ==

== Screenshots ==

== TODO List ==

(empty)

If you have any requirement about this plugin, please leave a comment on the plugin page above.