wordpress / twentytwentythree Goto Github PK
View Code? Open in Web Editor NEWTwenty Twenty-Three, the default WordPress theme sporting many styles that will launch with WordPress 6.1.
Twenty Twenty-Three, the default WordPress theme sporting many styles that will launch with WordPress 6.1.
<!DOCTYPE html> <html lang="en"> <head> <meta name="viewport" content="width=device-width" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>WordPress › ReadMe</title> <link rel="stylesheet" href="wp-admin/css/install.css?ver=20100228" type="text/css" /> </head> <body> <h1 id="logo"> <a href="https://wordpress.org/"><img alt="WordPress" src="wp-admin/images/wordpress-logo.png" /></a> </h1> <p style="text-align: center">Semantic Personal Publishing Platform</p> <h2>First Things First</h2> <p>Welcome. WordPress is a very special project to me. Every developer and contributor adds something unique to the mix, and together we create something beautiful that I am proud to be a part of. Thousands of hours have gone into WordPress, and we are dedicated to making it better every day. Thank you for making it part of your world.</p> <p style="text-align: right">— Matt Mullenweg</p> <h2>Installation: Famous 5-minute install</h2> <ol> <li>Unzip the package in an empty directory and upload everything.</li> <li>Open <span class="file"><a href="wp-admin/install.php">wp-admin/install.php</a></span> in your browser. It will take you through the process to set up a <code>wp-config.php</code> file with your database connection details. <ol> <li>If for some reason this does not work, do not worry. It may not work on all web hosts. Open up <code>wp-config-sample.php</code> with a text editor like WordPad or similar and fill in your database connection details.</li> <li>Save the file as <code>wp-config.php</code> and upload it.</li> <li>Open <span class="file"><a href="wp-admin/install.php">wp-admin/install.php</a></span> in your browser.</li> </ol> </li> <li>Once the configuration file is set up, the installer will set up the tables needed for your site. If there is an error, double check your <code>wp-config.php</code> file, and try again. If it fails again, please go to the <a href="https://wordpress.org/support/forums/">WordPress support forums</a> with as much data as you can gather.</li> <li><strong>If you did not enter a password, note the password given to you.</strong> If you did not provide a username, it will be <code>admin</code>.</li> <li>The installer should then send you to the <a href="wp-login.php">login page</a>. Sign in with the username and password you chose during the installation. If a password was generated for you, you can then click on “Profile” to change the password.</li> </ol> <h2>Updating</h2> <h3>Using the Automatic Updater</h3> <ol> <li>Open <span class="file"><a href="wp-admin/update-core.php">wp-admin/update-core.php</a></span> in your browser and follow the instructions.</li> <li>You wanted more, perhaps? That’s it!</li> </ol> <h3>Updating Manually</h3> <ol> <li>Before you update anything, make sure you have backup copies of any files you may have modified such as <code>index.php</code>.</li> <li>Delete your old WordPress files, saving ones you’ve modified.</li> <li>Upload the new files.</li> <li>Point your browser to <span class="file"><a href="wp-admin/upgrade.php">/wp-admin/upgrade.php</a>.</span></li> </ol> <h2>Migrating from other systems</h2> <p>WordPress can <a href="https://developer.wordpress.org/advanced-administration/wordpress/import/">import from a number of systems</a>. First you need to get WordPress installed and working as described above, before using <a href="wp-admin/import.php">our import tools</a>.</p> <h2>System Requirements</h2> <ul> <li><a href="https://www.php.net/">PHP</a> version <strong>7.2.24</strong> or greater.</li> <li><a href="https://www.mysql.com/">MySQL</a> version <strong>5.5.5</strong> or greater.</li> </ul> <h3>Recommendations</h3> <ul> <li><a href="https://www.php.net/">PHP</a> version <strong>7.4</strong> or greater.</li> <li><a href="https://www.mysql.com/">MySQL</a> version <strong>8.0</strong> or greater OR <a href="https://mariadb.org/">MariaDB</a> version <strong>10.5</strong> or greater.</li> <li>The <a href="https://httpd.apache.org/docs/2.2/mod/mod_rewrite.html">mod_rewrite</a> Apache module.</li> <li><a href="https://wordpress.org/news/2016/12/moving-toward-ssl/">HTTPS</a> support.</li> <li>A link to <a href="https://wordpress.org/">wordpress.org</a> on your site.</li> </ul> <h2>Online Resources</h2> <p>If you have any questions that are not addressed in this document, please take advantage of WordPress’ numerous online resources:</p> <dl> <dt><a href="https://wordpress.org/documentation/">HelpHub</a></dt> <dd>HelpHub is the encyclopedia of all things WordPress. It is the most comprehensive source of information for WordPress available.</dd> <dt><a href="https://wordpress.org/news/">The WordPress Blog</a></dt> <dd>This is where you’ll find the latest updates and news related to WordPress. Recent WordPress news appears in your administrative dashboard by default.</dd> <dt><a href="https://planet.wordpress.org/">WordPress Planet</a></dt> <dd>The WordPress Planet is a news aggregator that brings together posts from WordPress blogs around the web.</dd> <dt><a href="https://wordpress.org/support/forums/">WordPress Support Forums</a></dt> <dd>If you’ve looked everywhere and still cannot find an answer, the support forums are very active and have a large community ready to help. To help them help you be sure to use a descriptive thread title and describe your question in as much detail as possible.</dd> <dt><a href="https://make.wordpress.org/support/handbook/appendix/other-support-locations/introduction-to-irc/">WordPress <abbr>IRC</abbr> (Internet Relay Chat) Channel</a></dt> <dd>There is an online chat channel that is used for discussion among people who use WordPress and occasionally support topics. The above wiki page should point you in the right direction. (<a href="https://web.libera.chat/#wordpress">irc.libera.chat #wordpress</a>)</dd> </dl> <h2>Final Notes</h2> <ul> <li>If you have any suggestions, ideas, or comments, or if you (gasp!) found a bug, join us in the <a href="https://wordpress.org/support/forums/">Support Forums</a>.</li> <li>WordPress has a robust plugin <abbr>API</abbr> (Application Programming Interface) that makes extending the code easy. If you are a developer interested in utilizing this, see the <a href="https://developer.wordpress.org/plugins/">Plugin Developer Handbook</a>. You shouldn’t modify any of the core code.</li> </ul> <h2>Share the Love</h2> <p>WordPress has no multi-million dollar marketing campaign or celebrity sponsors, but we do have something even better—you. If you enjoy WordPress please consider telling a friend, setting it up for someone less knowledgeable than yourself, or writing the author of a media article that overlooks us.</p> <p>WordPress is the official continuation of <a href="https://cafelog.com/">b2/cafélog</a>, which came from Michel V. The work has been continued by the <a href="https://wordpress.org/about/">WordPress developers</a>. If you would like to support WordPress, please consider <a href="https://wordpress.org/donate/">donating</a>.</p> <h2>License</h2> <p>WordPress is free software, and is released under the terms of the <abbr>GPL</abbr> (GNU General Public License) version 2 or (at your option) any later version. See <a href="license.txt">license.txt</a>.</p> </body> </html>
And another one:
Figma link:
https://www.figma.com/file/Fft6s8KS3I0BUcwu4ybdLd/TT3-Variation-%22Dusk%22?node-id=2%3A9
JSON:
variation-dusk.json.zip
Notice</b>: Undefined index: button in <b>C:\laragon\www\tt3\wp-includes\class-wp-theme-json.php</b> on line <b>1482
Go to pages > add new and you will see the list of notice.
Make sure debug mode is enabled from wp-config.php file.
It would be nice to browse the style variations in the correct order. That would be left to right: Default > Example 2 > Example 3 > Example 4.
Also, there's a typo in "Example 2".
We need a screenshot for the base theme :D
It is common for the default themes to be compatible with WordPress versions below the version the theme is first included in.
This theme's minimum required version is set to 5.9, but the theme can not be activated on 5.9.3:
The package could not be installed. The theme is missing the index.php file.
Theme installation failed.
The theme could include an index.php file without causing conflicts for 6.1.
But are there other 6.1 features that are breaking on 5.9?
Updating templates to include new features like the "no results" block for the queries and the new comments blocks also depends on increasing the version.
Add code linting to make sure WordPress Coding Standards are maintained during the development.
Tasks:
Need Discussion:
pre-commit
hookThis is my contribution to the TT3 style variations:
Figma link:
https://www.figma.com/file/NV8HsXUVEmTZNCrCOZdJcd/TT3-Variation-%22Maresa%22?node-id=0%3A1
JSON:
variation-maresa.json.zip
As this is the first time I'm working with style variations, please let me know if I'm missing something.
Currently, the 'small' font size is set to 1rem
, but as we're using fluid typography and we have set no min
or max
value, this font size preset scales to a very small size at smaller resolutions (12px).
I think we should add at least a min
value to the 'small' size, maybe around 14px
/ 0.9rem
?
The 404 page pattern needs to be updated to match the design.
Across the templates, the format var(--wp--preset--spacing--90)
is used inside the JSON block comment.
For the code in the template to match the code of new blocks added in the block editor, this format should be used: var:preset|spacing|numeric-value
See #55 (comment)
Should the single-no-separators.html remain in the theme, but without the separator above the post meta?
The page does not have separators, I suggest removing the template.
As TT3 is focused on style variations, it would be good to remove as many opinionated styles from the block markup as possible. There are a few places where this is happening, but sometimes it can be difficult where unique styles have been required. Here's an example of where we have done this previously: #31
This issue is to track where we could consider moving these settings, and encourage discussion around this for each area:
Proposal for consideration:
Possible benefits:
Possible drawbacks:
Just opening this up to discussion and consideration. Thanks!
Opening up an issue to track the creation of a demo site. I've handled the paperwork of getting a *.wordpress.net site for the past few years and happy to continue if desired.
I'd get the site setup, keep it up to date with Core/Gutenberg/plugins/TT3 code. A themer would go in to actually setup the demo site as desired.
Can we add the typeface IBM Plex Mono to the font assets? Thank you!
Given the likelihood that variations from community authors will use different Google fonts, at least one of the example variations should demonstrate how it is loaded in its theme.json file such as:
"title": "Example X",
"settings": {
"color": {
"palette": [
{
"color": "#ffd875",
"name": "Base",
"slug": "base"
},
{
"color": "#000000",
"name": "Contrast",
"slug": "contrast"
},
{
"color": "#ffffff",
"name": "Primary",
"slug": "primary"
},
{
"color": "#000000",
"name": "Secondary",
"slug": "secondary"
},
{
"color": "#F6F6F6",
"name": "Tertiary",
"slug": "tertiary"
}
]
},
"typography": {
"fontFamilies": [
{
"fontFace": [
{
"fontFamily": "Open Sans",
"fontStretch": "normal",
"fontStyle": "normal",
"fontWeight": "200 900",
"src": [
"file:./assets/fonts/open-sans/OpenSans-Regular.ttf"
]
},
{
"fontFamily": "Open Sans",
"fontStretch": "normal",
"fontStyle": "italic",
"fontWeight": "200 900",
"src": [
"file:./assets/fonts/open-sans/OpenSans-Italic.ttf"
]
}
],
"fontFamily": "\"Open Sans\", sans-serif",
"name": "Open Sans",
"slug": "open-sans"
}
]
}
},
"styles": {
"blocks": {
"core/separator": {
"border": {
"width": "2px"
}
}
},
"elements": {
"button": {
"border": {
"radius": "5px"
}
}
},
"typography": {
"fontFamily": "var(--wp--preset--font-family--open-sans)"
}
},
"version": 2,
"$schema": "https://schemas.wp.org/trunk/theme.json"
}```
Twenty Twenty-Three Figma Mockups
The figma file link in the readme file is either not linking to anything or inacessable. Can this resource be enabled for read-only by default?
There are a few details from the Figma that should be refined in the templates:
Page & Single
Single
Figma reference here
We should consider using more generic font-family slugs (i.e. body
, heading
, etc) instead of slugs that are specific to the font family that is registered within settings.typography.fontFamilies
.
The fonts loaded within settings.typography.fontFamilies
are only available on the active style, resulting in CSS variables
If a the parent theme.json file registers a font, like DM Sans, and uses a slug of dm-sans
— whenever we switch styles we're left with an undefined CSS variable output wherever we used "fontFamily": "var(--wp--preset--font-family--system-font)"
.
Also resulting in none of the parent theme.json's font family values will carry over to subsequent styles.
Below is a screenshot of the CSS generated if you have a specific font-family slug from the parent theme.json that is not available (different font) from a style variation.
Instead if we used body
and heading
slugs, then those CSS variables will be meaningful within other style variations. A heading with "fontFamily": "var(--wp--preset--font-family--heading)",
assigned to it, still maintains the style variant's fontFamily that has the slug of heading
.
Having a style that actually inherits the parent style seems the best foot forward in my opinion. And even if we end up not having fontFamilies within the parent theme.json, we should still have these consistent values across the theme — from variation to variation. Example: if I choose my theme's heading font (DM Sans) then switch styles, then that style variation's heading font should take over wherever I used the previous one.
What do you think?
Currently, the theme uses the deprecated post comments block: <!-- wp:post-comments /-->
.
I suggest using the new comments query and related blocks instead.
I also recommend that this is added as a template part to reduce code duplication.
The comment query requires WordPress 6.0, and depends on #24
The current spacing is using the new spacing size presets from Gutenberg, however, the sizes are incorrect. They should match the spacing sizes used in Twenty Twenty-Two and the new Twenty Twenty-Three designs.
The font files for Source Serif Pro are twice in the theme, once in the fonts
folder itself, and once in the source-serif-pro
subfolder. The theme.json file references the files in the source-serif-pro
folder, so I guess it's safe to remove the files in the fonts
folder.
Notice: Error when decoding a JSON file at path /sites/twentyTwentyThree/styles/example-five.json: Syntax error in /Sites/TwentyTwentyThree_site/app/public/wp-includes/functions.php on line 4548
I noticed that the font size and hover/focus/active is different on the submenu and home link compared to the "core/navigation-link", which is styled in theme.json.
Is it possible to place these styles directly on the navigation block instead of the child block?
If not, I think that if we are going to style one of them, we have to style and test all the child blocks.
The search form is using the default medium font size, compared to the navigation link which uses the small font size.
In the image:
First, from the left side, there are two regular navigation links that are using size small.
Next is a sub menu, which uses the default medium size.
And then a page link and the search form.
Currently, the theme.json declares base
and contrast
colors that match the background and text colors of the site. To be consistent with Twenty Twenty-Two, the Colors inside the Figma Styles page, and a majority of themes (Poe, Blockbase, Vivre, Pendant, Extendable, Lyna, Gutenify, eStory, Lawson...), we should consider using the background
and foreground
slugs along with the "Background" and "Foreground" names.
Moreover, having the same color slugs as Twenty Twenty-Two would allow users to easily switch from Twenty Twenty-Two to Twenty Twenty-Three.
The theme should follow core best practices and add context to the sample texts.
See WordPress/gutenberg#43409
The default footer pattern uses a category called "footer", but this category is not registered.
Currently, the style.css and functions.php files are only required to add the following CSS:
body {
-moz-osx-font-smoothing: grayscale;
-webkit-font-smoothing: antialiased;
}
I don't believe we'll need to add any other CSS, so it's a shame to include these files just to handle font-smoothing. Unfortunately, the current system font we're using looks significantly worse without the above CSS.
A solution could be to choose a different default font, but that may require bundling more font files.
Another idea could be to add a theme.json setting that opts-in to font-smoothing, however this has been discussed previously: WordPress/gutenberg#35934
Would love to hear any more ideas.
Originally discussed here - #22 (comment)
This issue is to list and track any Gutenberg issues that would benefit Twenty Twenty-Three and its variations.
Required for base theme (WP 6.1):
NOT required, but nice to have for style variations:
Following button states should match with figma.
Current:
Hover: (outline button background)
With the no results block, the theme can conditionally display blocks when a query returns no results.
Without this block, a search that has no results for example, displays an empty page.
The block requires WordPress 6.0 and depends on #24
Update:
Like its title, this variation is still very much a rough draft. However, I wanted to go ahead and share progress in case others were looking at how to override certain things (there's quite a bit of experimentation in there).
It took me a bit to learn some of the newer stuff. I haven't tackled fluid typography yet, but it's coming. I also need to look into mapping some custom slugs to TT3's existing slugs for things like font sizes.
Current progress is saved as a child theme in this repo (easy to install and test this way): https://github.com/justintadlock/tt3-rough-draft
The following is a screenshot of a single post (no separators template) with various blocks:
Figma Link:
https://www.figma.com/file/CHvE6JTndoOlNMN76JjRUT/TT3-Variation-%22Pastel%22?node-id=2%3A9
JSON:
variation-pastel.json.zip
Not sure if we are able to change a bit header and footer backgrounds or do we need to stick to the default Figma file as it is and play just with the colors and fonts? Can we submit more than one variation :)?
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.