Advanced Administration Handbook: Status 2023-01-15

Last September, the WordPress Advanced Administration Handbook start it path and after some Contributor Days and a lot of work from the Docs and HostingHosting A web hosting service is a type of Internet hosting service that allows individuals and organizations to make their website accessible via the World Wide Web. Teams, and plenty of contributors, we have some clarity for this 2023.

What

This new documentation is proposed as advanced regarding what currently exists for end users (UserHub / Support), with the goal that the documentation for users is free of advanced technical material, and that the documentation for developers (DevHub) is very differentiated between what is development, and what are advanced development or system configurations.

How

Although we have some pages documented, if you know of other WordPress content that could be in this Handbook, please open an issue and discuss it with the Documentation team. Please consider using the label “advanced administration”.

If you want to help launch the Handbook as soon as possible, please take an issue and work on it. You can comment on the site itself if you have any questions, suggestions, or improvements.

Stats

  • There are 63 pages in the Handbook
  • The content is categorized in 10 sections
    • Before Install
    • ServerServer A server is a piece of computer hardware or software that provides functionality for other programs or devices. Typical servers are database servers, file servers, mail servers, print servers, web servers, game servers, and application servers.
    • WordPress
    • Upgrade
    • MultiSiteMultisite Multisite is a WordPress feature which allows users to create a network of sites on a single WordPress installation. Available since WordPress version 3.0, Multisite is a continuation of WPMU or WordPress Multiuser project. WordPress MultiUser project was discontinued and its features were included into WordPress core.https://codex.wordpress.org/Create_A_Network.
    • Plugins
    • Themes
    • Security
    • Performance
    • Debug
  • 51 contents from Support, Codex, or APIs will be moved
  • There are 5 pages pending migrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies.
  • The content (pending publish) is available at GitHub

Next steps

There are some issues open:

Tools

To work on this project, you will need:

Contributor DayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/.

If you are going to participate in a Contributor Day, this is one of the Hosting / Documentation projects to contribute.

Please take a look at our Contributor Day page, and specifically, the Advanced Admin Handbook section.

Help

If help is needed, please ask in the #docs, #hosting-community channel or contact @JavierCasares, @lucp, @milana_cap.

+make.wordpress.org/docs/

+make.wordpress.org/updates/

#documentation

WordPress Advanced Administration Handbook

In early August 2022, the #Docs team reached out to the #Hosting team to collaborate on a new documentation section within WordPress.

This new documentation is proposed as advanced regarding what currently exists for end users (UserHub / Support), with the goal that the documentation for users is free of advanced technical material, and that the documentation for developers (DevHub) is very differentiated between what is development, and what are advanced development or system configurations.

This project is led by @JavierCasares, @lucp and @milana_cap. If you have any questions or concerns, please contact any of them.

Some information and links

Starting the Handbook

After several meetings in the Documentation team and the HostingHosting A web hosting service is a type of Internet hosting service that allows individuals and organizations to make their website accessible via the World Wide Web. team, the Handbook has been created in a GitHub repository and the first steps have been requested to the Meta team.

A first step has been the creation of an organizational structure of categories. It is a first version that can evolve. The idea is that the contents are only at two levels. In this way we will enter, for example, in the ServerServer A server is a piece of computer hardware or software that provides functionality for other programs or devices. Typical servers are database servers, file servers, mail servers, print servers, web servers, game servers, and application servers. categoryCategory The 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging. and there we will find the different pages (like nginxNGINX nginx is a web server that can also be used as a reverse proxy, load balancer, mail proxy and HTTP cache. Nginx is free and open-source software, released under the terms of the 2-clause BSD license.), but without subpages.

Subsequently, a page has been created for each of the documents to be copied from their origin. These pages have their respective Issues in the repository. This way, anyone who wants to work on the project can choose an issue and work on it.

Want to contribute?

Although we are still in a first step, if you know of other WordPress content that could be in this Handbook, please open an issue and discuss it with the Documentation team. Please use the label “advanced administration”.

If you want to help launch the Handbook as soon as possible, please take an issue and work on it. You can comment on the site itself if you have any questions, suggestions or improvements.

Where and when can you find us?

