Merge pull request #830 from ExpressionEngine/7.dev

TomJaeger · web-flow · commit c753b2a70d72 · 2024-03-20T21:20:15.000-04:00
Pushing 7.4.5 changelog live and a few other updates.
diff --git a/docs/control-panel/member-manager.md b/docs/control-panel/member-manager.md
@@ -19,7 +19,7 @@ This page is used both to search and to browse through members within your Expre
 
 ![Member Manager Control Panel Page](_images/cp-members.png)
 
-Filters and search input can be used to narrow down the list of members displayed. 
+Filters and search input can be used to narrow down the list of members displayed.
 
 The set of columns displayed can be customized using the "Columns" dropdown. By default, the following columns are shown: Member ID, Name (which is composed of avatar, username and screen name), Email, Roles, Join Date, Last Visit Date. Also each member row has "Actions" buttons that contains links to some common actions and a checkbox that allows performing bulk actions on selected members. When "Pending" is selected in the "Role" filter, the bulk action options are "Approve" and "Decline", otherwise "Remove" is the only option.
 
@@ -54,6 +54,82 @@ If you need a custom set of permissions for the role, we suggest creating a new
 
 Edit the role by clicking its name in the list.
 
+### Role Settings
+
+**Control Panel Location: `Members > Roles > Create/Edit`**
+
+Roles are highly configurable to manage permissions for members that belong to the role. It is important to note that permissions are additive. This means that if a member belongs to multiple roles they will have the sum of all the permissions granted by each of their roles.
+
+You should be very careful when assigning permissions marked with a shield icon. These are related to the security of your website.
+
+The role settings are grouped into the following tabs.
+
+[TOC=4]
+
+#### Role tab
+
+This tab contains the generic settings for the role, including name, description, color label and security preferences (such as requiring MFA). You can also assign the role to Role Groups on this tab.
+
+#### Website Access tab
+
+Use this tab to set up how members in this role can interact with your website and what actions they can perform on the front-end.
+
+#### CP Access tab
+
+This tab is used to set up the sections of the Control Panel that members in this role can access. You can also set up specific actions they can perform within each section. There are also settings for defining the look of certain Control Panel pages.
+
+The settings here are grouped into sections for each subset of Control Panel functionality.
+
+[TOC=5]
+
+##### Channel
+
+Defines whether and how the members in this role can administrate the [Channels](getting-started/the-big-picture.md#channels) and related content structures (such as Categories, Statuses).
+
+##### Channel Entries
+
+Defines the permissions that members in this role have for creating/editing/deleting entries in each of the channels.
+
+##### Files
+
+Defines actions members in this role can perform on the files as well as administrative permissions on [upload directories](control-panel/file-manager/upload-directories.md).
+
+Note: when editing channel entries with File fields, the members would need access to respective upload directories to modify those.
+
+##### Members
+
+Defines whether the members of this role can access Member Manager and perform certain actions on members and roles.
+
+##### Templates
+
+Defines whether the members of this role can create/edit/modify templates, template partials and template variables. Granular administrative permissions can also be set per template group.
+
+##### Add-Ons
+
+Defines whether the members of this role can access the Add-ons section and which Add-ons they are allowed to access in the Control Panel.
+
+##### Utilities
+
+Set the CP utilities that members of this role are allowed to use.
+
+##### Logs
+
+Defines if members of this role can access the Logs section in the Control Panel.
+
+##### Settings
+
+Defines if members of this role can modify system settings, with separate preferences for subsections which may contain more sensitive settings.
+
+#### Template Access tab
+
+This tab lists all the templates of your website. If you deselect certain templates, the members in this role will not be able to access site pages that are using these templates. Instead, they will see the "No Access" message as configured in settings for those templates.
+
+### Role Groups
+
+Role Groups are a way to organize your roles into logical groups. Create a Role Group by clicking "New" next to Role Groups heading in the sidebar. You can set the role group name and assign roles to it by checking the appropriate checkboxes.
+
+You can then assign members to the Role Group. These members will have all the permissions granted by all of the roles within the Role Group.
+
 ## Custom Member Fields
 
 **Control Panel Location: `Settings > Members > Member Fields`**
diff --git a/docs/fieldtypes/checkboxes.md b/docs/fieldtypes/checkboxes.md
@@ -63,10 +63,10 @@ Two
 Three
 ```
 
-By default, `{item}` will render the item's label To access the value and label separately, simply add a `:value` or `:label` modifier to the `{item}` variable:
+By default, `{item}` will render the item's value. To access the value and label separately, simply add a `:value` or `:label` modifier to the `{item}` variable:
 
     {field_name}
-        Label: {item}<br> {!-- 1 --}
+        Value: {item}<br> {!-- 1 --}
         Value: {item:value}<br> {!-- 1 --}
         Label: {item:label}<br> {!-- One --}
     {/field_name}
diff --git a/docs/fieldtypes/file.md b/docs/fieldtypes/file.md
@@ -222,18 +222,19 @@ Resize the image.
 
 ### `:crop`
 
-    {news_image:crop width="100" height="100"}
+    {news_image:crop width="100" height="100" position="center"}
 
-Crop the image.
+Crop the image. By default, cropping uses top left corner of image as starting position. You can specify `x` and `y` offset, if needed, or `position="center"` parameter to make crop happen close to image center.
 
 | Parameter | Values  | Default    | Description                           |
 | --------- | ------- | ---------- | -------------------------------------- |
 | width    | `Number` | `*required`| Width to crop to |
 | height   | `Number` | `*required`| Height to crop to |
-| quality  | `0`-`100`| `75`| Image quality, % |
-| maintain_ratio   | `y` / `n` | `y`| Keep image ratio (yes/no)  |
-| x        | `Number` | `0`| Horizontal offset, px |
-| y        | `Number` | `0`| Vertical offset, px |
+| quality  | `0`-`100`| `75`       | Image quality, % |
+| maintain_ratio      | `y` / `n`  | `y`| Keep image ratio (yes/no)  |
+| position | `center` |            | Crop close to image center  |
+| x        | `Number` | `0`        | Horizontal offset, px |
+| y        | `Number` | `0`        | Vertical offset, px |
 
 ### `:rotate`
 
diff --git a/docs/fieldtypes/multiselect.md b/docs/fieldtypes/multiselect.md
@@ -63,10 +63,10 @@ Two
 Three
 ```
 
-By default, `{item}` will render the item's label. To access the value and label separately, simply add a `:value` or `:label` modifier to the `{item}` variable:
+By default, `{item}` will render the item's value. To access the value and label separately, simply add a `:value` or `:label` modifier to the `{item}` variable:
 
     {field_name}
-        Label: {item}<br> {!-- One --}
+        Value: {item}<br> {!-- One --}
         Value: {item:value}<br> {!-- 1 --}
         Label: {item:label}<br> {!-- One --}
     {/field_name}
diff --git a/docs/fieldtypes/selectable-buttons.md b/docs/fieldtypes/selectable-buttons.md
@@ -60,10 +60,10 @@ When allowing multiple items to be selected, Selectable Buttons will usually be
         {item}<br>
     {/field_name}
 
-By default, `{item}` will render the item's label. To access the value and label separately, simply add a `:value` or `:label` modifier to the `{item}` variable:
+By default, `{item}` will render the item's value. To access the value and label separately, simply add a `:value` or `:label` modifier to the `{item}` variable:
 
     {field_name}
-        Label: {item}<br>
+        Value: {item}<br>
         Value: {item:value}<br>
         Label: {item:label}<br>
     {/field_name}
diff --git a/docs/installation/changelog.md b/docs/installation/changelog.md
@@ -8,6 +8,34 @@
 -->
 # ExpressionEngine v7 Change Log
 
+## Version 7.4.5
+(Release: March 20, 2024)
+
+- **Contributors** 🙌
+<div class="max-w-7xl mx-autotext-center">
+<div class="space-y-8 sm:space-y-12">
+    <ul role="list" class="mx-auto grid grid-cols-2 gap-x-4 gap-y-1 sm:grid-cols-4 md:gap-x-6 lg:max-w-5xl lg:gap-x-8 lg:gap-y-1 xl:grid-cols-5">
+<li><div class="space-y-4 text-center"><img class="mx-auto h-20 w-20 rounded-full lg:w-24 lg:h-24" src="https://avatars.githubusercontent.com/u/752126?v=4" /><div class="space-y-2"><div class="text-xs font-medium lg:text-sm"><p class="mb-1">Yuri Salimovskiy</p><p class="text-indigo-600"><a href="https://github.com/ExpressionEngine/ExpressionEngine/commits?author=intoeetive" target="_BLANK">@intoeetive</a></p></div></div></div></li>
+<li><div class="space-y-4 text-center"><img class="mx-auto h-20 w-20 rounded-full lg:w-24 lg:h-24" src="https://avatars.githubusercontent.com/u/23382425?v=4" /><div class="space-y-2"><div class="text-xs font-medium lg:text-sm"><p class="mb-1">Yulyaswan</p><p class="text-indigo-600"><a href="https://github.com/ExpressionEngine/ExpressionEngine/commits?author=Yulyaswan" target="_BLANK">@Yulyaswan</a></p></div></div></div></li>
+    </ul>
+</div>
+</div>
+
+**Enhancements** 🚀
+
+- Resolved [#3972](https://github.com/ExpressionEngine/ExpressionEngine/issues/3972) where it was not possible to use 1-click Updater on servers with `disk_free_space()` disabled
+- Enabled view counters to be displayed in Entry Manager
+- Changed default limit in Members field settings
+
+**Bug Fixes** 💃🐛
+
+- Resolved [#4148](https://github.com/ExpressionEngine/ExpressionEngine/issues/4148) where SuperAdmins were not able to approve members into Locked roles
+- Resolved [#4147](https://github.com/ExpressionEngine/ExpressionEngine/issues/4147) where label of dropdown select field for member was not parsed correctly
+- Resolved [#4129](https://github.com/ExpressionEngine/ExpressionEngine/issues/4129) where CSRF token not getting refreshed when CP session type is "session only"
+- Resolved issue where saving RTE toolset could show an error
+- Resolved issue where certain uses of Member model in CLI requests were causing errors
+- Resolved [#4111](https://github.com/ExpressionEngine/ExpressionEngine/issues/4111) where reordering groups did not work in Pro Variables
+
 ## Version 7.4.4
 (Release: March 11, 2024)
 
