Introduction

News Hunt is a Laravel-powered news aggregation platform that syncs content from multiple RSS feeds, offering real-time updates across diverse categories. With a user-friendly interface, bookmarking, and sharing features, it delivers a seamless and engaging experience for staying informed.

What is News Hunt?

News Hunt is a powerful news aggregation platform built using the Laravel framework, designed to deliver a seamless and intuitive experience for news enthusiasts. The platform aggregates news from multiple trusted sources using RSS feeds, providing users with real-time updates and a diverse range of content, all in one place.

At the heart of News Hunt is user engagement. Visitors can explore news across categories, bookmark their favorite stories, and share them with others, fostering a connected and informed community. With its clean and organized interface, News Hunt ensures that users can easily discover and consume news that matters to them.

The platform also features a robust categorization system, enabling users to filter news based on their interests, such as politics, sports, entertainment, technology, and more. Advanced search and sorting options make it even easier to find specific stories.

Built on Laravel, News Hunt leverages a scalable and secure backend architecture, ensuring a smooth and efficient experience for users. Laravel’s robust features support a fast and flexible development process, enabling timely updates and feature enhancements. News Hunt aims to be the go-to destination for staying informed, offering a dynamic, interactive, and user-friendly environment for exploring the news world.
Now let's move on with Installation.

How news render in index page ?

Banner News Section ?

This news take by publish date of new which arrive from the rssfeeds. And there is also one more condition if you news does not contain image it will not show in banner section it take from where image is availabl if it is old news it will show.

Popular News Section ?

This Section contains news from the last 7 days most read news and then it show according to it's publish date.

Recomandation News Section ?

This sectiton is show news base on publish date latest new will show there. and also if news does not contain image news will not render here. after that it will take latest news which hase image.

Installation

Go to database in your cPanel

Enter database name and Create a new database.

Create Database user.

Assign Database to the user.

Open File manager now.

Go to public_html or public_html/your-news-hunt.com folder in the file manager, whichever folder your domain points to.

Upload the downloaded zip in public_html or public_html/your-news-hunt.com folder.

unzip or extract the Code vX.X - upload this on server.zip file that you have just uploaded.

verify that all these files are in public_html or public_html/your-news-hunt.com folder.

Before installation, make sure the symlink is enabled and the server is running.
visit http://your-news-hunt.com/install

After following the above steps you have successfully created a Database, User for the Database, and uploaded Ready to Install files. Kindly gather that database information and fill in the form as suggested.

Database Hostname : Enter the hostname.
Database Username : Enter the username that have access to the database.
Database Password : Enter the password.
Database Name : Enter the name of database.
Admin Mobile : Enter the mobile number (The mobile number will be used further for user authentication)
Admin Password : Enter the password number(The password will be used further for user authentication)

Now click Install. Thats it! You are ready to run your App : http://your-news-hunt.com/

nav-item

Configure News Hunt

Note

In order to Configure News Hunt you must have Admin Account.

Use the given guide to configure and customize News Hunt as you need.

Enter Admin Login id and Password. Click Login

Great! You have logged in as Admin.

Follow the steps given below to customize News Hunt.

General Settings

All the General Settings like Company Title, Support Name, Support Email, favicon, Half Logo, Currency Symbol, TimeZone, Phone, Site Colors, Address, Description, Copyright Details, And Support Hours. Just go to Settings -> General.

Payment Gateway Settings

Set up Stripe and Razorpay by entering API keys.
Stripe: Add Publishable Key and Secret Key.
Razorpay: Add Key ID and Key Secret.
Enable the gateway after saving to start accepting payments.

In-App Purchase Setup Guide

