NewsLoopVersion 1.0.0 · offline copyGuides

Articles and the editor ​

This guide covers everything you do with stories in the admin: finding them, writing them, working on them with others, and taking them from draft to published. Articles live under Newsroom → Articles. Sections, tags and series are set up under Organise, and who may do what is set under System → Roles.

The Articles list ​

Newsroom → Articles lists every story you are allowed to see. People who cannot see everyone's articles (contributors, reporters and authors, unless you change their role) see only the ones they wrote or created.

The Articles list, with status tabs, filters and the newest articles

Trash ​

Deleting an article moves it to the trash. Nothing is lost until you delete it from there.

  1. Click the bin icon on a row, or tick several rows and click Move to trash.
  2. Click Trash at the right of the tabs to see deleted articles.
  3. Click Restore to bring one back, or Delete permanently to remove it and its history for good. Tick several rows to do either in one go.

You must restore a trashed article before you can edit it. Bulk actions skip articles you may not change and articles someone is editing, and say how many were skipped. Only editors and admins can delete permanently.

The trash is not emptied by itself. The cron job does delete drafts that were left as "Untitled" with no text for seven days.

Starting an article ​

Click New article. The arrow next to it starts another type:

Type Use it for
Article An ordinary story.
Video A story led by a video. Paste a YouTube or Vimeo address in Video link, and it replaces the featured image at the top.
Podcast / audio An episode or audio story.
Photo gallery A story told mostly in pictures.
Live blog A story that grows with timed updates. See Live blogs.

The type also decides which home page blocks and app screens show the article, such as a "Videos" block. You can change it later under Publishing → Type. A new article starts in your site's default language. For other languages, see Translations.

Writing in the editor ​

The article editor: the text in the middle, publishing settings and the AI assistant on the right

The toolbar has undo and redo, three heading sizes (Heading, Subheading, Small heading), bold, italic, underline, strikethrough, links, bulleted and numbered lists, quotes, code blocks, and left, centre and right alignment.

Insert adds a block:

Each block has a bar with its name, a handle to drag it to another place, and a button to remove it.

Article settings ​

The panels on the right hold everything else.

Publishing

Featured image. Click Choose a photo, then Replace or Remove. You get a warning when the photo has no alt text.

Categories and tags

Byline

Search engines

Saving ​

Editing at the same time ​

Only one person can edit an article at a time. When you open an article someone else is editing, you see "… is editing this article", and the editor is read-only.

Revisions ​

Click History at the top of the editor to see earlier versions. Each one shows when it was made, by whom, its word count and why it was kept: Saved, Autosave, Published or Restored.

  1. Pick a version on the left. It is compared, word by word, with the text in the editor now. Green was added since, red was removed. If the headline differed, it is shown too.
  2. Click Restore this version to bring back its headline, standfirst, summary and story.

Your current text is kept in the history first, so a restore can be undone. On a published article a restore goes live straight away. NewsLoop keeps the 50 latest versions of each article, and keeps only your newest autosave between two saves.

Review and publishing ​

An article is always in one of these states:

If you can publish, the main button changes with the article: Publish, Schedule when Publish at is in the future, Update schedule, Update for a published article, and Republish for an archived one. A Publish at time in the past publishes the article with that older date, which helps when you bring in old stories. Republishing an archived article keeps its original date.

The arrow next to the main button holds the other moves: Publish now and Unschedule for a scheduled article, Unpublish to turn a live article back into a draft, and Archive for a published one.

Scheduled articles are published by the cron job, within a minute of their time. Without the cron job they stay scheduled. See Installing.

If you cannot publish, the main button is Submit for review. While the article waits, it says Waiting for review, and the arrow offers Withdraw from review. You can keep editing until an editor publishes it.

Reviewing. Editors find submitted articles in the In review tab, and under Waiting for review on the dashboard. Publish or schedule the article, or choose Send back to the writer from the arrow. Type what should change. The article returns to draft and the writer sees your note.

Who can do what ​

Role Writes Publishes Edits others' articles Posts live blog updates
Contributor Own articles No, submits for review No No
Reporter Own articles No, submits for review No Yes
Author Own articles Own articles No No
Editor, Admin, Super Admin Any Any Yes Yes

Notifications and desk notes ​

The bell at the top of the admin shows newsroom notifications, and each one is also sent by email:

Notifications are sent in the background by the cron job (or a queue worker).

Notes for the desk is a panel for messages between writers and editors about one article. Readers never see them. Type a note and click Add note. You can delete your own notes. A note written while sending an article back is kept here too.

Translations ​

When your site has more than one language, the Translations panel shows the article's language and its versions in other languages, with their status.

  1. Click Translate to and the language.
  2. A new draft opens in that language, linked to the original. The headline, standfirst, summary, story, featured image, sections, video link and source are copied in, ready to translate. Tags are not copied, because each language has its own tags.
  3. Translate the text, add tags, and publish it like any other article.

Each article can have one version in each language. Once both are published, the language switcher on the site takes readers from one version to the other, and search engines learn that they belong together. See Languages and translations.

Live blogs ​

A live blog is an article with timed updates below its text. Use the main story box for the introduction, and post updates in the Live updates box under it.

  1. Optionally write a short headline for the update.
  2. Write the update. It uses the same editor, so it can hold photos, embeds and the other blocks.
  3. Tick Key event for moments readers should be able to jump to, or Pin to top to keep the update above the others.
  4. Click Post update.

Edit or delete an update with the icons beside it. Reporters change their own updates, and editors can change anyone's. Reporters can keep posting after the live blog is published, even though they cannot change the article itself.

What readers see:

AI tools ​

When AI is turned on and your role allows it, the editor gains an AI menu in the toolbar for selected text, an AI assistant panel on the right, and Make a picture with AI under the featured image. Nothing the AI writes is saved until you use it. Setting up the AI and using each tool are described in AI tools.