Skip to content

Commit 59539d0

Browse files
committed
cloning layouts, fields, categories, roles
1 parent c0d7a54 commit 59539d0

File tree

8 files changed

+76
-16
lines changed

8 files changed

+76
-16
lines changed
4.61 KB
Loading

docs/_images/cp_fields_edit.png

161 KB
Loading

docs/control-panel/categories.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Category groups are _collections_ of categories that can be assigned to channels
2323

2424
**Control Panel Location: `Content > Categories > New/Edit Category`**
2525

26-
Catagories have the following settings:
26+
Categories have the following settings:
2727

2828
- **Name** -- The name of the new category. The name may include spaces.
2929
- **URL title** -- The human readable category name used in the URL when using [Category URL Titles in Links](control-panel/settings/content-design.md).
@@ -32,6 +32,13 @@ Catagories have the following settings:
3232
- **Parent category** -- This drop-down list allows you to create a hierarchical relationship between categories. The list dynamically contains all existing categories for this category group. Selecting a parent category means that the new category will be a "child" of the parent in the hierarchy. The "None" option is available and will make the new category a "top level" category with no parent.
3333
- **Custom Fields** -- Any [custom category fields](#fields-tab) that exist for this category group will be included in the form.
3434

35+
The categories can be saved by clicking "Save" button or pressing `Ctrl`+`s` (`cmd`+`s`) on keyboard. Upon saving, the category editing page remains open so you can make other changes.
36+
37+
Extra saving options are available from dropdown menu under "Save":
38+
- "Save & New" - opens new category form after saving
39+
- "Save & Close" - redirects to categories list after saving
40+
- "Clone to New Category" - saves the changes into new category. The current category is used as "template" and remains unchanged.
41+
3542
## Create/Edit Category Groups
3643

3744
**Control Panel Location: `Content > Categories > New/Edit Category Group`**

docs/control-panel/channels.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -129,6 +129,8 @@ NOTE: **Note:** We recommend using the default base URL variable `{base_url}` de
129129

130130
**Control Panel Location: `Developer > Channels > Layouts`**
131131

132+
![Channel Publish Layouts Link](_images/channel-publish-layouts.png)
133+
132134
The Publish/Edit page can be customized, with the layout saved per member role, per channel.
133135

134136
### Create/Edit Publish Layouts
@@ -137,6 +139,14 @@ The Publish/Edit page can be customized, with the layout saved per member role,
137139

138140
This section of the control panel is where channel layouts are created or edited.
139141

142+
When publish layout for channel is assigned to member role, the Publish / Edit entry page would be displayed as defined by that layout, for editors in that role.
143+
144+
The publish layouts are capable of organizing fields into tabs, reordering fields, changing their width for organizing into columns, and hiding the fields that should not be visible.
145+
146+
Each layout needs to be assigned to one or several member roles. However each role can have only one publish layout assigned.
147+
148+
You can have one publish layout for all editor roles, or you can have different layouts for different roles. When only small adjustment is needed, the publish layout can be duplicated using "Clone to New Layout" option in "Save" dropdown.
149+
140150
## Channel Set Import
141151

142152
**Control Panel Location: `Developer > Channels > Import`**
Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
<!--
2+
This source file is part of the open source project
3+
ExpressionEngine User Guide (https://github.com/ExpressionEngine/ExpressionEngine-User-Guide)
4+
5+
@link https://expressionengine.com/
6+
@copyright Copyright (c) 2003-2020, Packet Tide, LLC (https://packettide.com)
7+
@license https://expressionengine.com/license Licensed under Apache License, Version 2.0
8+
-->
9+
10+
# Create/Edit Field
11+
12+
**Control Panel Location: `Developer > Fields > New/Edit Field`**
13+
14+
This section of the control panel allows you to create and edit [Fields](/fieldtypes/overview.md) to be used in channel entries.
15+
16+
New field can be added by clicking "New Field" button, or by picking "Clone to New Field" from the existing field's "Save" dropdown - in that case, the original field will serve as "template" and the changes would be applied to new field only.
17+
18+
If you are viewing certain field group when clicking "New Field" button, the field will be assigned to that group. The existing fields can be assigned to multiple field groups by editing the Field Group.
19+
20+
Fields have the following settings:
21+
22+
- **Type** -- The type of field. [List of available fieldtypes](fieldtypes/overview.md).
23+
- **Name** -- The descriptive name for the field which is displayed in the publish form. Unlike the Field Name, the label does not need to be unique within the system, so you can use the same label on multiple fields in different field groups.
24+
- **Short Name** -- This is the internal or "short name" for the field. The field name must be unique within the system, which means that you cannot have two field groups each containing a field with the field name of "body". The short name is typically used as the variable name in your [Channel Entries Tag](channels/entries.md)
25+
- **Instructions** -- These are instructions for authors on how or what to enter into the field when submitting an entry. The instructions will appear below the Field Label in your publish page.
26+
- **Require field?** -- If the field is required and the user leaves it blank, upon submission they will receive an error message prompting them to correct it. Required fields are only required when not [conditionally hidden](control-panel/field-manager/conditional-fields.md).
27+
- **Include in search?** -- This determines whether the contents of this field will be included in searches that are within the entry content.
28+
- **Hide field?** -- Shows or hides the field on the publish page. When hidden, the field will be collapsed by default.
29+
- **Enable front-end editing?** -- Enable/disable [frontedit](/advanced-usage/front-end/frontend.md) links for this field.
30+
- **Make Conditional?** -- Shows or hides the field on the publish page based on [conditional settings](control-panel/field-manager/conditional-fields.md). Fields which are conditionally hidden are not shown at all on the publish page until conditions are met.
31+
- **Channels** -- Read-only list of [channels](control-panel/channels.md) this field is assigned to. The field can be assigned to channel in several ways:
32+
- By editing channel and assigning field directly
33+
- By editing channel and assigning field group, which in turn has been edited and assigned this field
34+
- When a field is used in [Fluid field](fieldtypes/fluid.md) which is assigned to a channel, the field is also assigned to the channel (though not available outside of Fluid)
35+
36+
- **Field Options** -- Each fieldtype may have additional options. See the [individual field types](fieldtypes/overview.md) for details.
37+
38+
![](_images/cp_fields_edit.png)

docs/control-panel/field-manager/field-manager-settings.md

Lines changed: 4 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -21,20 +21,10 @@ This section of the Control Panel is where custom fields are created, edited and
2121

2222
**Control Panel Location: `Developer > Fields > New/Edit Field`**
2323

24-
This section of the control panel allows you to create and edit [Fields](/fieldtypes/overview.md) and Field Groups.
25-
26-
Fields have the following settings:
27-
28-
- **Type** -- The type of field. [List of available fieldtypes](fieldtypes/overview.md).
29-
- **Name** -- The descriptive name for the field which is displayed in the publish form. Unlike the Field Name, the label does not need to be unique within the system, so you can use the same label on multiple fields in different field groups.
30-
- **Short Name** -- This is the internal or "short name" for the field. The field name must be unique within the system, which means that you cannot have two field groups each containing a field with the field name of "body". The short name is typically used as the variable name in your [Channel Entries Tag](channels/entries.md)
31-
- **Instructions** -- These are instructions for authors on how or what to enter into the field when submitting an entry. The instructions will appear below the Field Label in your publish page.
32-
- **Require field?** -- If the field is required and the user leaves it blank, upon submission they will receive an error message prompting them to correct it. Required fields are only required when not [conditionally hidden](control-panel/field-manager/conditional-fields.md).
33-
- **Include in search?** -- This determines whether the contents of this field will be included in searches that are within the entry content.
34-
- **Hide field?** -- Shows or hides the field on the publish page. When hidden, the field will be collapsed by default.
35-
- **Make Conditional?** -- Shows or hides the field on the publish page based on [conditional settings](control-panel/field-manager/conditional-fields.md). Fields which are conditionally hidden are not shown at all on the publish page until conditions are met.
36-
- **Enable front-end editing?** -- Enable/disable [frontedit](/advanced-usage/front-end/frontend.md) links for this field.
37-
- **Field Options** -- Each fieldtype may have additional options. See the [individual field types](fieldtypes/overview.md) for details.
24+
This section of the control panel allows you to create and edit [Fields](/fieldtypes/overview.md) to be used in channel entries.
25+
26+
Visit [**Create/Edit Field**](control-panel/field-manager/edit-field.md) page for detailed information.
27+
3828

3929
## Create/Edit Field Group
4030

docs/control-panel/member-manager.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,20 @@ You can assign multiple roles to a member.
3333

3434
**Control Panel Location: `Members > Member Roles > Create/Edit`**
3535

36-
This sections allows you to set the various permissions and settings for the selected Member Role
36+
This sections allows you to set the various permissions and settings for the selected Member Role.
37+
38+
ExpressionEngine comes with 5 built-in Roles:
39+
- Super Admin _(#1)_ - has full control over site and all system settings. We advise that all member in this role would use [Multi-factor authentication](member/mfa.md)
40+
- Banned _(#2)_ - reserved role for members that are registered but have been banned from accessing the site
41+
- Guests _(#3)_ - reserved role for visitors that are not logged in. We advise to not assign any real member accounts to this role.
42+
- Pending _(#4)_ - members who filled in registration form but have not been approved yet (by admin or by verifying their email address, depending on your membership preferences)
43+
- Members _(#5)_ - regular site members. This is the default role that everyone gets registered into, unless specified differently
44+
45+
These roles should never be deleted.
46+
47+
If you need custom set of permissions for the role, we suggest creating new role for each case. You can do that by clicking "New Role" button, or you can create new role based on exsting one by picking "Clone to New Role" from the role's "Save" dropdown.
48+
49+
Edit the role by clicking its name in the list.
3750

3851
## Custom Member Fields
3952

docs/toc_sections/_the_fundamentals_toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,8 @@
3939
items:
4040
- name: Settings
4141
href: control-panel/field-manager/field-manager-settings.md
42+
- name: Create/Edit Field
43+
href: control-panel/field-manager/edit-field.md
4244
- name: Conditional Fields
4345
href: control-panel/field-manager/conditional-fields.md
4446
- name: Member Manager

0 commit comments

Comments
 (0)