﻿=== Plugin Name ===
Contributors: FeedsPress
Tags: inline,embed,rss,feed,reader,feed reader,page,rss import,rss include,simplepie,inline rss,rss feed,feed reader,rss reader,inline feed reader,embed feed,inline rss feed
Requires at least: 2.8
Tested up to: 5.4.1
Stable tag: trunk

FeedsPress embeds and displays RSS feeds inline on your pages or widgets using Shortcodes.

== Description ==

FeedsPress allows you to embed and display an RSS feed inline on your pages or widgets
by adding a Shortcode.  Usage is easy, just use the following shortcode:

[feedspress url="https://www.feedspress.com/"]

= Features =

* Uses WordPress Shortcodes to embed RSS feeds on any page or widget
* Has a variety of parameters to filter and format the feed
* Relies on WordPress built-in SimplePie for processing RSS data
* Fixes characters in URLs that may get mangled when editing in Visual mode
* Caches feeds and allows configuration of the cache expiration
* Outputs clean, HTML for easy styling with a CSS configuration setting
* Allows you to customize the HTML using templates
* Allows filtering of items in the RSS feed based on keywords
* Allows feed pagination
* Can create "local" seo friendly links to filter rss feed content  (ie www.feedspress.com/feed/feeditem)

== Installation ==

Automatic Installation:

1. Go to Admin - Plugins - Add New and search for "feedspress"
2. Click the Install Button
3. Click 'Activate'

Manual Installation:

1. Download feedspress.zip (or use the WordPress "Add New Plugin" feature)
2. Unzip and upload 'feedspress' folder to your '/wp-content/plugins/' directory
3. To support caching, ensure the directory 'wp-content/cache' exists and is writable.
4. Activate the plugin through the 'Plugins' menu in WordPress

== Screenshots ==

1. FeedsPress hungry for RSS feeds!
2. FeedsPress editor button assists you with the Shortcode for your page or post
3. The RSS feed is pulled, cached and displayed inline

== Frequently Asked Questions ==

= What is FeedsPress? =

FeedsPress is a plugin that includes an RSS feed within the content of a page or widget

= 1. The main title and/or description of the feed is displaying, how can I hide that? =

To hide the feed title you can use the feed_items parameter to specify which feed fields you wish to appear like so: feed_items="".  You can use the FeedsPress editor button to help build your shortcode using a GUI.

= 2. I keep getting the verysimple.com feed instead of my own, what's the problem? =

The verysimple feed is used as the default value if no URL is provided, or WordPress can't read the URL parameter due to either a syntax error in the shortcode, or a special character in the feed url.  Here are some known causes:

