<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title>[12248] sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-support/helphub-update-php-strings.php: Support: Update PHP page: Update the copy of the update PHP page.</title>
</head>
<body>
<style type="text/css"><!--
#msg dl.meta { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dl.meta dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer, #logmsg { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; }
#msg dl a { font-weight: bold}
#msg dl a:link { color:#fc3; }
#msg dl a:active { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { white-space: pre-line; overflow: auto; background: #ffc; border: 1px #fa0 solid; padding: 6px; }
#logmsg { background: #ffc; border: 1px #fa0 solid; padding: 1em 1em 0 1em; }
#logmsg p, #logmsg pre, #logmsg blockquote { margin: 0 0 1em 0; }
#logmsg p, #logmsg li, #logmsg dt, #logmsg dd { line-height: 14pt; }
#logmsg h1, #logmsg h2, #logmsg h3, #logmsg h4, #logmsg h5, #logmsg h6 { margin: .5em 0; }
#logmsg h1:first-child, #logmsg h2:first-child, #logmsg h3:first-child, #logmsg h4:first-child, #logmsg h5:first-child, #logmsg h6:first-child { margin-top: 0; }
#logmsg ul, #logmsg ol { padding: 0; list-style-position: inside; margin: 0 0 0 1em; }
#logmsg ul { text-indent: -1em; padding-left: 1em; }#logmsg ol { text-indent: -1.5em; padding-left: 1.5em; }
#logmsg > ul, #logmsg > ol { margin: 0 0 1em 0; }
#logmsg pre { background: #eee; padding: 1em; }
#logmsg blockquote { border: 1px solid #fa0; border-left-width: 10px; padding: 1em 1em 0 1em; background: white;}
#logmsg dl { margin: 0; }
#logmsg dt { font-weight: bold; }
#logmsg dd { margin: 0; padding: 0 0 0.5em 0; }
#logmsg dd:before { content:'\00bb';}
#logmsg table { border-spacing: 0px; border-collapse: collapse; border-top: 4px solid #fa0; border-bottom: 1px solid #fa0; background: #fff; }
#logmsg table th { text-align: left; font-weight: normal; padding: 0.2em 0.5em; border-top: 1px dotted #fa0; }
#logmsg table td { text-align: right; border-top: 1px dotted #fa0; padding: 0.2em 0.5em; }
#logmsg table thead th { text-align: center; border-bottom: 1px solid #fa0; }
#logmsg table th.Corner { text-align: left; }
#logmsg hr { border: none 0; border-top: 2px dashed #fa0; height: 1px; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<div id="msg">
<dl class="meta" style="font-size: 105%">
<dt style="float: left; width: 6em; font-weight: bold">Revision</dt> <dd><a style="font-weight: bold" href="http://meta.trac.wordpress.org/changeset/12248">12248</a><script type="application/ld+json">{"@context":"http://schema.org","@type":"EmailMessage","description":"Review this Commit","action":{"@type":"ViewAction","url":"http://meta.trac.wordpress.org/changeset/12248","name":"Review Commit"}}</script></dd>
<dt style="float: left; width: 6em; font-weight: bold">Author</dt> <dd>dd32</dd>
<dt style="float: left; width: 6em; font-weight: bold">Date</dt> <dd>2022-11-17 01:32:09 +0000 (Thu, 17 Nov 2022)</dd>
</dl>
<pre style='padding-left: 1em; margin: 2em 0; border-left: 2px solid #ccc; line-height: 1.25; font-size: 105%; font-family: sans-serif'>Support: Update PHP page: Update the copy of the update PHP page.
Props ironprogrammer, azaozz, sabernhardt.
Closes https://github.com/WordPress/wordpress.org/pull/95.
See <a href="http://meta.trac.wordpress.org/ticket/6516">#6516</a>.</pre>
<h3>Modified Paths</h3>
<ul>
<li><a href="#sitestrunkwordpressorgpublic_htmlwpcontentthemespubwporgsupporthelphubupdatephpstringsphp">sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-support/helphub-update-php-strings.php</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="sitestrunkwordpressorgpublic_htmlwpcontentthemespubwporgsupporthelphubupdatephpstringsphp"></a>
<div class="modfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Modified: sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-support/helphub-update-php-strings.php</h4>
<pre class="diff"><span>
<span class="info" style="display: block; padding: 0 10px; color: #888">--- sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-support/helphub-update-php-strings.php 2022-11-16 09:53:56 UTC (rev 12247)
+++ sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-support/helphub-update-php-strings.php 2022-11-17 01:32:09 UTC (rev 12248)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -24,7 +24,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> return $title;
</span><span class="cx" style="display: block; padding: 0 10px"> }
</span><span class="cx" style="display: block; padding: 0 10px">
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- return __( 'Get a faster, more secure website: update your PHP today', 'wporg-forums' );
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ return __( 'Get a faster, more secure website: update PHP today', 'wporg-forums' );
</ins><span class="cx" style="display: block; padding: 0 10px"> }
</span><span class="cx" style="display: block; padding: 0 10px"> add_filter( 'the_title', 'wporg_support_filter_update_php_title', 5, 2 );
</span><span class="cx" style="display: block; padding: 0 10px">
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -56,7 +56,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '<p>';
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= sprintf(
</span><span class="cx" style="display: block; padding: 0 10px"> /* translators: %s: link URL about keeping WordPress up to date */
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- __( 'PHP is the coding language WordPress is built on, and its version is set at the server-level by your hosting company. Whilst you may be familiar with the importance of <a href="%s">keeping WordPress, and your themes and plugins up-to-date</a>, keeping PHP up-to-date is just as important.', 'wporg-forums' ),
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ __( 'PHP is one of the programming languages that WordPress is built on. Your hosting company determines which versions of PHP are available for your site, and many hosters let you change this yourself. And while you may be familiar with the importance of <a href="%s">keeping WordPress, and your themes and plugins up-to-date</a>, keeping PHP up-to-date is just as important.', 'wporg-forums' ),
</ins><span class="cx" style="display: block; padding: 0 10px"> esc_url( _x( 'https://wordpress.org/support/article/administration-screens/#updates', 'link URL about keeping WordPress up to date', 'wporg-forums' ) )
</span><span class="cx" style="display: block; padding: 0 10px"> );
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '</p>';
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -64,12 +64,19 @@
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '<ul>';
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '<li>';
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= sprintf(
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ /* translators: 1: link URL to WordPress requirements page, 2: recommended PHP version */
+ __( '<strong>Your website may be faster</strong> because PHP becomes more efficient with each new version. Updating to <a href="%1$s">WordPress’s recommended PHP version</a> (currently %2$s or higher) can deliver a performance increase that will benefit all visitors to your website.', 'wporg-forums' ),
+ esc_url( _x( 'https://wordpress.org/about/requirements/', 'link URL to WordPress requirements page', 'wporg-forums' ) ),
+ RECOMMENDED_PHP
+ );
+ $content .= '</li>';
+ $content .= '<li>';
+ $content .= sprintf(
</ins><span class="cx" style="display: block; padding: 0 10px"> /* translators: %s: recommended PHP version */
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- __( '<strong>Your website will be faster</strong> as the latest version of PHP is more efficient. Updating to the latest supported version (currently %s) can deliver a huge performance increase; up to 3 or 4x faster for older versions.', 'wporg-forums' ),
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ __( '<strong>Your website will be more secure.</strong> PHP, like WordPress, is maintained by its community. Because PHP is so popular, it is a target for hackers – but the latest version will have the latest security features. Older versions of PHP (lower than %s) <em>do not have this</em>, so updating is essential to keep your WordPress site secure.', 'wporg-forums' ),
</ins><span class="cx" style="display: block; padding: 0 10px"> RECOMMENDED_PHP
</span><span class="cx" style="display: block; padding: 0 10px"> );
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '</li>';
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- $content .= '<li>' . __( '<strong>Your website will be more secure.</strong> PHP, like WordPress, is maintained by its community. Because PHP is so popular, it is a target for hackers – but the latest version will have the latest security features. Older versions of PHP <em>do not have this</em>, so updating is essential to keep your WordPress site secure.', 'wporg-forums' ) . '</li>';
</del><span class="cx" style="display: block; padding: 0 10px"> $content .= '</ul>';
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '<p>' . __( 'And then there are a number of secondary benefits:', 'wporg-forums' ) . '</p>';
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '<ul>';
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -79,18 +86,29 @@
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '</ul>';
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '<p>' . __( 'These benefits are good for you, and good for your website’s visitors. These are the reasons you should update PHP today. The next section will show you how to do this.', 'wporg-forums' ) . '</p>';
</span><span class="cx" style="display: block; padding: 0 10px">
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ // Section "How to check your PHP version".
+ $content .= '<h3>' . __( 'How to check your PHP version', 'wporg-forums' ) . '</h3>';
+ $content .= '<p>' . __( 'To check what version of PHP your WordPress site is using, from the WordPress Dashboard, select <em>Tools > Site Health</em> from the sidebar menu, and then select the Info tab. Expand the Server section and scroll down until you see <strong>PHP version</strong>.', 'wporg-forums' ) . '</p>';
+ $content .= '<p>';
+ $content .= sprintf(
+ /* translators: %s: recommended PHP version */
+ __( 'If this number is at or higher than PHP %s, then you don’t need to update PHP at this time!' ),
+ RECOMMENDED_PHP
+ );
+ $content .= '</p>';
+ $content .= '<p>' . __( 'However, if your site is lower than the recommended version, running on an outdated and insecure version of PHP, then it’s time to update. You also may have noticed a warning such as "PHP Update Required" or "PHP Update Recommended" on the Dashboard or in Site Health – these serve as important reminders to update PHP and make your site more secure.', 'wporg-forums' ) . '</p>';
+
</ins><span class="cx" style="display: block; padding: 0 10px"> // Section "Before you update your PHP version".
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '<h3>' . __( 'Before you update your PHP version', 'wporg-forums' ) . '</h3>';
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '<p>' . __( 'This section starts off with some warnings, but don’t be afraid! As with most things technical, we just need to cover some background before we can get to the part where you update your PHP version.', 'wporg-forums' ) . '</p>';
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '<p>';
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= sprintf(
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- /* translators: 1: minimum required PHP version, 2: recommended PHP version */
- __( 'Updating your PHP version should not be a problem, but we can’t <em>guarantee</em> that it’s not. WordPress itself works with PHP versions as far back as %1$s (we’re currently recommending version %2$s, so this is <em>great</em> backward compatibility!), but we don’t know if your themes or plugins will work. They should, and popular or reputable ones almost certainly will be, but we can’t guarantee it.', 'wporg-forums' ),
- MINIMUM_PHP,
- RECOMMENDED_PHP
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ /* translators: %s: minimum required PHP version */
+ __( 'Updating your PHP version should not be a problem, but we can’t <em>guarantee</em> that it’s not. WordPress itself works with PHP as far back as version %s, but we don’t know if your themes or plugins will work on newer versions. They should, and popular or reputable ones almost certainly will, but they should be tested to make sure.', 'wporg-forums' ),
+ MINIMUM_PHP
</ins><span class="cx" style="display: block; padding: 0 10px"> );
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '</p>';
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- $content .= '<p>' . __( 'There are a couple of steps you should take to mitigate any risk before proceeding:', 'wporg-forums' ) . '</p>';
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ $content .= '<p>' . __( 'There are a couple of steps you should take to avoid problems before proceeding:', 'wporg-forums' ) . '</p>';
</ins><span class="cx" style="display: block; padding: 0 10px"> $content .= '<ul>';
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '<li>';
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= sprintf(
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -99,7 +117,7 @@
</span><span class="cx" style="display: block; padding: 0 10px"> esc_url( _x( 'https://wordpress.org/plugins/search/backup/', 'link URL for free backup plugins', 'wporg-forums' ) )
</span><span class="cx" style="display: block; padding: 0 10px"> );
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '</li>';
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- $content .= '<li>' . __( '<strong>Update WordPress, themes, and plugins:</strong> from your WordPress Dashboard, head to Updates, and then update all. You should do this regularly anyway. :) When done, check your site is working as expected.', 'wporg-forums' ) . '</li>';
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ $content .= '<li>' . __( '<strong>Update WordPress, themes, and plugins:</strong> from your WordPress Dashboard, head to the Updates page under the <em>Dashboard > Updates</em> menu, and then update everything. You should do this regularly anyway :). When done, check that your site is working as expected.', 'wporg-forums' ) . '</li>';
</ins><span class="cx" style="display: block; padding: 0 10px"> $content .= '<li>';
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= sprintf(
</span><span class="cx" style="display: block; padding: 0 10px"> /* translators: %s: link URL to the PHP Compatibility Checker plugin */
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -122,16 +140,16 @@
</span><span class="cx" style="display: block; padding: 0 10px"> // Section "How to update your website's PHP version for a faster, more secure website".
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '<h3>' . __( 'How to update your website’s PHP version for a faster, more secure website', 'wporg-forums' ) . '</h3>';
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '<p>' . __( 'You’re now ready to update your website’s PHP version! You’ve done due diligence, got backups, and are in the best possible shape to do the update.', 'wporg-forums' ) . '</p>';
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- $content .= '<p>' . __( 'As the PHP version is set at the server level by your hosting company, updating involves either interacting with your host’s settings or asking them to do it.', 'wporg-forums' ) . '</p>';
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ $content .= '<p>' . __( 'PHP is installed on your website’s server, so updating it involves either interacting with your host’s settings or asking your provider to do it for you.', 'wporg-forums' ) . '</p>';
</ins><span class="cx" style="display: block; padding: 0 10px"> $content .= '<p>';
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= sprintf(
</span><span class="cx" style="display: block; padding: 0 10px"> /* translators: %s: link URL to hosting-specific update resources */
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- __( 'Thus, exactly <em>how</em> to do the update depends on your hosting company. We’ve asked hosting companies to submit instructions on how to update your PHP version on their hosting, and <a href="%s">you’ll find a list of hosts who have instructions available here</a>.', 'wporg-forums' ),
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ __( 'Exactly <em>how</em> to do the update depends on your hosting company. We’ve asked hosting companies to submit instructions on how to update your PHP version on their hosting, and <a href="%s">you’ll find a list of hosts who have instructions available here</a>.', 'wporg-forums' ),
</ins><span class="cx" style="display: block; padding: 0 10px"> esc_url( _x( 'https://github.com/WordPress/servehappy-resources/blob/master/tutorials/hosting-specific/tutorials-en.md', 'link URL to hosting-specific update resources', 'wporg-forums' ) )
</span><span class="cx" style="display: block; padding: 0 10px"> );
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '</p>';
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '<p>' . __( 'If you can’t find your host on this list, then email your hosting company and ask them to help! Here’s some template text you can use:', 'wporg-forums' ) . '</p>';
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">- $content .= '<pre>' . __( 'Dear Hosting Provider,<br><br>I want my website to be as performant and secure as<br>possible with the latest version of PHP. For the server<br>my WordPress site is hosted on, I want to ensure that<br>is the case. If I am not already on the latest version<br>of PHP, please let me know what steps I need to take<br>to update.<br><br>Thanks!', 'wporg-forums' ) . '</pre>';
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+ $content .= '<pre>' . __( 'Dear Hosting Provider,<br><br>I want my WordPress website to be as performant and<br>secure as possible with the latest version of PHP.<br>If the server my site is hosted on is not already on<br>the latest version of PHP, please let me know what<br>steps I need to take to update it.<br><br>Thanks!', 'wporg-forums' ) . '</pre>';
</ins><span class="cx" style="display: block; padding: 0 10px"> $content .= '<p>' . __( 'If you run into any issues at this stage, either change the PHP version back yourself, contact your hosting company or a professional web developer. In the unlikely event something goes wrong and you need to restore your backup, contact your host and ask them to restore the previous version of PHP you had running. You can then restore your backup.', 'wporg-forums' ) . '</p>';
</span><span class="cx" style="display: block; padding: 0 10px"> $content .= '<p>' . __( 'You should now have all the information you need to update! Nice work! With an up-to-date version of PHP you’ll enjoy a faster, more secure website and happier visitors.', 'wporg-forums' ) . '</p>';
</span><span class="cx" style="display: block; padding: 0 10px">
</span></span></pre>
</div>
</div>
</body>
</html>