Skip to content

1 6 Entrepot Block Repositories

imath edited this page Jan 18, 2019 · 1 revision

Using Entrepôt

Thanks to the Entrepôt you can enjoy an alternative source of public & free Blocks that are hosted on GitHub.com. Once activated, you will be able to browse, install, activate, deactivate, remove and upgrade the registered block types directly from your WordPress Administration.

Browsing the Entrepôt

To browse the Entrepôt you need to go to the "Block Types" WordPress Administration Screen. If you use a multisite configuration, you need to do this at the Network Administration level. On both configurations, this Administration screen is reachable from the "Block Types" Administration menu.

The Block Types Installed Tab

When you will first vist this screen, you will see the above list of blocks: an empty one. No worries, it's perfectly ok as it's your first visit, there's a good chance you haven't downloaded any Entrepôt registered Block types. To start installing new blocks, you will need to activate the "Available" tab.

The Block Types Available Tab

At the time I'm writing this page, there is only one available block. I've built it to show to custom block types developers how they can register a block and use the Entrepôt API to ease their work and the way they share it with you. If you are a developer, I advise you to read this documentation. Let's hope more and more of them will join the Entrepôt so that you will have more and more choice !

Install an Entrepôt registered block

Simply click on the "Install" button of the block you wish to download into the /wp-content/blocks directory of your site. This directory is not a native WordPress one as WordPress.org does not have a Blocks directory yet! Entrepôt adds it when upgrading to or installing its 1.5+ version.

Installing a block type

Activate/Deactivate or Remove an Entrepôt registered block

Once the download is complete, you will be able to activate the block using the corresponding blue button.

Now you've installed your first "standalone" * block, you will find it into the Installed tab of the Administration screen. You can alternatively activate, deactivate or delete the block at anytime using the buttons or links that are displayed under the Block Type's name.

Activate a block type Deactivate a block type
Activation Deactication

* Standalone because unlike what happens so far on WordPress.org, the block types registered on the Entrepôt do not need to be encapsulated into a plugin.

Upgrading a block

Block upgrade

Just like any WordPress.org theme or plugin, you can upgrade an Entrepôt registered block simply by clicking on the Upgrade button that is appearing under the Block name when a new version of it is available.