* Using curly quotes instead of straight quotes (ie ” vs  ")  See http://en.wikipedia.org/wiki/Quotation_mark_glyphs
* Certain special characters in the feed url must be url encoded.  Here are some known characters and their replacement:  "=%22 [=%5B  ]=%5D  (see http://www.w3schools.com/tags/ref_urlencode.asp)
* Copy/pasting the URL into the shortcode will sometimes create HTML instead of plain text.  Use the WordPress editor's HTML View to view the raw HTML source code of your post and make sure the URL parameter is plain text and not HTML code

= 3. I'm getting the error that wp-content/cache/ does not exist or is not writeable, what is wrong? =

In order to use caching, you must have a folder in wp-content called "cache" which is writable by the web server.

To do this, first reate an empty folder in /wp-content/ called "cache" if it does not already exist.
Next set permissions of /wp-content/cache/ to 755 or 777 (as necessary on your particular server).
Finally, open /wp.config.php and insert the following code anywhere below existing definitions:
define('ENABLE_CACHE', TRUE);

If you are not able to do create this folder, you can optionally go to Settings->FeedsPress and set the Cache Duration to 0.
However, it is strongly recommended that you do have this directory to enable caching because otherwise Wordpress will make a
new request to the RSS content provider every time any visitor views your page.  This makes your site slower because it
has to retrive the RSS content every time.  It could also be considered bad etiquette to continually hit your
content provider's feed.

= 4. How do I put double quotes into a feed url? =

To put double-quotes into a feed url, enter %22 instead of the double-quote.  This is necessary because the url parameter in the Shortcode is already double-quoted and so you have to use some other character.

= 5. FeedsPress won't read my feed, what do I do? =

First, enter the feed URL in your browser and see if it displays correctly.  If the feed appears to be valid, you may try using some of the debug parameters to investigate.  If you still cannot figure out the problem, you can submit a ticket for support (See the Technical Support section above)

= 6. How can I get a feed to appear in a sidebar widget? =

Shortcodes are not enabled in Widgets by default.  However as of FeedsPress 1.3.9 there is an option to enable Shortcode processing in Widgets on the FeedsPress settings page.  Be aware that this will enable Shortcode for all plugins, not just FeedsPress.  WordPress currently does not support selectively enabling Shortcode for a single plugin, so it is an all-or-nothing option.

= 7. Where do I go for support? =

Documentation is available on the plugin homepage at http://wordpress.org/tags/feedspress and questions may be posted on the support forum at http://wordpress.org/tags/feedspress

== Upgrade Notice ==

== Changelog ==

= 1.6.50 =
* Compatibility support up to PHP 8. Updated phpQuery-onefile and Mustache files to be compatible to PHP 8.4

= 1.6.49 =
* added ".typeform.com" to the DEFAULT_WHITELIST_URL

= 1.6.48 =
* {{image}} now honors wrap_image_with_link and change_to_local_link

= 1.6.47 =
* Change the default content of Template 4
* Add "Revert All" to revert all Default Templates to its default content

= 1.6.46 =
* Compatibility support up to PHP 8

= 1.6.45 =
* Added default value for Whitelist Urls settings and it can be reverted back to default values

= 1.6.44 =
* Added new attribute "change_to_permalink" that controls the output of {{local_link}} token. It can now be set to feed item's permalink value.
* Added some helpful text description on the RSS settings

= 1.6.43 =
* Added new feature which allows Feedspress to insert Attachment into Rss Feed items

= 1.6.42 =
* When link_target="" is present in the shortcode it will add "target=" attribute to the entire links

= 1.6.41 =
* Added {{target_code}} token for adding "target=""" text
* Added {{target_code}} to the links of default templates

= 1.6.40 =
* Added "d-block" class to the first element with "row" class

= 1.6.39 =
* Added showing of image's alt text in a span

= 1.6.38 =
* Public CSS changes

= 1.6.37 =
* Public CSS changes

= 1.6.36 =
* Added new feature which allows Feedspress to insert image into Rss Feed items

= 1.6.35 =
* style sheet updated
* new html to default template 1
* Added template 10 (future use)
* Fix for new template 9

= 1.6.34 =
* Added template 9 to support ads

= 1.6.33 =
* Added “revert” to default template
* Added "Redirect to a page" if there is a FeedsPress error
* Clean up Admin Setting Page by moving Tabs on its own PHP file

= 1.6.32 =
* Fixed default templates not saved to DB when plugin is activated

= 1.6.31 =
* Admin page updates
* Public CSS changes

= 1.6.30 =
* Public CSS changes

= 1.6.29 =
* Added option to load FeedsPress default styles or rely on current theme for styling.
* Removed Custom CSS option

= 1.6.28 =
* Fixed encoding issue with SimplePie and DomDocument
* New FeedsPress Settings page look and feel
* Fixed description not truncating when truncate_description is set to 1

= 1.6.27 =
* New Feedspress Settings UI page
* Fixed bug where each Feedspress items are echoing <!DOCTYPE>

= 1.6.26 =
* Fix for notifications on latest php version and WP version(5.7)
* Reverted changes from 1.6.24

= 1.6.25 =
* Fix for blocking ALL wp-admin/admin-post.php POSTS

= 1.6.24 =
* Fix for notifications on latest php version and WP version(5.7)
* removed LIBXML_HTML_NOIMPLIED and LIBXML_HTML_NODEFDTD
* Fix for notifications when there is paging

= 1.6.23 =
* Fix for notifications on latest php version and WP version(5.7)

= 1.6.22 =
* Major refactoring

= 1.6.21 =
* Fixed getting of feed item's url.

= 1.6.20 =
* Added image_size parameter for controlling the image's src by choosing one of the values in the srcset attribute.
* Added Image Size drop down and Wrap images with link radio button in the FP's Tiny MCE Dialog
* Some minor fixes in the FP's Tiny MCE Dialog

= 1.6.19 =
* Added parameters usage or documentation in the Settings page.

= 1.6.18 =
* fixed Settings Page Custom Htmls bug
* added new FP shortcode setting wrap_image_with_link for wrapping images with feed's source link
* if truncate_description_to_link = true and change_to_local_link = false then "Read more" will now use the feed's source link

= 1.6.17 =
* fixed truncate suffix with link bug

= 1.6.16 =
* changing of whitelist urls thru the settings page.

= 1.6.15 =
* added whitelist url settings in the setting page for the script tag.

= 1.6.14 =
* support for script tag if enable_objects is enabled; only works for hard coded url (Youtube, Twitter, Facebook, Vimeo)

= 1.6.13 =
* increased default custom templates to 8

= 1.6.12 =
* support for "1" equals to "true" and "0" equals to "false" for yes/no or true/false settings

= 1.6.11 =
* add support to enable object, param, embed, and iframe tags

= 1.6.10 =
* add better support for multiple feeds per page.  remove filter if feed doesn't contain filter item.

= 1.6.9 =
* able to purge all cache files in the cache folder

= 1.6.8 =
* able to control truncated suffix and size
* added {{image}} field/token
* added "Truncate Description Suffix" and "Convert Suffix to Link" to FP dialog box

= 1.6.7 =
* reverted back on using filters for checking of detail page

= 1.6.6 =
* removed checking of details page using filter.
* used new querysting(link_path) for storing detail's page link
* fixed links when website is not using permalinks

= 1.6.5 =
* supports images in feed
* "local" linking to feedspress post
* settings to not attributes and not add source base uri to relative links
* many more changes....

= 1.6.4 =
* changed to FeedsPress

= 1.6.3 =
* add support for "content" in item fields and templates for feeds that include full post contents

= 1.6.2 =
* attempt to create cache directory if it doesn't exist

= 1.6.1 =
* better error reporting when cache directory doens't exist
* added codes to pass brackets or quotes in a short code #91; #93; and #34;

= 1.6.0 =
* supress notice on systems when rss feed has no source

= 1.5.9 =
* fixed bug where templates containing html are htmlescaped

= 1.5.8 =
* parameters in shortcodes are passed through to the templates

= 1.5.7 =
* templates now use Mustache template engine
* added ability to enable shortcodes in templates
* added field for custom javascript
* added index_#, feed_title and feed_description template tags

= 1.5.6 =
* added order="none" parameter to not sort feed items

= 1.5.5 =
* fixed incorrect item count when using filter and max_items together

= 1.5.4 =
* further adjustments to error reporting

= 1.5.3 =
* improved error reporting in combination with other plugins

= 1.5.2 =
* added additional info to error checking for easier debugging

= 1.5.1 =
* added setting to customize the error output

= 1.5.0 =
* error message is displayed if data expression contains illegal characters

= 1.4.9 =
* fixed bug with "price" being displayed

= 1.4.8 =
* added ability to pull any field using the "data" variable in the template to pull in raw feed data
* added option in the shortcode wizard for "show_data" to view the raw feed data

= 1.4.7 =
* fixed bug with feeds that have no category

= 1.4.6 =
* added a button to the post/page editor to provide a GUI for creating shortcodes
* added index tag to be used in templates
* category tag in template now displays comma-delimited list if there are multiple categories

= 1.4.5 =
* added filter_out parameter to exclude items with certain keywords

= 1.4.4 =
* added order parameter to allow reverse or random order

= 1.4.3 =
* description can now be truncated using truncate_description parameter

= 1.4.2 =
* description can now be truncated using truncate_description parameter

= 1.4.1 =
* multiple filter words can now be specified, separated by a pipe | char
* Added attr selector in order to get attributes of selected elements, such as an image src
* added additional properties to the feed: soure, enclosure, id, category
* updated settings page with documentation

= 1.4.0 =
* Added feature to templates for transforming the RSS description field using phpquery selectors
* Filter parameter is now case-insensitive

= 1.3.9 =
* Added option to enable shortcodes in widgets

= 1.3.8 =
* HOTFIX pagination re-enabled

= 1.3.7 =
* HOTFIX disabled pagination feature while investing problem with permalinks

= 1.3.6 =
* Added page_size parameter for pagination (beta) and link_target for target in feed links

= 1.3.6 =
* Added page_size parameter for pagination (beta) and link_target for target in feed links

= 1.3.5 =
* Added filter parameter to include only items containing specified text

= 1.3.4 =
* Added feature for stripping ellipsis from rss description using parameter strip_ellipsis

= 1.3.3 =
* Added feature for stripping html from rss description using parameter allowed_tags

= 1.3.2 =
* Bug fix for unexpected T_OBJECT_OPERATOR

= 1.3.1 =
* Removed donation button and replaced it with a link to SmileTrain.  Happy Holidays!

= 1.3.0 =
* Added custom template settings that can be used to fully customize the output of the feed

= 1.2.1 =
* Fix to directory structure to make plugin work with wordpress installer

= 1.2.0 =
* Added parameter item_link_title to enable/disable the post title link
* Added parameter date_format to format the post date

= 1.1.0 =
* Improved feed reading when special characters get mangled by visual editor
* Improved error reporting when feeds cannot be read
* Awesome hungry monster logo added

= 1.0.0 =
*  Initial Release