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 ?

Popular News Section ?

Recomandation News Section ?

General Settings

All the General Settings like Company Title, Support Name, Support Email, favicon, Half Logo, Currency Symbol Address, Description. 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

1. 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
   
2. 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
   
3. 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
   
4. 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
   
5. 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
   
6. 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
   
7. 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
   
8. 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
   
9. 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
   
   
10. 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
11. 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
    

In-App Purchase Setup For Custom Ads

1. In-App Purchases Setup Guide
   • The In-App Purchases feature in App Store Connect requires your first purchase to be included with a new app version. Create the purchase, add it in the In-App Purchases and Subscriptions section on the version page, and submit it for review. After the first purchase is reviewed, you can add more purchases from this section. Check "Learn More" for details.
   
2. Create an In-App Purchase
   • This section in App Store Connect allows you to create an in-app purchase for customers to buy content, features, or services within your app via secure App Store payments. Steps for Users: Select Consumable as the Type from the dropdown. Enter a Reference Name (e.g., "Credit 10"). Input a unique Product ID (e.g., "credit10"). Set the Price (e.g., 55 or 91) based on your credit pack value. Click Create to finalize the in-app purchase. Use Cancel to discard changes.
   
3. App Availability Setup Screen
   • A screenshot showing an "Availability" section where users can set up in-app purchase availability by selecting countries or regions.
   
4. Country or Region Availability Settings
   • 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
   
5. Price Schedule Configuration
   • The image shows a "Price Schedule" section where users can set up a starting price for their App Store in-app purchases. The text indicates that the price determines the App Store price and user proceeds, and a Paid Application Agreement is required to sell in-app purchases. Options include an "Add Pricing" button and a "Learn More" link, with an "All Prices and Currencies" link on the right.
   
6. In-App Purchase Pricing Setup
   • The image shows an "In-App Purchase Pricing" section where users can choose India (INR) as the base country or region. Users set a base price (e.g., ₹29.00), with Apple adjusting prices for other regions based on tax or exchange rates, editable in the next step. Options include "Cancel" and "Next" buttons.s
   
7. Add App Store Localization Form
   • The image displays an "Add App Store Localization" dialog with a dropdown for Localization set to English (U.S.), a Display Name field filled as "Beginner Pack" (17 characters), a Description field filled as "This package will give you 10 credits." (shown with 6 characters, possibly truncated), and "Cancel" and "Create" buttons at the bottom.
   
8. Review Information Screen
   • The image shows a "Review Information" section with a "Screenshot" area displaying a "Starter Pack" card priced at ₹148.00 with a "Buy Now" button, and a blank "Review Notes" area on the right.
   

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

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

Terms And Conditions

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

1. Enter all Terms and conditions under Terms and conditions section.

Privacy Policy

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

1. Enter all Privacy Policy under Privacy Policy section.

About us

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

1. Enter all About us under About us section.

Custom Advertising Settings

1. The Custom Ads Feature Disable setting determines whether the admin wants to display this feature or keep it disabled. Below this, there is a status and price value for each placement, ensuring clarity on the daily price to be set per placement.

Sponsor Ads or Custom Ads Demonstration Video with Detailed Steps

Steps to Create Sponsor Ads (Start to End) :

1. Complete all settings related to Custom Ads.
   Go to: Custom Ads Settings
2. Fill out the Custom Ads form.
   After submitting the form, a request will be sent to the admin.
   Make sure you are logged in with admin credentials because only the admin can change the sponsor ad request status.
3. Approve the request.
   Once the admin approves the request status, the payment option will be displayed to the user.
4. Payment & Ad Display.
   After successful payment, the ad will be displayed automatically from the selected Start Date to End Date.

Sponsor Ads or Custom Ads Demonstration Video

Credit Packs

1. The Credit Packs feature under the settings is intended for use with custom ads, allowing administrators to create purchasable credit bundles. Any details added here, such as name, product ID, credits, and price, must also be added to App Store Connect accordingly to ensure they are properly implemented.

Dashboard

1. Dashboard of the app to view app insights.

Webstories

1. 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

1. Users where you can see user list and Manage users.

Channels

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

Add Channels

Note: When creating channels, please make sure that the news language has already been created.

Topics

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

Add Topics

Note: When creating topics, please make sure that the news language has already been created.

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

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

Supported RSS Feed Structures

Our system is designed to work with specific RSS feed formats. Please review the supported structures below to ensure your RSS feeds will work correctly with our platform.

✅ RSS Feed Formats We Support

The following RSS feed structures are fully compatible with our system:

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
  <channel>
    <title>Your News Channel</title>
    <link>https://yournewssite.com</link>
    <description>Latest news and updates</description>
    
    <item>
      <title>News Article Title</title>
      <link>https://yournewssite.com/article</link>
      <description>Article summary or excerpt</description>
      <pubDate>Mon, 23 Dec 2024 10:00:00 GMT</pubDate>
      
      <enclosure url="https://yournewssite.com/image.jpg" 
                 type="image/jpeg"/>
    </item>
    
  </channel>
</rss>

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
     xmlns:media="http://search.yahoo.com/mrss/"
     xmlns:yt="http://www.youtube.com/xml/schemas/2015">
  <channel>
    <title>Video News Channel</title>
    
    <item>
      <title>Video Title</title>
      <link>https://example.com/video</link>
      <description>Video description</description>
      <pubDate>Mon, 23 Dec 2024 15:30:00 GMT</pubDate>
      
      <!-- Thumbnail images -->
      <media:thumbnail url="https://example.com/thumb.jpg" 
                       width="1280" height="720"/>
      
      <!-- Video content -->
      <media:content url="https://youtube.com/v/VIDEO_ID" 
                     type="video/mpeg"/>
      
      <!-- For YouTube videos -->
      <yt:videoId>VIDEO_ID</yt:videoId>
      
    </item>
  </channel>
</rss>

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <title>News Feed</title>
  <link href="https://example.com"/>
  
  <entry>
    <title>Article Title</title>
    <link href="https://example.com/article"/>
    <id>unique-article-id</id>
    <published>2024-12-23T10:00:00Z</published>
    <summary>Article summary</summary>
  </entry>
  
</feed>

⚠️ Important Limitations

Common Feed URL Examples:

📊 Quick Reference: What Works and What Doesn't

Create Feeds

Note: When Rss Feeds, please make sure that the news language has already been created. Also, when you create a Rss Feeds for a specific news language, channels and topics for that news language must be available.

Posts

1. Posts List Page. Here you can view the latest posts and apply filters as needed.
2. You can also create, edit, and delete posts from this page.
3. Users can create videos as posts as well.
Note: When creating posts, please make sure that the news language has already been created. Also, when you create a post for a specific news language, channels and topics for that news language must be available.

Videos

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

Add Custom Videos

Note: When creating video posts, please make sure that the news language has already been created. Also, when you create a video post for a specific news language, channels for that news language must be available.

Add Youtube Videos

Note: When creating Youtube video posts, please make sure that the news language has already been created. Also, when you create a Youtube video post for a specific news language, channels for that news language must be available.

Reported comments

1. 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

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

Contact Us Details

1. 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

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

Create Roles

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

Admin

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

Create Admin

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

Membership

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

Subscription

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

Transaction

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

Transaction Details

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

Email Template

1. The Email Template page lists all Email Template.

Add Email Template

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.