=== PressForward ===
Contributors: PressForward, AramZS, boonebgorges, lmrhody, asmmap, regan008, joanftroyano, clioweb
Donate link:
Tags: aggregate, aggregation, aggregator, atom, attribution, circulate, collect, community, content curation, curate, curation, curation tool, discuss, distribute, editorial, feed, network, news, opml, OPML, read, reader, reblog, reblogging, republish, review, RSS, rss, share, syndicate, syndication, workflow
Requires at least: 3.0.1
Tested up to: 4.2
Stable tag: 3.6.3
License: GPL2
License URI: http://www.gnu.org/licenses/old-licenses/gpl-2.0.html

PressForward provides an integrated workflow for curating content aggregated from the web.


== Description ==
PressForward is a free plugin that provides an editorial workflow for content aggregation and curation within the WordPress dashboard. It is designed for bloggers and editorial teams who wish to collect, discuss, and share content from a variety of sources on the open web.

**PressForward helps you:**

* Collect content from the web via a feed reader and a bookmarklet
* Discuss content through a collaborative editing interface
* Share content using best practices for attribution and citation

**Collect**

* Aggregate content using RSS/Atom feeds
* Capture any web content with a bookmarklet
* Import full text, image, video content, and post metadata
* Batch add feeds using OPML files
* Integrate standardized content with [Readability](https://www.readability.com/)

**Discuss**

* Discuss content internally with private commenting
* Count nominations from teams of contributors and editors
* Expose item metadata, including the name of the source and method of nomination

**Share**

* Allow contributors to send items directly to their own Twitter account
* Attach full content, attribution link, canonical URL, and metadata to WordPress Posts as Draft
* Republish any content type supported by your theme (text, image, quote, snippet, etc.)
* Optional auto-redirect back to original source
* Export an RSS feed that combines all content from site's feed list

Instructions for use are found in our [GitHub Wiki](https://github.com/PressForward/pressforward/wiki).

[See how we compare to other WordPress plugins](https://github.com/PressForward/pressforward/wiki/FAQ#how-does-pressforward-compare-to-other-plugins).

The PressForward Plugin is developed and maintained by the [Roy Rosenzweig Center for History and New Media](http://chnm.gmu.edu) at [George Mason University](http://gmu.edu) as part of the [PressForward Project](http://pressforward.org), generously funded by the Alfred P. Sloan Foundation. Our developers include [Aram Zucker-Scharff](http://aramzs.me), [Boone B. Gorges](http://boone.gorg.es), and [Jeremy Boggs](http://clioweb.org). PressForward is free to use and modify under a [GNU GPL2 license](http://www.gnu.org/licenses/old-licenses/gpl-2.0.html).

[Detailed information about our code](https://github.com/PressForward/pressforward/wiki/Devbook) can be found on our [GitHub Wiki](https://github.com/PressForward/pressforward/wiki/).

== Installation ==

Our [Five-Step Quick Start Guide](https://github.com/PressForward/pressforward/wiki/Quick-Start-Guide) can be found on our [GitHub Wiki](https://github.com/PressForward/pressforward/wiki/).

* Search the [WordPress Plugin Directory](http://wordpress.org/plugins/) and download the PressForward plugin; or
* Go to the [latest version on GitHub](https://github.com/PressForward/pressforward/tags).
1. Download the zip or tar.gz file of the most recent version
1. Rename zipped folder 'pressforward'
1. Place the ‘pressforward’ folder in your ‘/wp-content/plugins’ directory using your FTP client.
* Activate plugin via the "Installed Plugins" menu in the Wordpress Dashboard
* The PressForward menu should now appear in your Wordpress Dashboard. Clicking on the PressForward icon will display tabs.

A complete [User Manual](https://github.com/PressForward/pressforward/wiki/User-Manual) also is available on our [GitHub Wiki](https://github.com/PressForward/pressforward/wiki/).

== Frequently Asked Questions ==

A list of [FAQs](https://github.com/PressForward/pressforward/wiki/FAQ) can be found on our [GitHub Wiki](https://github.com/PressForward/pressforward/wiki/).

== Screenshots ==

1. Add RSS/Atom Feeds to automatically aggregate content.
2. Nominate This! Bookmarklet allows you to collect content from the web.
3. All Content Grid View provides title, source, snippet, and additional information for every item.
4. All Content List View provides title, source, snippet, and additional information for every item.
5. Toolbar on every item provides easy access to see additional information, star items, add a comment, or nominate an item, sending it to Nominated.
6. Reader View displays content in a comfortable reading environment, links to original source, and includes comments and the toolbar.
7. Internal discussion visible in threaded comments.
8. In Nominated the toolbar displays the number of comments and nominations, and provides ability to archive item or Send to Draft.
9. Send items to introduce, format, and publish in the WordPress Posts panel.

== Changelog ==
= 3.6 =
* Added the ability to subscribe to an OPML file.
* OPML subscription imports any folders included in the OPML file.
* Added preference field for minutes between feed retrieval cycles.
* Added an OPML file link to Tools menu. Allows administrators to share their subscription list as an OPML file.
* Added edit link to the success/fail message when a feed is added.
* Added an in browser screen that indicates loading when a large OPML is uploaded.
* Added Folders and sorting by folders and feeds to the "Nominated" panel.
* Layout enhancements to the Add Feeds and Tools panels.
* Added a subscribe to feed option in the Nominate This bookmarklet.
* Added an option for users to select what post type and status nominations take on when they are sent to the next step.
* Fixed bug where alerts weren't closed upon successful feed retrieval.
* Fixed bug causing "Nominated" usernames to repeat.
* 'Save Inactive' in the "Edit Feed" page no longer saves the feed as 'Pending'.
* When sorting by 'Last Time Feed Checked' results now include unchecked feeds.
* Fixed in-modal comments in Nominated panel.
* Fixed bug where the Open Graph image was not being pulled in through nomination process.
* Fixed bug related to insure PressForward properly hooks to the Yoast SEO plugin's Open Graph and Canonical values.
* Fixed bug where the author custom field was no longer overriding WordPress author.
* Fixed bug where clean-up of old posts after user-set period was not cleaning up posts.
= 3.5 =
* Now checks for known aggregation services to insure proper resolution of URLs.
* Created the Amplify dropdown button in the actions bar.
* Added button to share to Twitter to the Amplify dropdown.
* Added button to Amplify to send from All Content directly to draft.
* For clarity, changed Last Retrieved column title to Last Time Item Retrieved.
* Added OG URL tag to forwarded pages.
* Updated Readability script to detect Medium.
* Updated Readability script to retrieve pages using File Get Contents when no other methods work.
* Separated out a number of template functions into their own class.
* Attach the navbar on scroll.
* Moved Refresh button to Tools.
* Better assure that the system retrieves open graph images and sets them as Featured Images.
* Allows feed URLs to be changed via Quick Edit.
* Set up functions to better detect current page.
* Set up a debug function for displaying current page.
* If WordPress installs are greater than 4.0, all feeds not in folders will display under folders.
* Set default sort for Feeds to alphabetical.
* Set up breadcrumb titling for All Content and Nominated.
* Moved the source and byline to the head of the current article modal.
* Added help button to menu.
* Allows users to decide if they want the right menu displayed and turn it off by default.
* Allows users to set Grid or List and have the system remember it as a user preference.
* Allows users to set infinite scroll or pagination and have the system remember it as a user preference.
* Adds search to the nav menu on scroll-down.
* New tabbed settings page, with user access to tabs based on user roles.
* Allows administrators to control tab access with settings.
* Allows users to always access their settings regardless of level.
* Moved Nominate This to the Tools menu.
* Added Nominate This as a source for the Feeds menu.
* Added a Nominate This prompt for first-time users to the All Content menu.
* Allows administrators to control the display of comments based on user level.
* Open modal now counts as a hashed page state.
* Pressing the browser back button while viewing an open modal will close the modal, not go to the previous page.
* Compressed filtering options into a dropdown in the navbar.
* Opening a modal to read an item will now only set the item to Read, it will never unset the Read property.
* Added a column to the Feeds area to indicate last time the feed was retrieved.
* Allows feeds to be sorted by the last time they were retrieved.
* Fullscreen script patched to 1.2
* Flipped infobox to display over the action bar.
* No hidden items in modal navigation.
* The Folders sidebar now scrolls separately from the main page and is always fully available.
* Clarify what exactly dismissing alerts does. (It sets those feeds to Inactive.)
* Better descriptions of most settings.
* Fixed occasional content duplication on infinite scroll, when retrieval was active.
* Fixed a variety of user action responses so actions are clearer.

= 3.4.6 =
* Supports additional file path configurations for Nominate This.

= 3.4.5 =
* Nominate This now works much more optimally.
* Nominate This no longer creating crazy line breaks.
* OpenGraph image detection now working properly.
* Alert Box now more backwards compatible.
* Turned off modules no longer show turned on menus.
* Mark As Read now works properly.

= 3.4.4 =
* Resolved CSS overlay design conflicts.
* Fixed Nominate to Draft in the Nominated page.

= 3.4 =
* the "Nominate This" bookmarklet has moved to tools
* the "Under Review" panel has been renamed to Nominated
* refinements to sorting and filtering in the "All Content" and "Nominated" views
* the "Subscribed Feeds" panel now displays the time and date of the last update on a feed
* items can now be unnominated by clicking again on the green nominate button in All Content
* Administrators can now set the number of days to retain feed items
* users can choose to turn on pagination rather than infinite scroll
* feed alerts can now be deleted or dismissed
* items older than one week, two weeks, one month, or one year can now be archived in "Nominated"
* introduction of folders for feeds.  Individual feeds can be added to folders in the "Subscribed Feeds" panel.  Items in "All Content" can then be filtered by folder.
For more information on the changes see the GitHub summary for [3.4](https://github.com/PressForward/pressforward/issues?q=milestone%3A3.4.x)

= 3.3 =
* show hidden items on the "All Content" browse page
* upload OPML files in the "Add Feeds" panel
* return an item to the pre-readability state in the full screen mode
* provide option to turn off alerts and to change the retention time for feeds
* enhancements improve the speed of the plugin
* improvements to moving a nominated item's metadata into a draft
* improvements to the appearance of action buttons in list and grid view
* sets a limit to the number of times an indivdual user is able to nominate a single item
For more information see the GitHub summary for [3.2](https://github.com/PressForward/pressforward/issues?q=milestone%3A3.2)