NewsLoopVersion 1.0.0 · offline copyGuides

Media library ​

The media library keeps the photos, videos, audio and PDFs for your articles, pages, ads and app. This guide covers uploading, what NewsLoop does to your pictures, describing them, and choosing them in the editor. You find it under Newsroom → Media.

Uploading ​

  1. Open Newsroom → Media.
  2. Click Upload and choose one or more files, or drop them anywhere on the page.
  3. Each file shows a progress bar while it uploads. Click the cross next to it to cancel.

The media library

If a folder is chosen in the folder list, new files go into that folder.

These types are accepted:

The line under the toolbar says how large a file can be ("Up to 20 MB each"). You set the limit under System → Site settings → Media → Largest upload (MB). Your hosting can set a lower limit. The library always shows the one that really applies, so uploads never fail without a reason. Pictures can be up to 50 megapixels, which is more than any camera makes.

A new file gets its title from its file name. You can change it later.

What happens to pictures ​

You don't need to do anything for this. Every upload is checked and cleaned:

Picture sizes need the cron job ​

The thumbnail is made at once. The 960 and 1920 copies are made in the background, a minute or so after the upload. Until they are ready, the site shows the original file. When they are ready, articles that use the picture are updated by themselves.

This background work needs the cron job from the installation guide. If large copies never appear, check that the cron job runs on the System page. See Background work without a worker.

The focal point ​

Cards and thumbnails often crop a photo. The focal point tells NewsLoop which part to keep in view.

  1. Click a photo in the library to open its details.
  2. Click the most important part of the photo, such as a face. You can also use the arrow keys; hold Shift for bigger steps.
  3. Click Save.

The smaller copies are then made again around the new point.

Alt text, caption and credit ​

Open a file to see and edit its details:

When you put a photo in an article, it uses these by default. You can type a different caption, alt text or credit for one article in the photo block, without changing the library.

The details panel also has Copy link and Open, to share or view the file itself.

Folders ​

Folders help you keep the library tidy, for example one per event or per photographer. They are only for you: moving a file to a folder never changes its address.

Finding files ​

Choosing files in the editor ​

You rarely need to open the library first. Wherever NewsLoop asks for a picture, it opens the library in a window: Pick a file, or upload a new one. Search and filter as usual, or upload a new file there, then click the one you want.

In the article editor:

Logos, the site icon, share images, ad pictures and the app icon are chosen the same way. See Articles for the rest of the editor.

AI alt text ​

If AI tools are set up, Suggest with AI next to Alt text describes the picture for you. Check the suggestion, then click Save. See AI tools.

Deleting files ​

  1. Open the file.
  2. Click Delete and confirm.

This removes the file and all its sizes for good. Articles that use it lose the picture, so check before you delete a photo that may still be in use. It cannot be undone.

Who can do what ​

You can change this under System → Roles.

Where files are stored ​

Files are kept in the public/uploads folder of your site. Updates never touch this folder. Backups on the System page include it when you tick the uploads option. See Backups.

To keep files on Amazon S3 or a service that works like it, such as Cloudflare R2, a developer can install the S3 driver (composer require league/flysystem-aws-s3-v3), fill in the AWS_ settings in .env, and add MEDIA_DISK=s3. Files uploaded before the change stay in public/uploads and keep working.

Troubleshooting ​