Article Pull - WordPress Plugin

Pull articles from other WordPress sites via REST API. Download articles with their featured images, categories, and tags, preview them before publishing to your WordPress site.

Description

Article Pull is a powerful WordPress plugin that allows you to easily import articles from other WordPress websites using the WordPress REST API. This plugin is perfect for:

• Content aggregation websites
• Multi-site content syndication
• Migrating content between WordPress installations
• Creating content backups from remote sites
• Building content curation platforms

Key Features

✅ Easy Article Import - Pull articles from any WordPress site with exposed REST API
✅ Featured Image Download - Automatically downloads and sets featured images
✅ Category Management - Auto-creates categories with matching names and slugs
✅ Tag Management - Auto-creates tags and assigns them to imported articles
✅ Smart Slug Management - Preserves original slugs, auto-generates unique slugs for conflicts
✅ Preview Before Publishing - Review articles in a temporary table before publishing
✅ Flexible Status - Choose post status (publish, draft, pending, private) for each article
✅ Automatic Import - Download all available articles automatically
✅ URL Replacement - Automatically updates internal links to match your WordPress site
✅ Chunked Processing - Efficient bulk save with progress indicators
✅ Real-time Progress - Auto-refresh table and progress tracking
✅ Clean Interface - Beautiful, user-friendly admin interface
✅ Safe Import - Prevents duplicate articles by checking slugs

Installation

Method 1: Manual Installation

1. Download the plugin ZIP file from the releases page
2. Log in to your WordPress admin panel
3. Navigate to Plugins > Add New
4. Click Upload Plugin button at the top
5. Choose the downloaded ZIP file and click Install Now
6. After installation, click Activate Plugin

Method 2: FTP Installation

1. Download and extract the plugin ZIP file
2. Upload the article-pull folder to your /wp-content/plugins/ directory using FTP
3. Log in to your WordPress admin panel
4. Navigate to Plugins and find "Article Pull"
5. Click Activate

Method 3: Git Clone

cd wp-content/plugins/
git clone https://github.com/teguh02/wordpress-article-pull.git article-pull

Then activate the plugin from the WordPress admin panel.

Usage

⚠️ Important Notice: Before downloading articles from any WordPress site, ensure you have proper permission from the site owner. This plugin is merely a tool to help automate the downloading process. You are responsible for complying with copyright laws and terms of service of the target websites.

Step 1: Access the Plugin

1. After activation, you'll see a new menu item "Article Pull" in your WordPress admin sidebar
2. Click on it to access the plugin interface

Step 2: Validate URL and Fetch Articles

1. Enter the WordPress URL of the site you want to pull articles from (e.g., https://example.com)
2. Click "Validate URL & Check REST API" to verify the site is accessible
3. Once validated, click "Download All Articles" button
4. Wait for the download process to complete (this will fetch all available articles automatically)
5. The table will auto-refresh every 5 seconds to show newly downloaded articles

Step 3: Review Articles

After downloading, you'll see a preview table with:

• Thumbnail - Featured image of the article
• Title - Article title and slug
• Category - Assigned categories
• Status - Dropdown to select post status (publish, draft, pending, private)
• Actions - Save or Delete buttons

Step 4: Save Articles

1. Review each article in the preview table
2. Select the desired post status from the dropdown
3. Click "Save to Posts" button to publish the article to your WordPress site
4. The article will be removed from preview after successful save

Requirements

• WordPress 5.0 or higher
• PHP 7.0 or higher
• WordPress REST API must be enabled on the source site
• allow_url_fopen or cURL enabled on your server

How It Works

REST API Endpoints Used

The plugin uses the following WordPress REST API endpoints:

1. Posts Endpoint: /wp-json/wp/v2/posts

   • Fetches posts with their metadata

2. Media Endpoint: /wp-json/wp/v2/media/{id}

   • Fetches featured image details

3. Categories Endpoint: /wp-json/wp/v2/categories?post={id}

   • Fetches categories assigned to a post

4. Tags Endpoint: /wp-json/wp/v2/tags?post={id}

   • Fetches tags assigned to a post

Data Handling

The plugin:

• Downloads articles to a temporary database table first
• Extracts title, content, excerpt, slug, date, and format
• Downloads featured images from the source site
• Auto-creates categories if they don't exist (matching name and slug)
• Auto-creates tags if they don't exist (matching name and slug)
• Maintains the same slug as the original article
• Prevents duplicate posts by checking if slug already exists

Security

• Uses WordPress nonces for AJAX security
• Checks user capabilities (manage_options, publish_posts)
• Sanitizes and validates all inputs
• Uses prepared statements for database queries

Database

The plugin creates a temporary table wp_article_pull_temp to store downloaded articles before publishing. This table includes:

• Article metadata (title, content, excerpt, slug)
• Featured image URL and ID
• Categories and tags (stored as JSON)
• Source information (source URL and ID)
• Post settings (status, format, date)

Frequently Asked Questions

Can I pull articles from any WordPress site?

Yes, as long as the WordPress REST API is accessible on that site. Most WordPress sites have the REST API enabled by default.

Will it download images?

Yes! The plugin automatically downloads featured images from the source site and uploads them to your media library.

What happens to categories and tags?

The plugin automatically creates categories and tags if they don't exist on your site. It maintains the same names and slugs as the original.

Can I edit articles before publishing?

Currently, articles are saved directly to your WordPress posts. You can set the status to "draft" to review and edit them before publishing.

Will it create duplicate posts?

No. The plugin checks if a post with the same slug already exists and prevents duplicate imports.

Can I delete downloaded articles?

Yes. You can delete articles from the preview table before saving them to your posts. Use the "Delete" button for individual articles or "Clear All" to remove all previewed articles.

Troubleshooting

Error: "Invalid response from remote server"

• Check if the WordPress URL is correct
• Verify that the REST API is enabled on the source site
• Try accessing {URL}/wp-json/wp/v2/posts directly in your browser

Images not downloading

• Check if your server has allow_url_fopen enabled
• Verify that your server can access the image URLs
• Check WordPress upload permissions

Categories/Tags not created

• Ensure you have proper permissions (manage_categories, manage_post_tags)
• Check for any slug conflicts with existing terms

Changelog

Version 1.0.0 (2025)

• Initial release
• Fetch articles from remote WordPress sites
• Download featured images
• Auto-create categories and tags
• Preview before publishing
• Batch import support
• Clean admin interface

Support

If you encounter any issues or have questions:

1. Check the FAQ section
2. Visit the GitHub Issues page
3. Submit a new issue with detailed information

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

This plugin is licensed under the GPL-2.0+ License. See the LICENSE file for details.

Credits

Author: Teguh Rijanandi
GitHub: @teguh02
Plugin URI: https://github.com/teguh02/wordpress-article-pull

Screenshots

Admin Interface

The main plugin page with fetch form and preview table.

Fetch Articles

Download articles from remote WordPress sites.

Preview Table

Review articles before publishing with thumbnail, title, and category information.

Save to Posts

Choose post status and save articles to your WordPress site.

---

Made with ❤️ for the WordPress community