Create In-App Purchase Key in App Store Connect
- Navigate to Users and Access → Integrations tab
- Select In-App Purchase from the sidebar
- Click on the + button to generate a new key
- Enter a name for your key (e.g., "membershipkeys")
- Click Generate to create the key
- Copy the generated Key ID and Issuer ID
Setup Auto-Renewable Subscriptions
- Go to your app in App Store Connect
- Navigate to Distribution → Subscriptions
- Create Subscription Groups to organize your subscriptions
- Users can only subscribe to one subscription in a group at a time
- Set up Billing Grace Period for failed payments
Generate In-App Purchase Key
- In the In-App Purchase section, click the + button to add a new key
- A modal dialog "Generate In-App Purchase Key" will appear
- Enter a descriptive Name for your key in the text field
- The name should be meaningful (e.g., "ProductionKey", "DevelopmentKey")
- Click Generate button to create the key
- Click Cancel if you want to abort the process
Create Subscription Group
- Click on + button next to Subscription Groups
- Check "I understand, create additional subscription group"
- Click Next to proceed
- This prevents users from accidentally purchasing multiple subscriptions
Add Individual Subscriptions
- Within your Membership Plan group, click the + button
- Fill in the Reference Name (internal identifier)
- Add the Product ID (matches your app's product identifier)
- Select subscription duration (1 week, 1 month, 2 months, 3 months, 6 months, 1 year)
- Click Create to save the subscription
Configure Subscription Details
- Set the Reference Name (e.g., "Premium_Plan")
- Configure Product ID (e.g., "premium_one_month")
- Select appropriate Duration from dropdown
- Set Group Reference Name (e.g., "Membership Plan")
- Configure availability for all countries or specific regions
Set Regional Availability
- Choose All countries or regions selected for global availability
- Or select specific countries from the list
- Configure pricing for different regions
- United States and Canada, Europe (42 countries), and other regions
- Click Done after selecting regions
Add Review Information
- Upload a Screenshot showing the subscription purchase flow
- Add Review Notes explaining the subscription functionality
- Include details about what premium features are unlocked
- Explain the subscription benefits clearly for App Review
Configure Localization Settings
- Click the + button in the Localization section
- Select your target Localization from dropdown (e.g., Arabic, English (Canada))
- Enter the Display Name with maximum 30 characters
- Add Description with maximum 45 characters limit
- Click Add to save the localization
- Click Cancel to abort the localization process
Set Subscription Prices
- Navigate to Subscription Prices section
- Click the + button to add pricing tiers
- Review Current Pricing for New Subscribers
- Use View all Subscription Pricing to see comprehensive pricing
- Configure pricing for different regions and currencies
- Set prices based on your market strategy and competitor analysis
Submit Premium Plan for Review
- Ensure your Premium_Plan subscription is properly configured
- Click Save button to preserve all settings
- Note that your first subscription must be submitted with a new app version
- Create your subscription, then select it from the app's In-App Purchases section
- Submit the version to App Review before the subscription becomes active
- Once binary is uploaded and first subscription submitted, additional subscriptions can be added

Basic Company Setup

This section allows the admin to configure basic company details such as the company name, email, contact numbers, and address.

Logo Management and Weather API Key Setting

This section allows the admin to manage branding, weather integration, and fallback media. Admins can upload various logos for Firebase, Sidebar, Light Theme, and Dark Theme to ensure consistent visual identity across the platform. The "News Label" field lets admins set a custom label used across the front end for news branding.
A Weather API Key (from OpenWeatherMap) can be added to enable real-time weather display throughout the site.
In the Default Images section, admins can upload fallback images that appear when no specific image is available for posts or e-newspapers. The "E-Newspaper Image" acts as a placeholder for digital papers, and the "E-Newspaper Title" can be customized for front-end display.

Subscription Model and Header/Footer Script Setting

This section allows the admin to configure the subscription popup and manage global scripts. Admins can set the subscription modal title, subtitle, image, and toggle its visibility. Additionally, they can add custom header and footer scripts.

Social Links & Other Settings

This section enables the admin to manage social media links and other settings. Admins can input URLs for Instagram, Twitter, Facebook, LinkedIn, and Pinterest, as well as configure app store links, Android/iOS schemes, post deletion schedules, maintenance mode, and free trial limits.

SMTP Mail Configuration

This section allows the admin to configure SMTP mail settings. Admins can set the mailer type, host, port, username, password, encryption, from address, and from name to manage email communications effectively.

Languages

This section allows the admin to translate the complete admin panel according to added languages and their label values, along with the option to add new languages.

System Update

This section is for dragging and dropping a new version's ZIP file, allowing the admin to upload the latest version's ZIP file whenever a new version is released, thereby adding all the latest features.

Cron job

What is cron job

A cron job is a scheduled task that runs a piece of code at a set interval.
We are use this to fetch rss feeds according to our scheduled.
for more detail visit in admin panel.

Terms And Conditions

Configure Terms And Conditions settings. Just go to Settings -> Terms and Conditions.

Enter all Terms and conditions under Terms and conditions section.

Privacy Policy

Configure Privacy Policy settings. Just go to Settings -> Privacy Policy.

Enter all Privacy Policy under Privacy Policy section.

About us

Configure About us settings. Just go to Settings -> About us.

Enter all About us under About us section.

Tabs

Informations about all tabs in News Hunt

Dashboard

Dashboard of the app to view app insights.

Webstories

Webstories List Page. Here you can create, edit, and delete stories.

Create a story topic and select a topic from the provided dropdown to categorize your story.
Add slides with a title, description, and images to make your story engaging and informative.
Arrange the slides in the correct order to ensure a smooth and logical storytelling flow.
Apply animations to the title, description, and images to enhance the visual experience.
Review the final story, make necessary adjustments, and publish it for your audience.

User

Users where you can see user list and Manage users.

Channels

Channels List Page. Here you can create, edit and delete channels.

Add Channels

When the news language mode is turned off , channels can be created without assigning a news language.

Add Channels

When the news language mode is turned on, channels can be created with assigning a news language.

Topics

Topics List Page. Here you can create, edit and delete Topics.

Add Topics

When the news language mode is turned off, topics can be created without assigning a news language.

Add Topics

When the news language mode is turned on, topics can be created with assigning a news language.

E-Newspaper and Magazines

E-Newspaper and Magazines List Page. Here you can create, edit and delete E-Newspaper and Magazines.

Add E-Newspaper and Magazines

RSS Feeds

RSS Feeds List. Where you can manage your rss feeds.
Here you can manually fetched feeds if you want.

Create Feeds

When the news language mode is turned off, rss feed can be created without assigning a news language.

Create Feeds

When the news language mode is turned on, rss feed can be created with assigning a news language.

Posts

Posts List Page. Here you can view the latest posts and apply filters as needed.
You can also create, edit, and delete posts from this page.
Users can create videos as posts as well.
When the news language mode is turned off, rss feed can be created without assigning a news language.
When the news language mode is turned on, rss feed can be created with assigning a news language.

Videos

Videos List Page. Here you can create, edit and delete Custom and Youtube videos.

Add Custom Videos

When the news language mode is turned off , Videos can be created without assigning a news language.

When the news language mode is turned on , Videos can be created with assigning a news language.

Add Channels

When the news language mode is turned on, channels can be created with assigning a news language.

Add Youtube Videos

When the news language mode is turned off , Videos can be created without assigning a news language.

When the news language mode is turned on , Videos can be created with assigning a news language.

Add Channels

When the news language mode is turned on, channels can be created with assigning a news language.

Reported comments

Reported Comments. Here you see reported comments and you can take action on it.

Notifications

You can view and delete existing notifications from the list.
Send manual notifications from the admin panel to all users or selected users individually.
The notification includes a title, message, and an optional image.
This system supports alert-style notifications only (no push notifications or deep linking).

Notifications Details Table

This page displays a list of all notifications sent by the admin.

Contact us

This page displays a list of all user-submitted contact queries from the front-end Contact Us form.

Contact Us Details

Clicking the eye icon in the Contact Us list opens a detailed modal view.

Subscribers

This section shows a list of all users who subscribed via the frontend popup.

Roles

The Role Management page displays a list of roles with their IDs, names, and action options for the NewsHunt admin interface.

Create Roles

The Create Role page allows the admin to define a new role by setting a name and selecting specific permissions.

Admin

The Admin page shows a list of administrators with their IDs, names, emails, statuses, and action options for management.

Create Admin

The Create Admin page enables the admin to add a new administrator by specifying a role, name, email, and password.

Membership

Create membership plans, edit plans, and delete plans as per your requirements.
Users can purchase a membership plan from the available options.

Subscription

View subscription details for the purchased membership plans.
Check active, expired, and upcoming subscriptions in the list.

Transaction

The Transactions page lists all transactions with details including ID, user, transaction ID, payment gateway, date, and action options.

Transaction Details

View transaction details related to a purchased membership plan.
Each transaction record includes payment gateway details, amount, and status.

Email Template

The Email Template page lists all Email Template.

Add Email Template

News Languages

Create different news languages to categorize your news content.
Edit or delete existing news languages as needed.
Important: First enable the "News Language" toggle in the settings before adding languages.

News Languages Settings

News Language Mode Off Behavior

If the News Language Mode is off, the admin cannot add new languages, and news languages will not be displayed on the website, but posts and videos in the default language set by the admin will be shown.

News Language Mode On with Inactive Language

If the News Language Mode is on and a particular language is inactive, posts and videos from active languages will be displayed. If all news languages are inactive when the mode is on, posts and videos from the default language will be shown instead.

News Language Mode On Behavior

If the News Language Mode is on, the admin can add new languages, and all new languages will be visible on the website.