Improve plugin template: archive, prerequisites, activation logic

Author: eliot-akira

.github/workflows/release.yml

@@ -15,7 +15,7 @@ jobs:
       - name: Install dependencies
         run: bun install
       - name: Create archive
-        run: bunx roll archive -y
+        run: bun run archive
       - name: Install pipeline
         run: mkdir -p publish && cd publish && git clone https://github.com/tangibleinc/pipeline
       - name: Add latest tag as needed

example-plugin.php

@@ -26,6 +26,15 @@ function example_plugin($instance = false) {
 
 add_action('plugins_loaded', function() {
 
+  /**
+   * Don't load during plugin activation: the newest version of Framework is
+   * not guaranteed due to how WordPress runs the `plugins_loaded` action *before*
+   * loading plugins and modules, short-circuiting the version comparison logic.
+   * @see https://developer.wordpress.org/reference/functions/register_activation_hook/#more-information
+   * @see https://github.com/WordPress/wordpress-develop/blob/8a52d746e9bb85604f6a309a87d22296ce1c4280/src/wp-admin/includes/plugin.php#L2381C10-L2381C31
+   */
+  if (defined('WP_SANDBOX_SCRAPING')) return;
+
   $plugin    = framework\register_plugin([
     'name'           => 'example-plugin',
     'title'          => 'Example Plugin',

readme.md

@@ -4,7 +4,7 @@ Description of example plugin
 
 ## Develop
 
-Prerequisites: [Git](https://git-scm.com/), [Node](https://nodejs.org/en/) (version 18 and above)
+Prerequisites: Linux, macOS, or Windows ([WSL](https://learn.microsoft.com/en-us/windows/wsl/about)); [Git](https://git-scm.com/), [Node](https://nodejs.org/en/) (version 20 and above)
 
 Clone the repository and install dependencies.
 

tangible.config.js

@@ -29,7 +29,7 @@ export default {
     src: [
       '*.php',
       'assets/**',
-      'includes',
+      'includes/**',
       'vendor/tangible/**',
       'readme.txt'
     ],