Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions docs/add-ons/pro-variables/type.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,16 @@ Displays a date picker. To output anything other than a timestamp, use the `{exp

{exp:pro_variables:single var="my_var" modifier="relative"}

## File

Uses the native [File field](/fieldtypes/file.md). To output the variable, always use the `{exp:pro_variables:pair}` or `{exp:pro_variables:single}` tag where appropriate. If you try to address the variable by name only, it will return the content unparsed, e.g. `{file:XX:url}`. You can use File field [parameters](/fieldtypes/file.md#template-tag-usage) and [variables](/fieldtypes/grid.md#template-tags) using these tags. Additionally, one more parameter is available:

### Parameters

#### `modifier`

Allows applying modifiers, which, among other, are used to apply [on-the-fly image manipulations](/fieldtypes/grid.md#on-the-fly-image-manipulations) to files

## Grid

Uses the native [Grid field](/fieldtypes/grid.md). All native types are available, _except for Relationships_. To output the variable, use the `{exp:pro_variables:pair}` or `{exp:pro_variables:single}` tag where appropriate. You can use any of Grid’s [parameters](/fieldtypes/grid.md#parameters) and [variables](/fieldtypes/grid.ms#variables) using these tags. Additionally, one more parameter is available:
Expand Down
1 change: 0 additions & 1 deletion docs/channels/channel-form/examples.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,6 @@
{custom_fields}
<label for="{field_name}">{if required}* {/if}{field_label}</label>
{field_instructions}
{formatting_buttons}

{if error}
<p class="error">{error}</p>
Expand Down
1 change: 0 additions & 1 deletion docs/channels/channel-form/fields.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,6 @@ The Custom fields tag pair will conveniently show all your custom fields, but it

<label for="{field_name}">{if required}* {/if}{field_label}</label>
{field_instructions}
{formatting_buttons}

{if error}
<p class="error">{error}</p>
Expand Down
2 changes: 0 additions & 2 deletions docs/channels/channel-form/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -290,7 +290,6 @@ If using a field with options, such as Checkboxes or Dropdown, you can display t
{custom_fields}
<label for="{field_name}">{if required}* {/if}{field_label}</label>
{field_instructions}
{formatting_buttons}

{if error}
<p class="error">{error}</p>
Expand Down Expand Up @@ -383,7 +382,6 @@ Within this loop, you have the following single variables:
{field_id}
{error}
{field_instructions}
{formatting_buttons} - Shows the EE formatting buttons if have that option selected for that field
{display_field} - Displays the field as it appears in the CP (using the fieldtype API display_field method)
{text_direction}
{rows} - For textareas
Expand Down
2 changes: 1 addition & 1 deletion docs/development/services/alert.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Alerts are for providing feedback on an action and calling attention to warnings

[TOC=3]

### `make($name, $type = 'inline')`
### `make($name, $type = 'alert')`

Makes a new named alert of the specified type.

Expand Down
65 changes: 55 additions & 10 deletions docs/installation/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,15 +8,62 @@
-->
# ExpressionEngine v7 Change Log

## Version 7.2.17
(Release: May 2, 2023)

- **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/563996?v=4" /><div class="space-y-2"><div class="text-xs font-medium lg:text-sm"><p class="mb-1">Bryan Nielsen</p><p class="text-indigo-600"><a href="https://github.com/ExpressionEngine/ExpressionEngine/commits?author=bryannielsen" target="_BLANK">@bryannielsen</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/931642?v=4" /><div class="space-y-2"><div class="text-xs font-medium lg:text-sm"><p class="mb-1">Sobral</p><p class="text-indigo-600"><a href="https://github.com/ExpressionEngine/ExpressionEngine/commits?author=robsonsobral" target="_BLANK">@robsonsobral</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">Yulya Lebed</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>
<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>
</ul>
</div>
</div>

**Enhancements** 🚀

- Improved counting members on role
- Added extra information on RTE advanced configuration
- Resolved issue where icons on Channels page were not self-evident
- Enabled File field to be used as Pro Variable; [#2498](https://github.com/ExpressionEngine/ExpressionEngine/issues/2498)
- Added separate list with selected categories for Entry page Category tab [#2807](https://github.com/ExpressionEngine/ExpressionEngine/issues/2807)
- Added more information to template debugger when using `search` parameter in `exp:channel:entries`; [#2670](https://github.com/ExpressionEngine/ExpressionEngine/issues/2670)

**Bug Fixes** 💃🐛

- Wrap Structure global functions to avoid conflict
- Resolved [#3261](https://github.com/ExpressionEngine/ExpressionEngine/issues/3261) where empty Grid row could have been added in Fluid upon saving
- Resolved [#2148](https://github.com/ExpressionEngine/ExpressionEngine/issues/2148) where entry status was not updated after change of status name
- Resolved [#477](https://github.com/ExpressionEngine/ExpressionEngine/issues/477) where no information was provided when editing entry with status that's not accessible to member
- Resolved [#3331](https://github.com/ExpressionEngine/ExpressionEngine/issues/3331) Where Categories tab shows empty alert when no category groups assigned
- Resolved [#758](https://github.com/ExpressionEngine/ExpressionEngine/issues/758) where installation wizard did not work when PHP was configured to have no memory limit
- Resolved [#1795](https://github.com/ExpressionEngine/ExpressionEngine/issues/1795) Where display of negative numerical field has - placed incorrectly for RTL text direction
- Resolved issue where setting member field type might not work properly when called programmatically
- Resolved [#3224](https://github.com/ExpressionEngine/ExpressionEngine/issues/3224) where descending sorting order did not persist when using pagination in File Manager
- Resolved [#2609](https://github.com/ExpressionEngine/ExpressionEngine/issues/2609) where the permissions for Guests role could be incorrect and Guest could log in
- Resolved [#2570](https://github.com/ExpressionEngine/ExpressionEngine/issues/2570) where saving empty "Select Entries" Pro Variable was throwing SQL error
- Resolved [#2843](https://github.com/ExpressionEngine/ExpressionEngine/issues/2843) where Channel Form was saving file field data in old format
- Resolved [#2112](https://github.com/ExpressionEngine/ExpressionEngine/issues/2112) where deleting too many logs could cause the system go out of memory
- Resolved [#2387](https://github.com/ExpressionEngine/ExpressionEngine/issues/2387) where PHP error could be shown when several developer logs are existing
- Resolved [#3286](https://github.com/ExpressionEngine/ExpressionEngine/issues/3286) when warning was shown when using member fields with PHP 8.2

**Developers** 💻

- Added `GridColumn` model
- Improve error reporting when instantiating non-existent model
- Added relationships to model definitions that were missing
- Improve string-to-boolean conversion; [#1959](https://github.com/ExpressionEngine/ExpressionEngine/issues/1959)

## Version 7.2.16
(Release: April 24, 2023)

- **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/563996?v=4" /><div class="space-y-2"><div class="text-xs font-medium lg:text-sm"><p class="mb-1">Bryan Nielsen</p><p class="text-indigo-600"><a href="https://github.com/ExpressionEngine/ExpressionEngine/commits?author=bryannielsen" target="_BLANK">@bryannielsen</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/11818941?v=4" /><div class="space-y-2"><div class="text-xs font-medium lg:text-sm"><p class="mb-1">Matt Johnson</p><p class="text-indigo-600"><a href="https://github.com/ExpressionEngine/ExpressionEngine/commits?author=matthewjohns0n" target="_BLANK">@matthewjohns0n</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/931642?v=4" /><div class="space-y-2"><div class="text-xs font-medium lg:text-sm"><p class="mb-1">Sobral</p><p class="text-indigo-600"><a href="https://github.com/ExpressionEngine/ExpressionEngine/commits?author=robsonsobral" target="_BLANK">@robsonsobral</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">Yulya Lebed</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>
<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>
Expand All @@ -28,13 +75,11 @@

- Optimize logging developer messages; [#3057](https://github.com/ExpressionEngine/ExpressionEngine/issues/3057)
- Added keyboard shortcut for saving Pro Variables
- Added icon for video file
- Added icon for doc file type
- Installer / Updated now respects default theme colors
- Remove "blinks" into the drak on script loads
- Made styles a bit more generic for multiselect
- Added additional styles for long channel titles
- Resolved [#518](https://github.com/ExpressionEngine/ExpressionEngine/issues/518) where include in search was present on relaionthips and shouldn't be
- Resolved [#3222](https://github.com/ExpressionEngine/ExpressionEngine/issues/3222) where File icon in File field does not match field type
- Resolved [#2028](https://github.com/ExpressionEngine/ExpressionEngine/issues/2028) where Installer/Updater does not respect the theme
- Resolved [#3247](https://github.com/ExpressionEngine/ExpressionEngine/issues/3247), where H2 tag didn't respect theme colors on Redactor RTE
- Improved styles for Pages add-on settings
- Improved [#518](https://github.com/ExpressionEngine/ExpressionEngine/issues/518) where 'Include in search' option from Relationships field should have been hidden.

**Bug Fixes** 💃🐛

Expand All @@ -50,7 +95,7 @@
- Resolved [#3302](https://github.com/ExpressionEngine/ExpressionEngine/issues/3302) where Structure was showing deprecation notices when using PHP 8.2
- Resolved [#3191](https://github.com/ExpressionEngine/ExpressionEngine/issues/3191) where PHP errors could be shown when installing add-on that have a fieldtype and module
- Resolved [#3286](https://github.com/ExpressionEngine/ExpressionEngine/issues/3286) where PHP errors could be thrown on creating of a dynamic property
- Resolved [#510](https://github.com/ExpressionEngine/ExpressionEngine/issues/510) where Toggle field conditionals on frontend didn't handle defaults correctly
- Resolved [#510](https://github.com/ExpressionEngine/ExpressionEngine/issues/510) where existing entries did not have the correct value for toggle field after it was added to a channel it also did not prompt to update existing entries with the default toggle value

## Version 7.2.15
(Release: April 12, 2023)
Expand Down
15 changes: 15 additions & 0 deletions docs/templates/conditionals.md
Original file line number Diff line number Diff line change
Expand Up @@ -281,6 +281,21 @@ Tags that output numeric content will work fine with quotes, but also do not nee

{if {fluid_content:count type="long_form_text"} == 3}

If the conditional expression contains [variable modifiers](templates/variable-modifiers.md), braces should only be omited if the conditional is executed on a top-level variable (not Grid column or Fluid field element) and when there is only one check in the expression (no AND / OR operators).
In other words, you can only do following without braces:

{if grid_field:total_rows}

But you will need braces in there cases:

{if {grid_field:total_rows} AND {another_grid_field:total_rows}}

{if {grid_field:text_column:length}}

{fluid:rte_field}
{if '{content:has_excerpt}' == 'y'}<h1>Read More</h1>{/if}
{/fluid:rte_field}

## Short Conditionals

Certain conditionals exist in a shortened form in order to improve template readability. These conditionals are usually checking to see if a certain thing is true or exists:
Expand Down