Block registration in Wordpress - Cheat Sheet & Quick Revision

Recall & Review

beginner

What is block registration in WordPress?

Block registration is the process of telling WordPress about a new block so it can be used in the block editor. It defines the block's name, appearance, and behavior.

beginner

Which function is used to register a block in WordPress?

The function register_block_type() is used to register a block in WordPress. It links the block's name with its settings and scripts.

beginner

What are the two main parts you need to register a block?

You need a unique block name (like namespace/block-name) and an array of settings that include scripts, styles, and render callbacks.

intermediate

Why do you need to enqueue scripts and styles when registering a block?

Scripts and styles are needed to make the block work and look right in the editor and on the website. Enqueuing them ensures they load only when needed.

intermediate

What is the role of the render_callback in block registration?

The render_callback is a PHP function that generates the block's HTML on the server side. It allows dynamic content to show when the block is displayed.

Which function registers a block in WordPress?

A register_post_type()

B register_block_type()

C enqueue_block_assets()

D add_block_script()

The correct function to register a block is register_block_type().

What format should the block name have?

A namespace/block-name

B block-name

C block_name

D blockName

Block names must have a namespace and a name separated by a slash, like namespace/block-name.

Why do you use render_callback in block registration?

A To generate dynamic HTML on the server

B To add CSS styles

C To register block categories

D To load JavaScript files

render_callback generates dynamic HTML on the server side for the block.

Where do you usually call register_block_type()?

A Inside the block editor JavaScript

B In the WordPress admin settings

C In the theme's functions.php or a plugin PHP file

D In the block's CSS file

You call register_block_type() in PHP files like functions.php or a plugin to register the block.

What happens if you don't enqueue block scripts properly?

A Nothing, scripts are optional

B The block will load faster

C The block will be available everywhere

D The block might not work or display correctly

Without proper scripts, the block may not function or look as expected.

Explain the steps to register a new block in WordPress.

Think about what WordPress needs to know to add your block to the editor.

Describe why enqueuing scripts and styles is important in block registration.

Consider what happens if the block has no styles or scripts.

Practice

1. What is the main purpose of registerBlockType in WordPress block development?

easy

A. To add a new custom block to the WordPress editor

B. To register a new theme for WordPress

C. To create a new user role in WordPress

D. To install a plugin automatically

Solution

1. Step 1: Understand the role of registerBlockType

   This function is used specifically to add custom blocks to the WordPress block editor.

2. Step 2: Compare with other WordPress features

   Registering themes, user roles, or plugins are done by different functions, not registerBlockType.

3. Final Answer:

   To add a new custom block to the WordPress editor -> Option A

4. Quick Check:

   Block registration = add custom block [OK]

Hint: Remember: registerBlockType = add custom block [OK]

Common Mistakes:

• Confusing block registration with theme or plugin registration
• Thinking it creates user roles
• Assuming it installs plugins automatically

2. Which of the following is the correct way to start registering a block named "myplugin/example" in JavaScript?

easy

A. registerBlockType('myplugin_example', { edit: () => {}, save: () => {} });

B. registerBlock('myplugin/example', { edit: () => {}, save: () => {} });

C. registerBlockType('myplugin/example', { edit: () => {}, save: () => {} });

D. registerBlockType('myplugin/example');

Solution

1. Step 1: Identify the correct function name and parameters

   The correct function is registerBlockType and it requires a unique block name and an object with edit and save functions.

2. Step 2: Check the block name format and object completeness

   The block name must be a string with a namespace and name separated by a slash, like 'myplugin/example'. The object must include both edit and save functions.

3. Final Answer:

   registerBlockType('myplugin/example', { edit: () => {}, save: () => {} }); -> Option C

4. Quick Check:

   Correct function and full object = registerBlockType('myplugin/example', { edit: () => {}, save: () => {} }); [OK]

Hint: Use registerBlockType with namespace/name and edit/save [OK]

Common Mistakes:

• Using registerBlock instead of registerBlockType
• Using underscore instead of slash in block name
• Omitting edit or save functions

3. Given this block registration code snippet, what will be the saved content output in the post?

registerBlockType('myplugin/simple', {
  edit: () => {
    return wp.element.createElement('p', null, 'Hello Editor');
  },
  save: () => {
    return wp.element.createElement('p', null, 'Hello Saved');
  }
});

medium

A. <p>Hello Editor</p>

B. <p>Hello Saved</p>

C. Hello Editor

D. Hello Saved

Solution

1. Step 1: Understand the difference between edit and save functions

   The edit function controls what the editor shows while editing. The save function controls what HTML is saved and shown on the front end.

2. Step 2: Identify the saved output

   The save function returns a paragraph with text 'Hello Saved', so this is the content saved in the post and shown to visitors.

3. Final Answer:

   <p>Hello Saved</p> -> Option B

4. Quick Check:

   Saved content = save() output = <p>Hello Saved</p> [OK]

Hint: Remember: save() output is what visitors see [OK]

Common Mistakes:

• Confusing edit() output with saved content
• Ignoring that save() returns HTML elements
• Assuming edit() content is saved

4. Identify the error in this block registration code:

registerBlockType('myplugin/test', {
  edit() {
    return <p>Edit Block</p>
  },
  save() {
    return <p>Save Block</p>
  }
});

medium

A. JSX syntax used without React or Babel setup

B. Block name missing namespace

C. Missing semicolons after return statements

D. edit and save functions must be arrow functions

Solution

1. Step 1: Check the syntax used in edit and save functions

   The code uses JSX syntax like <p>Edit Block</p> directly, which requires React and Babel setup to compile.

2. Step 2: Identify environment requirements

   If JSX is used without proper setup, this code will cause syntax errors. The code should use wp.element.createElement or have JSX compiled.

3. Final Answer:

   JSX syntax used without React or Babel setup -> Option A

4. Quick Check:

   JSX needs compilation = JSX syntax used without React or Babel setup [OK]

Hint: JSX needs React/Babel; otherwise use createElement [OK]

Common Mistakes:

• Assuming JSX works without setup
• Thinking semicolons are mandatory after return
• Believing edit/save must be arrow functions

5. You want to register a block that shows a list of items passed as an attribute and saves them as a comma-separated string. Which approach correctly registers this block?

hard

A. Store the list as a string attribute, use edit to split it into an array, and save to output the array directly.

B. Store the list as an object attribute, use edit to convert it to string, and save to output JSON.

C. Use no attributes, hardcode the list in save, and ignore edit.

D. Use attributes to store an array, edit to update it, and save to join array into a string inside a <p> tag.

Solution

1. Step 1: Define attributes properly for data handling

   To handle a list, store it as an array attribute so it can be easily manipulated in edit.

2. Step 2: Implement edit and save functions correctly

   edit updates the array attribute. save joins the array into a comma-separated string inside a paragraph tag for saving as HTML.

3. Final Answer:

   Use attributes to store array, edit to update, save to join as string -> Option D

4. Quick Check:

   Array attribute + join in save = Use attributes to store an array, edit to update it, and save to join array into a string inside a <p> tag. [OK]

Hint: Store list as array attribute, join in save() output [OK]

Common Mistakes:

• Storing list as string and trying to output array directly
• Ignoring attributes and hardcoding data
• Saving data as JSON instead of HTML