Development

Creating Collections

Collections define the structure of your data model. You can create new ones from Settings → Data Model → Create Collection.

Creating Section Collections

1. Create the Collection:
   • For page-specific sections, prefix the collection name with the page it will be used on (e.g., hawaii_about_hero).
   • For reusable sections, do not prefix (e.g., hawaii_cta).
2. Do not add a status field and check the “Singleton” checkbox.
3. Click the checkmark to save and go to the collection’s structure page.
4. Add the necessary fields.

Creating Repeating Items Collections

Repeating items collections can be used for things like blog posts.

1. Give it a name lik e.g., hawaii_blog_post.
2. Add the status field and do not check the “Singleton” checkbox.
3. Click the checkmark to save and go to the collection’s structure page.
4. Add the necessary fields.

Important: Permissions

When you add a new collection, you must update the public permissions to make its content accessible via the API.

1. Go to Settings → Roles & Permissions → Public.
2. Under Permissions, find your new collection.
3. Give it Read access.

User & Access Control

You can create users with limited access to specific parts of the CMS.

Example: Creating a “Hawaii Editor” Role

1. Create an Access Policy

   1. Go to Settings → Access Control → Roles → Create Role.
   2. Name it Hawaii Edit.
   3. Under Permissions, grant the desired permissions (e.g., Create, Read, Update) for all collections prefixed with Hawaii.
   4. Ensure that the System Collections have the default permissions checked.

2. Create a User Role and Assign the Policy

   1. Go to Settings → Access Control → Roles and create a new role named Hawaii Editor.
   2. Under the Users section for this new role, you can add new or existing users.
   3. Under the Permissions tab, set the permissions for the collections.