What This Screen Does
This is the Blog screen — a central place where you can browse, search, and sort all published articles (also called posts or notifications). Think of it like a news feed or bulletin board where your organisation shares updates, announcements, and helpful content. You can find a specific article by searching for its title, or change the order articles appear in.
How to Get There
Open the dashboard.
In the left-hand menu, click Notifications (or Blog).
You are now on the Blog screen.
Step-by-Step Guide
1. Browse Articles
When the page loads, all published articles appear in a card grid.
The first article is displayed larger (taking up half the row) to highlight the most relevant post.
The remaining articles are shown as smaller cards, four per row on desktop or two per row on tablets.
While articles are loading, you will see placeholder skeleton cards. Wait a moment for the content to appear.
2. Search for an Article
At the top of the page, you will find a Search bar on the left side.
Start typing the title of the article you are looking for.
As you type, a dropdown will appear showing matching results with a thumbnail image and highlighted title text.
Click on a result to go directly to that article’s detail page.
You can also type your query and press Enter to navigate to the article.
If no articles match your search, you will see a “No results found” message in the dropdown.
Field | Required | What to Enter |
Search | No | Type any part of an article title. Results update automatically as you type. |
3. Sort Articles
To the right of the search bar, you will see a Sort By button showing the current sort order.
Click the button to open a dropdown menu with three options:
Sort Option | What It Does |
Latest | Shows the newest articles first (this is the default). |
Oldest | Shows the oldest articles first. |
Popular | Shows the most-viewed articles first. |
Click on your preferred sort option. The article grid will instantly reorder.
4. Load More Articles
If there are more than 8 articles, a Load More button appears at the bottom of the page.
Click it to load additional articles below the ones already displayed.
5. Open an Article
Click on any article card to navigate to that article’s detail page.
On the detail page you can read the full content of the article.
What Happens Behind the Scenes
Page loads
|
v
API call: useGetPosts() fetches all published articles
|
v
Articles are sorted by "latest" (default) and displayed in a card grid
|
v
(If you type in the search bar)
Input is debounced (waits for you to stop typing)
|
v
API call: useSearchPosts(query) searches articles matching your text
|
v
Matching results appear in the search dropdown
|
v
(If you click a result or press Enter)
You are redirected to the article detail page
|
v
(If you change the sort order)
Articles are re-sorted locally — no extra API call needed
Troubleshooting
“The page is blank and I only see grey placeholder boxes”
Those are loading skeletons — they mean the articles are still being fetched from the server.
Wait a few seconds. If they do not disappear, check your internet connection and refresh the page.
“I searched for an article but nothing came up”
Make sure you are spelling the title correctly. The search matches against article titles only.
Try a shorter or more general keyword instead of the full title.
The article may not have been published yet. Check with your content team.
“The sort order does not seem to change anything”
If all articles were created at the same time, switching between Latest and Oldest will look the same.
If all articles have the same number of views, Popular will not visibly reorder them either.
Try a different sort option to confirm the feature is working.
“I clicked Load More but nothing happened”
The Load More button only appears when there are more than 8 articles.
If you see the button but nothing new loads, it may be a temporary server issue. Refresh the page and try again.
“The search dropdown is slow to appear”
The search input is debounced, meaning the system waits briefly for you to finish typing before sending the search request. This is normal and prevents unnecessary server calls.
If results take more than a few seconds, your internet connection may be slow. You will see a spinning loading indicator in the search bar while results are being fetched.
“I cannot find the Blog / Notifications page in the menu”
The menu item may be labelled differently depending on your system configuration (e.g. Blog, News, or Notifications).
If you do not see it at all, your user role may not have permission to view this section. Contact your administrator.
“Articles are not showing the correct cover image”
Cover images are set when the article is created or edited. If an image is missing or broken, the article author needs to re-upload it from the article edit screen.
If images load slowly, this may be due to large file sizes or a slow connection.
