Merge pull request #312 from oandregal/add/translate-php-patterns-met…

…adata

features/makepot.feature

@@ -3658,3 +3658,40 @@ Feature: Generate a POT file of a WordPress project
       msgctxt "Color name"
       msgid "Black"
       """
+
+  Scenario: Extract strings from the patterns directory
+    Given an empty foo-theme/patterns directory
+    And a foo-theme/patterns/my-pattern.php file:
+      """
+      <?php
+      /**
+       * Title: My pattern title.
+       * Description: My pattern description.
+       */
+      """
+    And a foo-theme/style.css file:
+      """
+      /*
+      Theme Name: foo theme
+      */
+      """
+
+    When I try `wp i18n make-pot foo-theme`
+    Then STDOUT should be:
+      """
+      Theme stylesheet detected.
+      Success: POT file successfully generated!
+      """
+    And the foo-theme/foo-theme.pot file should exist
+    And the foo-theme/foo-theme.pot file should contain:
+      """
+      #: patterns/my-pattern.php
+      msgctxt "Pattern title"
+      msgid "My pattern title."
+      msgstr ""
+
+      #: patterns/my-pattern.php
+      msgctxt "Pattern description"
+      msgid "My pattern description."
+      msgstr ""
+      """

src/IterableCodeExtractor.php

@@ -24,6 +24,7 @@ trait IterableCodeExtractor {
 	 *     Optional. An array of options passed down to static::fromString()
 	 *
 	 *     @type bool  $wpExtractTemplates Extract 'Template Name' headers in theme files. Default 'false'.
+	 *     @type bool  $wpExtractPatterns  Extract 'Title' and 'Description' headers in pattern files. Default 'false'.
 	 *     @type array $restrictFileNames  Skip all files which are not included in this array.
 	 * }
 	 * @return null
@@ -65,6 +66,30 @@ public static function fromFile( $file_or_files, Translations $translations, arr
 				}
 			}
 
+			if ( ! empty( $options['wpExtractPatterns'] ) ) {
+				$headers = MakePotCommand::get_file_data_from_string(
+					$string,
+					[
+						'Title'       => 'Title',
+						'Description' => 'Description',
+					]
+				);
+
+				if ( ! empty( $headers['Title'] ) ) {
+					$translation = new Translation( 'Pattern title', $headers['Title'] );
+					$translation->addReference( $options['file'] );
+
+					$translations[] = $translation;
+				}
+
+				if ( ! empty( $headers['Description'] ) ) {
+					$translation = new Translation( 'Pattern description', $headers['Description'] );
+					$translation->addReference( $options['file'] );
+
+					$translations[] = $translation;
+				}
+			}
+
 			static::fromString( $string, $translations, $options );
 		}
 	}

src/MakePotCommand.php

@@ -618,6 +618,17 @@ protected function extract_strings() {
 				PhpCodeExtractor::fromDirectory( $this->source, $translations, $options );
 			}
 
+			if ( ! $this->skip_php ) {
+				$options = [
+					// Extract 'Title' and 'Description' headers from pattern files.
+					'wpExtractPatterns' => isset( $this->main_file_data['Theme Name'] ),
+					'include'           => array_merge( $this->include, array( 'patterns' ) ),
+					'exclude'           => $this->exclude,
+					'extensions'        => [ 'php' ],
+				];
+				PhpCodeExtractor::fromDirectory( $this->source, $translations, $options );
+			}
+
 			if ( ! $this->skip_blade ) {
 				$options = [
 					'include'       => $this->include,