diff --git a/docusaurus/docs/cms/features/content-type-builder.md b/docusaurus/docs/cms/features/content-type-builder.md index c5aca5cb81..b219cae785 100644 --- a/docusaurus/docs/cms/features/content-type-builder.md +++ b/docusaurus/docs/cms/features/content-type-builder.md @@ -24,27 +24,8 @@ From the Content-type Builder, accessible via the main na ## Overview - - - -:::strapi Content Type Builder updates - Interface modifications and new options are available in the Content-type Builder, including: -- tags to indicate the status of the fields and content types: "N" for new, "M" for modified and "D" for deleted, -- an `*` beside required fields in the list view, -- a drag & drop button in the list view, to reorder the fields, -- and collapse button for dynamic zones and components. - -The **Save** button has also been moved to the Content-type Builder navigation which lists all content types and components. This, along with the status tags, allows you to work on several content types and components at the same time. **Revert**, **Undo** and **Discard changes** button have also been added, which also work globally on all content types and components. -::: - The Content-type Builder allows the creation and management of content-types, which can be: - Collection types: content-types that can manage several entries. @@ -57,19 +38,22 @@ All 3 are displayed as categories in the sub navigation of the in the Content-type Builder sub navigation to find a specific collection type, single type, or component. ::: +In the Content-type Builder's sub navigation is also displayed a centralised **Save** button that applies for all content-types and components. Along with the display of statuses for both content-types/components and fields, this allows you to work on several content-types and components at the same time. The following statuses can be displayed: + +- `New` or `N` indicates that a content-type/component or field is new and hasn't been saved yet, +- `Modified` or `M` indicates that a content-type/component or field has been modified since the last save, +- `Deleted` or `D` indicates that a content-type/component or field has been deleted but that it will only be confirmed once saved. + +:::note +Clicking on the **...** button next to **Save** gives access to other options, such as **Undo/Redo last change** and **Discard all changes**. These options are also centralised, meaning that they apply to the last action(s) that was/were done on all content-types, components and fields since the last time you saved. +::: + ## Usage
### Creating content-types - - The Content-type Builder allows to create new content-types: single and collection types, but also components. #### New content-type @@ -125,21 +109,20 @@ The Content-type Builder allows to manage all existing content-types. For an cho -- Click on the **Add new/another field** button in the top right corner to add more fields to your content-type. -- In the table that displays the fields of your content-type , click on the and/or buttons to respectively edit and/or delete these fields. -- Click on the **Edit** button to access the basic and advanced settings of your content-type: +#### Settings + +1. Click on the **Edit** button of your content-type to access its settings. +2. Edit the available settings of your choice: - The **Basic Settings** tab allows to edit the following properties of the content-type or component: - - The **Advanced Settings** tab allows to edit the following properties of the content-type or component: - +3. Click the **Finish** button in the dialog. +4. Click the **Save** button in the Content-Type Builder navigation. -- Click on the **Save** button to confirm any ongoing modification. +#### Fields + +From the table that lists the fields of your content-type, you can: +- Click on the button to access a field's basic and advanced settings to edit them +- Click on the **Add another field** buttons to create a new field for the selected content-type +- Click on the button and drag and drop any field to reorder the content-type's fields +- Click on the button to delete a field :::caution Editing a field allows renaming it. However, keep in mind that regarding the database, renaming a field means creating a whole new field and deleting the former one. Although nothing is deleted from the database, the data that was associated with the former field name will not be accessible from the admin panel of your application anymore. @@ -182,13 +171,6 @@ Editing a field allows renaming it. However, keep in mind that regarding the dat ### Configuring content-types fields {#configuring-fields-content-type} - - Content-types are composed of one or several fields. Each field is designed to contain specific kind of data, filled up in the Content Manager (see [Creating & Writing content](/cms/features/content-manager#creating--writing-content)). In the Content-type Builder, fields can be added at the creation of a new content-type or component, or afterward when a content-type or component is edited or updated. @@ -539,8 +521,6 @@ The Password field displays a password field that is encrypted. The Enumeration field allows to configure a list of values displayed in a drop-down list. - - @@ -714,6 +694,7 @@ Content types and components can be deleted through the Content-type Builder. De 2. In the edition interface of the chosen content-type or component, click on the **Edit** button on the right side of the content-type's or component's name. 3. In the edition window, click on the **Delete** button. 4. In the confirmation window, confirm the deletion. +5. Click on the **Save** button in the Content-type Builder sub navigation. :::caution Deleting a content-type only deletes what was created and available from the Content-type Builder, and by extent from the admin panel of your Strapi application. All the data that was created based on that content-type is however kept in the database. For more information, please refer to the related . @@ -722,7 +703,7 @@ Deleting a content-type only deletes what was created and available from the Con diff --git a/docusaurus/static/img/assets/content-type-builder/new_CTB.png b/docusaurus/static/img/assets/content-type-builder/new_CTB.png new file mode 100644 index 0000000000..f24c5a62b0 Binary files /dev/null and b/docusaurus/static/img/assets/content-type-builder/new_CTB.png differ diff --git a/docusaurus/static/img/assets/content-type-builder/new_CTB_DARK.png b/docusaurus/static/img/assets/content-type-builder/new_CTB_DARK.png new file mode 100644 index 0000000000..5376fd8473 Binary files /dev/null and b/docusaurus/static/img/assets/content-type-builder/new_CTB_DARK.png differ diff --git a/docusaurus/static/img/assets/content-type-builder/new_CTB_deletion.png b/docusaurus/static/img/assets/content-type-builder/new_CTB_deletion.png new file mode 100644 index 0000000000..a60174cc84 Binary files /dev/null and b/docusaurus/static/img/assets/content-type-builder/new_CTB_deletion.png differ diff --git a/docusaurus/static/img/assets/content-type-builder/new_CTB_deletion_DARK.png b/docusaurus/static/img/assets/content-type-builder/new_CTB_deletion_DARK.png new file mode 100644 index 0000000000..a68231f5d0 Binary files /dev/null and b/docusaurus/static/img/assets/content-type-builder/new_CTB_deletion_DARK.png differ