-
Notifications
You must be signed in to change notification settings - Fork 299
How to Build a WordPress Theme in WordPress Playground #2193
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: trunk
Are you sure you want to change the base?
How to Build a WordPress Theme in WordPress Playground #2193
Conversation
|
||
# How to Build a WordPress Theme in WordPress Playground | ||
|
||
WordPress Playground is a powerful tool that lets you build, preview, and export WordPress themes—all in your browser or locally via `wp-now`. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Let's use Playground CLI in examples because that's the tool we are focused on.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
How does this docs page fit in with the existing theme development section?
@bgrgicak May be we can enhance the theme development section with our new page content? More insights will be helpful |
This could become a Block theme development using the Playground Website section on the existing page. Regarding the content you created, you were precise in explaining how to configure Playground, which is nice and makes it clear for the user. With Playground, we can take it a step further and replace these setup instructions with a Playground link that contains a Blueprint, so users can have a Playground ready to go in one click. 🙂 |
Out of the 8 steps which I have added, what are all the points that can be removed and replaced? Also adding this json link ( https://playground.wordpress.net/?blueprint=https%3A%2F%2Fgithub.com%2Fwordpress%2Fblueprints%2Fblob%2Ftrunk%2Fblueprints%2Fcreate-block-theme%2Fblueprint.json ) to playground does not activate the "create block theme" in playground. What mistake i am doing here? cc @bph |
@karthick-murugan two things:
|
@bph do you think this one is good to go? |
@adamziel @karthick-murugan I'll review again tomorrow first thing. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@karthick-murugan Hi there,
We already have a Guide for WordPress Theme developers. Wouldn't it be less duplication if you augment the comment there?
For instance would be it quite helpful to add the workflow from this Hallway Hangout to the documentation
3. Choose WordPress and PHP versions if needed | ||
4. Click **"Launch"** | ||
|
||
### Locally with `wp-now` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would remove the wp-now reference and instructions, as it's going to be replaced by Playground CLI. The commands not correct anyway.
It would be npx @wp-now/wp-now start
- [Gutenberg](https://wordpress.org/plugins/gutenberg/) | ||
- [Theme Check](https://wordpress.org/plugins/theme-check/) | ||
|
||
Directly use playground links to load plugins: https://playground.wordpress.net/#%7B%22plugins%22:%5B%22hello-dolly%22,%22gutenberg%22%5D,%20%22login%22:%20true,%20%22landingPage%22:%20%22/wp-admin/plugins.php%22%20%7D |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This Playground link only installs the hello-dolly plugin again and the Gutenberg plugin but not the Create-Block-Theme plugin.
2. Click **Choose File** and select your `.zip` theme file | ||
3. Click **Install Now** | ||
4. Once installed, click **Activate** | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
These built up could be solved much faster with a blueprint and that would have the advantage that it can be called repeatedly with only one click and a step.
Fixes #1257
This PR adds a new documentation page that explains how to build a WordPress theme using WordPress Playground. The guide is aimed at theme developers and contributors looking for a fast, browser-based workflow to build, test, and share themes without needing a local setup.
✅ What’s Included