=== Plugin Name ===
Contributors: weyhan
Donate link: http://sandboxblogger.com/
Tags: teaser, excerpt, preview, statistics, navigation, more
Requires at least: 1.5
Tested up to: 2.3
Stable tag: 3.10

Post Teaser generates excerpts of posts for the main, archive and category pages, also generate a word count, image count, and estimated reading time.

== Description ==

Post Teaser generates a preview or "teaser" of a post for the main, archive and category pages, with a link underneath to go to the full post page. It includes features to generate a word count, image count, and an estimated reading time.

Reasons you might want to use Post Teaser:

* You keep putting `<!--more-->` into your posts
* You would like to save bandwidth by only having people view a full post if they actually want to read it
* You just like the "teaser" format

Contributors:

* [WeyHan Ng](http://sandboxblogger.com/ "SandboxBlogger.com") -- Maintainer
* [Jonathan Leighton (Turnip)](http://turnipspatch.com "Turnip") -- Concept and programming
* [eleZeta](http://ele-zeta.com.ar/ "eleZeta") -- Estimated reading time code was adapted from his plugin : )

**** NOTE: PLEASE DO NOT EMAIL JONATHAN LEIGHTON FOR SUPPORT. Instead contact [me](http://sandboxblogger.com/contact/ "Contact me") for support.
	
Translators:

* el_GR:
	* [Alexander Kanakaris](http://www.tech-spot.gr/ "Alexander Kanakaris")
* de_DE:
	* [Sören Weber](http://soeren-weber.net/ "Sören Weber")
* nl_BE, nl_NL:
	* [Mathias Bynens](http://mathibus.com/ "Mathias Bynens")
* pl_PL:
	* [Przemysław Naruszewicz](http://www.ikeris.com/ "Przemysław Naruszewicz")

== Installation ==

1. Download [post-teaser.zip](http://downloads.wordpress.org/plugin/post-teaser.zip "post-teaser.zip")
2. Extract and place `post-teaser.php` it in the wp-content/plugins directory of your WordPress installation. **Do not place it in a sub-directory of the plugins directory.**
3. Go to the Plugins configuration page in your WordPress admin panel, and enable Post Teaser

Post Teaser does not need to be configured in order to work but some users understandably wish to change settings. That's easy too -- the dead simple configuration page can be found under `Options > Post Teaser` in your WordPress admin panel.

== Frequently Asked Questions ==

= Do I really need this plugin? =

No, of course not, but it makes a nice addition and some people find it easier to skim over previews to find something that interests them rather than to scroll down huge chunks of text.

= Why Post Teaser fail to split some/all post on the front page? =

Post Teaser is a paragraph aware teaser. Not only just aware, it will not break in the middle of a paragraph unless explicitly told to do so with the `<!--more-->` tag. 

There are two reasons why Post Teaser seems to have failed to split a post:

1. *The post has only one long paragraph.* Well, as stated, Post Teaser is a paragraph aware teaser therefore will split post with only one lone paragraph at the end of the first paragraph which in this case is the end of the post. To fix this problem, either split the post into shorter paragraph or add a `<!--more-->` to force a split.
1. *The post have multiple paragraph, however, instead of the `<p>` tag, the `<br />` tag was used.* To a human being, using a `<br />` tag to break a new paragraph is just fine. However, to a computer program, schematically it makes a big difference. While it reads like a post with multiple paragraphs, Post Teaser sees it as one long paragraph. To fix this problem, the `<br />` tags needs to be replace with the proper `<p>...</p>` paragraph marker pair.

= Help! I get an error that says "Warning: Cannot modify header information..." =

This one is very common and applies to any WordPress plugin. There must not be any content in the plugin file other than PHP code. Sometimes if people have copied the code into their own file, rather than downloading it, they accidentally leave whitespace or other characters at the beginning or end of the file, outside of the `<?php ... ?>` block. Removing any excess characters will solve the problem.

= How can I apply presentation to the teaser text? =

The teaser text is placed inside a block level `<div>` element with a class of "post-teaser". This means that you can use CSS to style the teaser text. As an example, here's the CSS you'd use to make it bold:

.post-teaser {
    font-weight: bold;
}

= What if I don't want a particular post to be teasered? =

You have two options here:

1. Have Post Teaser ignore that post entirely
2. Have Post Teaser "display the post in full", and display the message that it did so (like what happens if you have a post that is too short to be teasered)

Both of them work by using a custom field for you post. Here's how to do it:

1. Edit/Write your post in the WordPress admin panel
2. If you are not in the "Advanced" mode, then get into it by clicking the "Advanced Editing" button
3. At the bottom of the form, where it says "Custom Fields", write 'teaser' in the box labelled "Key"
4. Next, go to the "Value" box, and write 'disable' if you want Post Teaser to ignore the post entirely, or 'showall' if you want Post Teaser to return the post in full
5. Click "Add Custom Field"

= Can I choose where a post is teasered, rather than having it calculated? =

Yes. You just write `<!--more-->` where you want it to be teasered, in the "traditional" WordPress style, and Post Teaser will do the rest.

= I've got a problem or question that isn't answered here. Can you help me please? =

Absolutely. Please use the [contact form](http://sandboxblogger.com/contact/ "contact me") on my website, and I will get back to you as soon as I can.

= Is this plugin available in other languages? =

Yes. To use a translated version, you need to obtain the language file for it. At this point it would be useful to read [Installing WordPress in Your Language](http://codex.wordpress.org/Installing_WordPress_in_Your_Language "Installing WordPress in Your Language") from the Codex. You will need an .mo file for Post Teaser that corresponds with the "WPLANG" setting in your wp-config.php file. Translations are listed below -- if a translation for your language is available, all you need to do is place it in the wp-content/plugins directory of your WordPress installation. If one is not available, and you also speak good English, please consider doing a translation yourself (see the next question).

The following translations are available:

* Dutch
	* [Belgium](http://svn.wp-plugins.org/post-teaser/trunk/translations/nl_BE/post-teaser-nl_BE.mo "Belgium")
	* [Netherlands, The](http://svn.wp-plugins.org/post-teaser/trunk/translations/nl_NL/post-teaser-nl_NL.mo "The Netherlands")
* English
	* Great Britain (en_GB) -- This is the default language for Post Teaser
* German
	* [Germany (de_DE)](http://svn.wp-plugins.org/post-teaser/trunk/translations/de_DE/post-teaser-de_DE.mo "German")
* Greek:
	* [Greek (el_GR)](http://svn.wp-plugins.org/post-teaser/trunk/translations/el_GR/post-teaser-el_GR.mo "Greek")
* Polish
	* [Poland (pl_PL)](http://svn.wp-plugins.org/post-teaser/trunk/translations/pl_PL/post-teaser-pl_PL.mo "Polish")

= Can I provide a translation? =

Of course! It will be very gratefully received. Please read [Translating WordPress](http://codex.wordpress.org/Translating_WordPress "Translating WordPress") first for background information on translating. Then obtain the latest [.pot file](http://svn.wp-plugins.org/post-teaser/trunk/post-teaser.pot ".pot file") and translate it. *There are some strings with a space in front -- please make sure you remember the space!* When you have a translation ready, please send the .po and .mo files to han at sandboxblogger dot com. If you have any questions, feel free to email me also. Thanks!