Loading...

This is taking longer than expected.

Posts

Publish news and articles — title, author, content, files, category and custom fields — and decide which posts your site shows.

Your posts live under Posts in your team's menu. This guide covers the list, every field of the post form, and what each one changes on your site.

The post list

The list shows each post with its title, its author, its category and whether it is active, newest first. Above it:

  • Create opens an empty form.
  • Categories opens the categories of your posts: create them there, with a name, a description and an image, and nest them up to three levels. See Template types and categories.
  • When your posts have custom fields with a filter, the filters narrow the list by their values.

Each row lets you open, edit, delete or copy the post. Copying is described in Clone an item.

Create a post

  1. Click Create.
  2. Fill in the fields below. Title and User are required.
  3. Click the save button at the bottom.
Field What it does
Title Required. The post's title everywhere on your site.
User Required. The author of the post. It starts with you, and only the members of your team are offered.
Content The text of the post, in an editor with bold, lists, links and headings.
Media The post's files and images. You can upload several or pick them from your files. The first one is the picture at the top of the post's page.
Category The category the post belongs to. Only the categories of your posts are offered.
Is Active On by default. Off, the post is left out of the list of posts on your site without being deleted.

When your team has custom fields for posts, their inputs appear at the end of the form. See Custom fields and choose Post as the field's model.

Edit a post

Editing shows one more field:

Field What it does
Slug The end of the post's address on your site: a post with the slug our-new-office is at your site's address followed by posts/our-new-office. It is written from the title when the post is created. Lowercase letters, numbers, hyphens and slashes, up to 100 characters, and no two posts of your team can share it. Change it only if you have not shared the address yet: the old one stops working.

Files

The files you upload are kept in your team's files, in the Posts folder, inside a folder named after the number of the post. A file you pick from your files instead stays where it is. Every file counts against your team's storage space; when there is no space left, the upload is refused. See Your media library and Your storage space.

On your site

Your site lists your active posts on the Posts page and shows each one on the Post Detail page, with its category and how long ago it was published. The default pages do not show the author: add it to the page if you want it. See Show your company content on your site.

Who can do what

The actions follow the team permissions Post: See, Post: Create, Post: Update and Post: Delete on the Roles screen. A deleted post is kept, and only a member with the team's owner role can restore it or delete it for good.

For developers

  • The screen is App\Front\Resources\Team\Post at /team/posts, over App\Models\Post (posts table), with PostPolicy (permission name post).
  • The author is author(), a belongsTo to User on author_id.
  • $post->excerpt is the content without Markdown, cut at 150 characters.
  • The files go to Posts/{id} in the team library.