Blog admin screens
v0.0.1
The blog adds one entry to the admin sidebar, Blog under Plugins, and nine screens behind it. This page lists each screen's address, the permission it needs, its filters and its actions, then the dashboard widgets and the blog's settings. For the fields of each form, see Blog record fields.
Screens
| Screen | Address | Needs | Add button |
|---|---|---|---|
| Blog dashboard | /admin/dashboard/blog | admin:dashboard:blog:post or admin:dashboard:blog:comment | New Post opens the Posts screen. |
| Posts, titled Blog Posts Management | /admin/dashboard/blog/posts | admin:dashboard:blog:post | Add Post |
| Collections | /admin/dashboard/blog/collections | admin:dashboard:blog:post | Add Collection |
| Tags | /admin/dashboard/blog/tags | admin:dashboard:blog:post | Add Tag |
| Bloggers | /admin/dashboard/blog/bloggers | admin:dashboard:blog:post | Add Blogger |
| Teams | /admin/dashboard/blog/teams | admin:dashboard:blog:post | Add Team |
| Comments, titled Comments Management | /admin/dashboard/blog/comments | admin:dashboard:blog:comment | Add Comment |
| Auto Posting | /admin/dashboard/blog/auto-posting | admin:dashboard:blog:post | None |
| Analytics | /admin/dashboard/blog/analytics | admin:dashboard:blog:post | None |
Each screen has a link back to the Blog dashboard. A master sees a Site filter and picks the site when adding a record. A site admin sees only its own site.
Filters
| Screen | Filters |
|---|---|
| Posts | Search in title, slug and excerpt; Site (master); Collection; Status with Published, Draft and Scheduled; Featured; Language |
| Collections | Search in name, slug and description; Site; Status with Active and Draft; Language; Featured only |
| Tags | Search in name, slug and description; Site; Language |
| Bloggers | Search in display name, slug and bio; Site; Can Publish Directly |
| Teams | Search in name, slug and description; Site; Status with Active, Inactive and Draft |
| Comments | Search in content; Site; Status with Pending, Approved, Flagged and Spam; Post; Pinned |
| Auto Posting | Search in name, plugin and description; Site; Active |
The Posts and Comments screens accept filters in the address, such as posts_filter_collection_id and comments_filter_post_id. The count on a post's card and the name of a collection use them.
Row actions
| Screen | On live records | On archived records |
|---|---|---|
| Posts | Edit, Versions, Publish, Unpublish, Delete | Restore, Versions, Delete forever |
| Tags, Teams | Edit, Versions, Delete | Restore, Versions, Delete forever |
| Collections, Bloggers | Edit, Versions, Delete | Restore, Delete forever |
| Comments | Edit, Reply, Approve, Flag, Spam, Pin or Unpin, Delete | Restore, Delete forever |
| Auto Posting | Edit, Versions, Activate, Deactivate, Delete | Restore, Versions Archived, Delete Permanently |
Delete archives a record after you confirm. Delete forever removes it and its history, and cannot be undone. Publish and Unpublish are described in Write and publish a post. Comments are not versioned, so they have no Versions action.
On Auto Posting, the page has no form and no add button, and its Edit and Versions buttons are not answered by the page. A configuration is created over the API. See How the blog works.
Blog dashboard
The dashboard fills in its figures after the page paints. An area the account does not hold is not drawn.
| Part | What it shows |
|---|---|
| Today's Posts | Posts for today, compared with yesterday. |
| Today's Views | Views today, compared with yesterday. |
| New Comments | Comments from the last seven days, with how many are pending. |
| Active Bloggers | The site's bloggers, with how many joined this month. |
| Engagement | Comments divided by views over the last 30 days, compared with the 30 days before. |
| Section cards | Eight cards, one for each of Collections, Blog Posts, Bloggers, Teams, Comments, Auto Posting, Tags and Analytics, each with two figures and a link to its screen. |
| Calendar | A month grid of published and scheduled posts, on the day they went out or are due. Open it with the Calendar button, move with Previous month, Today and Next month. |
| Recent Activity, This Month | The newest few records, and posts published, views, comments and engagement rate for the month. |
| Quick Actions | Create New Post, Review Comments, View Analytics and Blog Settings. |
The header has the check-and-repair button, described in Set up the blog on a site. Setting up and repairing need extra permissions.
Analytics
The screen counts rows of the post view log, where one view is one reader opening one post. Choose 7 days, 30 days or 90 days. It has no read time or bounce rate, because nothing records a reader leaving.
| Part | What it shows |
|---|---|
| Tiles | Total Views, Views in Period, Unique Readers, Views Today and Engagement. The last needs the comment area too. |
| Views Over Time | One point a day, with the busiest day. |
| Top Performing Posts | The five most-read posts of the period. |
| Referrers | The page each reader arrived from, six at most. |
| Audience | Signed-in readers and guests. |
Dashboard widgets
Five widgets can be added to the main admin dashboard. Each admin sets the size of a widget for themselves, on the card's gear in customize mode or in Settings, Blog, Dashboard widgets.
| Widget | Needs | Setting | Default | Range | Links to |
|---|---|---|---|---|---|
| Recent posts | Post area | Posts to show | 4 | 1 to 12 | Posts |
| Drafts & scheduled | Post area | Posts to list | 4 | 1 to 12 | Posts |
| Comments to moderate | Comment area | Comments to show | 3 | 1 to 10 | Comments |
| Top posts | Post area | Posts to rank | 5 | 3 to 12 | Analytics |
| Bloggers | Post area | Bloggers to rank | 5 | 3 to 12 | Bloggers |
Blog settings
The Blog tab of Settings is at /admin/dashboard/settings?tab=blog.
| Setting | Scope | What it does |
|---|---|---|
| Set up at version | Site | The version the site was set up at. Blank until it is set up. The installer writes it, and you cannot edit it. |
| Active on this site | Site | On by default. Off hides the blog's menu and stops its pages being served on that site. Nothing is deleted. |
| Notify blog admins when a post is published | Global default, with a site override | On by default. Notifies the holders of admin:dashboard:blog:post each time a post goes live, except the person who published it. Each admin also has a New posts published preference. |
| Widget sizes | Each admin | The five settings in the widget table, under Dashboard widgets. |