@artemsemkin/wp-headers 1.2.1 → 1.2.5

package/README.md

@@ -58,6 +58,16 @@ Running `processMapping({ type: 'theme', slug: 'flavor', entityDir: '/path/to/th
  * Text Domain: flavor
  * Tags: blog, one-column
  */
+
+html {
+  margin-top: 0 !important;
+}
+
+img,
+video {
+  max-width: 100%;
+  height: auto;
+}
 ```
 
 ### Plugin: `package.json` → PHP header
@@ -88,6 +98,7 @@ Given this in your plugin's `package.json`:
 Running `processMapping({ type: 'plugin', slug: 'flavor-core', entityDir: '/path/to/plugin' })` generates or updates the header at the top of `flavor-core.php`:
 
 ```php
+<?php
 /**
  * Plugin Name: Flavor Core
  * Plugin URI: https://example.com/flavor-core
@@ -101,29 +112,69 @@ Running `processMapping({ type: 'plugin', slug: 'flavor-core', entityDir: '/path
  * License: GPL-2.0-or-later
  * Text Domain: flavor-core
  */
+
+defined( 'ABSPATH' ) || exit;
+
+define( 'FLAVOR_CORE_VERSION', '1.0.0' );
+define( 'FLAVOR_CORE_PATH', plugin_dir_path( __FILE__ ) );
+
+require_once FLAVOR_CORE_PATH . 'inc/class-flavor-core.php';
+
+load_plugin_textdomain( 'flavor-core', false, dirname( plugin_basename( __FILE__ ) ) . '/languages' );
 ```
 
 ### TGM version patching
 
-When a plugin's `package.json` includes `wp.plugin.loadPluginsFile`, the tool also patches version strings inside TGM-style PHP arrays. Given this PHP file registered via `tgmBasePath`:
+WordPress themes commonly use TGMPA to register required plugins with minimum version constraints. When a plugin's `package.json` includes `wp.plugin.loadPluginsFile`, the tool finds the matching slug in the TGM PHP file and patches its version string.
+
+Given this TGM registration file in your theme:
 
 ```php
-$plugins = array(
-    array(
-        'name'     => 'Flavor Core',
-        'slug'     => 'flavor-core',
-        'version'  => '1.0.0',
-    ),
-);
+<?php
+
+add_action( 'tgmpa_register', 'flavor_tgm_register_required_plugins' );
+function flavor_tgm_register_required_plugins() {
+    $plugins = array(
+        // Bundled plugins — have a version constraint
+        array(
+            'name'     => 'Flavor Core',
+            'slug'     => 'flavor-core',
+            'source'   => esc_url( $core_plugin_url ),
+            'required' => true,
+            'version'  => '1.0.0',
+        ),
+        array(
+            'name'     => 'Flavor Elementor Extension',
+            'slug'     => 'flavor-elementor-extension',
+            'source'   => esc_url( $elementor_plugin_url ),
+            'required' => true,
+            'version'  => '1.0.0',
+        ),
+        // Third-party plugins — no version field, pulled from wp.org
+        array(
+            'name'     => 'Elementor',
+            'slug'     => 'elementor',
+            'required' => true,
+        ),
+        array(
+            'name'     => 'Contact Form 7',
+            'slug'     => 'contact-form-7',
+            'required' => false,
+        ),
+    );
+
+    tgmpa( $plugins, $config );
+}
 ```
 
-After processing with `version: "2.0.0"` in `package.json`, the version field is updated in place:
+When `flavor-core`'s `package.json` has `"version": "2.0.0"`, processing updates only the matching entry — the Elementor and Contact Form 7 entries are left untouched because they don't have a `version` field and their slugs don't match:
 
-```php
-        'version'  => '2.0.0',
+```diff
+-            'version'  => '1.0.0',
++            'version'  => '2.0.0',
 ```
 
-Whitespace alignment, quote styles, and other entries are preserved.
+Whitespace alignment, quote styles, nested function calls, and other plugin entries are preserved.
 
 ## Usage
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artemsemkin/wp-headers",
-  "version": "1.2.1",
+  "version": "1.2.5",
   "description": "Generate and patch WordPress file headers (style.css, plugin PHP, readme.txt, TGM)",
   "license": "MIT",
   "author": "Artem Semkin",