diff --git a/user-docs/.vuepress/config.js b/user-docs/.vuepress/config.js index 14803f9c97..a773d33a92 100755 --- a/user-docs/.vuepress/config.js +++ b/user-docs/.vuepress/config.js @@ -265,7 +265,7 @@ module.exports = { ], [ '/latest/content-manager/configuring-view-of-content-type', - 'Configuring the view of a content type', + 'Configuring the views of a content type', ], ['/latest/content-manager/writing-content', 'Writing content'], ['/latest/content-manager/managing-relational-fields', 'Managing relational fields'], diff --git a/user-docs/latest/.DS_Store b/user-docs/latest/.DS_Store deleted file mode 100644 index 8a0977eb79..0000000000 Binary files a/user-docs/latest/.DS_Store and /dev/null differ diff --git a/user-docs/latest/assets/content-manager/edit-view-config.png b/user-docs/latest/assets/content-manager/edit-view-config.png new file mode 100644 index 0000000000..ddc1da3ce5 Binary files /dev/null and b/user-docs/latest/assets/content-manager/edit-view-config.png differ diff --git a/user-docs/latest/content-manager/configuring-view-of-content-type.md b/user-docs/latest/content-manager/configuring-view-of-content-type.md index bcdebe3e19..49c59a6ab1 100644 --- a/user-docs/latest/content-manager/configuring-view-of-content-type.md +++ b/user-docs/latest/content-manager/configuring-view-of-content-type.md @@ -1,6 +1,10 @@ -# Configuring the view of a content type +# Configuring the views of a content type -Right above the list view table, on the right side of the interface, a settings button is displayed. It allows to access the configurations that can be set for the list view of your collection type, and to choose which fields to display in the table. +Depending on their type, content types can be divided into 2 interfaces: the list view and the edit view. Both interfaces can be configured. + +## Configuring the list view + +On the right side of the list view interface, right above the table, a settings button is displayed. It allows to access the configurations that can be set for the list view of your collection type, and to choose which fields to display in the table. ::: tip NOTE The configurations only apply to the list view of the collection type from which the settings are accessed (i.e. disabling the filters or search options for a collection type will not automatically also disable these same options for all other collection types). @@ -10,11 +14,11 @@ Note also that the explanations below explain how to permanently configure which ![Settings of a list view in the Content Manager](../assets/content-manager/content-manager_settings-list-view.png) -To configure the list view settings: +### List view settings -1. In the list view, click on the settings button . +1. In the list view of your collection type, click on the settings button . 2. Click on the **Configure the view** button. -3. Define your chosen new settings: +3. In the Settings area, define your chosen new settings: | Setting name | Instructions | | ---------------------- | -------------------------------------------------------------------------------------------------- | @@ -24,11 +28,23 @@ To configure the list view settings: | Entries per page | Choose among the drop-down list the number of entries per page. | | Default sort attribute | Choose the sorting field and type that will be applied by default. | -4. Define what fields to display in the list view table, and in what order: +4. Click on the **Save** button. + +### List view display + +1. In the list view of your collection type, click on the settings button . +2. Click on the **Configure the view** button. +3. In the View area, define what fields to display in the list view table, and in what order: - Click the add button ![icon add new](../assets/content-manager/icon_add.png) to add a new field. - Click the delete button ![icon delete](../assets/content-manager/icon_delete.png) to remove a field. - Click the reorder button ![icon drag & drop](../assets/content-manager/icon_dragdrop.png) and drag and drop it to the place you want it to be displayed amond the other fields. - - Click the name of the field to edit the label and/or enable or disable sort on that field. +4. Click the name of the field to access its available own settings: + +| Setting name | Instructions | +| ------------------------- | ------------------------------------------------------------------------- | +| Label | Write the label to should be used for the field in the list view table. | +| Enable sort on this field | Click on **ON** or **OFF** to able or disable the sort on the field. | + 5. Click on the **Save** button. ::: tip NOTE @@ -43,3 +59,56 @@ Note also that relational fields have a couple limitations when it comes to sort - Sorting cannot be enabled for relational fields which display several fields. - Relational fields cannot be set as default sort. ::: + +## Configuring the edit view + +In the edit view of a content type, in the right side of the interface, a **Configure the view** button is displayed. It allows to access the configurations that can be set for the edit view of the content type, such as the entry title, and the display of the fields of the content type, including the relational ones. + +![Configuring the edit view of the Content Manager](../assets/content-manager/edit-view-config.png) + +### Edit view settings + +1. In the edit view of your content type, click on the **Configure the view** button. +2. In the Settings area, define your chosen new settings: + +| Setting name | Instructions | +| --------------- | ------------------------------------------------------------------------------------- | +| Entry title | Choose among the drop-down list the field that should be used as title for the entry. | + +3. Click on the **Save** button. + +### Edit view display + +1. In the edit view of your content type, click on the **Configure the view** button. +2. In the View area, define what fields to display in the list view table, and in what order: + - Click the add button ![icon add new](../assets/content-manager/icon_add.png) to add a new field. + - Click the delete button ![icon delete](../assets/content-manager/icon_delete.png) to remove a field. + - Click the reorder button ![icon drag & drop](../assets/content-manager/icon_dragdrop.png) and drag and drop it to the place you want it to be displayed amond the other fields. +3. Click the name of a field to access its available own settings: + +| Setting name | Instructions | +| --------------- | ----------------------------------------------------------------------------------------- | +| Label | Write the label to should be used for the field. | +| Description | Write a description for the field, to help other administrators fill it properly. | +| Placeholder | Write the placeholder that should be displayed by default in the field. | +| Editable field | Click on **ON** or **OFF** to able or disable the edition of the field by administrators. | + +4. Click on the **Save** button. + +::: warning IMPORTANT +The settings and display of a component's fields cannot be managed and reordered through the entry's edit view configuration page. Click on the **Set the component's layout** button of a component to access the component's own configuration page. You will find the exact same settings and display options as for the entry, but that will specifically apply to your component. + +Note also that the settings are defined for the component itself, which means that the settings will automatically be applied for every other content type where the component is used. +::: + +#### Relational fields + +On the right side of the View area is displayed a Relational fields part. As in the edit view, regular fields and relational fields are managed separately (see [Managing relational fields](managing-relational-fields.md)). Although most configuration options are similar to regular fields', relational fields configurations have some specificities. + +To define what relational fields of an entry should be available in the edit view, the following options are available: + +- the **Insert another relational field** button, to add another relational field to your entry. If the button remains unclickable, it means that no other relational field can be added. +- the delete button ![icon delete](../assets/content-manager/icon_delete.png), to remove a relational field. +- the reorder button ![icon drag & drop](../assets/content-manager/icon_dragdrop.png), to drag and drop to the place you want your relational field to be displayed among the others. + +As for regular fields, it is possible to access the available settings of the relational fields by clicking on their name. Most settings are the same as for regular fields (see [Edit view display](./configuring-view-of-content-type.md#edit-view-display)) except for "Entry title" which is only available for relational fields. It is recommended to choose well the entry title of relational fields as the more comprehensive it is, the easier it will be for administrators to manage the content of relational fields from the edit view. \ No newline at end of file diff --git a/user-docs/latest/content-manager/introduction-to-content-manager.md b/user-docs/latest/content-manager/introduction-to-content-manager.md index 6a4147d31d..e76202088a 100644 --- a/user-docs/latest/content-manager/introduction-to-content-manager.md +++ b/user-docs/latest/content-manager/introduction-to-content-manager.md @@ -25,7 +25,7 @@ From the list view, it is possible to: - configure the fields displayed in the table of the list view (4). ::: tip 💡 TIP -Sorting can be enabled for any field displayed in the list view table (see [Configuring view of content type](../content-manager/configuring-view-of-content-type.md)). Click on a field name, in the header of the table, to sort on that field. +Sorting can be enabled for any field displayed in the list view table (see [Configuring the views of a content type](../content-manager/configuring-view-of-content-type.md)). Click on a field name, in the header of the table, to sort on that field. ::: ### Filtering entries @@ -59,10 +59,10 @@ New entries are only considered created once some of their content has been writ ### Configuring the table fields -Right above the list view table, on the right side of the interface, a settings button is displayed. It allows to access the configurations that can be set for the list view of your collection type (see [Configuring view of content type](../content-manager/configuring-view-of-content-type.md)), and to choose which fields to display in the table. +Right above the list view table, on the right side of the interface, a settings button is displayed. It allows to access the configurations that can be set for the list view of your collection type (see [Configuring the views of a content type](../content-manager/configuring-view-of-content-type.md)), and to choose which fields to display in the table. ::: tip NOTE -Configuring the displayed field of the table in the way detailed below is only temporary: the configurations will be reset as soon as the page is refreshed or when navigating the admin panel outside the Content Manager. For permanent configurations, please refer to [Configuring view of content type](../content-manager/configuring-view-of-content-type.md). +Configuring the displayed field of the table in the way detailed below is only temporary: the configurations will be reset as soon as the page is refreshed or when navigating the admin panel outside the Content Manager. For permanent configurations, please refer to [Configuring the views of a content type](../content-manager/configuring-view-of-content-type.md). ::: ![Displayed fields in the settings of a list view in the Content Manager](../assets/content-manager/content-manager_displayed-fields.png) @@ -74,7 +74,7 @@ To temporarily configure the fields displayed in the table: 3. Untick the boxes associated with the fields you do not want to be displayed in the table. ::: tip NOTE -Relational fields can also be displayed in the list view. Please refer to [Configuring view of content type](../content-manager/configuring-view-of-content-type.md) for more information on their specificities. +Relational fields can also be displayed in the list view. Please refer to [Configuring the views of a content type](../content-manager/configuring-view-of-content-type.md) for more information on their specificities. :::