=== Edit Flow Project ===
Contributors: batmoo, danielbachhuber
Donate link: http://copress.org/donate/
Tags: edit flow, workflow, editorial, newsroom, management, journalism, post status, custom status, notifications, email, comments, editorial comments 
Requires at least: 2.8
Tested up to: 2.8
Stable tag: 0.2

Plugin for WordPress to allow for better editorial workflow.

== Description ==

The overall goal of this plugin is to improve the WordPress Admin interface for a multi-user newsroom’s editorial workflow. 

There are a few key components to this project: 

* improving the meta data on top of posts to better reflect the information that needs to be recorded about an assignment;
* empowering newsrooms to manage more of their editorial workflow from within the WordPress admin; and
* building out a way to track all of this active meta data within the system as a way of visualizing content and priorities at a glance.

More details can be found on the Here's a link to [CoPress Wiki](http://www.copress.org/wiki/Edit_Flow_Project)

We welcome any and all feedback. Ideas are more awesome than money (okay, not always).

= Stage 1: Custom Post Statuses =

Enables users to create custom statuses for posts, and assign those to posts.

**Adding/Editing/Managing Custom Statuses**

* Upon activation, the plugin adds five default statuses ("Assigned", "Draft", "Pending Review", "Pitch", "Waiting for Feedback"). These can all be edited or deleted (with the exception of "Draft" and "Pending Review", which can only be deleted). Users can also add additional custom statuses. Overall, we tried to make this as flexible as possible, acknowledging the extreme diversity in workflows and requirements across different newsrooms.
* The "Add/Edit/Manage Custom Statuses" screen is reminiscent of the interface used to manage categories and tags. From a design stand-point, we tried to keep with standard WordPress interface conventions (to minimize the learning curve) and, similarly, make the plugin as less intrusive as possible.

**Assigning Custom Statuses to Posts**

* With custom statuses defined, they can now be assigned to posts. The plugin adds the custom statuses to the “Status” dropdown when editing a post (screenshot above). Additionally, given the likely frequency of use of this feature, the Status dropdown is made visible by default. The plugin also allows you to set a default status for new posts, which WordPress sets to "Draft" by default.

**Managing Posts**

* A new column is added to the Edit/Manage Posts screen that indicates the current status of the post. Additionally, the posts on this screen can be filtered by status, by clicking on the links at the top.
* To ease the management of content, a new column is added to the Edit/Manage Posts screen that indicates the current status of the posts displayed. Additionally, the posts on this screen can be filtered by status, by clicking on the links at the top.

**Dashboard Widget**

* As a small bonus, we threw in a small dashboard widget that gives you a quick glance of the state of currently unpublished content. As this was a last minute addition, it's minimal and largely unstyled, but something we'll clean up and build out more in the coming days.

= Stage 2: Post Metadata and Editorial Commenting =

**Post Metadata**

* We've added some basic fields to allow you to capture some additional data for each article.

** Quick Pitch **

* Similar to QuickPress, this dashboard widget allows users to create a new pitch for an article.

**Editorial Comments**

* Edit Flow now supports editorial comments. Discussions on posts/articles can now take place between editorial staff within the WordPress Administration interface. This can cutdown on long-winded back-and-forth email threads as all comments are conveniently displayed within the Edit Posts page and better facilitate online workflows. Threading is supported (assuming it's enabled on your install)

**Notifications**

* We've added basic email notification support. Email notifications are delivered when a post's status changes or an editorial comment is added to a post. Notifications are delivered to: 
** Post author and Administrators, by default;
** Any specified roles (under Edit Flow > settings); and
** Any users that comment on posts.

= Stage 3: To come =

**What to expect**

* We're looking at more enhanced notification support, additional dashboard widgets (editorial comments), and other goodies.

== Installation ==

This section describes how to install the plugin and get it working.

1. Extract the contents of the zip file into your `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Party.

== Other Notes ==

= Editorial Comments =

**Hiding comments from front-end**

Editorial comments are stored as regular comments but identified in the database as different from regular comments. This allows However, given limitation in WordPress, editorial comments will only be hidden as long as Edit Flow is activated. To ensure that editorial comments stay hidden if you chose to deactivate Edit Flow, please add the following code to your theme's functions.php file:

`
<?php
/* Function to filter out editorial comments from comments array. Used to hide editorial comments from front-end if the Edit Flow plugin is ever deactivated */
$active_plugins = get_option('active_plugins');
if ( !in_array( 'edit-flow/edit_flow.php' , $active_plugins ) ) {
	add_filter( 'comments_array', 'ef_filter_editorial_comments' );
	add_filter( 'get_comments_number', 'ef_filter_editorial_comments_count' );
	
	if(!function_exists('ef_filter_editorial_comments')) {
		add_filter( 'comments_array', 'ef_filter_editorial_comments' );
		function ef_filter_editorial_comments( $comments ) {
			// Only filter if viewing front-end
			if( !is_admin() ) {
				$count = 0;
				foreach($comments as $comment) {
					if($comment->comment_type == 'editorial-comment') {
						unset($comments[$count]);
					}
					$count++;
				}
			}
			return $comments;
		}
	}
	if(!function_exists('ef_filter_editorial_comments_count')) {
		function ef_filter_editorial_comments_count( $count ) {
			global $post;
			// Only filter if viewing front-end
			if( !is_admin() ) {
				// Get number of editorial comments
				$editorial_count = ef_get_editorial_comment_count($post->ID);
				$count = $count - $editorial_count;
			}
			return $count;
		}
	}
	if(!function_exists('ef_get_editorial_comment_count')) {
		function ef_get_editorial_comment_count( $id ) {
			global $wpdb; 
			$comment_count = $wpdb->get_var($wpdb->prepare("SELECT COUNT(*) FROM $wpdb->comments WHERE comment_post_ID = %d AND comment_type = %s", $id, 'editorial-comment'));
			if(!comment_count) $comment_count = 0;
			return $comment_count;
		}
	}
}
?>
`

**Threaded Commenting**

For replies to work properly, you need to enable threaded commenting in your blog's settings. Find it under **Settings > Discussion** and enable the setting called **Enable threaded (nested) comments**.


== Screenshots ==

1. The ability to Add, Edit, and Delete Custom Statuses
2. Custom Statuses are automatically added to Status dropdown on the Edit Post and Quick Edit Post screens
3. A new column is added to the Edit Posts screen and the ability to filter by status
4. Threaded editorial commenting and additional metadata for posts

== Changelog ==

= 0.2 =
* Custom Statuses are now supported for pages
* Editorial Comments (with threading)
* Email Notifications (on post status change and editorial comment)
* Additional Post metadata 
* Quick Pitch Dashboard widget
* Bug fix: sorting issue on Manage Posts page (Mad props to David Smith from Columbia U.)
* Other bug fixes
* Better localization support

= 0.1.5 =
* Ability to assign custom statuses to posts

== Frequently Asked Questions ==

= When is the expected final completion date of this project? =

This project will never end. Though, we hope to release pieces of the plugin throughout the summer of 2009 and into fall 2009.