Translate pattern metadata (title & description)

[oandregal]

Related wp-cli/i18n-command#312

What?

#36751 introduced the ability to automatically register patterns from the /patterns directory of the theme. This PR enables translation for the title & description of the pattern.

Why?

Users expect patterns metadata to be translated.

How?

This PR uses translate_with_gettext_context to pull the strings provided by the theme in the correct user locale before the pattern is registered.

Testing Instructions

1 - Create the pattern

• Install and activate the TwentyTwentyTwo theme.
• Add the following pattern under patterns/my-test-heading.php:

<?php
/**
 * Title: My test title
 * Description: My test description
 * Slug: twentytwentytwo/my-test-heading
 * Categories: text
 */

?>
<!-- wp:heading -->
<h2>Hello!</h2>
<!-- /wp:heading -->
<!-- wp:paragraph -->
<p>2 + 2 = <?php echo 2 + 2; ?></p>
<!-- /wp:paragraph -->

2 - Provide a translation

• Go to "Settings > General" and set the language of your site to "Spanish".
• Go to "Dashbord > Updates" and make sure you have the translations section updated (it contains the TwentyTwentyTwo strings in Spanish).
• Unzip the twentytwentytwo-es_ES.mo.zip attached to this PR into wp-content/languages/themes/.

Alternatively, you can create the .mo file yourself for any language, here's how:

• Go to wp-content/languages/themes/ and paste the following at the end of the twentytwentytwo-es_ES.po file:

#: patterns/my-test-heading.php
msgctxt "Pattern title"
msgid "My test title"
msgstr "Mi título de test"

#: patterns/my-test-heading.php
msgctxt "Pattern description"
msgid "My test description"
msgstr "Mi descripción de test"

• Run the wp i18n make-mo <path-to-your-po-file> <path-to-the-directory> command to convert the .po file into the .mo one in the same directory.

3 - Do the testing

• Go to an inserted and search for "test".
• Verify that the pattern title is translated accordingly to the site language (switch between English and Spanish).

[oandregal]

@mcsf @youknowriad @swissspidy I've addressed all the feedback and this is now ready.

[mcsf]

Looks good as far as the original functionality is concerned (thanks for taking care of this!). A separate 👍 on the translation technique would be good.

[oandregal]

Given the time-sensitive period we're in, I'm going to take this comment by Pascal as an "approval for direction" in terms of translation. It's also the same approach we follow to translate strings coming from theme.json (see).