What This Screen Does
This is the main blog page where you can browse all published articles (also called posts or newsletters). Think of it like a news feed — you see a grid of articles with their cover images and titles, and you can search for a specific article or sort them by date or popularity. From here you can click into any article to read the full content.
How to Get There
Open the dashboard.
In the left-hand menu, click Newsletter (or Blog).
You are now on the Blog list screen.
Step-by-Step Guide
1. Browse Articles
When the page loads, you will see a grid of article cards.
The first article in the list is displayed larger (taking up half the row) to highlight it as the featured post.
The remaining articles are shown in a smaller card format, four per row on desktop.
While articles are loading, you will see placeholder skeleton cards. Wait a moment for them 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.
The search uses a slight delay (debounce) so it waits until you stop typing before fetching results. This is normal.
A dropdown will appear showing matching articles, each with a thumbnail image and title.
Matching text in the title is highlighted in bold so you can spot it easily.
Click on an article in the dropdown to go directly to its detail page.
You can also press Enter on your keyboard to navigate to the first result.
Field | Required | What to Enter |
Search | No | Type part or all of an article title. The system searches as you type. |
3. Sort Articles
On the right side of the top bar, click the Sort By button.
A small menu will appear with the following options:
Sort Option | What It Does |
Latest | Shows the newest articles first (sorted by creation date, newest on top). This is the default. |
Oldest | Shows the oldest articles first (sorted by creation date, oldest on top). |
Popular | Shows the most-viewed articles first (sorted by total views, highest on top). |
Click your preferred option. The menu closes and the article grid updates immediately.
4. View an Article
Click on any article card in the grid.
You will be taken to the article’s detail page where you can read the full content.
5. 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 into the grid.
What Happens Behind the Scenes
Page loads
|
v
API call: useGetPosts() fetches all articles
|
v
Articles are sorted by "latest" (default)
|
v
Grid displays article cards (skeleton placeholders shown while loading)
|
v
(If you type in the search bar)
|
v
Input is debounced (waits for you to stop typing)
|
v
API call: useSearchPosts(query) searches for matching articles
|
v
Dropdown shows matching results with highlighted titles
|
v
(If you click a result or press Enter)
|
v
You are redirected to the article detail page at /newsletter/:title
Troubleshooting
“The page is blank and I only see grey placeholder boxes”
The articles are still loading from the server. Wait a few seconds.
If the placeholders stay for a long time, check your internet connection.
Try refreshing the page. If the problem continues, the server may be temporarily unavailable — contact your administrator.
“I typed something in the search bar but nothing happens”
The search waits about half a second after you stop typing before it starts looking. This is normal — just wait a moment.
Make sure you are typing part of an article title. The search does not look inside article content, only titles.
If the dropdown says “No results found”, the article may not exist or may be spelled differently. Try a shorter or different keyword.
“The search results show the wrong articles”
The search matches against article titles. If multiple articles have similar titles, they will all appear.
Try typing a more specific or longer phrase to narrow down the results.
Check for typos in your search query.
“I clicked Sort By but the articles did not change order”
If all articles were created at the same time or have the same view count, sorting may not produce a visible difference.
Make sure you clicked one of the sort options in the dropdown menu (Latest, Oldest, or Popular) — simply opening the menu does not change anything.
“I cannot find the article I am looking for”
Try using the search bar and typing part of the title.
Check if you are looking at the right sort order — switch to Latest if you recently published the article, or Oldest if it was published long ago.
The article may not have been published yet. Check with the person who wrote it to confirm it has been published.
“The Load More button is not showing”
The Load More button only appears when there are more than 8 articles in the system.
If you have 8 or fewer articles, all of them are already displayed on the page.
“Clicking on an article takes me to a broken page”
The article detail page may have been removed or the article’s URL may have changed.
Go back to the blog list and try a different article. If the problem happens with every article, contact your administrator.
Try refreshing the page — it may be a temporary loading issue.