Conditions + element source improvements

[brandonkelly]

Overview

This is a bit of a loaded PR. It does the following:

• Moves element index settings to the project config
• Adds a condition builder framework (powered by Htmx)
• Adds element index filtering (Sort/Filter Entries by 'Entry Type' #9192, Filter entries by date #9450, etc.)
• Adds custom element index sources (Smart Sources #8423)

Creating conditions

Condition classes must implement craft\conditions\ConditionInterface. A generic base implementation is provided by craft\conditions\BaseCondition, as well as one tailored for modifying a database query: craft\conditions\BaseQueryCondition.

Condition rules must implement craft\conditions\ConditionRuleInterface; query condition rules must also implement craft\conditions\QueryConditionRuleinterface.

A condition builder’s HTML can be generated via $condition->getBuilderHtml(), which supports a few builder-specific options:

• mainTag – The container tag type (form by default)
• id – The container ID
• sortable – Whether the rules should be user-sortable (true by default)
• singleUseTypes – Whether rules can only be used once within the condition
• projectConfigTypes - Whether to limit the available rules to those which can be stored in the project config (needed for custom sources)

Element query conditions

Element types can provide their own custom condition classes which extend craft\conditions\elements\ElementQueryCondition. Doing so will give them a chance to include additional element type-specific rules, by overriding conditionRuleTypes() (see EntryQueryCondition for an example).

The element type can return an instance of it from its static createCondition() method.

Field condition rules

Field types can provide a rule type which implements craft\conditions\elements\fields\FieldConditionRuleInterface and uses craft\conditions\elements\fields\FieldConditionRuleTrait.

The field type can return its class name from its getQueryConditionRuleType() method.

To-do

• Accessibility audit
• Use Garnish.DragSort for rule sorting
• Add condition rules for most built-in field types
• Add element query conditions for all built-in element types
• Ability to limit custom sources to certain user groups
• Update the source translation file
• Update the changelog