Contexts

Contextual awareness is a crucial part of Pimcore Copilot. Therefore, Pimcore Copilot can filter available actions for a current context the user has. So it provides the user with the most relevant actions based on its current context.

Following contexts are supported:

• Assets
  • Including all subtypes (images, videos, ...)
  • Including selections in the grid
• Documents
  • Including all subtypes (Pages, Snippets, ...)
• Objects
  • Including all subtypes created via Data Object class editor (e.g. Cars, News, Events, ...)
  • Including selections in the grid
• Panel id (of currently opened and active tab, e.g. translations tab)
  • Limit actions to specific panels

info

Limitation to selection in grid is only available for objects and assets. For documents, you can only limit to a specific document type. Additionally, the configured action with selection context will not be displayed, if there is no selection in the grid.

Example configurations

1.) Limit an action to assets (or documents, objects) only

pimcore_copilot:
  automation_actions:
    step_implementation_mapping:
      asset_relation_object_meta: 
        class: 'Pimcore\Bundle\CopilotBundle\AutomationAction\Messenger\Messages\Generic\GenericAssetObjectRelationByMetaMessage'
    actions:
      asset_relation_object_meta:
        triggers:
          manual:
            enabled: true
            context_limitations: [ 'asset' ] #or 'document' or 'object'
            search_terms: [ ]
    ...

2.) Limit an action to specific objects (or assets, documents) only

pimcore_copilot:
  automation_actions:
    step_implementation_mapping:
      asset_relation_object_meta: 
        class: 'Pimcore\Bundle\CopilotBundle\AutomationAction\Messenger\Messages\Generic\GenericAssetObjectRelationByMetaMessage'
    actions:
      asset_relation_object_meta:
        triggers:
          manual:
            enabled: true
            context_limitations: [ 'object_Car' ] #or 'asset_image' or 'document_page'
            search_terms: [ ]
    ...

3.) Limit an action to a selection in the grid for objects (or assets) only

pimcore_copilot:
  automation_actions:
    step_implementation_mapping:
      asset_relation_object_meta: 
        class: 'Pimcore\Bundle\CopilotBundle\AutomationAction\Messenger\Messages\Generic\GenericAssetObjectRelationByMetaMessage'
    actions:
      asset_relation_object_meta:
        triggers:
          manual:
            enabled: true
            context_limitations: [ 'object_Car_selection' ] #or 'asset_image_selection'
            search_terms: [ ]
    ...