Currently, you can find us on Tuesdays at 14:00 UTC in the #docs SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. channel, or Wednesdays at 09:00 UTC and 18:00 UTC in the #hosting-community Slack channel.

You can also find us at the Contributor Day of WordCamp US (US), at the Contributor Day of WordCamp Netherlands (NL), or at the Contributor Day of WordCamp Valencia (ES).

+make.wordpress.org/docs/

#documentation

Get ready for WordPress 6.0

WordPress 6.0 release time is approaching, and before that time comes, we’re going to go over some interesting elements for hostingHosting A web hosting service is a type of Internet hosting service that allows individuals and organizations to make their website accessible via the World Wide Web. teams.

First, the calendar.

  • 2022-05-03: RC1
  • 2022-05-10: RC2
  • 2022-05-17: RC3
  • 2022-05-23: Dry run
  • 2022-05-24: WordPress 6.0 is released

Now that WordPress 6.0 has entered the Release CandidateRelease Candidate A beta version of software with the potential to be a final product, which is ready to release unless significant bugs emerge. phase, the following policies are in place.

Everything starts with the WordPress 6.0 Release Candidate 1

With the Release Candidate 1 officially shipped, it’s time to explore the next major releaseMajor Release A set of releases or versions having the same major version number may be collectively referred to as “X.Y” -- for example version 5.2.x to refer to versions 5.2, 5.2.1, and all other versions in the 5.2. (five dot two dot) branch of that software. Major Releases often are the introduction of new major features and functionality., WordPress 6.0. This release introduces Style variations, the BlockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. Locking UIUI UI is an acronym for User Interface - the layout of the page the user interacts with. Think ‘how are they doing that’ and less about what they are doing., various writing improvements, more design tools, new hooksHooks In WordPress theme and development, hooks are functions that can be applied to an action or a Filter in WordPress. Actions are functions performed when a certain event occurs in WordPress. Filters allow you to modify certain functions. Arguments used to hook both filters and actions look the same., updated external libraries, and more!

WordPress 6.0, planned for May 24, 2022, is now ready to be translated on translate.wordpress.org!

Related to the Hosting team

As part of the release of WordPress 6.0, the new Performance team has been working on several improvements to the coreCore Core is the set of software required to run WordPress. The Core Team builds WordPress.. There are a few new additions to the WordPress CachingCache A cache is a component that stores data so that future requests for that data can be served faster; the data stored in a cache might be the result of an earlier computation or a copy of data stored elsewhere. APIAPI An Application Programming Interface (API) is a computing interface that defines interactions between multiple software intermediaries. It defines the kinds of calls or requests that can be made, how to make them, the data formats that should be used, the conventions to follow, etc..

As part of the 6.0 release of WordPress, the new performance team has been hard at work to improve the performance of term queries. There are many term queries on the average page load, and improving these, improves the performance of WordPress in general.

In WordPress 6.0, websites with more than 10,000 users will see improvements in handling users. Before changes, sites with more than 10,000 users would suffer from slow page loading time in the user and post list screens.

Changes in PHPPHP PHP (PHP: Hypertext Preprocessor) is a general-purpose scripting language especially suited to web development. PHP code is usually processed on a web server by a PHP interpreter. On a web server, the result of the interpreted and executed PHP code would form the whole or part of an HTTP response.MySQLMySQL MySQL is an open-source relational database management system (RDBMS). MySQL is free and open-source software under the terms of the GNU General Public License./MariaDBMariaDB MariaDB is a fork of the MySQL relational database management system (RDBMS), intended to remain free and open-source software under the GNU General Public License. MariaDB intended to maintain high compatibility with MySQL, ensuring a drop-in replacement capability with library binary parity and exact matching with MySQL APIs and commands.

At this time there are no changes to WordPress 6.0 compatibility with respect to PHP or MySQL/MariaDB, so WordPress 5.9 compatibility should remain the same as WordPress 6.0.

In case there are changes, they will be announced in this post or in a later post.

#core, #documentation

Help with the Gutenberg Migration Guide at Contributor Day

Looking for something to do at Contributor DayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/.? We could use your help!

