mmikkel / cp-field-inspect
Inspect field handles and easily edit field and element source settings
Installs: 478 340
Dependents: 18
Suggesters: 0
Security: 0
Stars: 29
Watchers: 2
Forks: 5
Open Issues: 1
Type:craft-plugin
Requires
- php: ^8.2
- craftcms/cms: ^5.0.0
- dev-master
- 2.0.x-dev
- 2.0.2
- 2.0.1
- 2.0.0
- 2.0.0-beta.5
- 2.0.0-beta.4
- 2.0.0-beta.3
- 2.0.0-beta.2
- 2.0.0-beta.1
- 2.0.0-alpha.4
- 2.0.0-alpha.3
- 2.0.0-alpha.1
- v1.x-dev
- 1.4.4
- 1.4.3
- 1.4.2
- 1.4.1
- 1.4.0.1
- 1.4.0
- 1.3.1
- 1.3.0
- 1.2.6
- 1.2.5
- 1.2.4
- 1.2.3
- 1.2.2
- 1.2.1
- 1.2.0
- 1.1.3
- 1.1.2
- 1.1.0.1
- 1.1.0
- 1.0.7
- 1.0.6
- 1.0.5
- 1.0.4
- 1.0.2
- 1.0.1
- 1.0.0
- 1.0.0-beta.1
- dev-develop
This package is auto-updated.
Last update: 2024-11-05 08:15:00 UTC
README
CP Field Inspect is a tiny utility plugin, that makes content modelling a little bit easier in Craft.
The plugin adds two things to the Craft control panel (hence the first part of the name!):
-
A link for quickly accessing field settings to the field handles in element edit forms (for admin users who opt to display those). This link appears as a little cogwheel inside the field handle, and clicking this link redirects you to the fields' settings pages, and back to your content when you save the settings.
-
Links for quickly accessing element source settings (i.e. entry type, section, volume, category group etc.) to element edit forms, cards, chips and inline Matrix entries (nee blocks)
The caveats!
CP Field Inspect will only add field settings links and element source buttons to the Craft control panel if
- The logged-in user is an admin
allowAdminChanges
istrue
If either of the above are false, CP Field Inspect will do absolutely nothing.
Additionally, the field settings cogwheels requires the "Show field handles in edit forms" admin user preference.
Requirements
This plugin requires Craft CMS 5.0+.
But, the plugin doesn't appear to do anything!
If CP Field Inspect's links won't appear in environments where allowAdminChanges
is enabled and the user is an admin, the reason is most likely due to the site having one or several plugins or custom modules installed, that call Craft::$app->getUser()->getIdentity()
or related methods from within their constructor or init()
methods. This has been confirmed, due to a bug in Craft, to prevent CP Field Inspect from displaying the cogwheels, since Craft::$app->getUser()->getIsAdmin()
will actually return a false negative in plugins, in this scenario.
The workaround is to defer any calls to Craft::$app->getUser()
(such as Craft::$app->getUser()->getIdentity()
etc.) in the offending custom module to after Craft has finished initialising (the below would go in your custom module's primary class):
public function init() { parent::init(); Craft::$app->onInit(function () { $this->doIt(); } } protected function doIt() { $currentUser = Craft::$app->getUser()->getIdentity(); // ... all other logic dependant on `$currentUser` }
Disclaimer
Please report any bugs or other issues here.
Plugin icon: CUSTOMIZE SEARCH by creative outlet from the Noun Project