Download the PHP package justinholtweb/craft-xplain without Composer
On this page you can find all versions of the php package justinholtweb/craft-xplain. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download justinholtweb/craft-xplain
More information about justinholtweb/craft-xplain
Files in justinholtweb/craft-xplain
Package craft-xplain
Short Description Your Craft schema, explained where you build it. Xplain writes a developer tip onto every field in every field layout — how the field is stored, the Twig that reads it, and the gotcha worth knowing — using Craft’s own field tips, so the notes live in project config and deploy with the schema.
License proprietary
Homepage https://justinholt.com/plugins/craft-xplain
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package craft-xplain
Xplain
Your content schema, explained where you build it.
Every Craft 5 field layout lets you put a tip under each field — a note that sits in the entry form, shows a lightbulb in the field layout designer, and is stored in project config with the rest of the layout. Almost nobody writes them, because one note per field per layout is a job nobody has time for, and they go stale the day a setting changes.
Xplain writes them for you. For every field in every layout it says what the field stores, gives the
Twig that reads it in that layout — block. inside a Matrix, category. on a category group,
the renamed handle if the layout renamed it — and adds the one thing worth knowing: eager-load this,
compare the value not the label, zero is falsy. When the schema changes, the tips change with it.
Free. Craft 5.3+, PHP 8.2+. No database tables, no outbound requests, no runtime dependencies.
Why Craft's own tips
- They live in project config. Tips version with the schema, show up in pull requests, and
deploy with
project-config/apply. Nothing to migrate, nothing to sync. - They are where people look. Under the field in the entry form, and as a lightbulb in the field layout designer.
- They outlive the plugin. Uninstall Xplain and it takes its own tips with it — or keep them: they are ordinary Craft tips.
What it does
- Writes a tip for every field in every layout — entry types, Matrix entry types, category and tag groups, volumes, global sets, users, addresses, Content Block fields, Commerce product and variant types, and any plugin's layouts. It finds them all by walking project config, so there is no list of owners to fall behind.
- Keeps them current. Save a field or a layout and a queued job rewrites whatever changed — including the Matrix field whose note lists the entry type you just edited. Existing fields get their tips on install.
- Never touches your tips. Xplain records a hash of every tip it writes. A tip is Xplain's only while its text is exactly what Xplain wrote; edit one word and it is yours, and Xplain leaves it alone from then on.
- Keeps developer notes away from authors. Xplain's tips show to admins and to users with the See Xplain's developer tips permission. Hand-written tips still show to everyone — they are the author-facing notes the property was made for.
- Explains each field in full under its own settings screen: every layout it is in, the Twig
for each, the whole
{% switch %}for a Matrix field with every entry type's real field handles, an element query, a GraphQL selection, and every tip. - Exports the schema as one Markdown document — for a repo's docs folder, a handover, or a review.
- Checks in CI.
php craft xplain/tips/checkexits non-zero when a tip is missing or stale.
Field types
Plain Text, Email, URL, Link, Number, Range, Money, Lightswitch, Date, Time, Color, Country, Icon, JSON, Dropdown, Radio Buttons, Button Group, Checkboxes, Multi-select, Table, Addresses, Entries, Assets, Categories, Tags, Users, Matrix, Content Block, CKEditor and Redactor — and a fallback that reads the value type Craft itself declares for anything else. Plugins can describe their own field types with one event.
Install
Tips are written by a queued job straight away. Or, to see them first:
Commit the project config changes like any other schema change.
Console
Documentation
https://justinholt.com/plugins/craft-xplain/docs
License
The Craft License. See LICENSE.md. Xplain is free: no editions, no licence key, and no licensing
code in the plugin.
