=== FunkyPress First Sentence Highlighter ===

Plugin Homepage Coming Soon!

Contents of this file:
1. readme.txt
2. fp_firstsentence.php (below)

Contributors: Joss Crowcroft
Donate link: http://www.funkypress.com/first-sentence-highlighter#donate
Tags: CSS, excerpt, content, formatting, highlight, page, post, style, template tag, text,
Requires at least: 2.0.2
Tested up to: 2.8.2
Stable tag: 1.0

Adds a new Template Tag that highlights the first sentence in a string with a specified CSS style. Works well with get_the_content().

== Description ==

The FunkyPress First Sentence Highlighter adds a new Template Tag **`fp_firstsentence( $str , $style , $br )`**, which highlights the first sentence in a string/content ($str) with a specified CSS style ($style) - for example: "font-size:14.5px;font-weight:bold;color:#990000;".

Works charmingly well with **`get_the_content()`** or **`get_the_excerpt()`** to add Newspaper-style emphasis on post content.

This beautifully simple function allows you to add emphasis to the first sentence of a post without actually specifying it in the post editor, thus the post will display as normal on its single page.

Places where this function comes in handy:

* To add emphasis to each entry in an archive list.
* To create a Newspaper/Magazine-style lead-in on a featured post on the front page.
* To highlight the first sentence of posts in a certain category (i.e. Featured) when browsing archives.
* So many more possible uses! See the screenshots and [Plugin Homepage](http://www.funkypress.com/first-sentence-highlighter/ "FunkyPress First Sentence Highlighter") for examples.

NB: By default, $br = 1, meaning that the function will preserve line/paragraph breaks in the content. You can optionally specify $br = 0 to have the function echo a block of text with no breaks.

Check out the screenshots for examples, and a live demo at the [Plugin Homepage](http://www.funkypress.com/first-sentence-highlighter/ "FunkyPress First Sentence Highlighter")

Much Love,

== Installation ==

1. Upload `fp_firstsentence.php` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Use `<?php fp_firstsentence( $str , $style , $br ); ?>` in your theme templates.

NB: The $style must be valid CSS, for example "font-size:14.5px;font-weight:bold;color:#990000;" or anything that you may have used in <span style=""> to style the text. 

$br is optional, and only needed if you are specifying false / 0.

== Frequently Asked Questions ==

= Got a question? =

Please get in touch!

= Got a suggestion? =

See above.

== Screenshots ==

1. Screenshots to be added by mid-August.

== Changelog ==

= 1.0 =
* Released as standalone plugin.

= 0.5 =
* Added $br option to echo text with preserved paragraph breaks.




==== fp_firstsentence.php ====




<?php
/*
Plugin Name: FP First Sentence Highlighter
Plugin URI: http://plugins.funkypress.com/first-sentence-highlighter/
Description: Adds new Template Tag 'fp_firstsentence ( $str , $style , $br )', which highlights the first sentence in any given content ($str) using a specified CSS style ($style). Works well with get_the_content(). Check out the readme for tricks and tips.
Tags: CSS, excerpt, content, formatting, highlight, page, post, style, template tag, text,
Version: 1.0
Author: Joss Crowcroft
Author URI: http://www.funkypress.com
*/
/* License Information:

	Copyright 2009  Joss Crowcroft & FunkyPress (email : joss@funkypress.com)

	This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. 
	This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
	To obtain a copy of the GNU General Public License, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
*/

/* AUTHOR REQUEST:
	You are free to do whatever you like with this code - however, if you are re-releasing this function with modifications or building on it for any other public-release purpose - or using it in your premium Wordpress Theme - please give credit in the // Comments with a link to FunkyPress.com. Let me know what you're doing with it and I'll even give you a backlink on the website. Much love, 
	Joss @ FunkyPress 
*/

function fp_firstsentence ($str, $style, $br = 1) {

	// $str = content;
	// $style = CSS styling for first sentence (e.g. "font-size:14.5px;font-weight:bold;")
	// $br = Add line breaks to new lines (default = true : if specified false = returns content as a block with no line breaks.)
 	// Like this function? Visit FunkyPress for more nice-lookin' Wordpress resources. Much love,

	$firstfullstop = stripos ( $str  , "." );

	$array = explode(".", $str, 2); //Split string into 2 chunks by first full stop (removes the stop)

	$str = '<span style="' . $style . '">' . $array[0] . '. </span>' . $array[1];

	if ( $br == true || $br == 1 ) { echo nl2br($str); }
	else { echo $str; }
}?>





==== END ====