Bootstrap Blocks

説明

WordPress 用 Bootstrap の Gutenberg ブロックです。Bootstrap v4 と v5 をサポートしています。このプラグインは、Bootstrap のコンポーネント (グリッドシステム, ボタン) とそれらのレイアウトオプションを Gutenberg ブロックとして追加します。

このプラグインの完全なドキュメント (英語) は、GitHub: https://github.com/liip/bootstrap-blocks-wordpress-plugin#readme でご覧いただけます。

利用可能なブロック

Bootstrap Container (コンテナ)

設定:

  • フルード(可変): 有効にすると、コンテナは使用可能な幅全体を使用し、ビューポートの幅いっぱいに拡がります。
  • フルード (可変) ブレークポイント: responsive containers を有効にします。この機能は、Bootstrap 4.4 以降でのみ動作します。コンテナは、指定したブレークポイントに達するまで、100% 幅となります。それ以上は、より広い最大幅のそれぞれのブレークポイントに設定された幅が適用されます。
  • 下マージン: Bootstrap Container ブロックの下マージンを設定

Bootstrap Row (行)

設定:

  • テンプレート: 內部の column ブロックのテンプレートを選択
  • 余白なし: カラム間の余白を無くす
  • 水平方向の配置: 内側の column ブロックの水平方向の配置
  • 垂直方向の配置: 内側の column ブロックの垂直方向の配置
  • エディターでカラムを縦並び: エディターでカラムを読みやすくするため、カラムを縦並びで表示します。
  • 水平方向の間隔: 水平方向の間隔のサイズ
  • 垂直方向の間隔: 垂直方向の間隔のサイズ

Bootstrap Column (列)

設定:

  • 全てのブレークポイント (xxl, xl, lg, md, sm, xs) でのサイズ: 指定されたブレークポイントで、カラムがどれだけスペースを使用するか。
  • 全てのブレークポイント (xxl, xl, lg, md, sm, xs) で等幅: 可能な場合、カラムは他のカラムと同じ幅に拡がります。
  • 背景色: カラムに背景色を設定
  • Content vertical alignment: Align content vertically in column. This option is only needed if a background color is set. Otherwise use the Alignment option of the outer row block.
  • Padding: カラム内側の余白 (Padding) の指定

Bootstrap Button (ボタン)

設定:

  • スタイル: ボタンのスタイルを選択
  • 新しいタブで開く: リンクを新しいタブで開く場合に選択
  • Rel: リンクの rel 属性をセットしてください。
  • 整列: ボタンの水平揃え

対応している Bootstrap のバージョン

このプラグインは、Bootstrap v4 と v5 をサポートしています。

Bootstrap のバージョンは、このプラグインの設定 (設定 > Bootstrap Blocks) で選択できます。 wp-config.phpWP_BOOTSTRAP_BLOCKS_BOOTSTRAP_VERSION 定数で指定することも可能です。

  • Bootstrap 4 (default): define( 'WP_BOOTSTRAP_BLOCKS_BOOTSTRAP_VERSION', '4' );
  • Bootstrap 5: define( 'WP_BOOTSTRAP_BLOCKS_BOOTSTRAP_VERSION', '5' );

現在の適用可能な値は '4''5' です。デフォルトでは、Bootstrap のバージョン4 が選択されています。

Bootstrap ライブラリ

このプラグインは Bootstrap ライブラリを含んでいませんので注意してください。ご自身でセットする必要があります。Bootstrap をロードする前に、使用者のニーズに合わせて設定 (CSS変数、読み込むパーシャル SCSS ファイルや JavaScript モジュール) を変更できるよう、ライブラリを含めないことにしました。

Bootstrap (CDN) をテーマの function.php で読み込むためのコードサンプルは、 documentation をご参照ください。

テンプレート

全てのブロックが、ダイナミックブロックです。これにより、テーマ内のブロックのテンプレートを上書きできます。

ブロックテンプレートのカスタマイズも可能です。テーマディレクトリに wp-bootstrap-blocks/ フォルダを作成し、その中にオリジナルテンプレート wp-bootstrap-blocks/src/templates/<blockname>.php を複製し編集してください。

必要条件

  • WordPress >= 5.0
  • PHP >= 5.6

より詳細な情報

スクリーンショット

  • Row ブロック
  • Column ブロック
  • Column ブロック (詳細設定)
  • Container ブロック

インストール

  1. /wp-content/plugins/ ディレクトリに wp-bootstrap-blocks ディレクトリをアップロードします。
  2. 管理画面のプラグインメニューから、Pluginsを有効にします
  3. Bootstrap Blocks カテゴリから、ブロックの追加を開始してください。

FAQ

どのバージョンの Bootstrap がサポートされていますか?

このプラグインは、Bootstrap v4 と v5 をサポートしています。

このプラグインは Bootstrap を含んでいますか?

いいえ。このプラグインは Bootstrap ライブラリを読み込みません。ご使用のテーマの中でご自身で Bootstrap を読み込む必要があります。詳細は documentation をご覧ください。

