mirror of
https://github.com/ONLYOFFICE/onlyoffice.github.io.git
synced 2026-02-10 18:05:06 +08:00
News Plugin
Overview
Search through millions of articles from multiple news sources using various news API providers. This plugin allows you to search for articles by keywords and browse top headlines by category and country, then open them directly in your browser.
The plugin supports multiple news API providers. Choose your preferred provider and get a free API key to start using the plugin.
Features
- Multiple Providers: Support for GNews and TheNewsAPI with easy provider switching
- Keyword Search: Search for articles using specific keywords or phrases
- Top Headlines: Browse top headlines by category (Business, Technology, Sports, etc.)
- Provider-Specific Options: Dynamic UI that adapts to each provider's capabilities
- Language Support: Support for multiple languages (English, Spanish, French, German, etc.)
- Advanced Settings: Sort by publication date or relevance, filter by domains (TheNewsAPI)
- Display Options: Choose what to display (available for GNews)
- Direct Access: Click any article to open it in a new browser tab
Supported Providers
GNews (gnews.io)
- 100 requests/day (free tier)
- Search in title, description, or content
- 60,000+ news sources
TheNewsAPI (thenewsapi.com)
- 150 requests/day (free tier)
- Filter by specific domains
- Locale-based filtering
How to use
- Choose Provider: Select your preferred news provider (GNews or TheNewsAPI)
- Get API Key: Register at your chosen provider's website and get your free API key
- Install Plugin: Open the plugin from the Plugins tab in ONLYOFFICE
- Setup: Enter your API key when prompted
- Search: Use the Search tab to find articles by keywords
- Headlines: Use the Top Headlines tab to browse news by category
- Open Articles: Click on any article to open it in your browser
Search Tab
- Enter keywords in the search field
- (GNews only) Choose what to display using the checkboxes (Title, Description, Content)
- Optionally configure advanced settings (language, sort order, domains for TheNewsAPI)
- Click "Find" to search
Top Headlines Tab
- Optionally enter keywords to filter headlines
- Select a category (General, Business, Technology, etc.)
- Select a country
- Click "Find" to get headlines
Requirements
- ONLYOFFICE Document Editor
- Internet connection
- Free API key from your chosen provider (gnews.io or thenewsapi.com)
Known Issues
- Requires internet connection to fetch articles
- API rate limits apply based on your provider's plan
- Some regions may have limited access to certain news sources
- Each provider requires its own API key
Support
For issues and feature requests, please contact the plugin developer.
Documentation
- ARCHITECTURE.md - Technical architecture and code organization
- PROVIDER_FEATURES.md - Detailed comparison of provider features and capabilities
- CHANGELOG.md - Version history and changes
API Information
This plugin supports multiple news API providers:
- GNews API - 100 requests/day free tier
- TheNewsAPI - 150 requests/day free tier
Please refer to each provider's documentation for API limits and terms of service.