<!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>[8071] sites/trunk/wordpress.org/public_html/wp-content: Support Hub: Move the `Update PHP` page to translatable strings.</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/8071">8071</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/8071","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>2019-01-11 03:55:46 +0000 (Fri, 11 Jan 2019)</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 Hub: Move the `Update PHP` page to translatable strings.

Props flixos90 for initial patch, dd32.
Fixes <a href="http://meta.trac.wordpress.org/ticket/4004">#4004</a>.</pre>

<h3>Modified Paths</h3>
<ul>
<li><a href="#sitestrunkwordpressorgpublic_htmlwpcontentpluginssupporthelphubsupporthelphubphp">sites/trunk/wordpress.org/public_html/wp-content/plugins/support-helphub/support-helphub.php</a></li>
</ul>

<h3>Added Paths</h3>
<ul>
<li>sites/trunk/wordpress.org/public_html/wp-content/plugins/support-helphub/inc/helphub-update-php/</li>
<li><a href="#sitestrunkwordpressorgpublic_htmlwpcontentpluginssupporthelphubinchelphubupdatephphelphubupdatephpphp">sites/trunk/wordpress.org/public_html/wp-content/plugins/support-helphub/inc/helphub-update-php/helphub-update-php.php</a></li>
<li><a href="#sitestrunkwordpressorgpublic_htmlwpcontentthemespubwporgsupportpageupdatephpphp">sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-support/page-update-php.php</a></li>
</ul>