バグを見つけましたか?機能リクエストはありますか?

新しい GitHub イシューを作成し、私たちにお知らせください: https://github.com/liip/bootstrap-blocks-wordpress-plugin/issues

評価

2021年7月7日
And you have all the foundations you need for building quick, bespoke, and easy-to-manage websites for your clients. I'll be using this for all my projects from now on. Using ACF Pro to build the custom blocks required, and using these very handy container/row blocks to place my custom ACF blocks inside of. Just perfect.
2020年10月29日
I started using Bootstrap Blocks because I wanted a better WordPress back-end experience instead of actually coding raw code in a file. With Bootstrap Blocks, I can have a better back-end experience and have a peace of mind knowing that the developers working on the plugin are using Bootstrap best practices. The plugin is also regularly maintained and updated to work at its peek performance. I'm very happy with Bootstrap Blocks and I highly recommend for any developer who is working with WordPress + a Bootstrap theme.
2020年8月7日
Have you ever had a good experience trying to create rows / columns, with the default WordPress blocks, on a Bootstrap site / theme? Unless you used this plugin to do so, I highly doubt it. This plugin is the key to success in the above scenario, and makes it so blog posts look like they actually belong in the site, rather than just being an afterthought. Best of all, it's 100% open source! No annoying ads, no annoying paywall, just straight up solid functionality / support. If you use Bootstrap for your theme, you need to use this plugin. A big thank you to the developer(s)!
22件のレビューをすべて表示

貢献者と開発者

Bootstrap Blocks はオープンソースソフトウェアです。以下の人々がこのプラグインに貢献しています。

貢献者

“Bootstrap Blocks” は3ロケールに翻訳されています。 翻訳者のみなさん、翻訳へのご協力ありがとうございます。

“Bootstrap Blocks” をあなたの言語に翻訳しましょう。

開発に興味がありますか ?

コードを閲覧するか、SVN リポジトリをチェックするか、開発ログRSS で購読してみてください。

変更履歴

3.3.2

  • [FIX] Remove deprecated wp-editor dependency in newer versions of WordPress to avoid deprecation notice in widget screen (WordPress >= 5.8).

3.3.1

  • [COMPATIBILITY] Tested up to WordPress 5.8.
  • [FIX] Use new block_categories_all filter instead of deprecated block_categories to register custom block category.

3.3.0

  • [FEATURE] Added possibility to vertically align the content in a column block from the block controls.
  • [DEPRECATED] The centerContent attribute of the column block is deprecated. If enabled it will automatically be migrated to the new contentVerticalAlignment attribute.
  • Modified Templates: column.php

3.2.0

  • [FEATURE] Ability to transform multiple selected blocks into a row block. This feature only works with WordPress >= 5.6. Additionally custom templates (see wpBootstrapBlocks.row.enableCustomTemplate filter) must be enabled (which is the default).
  • [COMPATIBILITY] Bootstrap 5 is not flagged experimental anymore.
  • [COMPATIBILITY] Tested up to WordPress 5.7.2.
  • [DEVELOPMENT] Migrate E2E tests to Cypress.

3.1.3

3.1.2

  • [COMPATIBILITY] Tested up to WordPress 5.6.
  • [FIX] Fix editor styling issues when used with Twenty Twenty-One theme (which will be shipped with WordPress 5.6).

3.1.1

  • [FIX] Use unique jsonpFunction name in webpack config to avoid conflict with other plugins built with @wordpress/scripts. (Thanks CP-Antoine for the hint)
  • [IMPROVEMENT] Replace WordPress Dashicons with SVG icons.

3.1.0

  • [FEATURE] Add possibility to open link of button block in new tab.
  • [FEATURE] Add possibility to set the rel attribute of the button blocks link.
  • テンプレートの変更: button.php

3.0.0

This version adds (experimental) support for Bootstrap 5! Please read the documentation for further information.

  • [FEATURE] Add Bootstrap 5 support.
  • [FEATURE] Introduce new plugin options page (Settings > Bootstrap Blocks).
  • [FEATURE] Add options to define vertical and horizontal gutters sizes in row block (Bootstrap 5 only).
  • [FEATURE] Add support for Xxl breakpoint size (Bootstrap 5 only).
  • [FEATURE] Introduce new JavaScript filters for Bootstrap 5 specific options: wpBootstrapBlocks.row.horizontalGuttersOptions, wpBootstrapBlocks.row.verticalGuttersOptions. Please read the documentation for further information.
  • Modified Templates: column.php, row.php

2.4.3

  • [FIX] Import dependencies from @wordpress npm-packages instead of relying on the global wp namespace during development.
  • [FIX] Fix visibility of row, column and container blocks in WP 5.5.

2.4.2

  • [FIX] Fix loading of translations.
  • [FIX] Fix dependencies of editor script.
  • [TRANSLATION] Add Swiss-German translation.

