Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update glossary to include more block based terminology #26478

Merged
merged 2 commits into from Nov 2, 2020
Merged

Update glossary to include more block based terminology #26478

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4098d5c
Update glossary to include more block based terminology
annezazu Oct 26, 2020
514115f
Update glossary.md
annezazu Oct 27, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
12 changes: 12 additions & 0 deletions docs/designers-developers/glossary.md
View file
Open in desktop
Expand Up @@ -10,6 +10,9 @@
<dt>Block</dt>
<dd>The abstract term used to describe units of markup that, composed together, form the content or layout of a webpage. The idea combines concepts of what in WordPress today we achieve with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience.</dd>

<dt>Block Based Theme</dt>
<dd>A theme built in block forward way that allows Full Site Editing to work. The core of a block-based theme are its block templates and block template parts. To date, block-based theme templates have been HTML files of block markup that map to templates from the standard WordPress template hierarchy. </dd>

<dt>Block categories</dt>
<dd>These are not a WordPress taxonomy, but instead used internally to sort blocks in the Block Library.</dd>

Expand All @@ -19,6 +22,12 @@
<dt>Block name</dt>
<dd>A unique identifier for a block type, consisting of a plugin-specific namespace and a short label describing the block's intent. e.g. <code>core/image</code></dd>

<dt>Block Template</dt>
<dd>Templates are HTML files of block markup that map to templates from the standard WordPress template hierarchy, for example index, single or archive. This helps control the front-end defaults of a site that are not edited via the Page Editor or the Post Editor. </dd>

<dt>Block Template Part</dt>
<dd>Building on Block Templates, these parts help set structure like a Footer or Header that one typically sees in a WordPress site. With Full Site Editing and block based themes, users can create their own arbitrary Template Parts, save those in the database for their site, and re-use them throughout their site.</dd>
annezazu marked this conversation as resolved.
Show resolved Hide resolved

<dt>Patterns</dt>
<dd>Patterns are predefined layouts of blocks that can be inserted as starter content that are meant to be changed by the user every time. Once inserted, they exist as a local save and are not global.</dd>

Expand All @@ -31,6 +40,9 @@
<dt>Dynamic block</dt>
<dd>A type of block where the content of which may change and cannot be determined at the time of saving a post, instead calculated any time the post is shown on the front of a site. These blocks may save fallback content or no content at all in their JavaScript implementation, instead deferring to a PHP block implementation for runtime rendering.</dd>

<dt>Full Site Editing </dt>
<dd>This refers to a collection of features that ultimately allows users to edit their entire website using blocks as the starting point. This feature set includes everything from block patterns to global styles to templates to design tools for blocks (and more). Currently, it's still in an experimental phase.</dd>

<dt>Inspector</dt>
<dd>Deprecated term. See <a href="#settings-sidebar">Settings Sidebar.</a></dd>

Expand Down