</div>
<div id="patch">
<h3>Diff</h3>
<a id="sitestrunkwordpressorgpublic_htmlwpcontentpluginssupporthelphubinchelphubupdatephphelphubupdatephpphp"></a>
<div class="addfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Added: sites/trunk/wordpress.org/public_html/wp-content/plugins/support-helphub/inc/helphub-update-php/helphub-update-php.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/plugins/support-helphub/inc/helphub-update-php/helphub-update-php.php                            (rev 0)
+++ sites/trunk/wordpress.org/public_html/wp-content/plugins/support-helphub/inc/helphub-update-php/helphub-update-php.php      2019-01-11 03:55:46 UTC (rev 8071)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -0,0 +1,147 @@
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+<?php
+/**
+ * Injects the hard-coded page content for the Update PHP page, based on whether the page template is selected.
+ *
+ * @package HelpHub_Update_PHP
+ */
+
+use WordPressdotorg\API\Serve_Happy\RECOMMENDED_PHP;
+use WordPressdotorg\API\Serve_Happy\MINIMUM_PHP;
+
+/**
+ * Injects the title for the Update PHP page if the Update PHP page template is selected.
+ *
+ * @param string $title Post title.
+ * @param int    $id    Post ID.
+ * @return string Filtered post title.
+ */
+function hh_filter_update_php_title( $title, $id ) {
+       if ( is_admin() ) {
+               return $title;
+       }
+
+       if ( 'page-update-php.php' !== get_page_template_slug( $id ) ) {
+               return $title;
+       }
+
+       return __( 'Get a faster, more secure website: update your PHP today', 'wporg-forums' );
+}
+add_filter( 'the_title', 'hh_filter_update_php_title', 5, 2 );
+
+/**
+ * Injects the content for the Update PHP page if the Update PHP page template is selected.
+ *
+ * @param string $content Post content.
+ * @return string Filtered post content.
+ */
+function hh_filter_update_php_content( $content ) {
+       if ( is_admin() ) {
+               return $content;
+       }
+
+       if ( ! is_page_template( 'page-update-php.php' ) ) {
+               return $content;
+       }
+
+       if ( ! in_the_loop() || get_the_ID() !== get_queried_object_id() ) {
+               return $content;
+       }
+
+       // Introduction.
+       $content  = '<p><strong>' . __( 'Your WordPress site can be faster, and more secure, and you can make this happen!', 'wporg-forums' ) . '</strong></p>';
+       $content .= '<p>' . __( 'This page will explain why this matters to you, and then how you can fix it.', 'wporg-forums' ) . '</p>';
+
+       // Section "Why PHP Matters To You".
+       $content .= '<h3>' . __( 'Why PHP Matters To You', 'wporg-forums' ) . '</h3>';
+       $content .= '<p>';
+       $content .= sprintf(
+               /* translators: %s: link URL about keeping WordPress up to date */
+               __( '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' ),
+               esc_url( _x( 'https://wordpress.org/support/article/administration-screens/#updates', 'link URL about keeping WordPress up to date', 'wporg-forums' ) )
+       );
+       $content .= '</p>';
+       $content .= '<p>' . __( 'There are two main benefits to keeping PHP up-to-date:', 'wporg-forums' ) . '</p>';
+       $content .= '<ul>';
+       $content .= '<li>';
+       $content .= sprintf(
+               /* translators: %s: recommended PHP version */
+               __( '<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' ),
+               RECOMMENDED_PHP
+       );
+       $content .= '</li>';
+       $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>';
+       $content .= '</ul>';
+       $content .= '<p>' . __( 'And then there are a number of secondary benefits:', 'wporg-forums' ) . '</p>';
+       $content .= '<ul>';
+       $content .= '<li>' . __( '<strong>A faster WordPress website will be rewarded by search engines</strong>, so you&#8217;ll rank higher in search!', 'wporg-forums' ) . '</li>';
+       $content .= '<li>' . __( '<strong>A faster website will retain visitors better</strong> (they&#8217;ll leave if it takes too long to load), making your website more effective.', 'wporg-forums' ) . '</li>';
+       $content .= '<li>' . __( '<strong>A more secure website is better protected against hackers</strong>, and the cost and reputational damage associated with a hacked website.', 'wporg-forums' ) . '</li>';
+       $content .= '</ul>';
+       $content .= '<p>' . __( 'These benefits are good for you, and good for your website&#8217;s visitors. These are the reasons you should update PHP today. The next section will show you how to do this.', 'wporg-forums' ) . '</p>';
+
+       // Section "Before you update your PHP version".
+       $content .= '<h3>' . __( 'Before you update your PHP version', 'wporg-forums' ) . '</h3>';
+       $content .= '<p>' . __( 'This section starts off with some warnings, but don&#8217;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>';
+       $content .= '<p>';
+       $content .= sprintf(
+               /* translators: 1: minimum required PHP version, 2: recommended PHP version */
+               __( 'Updating your PHP version should not be a problem, but we can&#8217;t <em>guarantee</em> that it&#8217;s not. WordPress itself works with PHP versions as far back as %1$s (we&#8217;re currently recommending version %2$s, so this is <em>great</em> backward compatibility!), but we don&#8217;t know if your themes or plugins will work. They should, and popular or reputable ones almost certainly will be, but we can&#8217;t guarantee it.', 'wporg-forums' ),
+               MINIMUM_PHP,
+               RECOMMENDED_PHP
+       );
+       $content .= '</p>';
+       $content .= '<p>' . __( 'There are a couple of steps you should take to mitigate any risk before proceeding:', 'wporg-forums' ) . '</p>';
+       $content .= '<ul>';
+       $content .= '<li>';
+       $content .= sprintf(
+               /* translators: %s: link URL for free backup plugins */
+               __( '<strong>Make a backup of your website:</strong> a backup will let you revert your site to how it is right now in the event anything goes wrong. There are <a href="%s">plenty of free backup plugins available</a>, so if you don&#8217;t have a backup solution already – use one of these. In order to revert this backup, you&#8217;ll also need your web host to move your PHP version back to your current version (we&#8217;ll cover how to do this later).', 'wporg-forums' ),
+               esc_url( _x( 'https://wordpress.org/plugins/search/backup/', 'link URL for free backup plugins', 'wporg-forums' ) )
+       );
+       $content .= '</li>';
+       $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>';
+       $content .= '<li>';
+       $content .= sprintf(
+               /* translators: %s: link URL to the PHP Compatibility Checker plugin */
+               __( '<strong>Check PHP compatibility:</strong> install the <a href="%s">PHP Compatibility Checker plugin</a> to check your themes and plugins for possible issues. This plugin isn&#8217;t perfect and may miss items or flag false positives, but it does work in most cases.', 'wporg-forums' ),
+               esc_url( _x( 'https://wordpress.org/plugins/php-compatibility-checker/', 'link URL to the PHP Compatibility Checker plugin', 'wporg-forums' ) )
+       );
+       $content .= '</li>';
+       $content .= '<li>';
+       $content .= sprintf(
+               /* translators: %s: link URL to wordpress.org */
+               __( '<strong>Fix any PHP compatibility issues:</strong> if the PHP Compatibility Checker plugin picks up any issues, get in touch with the theme or plugin developer and ask them to investigate. If they can&#8217;t or won&#8217;t get back to you, have a look for themes or plugins on <a href="%s">WordPress.org</a> with similar functionality and use one of these instead.', 'wporg-forums' ),
+               esc_url( _x( 'https://wordpress.org/', 'link URL to wordpress.org', 'wporg-forums' ) )
+       );
+       $content .= '</li>';
+       $content .= '</ul>';
+       $content .= '<p>' . __( 'Run through these steps, and you&#8217;ll be ready to update the PHP version on your WordPress site – and enjoy all of the benefits that come with this!', 'wporg-forums' ) . '</p>';
+       $content .= '<p>' . __( 'If you run into any issues whilst doing this or need help, you should contact a professional web developer, your hosting company, or your theme and plugins authors. All of these will be happy to help here.', 'wporg-forums' ) . '</p>';
+       $content .= '<p>' . __( 'We can now get on to the final part: actually updating your website&#8217;s PHP version.', 'wporg-forums' ) . '</p>';
+
+       // Section "How to update your website's PHP version for a faster, more secure website".
+       $content .= '<h3>' . __( 'How to update your website&#8217;s PHP version for a faster, more secure website', 'wporg-forums' ) . '</h3>';
+       $content .= '<p>' . __( 'You&#8217;re now ready to update your website&#8217;s PHP version! You&#8217;ve done due diligence, got backups, and are in the best possible shape to do the update.', 'wporg-forums' ) . '</p>';
+       $content .= '<p>' . __( 'As the PHP version is set at the server level by your hosting company, updating involves either interacting with your host&#8217;s settings or asking them to do it.', 'wporg-forums' ) . '</p>';
+       $content .= '<p>';
+       $content .= sprintf(
+               /* translators: %s: link URL to hosting-specific update resources */
+               __( 'Thus, exactly <em>how</em> to do the update depends on your hosting company. We&#8217;ve asked hosting companies to submit instructions on how to update your PHP version on their hosting, and <a href="%s">you&#8217;ll find a list of hosts who have instructions available here</a>.', 'wporg-forums' ),
+               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' ) )
+       );
+       $content .= '</p>';
+       $content .= '<p>' . __( 'If you can&#8217;t find your host on this list, then email your hosting company and ask them to help! Here&#8217;s some template text you can use:', 'wporg-forums' ) . '</p>';
+       $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>';
+       $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>';
+       $content .= '<p>' . __( 'You should now have all the information you need to update! Nice work! With an up-to-date version of PHP you&#8217;ll enjoy a faster, more secure website and happier visitors.', 'wporg-forums' ) . '</p>';
+
+       // Section "Faster, more secure WordPress websites for all".
+       $content .= '<h3>' . __( 'Faster, more secure WordPress websites for all', 'wporg-forums' ) . '</h3>';
+       $content .= '<p>' . __( 'Making sure you have the latest version of PHP ensures your website is as fast, and secure as possible.', 'wporg-forums' ) . '</p>';
+       $content .= '<p>' . __( 'You now have all the information you need to update to the latest version of PHP, and you know how to update in the future as well. Look out for more PHP update messages on your WordPress Dashboard going forwards, or keep an eye on your hosting company&#8217;s news for more information.', 'wporg-forums' ) . '</p>';
+       $content .= '<p>' . __( 'As a final reminder: contact your hosting company, a professional web developer, or your theme and/or plugin authors for any additional questions. They&#8217;ll all be able to help out with their areas of expertise.', 'wporg-forums' ) . '</p>';
+       $content .= '<p><strong>' . __( 'Thanks for making the internet a better place!', 'wporg-forums' ) . '</strong></p>';
+
+       return $content;
+}
+add_filter( 'the_content', 'hh_filter_update_php_content', 5 );
</ins><span class="cx" style="display: block; padding: 0 10px">Property changes on: sites/trunk/wordpress.org/public_html/wp-content/plugins/support-helphub/inc/helphub-update-php/helphub-update-php.php
</span><span class="cx" style="display: block; padding: 0 10px">___________________________________________________________________
</span></span></pre></div>
<a id="svneolstyle"></a>
<div class="addfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Added: svn:eol-style</h4></div>
<ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+native
</ins><span class="cx" style="display: block; padding: 0 10px">\ No newline at end of property
</span><a id="sitestrunkwordpressorgpublic_htmlwpcontentpluginssupporthelphubsupporthelphubphp"></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/plugins/support-helphub/support-helphub.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/plugins/support-helphub/support-helphub.php      2019-01-11 02:43:32 UTC (rev 8070)
+++ sites/trunk/wordpress.org/public_html/wp-content/plugins/support-helphub/support-helphub.php        2019-01-11 03:55:46 UTC (rev 8071)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -23,4 +23,4 @@
</span><span class="cx" style="display: block; padding: 0 10px"> require_once( dirname( __FILE__ ) . '/inc/helphub-front-page-blocks/helphub-front-page-blocks.php' );
</span><span class="cx" style="display: block; padding: 0 10px"> require_once( dirname( __FILE__ ) . '/inc/helphub-customroles/class-helphub-custom-roles.php' );
</span><span class="cx" style="display: block; padding: 0 10px"> require_once( dirname( __FILE__ ) . '/inc/helphub-manager/class-helphub-manager.php' );
</span><del style="background-color: #fdd; text-decoration:none; display:block; padding: 0 10px">-
</del><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+require_once( dirname( __FILE__ ) . '/inc/helphub-update-php/helphub-update-php.php' );
</ins></span></pre></div>
<a id="sitestrunkwordpressorgpublic_htmlwpcontentthemespubwporgsupportpageupdatephpphp"></a>
<div class="addfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Added: sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-support/page-update-php.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/page-update-php.php                             (rev 0)
+++ sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-support/page-update-php.php       2019-01-11 03:55:46 UTC (rev 8071)
</span><span class="lines" style="display: block; padding: 0 10px; color: #888">@@ -0,0 +1,13 @@
</span><ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+<?php
+/**
+ * Template Name: Update PHP
+ *
+ * @package WPOrg
+ * @subpackage Theme
+ */
+
+/*
+Use the default template for pages. This specific template is only used to indicate that the content needs to be
+manually injected, which happens in the HelpHub plugin.
+ */
+require get_stylesheet_directory() . '/page.php';
</ins><span class="cx" style="display: block; padding: 0 10px">Property changes on: sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-support/page-update-php.php
</span><span class="cx" style="display: block; padding: 0 10px">___________________________________________________________________
</span></span></pre></div>
<a id="svneolstyle"></a>
<div class="addfile"><h4 style="background-color: #eee; color: inherit; margin: 1em 0; padding: 1.3em; font-size: 115%">Added: svn:eol-style</h4></div>
<ins style="background-color: #dfd; text-decoration:none; display:block; padding: 0 10px">+native
</ins><span class="cx" style="display: block; padding: 0 10px">\ No newline at end of property
</span></div>

</body>
</html>