2.4.1

  • [FIX] Fix documentation of wp_bootstrap_blocks_column_default_attributes filter (see: https://github.com/liip/bootstrap-blocks-wordpress-plugin#wp_bootstrap_blocks_column_default_attributes). sizeXY attributes have been defined as string values instead of int values in example. If you’re using this filter please check if you pass the values correctly. Passing string values to int attributes will stop working in WordPress 5.5.

2.4.0

  • [FEATURE] Possibility to enable stacked layout for column blocks in editor to enhance readability of block content. This feature can be enabled by default by setting the editorStackColumns value to true in the wp_bootstrap_blocks_row_default_attributes PHP filter.

2.3.1

  • [FIX] Regression in built assets which was introduced by the @wordpress/scripts package. Using multiple plugins which were built with the @wordpress/scripts build-script resulted in a JavaScript error.

2.3.0

  • [FEATURE] Visually show all column background colors in editor (not only preconfigured).
  • [DEVELOPMENT] Switch from @wordpress/scripts to @wordpress/env for local dev environment.
  • [DEVELOPMENT] Use official webpack config from @wordpress/scripts to compile scss files.

2.2.0

  • [IMPROVEMENT] Improve visibility of row, column and container blocks in editor.
  • [IMPROVEMENT] Do not automatically insert default block in wrapper blocks (column and container) [WordPress >=5.3].
  • [FIX] Replace usage of deprecated packages.

2.1.0

  • Breaking Change [CHANGE] Do not render empty content <div> in column template. This is a rather small change but it could break your current design (if it relies on this <div>). Please verify that this isn’t the case before updating.
  • [FIX] Fix styling issues of column block with WordPress 5.4.
  • Modified Templates: column.php

2.0.1

  • [IMPROVEMENT] Do not run version check on every request.
  • [FIX] Fix styling issues with Gutenberg plugin v7.2.
  • [FIX] Fix loading of translation files.
  • [FIX] Fix compatibility issues with WordPress <= v5.1.

2.0.0

This is a major update of the plugin. Please check if the mentioned breaking changes affect your code before updating to this version.

  • Breaking Change [REMOVE] Old object template structure for row templates is not supported anymore! Please update your templates to the new array structure (see filter documentation).
  • Breaking Change [REMOVE] Removed unused wpBootstrapBlocks.row.useOldObjectTemplateStructure filter.
  • Breaking Change [REMOVE] Removed wpBootstrapBlocks.container.useFluidContainerPerDefault filter. Please use wp_bootstrap_blocks_container_default_attributes filter instead.
  • Breaking Change [CHANGE] Removed unused wrapper-div from row template. The alignfull class now gets added directly to the row.
  • Breaking Change [CHANGE] Renamed wpBootstrapBlocks.container.customMarginOptions filter to wpBootstrapBlocks.container.marginAfterOptions.
  • [FEATURE] Support for responsive containers which were introduced in Bootstrap 4.4. Use them by setting the Fluid Breakpoint option in the container block.
  • [FIX] Reset centerContent attribute of column block if background-color gets removed.
  • [FIX] Check if className attribute isn’t empty before adding it to template to avoid empty strings in classes array.
  • [FIX] Fix filemtime() warning if asset version couldn’t be found.
  • Modified Templates: container.php, row.php, column.php, button.php

1.4.0

  • [CHANGE] Decrease loading priority of block editor assets to ensure that custom block filters are executed.
  • [CHANGE] Add custom classes of row block to row-div instead of wrapper-div.
  • [FEATURE] Added possibility to define equal-width columns.
  • [IMPROVEMENT] Improve template selection button styling when using a custom icon.
  • [IMPROVEMENT] Optimized editor styling of grid.
  • [IMPROVEMENT] Do not limit the width of child blocks inside the container block.
  • Modified Templates: column.php, row.php

1.3.1

  • [FIX] Fix meaning of wpBootstrapBlocks.row.useOldObjectTemplateStructure filter. In v1.3.0 boolean value was inverted.
  • [FIX] Fix add default icon to template if it’s missing.

1.3.0

In this release we changed the template structure for the row block form object to array (see template update guide). With this change we try to move towards the new template structure which will be introduced by the InnerBlocks template selector feature.

If you used the wpBootstrapBlocks.row.templates filter to modify the existing row templates please update your template structure accordingly (see filter documentation). The old structure will still work but is deprecated.

As soon as you have updated your template structure you need to disable the old object template structure with the wpBootstrapBlocks.row.useOldObjectTemplateStructure filter.

  • [IMPROVEMENT] Improve template selection in row block. Added possibility to set an icon for each template.
  • [IMPROVEMENT] Use withSelect / withDispatch HOCs in row block.

1.2.0

  • [FEATURE] Added new filter wp_bootstrap_blocks_enqueue_block_assets to disable enqueuing block assets.
  • [FIX] Fix enqueuing of script and style dependencies.

1.1.0

  • [FEATURE] Added possibility to set background color on column block.
  • [IMPROVEMENT] Optimized editor styling of row block.
  • Modified Templates: button.php, column.php, row.php

1.0.0

  • Initial release of this plugin