Revision e52f60fd2273ee15ccd4ea964d14d93c8ad406a7 authored by Aram Zucker-Scharff on 20 June 2016, 06:47:08 UTC, committed by Aram Zucker-Scharff on 20 June 2016, 06:47:08 UTC
Bringing forward-of-master improvements to PF to the recore.
readme.txt
=== 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.4.0
Stable tag: 3.9.0
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.8 =
* A new option in preferences allows site administrators to change the location of the source link from the bottom of the post to the top.
* Restored “Send to Draft” functionality in All Content.
* List view now has a white background to conform to accessibility standards.
* Fixed a bug where the RSS-Quick add methodology would fail upon upload of an OPML that includes broken links.
* Fixed a bug where the “Nominate This” bookmarklet failed when nominating the same article twice.
* Fixed a user permissions error which prevented Author level contributors from adding a feed (when the Feeder menu preference was changed to allow author access).
* Fixed a bug where the “Nominate” button appeared as “Submit for Review” for contributors in the Bookmarklet.
* Ensured that feeds in OPMLs will have their title retrieved after submission.
* Made adjustments to ensure that Gothamist and Medium articles can be nominated via the Nominate This bookmarklet
* Changed quick edit post statuses to feed statuses in Subscribed Feeds.
= 3.7 =
* Administrators and Contributors can now submit a feed through the Nominate This bookmarklet. Feeds are drafted and appear in yellow as “Under Review” in subscribed feeds.
* Created a template tag that can be added to a theme’s post template to reveal any internal PressForward comments on an item.
* Added a “Filter by Drafted” option to both All Content and Nominated.
* Added the ability to filter by unread items in All Content.
* Individual feeds can now be manually refreshed in Subscribed Feeds.
* The Site Redirect preference can now be overridden on a post by post basis in the Edit Post page.
* Created a “Clean Up” button to trigger the deletion process of old feed items.
* Leveraging the Heartbeat API, a new Feed retrieval progress bar appears in the Tools menu and indicates where PressForward is in the feed retrieval process.
* New column in Subscribed Feeds displays the total number of items retrieved from each feed.
* The feed url is now displayed in the Subscribed Feeds list.
* Alerted feeds now display the error message beneath the feed title in Subscribed Feeds.
* A count of alerted feeds now displays next to the Subscribed Feeds menu item.
* Alerted and pending feeds are now colored either red (alerted) or yellow (under review) in Subscribed feeds rather than appearing hidden.
* Added an option to set Press Forward’s feed reader to ignore all alerts and never make the feed inactive.
* Added an “Edit feed” link to the success and failure messages in Add Feeds.
* Adjusted transient feed ids to prevent problems with adding, removing, and reading OPML files.
* The archive action in Nominated is now a site wide action while the hide action in All Content is user specific.
* Archived items can now be unarchived.
* Fixed bug where the Refresh button wasn’t showing responses outside of Debug mode.
* Fixed a bug that caused the info box to remain open once the user has clicked out.
* Fixed a bug where the scroll location would reset when opening the comments dialog box.
* Fixed bug where the source link was sporadically generated for posts nominated or drafted using Nominate This!
* Nominate This now generates an error message rather than failing when no HTML is found.
* Nominate This button styling updated.
* Source link is now properly attached to Nominate This nominations.
* Fixed a bug where Send to Draft wasn’t working on some items.
= 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)
![swh spinner](/static/img/swh-spinner.gif)
Computing file changes ...