A WordPress plugin to create block themes https://wordpress.org/plugins/create-block-theme/
Find a file
2023-04-27 15:52:17 +01:00
.github/workflows Merge pull request #257 from WordPress/fix-package-lock 2023-03-02 11:59:55 -05:00
.husky Add commit hook 2023-02-01 10:58:44 +00:00
.wordpress-org Update screenshots 2023-03-15 15:56:47 -03:00
admin Merge branch 'trunk' into add/handle-google-font-credits 2023-04-27 15:52:17 +01:00
assets revert changes to fonts litst 2023-04-27 10:14:06 -03:00
includes Merge pull request #304 from WordPress/add/theme-name-validation 2023-04-27 10:49:39 -03:00
src Merge branch 'trunk' into add/handle-google-font-credits 2023-04-27 15:52:17 +01:00
.browserslistrc Add browserlist config 2023-02-01 10:45:13 +00:00
.distignore moving assets files 2022-10-26 16:13:11 -03:00
.editorconfig Add browserlist config 2023-02-01 10:45:13 +00:00
.eslintignore Add browserlist config 2023-02-01 10:45:13 +00:00
.eslintrc.json Try disabling no-undef rule specifically 2023-02-08 15:01:29 +00:00
.gitignore Add .vscode directory to gitignore 2023-04-26 15:28:52 -04:00
.nvmrc Specify node and npm versions, add nvmrc file 2023-01-19 18:04:58 +08:00
.prettierignore Make prettier and stylelint ignore dirs consistent 2023-02-07 12:08:05 +00:00
.prettierrc.js Add prettier and stylelint config files 2023-02-01 10:39:16 +00:00
.stylelintignore Make prettier and stylelint ignore dirs consistent 2023-02-07 12:08:05 +00:00
.stylelintrc.json Add prettier and stylelint config files 2023-02-01 10:39:16 +00:00
babel.config.js Use npm:wp-prettier instead of prettier 2023-02-02 15:25:35 +00:00
CODE_OF_CONDUCT.md Add code of conduct 2023-02-10 16:54:04 +00:00
composer.json Remove php-font-lib 2023-04-19 13:17:50 +01:00
composer.lock Remove php-font-lib 2023-04-19 13:17:50 +01:00
CONTRIBUTING.md Add composer to prerequisites 2023-02-13 16:21:39 +00:00
create-block-theme.php Version bump & changelog update 2023-04-27 14:48:52 +00:00
index.php Results of lint:php:fix 2023-01-27 17:27:18 +00:00
LICENSE Initial commit 2021-10-29 13:39:09 +01:00
package-lock.json Version bump & changelog update 2023-04-27 14:48:52 +00:00
package.json Version bump & changelog update 2023-04-27 14:48:52 +00:00
phpcs.xml.dist Merge branch 'trunk' into add/handle-google-font-credits 2023-04-27 15:52:17 +01:00
README.md Move dev only notice higher up 2023-02-13 16:14:13 +00:00
readme.txt Version bump & changelog update 2023-04-27 14:48:52 +00:00
update-google-fonts-json-file.js fix js lint issues 2023-03-01 15:57:56 +05:30
update-version-and-changelog.js avoid erroring when the tag doesn't exist. For example when you run twice the updater and you haven't created a new tag in the repo. 2023-03-22 12:11:22 -03:00
webpack.config.js local fonts upload: refactor ui from php and vanilla js to react app 2023-03-10 10:23:22 +04:00

Create Block Theme

Welcome to Create Block Theme - a WordPress plugin to create block themes from within the Site Editor.

It works alongside features that are already available in the Site Editor to enhance the workflow for creating block themes. After being tested in this plugin, some of the features included here may be moved into the Site Editor itself.

The plugin is for development only — it is not intended for use on production websites, but to be used as a tool to create new themes.

This plugin allows you to:

  • Export your existing theme with all customizations made in the Site Editor
  • Create a new theme, blank theme, child theme, or style variation from the Site Editor
  • Embed Google Fonts locally in your theme
  • Embed local font assets in your theme

Learn more about how to use the plugin or how to contribute.

User Support

If you have run into an issue, you should check the Support Forums first. The forums are a great place to get help. If you have a bug to report, please submit it to this repository as an issue. Please search prior to creating a new bug to confirm its not a duplicate.

Plugin Features

Theme Creation Options

There are six options the plugin provides to create a new theme:

1. Export

Export the activated theme including the user's changes.

2. Create a child theme

Creates a new child theme with the currently active theme as a parent.

3. Clone the active theme

Creates a new theme by cloning the activated theme. The resulting theme will have all of the assets of the activated theme combined with the user's changes.

4. Overwrite theme files

Saves the user's changes to the theme files and deletes the user's changes from the site.

5. Generate blank theme

Generate a boilerplate "empty" theme inside of the current site's themes directory.

6. Create a style variation

Saves user's changes as a style variation of the currently active theme.

Embed Google Fonts or local font files

This feature allows you to embed fonts into your active theme. You can embed Google Fonts and local font assets.

When you add a font the plugin will add to your theme:

  • The font files to your theme's file structure under this path ./assets/fonts.
  • The font face definitions to the theme.json file.

You can continue using your modified theme or you can export it as a new theme containing the new fonts.

How to Use the Plugin

Step 1: Setup

To use the latest release of the Create Block Theme plugin on your WordPress site: install from the plugins page in wp-admin, or download from the WordPress.org plugins repository.

In the WordPress Admin Dashboard, under Appearance there will be three new pages called:

  • Create Block Theme
  • Embed Google font in your active theme
  • Embed local font file assets

Step 2: Fonts, styles and templates customizations

Make changes to your site styles and templates using the Site Editor. You can also include new fonts using the plugin options.

Step 3: Save

Still in the WordPress dashboard, navigate to "Appearance" -> "Create Block Theme" section. Select one of the available options and then, if necessary, add the details for the theme here. These details will be used in the style.css file. Click the "Generate" button to save the theme.

How to Contribute

We welcome contributions in all forms, including code, design, documentation, and triage. Please see our Contributing Guidelines for more information.