The Gutenberg Migration Guide is a crowdsourcing project to document WordPress Classic Editor customization points and their GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/ equivalents (if such exist). media_buttons is the quintessential example; whereas you might’ve used this action previously in the Classic Editor to register a button, it no longer exists in Gutenberg and the blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. inserter is its direct equivalent.

We want the migrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. guide to be as comprehensive as it can be. This is defined as:

  1. Identifying as many integration points as we can find. For instance, there are already 14 actions / filters listed. Some are commonly used, while others are not. As long as we have a good example for how the integration point is used, it makes sense to include in the guide.
  2. Whenever possible, documenting how feature parity can be achieved with Gutenberg. Some integration points do already have Gutenberg equivalents. Others don’t yet, and that’s alright.

You can help make the migration guide more comprehensive. If you don’t have any examples of your own to include, here are a couple of places you can start looking:

  • Our plugin compatibility database has a good number of plugins marked incompatible. Some even have descriptions of the problems!
  • The [Type] Plugin / Theme Interoperability and Backwards Compatibility labels in the Gutenberg GitHubGitHub GitHub is a website that offers online implementation of git repositories that can can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. repository have some number of reasonably documented conflicts.

Everyone can contribute to the migration guide, regardless of skill set. All you need to do is open a new GitHub issue and report the incompatibility you’ve found. Screenshots and GIFs are tremendously helpful. If you know the underlying problem, then please include that too. If all you know is that a given pluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory or can be cost-based plugin from a third-party.’s feature doesn’t work in Gutenberg, no worries; simply open an issue and we can help track down the cause. Identifying examples of breakage are what we need help with most.

Feel free to join #hosting-community in the WordPress.org Slack if you have any questions, etc. Thanks for your help!

#contributor-day, #core, #documentation

Call for Best Practices Documentation

One of the topics that has been largely discussed during #hosting-community meetings is coming up with a list of best practices for hostingHosting A web hosting service is a type of Internet hosting service that allows individuals and organizations to make their website accessible via the World Wide Web. companies to follow. Currently, we know that virtually every hosting company has a different serverServer A server is a piece of computer hardware or software that provides functionality for other programs or devices. Typical servers are database servers, file servers, mail servers, print servers, web servers, game servers, and application servers. OS, default php.iniphp.ini The main configuration file of PHP. values, NGINXNGINX nginx is a web server that can also be used as a reverse proxy, load balancer, mail proxy and HTTP cache. Nginx is free and open-source software, released under the terms of the 2-clause BSD license./ApacheApache Apache is the most widely used web server software. Developed and maintained by Apache Software Foundation. Apache is an Open Source software available for free. configs, etc. We’re looking to get some of those things aggregated to provide suggested defaults and best practices.

Here is some of the data we are looking for:

  • Any plugins or mu-plugins installed by default
  • Any modifications made to wp-config.phpwp-config.php One of the most important files in a WordPress installation is the wp-config.php file. This file is located in the root of your WordPress file directory and contains your website’s base configuration details, such as database connection information. by default
  • PHPPHP PHP (PHP: Hypertext Preprocessor) is a general-purpose scripting language especially suited to web development. PHP code is usually processed on a web server by a PHP interpreter. On a web server, the result of the interpreted and executed PHP code would form the whole or part of an HTTP response. versions offered
  • Modules available in each PHP version
  • Default php.ini files
  • Default cachingCache A cache is a component that stores data so that future requests for that data can be served faster; the data stored in a cache might be the result of an earlier computation or a copy of data stored elsewhere. configs (Varnish, Memcache, RedisRedis Redis (Remote Dictionary Server) is an in-memory data structure store, in-memory key–value database. It is open-source software.., etc)
  • Default web serverServer A server is a piece of computer hardware or software that provides functionality for other programs or devices. Typical servers are database servers, file servers, mail servers, print servers, web servers, game servers, and application servers. configs (NGINX, Apache, etc)

Of course, we’re aware that some things (i.e. security configurations) may be sensitive. We don’t want those things.

This information will be compared, discussed, and picked apart to determine best practices to follow. Our goal is not to debate which hosting company is better. This should be an objective analysis by involved individuals from many hosting companies and potentially individuals not affiliated with any hosting company.

If you would like to contribute to the formation of WordPress hosting best practices and have information to offer, please contact @voldemortensen on SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/..

#documentation