Overview

The News Search Widget is designed to help users easily search and display the latest news articles on a specific topic from a reliable source using the NewsAPI. Users can input any search query (e.g., "bitcoin", "technology", "sports") into the search bar, and the widget will fetch relevant news articles from around the world. This widget is perfect for personal dashboards, websites, or applications that require real-time news updates.

Documentation

Features:

1. Search Functionality: Users can type keywords to fetch related news articles in real-time.
2. Detailed Article Display: Includes article title, description, image, author, and published date.
3. Responsive Design: Works seamlessly across different screen sizes, ensuring a consistent look on desktop and mobile devices.
4. Pagination: Supports pagination for navigating through multiple news articles efficiently.
5. Real-Time Data: Fetches news dynamically based on user search queries via the NewsAPI.

Limitations:

• API Rate Limits: The widget relies on NewsAPI, which may have rate limitations on free-tier usage.
• Content Gaps: Some articles may be missing images, author details, or descriptions depending on the API response.
• Dependency on External API: The performance and availability of the widget depend on the external NewsAPI.

Dependencies

This widget requires the following:

• NewsAPI: A valid API key is necessary for accessing news data. Users can register on the NewsAPI website (https://newsapi.org/docs/get-started) to obtain an API key.
• React (for custom widget): This widget is built using React, so React knowledge may be needed to extend or modify the component.
• Mendix 8 or higher: The widget is compatible with Mendix versions 8 and up.

Installation

To install the News Search Widget:

1. Download and Import: Download the widget from the Mendix Marketplace and import it into your Mendix project.
2. API Key Configuration: Add your NewsAPI key in the widget general settings.
3. Place Widget: Drag and drop the widget onto any page in your Mendix app, preferably where users can perform searches.
4. Configure Query: Optionally, set a default search query (like "technology" or "sports") to display articles on page load.

Configuration

1. API Key: The widget requires an API key to function. This can be configured in the widget’s settings in Mendix Studio Pro.
2. Search Query: The default search query can be pre-configured in the widget, and users can override it by typing in the search bar.