Git Product home page Git Product logo

twentytwentythree's Introduction

<!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 &#8250; 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">&#8212; 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 &#8220;Profile&#8221; 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&#8217;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&#8217;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&#8217; 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&#8217;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&#8217;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&#8217;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&#8212;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&#233;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>

twentytwentythree's People

Contributors

audrasjb avatar bobmatyas avatar carolinan avatar colorful-tones avatar critterverse avatar desrosj avatar felipeelia avatar hiyascout avatar kafleg avatar kathryncodes avatar kraftbj avatar luminuu avatar madhusudhand avatar maggiecabrera avatar mikachan avatar pbking avatar richtabor avatar scruffian avatar soean avatar t-hamano avatar tahmid-ul avatar tanvirulhaque avatar thelovekesh avatar wberredo avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

twentytwentythree's Issues

Undefined index: button while creating a new page

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.

Reorder style variation examples

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".

order.mp4

Screenshot

We need a screenshot for the base theme :D

Increase the minimum required WordPress version

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?

  • The spacing CSS variables are not working. So it depends if you consider that breaking or not.
  • "Elements" hover and focus styles do not work.
  • Font family options do not work.
  • The patterns folder does not work on 5.9. So the theme has no footer and no 404 page content.

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 with required GitHub workflows

Add code linting to make sure WordPress Coding Standards are maintained during the development.

Tasks:

  • Add Stylelint for CSS linting.
  • Add PHPCS for PHP CS and linting.
  • Add required GitHub workflows to run linting on PRs.

Need Discussion:

  • Add pre-commit hook
  • Is config for JS linting required?

The 'small' font size scales down too much at smaller resolutions

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?

"No separators" templates

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.

Remove opinionated settings from block markup

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:

  • 404 pattern: #93
  • Search template: #103
  • Home template: #94

Child theme with style variations spin-off

Proposal for consideration:

  • TT3 theme - with 2-4 style variations, and
  • TT3 child theme - with a handful of community-contributed style variations

Possible benefits:

  • Test the limits of current WordPress theme APIs
  • Encourage further creative expression by encouraging more fonts and even Patterns included

Possible drawbacks:

  • Harder to onboard new contributors with two different repos/projects
  • Maintenance - related to above. Two projects to maintain.
  • Possible that the TT3 child theme may be underutilized (low install numbers) and impact morale of contributors.
  • Shift in timeline and progress, but this could potentially be a benefit too: faster ship times with separation of concerns.

Just opening this up to discussion and consideration. Thanks!

Links Details

  • Can we keep the #345C00 color to the links in paragraphs only?

Captura de ecrã 2022-08-10, às 16 51 33

  • Also, let's match the links with TT2: 1px underline thickness and a text-underline-offset:.25ch with the same hover effect.
tt2_links.mp4

Demo Site

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.

Example Variations Using Different Fonts

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"
}```

Archive template: match the Figma

Currently the archive template is a query block with a list style view. It should match the Figma design instead, using a 2 x 3 layout:

archive

Single + Page templates: match Figma

There are a few details from the Figma that should be refined in the templates:

Page & Single

  • The Post Featured Image should come before the Post Title
  • There should not be a separator between the Post Title and the Post Content

Single

  • The post meta should be split into a row and wide aligned, with the Post Date, Category and Author on the left, and the Tags on the right.

Figma reference here

Use generic font family slugs

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

Why:

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.

Proposal:

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?

Screenshot:

CleanShot 2022-08-10 at 22 01 20@2x

CleanShot 2022-08-10 at 21 45 55@2x

Use the new comments blocks

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

Remove duplicate Source Serif Pro font files

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.

Style variation thumbnails: Not displaying fonts used

The style variation thumbnail previews don't currently reflect the fonts used in each variation. The smaller Aa Aa preview that appears on hover looks correct, but the larger text on hover and the Aa text in the main preview are not displaying properly:

variation-thumbnails

Extra comma in example-five.json throwing error

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

Apply the navigation block styles to the sub menu block and home link

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 block in the navigation block is very large

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.

navigation menu, see image description above

Use "background" and "foreground" color slugs instead of "base" and "contrast" for consistency and compatibility

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.

style.css and functions.php are only required to handle font-smoothing

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.

Track Related Gutenberg Issues

Add the no results block

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

Variation "Rough Draft"

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

Screenshot

The following is a screenshot of a single post (no separators template) with various blocks:

tt3-variation-006

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.