eminos / statamic-element-picker

A Statamic addon that adds an Element Picker fieldtype and lets you pick an element and generate a unique CSS selector for that element.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Statamic Element Picker

A Statamic plugin that adds an Element Picker Fieldtype.
Pick an element and get its short and unique "CSS selector".

Screenshot of the Element Picker Fieldtype

Installation

Install this plugin using composer.

composer require eminos/statamic-element-picker

Features

  • Pick an element right on that page or a configurable URL.
  • Configure where the URL is coming from.
    • Set the URL in the field config.
    • Let the URL come from a sibling or ancestor field (works inside Grids or Replicators as well).
  • If you choose to use a URL a new window will open with that URL where you can pick your element with a click.
  • Saves a short and unique "CSS selector" for that element which you can use to find the element again (uses finder under the hood).

Here's a screenshot of the config options.

Screenshot of the Element Picker field config

Known limitations

  • The URL must be the same origin as the page where the Element Picker is loaded. In other words you can only pick an element from the same domain as the control panel. This is because of the security in how messaging between open windows/tabs work. There might be a workaround involving Shadow DOM or similar.

Possible improvements

  • Option to set the URL right on the Element Picker field itself. This can optionally get saved together with the CSS selector string.
  • Configurable CSS selector generation / finder.
  • Configurable inspector design, background color, border, etc.

License

The MIT License (MIT). Please see License File for more information.

About

A Statamic addon that adds an Element Picker fieldtype and lets you pick an element and generate a unique CSS selector for that element.

License:MIT License


Languages

Language:Vue 41.3%Language:JavaScript 39.2%Language:PHP 18.0%Language:CSS 1.4%