sage/resources/views/blocks/example/README.md

Bad Egg's Native Wordpress Block Example

This block serves as a placeholder that can be copied and extended to build native Wordpress blocks.

Features

• Automatic registration and asset building through the theme's app/blocks.php file and vite.config.js
• Automatic enqueueing of block scripts and styles if the correct files are included in the block's directory
• Supports Laravel Blade templates if the render.blade.php file is present, with access to the $attributes, $block, and $content variables.
• Default block attributes are defined in resources/json/block-attributes.json so that they are not needed in duplicate in block.json
• A reusable customisation UI is defined in resources/js/blocks/components/BlockSettings.jsx so that multiple blocks can rely on the same controls

Directory Structure

app
│   ...
│
│   blocks.php  ->  this is where the auto registration functions live
│
resources
│   ...
│
└── js
│   └── editor.js
│
└── views
    │   ...
    │
    └── blocks
        │   ...
        │
        └── example
            │  README.md         ->   this file
            │  block.json        ->   (required) the block's metadata
            │  index.jsx         ->   (required) EditorScript
            │  script.js         ->   (optional) Editor & Front end
            │  view.js           ->   (optional) Front end
            │  editor.scss       ->   (optional) Editor
            │  style.scss        ->   (optional) Editor & Front end
            │  render.blade.php  ->   (optional) falls back to index.jsx save