Create News from Mobile App

Users can submit news directly from the app. To enable this feature, the administrator must grant permission to specific user roles.

Navigate to Top Stories > General > Allow Users to Post News and select the desired user roles.

Once enabled, users will see two menu options in the app: Create Post and Manage Post.

After a user publishes a news post, it will remain in a pending state. The administrator must manually change its status from pending to published for it to appear in the app.

RSS Feed

1. Enable RSS Feed Crawling

If enabled, the feeds will be crawled using the default WordPress Cron.

2. Schedule RSS Feed Fetch

Choose the time frame for fetching the RSS feeds.

3. No of RSS Feeds

Specify the number of posts to retrieve in a single request. Keep in mind that a higher number may impact performance.

4. RSS Feed URLs

Paste each RSS feed URL on a separate line.

5. Home Screen Slider ( From RSS Feed URL )

If you want the posts to appear on the home screen slider, select the feed URLs. When posts are imported from these URLs, they will also be displayed in the home slider.

6. Home Screen Slider ( From Tags )

When an imported news item shares the same tag, it will be displayed in the home screen slider.

Note: If a news item is displayed in the home screen slider, it will also appear in the category slider.

6. Category Screen Slider

When an imported news item shares the same tag, it will be displayed in the category screen slider.

7. Category Setup

When the tags of the imported news match the selected tags, the post will be assigned to that category.

If you have multiple tags such as business, business news, business insider, and others, you can combine them to create a single category.

8. Sites Category Name

Note: Domains will remain empty if RSS feed URLs are not provided.

Occasionally, the domain generated from the feed URL may not be accurate. You can associate your custom name with the domain instead.

Videos

1. No. of Videos on Home Screen

Choose the number of videos to display on the homepage. These videos will be selected randomly. If you have a large collection of videos, a new video will appear with each refresh.

2. Fetch Videos From the

If you fetch a large number of videos daily, you can opt to display videos from the past day. However, if you fetch fewer videos, it’s better to select a longer timeframe, such as the past 7 days.

3. Enable YouTube Shorts Crawling

When enabled, this feature will periodically crawl YouTube Shorts at specified intervals and retrieve links from the YouTube page.

4. Schedule YouTube Shorts Fetch

Choose the interval at which the YouTube Shorts page should be crawled.

5. Number of Videos per Request

Retrieve a specified number of videos per request. Keep in mind that a higher number will require more resources.

6. YouTube Shorts Page Link

Paste each YouTube Shorts link on a new line. The more links you add, the more videos will be available for display.

News Detail

1. Hide Tags

By default, tags are displayed on the news detail page. You can choose to hide them if you prefer not to show them.

2. Exclude Tags

You can exclude specific tags from being displayed. To do this, list the tag names individually on separate lines. Any tags listed will not appear on the news detail page.

3. Reported News Notification Email

If a user reports news, you will receive an email containing the details of the reported news. If empty admin email will be used.

Search

1. Tags

You can select from Trending or most used tags to display in the search section.

2. Minimum Posts

Tags will only be displayed if they have a minimum of x posts.

3. Limit

The number of tags to display

Firebase

Push Notification Setup

  • First, go to the Firebase Console and sign in with your email account and go to the console.
  • Then Create A project by your app name.

To get the FCM API

  • Go to Project Overview > Project Settings > General > Project ID
  • Copy your project ID. In this example, it is topstories.
  • Your FCM API URL will look like this: https://fcm.googleapis.com/v1/projects/topstories/messages:send Replace topstories with your actual project ID.

How to get Service Account Key Configuration JSON

  • First, go to the Firebase Console and sign in with your email account and go to the console.
  • Click on the project you have just created or create a new one.
  • Go to Project Overview > Project Settings > Cloud Messaging and click on Manage Service Accounts
  • Click on the three dots and click on Manage Details
  • Click on KEYS Tab and click on create new key
  • Choose JSON and click on create
  • A .json file will be downloaded. Save it in a secure location, then open the file and copy its contents.
  • Paste the whole json data in Service Account Key Configuration JSON and click on update.

General Settings

1. Top Bar Image ( Light/ Dark Mode )

You can display an image on the top bar of the app, which is especially useful for highlighting special events or occasions such as New Year, Christmas, or Black Friday.

Preview

2. Primary Color

Select your app’s theme color using our color selector.

3. Background Color ( Light/ Dark Mode )

Choose the background color for the app, with options available for both light and dark themes.

4. Slider Posts

Choose the number of posts to display in the slider.

Preview

5. Recent Slider Posts

Fetch posts from the past (x) days to display in the slider.

6. Use Sites Taxonomy

You can opt to display either the post category or the source news site from which the news was obtained.


2. Import Top Stories Plugin

From the main_files/wp folder, you will get a extend-wp-json-api.zip file.

Go to your WordPress Admin Dashboard > Plugins > Add New > Upload Plugin.

Upload the plugin and activate it.

After that, You will see a Top Stories Menu option at the left bar of your WordPress admin dashboard. You can control and customize the app with that.

If you are using any cache plugins like LiteSpeed Cache or others then clear the cache after saving the configuration.