https://github.com/wasasquatch/wp-rss-feeds

Aggregate multiple RSS feeds by using shortcode within your WordPress posts or content.
https://github.com/wasasquatch/wp-rss-feeds

php rss wordpress wordpress-shortcode

Last synced: 25 days ago
JSON representation

Aggregate multiple RSS feeds by using shortcode within your WordPress posts or content.

• Host: GitHub
• URL: https://github.com/wasasquatch/wp-rss-feeds
• Owner: WASasquatch
• License: gpl-3.0
• Created: 2021-08-30T22:36:57.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2021-09-04T00:56:05.000Z (over 3 years ago)
• Last Synced: 2024-11-18T11:24:59.759Z (3 months ago)
• Topics: php, rss, wordpress, wordpress-shortcode
• Language: PHP
• Homepage:
• Size: 66.4 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# wp-rss-feeds

Aggregate multiple RSS feeds by using shortcode within your WordPress posts or content. 

Basic example can be seen at https://nwdagroup.com/

**Please note:** this is in development software (and may remain in such a state indefinitely). Please do not install this on a WordPress installation if you *do not* have access to FTP or a file manager through cPanel. If a critical error occurs for any reason, you will not have access to WordPress Admin to fix the issue. 

# Requirements

- PHP 7.4+ required

- SimpleXML module (php-xml package) 

- WordPress 5.5+

# Installation

Upload the files to your theme directories base. 

Inside your themes functions.php, include wp-rss-feeds.php at the end of your file

```

// Inlcude WP RSS Feeds

include( get_template_directory() . '/wp-rss-feeds.php' );

```

# Usage

In your posts, or content you can call `[wp-rss-feeds feeds="URL"]` where `URL` is a list or single URL to a RSS feed.

The following is a list of attributes and their examples or defaults. Attributes denoted by ▫️ are optional.

| Attribute | Description | Default / Example |

| :---         |     :---:      |          ---: |

| `feeds`   | A RSS URL, or RSS URL list seperated by commas.     | `https://example.com/rss` or `https://example.com/rss,https://example2.com/rss`    |

| `entrylimit` ▫️    | RSS entries will be limited to this integer.       | `30`      |

| `charlimit` ▫️    | RSS description character limit, followed by read more link. `0` is no limit.       | `0`      |

| `fullcat` ▫️    | Display full category path `0` will only show current, or last category, `1` is full path.       | `0`      |

| `order` ▫️    | Order RSS entries by ascending, or descending. Default `0` is ascending, `1` is descending.       | `0`      |

| `target` ▫️    | The target all `` links should use. Default is `_blank`       | `_blank`      |

| `timeout` ▫️    | RSS cache timeout in hours       | `4`      |

| `timezone` ▫️    | The PHP compatible time zone ID to use with RSS entries publish date. Default is `server` which is the server's time zone.       | `America/New_York`      |

| `dateformat` ▫️    | PHP `DateTime` compatible date format.       | `D, dS F Y g:i:s A`      |

| `dofutureposts` ▫️    | If encountering RSS entries published in the future, discard or display them. Default is discard.       | `0`      |

| `fallback` ▫️    | Fallback to retrieving live feeds from feeds list. Default `false`       | `0`      |

| `tmp` ▫️    | Path to the directory to store RSS cache. Default is `get_temp_dir() . 'rss/'` in WordPress cache location.      | `/path/to/tmp/`     |


## Example

```

[wp-rss-feeds feeds="https://www.blender.org/feed/,http://pixologic.com/blog/feed/" charlimit="300"]

```