# FetchWire
Fetch and display news from any WordPress site using a powerful, highly customizable Elementor widget.

## Screenshots
![The FetchWire widget displayed in Elementor](./.wordpress-org/1.png)
![The FetchWire feed displayed on the frontend](./.wordpress-org/2.png)

FetchWire is the ultimate solution for website owners who want to aggregate and display content from other WordPress-powered sites seamlessly. Whether you're managing a university portal, a corporate news hub, or a niche blog network, FetchWire gives you the tools to pull the latest posts from any WordPress REST API source and present them beautifully on your own site.

Built specifically for Elementor, FetchWire provides a custom widget that eliminates the need for complex RSS feeds or manual content updates. Simply enter a source URL, and FetchWire handles the rest — fetching titles, featured images, excerpts, and dates in real time.

## Key Features

Transform your site into a dynamic content hub with FetchWire—the simplest way to connect and share WordPress news.

* Grid layouts: 1–4 columns.
* Force image aspect ratios (16:9, 4:3, square).
* Filter by category or tag ID.
* Adjustable excerpt length.
* Adjustable caching window (15 minutes to 24 hours).
* Clean, developer-friendly code.

See the [upcoming roadmap](#upcoming-features) for planned features and improvements.

# Installation & Usage

## From your WordPress dashboard

1. Visit 'Plugins > Add New'
2. Search for 'FetchWire'
3. Activate FetchWire from your Plugins page.

## From WordPress.org

1. Download the [FetchWire plugin](https://wordpress.org/plugins/fetchwire/).
2. Upload the 'fetchwire' directory to your '/wp-content/plugins/' directory, using your favorite method (ftp, sftp, scp, etc...)
3. Activate FetchWire from your Plugins page.

## Once Activated
* Add a source URL + style your grid via the Elementor FetchWire widget.

## Upcoming features
- [ ] Add a Gutenberg Block.
- [ ] Support is coming in a future update. 
- [ ] Clear cached news manually?

## Contribute/Issues/Feedback
If you have any feedback, just write an issue. Or fork the code and submit a PR [on Github](https://github.com/fetch/fetch-wire).

## Changelog

### 1.0.1
- [x] Bug: Fix the color control for titles.
- [x] Fix: Move the layout items to Style tab.
- [x] Add: Add date text typography and color controls.
- [x] Add: Improve the error message when the source URL is invalid.
- [x] Add: Improve code quality and documentation.
- [x] Test: Tested up to WP 6.9 and Elementor 3.35.0.

### 1.0.0
- First public release 🎉
